동시에 여러 대상에 앱 배포

Skaffold 구성 및 애플리케이션 매니페스트 준비

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

이 빠른 시작에서는 샘플 앱을 배포하는 데 사용할 애플리케이션 매니페스트를 식별하는 skaffold.yaml 파일을 만듭니다.

1. 터미널 창을 엽니다.

2. 새 디렉터리를 만들어 해당 디렉터리로 이동합니다.

   GKE

   mkdir deploy-gke-parallel-quickstart
   cd deploy-gke-parallel-quickstart
   

   Cloud Run

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

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

   GKE

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - k8s-deployment.yaml
   deploy:
     kubectl: {}
   

   Cloud Run

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - service.yaml
   deploy:
     cloudrun: {}
   

   이 파일은 최소한의 Skaffold 구성입니다. 이 빠른 시작에서는 해당 파일을 만듭니다. 하지만 간단한 비프로덕션 애플리케이션의 경우 Cloud Deploy에서 자동으로 생성되도록 할 수도 있습니다.

   이 파일에 대한 자세한 내용은 skaffold.yaml 참조를 확인하세요.

4. Cloud Run용 서비스 정의 또는 GKE용 Kubernetes 매니페스트와 같은 애플리케이션의 정의를 만듭니다.

   GKE

   다음 콘텐츠로 k8s-deployment.yaml라는 파일을 만듭니다.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
     namespace: default
   spec:
     replicas: 1 # from-param: ${replicaCount}
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: nginx
           image: my-app-image
   

   이 파일은 애플리케이션을 배포하기 위해 클러스터에 적용되는 간단한 Kubernetes 매니페스트입니다. 배포할 컨테이너 이미지는 여기에서 자리표시자 my-app-image로 설정되며, 이는 버전을 만들 때 특정 이미지로 대체됩니다.

   Cloud Run

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

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: my-parallel-run-service
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 1 # from-param: ${minInstances}
       spec:
         containers:
         - image: my-app-image
   

   이 파일은 배포 시 Cloud Run 서비스를 만드는 데 사용되는 단순 Cloud Run 서비스 정의입니다. 배포할 컨테이너 이미지는 여기에서 자리표시자 my-app-image로 설정되며, 버전을 만들 때 특정 이미지로 대체됩니다.

배포 파이프라인 및 대상 만들기

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

1. 배포 파이프라인과 대상 정의를 만듭니다.

   GKE

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           replicaCount: "1"
         matchTargetLabels:
           label1: label1
       - values:
           replicaCount: "2"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production clusters
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production cluster 2
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production cluster 3
   gke:
     cluster: projects/PROJECT_ID/locations/us-west1/clusters/quickstart-cluster-qsprod2
   

   Cloud Run

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           minInstances: "2"
         matchTargetLabels:
           label1: label1
       - values:
           minInstances: "3"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production us-central1
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production us-west1
   run:
     location: projects/PROJECT_ID/locations/us-west1
   

   이 파일에는 다중 대상 1개와 하위 대상 2개의 3개 대상이 포함됩니다. 배포 파이프라인이 아닌 별도의 파일로 대상을 구성할 수도 있습니다.

   또한 배포 파이프라인에는 라벨이 있는 deployParameters가 포함되어 있고 하위 타겟에는 이러한 매개변수와 일치하는 라벨이 포함되어 있습니다. 이렇게 하면 원하는 경우 별도의 하위 대상에 별도의 값을 전달할 수 있습니다. 자세히 알아보기

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

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

   이제 두 개의 GKE 또는 Cloud Run 대상으로 구성된 하나의 다중 대상이 있는 파이프라인을 사용하여 애플리케이션을 배포할 수 있습니다.

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

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

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

   방금 만든 배포 파이프라인이 표시됩니다. clouddeploy.yaml 파일에 3개의 대상(다중 대상 1개 및 하위 대상 2개)을 구성했더라도 대상 열에는 1개의 대상이 나열됩니다.

   

   나열된 유일한 대상은 다중 대상 qsprod-multi입니다. 하위 타겟은 표시되지 않습니다.

출시 버전 만들기

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

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-parallel-demo-app-1 \
   --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa \
   --to-target=qsprod-multi

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

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

항상 그렇듯이 출시 버전을 만들 때 파이프라인의 첫 번째 대상(또는 이 경우 --to-target=을 사용하여 지정된 특정 타겟)의 출시가 자동으로 생성됩니다. 이 빠른 시작에서 이 대상은 다중 대상이므로 rollout은 두 하위 대상의 '컨트롤러 출시'이며 배포 파이프라인에 후속 대상은 없습니다. 즉, 애플리케이션은 출시와 동시에 모든 위치에 배포됩니다.

Google Cloud 콘솔에서 결과 보기

출시 버전을 만들고 컨트롤러 출시 및 하위 출시가 생성되었으므로 이제 해당 하위 출시가 각 GKE 클러스터 또는 Cloud Run 서비스에 배포(또는 배포 중)됩니다.

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

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

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

   파이프라인 시각화에 앱의 배포 상태가 표시됩니다. 파이프라인에는 단계가 하나뿐이므로 시각화에 노드가 하나만 표시됩니다.

   

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

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

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