구성 동기화 업그레이드

이 페이지에서는 클러스터에 설치된 구성 동기화 버전을 업그레이드하는 방법을 설명합니다.

구성 동기화 자동 업그레이드

Google Cloud 기반 GKE 클러스터에서 새 버전으로 자동 업그레이드하도록 구성 동기화를 구성할 수 있습니다.

구성 동기화에 자동 업그레이드를 사용 설정하면 관리 경험이 간소화됩니다. Google에서 구성 동기화 버전을 자동으로 업그레이드하고 구성요소의 수명 주기를 감독할 책임을 집니다. 자동 업그레이드를 사용 설정하면 다음과 같은 이점이 있습니다.

유지보수 오버헤드 감소: 최신 구성 동기화 버전을 모니터링하고 클러스터 간에 구성 동기화를 수동으로 업그레이드할 필요가 없습니다.
지원되는 버전 유지: 지원되지 않는 구성 동기화 버전을 사용하지 않도록 Google이 클러스터에서 지원되는 최신 버전을 유지합니다.
안정성 향상: Google이 구성 동기화 구성요소를 관리하고 변경사항이 있는 경우 구성요소를 조정합니다.

구성 동기화 버전 및 GKE 출시 채널

구성 동기화는 Google Kubernetes Engine 클러스터 출시 채널을 기반으로 업그레이드할 버전을 선택합니다. GKE 출시 채널을 사용하지 않는 클러스터는 안정화 버전 GKE 출시 채널을 사용하는 클러스터로 취급됩니다.

자동 업그레이드를 사용해서 구성 동기화가 클러스터에서 자동으로 업그레이드되도록 할 수 있습니다. 출시 채널에서 구성 동기화의 새 버전을 사용할 수 있게 되면 구성 동기화에서 클러스터 출시 채널과 일치하도록 구성 동기화 버전을 업그레이드합니다. 신속 채널은 최신 버전의 구성 동기화가 제공되는 즉시 이를 제공합니다. 일반 채널은 최신 버전의 구성 동기화를 합리적으로 빠른 시일 내에 제공합니다. 안정화 버전 채널은 신속 채널 및 일반 채널에서 검증된 후에 최신 버전의 구성 동기화를 제공합니다.

출시 채널에 대한 자세한 내용은 출시 채널 정보를 참조하세요.

다음 표에서는 각 출시 채널에서 제공되는 현재 구성 동기화 버전을 보여줍니다.

출시 채널	구성 동기화 버전
신속 및 일반	1.19
안정화 버전(또는 채널 없음)	1.18.3

자동 업그레이드 사용 설정

자동 업그레이드를 사용 설정하여 Fleet 전반의 클러스터에서 구성 동기화가 자동으로 업그레이드되도록 합니다.

GKE Enterprise가 사용 설정된 Google Cloud 기반 GKE 클러스터에서만 자동 업그레이드를 사용 설정할 수 있습니다.

구성 동기화를 설치하고 자동 업그레이드를 사용 설정하려면 구성 동기화 설치 안내를 따르세요.

구성 동기화가 이미 설치된 클러스터에서 자동 업그레이드를 사용 설정하려면 다음 단계를 수행합니다.

GKE 클러스터가 출시 채널에 등록되었는지 확인합니다. GKE 클러스터가 출시 채널에 등록되지 않았으면 클러스터가 안정화 버전 GKE 출시 채널을 사용하듯이 구성 동기화가 자동으로 업그레이드합니다.
이전에 Cloud Monitoring으로 측정항목을 전송하도록 구성 동기화를 구성하지 않은 경우 측정항목 쓰기 권한을 부여합니다. 이는 자동 업그레이드를 위해 필요합니다.
구성 동기화가 지원되는 버전인지 확인합니다.
콘솔
1. Google Cloud 콘솔에서 기능 섹션 아래의 구성 페이지로 이동합니다.
  
  구성으로 이동
2. 설정 탭에서 업그레이드하려는 버전의 클러스터 옆에 있는 클러스터 구성 수정을 클릭합니다.
3. 버전 드롭다운 목록에서 업그레이드할 버전을 선택합니다.
4. 구성 동기화 업그레이드를 클릭합니다.
gcloud
1. (선택사항) 업그레이드하기 전 클러스터에 설치된 구성 동기화 버전을 확인하려면 다음 명령어를 실행합니다.
  gcloud beta container fleet config-management
