Skip to main content

Simple Atmos Tutorial

Easy

In this simple example, we will show you, how you can Terraform the weather. We won’t focus on more advanced concepts like configuring state backends or integrating with specific cloud providers, allowing us to concentrate on the core concepts of Atmos.

You're about to discover a new way to think about terraform...

You will learn

  1. How to set up a project repository to organize your Terraform code and configurations
  2. How to configure the Atmos CLI to work with the project
  3. Write a simple Terraform root module
  4. How to create stacks and configure the root module as a component of a stack
  5. Finally, how to deploy everything using Atmos

Spoiler alert You can’t actually change the weather with Terraform, but you can certainly ask for it.

We’ll use this example to avoid relying on complicated cloud credentials, which can vary based on your organizational context and cloud provider. Instead, we want to focus on Terraform and how to utilize it effectively as a component within Atmos. Once you understand this, you’ll see how to tailor your Terraform "root modules" to work seamlessly with Atmos.

NOTE: This tutorial is for those who prefer hands-on learning and want to create something tangible quickly. If you prefer to learn theory and concepts first, start with the Core Concepts.

Prerequisites

Here's what you'll need to get started with this tutorial.

Use GitHub Codespaces

You can try out atmos directly in your browser using GitHub Codespaces

We bundle all the examples and tools you need to get started with Atmos in a GitHub Codespace. Click the button below to start a new Codespace with the Atmos repository (it's FREE).

Open in GitHub Codespaces

Already start one? Find it here.

Then, when you're ready for a deeper understanding of using Atmos with Terraform, handling state management and working with AWS authentication, please refer to our advanced quick start guide.

Extra Credit

After you finish mastering the basics, maybe check out the "Extra Credit" exercises to learn how to...

What's Included

Start your first project in 5 easy steps. After this, you can configure and provision infrastructure with Terraform using Atmos.

Ready to learn this topic?

Start with the first step, which is configuring your project for Atmos. Configure Project