Atlantis

Appearance

Atlantis 0.4.4 Now Supports Bitbucket ​

INFO

This post was originally written on July 25th, 2018

Original post: https://medium.com/runatlantis/atlantis-0-4-4-now-supports-bitbucket-86c53a550b45

Atlantis is an open source platform for using Terraform in teams. I'm happy to announce that the latest release of Atlantis (0.4.4) now supports both Bitbucket Cloud (bitbucket.org) and Bitbucket Server (aka Stash).

Atlantis now supports the three major Git hosts: GitHub, GitLab and Bitbucket. The rest of this post will talk about how to use Atlantis with Bitbucket.

What is Atlantis? ​

Atlantis is a self-hosted application that listens for Terraform pull request events via webhooks. It runs terraform plan and apply remotely and comments back on the pull request with the output.

With Atlantis, you collaborate on the Terraform pull request itself instead of running terraform apply from your own computers which can be dangerous:

Check out <www.runatlantis.io> for more information.

Getting Started ​

The easiest way to try out Atlantis with Bitbucket is to run Atlantis locally on your own computer. Eventually you'll want to deploy it as a standalone app but this is the easiest way to try it out. Follow these instructions to get Atlantis running locally.

Create a Pull Request If you've got the Atlantis webhook configured for your repository and Atlantis is running, it's time to create a new pull request. I recommend adding a null_resource to one of your Terraform files for the the test pull request. It won't actually create anything so it's safe to use as a test.

Using the web editor, open up one of your Terraform files and add:

tf
resource "null_resource" "example" {}

Click Commit and select Create a pull request for this change.

Wait a few seconds and then refresh. Atlantis should have automatically run terraform plan and commented back on the pull request:

Now it's easier for your colleagues to review the pull request because they can see the terraform plan output.

Terraform Apply ​

Since all we're doing is adding a null resource, I think it's safe to run terraform apply. To do so, I add a comment to the pull request: atlantis apply:

Atlantis is listening for pull request comments and will run terraform apply remotely and comment back with the output:

Pull Request Approvals ​

If you don't want anyone to be able to terraform apply, you can run Atlantis with --require-approval or add that setting to your atlantis.yaml file.

This will ensure that the pull request has been approved before someone can run apply.

Other Features ​

Customizable Commands ​

Apart from being able to plan and apply from the pull request, Atlantis also enables you to customize the exact commands that are run via an atlantis.yaml config file. For example to use the -var-file flag:

yaml
# atlantis.yaml
version: 2
projects:
- name: staging
  dir: "."
  workflow: staging

workflows:
  staging:
    plan:
      steps:
      - init
      - plan:
          extra_args: ["-var-file", "staging.tfvars"]

Locking For Coordination ​

Atlantis will prevent other pull requests from running against the same directory as an open pull request so that each plan is applied atomically. Once the first pull request is merged, other pull requests are unlocked.

Next Steps ​

If you're interested in using Atlantis with Bitbucket, check out our Getting Started docs. Happy Terraforming!