조정 전략

선언적 구성을 사용하여 원하는 시스템 상태를 정의합니다. 그러면 이 상태에 가능한 한 가깝게 유지하도록 시스템이 일정하게 작동합니다. 자세한 내용은 구성 파일을 사용한 Kubernetes 객체의 선언적 관리를 참조하세요.

구성 커넥터를 사용하면 종속 관계와 관계없이 임의의 순서로 리소스를 만들고 업데이트할 수 있습니다. GKE는 선언된 구성을 원하는 상태의 eventual consistency로 이동합니다.

예를 들어, 해당 PubSubTopic 전에 PubSubSubscription을 생성하는 경우 구성 커넥터는 연관된 구독을 생성하기 전에 주제가 만들어질 때까지 기다립니다.

구성 커넥터 설치가 일치하지 않는 상태로 유지되는 시간은 관리되는 리소스 수 및 유형에 따라 달라집니다. GKE 클러스터에 대한 변경은 일반적으로 수초 내에 수행됩니다. 하지만 Google Cloud 리소스 생성 시간은 리소스 유형에 따라 달라질 수 있습니다. 예를 들어 단일 PubSubTopic은 만들기에 몇 초가 걸립니다. Google Cloud 리소스는 생성되기 까지 일관성에 도달하지 않습니다. 예를 들어 SQLInstance 및 SQLDatabase를 만들 때 시스템은 데이터베이스를 만드는 몇 분 동안 일치하지 않는 상태입니다.

GKE 및 구성 커넥터는 업데이트가 수행될 때마다 또는 사전 구성된 기본 간격을 기준으로 하는 평균 지터 기간을 두고 각 리소스를 조정합니다. 각 리소스의 참조 페이지에 있는 '구성 커넥터 기본 평균 조정 간격(초)'에서 기본 간격을 확인할 수 있습니다. 각 리소스 링크는 리소스 개요를 참조하세요. 조정에 오류가 있으면 구성 커넥터가 최대 백오프가 2분인 지수 백오프를 사용하여 재시도합니다. 해당 리소스의 이벤트에서 오류를 볼 수 있습니다.

조정 간격 구성

구성 커넥터 1.102부터는 구성 커넥터에서 관리하는 cnrm.cloud.google.com/reconcile-interval-in-seconds 주석을 사용하여 리소스의 평균 조정 간격을 구성할 수 있습니다. 주석 값은 리소스 참조 페이지의 '구성 커넥터 기본 평균 조정 간격(초)' 기본값을 덮어씁니다. 주석 값은 시간(초)을 나타내는 음수가 아닌 정수여야 합니다. 값이 0으로 설정된 경우 구성 커넥터는 리소스가 UpToDate 상태에 도달하면 조정 시작을 중지합니다.

예를 들어 기본 Google Cloud API 할당량 문제가 발생하지 않도록 구성 커넥터에서 리소스를 더 적게 조정하려는 경우 평균 조정 간격 값을 1시간으로 설정하면 됩니다.

cnrm.cloud.google.com/reconcile-interval-in-seconds: "3600"

구성 커넥터가 리소스를 더 자주 조정하여 드리프트를 더 빨리 수정하도록 하려면 주석을 작은 값으로 설정하면 됩니다.

동일한 그룹 버전 종류(GVK)를 공유하는 특정 유형의 모든 리소스에 다음 스크립트를 주석으로 추가할 수 있습니다.

#!/bin/bash

KIND=RESOURCE_KIND
NAMESPACE=RESOURCE_NAMESPACE
ANNOTATION_KEY="cnrm.cloud.google.com/reconcile-interval-in-seconds"
ANNOTATION_VALUE=RECONCILE_INTERVAL

kubectl annotate --overwrite --all ${KIND} ${ANNOTATION_KEY}=${ANNOTATION_VALUE} -n ${NAMESPACE}
echo "Annotation added to all ${KIND} RESOURCE"

다음을 바꿉니다.

RESOURCE_KIND: 주석을 추가할 리소스 종류입니다.
RESOURCE_NAMESPACE: 주석을 추가할 리소스가 포함된 네임스페이스입니다.
RECONCILE_INTERVAL: 조정 간격(초)입니다.

조정 간격을 0으로 설정하여 리소스에 대한 드리프트 수정을 중지할 수 있지만 리소스 활성화는 사용 중지되지 않습니다. Spec 리소스를 변경하면 리소스가 다시 조정됩니다.

조정 간격을 0으로 설정하면 되돌릴 수 없습니다. 즉, 값을 다시 0이 아닌 숫자로 변경해도 구성 커넥터에서 리소스를 다시 조정하지 않습니다.

0 조정 간격을 되돌리려면 다음 옵션을 사용합니다.

새 조정을 사용 설정하려면 리소스 사양을 조정 간격 값으로 수정합니다.
cnrm.cloud.google.com/deletion-policy: "abandon" 주석을 설정하여 리소스를 폐기하고 조정 간격 값이 0이 아닌 리소스를 다시 만듭니다.

변경 가능하지만 읽을 수 없는 필드는 변경 시에만 활성화됨

일부 API는 읽을 수 없지만 변경 가능한 필드를 제공합니다(예: SQL 사용자의 비밀번호). 이러한 필드가 수정되었는지 확인할 수 없기 때문에 변경 가능하지만 읽을 수 없는 필드는 커스텀 리소스가 수정될 때만 업데이트됩니다.

변경할 수 없는 필드를 수정할 때 리소스가 다시 생성되지 않음

리소스의 일부 필드는 변경 불가능하며, 대상 리소스를 삭제한 후 다시 만들지 않는 한 조정이 불가능합니다.

이러한 경우 구성 커넥터가 이 다시 만들기를 수행하는 대신 리소스에 대해 'UpdatedFailed' Kubernetes 이벤트를 방출합니다. 그러면 사용자가 리소스를 삭제하고 다시 만들어야 합니다.

예시 이벤트:

Warning  UpdateFailed  37m (x643 over 15d)    computeinstance-controller  Update call failed: the desired mutation for the following field(s) is invalid: [bootDisk.0.InitializeParams.0.Image networkInterface.0.NetworkIp]