top of page

Tutorial blog to use Amazon EFS along with Amazon ECS

Learning objectives:

1. Learn to create an ECS cluster.

2. Learn to use EFS file system with ECS to access data across fleet of Amazon ECS tasks.

Step 1: In AWS management console, go to ECS service.

On the Clusters page, choose Create cluster.

Under Cluster configuration, for Cluster name, enter My-EFS for the cluster name.

Choose Infrastructure, uncheck AWS Fargate (serverless) and check the Amazon EC2 instances.

To create a Auto Scaling group, from Auto Scaling group (ASG), select Create new group, and then provide the following details about the group:

For Operating system/Architecture, choose Amazon Linux 2.

For EC2 instance type, choose t2.micro.

For Desired Capacity, enter Minimum 1 and Maximum 2.

For SSH key pair, choose the pair that proves your identity when you connect to the instance.

In Networking, under Security group choose Use an existing security group and remove the default security group and choose WebServer-SG.

If you don’t have the WebServer-SG security group, then follow the steps to create the security group.

In AWS management console, go to EC2 instance service.

In the navigation pane, under Network and Security choose Security groups.

Choose Create Security Group.

Security group name: WebServer-SG

Description: Security group for Web Servers

Inbound Rules: Add rule

Type: SSH


Select Add rule

Type: HTTP


Choose Create Security group

Step 2: Create a security group for your Amazon EFS file system with the following options:

In AWS management console, go to EC2 instance service.

In the navigation pane, under Network and Security choose Security groups.

Choose Create Security Group.

Security group name: EFS-SG

Description: Security group for EFS services.

Inbound Rules: Add rule

Type: NFS


Choose Create Security group

In AWS management console, go to EFS service.

Choose Create file system.

Name: my-EFS-system.

Keep VPC default and select Customize.

Scroll down to Performance Settings.

Throughput mode: Bursting.

Choose Next.

On the Network access page, under Mount targets, replace the existing security group configuration for every availability zone with the security group you created for the file system i.e., EFS-SG.

You do not need to configure File system policy for this tutorial, so you can skip the section by choosing Next.

Review your file system options and choose Create to complete the process.

From the File systems screen, record the File system ID. In the next step, you will reference this value in your Amazon ECS task definition.

Step 3: In AWS management console, go to EC2 instance service.

Choose Launch Instance.

Name: my-EFS-instance.

Under Application and OS Images (Amazon Machine Image), select the Amazon Linux 2 AMI (HVM).

Under Instance type, keep the default instance type, t2.micro.

Choose the Key Pair.

Under Network settings, choose Edit and choose a subnet.

Auto-assign public IP: Enable.

Select any available: subnet

Select existing Security group choose WebServer-SG.

Under Configure storage, choose the Edit button for file systems, and then choose EFS.

Clear the Automatically create and attach security groups. Leave the other check box selected. Choose Add shared file system.

Choose Launch Instance.

Step 4: Connect you my-EFS-instance to SSH.

Execute the following command.

df -T

Next command

cd /mnt/efs/fs1

Next command

sudo nano index.html

Paste the following code.



<h1>Hi from Cloud-plusplus</h1>

<p>You are using an Amazon EFS file system for persistent container storage.</p>



Save the file using Ctrl+X, then Y and Enter.

Step 5: In AWS management console, go to ECS service.

In the navigation pane, choose Task definitions.

Choose Create new task definition, Create new task definition with JSON.

In the JSON editor box, copy and paste the following JSON text, replacing the fileSystemId with the ID of your Amazon EFS file system.


"containerDefinitions": [


"memory": 128,

"portMappings": [


"hostPort": 80,

"containerPort": 80,

"protocol": "tcp"



"essential": true,

"mountPoints": [


"containerPath": "/usr/share/nginx/html",

"sourceVolume": "efs-html"



"name": "nginx",

"image": "nginx"



"volumes": [


"name": "efs-html",

"efsVolumeConfiguration": {

"fileSystemId": "fs-1324abcd",

"transitEncryption": "ENABLED"




"family": "efs-tutorial"


Choose Create.

Step 6: On the Clusters page, select the cluster to run the standalone task in.

Scroll down and choose the Tasks tab.

Choose Run a new task.

In Compute options, select Launch type.

For Launch type, choose EC2.

Under Deployment configuration, Application type choose Task.

For Task definition, choose the efs-tutorial task definition that you created earlier.

For Desired tasks, enter 1.

Choose Create.

On the Cluster page, scroll down choose Infrastructure.

Under Container Instances, choose the container instance to connect to.

On the Container Instance page, under Networking, record the Public IP for your instance.

Open a browser and enter the public IP address. You should see the following message:

Note: Delete the Cluster, Task definition, EFS, terminate the instance if you no longer need them.

Was this document helpful? How can we make this document better. Please provide your insights. You can download PDF version for reference.

Download PDF • 719KB

For your aws certification needs or for aws learning contact us.

Recent Posts

See All
bottom of page