맞춤 단계를 사용하여 클러스터 업그레이드 출시 순서 지정

여러 Fleet에 걸쳐 출시를 관리하는 경우 전용 프로젝트를 사용하여 RolloutSequence 객체를 호스팅하는 것이 좋습니다. 이 프로젝트는 시퀀스 전반의 출시를 위한 상위 및 코디네이터 역할을 합니다. 이 프로젝트는 일반적으로 시퀀스에 포함되지 않습니다. 즉, 이 프로젝트에는 시퀀스에 포함된 함대나 클러스터가 포함되어 있지 않습니다.

시작하기 전에

• Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다. 로그인한 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.

  gcloud init

• 기존 Autopilot 또는 Standard 클러스터가 있는지 확인합니다. 새 클러스터를 만들려면 Autopilot 클러스터 만들기를 참고하세요.
• (선택사항) RolloutSequence 구성을 호스팅할 전용 Cloud de Confiance by S3NS 프로젝트가 아직 없는 경우Cloud de Confiance 콘솔 또는 다른 방법을 사용하여 만듭니다.
• 차량 관리 시스템에 필요한 API를 사용 설정했는지 확인합니다. 모든 유형의 출시 시퀀스를 만들려면 Fleet 호스트 프로젝트에서 이러한 API를 사용 설정해야 합니다. 출시 시퀀스 호스트 프로젝트에 gkehub.googleapis.com API를 사용 설정합니다.

• Terraform 안내의 경우 실행하려는 작업에 따라 다음 버전 이상의 google Terraform 프로바이더를 사용해야 합니다.

  • 다음 작업을 수행하려면 버전 7.39.0 이상이 필요합니다.
    • 출시 시퀀스 만들기
    • 출시 시퀀스 수정
    • 출시 시퀀스에서 GKE가 실행하는 업그레이드 유형 선택
    • 출시 시퀀스에서 클러스터 무시
  • 다음 작업을 수행하려면 버전 7.42.0 이상이 필요합니다.
    • 출시 시퀀스에 특정 버전 출시

필요한 역할

프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

출시 시퀀스를 만들거나 수정하려면 출시 시퀀스의 각 Fleet 호스트 프로젝트와 출시 시퀀스 호스트 프로젝트에 Fleet 편집자 IAM 역할 (roles/gkehub.editor)이 있어야 합니다. 이 역할은 다음 권한을 제공합니다.

• gkehub.rolloutsequences.create
• gkehub.rolloutsequences.get
• gkehub.rolloutsequences.list
• gkehub.rolloutsequences.update
• gkehub.rolloutsequences.delete
• gkehub.fleet.update

이러한 권한을 사용하면 RolloutSequence 객체를 만들고, 액세스하고, 수정할 수 있으며, 출시 시퀀스에서 플릿을 사용할 수 있습니다.

클러스터를 Fleet에 등록하거나 등록 취소하려면 다음 권한이 모두 필요합니다.

• Fleet 호스트 프로젝트의 클러스터 등록 권한
• 등록할 모든 GKE 클러스터에 대한 클러스터 관리자 권한
• 다른 프로젝트의 Fleet에 등록될 모든 GKE 클러스터에 대한 프로젝트 간 클러스터 등록 권한

하나 이상의 조직의 프로젝트에 호스팅된 Fleet을 사용하여 출시 시퀀스를 만들 수 있습니다(해당 프로젝트에 필요한 권한이 있는 경우).

다양한 작업에 필요한 최소 권한 IAM 역할에 대한 자세한 내용은 Gemini 지원을 통해 사전 정의된 역할 추천 받기를 참고하세요.

출시 시퀀스 구성

