Browse the Repo
Browse the Repo
Deploy Jenkins and configure CI / CD pipelines for your apps as code using Jenkinsfiles and Gruntwork build and deploy scripts.
This repo contains modules to manage CI servers, such as Jenkins, and to automate common CI tasks, such as installing dependencies, running tests, and publishing releases.
Deploy auto healing CI/CD servers
Automatically build and publish Docker containers and AMIs
Automatically update Terragrunt/Terraform variables
Setup CI environments for running Terratest
Install infrastructure tools for CI/CD, including Terraform, Terragrunt, Helm, and Kubectl
IAM policies for CI/CD servers
This repo is a part of the Gruntwork Infrastructure as Code Library, a collection of reusable, battle-tested, production ready infrastructure code. If you’ve never used the Infrastructure as Code Library before, make sure to read How to use the Gruntwork Infrastructure as Code Library!
How to use Terraform as a team: Our blog post on using terraform to manage infrastructure as a team. Includes discussion about typical CI/CD workflows for both application code and infrastructure code.
modules: the main implementation code for this repo, broken down into multiple standalone, orthogonal submodules.
modules/build-helpers: use the scripts in this module to build and publish machine images using Docker or Packer.
modules/circleci-helpers: use the scripts in this module to setup a CI environment for testing or deploying Gruntwork modules.
modules/terraform-helpers: use the scripts in this module to manipulate terraform and terragrunt variables in a CI environment.
modules/iam-policies: use this module to provision a set of IAM policies that you can attach to your machine users for employing principles of least privilege when setting up CI/CD.
modules/jenkins-server: use this module to provision an auto healing Jenkins server as your CI/CD platform.
examples: This folder contains working examples of how to use the submodules.
test: Automated tests for the modules and examples.
If you just want to try this repo out for experimenting and learning, check out the following resources:
examples folder: The
examples folder contains sample code optimized for learning, experimenting, and testing (but not production usage).
If you want to deploy this repo in production, check out the following resources:
jenkins in the Acme example Reference Architecture: Production-ready sample code from the Acme Reference Architecture examples.
CircleCI configuration in the Acme example Reference Architecture: Production-ready configuration of a CI/CD job for sample application in the Acme Reference Architecture examples
If you need help with this repo or anything else related to infrastructure or DevOps, Gruntwork offers Commercial Support via Slack, email, and phone/video. If you’re already a Gruntwork customer, hop on Slack and ask away! If not, subscribe now. If you’re not sure, feel free to email us at firstname.lastname@example.org.
Contributions to this repo are very welcome and appreciated! If you find a bug or want to add a new feature or even contribute an entirely new module, we are very happy to accept pull requests, provide feedback, and run your changes through our automated test suite.
Please see Contributing to the Gruntwork Infrastructure as Code Library for instructions.
Please see LICENSE.txt for details on how the code in this repo is licensed.
We're here to talk about our services, answer any questions, give advice, or just to chat.