Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/darkwizard242/ansible-role-hadolint

Ansible role for 'hadolint'. Available on Ansible Galaxy.
https://github.com/darkwizard242/ansible-role-hadolint

ansible ansible-galaxy ansible-role dockerfile-linter hadolint linux

Last synced: 22 days ago
JSON representation

Ansible role for 'hadolint'. Available on Ansible Galaxy.

Awesome Lists containing this project

README

        

[![build-test](https://github.com/darkwizard242/ansible-role-hadolint/workflows/build-and-test/badge.svg?branch=master)](https://github.com/darkwizard242/ansible-role-hadolint/actions?query=workflow%3Abuild-and-test) [![release](https://github.com/darkwizard242/ansible-role-hadolint/workflows/release/badge.svg)](https://github.com/darkwizard242/ansible-role-hadolint/actions?query=workflow%3Arelease) ![Ansible Role](https://img.shields.io/ansible/role/d/darkwizard242/hadolint) [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=ansible-role-hadolint&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=ansible-role-hadolint) [![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=ansible-role-hadolint&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=ansible-role-hadolint) [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=ansible-role-hadolint&metric=security_rating)](https://sonarcloud.io/dashboard?id=ansible-role-hadolint) ![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/darkwizard242/ansible-role-hadolint?label=release) ![GitHub repo size](https://img.shields.io/github/repo-size/darkwizard242/ansible-role-hadolint?color=orange&style=flat-square)

# Ansible Role: hadolint

Role to install (_by default_) `hadolint` on **Debian/Ubuntu** and **EL** systems. [hadolint](https://github.com/hadolint/hadolint) is a smart Dockerfile linter that helps you build best practice Docker images.

## Requirements

None.

## Role Variables

Available variables are listed below (located in `defaults/main.yml`):

### Variables list:

```yaml
hadolint_app: hadolint
hadolint_version: 2.12.0
hadolint_os: "{{ ansible_system }}"
hadolint_architecture_map:
amd64: x86_64
arm: arm64
x86_64: x86_64
armv6l: armv6
armv7l: armv7
aarch64: arm64
32-bit: "386"
64-bit: x86_64
hadolint_dl_url: https://github.com/{{ hadolint_app }}/{{ hadolint_app }}/releases/download/v{{ hadolint_version }}/{{ hadolint_app }}-{{ hadolint_os }}-{{ hadolint_architecture_map[ansible_architecture] }}
hadolint_bin_path: "/usr/local/bin"
hadolint_bin_permission_mode: '0755'
```

### Variables table:

Variable | Description
---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------
hadolint_app | Defines the app to install i.e. **hadolint**
hadolint_version | Defined to dynamically fetch the desired version to install. Defaults to: **2.12.0**
hadolint_os | Defines os type.
hadolint_architecture_map | Defines os architecture.
hadolint_dl_url | Defines URL to download the hadolint binary from.
hadolint_bin_path | Defined to dynamically set the appropriate path to store hadolint binary into. Defaults to (as generally available on any user's PATH): **/usr/local/bin**
hadolint_bin_permission_mode | Defines the permission mode level for the file. Defaults to: `0755`

## Dependencies

None

## Example Playbook

For default behaviour of role (i.e. installation of **hadolint**) in ansible playbooks.

```yaml
- hosts: servers
roles:
- darkwizard242.hadolint
```

For customizing behavior of role (i.e. specifying the desired **hadolint** version) in ansible playbooks.

```yaml
- hosts: servers
roles:
- darkwizard242.hadolint
vars:
hadolint_version: 2.7.0
```

For customizing behavior of role (i.e. placing binary of **hadolint** package in different location) in ansible playbooks.

```yaml
- hosts: servers
roles:
- darkwizard242.hadolint
vars:
hadolint_bin_path: /bin/
```

## License

[MIT](https://github.com/darkwizard242/ansible-role-hadolint/blob/master/LICENSE)

## Author Information

This role was created by [Ali Muhammad](https://www.alimuhammad.dev/).