출시 시퀀스를 만들려면 클러스터를 Fleet 그룹으로 구성해야 합니다. Kubernetes 라벨을 사용하여 Fleet 내의 특정 클러스터 하위 집합을 타겟팅할 수 있는 세부적인 단계를 만들 수도 있습니다. 클러스터 구성 방법에 대한 안내는 지역 은행 예시를 참고하세요. 클러스터를 그룹으로 정리하고 원하는 경우 라벨을 지정한 후 단계의 순서가 지정된 목록과 각 그룹의 적응 시간을 정의하여 출시 시퀀스를 만듭니다.

클러스터를 Fleet으로 구성

출시 시퀀스에서는 모든 클러스터를 동일한 출시 채널에 등록하는 것이 좋습니다. 클러스터가 동일한 채널에 등록되지 않은 경우 GKE는 시퀀스에서 가장 보수적인 채널의 버전을 선택합니다. 예를 들어 클러스터가 안정화 버전 채널과 일반 채널에 모두 등록된 경우 GKE는 안정화 버전 채널의 버전을 선택합니다. 또한 모든 클러스터가 동일한 자동 업그레이드 대상 버전을 사용할 수 있도록 동일한 마이너 버전을 실행하는 것이 좋습니다.

클러스터를 이미 Fleet으로 구성했다면 다음 단계를 건너뛰고 클러스터 하위 집합 만들기 섹션으로 진행하면 됩니다.

1. 클러스터를 Fleet으로 그룹화합니다. 테스트, 스테이징, 프로덕션과 같은 배포 환경별로 클러스터를 구성할 수 있습니다 (권장).
2. 선택한 그룹화에 따라 Fleet에 각 클러스터를 등록합니다.

클러스터 하위 집합 만들기 (선택사항)

출시 시퀀스의 단계를 특정 클러스터를 타겟팅하도록 하려면 해당 클러스터에 라벨을 지정해야 합니다.

예를 들어 전체 출시 전에 소수의 클러스터에서 새 버전을 테스트하려면 해당 클러스터에 canary 라벨을 적용하면 됩니다. Google Cloud CLI를 사용하여 값 true이 있는 canary 라벨을 클러스터에 추가하려면 다음 명령어를 실행합니다.

gcloud container clusters update CLUSTER_NAME \
    --location=CLUSTER_LOCATION\
    --update-labels=canary=true

다음을 바꿉니다.

• CLUSTER_NAME: 기존 클러스터의 이름입니다.
• CLUSTER_LOCATION: 클러스터의 Compute Engine 리전 또는 영역

--update-labels=canary=true 플래그는 GKE에 클러스터에 canary 라벨을 적용하도록 지시합니다 .

클러스터에 라벨을 추가하는 방법에 대한 자세한 내용은 기존 클러스터의 라벨 추가 또는 업데이트를 참고하세요.

맞춤 단계로 출시 시퀀스 만들기

맞춤 단계가 있는 출시 시퀀스는 단계를 선언적으로 정의하여 업그레이드 순서를 정의합니다. gcloud CLI를 사용하는 경우 YAML 파일을 사용하고 Terraform을 사용하는 경우 구성에 리소스 블록을 추가합니다. 이 섹션에 설명된 단계를 수행하면 RolloutSequence가 생성됩니다.

시퀀스에서 모든 클러스터를 캡처하려면 각 Fleet에 포괄적인 단계 (라벨 선택기가 없는 단계)가 포함되어야 합니다. 이 포괄적 단계에서는 GKE가 이전 단계에서 선택하지 않은 나머지 클러스터를 모두 포착합니다. 하나의 RolloutSequence 내에서 여러 단계에 단일 클러스터를 할당하는 경우 충돌을 해결하기 위해 GKE는 가장 빠른 단계에만 클러스터를 암시적으로 할당합니다.

다음 예시 구성은 3개의 단계를 만듭니다.

• 첫 번째 단계는 dev Fleet의 모든 클러스터를 타겟팅합니다. 업그레이드가 완료되면 7일 (7d)의 적응 시간이 있습니다.
• 두 번째 단계에서는 canary=true 라벨이 있는 prod Fleet의 클러스터를 타겟팅합니다. 업그레이드가 완료되면 7일 (7d)의 적응 시간이 있습니다.

