Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 2.37 KB

getting-started.md

File metadata and controls

121 lines (83 loc) · 2.37 KB

Overview

This document provides the initial environment setup required for working with this organization (e.g., llamandcoco). It covers the installation and configuration of essential tools for daily development, including shell productivity plugins, AWS SSO access, and Terraform version management.

Tools covered:

  • oh-my-zsh and recommended plugins
  • aws-vault (for secure AWS Identity Center / SSO login)
  • tfenv (Terraform version manager)
  • terragrunt (multi-environment Terraform workflows)

oh-my-zsh

Install oh-my-zsh

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Install Plugins

zsh-autosuggestions

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

fast-syntax-highlighting

git clone https://github.com/zdharma-continuum/fast-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/fast-syntax-highlighting

zsh-autocomplete

git clone --depth 1 https://github.com/marlonrichert/zsh-autocomplete.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autocomplete

Update .zshrc.

vim ~/.zshrc

Modify the plugins section:

plugins=(
  git
  zsh-autosuggestions
  fast-syntax-highlighting
  zsh-autocomplete
)

Apply the changes:

source ~/.zshrc

Install aws-vault

Install

brew install aws-vault

Configure AWS Identity Center (SSO)

Manually edit the AWS config file:

vim ~/.aws/config

Add your SSO profile:

[profile <PROFILE_NAME>]
sso_start_url  = https://<your-org>.awsapps.com/start
sso_region     = <aws-region>   # Region where Identity Center is hosted
sso_account_id = <account-id>
sso_role_name  = <role-name>
region         = <aws-region>   # Default AWS CLI region for resources

Tip

sso_region and region serve different purposes, and both are required.

Test login

aws-vault login <PROFILE_NAME>

tfenv

Install

brew install tfenv

Install and use a specific Terraform version

tfenv install 1.13.5
tfenv use 1.13.5

Terragrunt

Install

brew install terragrunt