<div id="readability-page-1" class="page"><div><div aria-hidden="false"><a rel="noopener follow" href="/?source=post_page---byline--876b5a20aff9---------------------------------------"><div><p><img alt="이상문" src="https://miro.medium.com/v2/resize:fill:64:64/1*PdFTYwkEj-ebxhH52VWJ8w.png" width="32" height="32" loading="lazy" data-testid="authorPhoto"></p></div></a></div><p id="038d">이 글에서 Google Cloud Platform(GCP)에서 <strong>Cloud Run</strong> 서비스를 사용하여 컨테이너 이미지를 배포하고, 이미지 목록 확인 및 삭제, 자동 배포 설정 등 이미지 관리를 위한 필수 작업들을 정리한다. 특히 여기에서는 <strong>Container Registry (</strong><code><strong>gcr.io</strong></code><strong>) 기반의 작업 기준</strong>으로 정리한다. 현재 구글에서는 Artifact Registry 기반의 처리를 권장하고 있다고 하니 추후에는 이 방식으로의 전환이 필요할지도 모르겠다.</p><h2 id="05fc">1. 컨테이너 이미지 목록 확인하기 (Container Registry 기준)</h2><pre><span id="ec6e">gcloud container images list --repository=gcr.io/PROJECT_ID</span></pre><ul><li id="b2ab"><code>PROJECT_ID</code>: GCP 프로젝트 ID</li></ul><h2 id="eeff">예시</h2><pre><span id="059c">gcloud container images list --repository=gcr.io/my-project</span></pre><p id="e71b">개별 이미지의 태그 목록을 확인하려면,</p><pre><span id="69a3">gcloud container images list-tags gcr.io/PROJECT_ID/IMAGE_NAME</span></pre><h2 id="df96">2. 컨테이너 이미지 삭제하기 (Container Registry 기준)</h2><pre><span id="dc6b">gcloud container images delete gcr.io/PROJECT_ID/IMAGE_NAME:TAG</span></pre><h2 id="a4a7">예시</h2><pre><span id="7403">gcloud container images delete gcr.io/my-project/my-app:latest</span></pre><blockquote><p id="0152"><em>참고: 기본적으로 </em><code><em>gcloud container images delete</em></code><em>는 지정한 태그만 삭제하며, 이미지 자체는 다른 태그가 존재할 경우 남아 있게 된다. 만약 </em><strong><em>용량 확보가 필요하거나 이미지가 더 이상 전혀 필요하지 않다면</em></strong><em> </em><code><em>--force-delete-tags</em></code><em> 옵션을 추가해 </em><strong><em>모든 태그를 강제로 삭제하고 이미지 레이어까지 완전히 제거</em></strong><em>해야 한다.</em></p><p id="fe47"><em>사용 예:</em></p></blockquote><pre><span id="5209">gcloud container images delete gcr.io/my-project/my-app:latest - force-delete-tags</span></pre><h2 id="8f0f">3. Cloud Run에 컨테이너 이미지 배포하기</h2><p id="884f">Cloud Run에 컨테이너를 수동으로 배포하려면 다음 명령어를 사용한다.</p><pre><span id="0000">gcloud run deploy SERVICE_NAME \<br>  --image=gcr.io/PROJECT_ID/IMAGE_NAME:TAG \<br>  --platform=managed \<br>  --region=REGION \<br>  --allow-unauthenticated</span></pre><ul><li id="ceae"><code>SERVICE_NAME</code>: Cloud Run 서비스 이름</li><li id="734f"><code>REGION</code>: 예: asia-northeast3</li></ul><h2 id="2aa2">예시</h2><pre><span id="638e">gcloud run deploy my-service \<br>  --image=gcr.io/my-project/my-app:latest \<br>  --region=asia-northeast3 --platform=managed --allow-unauthenticated</span></pre><h2 id="3520">4. Cloud Run 서비스 이름 확인하기</h2><p id="feb9">Cloud Run에 이미지를 배포할 때 사용하는 <code>SERVICE_NAME</code>은 기존에 생성된 Cloud Run 서비스 이름이거나, 새로운 이름을 지정할 수도 있다. 배포 명령어(<code>gcloud run deploy</code>)에서 사용되는 <code>SERVICE_NAME</code>이 현재 어떤 것들이 존재하는지 확인하려면 다음 명령어를 사용할 수 있다.</p><p id="7cc6">현재 프로젝트에 배포된 Cloud Run 서비스 목록은 다음 명령어로 확인하면 된다.</p><pre><span id="5365">gcloud run services list --platform=managed --region=REGION</span></pre><h2 id="7834">예시</h2><pre><span id="2c92">gcloud run services list --region=asia-northeast3</span></pre><h2 id="bc7b">5. 이미지 빌드시 자동 배포 설정하기</h2><p id="eb64"><strong>Cloud Build</strong>와 <strong>Cloud Run</strong>을 연동하여 코드 커밋 시 자동으로 이미지를 빌드하고 배포할 수 있다.</p><h2 id="58d4">cloudbuild.yaml 예시 (Container Registry 기준)</h2><p id="94c1">참고: <code>$COMMIT_SHA</code>는 Cloud Build에서 자동으로 제공하는 환경 변수로, 커밋의 SHA 해시 값을 의미한다. 이를 이미지 태그로 사용하면 커밋 단위로 이미지를 고유하게 관리할 수 있다.</p><pre><span id="8b59">steps:<br>- name: 'gcr.io/cloud-builders/docker'<br>  args: ['build', '-t', 'gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA', '.']<br>- name: 'gcr.io/cloud-builders/docker'<br>  args: ['push', 'gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA']<br>- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'<br>  entrypoint: 'gcloud'<br>  args: ['run', 'deploy', 'my-service',<br>         '--image=gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA',<br>         '--region=asia-northeast3', '--platform=managed', '--allow-unauthenticated']<br>images:<br>- 'gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA'</span></pre><h2 id="938b">Cloud Build 트리거 연결 방법</h2><ol><li id="7bf4">GCP 콘솔에서 <a href="https://console.cloud.google.com/cloud-build/triggers" rel="noopener ugc nofollow" target="_blank">Cloud Build 트리거 페이지</a>로 이동한다.</li><li id="bd9c"><strong>“트리거 만들기”</strong> 버튼을 클릭한다.</li><li id="e305">이름, 설명 등을 입력하고, <strong>소스 리포지토리(GitHub 또는 Cloud Source Repositories)</strong> 를 선택한다.</li><li id="84bd">이벤트 유형 (예: 브랜치에 push) 과 대상 브랜치를 지정한다.</li><li id="5cc2"><strong>빌드 구성 파일 유형</strong>으로 <code>cloudbuild.yaml</code> 선택하고, 경로를 지정한다 (기본값: 루트).</li><li id="717c">저장하면 설정이 완료되며, 이후 조건에 맞는 커밋이 발생할 때마다 자동으로 빌드 및 Cloud Run에 배포된다.</li></ol><p id="4871">이 트리거 설정을 통해 소스 코드 푸시 시점에 자동 배포를 구현할 수 있다.</p></div></div>