• 세 번째 단계는 prod Fleet의 나머지 클러스터를 타겟팅합니다. 업그레이드가 완료되면 7일 (7d)의 적응 시간이 있습니다.

특정 버전 출시

출시 시퀀스에 특정 버전을 출시할 수 있습니다. 자세한 내용은 특정 버전 출시를 참고하세요.

롤아웃 시퀀스의 클러스터 컨트롤 플레인 또는 노드에 버전을 롤아웃할 수 있습니다. 제어 영역 또는 노드에 롤아웃할 버전을 독립적으로 선택할 수 있습니다.

GKE는 스테이지에서 컨트롤 플레인 또는 노드에 각각 한 번에 하나의 버전만 출시할 수 있습니다. 롤아웃 시퀀스의 첫 번째 단계에서 실행 중인 기존 롤아웃이 있는 경우 gcloud CLI 또는 Terraform으로 롤아웃 시퀀스를 관리하는지에 따라 GKE에서 다음 작업을 실행합니다.

• gcloud CLI: 명령어를 실행하면 지정한 버전으로 출시를 만들기 위해 기존 출시를 취소할지 묻는 대화형 메시지가 표시됩니다. 긍정으로 대답하면 GKE가 기존 출시를 취소하고 새 출시를 만듭니다. 그렇지 않으면 GKE는 기존 출시를 유지하고 명령어에서 원래 요청한 대로 새 출시를 만들지 않습니다.
• Terraform: 다음 섹션에 설명된 대로 Terraform 구성을 업데이트하면 출시가 첫 번째 단계에서 실행 중인 경우 GKE에서 기존 출시를 취소합니다.

출시 시퀀스에서 컨트롤 플레인에 버전 출시

gcloud container fleet rolloutsequences upgrade ROLLOUT_SEQUENCE_NAME \
    --control-plane-version="CONTROL_PLANE_VERSION"

min_control_plane_version = "CONTROL_PLANE_VERSION"

출시 시퀀스의 노드에 버전 출시

gcloud container fleet rolloutsequences upgrade ROLLOUT_SEQUENCE_NAME \
    --node-version="NODE_VERSION"

min_node_version = "NODE_VERSION"

출시 상태 확인

출시 시퀀스를 구성하면 시스템에서 업그레이드를 관리하기 위해 Rollout 객체를 자동으로 만듭니다. Google Cloud CLI 명령어를 사용하여 이러한 객체의 진행 상황을 관찰하고 추적할 수 있습니다.

출시 나열

출시 시퀀스 호스트 프로젝트에서 활성 및 이전 출시를 모두 나열하려면 다음 명령어를 실행합니다.

gcloud container fleet rollouts list --project=HOST_PROJECT_ID

HOST_PROJECT_ID를 출시 시퀀스 호스트 프로젝트의 ID로 바꿉니다.

출시 시퀀스가 호스팅되는 프로젝트에 이미 있는 경우 --project=HOST_PROJECT_ID 플래그를 생략할 수 있습니다.

출력은 다음과 비슷합니다.

NAME                                              STATE      CREATE_TIME
05eb251e4f19269e23-node-1-33-5-gke-1201000-t7mqd  COMPLETED  2025-10-30T20:07:46
05eb251e4f19269e23-kcp-1-33-5-gke-1201000-djwst   COMPLETED  2025-10-30T18:07:06
05eb251e4f19269e23-node-1-33-5-gke-1125000-6bxvu  COMPLETED  2025-10-23T17:46:54
05eb251e4f19269e23-kcp-1-33-5-gke-1125000-2f6ct   RUNNING    2025-10-23T16:41:33

위 출력에서 kcp가 포함된 출시 이름은 컨트롤 플레인 업그레이드를 나타내고 node가 포함된 이름은 노드 업그레이드를 나타냅니다. kcp 또는 node 뒤에 오는 출시 이름의 세그먼트는 GKE 버전에서 파생됩니다.

