Integrate Checkov with GitLab CI
You can integrate checkov into your GitLab CI pipelines. This provides a simple, automatic way of applying policies to your Terraform code both during merge request review and as part of your build process.
Add a new job in the
.gitlab-ci.yml file in your repository as part of whichever stage is appropriate for you.
Here is a minimalistic example:
stages: - validate checkov: image: name: bridgecrew/checkov:latest entrypoint: - '/usr/bin/env' - 'PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' stage: validate script: - checkov -d .
When your pipeline executes, it will run this job. If checkov finds any issues, it will fail the build.
For example, I have an S3 bucket that does not have versioning enabled. Checkov detects this and fails the job and pipeline.
This will comment on an associated merge request or fail the build depending on the context.
Once I have corrected the configuration, checkov verifies that all is well.
Note that in the above examples the output of the test results does not display colors. This is because GitLab Runner runs without an interactive TTY. Although checkov does not currently support an environment variable to force colored output, the
script command can be used to emulate
tty so colors are displayed:
stages: - validate checkov: image: name: bridgecrew/checkov:latest entrypoint: - '/usr/bin/env' - 'PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' stage: validate script: # Use `script` to emulate `tty` for colored output. - script -q -c 'checkov -d .'
See the GitLab CI documentation for additional information.