Cloud Deploy를 사용하여 Cloud Run에 앱 배포

Skaffold 구성 준비

Cloud Deploy는 Skaffold를 사용하여 배포할 항목의 세부정보와 별도의 대상에 적절하게 배포하는 방법을 제공합니다.

이 빠른 시작에서는 샘플 앱을 배포하는 데 사용할 Cloud Run 서비스나 작업 정의를 식별하는 skaffold.yaml 파일을 만듭니다.

1. 터미널 창을 엽니다.

2. deploy-run-quickstart라는 이름의 새 디렉터리를 만들고 디렉터리로 이동합니다.

   mkdir deploy-run-quickstart
   cd deploy-run-quickstart
   

3. 다음 콘텐츠로 skaffold.yaml라는 파일을 만듭니다.

   서비스

   apiVersion: skaffold/v4beta7
   kind: Config
   metadata: 
     name: deploy-run-quickstart
   profiles:
   - name: dev
     manifests:
       rawYaml:
       - run-service-dev.yaml
   - name: prod
     manifests:
       rawYaml:
       - run-service-prod.yaml
   deploy:
     cloudrun: {}
   

   작업

   apiVersion: skaffold/v4beta7
   kind: Config
   metadata: 
     name: deploy-run-quickstart
   profiles:
   - name: dev
     manifests:
       rawYaml:
       - run-job-dev.yaml
   - name: prod
     manifests:
       rawYaml:
       - run-job-prod.yaml
   deploy:
     cloudrun: {}
   

   이 파일은 Cloud Run 서비스나 작업을 식별하는 최소한의 Skaffold 구성입니다. 이 파일에 대한 자세한 내용은 skaffold.yaml 참조를 확인하세요.

Cloud Run 서비스 또는 작업 준비

이 빠른 시작에서는 같은 프로젝트에 서로 다른 Cloud Run 서비스 2개나 Cloud Run 작업 2개를 만듭니다. Cloud Deploy는 여러 프로젝트에서의 배포도 지원합니다. 또한 Skaffold 프로필을 사용하여 같은 프로젝트에서 서비스 또는 작업 2개를 사용할 수 있습니다. 다른 프로젝트를 사용하는 경우 Skaffold 프로필을 사용할 필요가 없을 수도 있습니다.

전달 파이프라인 및 대상 만들기

파이프라인 및 대상을 파일 하나 또는 별도의 파일로 정의할 수 있습니다. 이 빠른 시작에서는 단일 파일을 만듭니다.

1. deploy-run-quickstart 디렉터리에서 다음 콘텐츠로 새 파일 clouddeploy.yaml을 만듭니다.

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-run-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: run-qsdev
       profiles: [dev]
     - targetId: run-qsprod
       profiles: [prod]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: run-qsdev
   description: Cloud Run development service
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: run-qsprod
   description: Cloud Run production service
   run:
     location: projects/PROJECT_ID/locations/us-central1
   

2. Cloud Deploy 서비스에 파이프라인 및 대상을 등록합니다.

   gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
   

   이제 타겟이 포함된 파이프라인을 사용하여 첫 번째 타겟에 애플리케이션을 배포할 수 있습니다.

3. 파이프라인 및 대상을 확인합니다.

   Google Cloud 콘솔에서 Cloud Deploy 배포 파이프라인 페이지로 이동하여 사용 가능한 배포 파이프라인 목록을 확인합니다.

   배포 파이프라인 페이지 열기

   방금 만든 배포 파이프라인이 표시되고 두 타겟이 타겟 열에 나열됩니다.

   

출시 버전 만들기

출시 버전은 배포되는 변경사항을 나타내는 중앙 Cloud Deploy 리소스입니다. 배포 파이프라인은 해당 출시의 수명 주기를 정의합니다. 수명 주기에 대한 자세한 내용은 Cloud Deploy 서비스 아키텍처를 참조하세요.

deploy-run-quickstart 디렉터리에서 다음 명령어를 실행하여 배포할 컨테이너 이미지를 나타내는 release 리소스를 만듭니다.

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/job@sha256:d7c33651fbad911a9a0a0c16f2f9b3a79f0b9e3e89afb205603af706067feac5

서비스 또는 작업 정의에서 자리표시자 (my-app-image)를 특정 SHA-정규화된 이미지로 대체하는 데 사용하는 --images= 플래그에 주의하세요. 이 방법으로 서비스 및 작업 정의의 템플릿을 만들고 출시 생성 시 SHA로 지정된 이미지 이름을 사용하는 것이 좋습니다.

모든 출시 버전과 마찬가지로(--disable-initial-rollout을 포함하지 않는 경우) Cloud Deploy도 자동으로 출시 리소스를 만듭니다. 애플리케이션은 진행 상황의 첫 번째 대상에 자동으로 배포됩니다.

출시 버전 승격

1. 배포 파이프라인 페이지에서 my-run-demo-app-1 파이프라인을 클릭합니다.

   배포 파이프라인 페이지 열기

   배포 파이프라인 세부정보 페이지에는 배포 파이프라인의 진행 상태가 그래픽으로 표시됩니다. 이 경우 출시 버전이 run-qsdev 타겟에 배포되었음을 보여줍니다.

   

2. 배포 파이프라인 시각화의 첫 번째 타겟에서 승격을 클릭합니다.

   출시 승격 대화상자가 표시됩니다. 승격하는 타겟의 세부정보가 표시됩니다.

3. 승격을 클릭합니다.

   출시 버전이 run-qsprod에의 배포를 위해 큐에 추가되었습니다. 배포가 완료되면 배포 파이프라인 시각화에 배포된 것으로 표시됩니다.

   

Google Cloud 콘솔에서 결과 보기

1. Google Cloud 콘솔에서 Cloud Deploy 배포 파이프라인 페이지로 이동하여 my-run-demo-app-1 배포 파이프라인을 확인합니다.

   배포 파이프라인 페이지 열기

2. 배포 파이프라인 이름 'my-run-demo-app-1'을 클릭합니다.

   파이프라인 시각화에서 파이프라인의 앱 진행 상황을 보여줍니다.

   

   출시 버전은 배포 파이프라인 세부정보의 출시 탭에 표시됩니다.

3. 출시 이름 test-release-001를 클릭합니다.

   출시 아래에 출시가 표시됩니다. 출시를 클릭하여 배포 로그를 비롯한 세부정보를 볼 수 있습니다.

   

Cloud Run 서비스 액세스

기본적으로 새로 만든 Cloud Run 서비스에 액세스하려면 인증을 받아야 합니다. Cloud Run 인증 개요를 참조하여 사용자 인증 정보를 제공하는 방법을 알아보고 인증 없이 서비스에 액세스하기 위해 필요한 Identity and Access Management 구성이 무엇인지 확인합니다. Cloud Run 작업에는 적용되지 않습니다.