출시 설명

타겟 버전, 상태, 업그레이드된 클러스터 등 특정 출시에 관한 자세한 정보를 가져오려면 이전 명령어에서 가져온 출시 ID와 함께 describe 명령어를 사용하세요.

gcloud container fleet rollouts describe ROLLOUT_ID \
  --project=HOST_PROJECT_ID

다음을 바꿉니다.

• ROLLOUT_ID: 출시를 나열할 때 획득한 출시 ID입니다.
• HOST_PROJECT_ID: 출시 시퀀스가 호스팅되는 프로젝트 ID입니다.

예를 들면 다음과 같습니다.

gcloud container fleet rollouts describe 927e9a989930cf3b55-kcp-1-32-4-gke-1106006 \
  --project=my-hostfleet

출력은 다음과 비슷합니다.

createTime: '2025-05-26T11:47:29.909959672Z'
membershipStates:
  projects/dev-project-id/locations/us-central1/memberships/c-1:
    lastUpdateTime: '2025-05-26T12:20:55.601542481Z'
    targets:
    - cluster:   projects/dev-project-id/locations/us-central1/clusters/c-1
      operation: //container.googleapis.com/v1/projects/dev-project-id/locations/us-central1/operations/operation-1234567890-abcdefg-hijklm-nopqrst
      state: SUCCEEDED
    stageAssignment: 1
  projects/dev-project-id/locations/us-central1/memberships/c-2:
    lastUpdateTime: '2025-05-26T12:22:57.151203493Z'
    targets:
    - cluster:   projects/dev-project-id/locations/us-central1/clusters/c-2
      operation: //container.googleapis.com/v1/projects/dev-project-id/locations/us-central1/operations/operation-987654321-ghijkl-mno-pqr-stu-vwxyz
      state: SUCCEEDED
    stageAssignment: 1
  projects/prod-project-id/locations/us-central1/memberships/c-1:
    lastUpdateTime: '2025-05-26T13:03:34.134308942Z'
    targets:
    - cluster: projects/prod-project-id/locations/us-central1/clusters/c-1
      operation: //container.googleapis.com/v1/projects/prod-project-id/locations/us-central1/operations/operation-567891234-efghij-klm-nopq-rstu-vwxyz
      state: SUCCEEDED
    stageAssignment: 2
  projects/prod-project-id/locations/us-central1/memberships/c-2:
    lastUpdateTime: '2025-05-26T13:06:34.025261641Z'
    targets:
    - cluster: projects/prod-project-id/locations/us-central1/clusters/c-1
      operation: //container.googleapis.com/v1/projects/prod-project-id/locations/us-central1/operations/operation-765432198-01a7b896-67c2-523-6fjjh4-icmdydh
      state: SUCCEEDED
    stageAssignment: 2
name: projects/user-hostfleet/locations/global/rollouts/05eb251e4f19269e23-kcp-1-32-4-gke-1106006
rolloutSequence: projects/project-id/locations/global/rolloutSequences/my-sequence
state: COMPLETED
updateTime: '2025-07-22T07:36:51.052691989Z'
versionUpgrade:
  desiredVersion: 1.32.4-gke.1106006
  type: TYPE_CONTROL_PLANE
stages:
- state: COMPLETED
  endTime: '2025-05-26T12:22:28.828506491Z'
  stageNumber: 1
  startTime: '2025-05-26T11:48:28.772658427Z'
  soakDuration: 600s
- state: COMPLETED
  endTime: '2025-05-26T13:06:20.026390832Z'
  stageNumber: 2
  startTime: '2025-05-26T12:32:38.419372153Z'
  soakDuration: 600s

출시의 상태 정보

출시를 설명하면 출력의 stages 및 membershipStates 필드에 각 단계와 해당 단계 내 클러스터의 진행 상태가 각각 표시됩니다.