2. 구성 동기화를 업그레이드하려면 다음 명령어를 실행합니다.
  gcloud beta container fleet config-management upgrade \ --version=VERSION \ --membership=MEMBERSHIP_NAME
  다음을 바꿉니다.
  - VERSION: 업그레이드할 버전입니다.
  - MEMBERSHIP_NAME: 클러스터를 등록할 때 선택한 Fleet 멤버십 이름입니다. gcloud container fleet memberships list를 실행하면 멤버십 이름을 찾을 수 있습니다.
구성 동기화 자동 업그레이드를 사용 설정합니다.
콘솔
개별 클러스터에서 자동 업그레이드 사용 설정

개별 클러스터에서 자동 업그레이드를 사용 설정하려면 다음 단계를 수행합니다.
1. Google Cloud 콘솔에서 기능 섹션 아래의 구성 페이지로 이동합니다.
  
  구성으로 이동
2. 구성 동기화 설정을 클릭합니다.
3. 업데이트하려는 클러스터에 대해 클러스터 구성 수정을 선택합니다.
4. 표시되는 설정 창에서 자동 업그레이드를 선택합니다.
5. 구성 동기화 설정 변경을 클릭합니다. 몇 분 후 설정 탭에서 클러스터의 자동 업그레이드 열에 예가 표시됩니다.
자동 업그레이드를 Fleet 기본값으로 사용 설정

클러스터의 Fleet에서 자동 업그레이드를 사용 설정하려면 다음 단계를 완료하세요.
1. Google Cloud 콘솔에서 기능 관리자 페이지로 이동합니다.
  
  기능 관리자로 이동
2. 구성 동기화 창에서 구성을 클릭합니다.
3. 기본 설정을 변경하려면 Fleet 맞춤설정을 클릭합니다.
4. 대화상자가 나타나면 자동 업그레이드를 선택합니다.
5. 변경사항 저장을 클릭합니다.
6. 선택사항: 기존 클러스터를 기본 설정으로 동기화합니다.
  1. 기능 관리자 페이지로 이동합니다.
    
    기능 관리자로 이동
  2. 구성 동기화 창에서 세부정보 보기를 클릭합니다.
  3. Fleet의 클러스터 목록에서 동기화할 클러스터를 선택합니다.
  4. Fleet 설정과 동기화를 클릭하고 확인 대화상자가 나타나면 확인을 클릭합니다. 이 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다.
gcloud
개별 클러스터에서 자동 업그레이드를 사용 설정하려면 다음 단계를 수행합니다.
1. Google Cloud CLI를 최신 버전으로 업그레이드합니다.
  gcloud components update
2. upgrades: auto 필드를 포함하도록 기존 구성 동기화 apply spec 파일을 업데이트합니다. 예를 들면 다음과 같습니다.
  applySpecVersion: 1 spec: upgrades: auto configSync: enabled: true # other fields intentionally omitted
3. 업데이트된 apply-spec.yaml 파일을 적용합니다.
  gcloud beta container fleet config-management apply \ --membership=MEMBERSHIP_NAME \ --config=CONFIG_YAML_PATH \ --project=PROJECT_ID
  다음을 바꿉니다.
  - MEMBERSHIP_NAME: 클러스터를 등록할 때 선택한 Fleet 멤버십 이름으로 gcloud container fleet memberships list를 사용하여 찾을 수 있습니다.
  - CONFIG_YAML_PATH: apply-spec.yaml 파일에 대한 경로입니다.
  - PROJECT_ID: 프로젝트 ID입니다.
4. 자동 업그레이드가 사용 설정되었는지 확인합니다.
  gcloud beta container fleet config-management status \ --project=PROJECT_ID
  PROJECT_ID를 프로젝트 ID로 바꿉니다.
  
  자동 업그레이드가 사용 설정된 클러스터의 Upgrades 열에 '자동'이 표시됩니다. 자동 업그레이드를 사용 설정할 때 오류가 있으면 Status 열에 자세한 오류 메시지와 함께 ERROR가 표시됩니다.
Terraform
개별 클러스터에서 자동 업그레이드 사용 설정

개별 클러스터에서 자동 업그레이드를 사용 설정하려면 리소스 google_gke_hub_feature_membership의 configmanagement.management 필드를 MANAGEMENT_AUTOMATIC으로 설정합니다.
```
resource "google_gke_hub_feature_membership" "feature_member" {
  location = "global"
  feature = google_gke_hub_feature.feature.name
  membership = google_gke_hub_membership.membership.membership_id
  configmanagement {
    # Don't use the `version` field with auto-upgrades.
    management= "MANAGEMENT_AUTOMATIC"
    config_sync {
      # The field `enabled` was introduced in Terraform version 5.41.0, and
      # needs to be set to `true` explicitly to install Config Sync.
      enabled = true
      # other fields intentionally omitted
    }
  }
}
```
자동 업그레이드를 Fleet 기본값으로 사용 설정

