From bc740fc609706df6788dbed64a3d4eebd282d5cd Mon Sep 17 00:00:00 2001 From: Anubhav Mishra Date: Sun, 10 Sep 2017 14:49:30 -0700 Subject: [PATCH] Adding generated html for the blog post. --- website/html/blog/atlantis-release/index.html | 367 ++++++++++++++++++ website/html/blog/index.html | 11 +- website/html/blog/index.xml | 13 +- website/html/categories/index.xml | 9 - website/html/css/custom.css | 6 +- website/html/docs/getting-started/index.html | 4 +- website/html/docs/index.html | 4 +- website/html/faq/index.html | 4 +- website/html/img/apply-comment.png | Bin 0 -> 118499 bytes website/html/img/approval-needed.png | Bin 0 -> 91194 bytes website/html/img/atlantis-flow.png | Bin 0 -> 38403 bytes website/html/img/atlantis-highquality.png | Bin 0 -> 21445 bytes website/html/img/comment.png | Bin 0 -> 274712 bytes website/html/img/demo-large.gif | Bin 0 -> 4767847 bytes website/html/img/demo.gif | Bin 0 -> 1650880 bytes website/html/img/diff-output.png | Bin 0 -> 89679 bytes website/html/img/diff.png | Bin 0 -> 42044 bytes website/html/img/master-flow.png | Bin 0 -> 20893 bytes website/html/img/pull-request-flow.png | Bin 0 -> 28377 bytes website/html/index.html | 77 ++-- website/html/index.xml | 21 +- website/html/sitemap.xml | 33 +- website/html/tags/index.xml | 19 - 23 files changed, 449 insertions(+), 119 deletions(-) create mode 100644 website/html/blog/atlantis-release/index.html create mode 100644 website/html/img/apply-comment.png create mode 100644 website/html/img/approval-needed.png create mode 100644 website/html/img/atlantis-flow.png create mode 100644 website/html/img/atlantis-highquality.png create mode 100644 website/html/img/comment.png create mode 100644 website/html/img/demo-large.gif create mode 100644 website/html/img/demo.gif create mode 100644 website/html/img/diff-output.png create mode 100644 website/html/img/diff.png create mode 100644 website/html/img/master-flow.png create mode 100644 website/html/img/pull-request-flow.png diff --git a/website/html/blog/atlantis-release/index.html b/website/html/blog/atlantis-release/index.html new file mode 100644 index 000000000..5da53d938 --- /dev/null +++ b/website/html/blog/atlantis-release/index.html @@ -0,0 +1,367 @@ + + + + + + + + + Atlantis: A Unified Workflow For Collaborating On Terraform + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+ Atlantis +
+ + +
+
+
+ + + + + + + + + + + + +
+

Atlantis: A Unified Workflow For Collaborating On Terraform

+ +
Why we built Atlantis and how it's enabled us to more effectively collaborate on Terraform
+ + +
+
+
+ + + +

We’re very excited to announce the open source release of Atlantis! Atlantis is a tool for collaborating on Terraform that’s been in use at Hootsuite for over a year. The core functionality of Atlantis enables developers and operators to run terraform plan and apply directly from Terraform pull requests. Atlantis then comments back on the pull request with the output of the commands:

+ +

+ +

This is a simple feature, however it has had a massive effect on how our team writes Terraform. By bringing a Terraform workflow to pull requests, Atlantis helped our Ops team collaborate better on Terraform and also enabled our entire development team to write and execute Terraform safely.

+ +

Atlantis was built to solve two problems that arose at Hootsuite as we adopted Terraform:

+ +
+
+ Collaborate +

1. Effective Collaboration

+

What's the best way to collaborate on Terraform in a team setting?

+
+
+ No need to distribute credentials +

2. Developers Writing Terraform

+

How can we enable our developers to write and apply Terraform safely?

+
+
+ +

Effective Collaboration

+ +

When writing Terraform, there are a number of workflows you can follow. The simplest workflow is just using master:

+ +

+ +

+ +

In this workflow, you work on master and run terraform locally. The problem with this workflow is that there is no collaboration or code review. So we start to use pull requests:

+ +

+ +

We still run terraform plan locally, but once we’re satisfied with the changes we create a pull request for review. When the pull request is approved, we run apply locally.

+ +