다음 표에는 단계의 가능한 상태가 나열되어 있습니다.

다음 표에는 시퀀스 내 클러스터의 가능한 상태가 나열되어 있습니다.

출시 관리

다음 섹션에 제공된 안내에 따라 개별 출시를 관리할 수 있습니다. 출시 관리 및 취할 수 있는 해당 조치에 대한 자세한 내용은 출시 관리를 참고하세요.

하나의 특정 출시뿐만 아니라 전체 출시 시퀀스를 관리하려면 다음 섹션인 출시 시퀀스 관리를 참고하세요.

출시 일시중지

활성 롤아웃을 일시중지할 수 있습니다. 이 작업에 대한 자세한 내용은 출시 일시중지를 참고하세요.

출시를 일시중지하려면 다음 명령어를 실행합니다.

gcloud container fleet rollouts pause ROLLOUT_ID

ROLLOUT_ID를 일시중지하려는 출시의 ID로 바꿉니다. 출시 시퀀스의 출시 ID를 가져오려면 출시 목록을 참고하세요.

출시 재개

일시중지된 출시가 90일 미만인 경우 재개할 수 있습니다. 이 작업에 대한 자세한 내용은 출시 재개를 참고하세요.

일시중지된 출시를 재개하려면 다음 명령어를 실행합니다.

gcloud container fleet rollouts resume ROLLOUT_ID

ROLLOUT_ID을 재개하려는 출시의 ID로 바꿉니다. 출시 시퀀스의 출시 ID를 가져오려면 출시 목록을 참고하세요.

출시 취소

활성 상태이거나 일시중지된 출시를 포함하여 출시를 취소할 수 있습니다. 필수 자동 업그레이드 출시는 취소할 수 없습니다. 출시 취소에 대한 자세한 내용은 출시 취소를 참고하세요.

출시를 취소하려면 다음 명령어를 실행합니다.

gcloud container fleet rollouts cancel ROLLOUT_ID

ROLLOUT_ID를 취소하려는 출시의 ID로 바꿉니다. 출시 시퀀스의 출시 ID를 가져오려면 출시 목록을 참고하세요.

출시 단계 완료

업그레이드를 다음 단계로 진행할 준비가 되면 출시 단계를 완료할 수 있습니다. 이 작업에 대한 자세한 내용은 출시 단계 완료를 참고하세요.

출시 단계를 완료하려면 다음 명령어를 실행합니다.

gcloud container fleet rollouts force-complete-stage ROLLOUT_ID \
    --stage=STAGE

다음을 바꿉니다.

• ROLLOUT_ID: 단계를 완료할 출시의 ID입니다. 출시 시퀀스의 출시 ID를 가져오려면 출시 목록을 참고하세요.
• STAGE: 지금 완료하려는 단계입니다. 예를 들어 두 번째 단계를 완료하려면 2를 입력합니다. 이 명령어를 사용하려면 스테이지가 실행 중이거나 소킹 중이어야 합니다.

특정 출시의 출시 시퀀스에서 클러스터 무시

활성 출시의 일부로 클러스터를 업그레이드하지 않으려면 출시 시퀀스에서 클러스터를 무시하도록 GKE를 설정할 수 있습니다. 하지만 이 작업은 활성 출시뿐만 아니라 활성 및 향후 출시의 출시 시퀀스에서 클러스터를 삭제합니다.

활성 출시에서 클러스터가 업그레이드되지 않도록 이 작업을 실행하려면 출시 시퀀스에서 클러스터 무시를 참고하세요.

출시 시퀀스 관리

다음 섹션에서 설명하는 여러 가지 방법의 출시 시퀀싱을 사용하여 자동 클러스터 업그레이드를 제어할 수 있습니다.

전체 출시 시퀀스와 모든 출시 대신 출시 시퀀스에서 하나의 출시를 관리하려면 출시 관리를 참고하세요.

출시 시퀀스 나열

