이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Cloud Build를 사용하여 Cloud Run에 배포

이 페이지에서는 Cloud Build를 사용하여 Cloud Run 서비스를 자동 배포하는 방법을 설명합니다. Cloud Build를 처음 사용하는 경우 빠른 시작 및 빌드 구성 개요를 먼저 읽어보세요.

Cloud Run을 사용하면 서버리스 환경에서 스테이트리스(Stateless) 이미지를 실행할 수 있습니다. Cloud Build를 사용하면 Artifact Registry의 이미지를 Cloud Run에 배포할 수 있습니다. 기존 이미지를 배포하거나, 이미지를 빌드하고 배포하거나, 배포를 자동화할 수 있습니다.

시작하기 전에

Enable the Cloud Build, Cloud Run, Artifact Registry, and Resource Manager APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs

애플리케이션 소스 코드를 준비합니다. 소스 코드는 GitHub 또는 Bitbucket과 같은 저장소에 저장되어야 합니다.
이 페이지에서 gcloud 명령어를 실행하려면 Google Cloud CLI를 설치합니다.
VPC 서비스 제어를 사용하는 경우 VPC 서비스 제어 경계에 비공개 풀을 설정합니다. 또한 VPC 서비스 제어에 대해 Cloud Run을 구성해야 합니다.

필요한 Identity and Access Management 권한

Google Cloud 콘솔에서 Cloud Build 권한 페이지로 이동합니다.
권한으로 이동
지정된 Cloud Build 서비스 계정 또는 기본 Cloud Build 서비스 계정의 경우 다음 역할의 상태를 사용 설정됨으로 설정합니다.
- Cloud Run 관리자 (roles/run.admin) | Cloud Build가 Cloud Run에 새 서비스를 배포할 수 있습니다.
  - '서비스 계정 사용자 역할 할당' 패널에서 가장할 서비스 계정을 선택한 다음 권한 부여를 클릭합니다.
- 스토리지 관리자 (roles/storage.admin) | Cloud Storage에서 읽기 및 쓰기를 사용 설정합니다.
- Artifact Registry 작성자 (roles/artifactregistry.writer) | Artifact Registry에서 이미지를 가져오고 Artifact Registry에 이미지를 쓸 수 있습니다.
- 로그 작성자 (roles/logging.logWriter) | 로그 항목을 Cloud Logging에 쓸 수 있습니다.
- Cloud Build 편집자 (roles/cloudbuild.builds.editor) | 서비스 계정이 빌드를 실행할 수 있도록 허용합니다.

이미지 빌드 및 배포

Cloud Build를 사용하면 이미지를 빌드하고 빌드된 이미지를 Artifact Registry에 저장한 다음 Cloud Run에 이미지를 배포할 수 있습니다.

이미지를 빌드하고 배포하려면 다음 안내를 따르세요.

프로젝트 루트 디렉터리에 cloudbuild.yaml이라는 구성 파일을 만듭니다.
빌드 구성 파일에 이미지를 빌드하고 Artifact Registry로 푸시하는 docker 빌드 단계를 추가한 다음 gcloud run deploy 명령어를 호출하여 Cloud Run에 이미지를 배포하는 gcloud 빌드 단계를 추가합니다.
```
steps:
# Build the image
- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE', '.']
# Push the image to Artifact Registry
- name: 'gcr.io/cloud-builders/docker'
  args: ['push', 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE']
# Deploy image to Cloud Run
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: gcloud
  args: ['run', 'deploy', 'SERVICE_NAME', '--image', 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE', '--region', 'SERVICE_REGION']
images:
- 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE'
```
각 항목의 의미는 다음과 같습니다.
- REPOSITORY은 이미지를 배포하는 Artifact Registry 저장소의 이름입니다.
- LOCATION은 Artifact Registry 저장소의 위치입니다(예: us-east1).
- PROJECT_ID는 이미지가 저장된 Google Cloud 프로젝트 ID입니다.
- SERVICE_NAME은 Cloud Run 서비스의 이름입니다.
- SERVICE_REGION은 배포하는 Cloud Run 서비스의 리전입니다.
- IMAGE는 Artifact Registry에 있는 이미지의 이름입니다.
프로젝트 루트 디렉터리로 이동하여 다음 명령어를 실행합니다. 여기서 LOCATION은 빌드를 실행할 지원되는 빌드 리전 중 하나입니다.
```
 gcloud builds submit --region=LOCATION
```

