• Quick Setup
• Detailed Setup
  • Install
  • Configure
  • Approve
    • Approve Individual .envrc
    • Approve all .envrc
• Directory Structure

Edit the <cloud>/<environment>/.envrc files with the profiles, regions, and other settings for your environments:

"$EDITOR" aws/dev/.envrc

Then just run make from the top level directory to install direnv and approve all the .envrc files:

make

Now whenever you cd into one of the <cloud>/<environment> directories it'll automatically:

• configure your cloud CLI settings, such as your:
  • AWS:
    • profile
    • region
    • EKS cluster
  • GCP:
    • project
    • config configuration
    • region (even different regions per service)
    • GKE cluster
• switch your kubectl context to the right Kubernetes cluster
• set any other environment variables you've specified, such as
  • API keys for other services such as Cloudflare
  • AWS or GCP Secret Manager keys that tools use to pull secrets from

Install direnv.

For convenience you can just run:

make install

which will attempt to install direnv using whatever your local package manager is, or fall back to binary download.

Edit the <cloud>/<environment>/.envrc files with the profile config names, regions, kubernetes cluster names and other settings for your environments:

"$EDITOR" aws/dev/.envrc

Changes to an .envrc require (re)approval for safety.

See aws/README.md or gcp/README.md for more cloud specific information.

Approve the $PWD/.envrc changes in the current directory:

direnv allow

Alternatively approve one at a different path:

direnv allow path/to/.envrc

To approve all .envrc under the current directory tree, run this from the top level directory of this repo:

make allow

to direnv allow all the .envrc found in this repo's directory tree.

$ tree -a aws gcp aws ├── .envrc ├── README.md ├── dev │ └── .envrc ├── prod │ └── .envrc └── staging └── .envrc gcp ├── .envrc ├── README.md ├── dev │ └── .envrc ├── prod │ └── .envrc └── staging └── .envrc

The rest of my original source repos are here.

Pre-built Docker images are available on my DockerHub.