호스트 프로젝트의 모든 출시 시퀀스를 나열하려면 다음 명령어를 실행합니다.

gcloud container fleet rolloutsequences list --project=HOST_PROJECT_ID

HOST_PROJECT_ID를 출시 시퀀스 호스트 프로젝트의 ID로 바꿉니다.

출시 시퀀스 설명

특정 출시 시퀀스의 세부정보를 보려면 다음 명령어를 실행합니다.

gcloud container fleet rolloutsequences describe ROLLOUT_SEQUENCE_NAME \
  --project=HOST_PROJECT_ID

다음을 바꿉니다.

• ROLLOUT_SEQUENCE_NAME: 출시 시퀀스의 이름입니다.
• HOST_PROJECT_ID: 출시 시퀀스 호스트 프로젝트의 ID입니다.

출력은 다음과 비슷합니다.

createTime: '2025-10-23T16:40:16.403871189Z'
displayName: my-display-name
name: projects/HOST_PROJECT_ID/locations/global/rolloutSequences/ROLLOUT_SEQUENCE_NAME
stages:
- clusterSelector:
    labelSelector: resource.labels.canary=='true'
  fleetProjects:
  - projects/FLEET_PROJECT_ID
  soakDuration: 600s
- fleetProjects:
  - projects/FLEET_PROJECT_ID
  soakDuration: 300s
uid: 5c5b2ac8-9d76-45f9-92ca-5e6bd3fbcaef
updateTime: '2025-10-23T17:11:57.285678399Z'

출시 시퀀스에서 GKE가 실행하는 업그레이드 유형 선택

기본적으로 GKE는 출시 시퀀스에서 모든 유형의 클러스터 업그레이드를 실행합니다. 특정 유형의 업그레이드만 실행하도록 출시 시퀀스에서 클러스터 업그레이드 범위를 제한할 수 있습니다. 자세한 내용은 롤아웃 시퀀스에서 GKE가 실행하는 업그레이드 유형 선택을 참고하세요.

출시 시퀀스에서 GKE가 실행할 업그레이드 유형을 지정하려면 출시 시퀀스 관리 방법에 따라 다음 안내를 따르세요.

gcloud container fleet rolloutsequences update ROLLOUT_SEQUENCE_NAME \
    --auto-rollout-scope=TYPES_OF_UPGRADES

auto_upgrade_config {
  rollout_creation_scope {
    upgrade_types = [
      UPGRADE_TYPES
    ]
  }
}

출시 시퀀스 수정

기존 출시 시퀀스는 만든 후에 수정할 수 있습니다. 출시 시퀀스를 관리하는 방법에 따라 다음 안내에 따라 출시 시퀀스를 수정합니다.

gcloud container fleet rolloutsequences update test-rollout-sequence \
  --display-name="My Updated Rollout Sequence" \
  --stage-config=rollout-sequence.yaml

출시 시퀀스에서 클러스터 무시

GKE가 출시 시퀀스에서 클러스터를 무시하도록 할 수 있습니다. 출시 시퀀스에서 하나 이상의 클러스터를 무시할 수 있습니다. 자세한 내용은 출시 시퀀스에서 클러스터 무시를 참고하세요.

GKE가 출시 시퀀스에서 클러스터를 무시하도록 하려면 다음 단계를 따르세요.

1. GKE에서 무시할 클러스터에 라벨을 추가하거나 기존 라벨을 사용합니다. 예를 들어 status와 같은 라벨을 무시하거나 status=quarantine과 같은 특정 값이 있는 라벨을 무시하도록 GKE에 지시할 수 있습니다.

