Copilot helps simplify AWS resources and automate deployments for projects.
This sample configuration runs the Open Assistant web app as an ECS Fargate services backed by a Serverless Aurora Postgres database.
Setup requires a few steps:
copilot app init --domain your_domain.com
This will initialize and register a variety of URLs with your your_domain.com
.
Replace with a proper domain to setup SSL certificates.
copilot env deploy
This will create a variety of aws roles and services needed for deployment.
copilot deploy
This will deploy the services but it won't be 100% ready for usage. Before being
ready, we have to inspect the AWS Secrets manager and extract out the database
credentials. Read those credentials then put them, and a few other secrets, in a
secrets.yml
file like the following:
DATABASE_URL:
staging: postgres://postgres:${db_password}@${db_host}:${db_port}/${db_name}
DISCORD_CLIENT_ID:
staging: ...
DISCORD_CLIENT_SECRET:
staging: ...
EMAIL_SERVER_HOST:
staging: ...
EMAIL_SERVER_PORT:
staging: ...
EMAIL_SERVER_USER:
staging: ...
EMAIL_SERVER_PASSWORD:
staging: ...
EMAIL_FROM:
staging: ...
FASTAPI_URL:
staging: ...
FASTAPI_KEY:
staging: ...
NEXTAUTH_SECRET:
staging: ...
Then, upload the secrets to AWS with:
copilot secret init --cli-input-yaml secrets.yml
Now, finally deploy:
copilot deploy
If we documented everything correctly, the site should work properly.
First, make sure the database is updated with any schema changes:
copilot task run \
--app open-assistant --env staging \
-n prisma-push \
--dockerfile docker/Dockerfile.prisma --build-context "./" \
--secrets DATABASE_URL=/copilot/open-assistant/staging/secrets/DATABASE_URL
Next, deploy everything:
copilot deploy
TODO: Make this a pipeline once github and aws are fully connected.