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

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

ansible ansible-galaxy ansible-role checkov code-analysis iac static-analysis

Last synced: 22 days ago
JSON representation

Ansible role for checkov. Available on Ansible Galaxy.

• Host: GitHub
• URL: https://github.com/darkwizard242/ansible-role-checkov
• Owner: darkwizard242
• License: mit
• Created: 2020-06-13T17:29:43.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-20T17:56:38.000Z (5 months ago)
• Last Synced: 2024-10-07T02:42:05.195Z (about 1 month ago)
• Topics: ansible, ansible-galaxy, ansible-role, checkov, code-analysis, iac, static-analysis
• Language: Python
• Homepage: https://galaxy.ansible.com/darkwizard242/checkov
• Size: 43 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

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

# Ansible Role: checkov

Role to install [checkov](https://github.com/bridgecrewio/checkov) pip package on **Debian/Ubuntu** systems for performing static code analysis based on benchmarks and policies for code written in popular IaC's like Terraform, CloudFormation and Kubernetes.

## Requirements

None.

## Role Variables

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

### Variables List:

```yaml

checkov_debian_pre_reqs:

  - python3

  - python3-pip

checkov_debian_pre_reqs_desired_state: present

pip_executable: pip3

pip_upgrade_version: latest

checkov_app_debian_package: checkov

checkov_desired_state: present

```

### Variables table:

Variable                              | Description

------------------------------------- | -------------------------------------------------------------------------------------------------------------------

checkov_debian_pre_reqs               | Packages required to install **checkov** on Debian based systems. Using python3 as python2.x is EOL by end of 2020.

checkov_debian_pre_reqs_desired_state | Desired state for **checkov** pre-requisite apps on Debian systems.

pip_executable                        | The executable to utilize for installing **pip** package of `checkov`.

checkov_app_debian_package            | Name of checkov application package require to be installed i.e. `checkov` on Debian based systems.

checkov_desired_state                 | Desired state for **checkov**.

## Dependencies

None

## Example Playbook

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

```yaml

- hosts: servers

  roles:

    - darkwizard242.checkov

```

For customizing behavior of role (i.e. installation of latest **checkov** package instead of ensure it is installed ) in ansible playbooks.

```yaml

- hosts: servers

  roles:

    - darkwizard242.checkov

  vars:

    checkov_desired_state: latest

```

For customizing behavior of role (i.e. removal of **checkov** package) in ansible playbooks.

```yaml

- hosts: servers

  roles:

    - darkwizard242.checkov

  vars:

    checkov_desired_state: absent

```

## License

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

## Author Information

This role was created by [Ali Muhammad](https://www.alimuhammad.dev/), a DevOps/CloudOps Engineer who loves to learn and contribute to Open Source community.