클러스터의 Fleet에서 자동 업그레이드를 사용 설정하려면 google_gke_hub_feature 리소스의 fleet_default_member_config.configmanagement.management 필드를 MANAGEMENT_AUTOMATIC으로 설정합니다.
```
resource "google_gke_hub_feature" "feature" {
  name = "configmanagement"
  location = "global"
  provider = google
  fleet_default_member_config {
    configmanagement {
      # Don't use the `version` field with auto-upgrades.
      management= "MANAGEMENT_AUTOMATIC"
      config_sync {
        # The field `enabled` was introduced in Terraform version 5.41.0,
        # and needs to be set to `true` explicitly to install Config Sync.
        enabled = true
        # other fields intentionally omitted
      }
    }
  }
}
```

출시 채널 변경

클러스터의 출시 채널 변경에 대한 자세한 내용은 GKE 문서에서 클러스터의 출시 채널 변경을 참조하세요. 구성 동기화에 대해 자동 업그레이드가 사용 설정된 경우 출시 채널을 변경할 때 다음을 고려해야 합니다.

출시 채널을 덜 안정적인 채널로 변경하면(예: 안정화 버전에서 신속 채널로) 구성 동기화가 원래 출시 채널에서 지원되는 최신 버전을 새 출시 채널에서 지원되는 최신 버전으로 자동 업그레이드합니다.
출시 채널을 더 안정적인 채널로 변경하면(예: 신속 채널에서 안정화 버전으로) 구성 동기화가 버전을 다운그레이드하지 않습니다. 시간이 지나면 원래 출시 채널에서 지원되는 최신 버전이 새로운 출시 채널로 승격됩니다.l. 새로운 출시 채널에서 새 버전을 사용할 수 있으면 정상적으로 구성 동기화 자동 업그레이드가 수행됩니다.
출시 채널에서 구독을 취소해도 구성 동기화 자동 업그레이드에는 영향을 주지 않습니다. 클러스터가 안정화 버전 출시 채널에 등록된 것처럼 구성 동기화 버전이 업그레이드됩니다.

구성 동기화 수동 업그레이드

구성 동기화를 업그레이드하기 전에 출시 노트에서 버전 간 변경사항에 대한 자세한 내용을 확인하세요. 지원되지 않는 구성 동기화 버전에서 업그레이드해야 하는 경우 한 번에 3개 이하의 부 버전으로 증분하여 단계별 업그레이드를 수행해야 합니다. 예를 들어 현재 구성 동기화 버전이 1.11.0이면 먼저 버전 1.14.0으로 업그레이드한 후 버전 1.17.0으로 업그레이드합니다.

구성 동기화를 업그레이드하려면 다음 단계를 완료합니다.

콘솔

Google Cloud 콘솔에서 기능 섹션 아래의 구성 페이지로 이동합니다.

구성으로 이동

설정 탭에서 업그레이드하려는 구성 동기화 버전의 클러스터 옆에 있는 클러스터 구성 수정을 선택합니다.
버전 드롭다운 목록에서 업그레이드할 버전을 선택합니다.
구성 동기화 업그레이드를 클릭합니다.

gcloud

(선택사항) 업그레이드하기 전 클러스터에 설치된 구성 동기화 버전을 확인하려면 다음 명령어를 실행합니다.
```
gcloud beta container fleet config-management version
```
다음 명령어를 실행합니다.
```
gcloud beta container fleet config-management upgrade \
    --version=VERSION \
    --membership=MEMBERSHIP_NAME
```
다음을 바꿉니다.
- VERSION: 업그레이드할 버전입니다.
- MEMBERSHIP_NAME: 클러스터를 등록할 때 선택한 Fleet 멤버십 이름입니다. gcloud container fleet memberships list를 실행하면 멤버십 이름을 찾을 수 있습니다.

구성 동기화 업그레이드

구성 동기화 자동 업그레이드

구성 동기화 버전 및 GKE 출시 채널

자동 업그레이드 사용 설정

콘솔

gcloud

콘솔

개별 클러스터에서 자동 업그레이드 사용 설정

자동 업그레이드를 Fleet 기본값으로 사용 설정

gcloud

Terraform

개별 클러스터에서 자동 업그레이드 사용 설정

자동 업그레이드를 Fleet 기본값으로 사용 설정

출시 채널 변경

구성 동기화 수동 업그레이드

콘솔

gcloud