Skip to content

Upgrade AWS instructions to AL2023 #6183

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 16, 2025
Merged

Upgrade AWS instructions to AL2023 #6183

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7d20245
Upgrade AWS instructions to AL2023
CGarces Jun 11, 2025
0f3e813
Apply suggestions from code review
CGarces Jun 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 4 additions & 6 deletions docs/aws.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -348,14 +348,13 @@ The grandparent directory of the `aws` tool will be mounted into the container a

### Docker installation

Docker is required by Nextflow to execute tasks on AWS Batch. The **Amazon ECS-Optimized Amazon Linux 2 (AL2) x86_64 AMI** has Docker installed, however, if you create your AMI from a different AMI that does not have Docker installed, you will need to install it manually.
Docker is required by Nextflow to execute tasks on AWS Batch. The **Amazon ECS-optimized Amazon Linux 2023 AMI** has Docker installed, however, if you create your AMI from a different AMI that does not have Docker installed, you will need to install it manually.

The following snippet shows how to install Docker on an Amazon EC2 instance:

```bash
# install Docker
sudo yum update -y
sudo amazon-linux-extras install docker
sudo yum install docker

# start the Docker service
Expand All @@ -365,21 +364,20 @@ sudo service docker start
sudo usermod -a -G docker ec2-user
```

You may have to reboot your instance for the changes to `ec2-user` to take effect.
You must logging out and logging back in again to use the new `ec2-user` permissions.

These steps must be done *before* creating the AMI from the current EC2 instance.

### Amazon ECS container agent installation

The [ECS container agent](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_agent.html) is a component of Amazon Elastic Container Service (Amazon ECS) and is responsible for managing containers on behalf of ECS. AWS Batch uses ECS to execute containerized jobs, therefore it requires the agent to be installed on EC2 instances within your Compute Environments.

The ECS agent is included in the **Amazon ECS-Optimized Amazon Linux 2 (AL2) x86_64 AMI** . If you use a different base AMI, you can also install the agent on any EC2 instance that supports the Amazon ECS specification.
The ECS agent is included in the **Amazon ECS-optimized Amazon Linux 2023 AMI** . If you use a different base AMI, you can also install the agent on any EC2 instance that supports the Amazon ECS specification.

To install the agent, follow these steps:

```bash
sudo amazon-linux-extras disable docker
sudo amazon-linux-extras install -y ecs
sudo yum install ecs-init
sudo systemctl enable --now ecs
```

Expand Down