Building a Docker container inside CloudShell and pushing it to an Amazon ECR repository (original) (raw)

Building a Docker container inside CloudShell and pushing it to an Amazon ECR repository - AWS CloudShell

Prerequisites Tutorial procedure Clean up

This tutorial shows you how to define and build a Docker container in AWS CloudShell and push it to an Amazon ECR repository.

Prerequisites

You must have the necessary permissions to create and push to an Amazon ECR repository. For more information about repositories with Amazon ECR, see Amazon ECR private repositories in the Amazon ECR User Guide. For more information about the permissions required for pushing images with Amazon ECR, see Required IAM permissions for pushing an image in the_Amazon ECR User Guide_.

Tutorial procedure

The following tutorial outlines how to use the CloudShell interface to build a Docker container and push it to an Amazon ECR repository.

Create a new folder in your home directory.

mkdir ~/docker-cli-tutorial

Navigate to the folder you created.

cd ~/docker-cli-tutorial

Create an empty Dockerfile.

touch Dockerfile

Using a text editor, for example nano Dockerfile, open the file and paste the following content into it.

# Dockerfile  
# Base this container on the latest Amazon Linux version  
FROM public.ecr.aws/amazonlinux/amazonlinux:latest  
# Install the cowsay binary  
RUN dnf install --assumeyes cowsay  
# Default entrypoint binary  
ENTRYPOINT [ "cowsay" ]  
# Default argument for the cowsay entrypoint  
CMD [ "Hello, World!" ]

The Dockerfile is now ready to be built. Build the container by running docker build. Tag the container with an easy-to-type name for use in future commands.

docker build --tag test-container .

Make sure to include the trailing period (.).
Image of the docker build command run inside AWS CloudShell. 6. You can now test the container to check that it is running correctly in AWS CloudShell.

docker container run test-container

Image of the docker container run command inside AWS CloudShell 7. Now that you have a functioning Docker container, you need to push it to an Amazon ECR repository. If you have an existing Amazon ECR repository, you can skip this step.
Run the following command to create an Amazon ECR repository for this tutorial.

ECR_REPO_NAME=docker-tutorial-repo  
aws ecr create-repository --repository-name ${ECR_REPO_NAME}

Image of the command used to create an Amazon ECR repository inside AWS CloudShell 8. After you create the Amazon ECR repository, you can push the Docker container to it.
Run the following command to get the Amazon ECR sign-in credentials for Docker.

AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query "Account" --output text)  
ECR_URL=${AWS_ACCOUNT_ID}.dkr.ecr.${AWS_REGION}.amazonaws.com  
aws ecr get-login-password | docker login --username AWS --password-stdin ${ECR_URL}

Image of the command used to get the Amazon ECR sign-in credentials for Docker.

Note

If the AWS_REGION environment variable is not set in your CloudShell or you want to interact with resources in other AWS Regions, run the following command:

AWS_REGION=<your-desired-region>

Tag the image with the target Amazon ECR repository and then push it to that repository.

docker tag test-container <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mrow><mi>E</mi><mi>C</mi><msub><mi>R</mi><mi>U</mi></msub><mi>R</mi><mi>L</mi></mrow><mi mathvariant="normal">/</mi></mrow><annotation encoding="application/x-tex">{ECR_URL}/</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mord"><span class="mord mathnormal" style="margin-right:0.07153em;">EC</span><span class="mord"><span class="mord mathnormal" style="margin-right:0.00773em;">R</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.3283em;"><span style="top:-2.55em;margin-left:-0.0077em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mathnormal mtight" style="margin-right:0.10903em;">U</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mord mathnormal" style="margin-right:0.00773em;">R</span><span class="mord mathnormal">L</span></span><span class="mord">/</span></span></span></span>{ECR_REPO_NAME}  
docker push <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mrow><mi>E</mi><mi>C</mi><msub><mi>R</mi><mi>U</mi></msub><mi>R</mi><mi>L</mi></mrow><mi mathvariant="normal">/</mi></mrow><annotation encoding="application/x-tex">{ECR_URL}/</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mord"><span class="mord mathnormal" style="margin-right:0.07153em;">EC</span><span class="mord"><span class="mord mathnormal" style="margin-right:0.00773em;">R</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.3283em;"><span style="top:-2.55em;margin-left:-0.0077em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mathnormal mtight" style="margin-right:0.10903em;">U</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mord mathnormal" style="margin-right:0.00773em;">R</span><span class="mord mathnormal">L</span></span><span class="mord">/</span></span></span></span>{ECR_REPO_NAME}

Image of the command used to tag the image with the target Amazon ECR repository.
If you encounter errors or run into issues when trying to complete this tutorial, see the Troubleshooting section of this guide for help.

Clean up

You have now successfully deployed your Docker container to your Amazon ECR repository. To remove the files you created in this tutorial from your AWS CloudShell environment, run the following command.

cd ~
rm -rf ~/docker-cli-tutorial

* Delete the Amazon ECR repository.

aws ecr delete-repository --force --repository-name ${ECR_REPO_NAME}

```

Tutorial: Creating presigned URLs

Tutorial: Deploying a Lambda function using the AWS CDK

Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.