Kubernetes에 AlloyDB Omni 설치

이 페이지에서는 AlloyDB Omni Kubernetes 연산자의 개요와 이를 사용하여 Kubernetes 클러스터에 AlloyDB Omni를 배포하는 방법을 설명합니다. 이 페이지에서는 Kubernetes 작업에 대한 기본적인 지식이 있다고 가정합니다.

표준 Linux 환경에 AlloyDB Omni를 설치하는 방법에 관한 안내는 AlloyDB Omni 설치를 참고하세요.

개요

Kubernetes 클러스터에 AlloyDB Omni를 배포하려면 Google에서 제공하는 Kubernetes API 확장 프로그램인 AlloyDB Omni 연산자를 설치합니다.

다른 Kubernetes 기반 배포와 마찬가지로 선언적 매니페스트 파일을 kubectl 유틸리티와 페어링하여 Kubernetes 기반 AlloyDB Omni 데이터베이스 클러스터를 구성하고 제어합니다. Kubernetes 클러스터가 아닌 개별 Linux 머신에 배포하기 위한 AlloyDB Omni CLI를 사용하지 않습니다.

AlloyDB Omni 연산자 1.1.0 호환성

AlloyDB Omni 버전 15.5.3 및 15.5.4와 AlloyDB Omni 연산자 버전 1.1.0은 호환되지 않습니다. 이러한 버전의 AlloyDB Omni를 사용하는 경우 다음과 유사한 오류가 발생할 수 있습니다.

Error from server (Forbidden): error when creating "[...]/dbcluster.yaml": admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.3

시작하기 전에

다음에 대한 액세스 권한이 필요합니다.

• 다음 소프트웨어를 실행하는 Kubernetes 클러스터
  • Kubernetes 버전 1.21 이상
  • cert-manager 서비스
• kubectl 유틸리티
• helm 패키지 관리자
• Google Cloud CLI gcloud CLI를 설치한 후에는 gcloud auth login을 실행하여 Google Cloud 계정을 인증해야 합니다.

Kubernetes 클러스터의 각 노드에는 다음이 있어야 합니다.

• x86 또는 AMD64 CPU 2개 이상
• 8GB 이상의 RAM
• Linux 커널 버전 4.18 이상
• Control group v2(cgroup v2) 사용 설정

AlloyDB Omni 연산자 설치

AlloyDB Omni 연산자를 설치하려면 다음 단계를 따르세요.

1. 여러 환경 변수를 정의합니다.

   export GCS_BUCKET=alloydb-omni-operator
   export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest)
   export OPERATOR_VERSION="${HELM_PATH%%/*}"

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

   gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive

3. AlloyDB Omni 연산자를 설치합니다.

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

   설치가 완료되면 다음과 같은 출력이 표시됩니다.

   NAME: alloydbomni-operator
   LAST DEPLOYED: CURRENT_TIMESTAMP
   NAMESPACE: alloydb-omni-system
   STATUS: deployed
   REVISION: 1
   TEST SUITE: None
   

4. 다운로드한 AlloyDB Omni 연산자 설치 파일을 삭제하여 정리합니다. 이 파일의 이름은 alloydbomni-operator-VERSION_NUMBER.tgz이며 현재 작업 디렉터리에 있습니다.

GDC connected 스토리지 구성

GDC connected에 AlloyDB Omni 연산자를 설치하려면 GDC 연결 클러스터가 기본 스토리지 클래스를 설정하지 않으므로 스토리지를 구성하기 위한 추가 단계를 따라야 합니다. AlloyDB Omni 데이터베이스 클러스터를 만들기 전에 기본 스토리지 클래스를 설정해야 합니다.

Symcloud Storage를 기본 스토리지 클래스로 설정하는 방법은 Symcloud Storage를 기본 스토리지 클래스로 설정을 참고하세요.

다른 모든 스토리지 클래스의 기본값 변경에 관한 자세한 내용은 기본 StorageClass 변경을 참고하세요.

Red Hat OpenShift 조정 단계

Red Hat OpenShift 4.12 이상을 사용하는 경우 AlloyDB Omni 연산자를 설치한 후 Kubernetes 클러스터에서 AlloyDB Omni 데이터베이스 클러스터를 만들기 전에 다음 단계를 완료해야 합니다. 또는 이 단계를 건너뛰어도 됩니다.

1. 다음과 같이 system:controller:statefulset-controller 클러스터 역할을 수정하여 AlloyDB Omni 인스턴스 최종 처리자를 업데이트할 권한을 추가합니다.

   kubectl edit clusterrole system:controller:statefulset-controller

