Skip to main content

Usage

How to use atlantis

Atlantis is a little different than the other management processes, as you will need to use one of those, but atlantis can add the support to run terraform in a CI/CD pipeline. This is useful if you want to automate the deployment and maintenance of your gen3 instances. This option is recommended if you want to collaborate with others on the deployment and maintenance of your gen3 instances, as it allows you to easily review and approve changes to your infrastructure through github pr's. There are a lot of possible ways to use atlantis and the specific implementation you decide on will depend on your needs, but we will go over how to use it once you have it setup.

Making changes

Once you have an atlantis setup configured to your specific needs, you should be able to start making changes from pull requests. The way atlantis works is it will watch your configured github repo for pull requests. Once it see's one it will run a specified workflow, which generally means it will plan your change. Depending on the configuration you have setup, it will then either comment on the pull request with the plan, or it will plan and apply if the plan is successful. We recommend setting it up to comment on the pull request with the plan, and then you can review the plan and approve it if it looks good. Once you approve the plan, atlantis will apply the changes and comment on the pull request with the results. If you have it setup to run a plan and apply, then it will just comment on the pull request with the results of the apply.