Console access to the running containers is via a 'Jumphost' in AWS, you will need
a digital-paas-production-account
, see hosting
documentation for instructions for obtaining this.
Once you have access, you can access a console by following these steps:
- sign in to AWS with your
digital-paas-production-account
account - select the correct AWS region, 'London (eu-west-2)'
- assume the role for the appropriate environment, see hosting documentation
You will need to make a note of the cluster name, ARN of the task and the container name:
First the cluster name:
- Locate Elastic Container Service (ECS) in the services menu
- You will see only a single cluster with a name that matches the environment,
e.g.
ODA-dev
for development - Note down the cluster name
Next, the task ARN:
- Click on the cluster
- Switch to the 'Tasks' tab
- Click on the copy icon for the first Task and make a note of it, it will be a long ARN string
And finally, the container name:
- Click on the task you copied the ARN of in the previous step
- Look at the list of containers, you will see the application and a 'SideCar',
make a note of the application container name, this is usually
ODA-app
You now have everything you need to use the console:
- Locate EC2 in the services menu
- In the sidebar, click on 'Instances'
- You will see a single 'Jumphost' instance for the environment, e.g.
Jumphost-dev
for development - Check that row and click the Connect button
- Switch to the Session Manager tab
- Click on the Connect button
- You will see a console on the Jumphost
You now have to connect to the container itself from the Jumphost:
Use the following command:
aws ecs execute-command --region [region] --cluster [cluster name] --task [task
arn] --container [container name] --command [command] --interactive
Where:
[region]
:eu-west-2
[cluster name]
: The cluster name you have noted down[task arn]
: The task ARN you have noted down[container name]
: The container name you have noted down[command]
:/bin/bash
AWS documentation for the aws ecs execute-command
- If you cannot see anything in ECS or EC2, you likely need to assume the correct role
- All variables are case sensitive