Stories by 이상문 on Medium

이 글에서 Google Cloud Platform(GCP)에서 Cloud Run 서비스를 사용하여 컨테이너 이미지를 배포하고, 이미지 목록 확인 및 삭제, 자동 배포 설정 등 이미지 관리를 위한 필수 작업들을 정리한다. 특히 여기에서는 Container Registry (gcr.io) 기반의 작업 기준으로 정리한다. 현재 구글에서는 Artifact Registry 기반의 처리를 권장하고 있다고 하니 추후에는 이 방식으로의 전환이 필요할지도 모르겠다.
1. 컨테이너 이미지 목록 확인하기 (Container Registry 기준)
gcloud container images list --repository=gcr.io/PROJECT_ID
PROJECT_ID: GCP 프로젝트 ID
예시
gcloud container images list --repository=gcr.io/my-project
개별 이미지의 태그 목록을 확인하려면,
gcloud container images list-tags gcr.io/PROJECT_ID/IMAGE_NAME
2. 컨테이너 이미지 삭제하기 (Container Registry 기준)
gcloud container images delete gcr.io/PROJECT_ID/IMAGE_NAME:TAG
예시
gcloud container images delete gcr.io/my-project/my-app:latest
참고: 기본적으로 gcloud container images delete는 지정한 태그만 삭제하며, 이미지 자체는 다른 태그가 존재할 경우 남아 있게 된다. 만약 용량 확보가 필요하거나 이미지가 더 이상 전혀 필요하지 않다면 --force-delete-tags 옵션을 추가해 모든 태그를 강제로 삭제하고 이미지 레이어까지 완전히 제거해야 한다.
사용 예:
gcloud container images delete gcr.io/my-project/my-app:latest - force-delete-tags
3. Cloud Run에 컨테이너 이미지 배포하기
Cloud Run에 컨테이너를 수동으로 배포하려면 다음 명령어를 사용한다.
gcloud run deploy SERVICE_NAME \
  --image=gcr.io/PROJECT_ID/IMAGE_NAME:TAG \
  --platform=managed \
  --region=REGION \
  --allow-unauthenticated
