🐍 Python

  1. Verify Python 3 Installation
    Make sure Python 3 is installed on your machine.

  2. Create a Virtual Environment
    Use a virtual environment to keep dependencies isolated:

    python3 -m venv venv
    source venv/bin/activate   # macOS/Linux
    venv\Scripts\activate      # Windows
    

🏗️ Terraform

  1. Install Terraform
    brew tap hashicorp/tap
    brew install hashicorp/tap/terraform
    terraform --version
    

    To upgrade:

    brew upgrade hashicorp/tap/terraform
    
  2. Install Terragrunt
    brew install terragrunt
    terragrunt --version
    

    To upgrade:

    brew upgrade terragrunt
    

☁️ AWS

AWS CLI

AWS CLI is required for AWS SSO authentication and managing AWS resources.

  1. Install AWS CLI

    macOS:

    brew install awscli
    

    Linux:

    curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
    unzip awscliv2.zip
    sudo ./aws/install
    

    Windows: Download and run the AWS CLI MSI installer from https://aws.amazon.com/cli/

  2. Verify Installation
    aws --version
    
  3. Upgrade AWS CLI (if needed)

    macOS:

    brew upgrade awscli
    

    Linux/Windows: Follow the same installation steps above to upgrade to the latest version.

AWS SSO Access

Follow the documentation here for detailed steps on setting up AWS SSO access.

💡 Note: You will need to configure an AWS profile that matches the aws.profile value in your config.yaml file (default: "Solution-Architects.User-979559056307").

Initial File Setup

  1. Copy Files
    • Duplicate the airbnb folder and rename it with your customer name.
    • For a fully managed solution, keep all folders.
    • For a hybrid approach, which doesn’t include VSCode Online, remove the eks-cluster folder.

Prerequisites complete? Head to Environment: Configuration to configure your deployment!