Skip to main content

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​

AttributeValue
ApplicationCloudController-{env} (e.g., CloudController-staging)
Environment{env}-cloud-controller-{env}-AL2023 (e.g., staging-cloud-controller-staging-AL2023)
PlatformPython 3.9 on Amazon Linux 2
Instance Typet3.small
Health ReportingEnhanced
ALBImplicit (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​

SymptomCheck
Environment degradeddescribe-environment-health for instance-level health
Deployment faileddescribe-events for recent deployment errors
Config issuedescribe-configuration-settings for env vars
App errorsRequest and retrieve tail logs, or check CloudWatch