Welcome to Atlantis!

[mjbraun]

In this pull request we will learn how to use Atlantis.

1. In a couple of seconds you should see the output of Atlantis automatically running terraform plan.

2. You can manually run plan by typing a comment:

   atlantis plan
   

   Usually you'll let Atlantis automatically run plan for you though.

3. To see all the comment commands available, type:

   atlantis help
   

4. To see the help for a specific command, for example atlantis plan, type:

   atlantis plan --help
   

5. Atlantis holds a "Lock" on this directory to prevent other pull requests modifying
   the Terraform state until this pull request is merged. To view the lock, go to the Atlantis UI: http://localhost:4141.
   If you wanted, you could manually delete the plan and lock from the UI if you weren't ready to apply. Instead, we will apply it!

6. To terraform apply this change (which does nothing because it is creating a null_resource), type:

   atlantis apply
   

   NOTE: Because this example isn't using remote state storage the state will be lost once the pull request is merged. To use Atlantis properly, you must be using remote state.

7. Finally, merge the pull request to unlock this directory.

Thank you for trying out Atlantis! Next, try using Atlantis on your own repositories: www.runatlantis.io/guide/getting-started.html.

[mjbraun]

Ran Plan for dir: . workspace: default

Terraform used the selected providers to generate the following execution
plan. Resource actions are indicated with the following symbols:
+ create

Terraform will perform the following actions:

  # null_resource.example will be created
+ resource "null_resource" "example" {
      + id = (known after apply)
    }

Plan: 1 to add, 0 to change, 0 to destroy.

• ▶️ To apply this plan, comment:
  • atlantis apply -d .
• 🚮 To delete this plan click here
• 🔁 To plan this project again, comment:
  • atlantis plan -d .

---

• ⏩ To apply all unapplied plans from this pull request, comment:
  • atlantis apply
• 🚮 To delete all plans and locks for the PR, comment:
  • atlantis unlock

[mjbraun]

atlantis plan -d

[mjbraun]

Error: flag needs an argument: 'd' in -d.
Usage of plan:
  -d, --dir string         Which directory to run plan in relative to root of repo,
                           ex. 'child/dir'.
  -p, --project string     Which project to run plan for. Refers to the name of the
                           project configured in a repo config file. Cannot be used
                           at same time as workspace or dir flags.
      --verbose            Append Atlantis log to comment.
  -w, --workspace string   Switch to this Terraform workspace before planning.

[mjbraun]

atlantis plan -d .

[mjbraun]

Ran Plan for dir: . workspace: default

Terraform used the selected providers to generate the following execution
plan. Resource actions are indicated with the following symbols:
+ create

Terraform will perform the following actions:

  # null_resource.example will be created
+ resource "null_resource" "example" {
      + id = (known after apply)
    }

Plan: 1 to add, 0 to change, 0 to destroy.

• ▶️ To apply this plan, comment:
  • atlantis apply -d .
• 🚮 To delete this plan click here
• 🔁 To plan this project again, comment:
  • atlantis plan -d .

---

• ⏩ To apply all unapplied plans from this pull request, comment:
  • atlantis apply
• 🚮 To delete all plans and locks for the PR, comment:
  • atlantis unlock

[mjbraun]

atlantis apply -d .

[mjbraun]

Ran Apply for dir: . workspace: default

null_resource.example: Creating...
null_resource.example: Creation complete after 0s [id=874408125722372294]

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.