Skip to main content

Onboarding as a New Developer

This guide is intended to help new developers get up to speed with the Cloud Posse reference architecture. It covers the basics of the architecture, how to get started, and how to contribute. We assume you have a basic understanding of Terraform and AWS. We assume you are joining a team that is already using the Cloud Posse reference architecture that's been fully implemented in your AWS organization.

This guide assumes you have the following:

  • Terraform experience working with modules, providers, public registry, state backends, etc
  • AWS experience including a firm understanding of general concepts, IAM, the web console, etc
  • Existing AWS environment utilizing Cloud Posse's reference architecture

If this all sounds a little bit daunting, you may want to start by reviewing the Learning Resources.

If you're new to Terraform, we recommend starting with the Terraform documentation.

Quickstart

  1. Review the Toolchain
  2. AWS Access
  3. Setup Leapp
  4. Repository Access
  5. Configure Local Workstation
  6. Checkout Repository
  7. Build Geodesic
  8. Run the Container
  9. Test Atmos

Getting Started

1 Learn the Cloud Posse Toolchain

AI generated voice

3 Review our Kubernetes Toolchain (for EKS users)

4 How we Use Terraform (for developers)

5 Try a Training Exercise

  • Clone your company’s infrastructure repository
  • Review the components in your company’s infrastructure repository (e.g. infrastructure/components/terraform)
  • Review the stack configurations in your company’s infrastructure repository (e.g. infrastructure/stacks/)
  • Review the catalog configurations in your company’s infrastructure repository (e.g. infrastructure/stacks/catalog)

Developer Workflow

  1. Start a new feature branch
  2. Develop and test your changes locally in the sandbox account
  3. Push your changes to the feature branch
  4. Create a pull request
  5. Review the pull request
  6. Wait for tests to pass (or fix them)
  7. Seek approval from the team
  8. Merge the pull request
  9. Deploy the changes