2. 이 라벨이 있는 클러스터를 무시하도록 출시 시퀀스를 설정합니다. 이렇게 하려면 출시 순서를 관리하는 방식에 따라 다음 단계를 실행하세요.

   gcloud

   다음 명령어를 실행합니다.

   gcloud container fleet rolloutsequences update ROLLOUT_SEQUENCE_NAME \
       --ignored-clusters-selector="resource.labels.LABEL_TO_IGNORE"
   

   다음을 바꿉니다.

   • ROLLOUT_SEQUENCE_NAME: 출시 시퀀스의 이름입니다.
   • LABEL_TO_IGNORE: GKE가 출시 순서에서 무시해야 하는 클러스터의 라벨 이름입니다.

   Terraform

   Terraform을 사용하여 출시 시퀀스를 관리하는 경우 출시 시퀀스를 생성하는 데 사용한 블록에 다음 필드를 추가합니다. 블록 사이를 제외한 어느 곳에나 필드를 추가할 수 있습니다. stages 블록은 연속되어야 합니다.

   ignored_clusters_selector {
     label_selector = "resource.labels.LABEL_TO_IGNORE"
   }
   

   LABEL_TO_IGNORE을 GKE가 출시 순서에서 무시해야 하는 클러스터의 라벨 이름으로 바꿉니다.

이 안내에서는 출시 시퀀스에서 한 가지 유형의 라벨을 무시하도록 GKE를 구성합니다. 여러 라벨을 무시하거나 특정 라벨이 있는 클러스터를 무시하는 방법에 관한 더 복잡한 표현식을 만들려면 CEL 표현식 구문을 사용하여 이 필드에 값을 전달하면 됩니다. 모든 라벨은 resource.labels. 접두사를 사용해야 합니다.

출시 시퀀스에 클러스터 다시 추가

이전 섹션의 안내에 따라 GKE가 출시 시퀀스에서 클러스터를 무시하도록 설정한 경우 이 작업을 되돌릴 수 있습니다. GKE에서 더 이상 클러스터를 무시하지 않도록 하려면 출시 시퀀스를 관리하는 방식에 따라 다음 안내에 따라 무시 선택기를 삭제하세요.

gcloud container fleet rolloutsequences update ROLLOUT_SEQUENCE_NAME \
    --clear-ignored-clusters-selector

또는 GKE에서 특정 클러스터를 무시하지 않도록 하려면 클러스터에서 라벨을 삭제하세요.

출시 시퀀스 삭제

출시 시퀀스를 삭제하려면 다음 명령어를 실행합니다.

gcloud container fleet rolloutsequences delete ROLLOUT_SEQUENCE_NAME \
  --project=HOST_PROJECT_ID

다음을 바꿉니다.

• ROLLOUT_SEQUENCE_NAME을 출시 시퀀스 이름으로 바꿉니다.
• HOST_PROJECT_ID를 출시 시퀀스 호스트 프로젝트의 ID로 바꿉니다.

출시 시퀀스를 삭제하면 해당 시퀀스의 진행 중인 출시가 취소됩니다. 시퀀스에 포함된 클러스터는 등록된 출시 채널의 기본 자동 업그레이드 동작으로 되돌아갑니다.

기존 출시 시퀀스를 마이그레이션하여 맞춤 단계를 사용

함대 기반 출시 시퀀싱 버전을 사용하는 경우 기존 함대를 참조하는 새 RolloutSequence를 만들어 맞춤 단계를 사용하는 시퀀스로 이전할 수 있습니다. 이 버전의 출시 순서에는 Cloud de Confiance 콘솔 지원이 없습니다.

출시 시퀀스를 이전하려면 다음 단계를 완료하세요.

1. 선택적으로 시퀀스를 이전하기 전에 현재 출시 시퀀스 구성의 사본을 만드세요. 구성을 복사하려면 다음 중 하나를 실행하세요.

   • gcloud CLI: 명령어를 실행하여 함대 기반 출시 시퀀스의 상태를 확인합니다. 명령어의 출력을 저장합니다.
   • Terraform: Terraform 구성을 저장합니다.

   필요한 경우 이전 버전의 출시 순서로 쉽게 되돌릴 수 있도록 함대를 기반으로 한 출시 순서를 삭제하지 않는 것이 좋습니다. 커스텀 단계가 있는 출시 시퀀스가 작동하려면 커스텀 단계가 있는 출시 시퀀스만 따르기 때문에 fleet 기반 출시 시퀀스를 삭제할 필요가 없습니다.

