This page shows documentation for version 15.5.5 of AlloyDB Omni.
See the latest AlloyDB Omni documentation.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

최신 버전의 AlloyDB Omni Kubernetes Operator로 마이그레이션

이 페이지에서는 AlloyDB Omni Operator 버전 1.0.0에서 버전 1.1.0으로 업그레이드하는 방법을 설명합니다.

Kubernetes에서 AlloyDB Omni를 업그레이드하는 단계는 실행 중인 AlloyDB Omni 버전과 업그레이드할 버전에 따라 다릅니다.

현재 버전 번호 확인

Kubernetes

데이터베이스 클러스터에서 사용하는 AlloyDB Omni 버전을 확인하려면 다음 명령어를 실행합니다.

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

다음을 바꿉니다.

DB_CLUSTER_NAME: 데이터베이스 클러스터의 이름입니다. 데이터베이스 클러스터를 만들 때 선언한 데이터베이스 클러스터 이름과 동일합니다.
NAMESPACE: 데이터베이스 클러스터의 Kubernetes 네임스페이스입니다.

AlloyDB Omni Operator 버전 1.0.0 이상을 실행하는 경우 이 명령어는 데이터베이스 클러스터에서 사용하는 AlloyDB Omni 버전을 출력합니다.

Kubernetes 클러스터에 설치된 AlloyDB Omni Operator의 버전을 확인하려면 다음 명령어를 실행합니다.

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

AlloyDB Omni Operator 버전 1.0.0 이상을 실행하는 경우 이 명령어는 Kubernetes 클러스터에서 실행 중인 AlloyDB Omni Operator의 버전 번호를 출력합니다.

1.0.0 이전 버전의 AlloyDB Omni Operator를 실행하는 경우 1.0.0 이전 AlloyDB Omni Operator에서 업그레이드의 안내를 따르세요.

그렇지 않으면 타겟 버전 번호 확인 섹션으로 이동합니다.

대상 버전 번호 확인

Kubernetes

AlloyDB Omni Operator 1.0.0 이상 버전을 실행하는 경우 다음 단계는 업그레이드하려는 AlloyDB Omni 버전에 따라 다릅니다. 이를 위해서는 AlloyDB Omni 버전 번호를 이해해야 합니다.

AlloyDB Omni 버전 번호에는 다음과 같은 구성요소가 포함됩니다.

PostgreSQL 호환성의 주요 버전 번호
PostgreSQL 호환성의 마이너 버전 번호
이 AlloyDB Omni 출시의 패치 버전 번호입니다.

예를 들어 AlloyDB Omni 버전 15.5.5는 PostgreSQL 버전 15.5를 지원하는 AlloyDB Omni의 패치 버전 5입니다.

최신 버전의 PostgreSQL을 지원하는 AlloyDB Omni 버전으로 업그레이드하려면 데이터베이스 클러스터와 함께 AlloyDB Omni Operator 자체를 업그레이드해야 합니다. 특정 PostgreSQL 마이너 버전을 지원하는 각 AlloyDB Omni 출시에는 자체 AlloyDB Omni Operator 버전 번호가 있습니다. 이 버전 번호는 AlloyDB Omni 버전의 출시 노트에서 확인할 수 있습니다.

AlloyDB Omni의 최신 패치 버전으로만 업그레이드하려는 경우 AlloyDB Omni 운영자 자체를 업그레이드할 필요 없이 데이터베이스 클러스터만 업그레이드할 수 있습니다.

그렇지 않으면 AlloyDB Omni 연산자 업그레이드 섹션으로 계속 진행합니다.

AlloyDB Omni 연산자 업그레이드

Kubernetes

AlloyDB Omni Operator를 업그레이드하려면 다음 단계를 따르세요.

환경 변수를 정의합니다.

export GCS_BUCKET=alloydb-omni-operator
export OPERATOR_VERSION=OPERATOR_VERSION
export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

OPERATOR_VERSION를 업그레이드할 AlloyDB Omni Operator 버전으로 바꿉니다(예: 1.1.0).

최신 AlloyDB Omni 연산자를 다운로드합니다.

gsutil cp -r gs://$GCS_BUCKET/$HELM_PATH ./
tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

최신 AlloyDB Omni Operator 맞춤 리소스 정의를 적용합니다.
```
kubectl apply -f alloydbomni-operator/crds
```

AlloyDB Omni Operator Helm 차트를 업그레이드합니다.

helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

AlloyDB Omni Operator 업그레이드를 완료한 후 자리에서 업그레이드 수행의 안내에 따라 새 데이터베이스 클러스터를 만듭니다.

AlloyDB Omni 클러스터가 AlloyDB Omni Operator 1.0.0으로 만들어진 경우 클러스터를 버전 15.5.5로 업그레이드하기 전에 매니페스트에 controlPlaneAgentsVersion 필드를 추가하고 1.1.0로 설정합니다. 그렇지 않으면 다음 오류가 표시됩니다.

admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.5 and/or control plane agents version 1.0.0

controlPlaneAgentsVersion 필드가 있는 샘플 매니페스트는 다음과 같습니다.

apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.5.5"
  controlPlaneAgentsVersion: "1.1.0"
...