<div id="readability-page-1" class="page"><section itemprop="text">
        
        

<h4 id="recommend-posts-before-this">RECOMMEND POSTS BEFORE THIS</h4>

<ul>
  <li><a href="https://junhyunny.github.io/aws/aws-alb-and-target-group-setup/">AWS ALB(Application Load Balancer) and Target Group Setup</a></li>
</ul>

<h2 id="0-들어가면서">0. 들어가면서</h2>

<p>ECS(Elastic Container Service) 클러스터를 구축하려면 컨테이너 이미지가 필요하다. 컨테이너 이미지는 도커 허브(docker hub) 같은 이미지 레포지토리가 필요하다. AWS 클라우드에서 제공하는 이미지 저장소인 ECR(Elastic Container Registry) 컴포넌트를 제공한다. 이번 글에선 AWS ECR 레포지토리를 생성하고 이미지를 푸시(push)하는 방법에 대해 정리한다.</p>

<h2 id="1-aws-ecrelastic-container-registry">1. AWS ECR(Elastic Container Registry)</h2>

<p>ECR는 컨테이너 이미지를 저장할 수 있는 AWS 클라우드 서비스이다. ECS 서비스는 IAM(Identity and Access Management)을 통해 인가 처리가 가능한 프라이빗 레포지토리(private repository)를 제공한다. 프라이빗 레포지토리인만큼 지정된 사용자 또는 EC2 인스턴스가 ECR 레포지토리 및 이미지에 접근할 수 있다. ECR 서비스는 퍼블릭 레포지토리(public repository)도 지원한다.</p>

<h2 id="2-create-ecr-private-repository">2. Create ECR Private Repository</h2>

<p>이제 프라이빗 레포지토리를 만들어보자. <code>ECR 대시보드</code>에서 프라이빗 레지스트리의 레포지토리 화면으로 이동한다.</p>

<p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-01.png">
</p>



<p>해당 화면에서 기존에 운영 중인 레포지토리 정보를 확인할 수 있다. 이 화면에서 레포지토리를 생성할 수 있다.</p>

<ul>
  <li><code>Create repository</code> 버튼을 누른다.</li>
</ul>

<p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-02.png" width="80%">
</p>



<p>레포지토리 생성 화면에서 레포지토리를 생성한다.</p>

<ul>
  <li>레포지토리 가시성 세팅은 <code>Private</code>을 선택한다.</li>
  <li>레포지토리 이름은 <code>demo-service</code>으로 정한다.</li>
  <li><code>Create repository</code> 버튼을 누른다.</li>
</ul>

<div>
  <p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-03.png" width="80%">
  </p>
  <p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-04.png" width="80%">
  </p>
</div>

<h2 id="3-push-container-image">3. Push Container Image</h2>

<p>레포지토리가 생성되면 이미지를 업로드 할 수 있다. 이미지를 업로드하는 명령어는 레포지토리 화면 상단 <code>View push commands</code> 버튼을 누르면 확인할 수 있다.</p>

<p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-05.png" width="80%">
</p>



<p>프라이빗 레포지토리에 이미지를 푸시하기 위해선 인증 과정이 필요하다. 터미널에서 도커 명령어로 해당 프라이빗 레포지토리에 로그인 한 이후 이미지를 푸시해야 한다.</p>

<ol>
  <li>ECR 프라이빗 레포지토리 로그인</li>
  <li>이미지 생성</li>
  <li>태그 이름 변경</li>
  <li>이미지 푸시</li>
</ol>

<p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-06.png" width="80%">
</p>



<p>필자는 회사에서 제공하는 AWS 샌드박스(sandbox) 환경을 사용하고 있다. 루트 사용자가 아니기 때문에 터미널에서 aws CLI 명령어를 사용하기 위해선 AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN 같은 정보가 필요하다. 다음 명령어로 발급 받은 시크릿 정보를 환경 변수에 추가한다.</p>

<div><pre><code>export AWS_ACCESS_KEY_ID=value_access_key_id¸
export AWS_SECRET_ACCESS_KEY=value_secret_access_key
export AWS_SESSION_TOKEN=value_session_token
</code></pre></div>

<p>환경 변수를 추가하고 로그인을 수행하면 다음과 같이 성공했다는 로그를 볼 수 있다.</p>

<div><pre><code>$ aws ecr get-login-password --region ap-northeast-2 | docker login --username AWS --password-stdin 1234567890.dkr.ecr.ap-northeast-2.amazonaws.com

Login Succeeded
</code></pre></div>