2. 출시 시퀀스를 호스팅할 전용 Cloud de Confiance by S3NS 프로젝트를 만듭니다. 이 프로젝트는 일반적으로 시퀀스에 포함되지 않습니다. 즉, 이 프로젝트에는 시퀀스에 포함된 플릿이나 클러스터가 포함되어 있지 않습니다.

3. 출시 시퀀스에 Fleet 내의 특정 클러스터를 포함하려면 해당 클러스터에 라벨을 추가하세요. 이 단계는 선택사항입니다.

4. 맞춤 단계로 출시 시퀀스 만들기의 안내를 따릅니다.

   예를 들어 rollout-sequence-migrate.yaml이라는 이름의 다음 매니페스트는 이전 출시 시퀀스의 기존 플릿을 참조합니다. 이 매니페스트는 prod Fleet의 canary 단계를 포함한 세 단계를 설명합니다.

   - stage:
     fleet-projects:
     - projects/dev
     soak-duration: 604800s
   - stage:
     fleet-projects:
     - projects/prod
     soak-duration: 604800s
     label-selector: canary=true
   - stage:
     fleet-projects:
     - projects/prod
     soak-duration: 604800s
   

Fleet의 새 RolloutSequence를 정의하면 GKE가 새 시퀀스에 따라 Fleet 업그레이드를 시작하고 이전 구성을 삭제합니다.

맞춤 단계가 있는 출시 시퀀스를 이전 출시 시퀀스로 이전

이 섹션에서는 맞춤 단계가 있는 출시 시퀀싱에서 Fleet 기반 출시 시퀀싱 모델로 되돌리는 방법을 설명합니다. 이 프로세스에는 새 RolloutSequence를 삭제하고 원래 함대 기반 구성을 복원하는 작업이 포함됩니다.

이전 중에 순서가 잘못된 업그레이드 방지

시퀀스를 재구성하는 동안 의도치 않은 업그레이드나 순서가 잘못된 업그레이드를 방지하려면 프로덕션 클러스터에 유지보수 제외를 적용하세요. 이 단계에서는 해당 클러스터의 모든 자동 업그레이드를 일시적으로 일시중지합니다. 예를 들어 프로덕션 클러스터에서 no upgrades 유형의 유지보수 제외를 구성할 수 있습니다.

출시 시퀀스 삭제

클러스터를 관리하는 RolloutSequence 객체를 삭제합니다. 이렇게 삭제하면 맞춤 단계 기능이 사용 중지됩니다.

RolloutSequence를 삭제하려면 다음 명령어를 실행합니다.

gcloud container fleet rolloutsequences delete ROLLOUT_SEQUENCE_NAME

ROLLOUT_SEQUENCE_NAME을 출시 시퀀스의 이름으로 바꿉니다.

이전 출시 순서 구성 복원 (맞춤 단계 제외)

RolloutSequence를 삭제한 후 원래의 Fleet 기반 구성을 복원할 수 있습니다. 이 프로세스에는 시퀀스의 각 Fleet에 대한 upstreamFleet 링크와 적응 시간을 비롯한 원래 파라미터로 clusterupgrade 기능을 다시 만드는 작업이 포함됩니다. 자세한 내용은 출시 시퀀스 만들기를 참고하세요.

유지보수 제외 삭제

원래의 전체 버전 기반 출시 순서 구성으로 복원한 후 이 섹션의 첫 번째 단계에서 적용한 유지관리 제외를 삭제합니다. GKE는 복원된 플릿 기반 시퀀스에 따라 자동 업그레이드를 재개합니다.

다음 단계

• 출시 시퀀싱을 사용한 클러스터 업그레이드에 대해 자세히 알아보세요.