Skip to main content

Scripted Infrastructure Deployment

The aws-terraform.sh script automates the deployment of infrastructure for AI/Run CodeMie on AWS.

Prerequisites​

Ensure you have completed all items in the Prerequisites checklist.

Deployment Order​

The script deploys resources in the following order:

#Resource nameRepository
1IAM deployer rolecodemie-terraform-aws-iam
2Main AWS resourcescodemie-terraform-aws-platform

Step 1: IAM Deployer Role Creation​

This step creates the DeployerRole AWS IAM role that will be used for all subsequent infrastructure deployments.

info

The created IAM role contains required permissions to manage AWS resources

  1. Clone the IAM repository:
git clone https://gitbud.epam.com/epm-cdme/codemie-terraform-aws-iam.git
cd codemie-terraform-aws-iam
  1. Review input variables in codemie-terraform-aws-iam/variables.tf and create a terraform.tfvars file:
region               = "your-region"
role_arn             = "arn:aws:iam::xxx:role/yourRole"
platform_domain_name = "your.domain"
...
info

Ensure you have carefully reviewed all variables and replaced mock values with yours.

  1. Initialize and apply Terraform:
terraform init
terraform plan
terraform apply

Step 2: Run Installation Script​

  1. Clone the platform repository:
git clone https://gitbud.epam.com/epm-cdme/codemie-terraform-aws-platform.git
cd codemie-terraform-aws-platform
  1. Fill in configuration details in deployment.conf:
# AI/Run CodeMie deployment variables configuration
AWS_PROFILE="My_Profile"

# AWS region where the platform will be deployed
TF_VAR_region="eu-west-2"

# AWS IAM Role ARN for the deployment you created on a previous step
TF_VAR_role_arn="arn:aws:iam::123456789012:role/AIRunDeployerRole"

# The domain name for the platform
TF_VAR_platform_domain_name="codemie.example.com"

# The name of the AWS IAM Role to be used to access the EKS cluster
TF_VAR_eks_admin_role_arn=""

# The name of the policy that defines the permissions boundary
TF_VAR_role_permissions_boundary_arn=""

TF_VAR_cluster_version="1.33"
TF_VAR_demand_instance_types='[{ instance_type = "r5.xlarge" }]'
TF_VAR_demand_max_nodes_count=2
TF_VAR_demand_desired_nodes_count=2
TF_VAR_demand_min_nodes_count=2
TF_VAR_platform_name="codemie"
TF_VAR_subnet_azs='["eu-west-2a", "eu-west-2b", "eu-west-2c"]'
TF_VAR_s3_states_bucket_name="codemie-terraform-states"
TF_VAR_table_name="codemie_terraform_locks"
TF_VAR_enable_private_connections=true

# List of optional prefix lists IDs for ALB and NLB to create security group from
TF_VAR_lb_prefix_list_ids='[]'

# List of optional specific IP addresses/CIDR blocks to allow access from to ALB and NLB
TF_VAR_lb_specific_ips='[]'

# Additional optional security group IDs to attach to ALB and NLB
TF_VAR_security_group_ids='[]'
  1. Run the installation script:
bash aws-terraform.sh

What the Script Does​

After execution, the script will:

1. Validate Environment​

  • Check for required tools (tfenv, AWS CLI)
  • Verify AWS authentication status
  • Validate configuration parameters

2. Deploy Infrastructure​

  • Create Terraform backend storage (S3 bucket and DynamoDB table)
  • Deploy core AI/Run CodeMie Platform infrastructure
  • Set up necessary AWS resources

3. Generate Outputs​

The script creates a deployment_outputs.env file with essential infrastructure details:

# Platform Outputs
AWS_DEFAULT_REGION=eu-west-2
EKS_AWS_ROLE_ARN=arn:aws:iam::123456789012:role/...
AWS_KMS_KEY_ID=12345678-90ab-cdef-1234-567890abcdef
AWS_S3_BUCKET_NAME=codemie-platform-bucket

# RDS Database Outputs
CODEMIE_POSTGRES_DATABASE_HOST=codemie-rds.123456789012.eu-west-2.rds.amazonaws.com
CODEMIE_POSTGRES_DATABASE_PORT=5432
CODEMIE_POSTGRES_DATABASE_NAME=codemie
CODEMIE_POSTGRES_DATABASE_USER=dbadmin
CODEMIE_POSTGRES_DATABASE_PASSWORD="password"

4. Complete Deployment​

  • Success message confirms deployment
  • Logs available in logs/codemie_aws_deployment_YYYY-MM-DD-HHMMSS.log
  • Summary of deployed resources displayed
Security

Keep the deployment_outputs.env file secure as it contains sensitive information. Do not commit it to version control.

Next Steps​

After successful deployment, proceed to Components Deployment to install AI/Run CodeMie application components.