{"id":1644,"date":"2022-06-22T11:09:33","date_gmt":"2022-06-22T11:09:33","guid":{"rendered":"https:\/\/www.checkmateq.com\/blog\/?p=1644"},"modified":"2023-08-06T15:33:47","modified_gmt":"2023-08-06T15:33:47","slug":"build-docker-image-to-aws-ecr","status":"publish","type":"post","link":"https:\/\/www.checkmateq.com\/blog\/build-docker-image-to-aws-ecr","title":{"rendered":"How to Build a Docker Image and Push it To AWS ECR?"},"content":{"rendered":"

Why do we need docker container?<\/h3>\n

Did you ever listened of a problem from your teammates that the code you have shared is not working but it was perfectly alright when you used it, ok ,let’s understand this with a practical scenario , assume you are a developer in your organization ,you have developed a new feature and it’s perfectly working for you and you forwarded it to testing team for testing , then you get a reply from them that the newly added feature is not at all working for them, what went wrong here ? , may be the testing team do not have the dependencies required or even though they installed all the required dependencies but a different version or you are working on latest version of OS and they are using older versions, to overcome these kind of problems we have got a solution called containerization. A Container packages<\/b>\u00a0up code and all the required dependencies so that the application runs without any error from one computing environment to another, then what is Docker?<\/p>\n

Docker<\/strong> is an open source and free containerization platform, It allows full stack developers<\/a> to package applications into executable components by combining application source code with the operating system\u00a0 libraries and dependencies required to execute that code in any environment, developers can also create containers without using docker, but docker\u00a0 makes it easier\u00a0 to build, deploy cicd pipeline and manage containers using simple commands, you can create a docker container using a docker image, docker images act as a set of instructions or a template to build a Docker container, you can compare a docker image to a snapshot in virtual machine environments, where you can take a snapshot of VM and create similar ones. you can share these images with your team or publicly by uploading them to a container registry there are many container registries in this blog we will look into AWS Elastic Container Registry<\/p>\n

Elastic Container Registry<\/strong><\/h3>\n

ECR is fully managed docker container registry provided by AWS<\/a> for hosting docker images , so you need not to worry about hosting your own private\u00a0 container registry , AWS will take care of underline infrastructure like scalability and high availability\u00a0 , and where ever you are going to deploy your docker container like Kubernetes or amazon EKS those container orchestration platform can pull the image from amazon ECS, follow below procedure to create a repository in AWS and upload an Image to it.<\/p>\n

In this blog we will create a docker image in an AWS ec2 instance and upload it to Amazon Elastic Container Registry,\u00a0<\/strong>if you are using your local machine skip step-3 from the whole process and if want to create an AWS ec2 instance refer this blog<\/a><\/p>\n

Step-1: Create ECR cluster<\/b><\/h3>\n

Login to your aws cloud console search for ECR and click on it.<\/p>\n

\"\"<\/p>\n

Click on “Get Started” under Create a repository<\/p>\n

\"\"<\/p>\n

Select ‘Public’ or ‘Private’ under Visibility settings, if you select public your repository will be accessible by everyone to pull the stored images and for private you can give access using IAM roles, for the purpose of this blog I am creating a private repository, give a name to your container repository.<\/p>\n

\"\"<\/p>\n

Click on the name or ECR you have created<\/p>\n

\"\"<\/p>\n

then click on view push commands, it will show you the commands to login in to ECR, create a docker image and how to tag it and push it to your container repository.<\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

Now let’s see how to Create a Docker image and push it to ECR<\/p>\n

Step-2: Writing a Dockerfile\u00a0<\/b><\/h3>\n

before writing a Dockerfile let’s install docker first, use below command to install docker on your compute instance.<\/p>\n

yum install docker -y<\/pre>\n
Check the installation using below given command.<\/p>\n
docker --version<\/pre>\n
This command gives installed version of docker.<\/p>\n
\"\"<\/p>\n
Create a file named Docker in the root folder of the application, every time you create a new docker file create it in new directory and the file name should be starting with capital “D”, use below command to create Dockerfile where vi is an editor and copy the following syntax into the file and save it.<\/p>\n
vi Dockerfile<\/p>\n
Dockerfile<\/strong><\/p>\n
#Installing apache server on ubuntu\r\nFROM ubuntu\r\nRUN apt-get update\r\nRUN apt-get install apache2 -y\r\nRUN apt-get install apache2-utils -y\r\nRUN apt-get clean\r\nEXPOSE 80\r\nCMD [\"apache2ctl\", \"-D\",\"FOREGROUND\"]\r\n<\/pre>\n
each line in Dockerfile is executed as individual step and creates a layer in the Docker image, let’s understand it by breaking down above given docker file which install apache on ubuntu.<\/p>\n
Line-1:<\/strong> #Installing apache server on ubuntu<\/p>\n
Start a line with “#” to write comments in a Dockerfile.<\/p>\n
Line-2:<\/strong>\u00a0 FROM ubuntu<\/p>\n
Most of the time you will not create a docker image from scratch, you may use a docker image as a base to build your required image. The FROM keyword tells Docker which base image to use to build the new image, you can only have comments above FROM line but no other commands, In the above given Dockerfile , Docker uses ubuntu image as a base and will perform rest of the things on it.<\/p>\n
Line-3: <\/strong>RUN apt-get update, RUN is used to give instructions to docker i.e., run a specific Linux command use RUN keyword.<\/p>\n
Line-7:\u00a0 <\/strong>EXPOSE 80, this instruction exposes particular port with a specified protocol(tcp\/udp) inside a docker Container.<\/p>\n
Line-8: <\/strong>CMD [“apache2ctl”, “-D”,”FOREGROUND”], instructions given with CMD will be executed only when a container is created, it has nothing to do with image building and you can always override these CMD instruction’s using external commands, in our case we are using it to run apache in background.<\/p>\n
Step-3: Allow EC2 instance to access ECR using IAM Role<\/strong><\/h3>\n
\u00a0<\/strong>To push your Docker image to ECR you have to connect to it, one of the ways to connect is using IAM role if you are using an AWS ec2 instance, if you are trying to access from your local machine use access key and secret key, as we are using an ec2 instance now let’s go and create a IAM role which allows our ec2 instance to access ECR registry.<\/p>\n
On your AWS console search for IAM and click on it, then on the left pane click on Roles <\/strong>under “Access management”.<\/p>\n
\"\"<\/p>\n
Click on ‘create role’<\/p>\n
\"\"<\/p>\n
Select “AWS service” for trusted entity and “EC2” for “Use case” as we are creating a role and attaching it our ec2 instance which allows it(instance) to access ECR, then click on “Next”.<\/p>\n
\"\"<\/p>\n
Search for policy AmazonEC2ContainerRegistryFullAccess\u00a0<\/strong> , select it and click on “Next”.<\/p>\n
\"\"<\/p>\n
Give a name to your role, scroll down and click on create role.<\/p>\n
\"\"<\/p>\n
Now assign the Role created to the ec2 instance in which you have docker image, go the ec2 instances select the instance and click on “Actions” and click on “Modify IAM role” under “Security”.<\/p>\n
\"\"<\/p>\n
select the role you have created with AmazonEC2ContainerRegistryFullAccess\u00a0<\/strong>and click on “Update IAM Role”<\/p>\n
\"\"<\/p>\n
Now the ec2 instance has full access to Amazon ECR,<\/p>\n
Step-4: Authenticate with ECR repository<\/strong><\/h3>\n
To push Image to ECR you need to authenticate with it, we will use an AWS CLI command to authenticate with the registry, install AWS cli on your ec2 instance using below commands<\/p>\n
curl \"https:\/\/awscli.amazonaws.com\/awscli-exe-linux-x86_64.zip\" -o \"awscliv2.zip\"\r\nsudo yum install unzip -y\r\nunzip awscliv2.zip\r\nsudo .\/aws\/install\r\n<\/pre>\n
Check your installation by executing below given command<\/p>\n
aws --version<\/pre>\n
\"\"<\/p>\n
Note<\/strong>:\u00a0 if you are using your local machine refer this blog<\/a> to configure your AWS CLI.<\/p>\n
Now go to your Repository and copy its URI.<\/p>\n
\"\"<\/p>\n
Use below command to retrieve the authentication details and authenticate with your registry<\/p>\n
aws ecr get-login-password --region ap-south-1<\/strong> | docker login --username AWS --password-stdin 109714447277.dkr.ecr.ap-south-1.amazonaws.com<\/strong><\/pre>\n
ap-south-1<\/strong> is the AWS region where I created my ECR, give your region here.<\/p>\n
109714447277.dkr.ecr.ap-south-1.amazonaws.com\u00a0<\/strong>is my ECR URI, exclude ECR name from the end of ECR URI, give your URI here.<\/p>\n
\"\"<\/p>\n
Step-5: Build Docker Image and Push it to ECR<\/strong><\/h3>\n
Go to the directory where your Docker file is located, use the command given below to build a docker image<\/p>\n
docker build -t apache-prac-ecr<\/strong> .<\/pre>\n
apache-prac-ecr<\/strong> is the name of image and “.” indicates that Docker file is in same path.<\/p>\n
\"\"<\/p>\n
Tag your image after the build is completed successfully.<\/p>\n
docker tag apache-prac-ecr:latest<\/strong> 109714447277.dkr.ecr.ap-south-1.amazonaws.com\/aksshaay-prac-ecr:latest<\/strong><\/pre>\n
By giving a tag for your Docker image it will be easy to pull and run images, in the above command latest is the tag.<\/p>\n
Finally push the Docker image to the repository, use command docker push <\/strong>along with ECR URI and repo name as shown below.<\/p>\n
docker push 109714447277.dkr.ecr.ap-south-1.amazonaws.com\/aksshaay-prac-ecr:latest<\/pre>\n
\"\"<\/p>\n
below is the (snapshot from my AWS web console) details of uploaded image to my repository.<\/p>\n
\"\"<\/p>\n
 <\/p>\n
Author Information<\/strong><\/p>\n
This blog is written by Checkmate DevOps team, you can connect with our Technical consultant to hire experienced DevOps engineer<\/a> to manage entire Infrastructure technical stack.<\/p>\n","protected":false},"excerpt":{"rendered":"
Why do we need docker container? Did you ever listened of a problem from your teammates that the code you have shared is not working but it was perfectly alright when you used it, ok ,let’s understand this with a practical scenario , assume you are a developer in your organization ,you have developed a … Continue reading “How to Build a Docker Image and Push it To AWS ECR?”<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":1843,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[65,3,2,64,66,7,22,59,11,63,23,24],"_links":{"self":[{"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/posts\/1644"}],"collection":[{"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/comments?post=1644"}],"version-history":[{"count":46,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/posts\/1644\/revisions"}],"predecessor-version":[{"id":4294,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/posts\/1644\/revisions\/4294"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/media\/1843"}],"wp:attachment":[{"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/media?parent=1644"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/categories?post=1644"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.checkmateq.com\/blog\/wp-json\/wp\/v2\/tags?post=1644"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}