<p>해당 실습을 진행하려면 애플리케이션 이미지가 필요하다. 필자는 간단한 TODO LIST 애플리케이션 이미지를 만들어 실습을 진행했다. 예제 코드는 이 <a href="https://github.com/Junhyunny/blog-in-action/tree/master/2024-08-07-aws-ecr-setup/action-in-blog">레포지토리</a>에서 확인할 수 있다. 해당 프로젝트 루트 경로에서 도커 이미지를 생성할 수 있다.</p>

<div><pre><code>$ docker build -t demo-service .
 [+] Building 24.5s (29/29) FINISHED                                                                       docker:desktop-linux
  =&gt; [internal] load build definition from Dockerfile                                                                      0.0s
  =&gt; =&gt; transferring dockerfile: 795B                                                                                      0.0s
  =&gt; [internal] load metadata for docker.io/library/openjdk:17-jdk-slim  

...

  =&gt; exporting to image 0.1s
  =&gt; =&gt; exporting layers0.1s
  =&gt; =&gt; writing image sha256:a72f69ef8f4edd26a3ee9aad9ca870eedac4e6107d74b504a35534ca8d25c5a7                              0.0s
  =&gt; =&gt; naming to docker.io/library/demo-service                                                                           0.0s
 
 View build details: docker-desktop://dashboard/build/desktop-linux/desktop-linux/g5p5wdsantsghhh8gsvd622u9
 
 What's next:
     View a summary of image vulnerabilities and recommendations → docker scout quickview 
</code></pre></div>

<p>이미지 빌드가 완료되면 다음 명령어를 사용해 이미지를 업로드한다.</p>

<ul>
  <li>ECR 레포지토리를 위한 태그 이름을 갖는 이미지를 만든다.</li>
  <li>해당 이미지를 푸시한다.</li>
</ul>

<div><pre><code>$ docker tag demo-service:latest 1234567890.dkr.ecr.ap-northeast-2.amazonaws.com/demo-service:latest

$ docker push 1234567890.dkr.ecr.ap-northeast-2.amazonaws.com/demo-service:latest
The push refers to repository [1234567890.dkr.ecr.ap-northeast-2.amazonaws.com/demo-service]
a0251f32f17d: Pushed 
1344044c94da: Pushed 
c82e5bf37b8a: Pushed 
2f263e87cb11: Pushed 
f941f90e71a8: Pushed 
latest: digest: sha256:4c4690abd7fee0279c58aa7227cfd66143cf74283d33f555844eff9271be7a65 size: 1371
</code></pre></div>

<p>이미지가 업로드 되면 AWS 웹 콘솔에서 확인할 수 있다.</p>

<p><img src="https://junhyunny.github.io/images/posts/2024/aws-ecr-setup-07.png" width="80%">
</p>

<h4 id="test-code-repository">TEST CODE REPOSITORY</h4>

<ul>
  <li><a href="https://github.com/Junhyunny/blog-in-action/tree/master/2024-08-07-aws-ecr-setup/action-in-blog">https://github.com/Junhyunny/blog-in-action/tree/master/2024-08-07-aws-ecr-setup/action-in-blog</a></li>
</ul>

<h4 id="recommend-next-posts">RECOMMEND NEXT POSTS</h4>

<ul>
  <li><a href="https://docs.aws.amazon.com/ko_kr/AmazonECR/latest/userguide/what-is-ecr.html">https://docs.aws.amazon.com/ko_kr/AmazonECR/latest/userguide/what-is-ecr.html</a></li>
</ul>

<h4 id="reference">REFERENCE</h4>


        
      </section></div>

Junhyunny's Devlogs