성공적으로 완료되면 배포된 서비스의 URL이 포함된 성공 메시지가 표시됩니다.

지속적 배포

Cloud Build 트리거를 만들어 Cloud Run으로 소프트웨어를 배포하는 과정을 자동화할 수 있습니다. 트리거를 구성하면 소스 코드를 업데이트할 때마다 이미지를 빌드하고 배포할 수 있습니다.

배포를 자동화하려면 다음 안내를 따르세요.

저장소 루트의 cloudbuild.yaml 구성 파일에 이미지를 빌드하고, 이 이미지를 Artifact Registry로 푸시한 다음 gcloud run deploy 명령어를 호출하는 단계를 추가합니다.

steps:
# Build the image
- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE/SERVICE_NAME:$COMMIT_SHA', '.']
# Push the image to Artifact Registry
- name: 'gcr.io/cloud-builders/docker'
  args: ['push', 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE/SERVICE_NAME:$COMMIT_SHA']
# Deploy image to Cloud Run
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: gcloud
  args: 
    - 'run'
    - 'deploy'
    - 'SERVICE_NAME'
    - '--image'
    - 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE/SERVICE_NAME:$COMMIT_SHA'
    - '--region'
    - 'SERVICE_REGION'
images:
- 'LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE/SERVICE_NAME:$COMMIT_SHA'

각 항목의 의미는 다음과 같습니다.

REPOSITORY은 이미지를 배포하는 Artifact Registry 저장소의 이름입니다.
LOCATION은 Artifact Registry 저장소의 위치입니다(예: us-east1).
PROJECT_ID는 이미지가 저장된 Google Cloud 프로젝트 ID입니다.
SERVICE_NAME은 Cloud Run 서비스의 이름입니다.
SERVICE_REGION은 배포하는 Cloud Run 서비스의 리전입니다.
IMAGE는 Artifact Registry에 있는 이미지의 이름입니다.

$COMMIT_SHA 대체 변수는 Git 저장소에서 트리거될 때 Cloud Build로 채워집니다.

이전 단계에서 만든 구성 파일을 사용하여 빌드 트리거를 만듭니다.
1. 트리거 페이지를 엽니다.
  
  트리거 페이지로 이동
2. 트리거 만들기를 클릭합니다.
3. 이름 필드에 트리거 이름을 입력합니다.
4. 리전 아래에서 트리거의 리전을 선택합니다.
  
  참고: 트리거의 리전은 배포하려는 Cloud Run 서비스의 리전과 일치해야 합니다.
5. 이벤트 아래에서 트리거를 시작할 저장소 이벤트를 선택합니다.
6. 소스 아래에서 저장소를 선택하고 트리거를 시작할 분기 또는 태그 이름을 선택합니다. 자동 빌드할 분기 지정에 대한 자세한 내용은 빌드 트리거 만들기를 참조하세요.
7. 구성 아래에서 Cloud Build 구성 파일(yaml 또는 json)을 선택합니다.
8. Cloud Build 구성 파일 위치 필드에 /와 cloudbuild.yaml을 차례로 입력합니다.
9. 만들기를 클릭하여 빌드 트리거를 저장합니다.
이제 저장소에 새 코드를 푸시하면 Cloud Build가 빌드를 호출하고 서비스를 Cloud Run에 배포합니다.

Cloud Build 트리거 생성에 대한 자세한 내용은 빌드 트리거 생성 및 관리를 참조하세요.

코드 예시

다음은 각각 샘플 애플리케이션과 그 애플리케이션을 Cloud Run에 배포하는 빌드 구성 파일을 포함하는 몇몇 샘플 저장소입니다.

deploy-prebuilt: Cloud Run에 사전 빌드된 이미지를 배포하는 방법을 보여주는 코드 예시입니다.
run-example-builddeploy: Cloud Run에 이미지를 빌드하고 배포하는 방법을 보여주는 코드 예시입니다.

다음 단계

Cloud Deploy를 사용하여 Cloud Run 배포 방법 알아보기
GKE에 배포하는 방법 알아보기
Cloud Run Functions에 배포하는 방법 알아보기
App Engine에 배포하는 방법 알아보기
Firebase에 배포하는 방법 알아보기
Compute Engine에서 블루-그린 배포를 수행하는 방법을 알아봅니다.
빌드 오류 문제 해결 방법 알아보기