Elastic Beanstalk

The Controller application runs on Elastic Beanstalk (Python/Django).

Quick Reference

# List environments
aws elasticbeanstalk describe-environments --query 'Environments[].[EnvironmentName,Status,Health,HealthStatus]' --output table

# Get environment details
aws elasticbeanstalk describe-environments --environment-names staging-cloud-controller-staging-AL2023

# Get environment config (env vars, instance type, etc.)
aws elasticbeanstalk describe-configuration-settings --application-name CloudController-staging --environment-name staging-cloud-controller-staging-AL2023

# Get recent events
aws elasticbeanstalk describe-events --environment-name staging-cloud-controller-staging-AL2023 --max-items 20

# Check health
aws elasticbeanstalk describe-environment-health --environment-name staging-cloud-controller-staging-AL2023 --attribute-names All

Environment Details

Attribute	Value
Application	CloudController-{env} (e.g., CloudController-staging)
Environment	{env}-cloud-controller-{env}-AL2023 (e.g., staging-cloud-controller-staging-AL2023)
Platform	Python 3.9 on Amazon Linux 2
Instance Type	t3.small
Health Reporting	Enhanced
ALB	Implicit (managed by EBS)

Key Env Var Sources

The controller gets most secrets from AWS Secrets Manager at {env}/CloudController and {env}/EncryptionSecretKey.

Logs

# Request logs from instances
aws elasticbeanstalk request-environment-info --environment-name staging-cloud-controller-staging-AL2023 --info-type tail

# Then retrieve them
aws elasticbeanstalk retrieve-environment-info --environment-name staging-cloud-controller-staging-AL2023 --info-type tail

Or check CloudWatch directly: /aws/elasticbeanstalk/{environment-name}/.

What to Look For

Symptom	Check
Environment degraded	describe-environment-health for instance-level health
Deployment failed	describe-events for recent deployment errors
Config issue	describe-configuration-settings for env vars
App errors	Request and retrieve tail logs, or check CloudWatch