diff --git a/terraform/aws/README.md b/terraform/aws/README.md index 50e8a4c..786194e 100644 --- a/terraform/aws/README.md +++ b/terraform/aws/README.md @@ -1,14 +1,18 @@ -## Terraform script to create AWS infrastructure for Databunker +## Terraform scripts to create AWS infrastructure for Databunker Terraform is a powerful tool to manage infrastructure with configuration files rather than through a graphical user interface. -We use Terraform scripts to streamline the installation of the following infrastructure elements: +We use Terraform scripts to streamline Databunker installation in production. + +These scripts create the following AWS infrastructure elements: 1. VPC 1. MySQL RDS 1. Elastic Kubernetes Service (EKS) 1. Security groups to allow connectivity -1. Generate random password for secure MySQL RDS access and save it as Kubernetes secret using the following resource path: **databunker-mysql-rds/db-password** + +During deployment, Terraform scripts generate a random password for secure MySQL RDS access and save it as Kubernetes secret using the following resource path: **databunker-mysql-rds/db-password**. + ### ⚡ How to set up everything @@ -46,17 +50,23 @@ helm install databunker databunker/databunker --set mariadb.enabled=false \ The **MYSQL-RDS-HOST** is the same as ```terraform output rds_hostname```. -### 🔍 View generated database password +### 🔍 View generated database password using terraform ``` terraform output rds_password ``` +### 🔍 View generated database password using kubernetes secret +``` +kubectl get secret databunker-mysql-rds -o json +``` + ### ⚙️ Troubleshooting +Different commands used to troubleshoot deployment: + ``` terraform destroy -target aws_eks_cluster.yuli-cluster terraform destroy -target module.eks.aws_eks_cluster.this\[0\] terraform destroy helm uninstall databunker kubectl get secret databunkertls -o json -kubectl get secret databunker-mysql-rds -o json ```