How boltops-tools/ufo works
UFO is a Heroku-like command-line tool for working with AWS ECS. Its broad workflow is to configure an application, prepare a task definition and container image, and manage deployment and runtime operations. The tree also shows CloudFormation infrastructure generation, rollback, scaling, logs, hooks, and project setup. Sampled code confirms task-definition context loading, ECS service resource construction, and ECR authentication; most command-to-subsystem wiring was not shown, so those relationships are dashed and unverified.
Main entry points: cli.rb UFO commands · builder.rb Image build · ecs_service.rb Stack resources · context.rb Task context
Components 22
CLI workflows
- UFO commands
lib/ufo/cli.rb - Project setup
lib/ufo/cli/new/sequence.rb
Application setup
- Configuration
lib/ufo/config.rb - Config layering
lib/ufo/layering/layer.rb - Task context
lib/ufo/task_definition/context.rb - Task definitions
lib/ufo/task_definition/builder.rb - Deployment hooks
lib/ufo/hooks/runner.rb
Image and deployment
- Image build
lib/ufo/docker/builder.rb - Image push
lib/ufo/docker/pusher.rb - Build state
lib/ufo/docker/state/s3.rb - ECR login
lib/ufo/ecr/auth.rb - Stack deployment
lib/ufo/cfn/deploy.rb - Stack resources
lib/ufo/cfn/stack/builder/resources/ecs_service.rb
ECS operations
- ECS service
lib/ufo/ecs/service.rb - Runtime commands
lib/ufo/cli/ps.rb - Service logs
lib/ufo/cli/logs.rb - Service scaling
lib/ufo/cli/scale.rb - Rollback
lib/ufo/s3/rollback.rb
AWS integrations
- IAM roles
lib/ufo/iam_role/builder.rb - AWS clients
lib/ufo/aws_services.rb
Other components
- Operator
- AWS services
Connections 21
- Operator → UFO commands: invokes
- UFO commands → Project setup: creates projects
- UFO commands → Configuration: uses settings
- Task context → Config layering: loads layers
lib/ufo/task_definition/context.rb - Task context → Task definitions: provides context
- UFO commands → Task definitions: builds definitions
- UFO commands → Image build: builds images
- Image build → Image push: pushes image
- Image build → Build state: stores state
- Image push → ECR login: authenticates
- ECR login → AWS clients: gets ECR token
lib/ufo/ecr/auth.rb - AWS clients → AWS services: creates clients
lib/ufo/aws_services.rb - UFO commands → Stack deployment: deploys stack
- Stack deployment → Stack resources: uses resources
- Stack resources → ECS service: defines service
lib/ufo/cfn/stack/builder/resources/ecs_service.rb - Stack resources → IAM roles: defines roles
- UFO commands → Runtime commands: runs operations
- UFO commands → Service logs: fetches logs
- UFO commands → Service scaling: scales service
- UFO commands → Rollback: rolls back
- UFO commands → Deployment hooks: runs hooks