SERVICE_NAME: Cloud Run 서비스 이름
REGION: 예: asia-northeast3
예시
gcloud run deploy my-service \
  --image=gcr.io/my-project/my-app:latest \
  --region=asia-northeast3 --platform=managed --allow-unauthenticated
4. Cloud Run 서비스 이름 확인하기
Cloud Run에 이미지를 배포할 때 사용하는 SERVICE_NAME은 기존에 생성된 Cloud Run 서비스 이름이거나, 새로운 이름을 지정할 수도 있다. 배포 명령어(gcloud run deploy)에서 사용되는 SERVICE_NAME이 현재 어떤 것들이 존재하는지 확인하려면 다음 명령어를 사용할 수 있다.
현재 프로젝트에 배포된 Cloud Run 서비스 목록은 다음 명령어로 확인하면 된다.
gcloud run services list --platform=managed --region=REGION
예시
gcloud run services list --region=asia-northeast3
5. 이미지 빌드시 자동 배포 설정하기
Cloud Build와 Cloud Run을 연동하여 코드 커밋 시 자동으로 이미지를 빌드하고 배포할 수 있다.
cloudbuild.yaml 예시 (Container Registry 기준)
참고: $COMMIT_SHA는 Cloud Build에서 자동으로 제공하는 환경 변수로, 커밋의 SHA 해시 값을 의미한다. 이를 이미지 태그로 사용하면 커밋 단위로 이미지를 고유하게 관리할 수 있다.
steps:
- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA', '.']
- name: 'gcr.io/cloud-builders/docker'
  args: ['push', 'gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA']
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'gcloud'
  args: ['run', 'deploy', 'my-service',
         '--image=gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA',
         '--region=asia-northeast3', '--platform=managed', '--allow-unauthenticated']
images:
- 'gcr.io/$PROJECT_ID/my-app:$COMMIT_SHA'
Cloud Build 트리거 연결 방법
GCP 콘솔에서 Cloud Build 트리거 페이지로 이동한다.
“트리거 만들기” 버튼을 클릭한다.
이름, 설명 등을 입력하고, 소스 리포지토리(GitHub 또는 Cloud Source Repositories) 를 선택한다.
이벤트 유형 (예: 브랜치에 push) 과 대상 브랜치를 지정한다.
빌드 구성 파일 유형으로 cloudbuild.yaml 선택하고, 경로를 지정한다 (기본값: 루트).
저장하면 설정이 완료되며, 이후 조건에 맞는 커밋이 발생할 때마다 자동으로 빌드 및 Cloud Run에 배포된다.
이 트리거 설정을 통해 소스 코드 푸시 시점에 자동 배포를 구현할 수 있다.

Google Cloud Run에서 컨테이너 이미지 배포 및 관리 가이드

댓글