https://github.com/langburd/devops-assignment
The example of 'Infrastructure as a code' approach for deploying simple Python application.
https://github.com/langburd/devops-assignment
Last synced: 3 months ago
JSON representation
The example of 'Infrastructure as a code' approach for deploying simple Python application.
- Host: GitHub
- URL: https://github.com/langburd/devops-assignment
- Owner: langburd
- License: mit
- Created: 2023-12-15T11:11:43.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-13T07:44:43.000Z (almost 2 years ago)
- Last Synced: 2024-09-13T20:29:47.451Z (almost 2 years ago)
- Language: HCL
- Homepage:
- Size: 101 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# DevOps Assignment
The requirements of the project are described in [REQUIREMENTS.md](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](https://pre-commit.com/) for linting, formatting and docs creation before the commit.
### `Setup`
- Install `pre-commit` using instructions [here](https://pre-commit.com/#installation)
- Install required tools
```shell
brew install tflint
brew install terraform-docs
```
- Install the hooks
```shell
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
```shell
pre-commit run -a
```
## Build the image and push it to the container registry
```shell
export CR_PAT=
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
```shell
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
```shell
terragrunt run-all init --working-dir=environments
terragrunt run-all plan --working-dir=environments
terragrunt run-all apply --working-dir=environments
```
## Deploy single resource
```shell
terragrunt apply --working-dir=environments//
```
## Deploy application only
```shell
terragrunt apply --working-dir=environments/aws/app
terragrunt apply --working-dir=environments/azure/app
```