2. 텍스트 편집기에서 클러스터 역할 끝에 다음을 추가합니다.

   - apiGroups:
     - alloydbomni.internal.dbadmin.goog
     resources:
     - instances/finalizers
     verbs:
     - update
   - apiGroups:
     - alloydbomni.internal.dbadmin.goog
     resources:
     - backuprepositories/finalizers
     verbs:
     - update
   

   Red Hat OpenShift에 OwnerReferencesPermissionEnforcement가 사용 설정되어 있으므로 StatefulSet 컨트롤러는 클러스터 역할에 추가된 인스턴스 최종 처리자를 업데이트할 수 있는 추가 권한이 있어야 합니다. 인스턴스 최종 처리자를 업데이트할 권한이 없으면 StatefulSet 컨트롤러가 데이터베이스 영구 볼륨 신청(PVC)을 만들지 못하고 데이터베이스 StatefulSet 이벤트에 다음과 같은 오류 메시지가 표시됩니다.

   Warning  FailedCreate  [...] cannot set blockOwnerDeletion if an ownerReference refers to a resource you can't set finalizers on
   

3. fleet-manager-role 클러스터 역할을 수정하여 AlloyDB Omni DBInstance 최종 처리자를 업데이트할 권한을 추가합니다.

   kubectl edit clusterrole fleet-manager-role

4. 텍스트 편집기에서 클러스터 역할 끝에 다음을 추가합니다.

   - apiGroups:
     - alloydbomni.dbadmin.goog
     resources:
     - dbinstances/finalizers
     verbs:
     - update
   

5. 다음과 같이 Red Hat OpenShift 프로젝트의 default 서비스 계정에 anyuid 보안 컨텍스트 제약조건을 추가합니다.

   oc adm policy add-scc-to-user anyuid system:serviceaccount:OPENSHIFT_PROJECT:default
   

   데이터베이스 포드 내에서 init 컨테이너는 루트로 실행되고 다른 컨테이너는 특정 사용자 ID로 실행되므로 default 서비스 계정이 anyuid 보안 컨텍스트 제약 조건을 사용할 수 있도록 허용해야 합니다. anyuid를 사용할 권한이 없으면 StatefulSet 컨트롤러가 데이터베이스 PVC를 만들지 못하고 데이터베이스 StatefulSet 이벤트에 다음 오류 메시지가 표시됩니다.

   Warning  FailedCreate  [...]    unable to validate against any security context constraint
   

데이터베이스 클러스터 만들기

AlloyDB Omni 데이터베이스 클러스터에는 기본 서버, 모든 복제본, 모든 데이터를 비롯하여 AlloyDB Omni 서버를 실행하는 데 필요한 모든 스토리지 및 컴퓨팅 리소스가 포함되어 있습니다.

Kubernetes 클러스터에 AlloyDB Omni 연산자를 설치한 후 다음과 유사한 매니페스트를 적용하여 Kubernetes 클러스터에 AlloyDB Omni 데이터베이스 클러스터를 만들 수 있습니다.

apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DB_CLUSTER_NAME
type: Opaque
data:
  DB_CLUSTER_NAME: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.7.0"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      cpu: CPU_COUNT
      memory: MEMORY_SIZE
      disks:
      - name: DataDisk
        size: DISK_SIZE

다음을 바꿉니다.

• DB_CLUSTER_NAME: 이 데이터베이스 클러스터의 이름입니다(예: my-db-cluster).

• ENCODED_PASSWORD: 기본 postgres 사용자 역할의 데이터베이스 로그인 비밀번호로, base64 문자열로 인코딩됩니다(예: ChangeMe123의 경우 Q2hhbmdlTWUxMjM=).

• CPU_COUNT: 이 데이터베이스 클러스터의 각 데이터베이스 인스턴스에서 사용할 수 있는 CPU 수입니다.

• MEMORY_SIZE: 이 데이터베이스 클러스터의 데이터베이스 인스턴스당 메모리 양입니다. CPU당 8GB로 설정하는 것이 좋습니다. 예를 들어 이 매니페스트에서 이전에 cpu를 2로 설정한 경우 memory를 16Gi로 설정하는 것이 좋습니다.

• DISK_SIZE: 데이터베이스 인스턴스당 디스크 크기입니다(예: 10Gi).

이 매니페스트를 적용하면 Kubernetes 클러스터에 지정된 메모리, CPU, 스토리지 구성이 포함된 AlloyDB Omni 데이터베이스 클러스터가 포함됩니다. 새 데이터베이스 클러스터와 테스트 연결을 설정하려면 사전 설치된 psql을 사용하여 연결을 참고하세요.

Kubernetes 매니페스트 및 적용 방법에 관한 자세한 내용은 리소스 관리를 참고하세요.

다음 단계

• AlloyDB Omni 실행 및 연결
• AlloyDB Omni 관리하기
• Kubernetes에서 고가용성 관리