2020-12-06 10:46:26 +01:00
# Hadolint Action
2019-10-02 22:50:00 +02:00
2020-12-06 10:46:26 +01:00
> GitHub Action that runs [Hadolint](https://github.com/hadolint/hadolint) Dockerfile linting tool.
2019-10-02 22:50:00 +02:00
[![GitHub Action ](https://img.shields.io/badge/GitHub-Action-blue?style=for-the-badge )](https://github.com/features/actions)
[![License ](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge )](LICENSE)
[![Commitizen friendly ](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge )](http://commitizen.github.io/cz-cli/)
[![semantic-release ](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge )](https://github.com/semantic-release/semantic-release?style=for-the-badge)
2021-04-14 20:25:02 +02:00
[![GitHub Workflow Status ](https://img.shields.io/github/workflow/status/hadolint/hadolint-action/CI?style=for-the-badge )](https://github.com/hadolint/hadolint-action/action)
2019-10-02 22:50:00 +02:00
## Usage
2020-12-06 10:46:26 +01:00
Add the following step to your workflow configuration:
2019-10-02 22:50:00 +02:00
```yml
steps:
2021-05-10 11:31:03 +02:00
- uses: actions/checkout@v2
- uses: hadolint/hadolint-action@v1.5.0
2021-05-08 13:08:16 +02:00
with:
dockerfile: Dockerfile
2019-10-02 22:50:00 +02:00
```
## Inputs
2021-05-08 13:08:16 +02:00
| Name | Description | Default |
|------------------ |------------------------------------------ |----------------- |
| dockerfile | The path to the Dockerfile to be tested | ./Dockerfile |
2021-06-04 17:49:26 +02:00
| format | The output format. One of [tty \| json \| | tty |
| | checkstyle \| codeclimate \| | |
2021-05-08 13:08:16 +02:00
| | gitlab_codeclimate] | |
| ignore | Space separated list of Hadolint rules to | < none > |
| | ignore. | |
| config | Custom path to a Hadolint config file | ./.hadolint.yaml |
| failure-threshold | Rule severity threshold for pipeline | info |
2021-06-04 17:49:26 +02:00
| | failure. One of [error \| warning \| | |
| | info \| style \| ignore] | |
2020-12-06 10:46:26 +01:00
## Hadolint Configuration
To configure Hadolint (for example ignore rules), you can create an `.hadolint.yaml` file in the root of your repository. Please check the Hadolint [documentation ](https://github.com/hadolint/hadolint#configure ).
2019-10-02 22:50:00 +02:00
## 🤝 Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated** .
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
2020-12-06 10:46:26 +01:00
## 💛 Support the project
2021-05-17 20:06:18 +02:00
If this project was useful to you in some form, We would be glad to have your support. It will help keeping the project alive.
2020-12-06 10:46:26 +01:00
The sinplest form of support is to give a ⭐️ to this repo.
2021-05-17 20:06:18 +02:00
This project was originally created by [Bruno Paz ](https://github.com/sponsors/brpaz ) and incorporated into the Hadolint organization. If you appreciate the work done on this action, Bruno would be happy with your [sponsorship ](https://github.com/sponsors/brpaz ).
2020-12-06 10:46:26 +01:00
2019-10-02 22:50:00 +02:00
## Author
👤 **Bruno Paz**
* Website: [https://github.com/brpaz ](https://github.com/brpaz )
* Github: [@brpaz ](https://github.com/brpaz )
## 📝 License
2021-05-17 20:06:18 +02:00
[MIT ](LICENSE )