This workflow is an improvement, but there are still problems. The first problem is that it’s hard to review just the diff on the pull request. To properly review a change, you really need to see the output from terraform plan.

+ + +
+ + What looks like a small change... + + +
+

+ What looks like a small change... + + + +

+
+ +
+ + + +
+ + ...can have a big plan + + +
+

+ ...can have a big plan + + + +

+
+ +
+ + +

The second problem is that now it’s easy for master to get out of sync with what’s actually been applied. This can happen if you merge a pull request without running apply or if the apply has an error halfway through, you forget to fix it and then you merge to master. Now what’s in master isn’t actually what’s running on production. At best, this causes confusion the next time someone runs terraform plan. At worst, it causes an outage when someone assumes that what’s in master is actually running, and depends on it.

+ +

With the Atlantis workflow, these problems are solved:

+ +

+ +

Now it’s easy to review changes because you see the terraform plan output on the pull request.

+ + +
+ + Pull requests are easy to review since you can see the plan + + +
+

+ Pull requests are easy to review since you can see the plan + + + +

+
+ +
+ + +

It’s also easy to ensure that the pull request is terraform apply’d before merging to master because you can see the actual apply output on the pull request.

+ + +
+ + + + +
+ + +

So, Atlantis makes working on Terraform within an operations team much easier, but how does it help with getting your whole team to write Terraform?

+ +

Developers Writing Terraform

+ +

Terraform usually starts out being used by the Ops team. As a result of using Terraform, the Ops team becomes much faster at making infrastructure changes, but the way developers request those changes remains the same: they use a ticketing system or chat to ask operations for help, the request goes into a queue and later Ops responds that the task is complete.

+ +

Soon however, the Ops team starts to realize that it’s possible for developers to make some of these Terraform changes themselves! There are some problems that arise though:

+ +
    +
  • Developers don’t have the credentials to actually run Terraform commands
    • +
  • If you give them credentials, it’s hard to review what is actually being applied
    • +
+ +

With Atlantis, these problems are solved. All terraform plan and apply commands are run from the pull request. This means developers don’t need to have any credentials to run Terraform locally. Of course, this can be dangerous: how can you ensure developers (who might be new to Terraform) aren’t applying things they shouldn’t? The answer is code reviews and approvals.

+ +

Since Atlantis comments back with the plan output directly on the pull request, it’s easy for an operations engineer to review exactly what changes will be applied. And Atlantis can run in require-approval mode, that will require a GitHub pull request approval before allowing apply to be run:

+ +

+ +

With Atlantis, developers are able to write and apply Terraform safely. They submit pull requests, can run atlantis plan until their change looks good and then get approval from Ops to apply.

+ +

Since the introduction of Atlantis at Hootsuite, we’ve had 78 contributors to our Terraform repositories, 58 of whom are developers (75%).

+ +

Where we are now

+ +

Since the introduction of Atlantis at Hootsuite we’ve grown to 144 Terraform repositories1 that manage thousands of Amazon resources. Atlantis is used for every single Terraform change throughout our organization.

+ +

Getting started with Atlantis

+ +

If you’d like to try out Atlantis for your team you can download the latest release from https://github.com/hootsuite/atlantis/releases. If you run atlantis bootstrap you can get started in less than 5 minutes. +To read more about Atlantis go to https://github.com/hootsuite/atlantis.

+ +

Check out our video for more information: + +

+ +
+

+ +

Icons made by Prosymbols and Freepik from www.flaticon.com are licensed by CC 3.0 BY

+
+ +
+ +
    +
  1. We split our Terraform up into multiple states, each with its own repository (see 1, 2, 3). + [return]
    2. +
+
+ + +
+ + + + +
+

+ Published + + + by + + + + + + using 872 words. +

+ + + + + +
+ + + +
+
+
+ + + + + + + + + diff --git a/website/html/blog/index.html b/website/html/blog/index.html index aa47341a1..89645bbf6 100644 --- a/website/html/blog/index.html +++ b/website/html/blog/index.html @@ -29,7 +29,7 @@ - + @@ -92,9 +92,9 @@
  • Blog
    • -
  • Docs
    • +
  • Docs
    • -
  • FAQ
    • +
  • FAQ
  • Demo
    • @@ -112,17 +112,16 @@

    Blog

    -

    Coming soon....