Deployment tool for Amazon ECS
Project description
Deployment tool for Amazon ECS.
Installation
pip install ecs-deplojo
Usage
Usage: ecs-deplojo [OPTIONS]
Options:
--config FILENAME [required]
--var VAR
--dry-run
--output-path PATH
--role-arn <optional arn>
--help Show this message and exit.
Example configuration
---
cluster_name: example
environment:
DATABASE_URL: postgresql://
task_definitions:
web:
template: task_definitions/web.json
overrides:
uwsgi:
memory: 512
portMappings:
- hostPort: 0
containerPort: 8080
protocol: tcp
manage:
template: task_definitions/manage.json
services:
web:
task_definition: web
before_deploy:
- task_definition: manage
container: uwsgi
command: manage.py migrate --noinput
after_deploy:
- task_definition: manage
container: uwsgi
command: manage.py clearsessions
Using SSM secrets
When you want to use the AWS SSM secrets in your configuration you can use the secrets section, however this needs some additional configuration within AWS
At first you need an AWS IAM role to use as the ECS execution role, this role needs access to the secrets in Secrets Manager or Parameter store and will only be used during the startup of your Docker container.
Example configuration:
--
cluster_name: example
environment:
NORMAL_ENV_VAR: value_of_variable
secrets:
DATABASE_URL: /path/to/secret/DATABASE_URL
task_definitions:
web:
execution_role_arn: arn:aws:iam::<account_id>:role/execution_role_name
template: task_definitions/web.json
services:
web:
task_definition: web
When the container is started the secrets are available as environment variables and hidden in the AWS ECS console.
AWS Default VPC
When running your servers in the AWS default VPC you need networkMode="awsvpc" in your task definition JSON file, this will ensure that no hostnames are set for the containers, since this isn’t supported by AWS.
AWS Fargate
Unlike EC2 based clusters AWS Fargate needs a execution_role_arn to work, this can be set in your service definition in the YAML file.
Example log output
Starting deploy on cluster example (1 services)
Registered new task definition web:10
Starting one-off task 'manage.py migrate --noinput' via manage:10 (uwsgi)
Updating service web with task defintion web:10
Waiting for deployments
Waiting for services: web (0/2)
Waiting for services: web (1/2)
Waiting for services: web (2/2)
Deployment finished: web (2/2)
Starting one-off task 'manage.py clearsessions' via manage:10 (uwsgi)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ecs_deplojo-0.9.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0090e38a1ef7f5ff3dd0943eaf55e4c50e0985ab6f1f20748ca12886b7c469d3 |
|
MD5 | f4faaa574d29d23dc3c0b147ca65c498 |
|
BLAKE2b-256 | 6ae5cdee725a1a0de9dd7c01cc0adefa0c4f4e45f5cf2415b492a35ae1c88560 |