DevOps Assignment

The requirements of the project are described in REQUIREMENTS.md

• The application is running in AWS EKS and Azure AKS clusters.
• The clusters are installed using IaC approach and managed by Terragrunt in environments directory.
• Terraform modules used by Terragrunt are located in modules directory.
• The application itself is located in app directory and deployed using the Helm chart located in helm directory.
• Since CI/CD processes are outside the scope of the current project, creating the image and pushing it to the container registry is done manually. As well as all infrastructure changes in Terraform and Terragrunt.

Pre-commit Hooks

This repo uses pre-commit hooks for linting, formatting and docs creation before the commit.

Setup

• Install pre-commit using instructions here
• Install required tools

brew install tflint
brew install terraform-docs

• Install the hooks

pre-commit install

Usage

The hooks will run automatically before every commit.
Updates the docs in each module's README.md and fixes formatting and linting with commands such as terraform fmt.
If you want to run the checks manually without committing, use the command

pre-commit run -a

Build the image and push it to the container registry

export CR_PAT=<github-token>
echo $CR_PAT | docker login ghcr.io -u langburd --password-stdin
REGISTRY=ghcr.io/langburd/devops-assignment
VERSION=$(cat helm/Chart.yaml| yq -r '.appVersion')
docker build --platform linux/amd64 -t $REGISTRY:$VERSION .
docker push $REGISTRY:$VERSION

Authenticate to AWS EKS and Azure AKS

touch $(pwd)/kubeconfig.yaml
chmod 600 $(pwd)/kubeconfig.yaml
export KUBECONFIG=$(pwd)/kubeconfig.yaml
# EKS
export AWS_PROFILE=devops-assignment
aws eks update-kubeconfig \
  --name "$(yq .inputs.cluster_name environments/aws/eks/tf_source_vars.yaml)"
# AKS
az login
az aks get-credentials \
  --resource-group "$(yq .resource_group_name environments/azure/env.yaml)" \
  --name "$(yq .inputs.cluster_name environments/azure/aks/tf_source_vars.yaml)" \
  --admin

Deploy all infrastructure and application resources

terragrunt run-all init --working-dir=environments
terragrunt run-all plan --working-dir=environments
terragrunt run-all apply --working-dir=environments

Deploy single resource

terragrunt apply --working-dir=environments/<env>/<resource>

Deploy application only

terragrunt apply --working-dir=environments/aws/app
terragrunt apply --working-dir=environments/azure/app