RECOMMEND POSTS BEFORE THIS
AWS ALB(Application Load Balancer) and Target Group Setup
0. 들어가면서
ECS(Elastic Container Service) 클러스터를 구축하려면 컨테이너 이미지가 필요하다. 컨테이너 이미지는 도커 허브(docker hub) 같은 이미지 레포지토리가 필요하다. AWS 클라우드에서 제공하는 이미지 저장소인 ECR(Elastic Container Registry) 컴포넌트를 제공한다. 이번 글에선 AWS ECR 레포지토리를 생성하고 이미지를 푸시(push)하는 방법에 대해 정리한다.
1. AWS ECR(Elastic Container Registry)
ECR는 컨테이너 이미지를 저장할 수 있는 AWS 클라우드 서비스이다. ECS 서비스는 IAM(Identity and Access Management)을 통해 인가 처리가 가능한 프라이빗 레포지토리(private repository)를 제공한다. 프라이빗 레포지토리인만큼 지정된 사용자 또는 EC2 인스턴스가 ECR 레포지토리 및 이미지에 접근할 수 있다. ECR 서비스는 퍼블릭 레포지토리(public repository)도 지원한다.
2. Create ECR Private Repository
이제 프라이빗 레포지토리를 만들어보자. ECR 대시보드에서 프라이빗 레지스트리의 레포지토리 화면으로 이동한다.
해당 화면에서 기존에 운영 중인 레포지토리 정보를 확인할 수 있다. 이 화면에서 레포지토리를 생성할 수 있다.
Create repository 버튼을 누른다.
레포지토리 생성 화면에서 레포지토리를 생성한다.
레포지토리 가시성 세팅은 Private을 선택한다.
레포지토리 이름은 demo-service으로 정한다.
Create repository 버튼을 누른다.
3. Push Container Image
레포지토리가 생성되면 이미지를 업로드 할 수 있다. 이미지를 업로드하는 명령어는 레포지토리 화면 상단 View push commands 버튼을 누르면 확인할 수 있다.
프라이빗 레포지토리에 이미지를 푸시하기 위해선 인증 과정이 필요하다. 터미널에서 도커 명령어로 해당 프라이빗 레포지토리에 로그인 한 이후 이미지를 푸시해야 한다.
ECR 프라이빗 레포지토리 로그인
이미지 생성
태그 이름 변경
이미지 푸시
필자는 회사에서 제공하는 AWS 샌드박스(sandbox) 환경을 사용하고 있다. 루트 사용자가 아니기 때문에 터미널에서 aws CLI 명령어를 사용하기 위해선 AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN 같은 정보가 필요하다. 다음 명령어로 발급 받은 시크릿 정보를 환경 변수에 추가한다.
export AWS_ACCESS_KEY_ID=value_access_key_id¸
export AWS_SECRET_ACCESS_KEY=value_secret_access_key
export AWS_SESSION_TOKEN=value_session_token
환경 변수를 추가하고 로그인을 수행하면 다음과 같이 성공했다는 로그를 볼 수 있다.
$ aws ecr get-login-password --region ap-northeast-2 | docker login --username AWS --password-stdin 1234567890.dkr.ecr.ap-northeast-2.amazonaws.com
Login Succeeded
해당 실습을 진행하려면 애플리케이션 이미지가 필요하다. 필자는 간단한 TODO LIST 애플리케이션 이미지를 만들어 실습을 진행했다. 예제 코드는 이 레포지토리에서 확인할 수 있다. 해당 프로젝트 루트 경로에서 도커 이미지를 생성할 수 있다.
$ docker build -t demo-service .
 [+] Building 24.5s (29/29) FINISHED                                                                       docker:desktop-linux
  => [internal] load build definition from Dockerfile                                                                      0.0s
  => => transferring dockerfile: 795B                                                                                      0.0s
  => [internal] load metadata for docker.io/library/openjdk:17-jdk-slim  
...
  => exporting to image 0.1s
  => => exporting layers0.1s
  => => writing image sha256:a72f69ef8f4edd26a3ee9aad9ca870eedac4e6107d74b504a35534ca8d25c5a7                              0.0s
  => => naming to docker.io/library/demo-service                                                                           0.0s
 
 View build details: docker-desktop://dashboard/build/desktop-linux/desktop-linux/g5p5wdsantsghhh8gsvd622u9
 
 What's next:
     View a summary of image vulnerabilities and recommendations → docker scout quickview 
이미지 빌드가 완료되면 다음 명령어를 사용해 이미지를 업로드한다.
ECR 레포지토리를 위한 태그 이름을 갖는 이미지를 만든다.
해당 이미지를 푸시한다.
$ docker tag demo-service:latest 1234567890.dkr.ecr.ap-northeast-2.amazonaws.com/demo-service:latest
$ docker push 1234567890.dkr.ecr.ap-northeast-2.amazonaws.com/demo-service:latest
The push refers to repository [1234567890.dkr.ecr.ap-northeast-2.amazonaws.com/demo-service]
a0251f32f17d: Pushed 
1344044c94da: Pushed 
c82e5bf37b8a: Pushed 
2f263e87cb11: Pushed 
f941f90e71a8: Pushed 
latest: digest: sha256:4c4690abd7fee0279c58aa7227cfd66143cf74283d33f555844eff9271be7a65 size: 1371
이미지가 업로드 되면 AWS 웹 콘솔에서 확인할 수 있다.
TEST CODE REPOSITORY
https://github.com/Junhyunny/blog-in-action/tree/master/2024-08-07-aws-ecr-setup/action-in-blog
RECOMMEND NEXT POSTS
https://docs.aws.amazon.com/ko_kr/AmazonECR/latest/userguide/what-is-ecr.html
REFERENCE

AWS ECR(Elastic Container Registry) Setup

댓글