고가용성 컨테이너 애플리케이션 배포

이 문서에서는 Google Distributed Cloud (GDC) 에어 갭에서 고가용성 (HA) Kubernetes 컨테이너 애플리케이션을 배포하는 방법을 설명합니다. 복원력을 보장하려면 여러 영역에 애플리케이션을 배포하고 스토리지 복제를 구성하여 예기치 않은 다운타임이나 로컬 재해가 발생할 경우 애플리케이션과 해당 데이터를 복구할 수 있도록 해야 합니다.

이 문서는 복원력이 우수한 컨테이너 워크로드를 만드는 애플리케이션 개발자를 대상으로 합니다.

자세한 내용은 GDC 에어 갭 문서 대상을 참조하세요.

목표

  • GDC 환경의 두 개 이상의 영역에 Kubernetes 클러스터를 만듭니다.
  • 전역 부하 분산을 구성합니다.
  • 각 영역 Kubernetes 클러스터에 컨테이너 워크로드를 배포합니다.
  • 스토리지를 프로비저닝하고 포드에 연결합니다.
  • 블록 스토리지 또는 객체 스토리지를 사용하여 스토리지 복제를 구성합니다.

시작하기 전에

이 문서의 작업을 준비하려면 필요한 권한을 얻고 환경을 확인해야 합니다.

IAM 역할 및 권한 요청

IAM 조직 관리자에게 문의하여 다음 역할을 요청하세요.

  • 네임스페이스 관리자 (namespace-admin): 공유 클러스터에서 컨테이너 워크로드를 만들고 수정합니다.
  • 사용자 클러스터 관리자 (user-cluster-admin): 공유 클러스터를 만들고 수정합니다.
  • 사용자 클러스터 개발자 (user-cluster-developer): 공유 클러스터에서 노드 풀을 만들고 수정합니다.
  • Harbor 인스턴스 관리자 (harbor-instance-admin): Harbor 인스턴스, Harbor 프로젝트, 컨테이너 이미지를 만들고 수정합니다.
  • 프로젝트 네트워크 정책 관리자 (global-project-networkpolicy-admin): 영역 간에 프로젝트 네트워크 정책을 만들고 수정합니다.
  • 전역 부하 분산기 관리자 (global-load-balancer-admin): 전역 부하 분산기를 만들고 수정합니다.
  • 볼륨 복제 전역 관리자 (app-volume-replication-admin-global): 블록 스토리지 리소스의 볼륨 복제 관계를 관리합니다.
  • 버킷 프로젝트 관리자 (global-project-bucket-admin): 이중 리전 스토리지 버킷을 만들고 수정합니다.

자세한 내용은 역할 설명을 참조하세요.

개발 환경 준비

에어 갭 적용 환경에 다음 도구와 구성이 있는지 확인합니다.

여러 영역에 Kubernetes 클러스터 만들기

가용성이 높은 컨테이너 애플리케이션을 만들려면 GDC 유니버스의 각 영역에 별도의 공유 Kubernetes 클러스터를 만들어야 합니다.

사용 가능한 클러스터 구성 옵션에 대한 자세한 내용은 Kubernetes 클러스터 구성을 참조하세요.

콘솔

  1. 탐색 메뉴에서 Kubernetes Engine > 클러스터를 선택합니다.

  2. 클러스터 만들기를 클릭합니다.

  3. 이름 필드에 클러스터 이름을 지정합니다.

  4. 클러스터의 Kubernetes 버전을 선택합니다.

  5. 클러스터를 만들 영역을 선택합니다.

  6. 프로젝트 연결을 클릭하고 클러스터에 연결할 기존 프로젝트를 선택합니다. 그런 다음 저장을 클릭합니다. 프로젝트 세부정보 페이지에서 클러스터를 만든 후 프로젝트를 연결하거나 분리할 수 있습니다. 컨테이너 워크로드를 배포하기 전에 클러스터에 연결된 프로젝트가 있어야 합니다.

  7. 다음을 클릭합니다.

  8. 클러스터의 네트워크 설정을 구성합니다. 클러스터를 만든 후에는 이러한 네트워크 설정을 변경할 수 없습니다. Kubernetes 클러스터에 지원되는 기본이자 유일한 인터넷 프로토콜은 인터넷 프로토콜 버전 4 (IPv4)입니다.

    1. 부하 분산기 IP 주소 풀 크기(예: 20)를 지정합니다.

    2. 사용할 서비스 CIDR (클래스 없는 도메인 간 라우팅)을 선택합니다. 부하 분산기와 같은 배포된 서비스에는 이 범위의 IP 주소가 할당됩니다.

    3. 사용할 포드 CIDR을 선택합니다. 클러스터는 이 범위의 IP 주소를 포드와 VM에 할당합니다.

    4. 다음을 클릭합니다.

  9. 클러스터에 대해 자동 생성된 기본 노드 풀의 세부정보를 검토합니다. 수정을 클릭하여 기본 노드 풀을 수정합니다.

  10. 추가 노드 풀을 만들려면 노드 풀 추가를 선택합니다. 기본 노드 풀을 수정하거나 새 노드 풀을 추가할 때 다음 옵션을 사용하여 맞춤설정합니다.

    1. 노드 풀의 이름을 할당합니다. 노드 풀을 만든 후에는 이름을 수정할 수 없습니다.
    2. 노드 풀에서 만들 워커 노드 수를 지정합니다.
    3. 워크로드 요구사항에 가장 적합한 머신 클래스를 선택합니다. 다음 설정 목록을 확인합니다.

      • 머신 유형
      • CPU
      • 메모리
    4. 저장을 클릭합니다.

    5. 만들기를 클릭하여 클러스터를 만듭니다.

  11. GDC 유니버스의 각 영역에 대해 이 단계를 반복합니다. HA 전략에 필요한 모든 영역에 Kubernetes 클러스터가 있는지 확인합니다.

API

API를 직접 사용하여 새 Kubernetes 클러스터를 만들려면 각 GDC 영역에 커스텀 리소스를 적용합니다.

  1. Cluster 커스텀 리소스를 만들고 영역의 Management API 서버에 배포합니다.

    kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
    apiVersion: cluster.gdc.goog/v1
    kind: Cluster
    metadata:
      name: CLUSTER_NAME
      namespace: platform
    spec:
      clusterNetwork:
        podCIDRSize: POD_CIDR
        serviceCIDRSize: SERVICE_CIDR
      initialVersion:
        kubernetesVersion: KUBERNETES_VERSION
      nodePools:
      - machineTypeName: MACHINE_TYPE
        name: NODE_POOL_NAME
        nodeCount: NUMBER_OF_WORKER_NODES
        taints: TAINTS
        labels: LABELS
        acceleratorOptions:
          gpuPartitionScheme: GPU_PARTITION_SCHEME
      releaseChannel:
        channel: UNSPECIFIED
    EOF
    

    다음을 바꿉니다.

    • MANAGEMENT_API_SERVER: 영역 Management API 서버의 kubeconfig 경로입니다. 자세한 내용은 영역 컨텍스트로 전환을 참조하세요.
    • CLUSTER_NAME: 클러스터의 이름입니다. 클러스터 이름은 -system로 끝나면 안 됩니다. -system 서픽스는 GDC에서 만든 클러스터용으로 예약되어 있습니다.
    • POD_CIDR: 포드 가상 IP 주소 (VIP)가 할당되는 네트워크 범위의 크기입니다. 설정하지 않으면 기본값 21가 사용됩니다.
    • SERVICE_CIDR: 서비스 VIP가 할당되는 네트워크 범위의 크기입니다. 설정하지 않으면 기본값 23가 사용됩니다.
    • KUBERNETES_VERSION: 클러스터의 Kubernetes 버전입니다(예: 1.26.5-gke.2100). 구성할 수 있는 Kubernetes 버전을 나열하려면 클러스터에 사용 가능한 Kubernetes 버전 나열을 참조하세요.
    • MACHINE_TYPE: 노드 풀의 워커 노드에 사용할 머신 유형입니다. 구성할 수 있는 항목은 사용 가능한 머신 유형을 참조하세요.
    • NODE_POOL_NAME: 노드 풀의 이름입니다.
    • NUMBER_OF_WORKER_NODES: 노드 풀에서 프로비저닝할 워커 노드 수입니다.
    • TAINTS: 이 노드 풀의 노드에 적용할 taint입니다. 이 필드는 선택사항입니다.
    • LABELS: 이 노드 풀의 노드에 적용할 라벨입니다. 키-값 쌍 목록이 포함됩니다. 이 필드는 선택사항입니다.
    • GPU_PARTITION_SCHEME: GPU 워크로드를 실행하는 경우 GPU 파티셔닝 스키마입니다(예: mixed-2). 이 필드가 설정되지 않으면 GPU가 파티셔닝되지 않습니다. 사용 가능한 멀티 인스턴스 GPU (MIG) 프로필은 지원되는 MIG 프로필을 참조하세요.
  2. HA 전략을 위해 컨테이너 애플리케이션을 호스팅하려는 각 영역에 대해 이전 단계를 반복합니다.

부하 분산기 구성

서로 다른 영역에 있는 포드 간에 트래픽을 분산하려면 부하 분산기를 만듭니다. 클라이언트 요청이 정상 영역으로 라우팅되도록 내부 및 외부 부하 분산기를 전역적으로 구성할 수 있습니다.

전역 내부 부하 분산기 만들기

내부 부하 분산기 (ILB)는 조직에 할당된 내부 IP 주소 풀에서 조직 내 서비스를 노출합니다. ILB 서비스는 조직 외부의 엔드포인트에서 액세스할 수 없습니다.

컨테이너 워크로드에 대한 전역 ILB를 만들려면 다음 단계를 완료합니다.

gdcloud

gdcloud CLI를 사용하여 포드 워크로드를 타겟팅하는 ILB를 만듭니다.

이 ILB는 Backend 객체에 정의된 라벨과 일치하는 프로젝트의 모든 워크로드를 타겟팅합니다. Backend 커스텀 리소스의 범위는 영역으로 지정되어야 합니다.

gdcloud CLI를 사용하여 ILB를 만들려면 다음 단계를 따르세요.

  1. 포드가 실행 중인 각 영역에 영역별 Backend 리소스를 만들어 ILB의 엔드포인트를 정의합니다.

    gdcloud compute backends create BACKEND_NAME \
        --labels=LABELS \
        --project=PROJECT \
        --cluster-name=CLUSTER_NAME \
        --zone=ZONE
    

    다음을 바꿉니다.

    • BACKEND_NAME: 백엔드 리소스에 선택한 이름입니다(예: my-backend).
    • LABELS: 이 백엔드 리소스에 사용할 포드 간 엔드포인트를 정의하는 선택기입니다(예: app=web).
    • PROJECT: 프로젝트의 이름
    • CLUSTER_NAME: 정의된 선택기의 범위가 제한되는 Kubernetes 클러스터입니다. 이 필드를 지정하지 않으면 지정된 라벨이 있는 모든 엔드포인트가 선택됩니다. 이 필드는 선택사항입니다.
    • ZONE: 이 호출에 사용할 영역입니다. 영역 플래그가 필요한 모든 명령어에 대해 영역 플래그를 미리 설정하려면 gdcloud config set core/zone ZONE를 실행합니다. 영역 플래그는 멀티 영역 환경에서만 사용할 수 있습니다. 이 필드는 선택사항입니다.

    GDC 유니버스의 각 영역에 대해 이 단계를 반복합니다.

  2. 전역 BackendService 리소스를 만듭니다.

    gdcloud compute backend-services create BACKEND_SERVICE_NAME \
        --project=PROJECT \
        --target-ports=TARGET_PORTS \
        --global
    

    다음을 바꿉니다.

    • BACKEND_SERVICE_NAME: 백엔드 서비스의 이름입니다.
    • PROJECT: 프로젝트의 이름
    • TARGET_PORTS: 이 백엔드 서비스가 변환하는 대상 포트의 쉼표로 구분된 목록입니다. 각 대상 포트는 프로토콜, 전달 규칙의 포트, 백엔드 인스턴스의 포트를 지정합니다. 여러 대상 포트를 지정할 수 있습니다. 이 필드는 protocol:port:targetport 형식이어야 합니다(예: TCP:80:8080). 이 필드는 선택사항입니다.
  3. 각 영역에서 이전에 만든 Backend 리소스에 BackendService 리소스를 추가합니다.

    gdcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
        --backend-zone=ZONE \
        --backend=BACKEND_NAME \
        --project=PROJECT \
        --global
    

    다음을 바꿉니다.

    • BACKEND_SERVICE_NAME: 전역 백엔드 서비스의 이름입니다.
    • ZONE: 백엔드의 영역입니다.
    • BACKEND_NAME: 영역 백엔드의 이름입니다.
    • PROJECT: 프로젝트의 이름

    이전에 만든 각 영역 백엔드에 대해 이 단계를 완료합니다.

  4. 서비스를 사용할 수 있는 가상 IP 주소 (VIP)를 정의하는 내부 ForwardingRule 리소스를 만듭니다.

    gdcloud compute forwarding-rules create FORWARDING_RULE_INTERNAL_NAME \
        --backend-service=BACKEND_SERVICE_NAME \
        --cidr=CIDR \
        --ip-protocol-port=PROTOCOL_PORT \
        --load-balancing-scheme=INTERNAL \
        --project=PROJECT \
        --global
    

    다음을 바꿉니다.

    • FORWARDING_RULE_INTERNAL_NAME: 전달 규칙의 이름입니다.
    • CIDR: 전달 규칙에 사용할 CIDR입니다. 이 필드는 선택사항입니다. 지정하지 않으면 IPv4/32 CIDR이 전역 IP 주소 풀에서 자동으로 예약됩니다. 이 전달 규칙과 동일한 네임스페이스에 있는 Subnet 리소스의 이름을 지정합니다. Subnet 리소스는 전역 서브넷의 요청 및 할당 정보를 나타냅니다. Subnet 리소스에 대한 자세한 내용은 서브넷 관리를 참조하세요.
    • PROTOCOL_PORT: 전달 규칙에 노출할 프로토콜 및 포트입니다. 이 필드는 ip-protocol=TCP:80 형식이어야 합니다. 노출된 포트는 실제 애플리케이션이 컨테이너 내부에 노출하는 포트와 동일해야 합니다.
  5. 구성된 ILB를 검증하려면 생성된 각 객체에서 Ready 조건을 확인합니다. VIP에 대한 curl 요청으로 트래픽을 확인합니다.

    1. 할당된 VIP를 가져오려면 전달 규칙을 설명합니다.

      gdcloud compute forwarding-rules describe FORWARDING_RULE_INTERNAL_NAME --global
      
    2. 전달 규칙의 필드에 지정된 포트에서 VIP에 대한 curl 요청으로 트래픽을 확인합니다.

      curl http://FORWARDING_RULE_VIP:PORT
      

    다음을 바꿉니다.

    • FORWARDING_RULE_VIP: 전달 규칙의 VIP입니다.
    • PORT: 전달 규칙의 포트 번호입니다.

API

KRM API를 사용하여 컨테이너 워크로드를 타겟팅하는 ILB를 만듭니다. 이 ILB는 Backend 객체에 정의된 라벨과 일치하는 프로젝트의 모든 워크로드를 타겟팅합니다. KRM API를 사용하여 전역 ILB를 만들려면 다음 단계를 따르세요.

  1. Backend 리소스를 만들어 ILB의 엔드포인트를 정의합니다. 컨테이너 워크로드가 배치된 각 영역에 대해 Backend 리소스를 만듭니다.

    kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
    apiVersion: networking.gdc.goog/v1
    kind: Backend
    metadata:
      namespace: PROJECT
      name: BACKEND_NAME
    spec:
      clusterName: CLUSTER_NAME
      endpointsLabels:
        matchLabels:
          app: APP_NAME
    EOF
    

    다음을 바꿉니다.

    • MANAGEMENT_API_SERVER: 영역 Management API 서버의 kubeconfig 경로입니다. 자세한 내용은 영역 컨텍스트로 전환을 참조하세요.
    • PROJECT: 프로젝트의 이름
    • BACKEND_NAME: Backend 리소스의 이름입니다.
    • CLUSTER_NAME: 정의된 선택기의 범위가 제한되는 Kubernetes 클러스터입니다. 이 필드를 지정하지 않으면 지정된 라벨이 있는 모든 엔드포인트가 선택됩니다. 이 필드는 선택사항입니다.
    • APP_NAME: 컨테이너 애플리케이션의 이름입니다.

    각 영역에 동일한 Backend 리소스를 사용하거나 각 영역에 대해 서로 다른 라벨 집합이 있는 Backend 리소스를 만들 수 있습니다.

  2. 이전에 만든 Backend 리소스를 사용하여 BackendService 객체를 만듭니다. HealthCheck 리소스를 포함해야 합니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: BackendService
    metadata:
      namespace: PROJECT
      name: BACKEND_SERVICE_NAME
    spec:
      backendRefs:
      - name: BACKEND_NAME
        zone: ZONE
      healthCheckName: HEALTH_CHECK_NAME
      targetPorts:
      - port: PORT
        protocol: PROTOCOL
        targetPort: TARGET_PORT
    EOF
    

    다음을 바꿉니다.

    • GLOBAL_API_SERVER: 전역 API 서버의 kubeconfig 경로입니다.
    • PROJECT: 프로젝트의 이름
    • BACKEND_SERVICE_NAME: BackendService 리소스에 대해 선택한 이름입니다.
    • HEALTH_CHECK_NAME: 이전에 만든 HealthCheck 리소스의 이름입니다.
    • BACKEND_NAME: 영역 Backend 리소스의 이름입니다.
    • ZONE: Backend 리소스가 있는 영역입니다. backendRefs 필드에 여러 백엔드를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

      - name: my-backend-1
        zone: us-east1-a
      - name: my-backend-2
        zone: us-east1-b
      

      targetPorts 필드는 선택사항입니다. 이 리소스는 이 BackendService 리소스가 변환하는 포트를 나열합니다. 이 객체를 사용하는 경우 다음에 대한 값을 제공합니다.

    • PORT: 서비스에서 노출하는 포트입니다.

    • PROTOCOL: 트래픽이 일치해야 하는 레이어 4 프로토콜입니다. TCP 및 UDP만 지원됩니다.

    • TARGET_PORT: 값이 변환되는 포트입니다(예: 8080). 지정된 객체에서 값을 반복할 수 없습니다.

      targetPorts의 예시는 다음과 같습니다.

      targetPorts:
        - port: 80
          protocol: TCP
          targetPort: 8080
      
  3. 서비스를 사용할 수 있는 가상 IP 주소 (VIP)를 정의하는 내부 ForwardingRule 리소스를 만듭니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: ForwardingRuleInternal
    metadata:
      namespace: PROJECT
      name: FORWARDING_RULE_INTERNAL_NAME
    spec:
      cidrRef:
        name: CIDR_NAME
      ports:
      - port: PORT
        protocol: PROTOCOL
      backendServiceRef:
        name: BACKEND_SERVICE_NAME
    EOF
    

    다음을 바꿉니다.

    • GLOBAL_API_SERVER: 전역 API 서버의 kubeconfig 경로입니다.
    • PROJECT: 프로젝트의 이름
    • FORWARDING_RULE_INTERNAL_NAME: ForwardingRuleInternal 리소스에 대해 선택한 이름입니다.
    • CIDR_NAME: 전달 규칙에 사용할 CIDR의 이름입니다. 이 필드는 선택사항입니다. 지정하지 않으면 IPv4/32 CIDR이 전역 IP 주소 풀에서 자동으로 예약됩니다. 이 전달 규칙과 동일한 네임스페이스에 있는 Subnet 리소스의 이름을 지정합니다. Subnet 리소스는 전역 서브넷의 요청 및 할당 정보를 나타냅니다. Subnet 리소스에 대한 자세한 내용은 서브넷 관리를 참조하세요.
    • PORT: 전달 규칙에 노출할 포트입니다. ports 필드를 사용하여 이 전달 규칙으로 구성된 백엔드로 패킷이 전달되는 L4 포트 배열을 지정합니다. 포트를 하나 이상 지정해야 합니다. port 필드를 사용하여 포트 번호를 지정합니다. 노출된 포트는 실제 애플리케이션이 컨테이너 내부에 노출하는 포트와 동일해야 합니다.
    • PROTOCOL: 전달 규칙에 사용할 프로토콜입니다(예: TCP). ports 배열의 항목은 다음과 같이 표시되어야 합니다.

      ports:
      - port: 80
        protocol: TCP
      
  4. 구성된 ILB를 검증하려면 생성된 각 객체에서 Ready 조건을 확인합니다. VIP에 대한 curl 요청으로 트래픽을 확인합니다.

    1. VIP를 검색합니다.

      kubectl get forwardingruleinternal -n PROJECT
      

      출력은 다음과 같이 표시됩니다.

      NAME           BACKENDSERVICE                  CIDR              READY
      ilb-name       BACKEND_SERVICE_NAME            192.0.2.0/32      True
      
    2. 전달 규칙의 필드에 지정된 포트에서 VIP에 대한 curl 요청으로 트래픽을 테스트합니다.

      curl http://FORWARDING_RULE_VIP:PORT
      

      다음을 바꿉니다.

      • FORWARDING_RULE_VIP: 전달 규칙의 VIP입니다.
      • PORT: 전달 규칙에 있는 필드의 포트 번호입니다.

전역 외부 부하 분산기 만들기

외부 부하 분산기 (ELB)는 더 큰 인스턴스 외부 IP 주소 풀에서 조직에 할당된 풀의 IP 주소에서 조직 외부에서 액세스할 수 있도록 서비스를 노출합니다.

컨테이너 워크로드에 대한 전역 ELB를 만들려면 다음 단계를 완료합니다.

gdcloud

gdcloud CLI를 사용하여 Backend 객체에 정의된 라벨과 일치하는 프로젝트의 모든 워크로드를 타겟팅하는 전역 ELB를 만듭니다. Backend 커스텀 리소스의 범위는 영역으로 지정되어야 합니다.

  1. ELB 서비스가 작동하려면 이 ELB 서비스의 워크로드에 대한 트래픽을 허용하도록 자체 맞춤설정된 ProjectNetworkPolicy 데이터 전송 정책을 구성하고 적용해야 합니다. 네트워크 정책은 부하 분산기 자체가 아닌 워크로드에 대한 액세스를 제어합니다. ELB는 워크로드를 고객 네트워크에 노출하므로 8080과 같은 워크로드 포트에 대한 외부 트래픽을 허용하려면 명시적인 네트워크 정책이 필요합니다.

    이 ELB의 워크로드에 대한 트래픽을 허용할 외부 CIDR 주소를 지정합니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: ProjectNetworkPolicy
    metadata:
      namespace: PROJECT
      name: allow-inbound-traffic-from-external
    spec:
      policyType: Ingress
      subject:
        subjectType: UserWorkload
      ingress:
      - from:
        - ipBlock:
            cidr: CIDR
        ports:
        - protocol: TCP
          port: PORT
    EOF
    

    다음을 바꿉니다.

    • GLOBAL_API_SERVER: 전역 API 서버의 kubeconfig 경로입니다. 전역 API 서버의 kubeconfig 파일을 아직 생성하지 않은 경우 kubeconfig 파일 수동 생성에서 자세한 내용을 참조하세요.
    • PROJECT: 프로젝트의 이름
    • CIDR: ELB에 액세스해야 하는 외부 CIDR입니다. 이 정책은 외부 부하 분산기가 소스 외부 IP 주소를 보존하고 반환 경로에서 부하 분산기를 우회하는 직접 서버 반환 (DSR)을 사용하므로 필요합니다. 자세한 내용은 조직 외부 트래픽에 대한 전역 인그레스 방화벽 규칙 만들기를 참조하세요.
    • PORT: 부하 분산기 뒤에 있는 포드의 백엔드 포트입니다. 이 값은 Service 리소스의 매니페스트에 있는 .spec.ports[].targetPortfield 필드에서 찾을 수 있습니다. 이 필드는 선택사항입니다.

    이 구성은 프로젝트 내의 모든 리소스에 지정된 CIDR 범위에 대한 액세스 권한을 제공합니다.

  2. 각 영역에 Backend 리소스를 만들어 ELB의 엔드포인트를 정의합니다.

    gdcloud compute backends create BACKEND_NAME \
      --labels=LABELS \
      --project=PROJECT \
      --cluster-name=CLUSTER_NAME \
      --zone=ZONE
    

    다음을 바꿉니다.

    • BACKEND_NAME: 백엔드 리소스의 이름입니다(예: my-backend).
    • LABELS: 이 백엔드 리소스에 사용할 포드 간 엔드포인트를 정의하는 선택기입니다(예: app=web).
    • PROJECT: 프로젝트의 이름
    • CLUSTER_NAME: 정의된 선택기의 범위가 제한되는 Kubernetes 클러스터입니다. 이 필드를 지정하지 않으면 지정된 라벨이 있는 모든 엔드포인트가 선택됩니다. 이 필드는 선택사항입니다.
    • ZONE: 이 호출에 사용할 영역입니다. 영역 플래그가 필요한 모든 명령어에 대해 영역 플래그를 미리 설정하려면 gdcloud config set core/zone ZONE를 실행합니다. 영역 플래그는 멀티 영역 환경에서만 사용할 수 있습니다. 이 필드는 선택사항입니다.

    각 영역에 동일한 Backend 리소스를 사용하거나 각 영역에 대해 서로 다른 라벨 집합이 있는 Backend 리소스를 만들 수 있습니다.

  3. 전역 BackendService 리소스를 만듭니다.

    gdcloud compute backend-services create BACKEND_SERVICE_NAME \
      --project=PROJECT \
      --target-ports=TARGET_PORTS \
      --health-check=HEALTH_CHECK_NAME \
      --global
    

    다음을 바꿉니다.

    • BACKEND_SERVICE_NAME: 이 백엔드 서비스에 선택한 이름입니다.
    • PROJECT: 프로젝트의 이름
    • TARGET_PORTS: 이 백엔드 서비스가 변환하는 대상 포트의 쉼표로 구분된 목록입니다. 각 대상 포트는 프로토콜, 전달 규칙의 포트, 백엔드 인스턴스의 포트를 지정합니다. 여러 대상 포트를 지정할 수 있습니다. 이 필드는 protocol:port:targetport 형식이어야 합니다(예: TCP:80:8080). 이 필드는 선택사항입니다.
    • HEALTH_CHECK_NAME: 상태 점검 리소스의 이름입니다. 이 필드는 선택사항입니다.
  4. 이전에 만든 영역 Backend 리소스에 전역 BackendService 리소스를 추가합니다.

    gdcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
      --backend=BACKEND_NAME \
      --backend-zone=ZONE \
      --project=PROJECT \
      --global
    

    이전에 만든 각 영역 백엔드에 대해 이 단계를 완료합니다.

  5. 서비스를 사용할 수 있는 VIP를 정의하는 외부 ForwardingRule 리소스를 만듭니다.

    gdcloud compute forwarding-rules create FORWARDING_RULE_EXTERNAL_NAME \
      --backend-service=BACKEND_SERVICE_NAME \
      --cidr=CIDR \
      --ip-protocol-port=PROTOCOL_PORT \
      --load-balancing-scheme=EXTERNAL \
      --project=PROJECT \
      --global
    

    다음을 바꿉니다.

    • FORWARDING_RULE_EXTERNAL_NAME: 전달 규칙의 이름입니다.
    • CIDR: 전달 규칙에 사용할 CIDR입니다. 이 필드는 선택사항입니다. 지정하지 않으면 IPv4/32 CIDR이 전역 IP 주소 풀에서 자동으로 예약됩니다. 이 전달 규칙과 동일한 네임스페이스에 있는 Subnet 리소스의 이름을 지정합니다. Subnet 리소스는 전역 서브넷의 요청 및 할당 정보를 나타냅니다. Subnet 리소스에 대한 자세한 내용은 서브넷 관리를 참조하세요.
    • PROTOCOL_PORT: 전달 규칙에 노출할 프로토콜 및 포트입니다. 이 필드는 ip-protocol=TCP:80 형식이어야 합니다. 노출된 포트는 실제 애플리케이션이 컨테이너 내부에 노출하는 포트와 동일해야 합니다.
    • PROJECT: 프로젝트의 이름
  6. 구성된 ELB를 검증하려면 생성된 각 객체에서 Ready 조건을 확인합니다. VIP에 대한 curl 요청으로 트래픽을 확인합니다.

    1. 할당된 VIP를 가져오려면 전달 규칙을 설명합니다.

      gdcloud compute forwarding-rules describe FORWARDING_RULE_EXTERNAL_NAME
      
    2. 전달 규칙의 PROTOCOL_PORT 필드에 지정된 포트에서 VIP에 대한 curl 요청으로 트래픽을 확인합니다.

      curl http://FORWARDING_RULE_VIP:PORT
      

      다음을 바꿉니다.

      • FORWARDING_RULE_VIP: 전달 규칙의 VIP입니다.
      • PORT: 전달 규칙의 PROTOCOL_PORT 필드에 있는 포트 번호입니다.

API

KRM API를 사용하여 포드 워크로드를 타겟팅하는 ELB를 만듭니다. 이 ELB는 Backend 객체에 정의된 라벨과 일치하는 프로젝트의 모든 워크로드를 타겟팅합니다. KRM API를 사용하여 영역 ELB를 만들려면 다음 단계를 따르세요.

  1. ELB 서비스가 작동하려면 이 ELB 서비스의 워크로드에 대한 트래픽을 허용하도록 자체 맞춤설정된 ProjectNetworkPolicy 데이터 전송 정책을 구성하고 적용해야 합니다. 네트워크 정책은 부하 분산기 자체가 아닌 워크로드에 대한 액세스를 제어합니다. ELB는 워크로드를 고객 네트워크에 노출하므로 8080과 같은 워크로드 포트에 대한 외부 트래픽을 허용하려면 명시적인 네트워크 정책이 필요합니다.

    이 ELB의 워크로드에 대한 트래픽을 허용할 외부 CIDR 주소를 지정합니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: ProjectNetworkPolicy
    metadata:
      namespace: PROJECT
      name: allow-inbound-traffic-from-external
    spec:
      policyType: Ingress
      subject:
        subjectType: UserWorkload
      ingress:
      - from:
        - ipBlock:
            cidr: CIDR
        ports:
        - protocol: TCP
          port: PORT
    EOF
    

    다음을 바꿉니다.

    • GLOBAL_API_SERVER: 전역 API 서버의 kubeconfig 경로입니다. 전역 API 서버의 kubeconfig 파일을 아직 생성하지 않은 경우 kubeconfig 파일 수동 생성에서 자세한 내용을 참조하세요.
    • PROJECT: 프로젝트의 이름
    • CIDR: ELB에 액세스해야 하는 외부 CIDR입니다. 이 정책은 외부 부하 분산기가 소스 외부 IP 주소를 보존하고 반환 경로에서 부하 분산기를 우회하는 직접 서버 반환 (DSR)을 사용하므로 필요합니다. 자세한 내용은 조직 외부 트래픽에 대한 전역 인그레스 방화벽 규칙 만들기를 참조하세요.
    • PORT: 부하 분산기 뒤에 있는 포드의 백엔드 포트입니다. 이 값은 Service 리소스의 매니페스트에 있는 .spec.ports[].targetPortfield 필드에서 찾을 수 있습니다. 이 필드는 선택사항입니다.
  2. Backend 리소스를 만들어 ELB의 엔드포인트를 정의합니다. 워크로드가 배치된 각 영역에 대해 Backend 리소스를 만듭니다.

    kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
    apiVersion: networking.gdc.goog/v1
    kind: Backend
    metadata:
      namespace: PROJECT
      name: BACKEND_NAME
    spec:
      clusterName: CLUSTER_NAME
      endpointsLabels:
        matchLabels:
          app: APP_NAME
    EOF
    

    다음을 바꿉니다.

    • MANAGEMENT_API_SERVER: 영역 Management API 서버의 kubeconfig 경로입니다. 대상 영역의 API 서버에 대한 kubeconfig 파일을 아직 생성하지 않은 경우 자세한 내용은 kubeconfig 파일 수동 생성을 참조하세요.
    • PROJECT: 프로젝트의 이름
    • BACKEND_NAME: Backend 리소스 이름입니다.
    • CLUSTER_NAME: 정의된 선택기의 범위가 제한되는 Kubernetes 클러스터입니다. 이 필드를 지정하지 않으면 지정된 라벨이 있는 모든 엔드포인트가 선택됩니다. 이 필드는 선택사항입니다.
    • APP_NAME: 컨테이너 애플리케이션의 이름입니다.

    각 영역에 동일한 Backend 리소스를 사용하거나 각 영역에 대해 서로 다른 라벨 집합이 있는 Backend 리소스를 만들 수 있습니다.

  3. 이전에 만든 Backend 리소스를 사용하여 BackendService 객체를 만듭니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: BackendService
    metadata:
      namespace: PROJECT
      name: BACKEND_SERVICE_NAME
    spec:
      backendRefs:
      - name: BACKEND_NAME
        zone: ZONE
      healthCheckName: HEALTH_CHECK_NAME
    EOF
    

    다음을 바꿉니다.

    • BACKEND_SERVICE_NAME: BackendService 리소스에 대해 선택한 이름입니다.
    • HEALTH_CHECK_NAME: 이전에 만든 HealthCheck 리소스의 이름입니다. 포드 워크로드에 ELB를 구성하는 경우 이 필드를 포함하지 마세요.
    • ZONE: Backend 리소스가 있는 영역입니다. backendRefs 필드에 여러 백엔드를 지정할 수 있습니다. 예를 들면 다음과 같습니다.
    - name: my-backend-1
      zone: us-east1-a
    - name: my-backend-2
      zone: us-east1-b
    

  4. 서비스를 사용할 수 있는 VIP를 정의하는 외부 ForwardingRule 리소스를 만듭니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: ForwardingRuleExternal
    metadata:
      namespace: PROJECT
      name: FORWARDING_RULE_EXTERNAL_NAME
    spec:
      cidrRef:
        name: CIDR_NAME
      ports:
      - port: PORT
        protocol: PROTOCOL
      backendServiceRef:
        name: BACKEND_SERVICE_NAME
    EOF
    

    다음을 바꿉니다.

    • FORWARDING_RULE_EXTERNAL_NAME: ForwardingRuleExternal 리소스에 대해 선택한 이름입니다.
    • CIDR_NAME: 전달 규칙에 사용할 CIDR의 이름입니다. 이 필드는 선택사항입니다. 지정하지 않으면 IPv4/32 CIDR이 전역 IP 주소 풀에서 자동으로 예약됩니다. 이 전달 규칙과 동일한 네임스페이스에 있는 Subnet 리소스의 이름을 지정합니다. Subnet 리소스는 전역 서브넷의 요청 및 할당 정보를 나타냅니다. Subnet 리소스에 대한 자세한 내용은 서브넷 관리를 참조하세요.
    • PORT: 전달 규칙에 노출할 포트입니다. ports 필드를 사용하여 이 전달 규칙으로 구성된 백엔드로 패킷이 전달되는 L4 포트 배열을 지정합니다. 포트를 하나 이상 지정해야 합니다. port 필드를 사용하여 포트 번호를 지정합니다. 노출된 포트는 실제 애플리케이션이 컨테이너 내부에 노출하는 포트와 동일해야 합니다.
    • PROTOCOL: 전달 규칙에 사용할 프로토콜입니다(예: TCP). ports 배열의 항목은 다음과 같이 표시됩니다.
    ports:
    - port: 80
      protocol: TCP
    
  5. 구성된 ELB를 검증하려면 생성된 각 객체에서 Ready 조건을 확인합니다. VIP에 대한 curl 요청으로 트래픽을 시도하고 테스트합니다.

    1. 프로젝트의 VIP를 검색합니다.

      kubectl get forwardingruleexternal -n PROJECT
      

      출력은 다음과 같이 표시됩니다.

      NAME           BACKENDSERVICE                  CIDR              READY
      elb-name       BACKEND_SERVICE_NAME            192.0.2.0/32      True
      
    2. 전달 규칙의 PORT 필드에 지정된 포트에서 VIP에 대한 curl 요청으로 트래픽을 확인합니다.

      curl http://FORWARDING_RULE_VIP:PORT
      

      FORWARDING_RULE_VIP:PORT를 전달 규칙의 VIP 및 포트(예: 192.0.2.0:80)로 바꿉니다.

각 영역 클러스터에 컨테이너 워크로드 배포

컨테이너 워크로드는 전역 리소스가 아니므로 각 컨테이너 애플리케이션을 영역 Kubernetes 클러스터에 개별적으로 배포해야 합니다.

  1. Kubernetes 클러스터를 호스팅하는 영역에 로그인합니다.

    gdcloud config set core/zone ZONE
    
  2. 관리형 Harbor 레지스트리에서 컨테이너 이미지를 사용할 수 있는지 확인합니다. 자세한 내용은 컨테이너 앱 배포 튜토리얼을 참조하세요.

  3. 컨테이너 워크로드의 매니페스트 파일을 만들고 영역 Kubernetes 클러스터에 배포합니다.

    kubectl --kubeconfig KUBERNETES_CLUSTER -n PROJECT apply -f - <<EOF
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: DEPLOYMENT_NAME
    spec:
      replicas: NUMBER_OF_REPLICAS
      selector:
        matchLabels:
          run: APP_NAME
      template:
        metadata:
          labels:
            run: APP_NAME
        spec:
          containers:
          - name: CONTAINER_NAME
            image: HARBOR_INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG
    EOF
    

    다음을 바꿉니다.

    • KUBERNETES_CLUSTER: 컨테이너 워크로드를 배포하는 영역 Kubernetes 클러스터의 kubeconfig 파일입니다. 영역 Kubernetes 클러스터의 kubeconfig 파일을 아직 생성하지 않은 경우 자세한 내용은 kubeconfig 파일 수동 생성을 참조하세요.
    • PROJECT: 컨테이너 워크로드를 배포할 프로젝트 네임스페이스입니다.
    • DEPLOYMENT_NAME: 컨테이너 배포의 이름입니다.
    • NUMBER_OF_REPLICAS: 배포에서 관리하는 복제된 Pod 객체 수입니다.
    • APP_NAME: 배포 내에서 실행할 애플리케이션의 이름입니다.
    • CONTAINER_NAME: 컨테이너의 이름.
    • HARBOR_INSTANCE_URL: Harbor 인스턴스의 URL입니다(예: harbor-1.org-1.zone1.google.gdc.test.). Harbor 인스턴스의 URL을 검색하려면 Harbor 레지스트리 인스턴스 보기를 참조하세요.
    • HARBOR_PROJECT_NAME: Harbor 프로젝트의 이름입니다(예: my-project).
    • IMAGE: 이미지 이름입니다(예: nginx).
    • TAG: 가져오려는 이미지 버전의 태그(예: 1.0)
  4. GDC 세계의 각 영역에 대해 이전 단계를 반복합니다. 컨테이너 애플리케이션이 HA 전략에 필요한 모든 영역에 있는지 확인합니다.

Kubernetes를 사용하여 컨테이너 애플리케이션 노출

GDC 유니버스의 다른 리소스에서 액세스할 수 있도록 컨테이너 애플리케이션을 노출해야 합니다.

  1. type: LoadBalancer의 Service 리소스를 만듭니다. 이 리소스는 네트워크를 통해 애플리케이션의 포드를 노출합니다.

    kubectl --kubeconfig KUBERNETES_CLUSTER -n PROJECT apply -f - <<EOF
    apiVersion: v1
    kind: Service
    metadata:
      name: SERVICE_NAME
    spec:
      selector:
        app: APP_NAME
      ports:
        - port: 80
          protocol: TCP
      type: LoadBalancer
    EOF
    

    다음을 바꿉니다.

    • KUBERNETES_CLUSTER: 컨테이너 워크로드를 배포하는 영역 Kubernetes 클러스터의 kubeconfig 파일입니다.
    • PROJECT: 컨테이너 워크로드가 있는 프로젝트 네임스페이스입니다.
    • SERVICE_NAME: 부하 분산기 서비스의 이름입니다.
    • APP_NAME: 컨테이너 애플리케이션에 적용한 라벨입니다.
  2. 기본 네임스페이스에 대한 모든 네트워크 트래픽을 허용하는 NetworkPolicy 커스텀 리소스를 만듭니다.

    kubectl --kubeconfig KUBERNETES_CLUSTER -n PROJECT apply -f - <<EOF
    apiVersion: networking.k8s.io/v1
    kind: NetworkPolicy
    metadata:
      annotations:
      name: allow-all
    spec:
      ingress:
      - from:
        - ipBlock:
            cidr: 0.0.0.0/0
      podSelector: {}
      policyTypes:
      - Ingress
    EOF
    

포드에 영구 스토리지 프로비저닝

애플리케이션 포드에 영구 스토리지를 제공하려면 PersistentVolumeClaim 리소스 (PVC)를 만들어야 합니다.

다음 안내에서는 GDC standard-rwo StorageClass를 사용하여 볼륨을 만드는 방법을 보여줍니다.

  1. PersistentVolumeClaim 리소스를 만듭니다. 예를 들어 ReadWriteOnce 액세스 모드와 standard-rwo 스토리지 클래스로 구성합니다.

    kubectl --kubeconfig KUBERNETES_CLUSTER -n PROJECT apply -f - <<EOF
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: PVC_NAME
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: 10Gi
      storageClassName: standard-rwo
    EOF
    

    다음을 바꿉니다.

    • KUBERNETES_CLUSTER: Kubernetes 클러스터의 kubeconfig 파일입니다.
    • PROJECT: PVC를 만들 프로젝트 네임스페이스입니다.
    • PVC_NAME: PersistentVolumeClaim 객체의 이름입니다.
  2. PersistentVolume (PV) 객체는 동적으로 프로비저닝됩니다. Kubernetes 클러스터에서 새 PV의 상태를 확인합니다.

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER
    

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

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
    pvc-uuidd  10Gi       RWO            Bound       pvc-name  standard-rwo   60s
    
  3. PVC를 사용하도록 컨테이너 워크로드를 구성합니다. 다음은 standard-rwo PVC를 사용하는 포드 매니페스트의 예시입니다.

    kubectl --kubeconfig KUBERNETES_CLUSTER -n PROJECT apply -f - <<EOF
    apiVersion: apps/v1
    kind: Pod
    metadata:
      name: web-server-deployment
      labels:
        app: APP_LABEL
    spec:
      containers:
      - name: CONTAINER_NAME
        image: HARBOR_INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG
        volumeMounts:
        - mountPath: MOUNT_PATH
          name: data
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: PVC_NAME
    EOF
    

    다음을 바꿉니다.

    • KUBERNETES_CLUSTER: 컨테이너 워크로드를 배포하는 Kubernetes 클러스터의 kubeconfig 파일입니다.
    • PROJECT: PVC가 있는 프로젝트 네임스페이스입니다.
    • APP_LABEL: 컨테이너 애플리케이션에 적용한 라벨입니다.
    • CONTAINER_NAME: 컨테이너의 이름.
    • HARBOR_INSTANCE_URL: Harbor 인스턴스의 URL입니다(예: harbor-1.org-1.zone1.google.gdc.test.). Harbor 인스턴스의 URL을 검색하려면 Harbor 레지스트리 인스턴스 보기를 참조하세요.
    • HARBOR_PROJECT_NAME: Harbor 프로젝트의 이름입니다(예: my-project).
    • IMAGE: 이미지 이름입니다(예: nginx).
    • TAG: 가져오려는 이미지 버전의 태그(예: 1.0)
    • MOUNT_PATH: 볼륨을 마운트할 포드 내부의 경로입니다.
    • PVC_NAME: 만든 PVC입니다.

스토리지 복제 구성

GDC 멀티 영역 유니버스는 재해 복구를 위한 스토리지 복제를 지원합니다. 이 전략은 동일한 리전의 두 영역 간에 데이터 복제를 제공하여 영역을 사용할 수 없게 되더라도 애플리케이션 데이터에 계속 액세스할 수 있도록 합니다.

컨테이너 애플리케이션에 대해 다음 스토리지 복제 유형 중 하나를 선택합니다.

객체 스토리지용 이중 영역 버킷 만들기

객체 스토리지 데이터는 두 영역 모두에 데이터가 저장되는 단일 버킷에 기록됩니다. 볼륨 복제와 달리 복제된 버킷은 영역 파티션 중에 쓰기 가능합니다. 객체에 쓸 때마다 다른 버전이 생성되며, 연결이 복원된 후에는 두 영역 중 최신 버전이 최종 상태가 됩니다.

  1. 인프라 운영자 (IO)가 객체 스토리지의 영역 간 복제에 필요한 BucketLocationConfig 커스텀 리소스를 만들었는지 확인합니다. 이 리소스는 루트 전역 API 서버에 배포되어야 합니다.

  2. 이중 영역 Bucket 커스텀 리소스를 만듭니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: object.global.gdc.goog/v1
    kind: Bucket
    metadata:
      name: BUCKET_NAME
      namespace: PROJECT
    spec:
      location: LOCATION_NAME
      description: Sample DZ Bucket
      storageClass: Standard
    EOF
    

    다음을 바꿉니다.

    • GLOBAL_API_SERVER: 전역 API 서버의 kubeconfig 파일입니다.
    • BUCKET_NAME: 스토리지 버킷의 이름입니다.
    • PROJECT: 버킷이 있는 프로젝트의 이름입니다.
    • LOCATION_NAME: 버킷의 객체 데이터가 상주하는 물리적 위치입니다. 이는 기존 BucketLocation 리소스의 이름에 매핑되어야 합니다. 조직의 전역 API 서버에서 사용 가능한 BucketLocation 리소스 목록을 쿼리하려면 kubectl --kubeconfig GLOBAL_API_SERVER bucketlocations를 실행합니다. BucketLocation 리소스가 없으면 IO에 문의하여 복제를 사용 설정했는지 확인합니다.

영역 간 비동기 블록 스토리지 복제 구성

복제된 블록 스토리지는 비동기식으로 복제된 볼륨 (PV)을 제공하며, 이는 기본 볼륨과 보조 볼륨 간의 블록 동등성을 유지합니다. 비동기 특성으로 인해 보조 볼륨은 과거 특정 시점의 기본 영역 상태를 반영합니다 (0이 아닌 RPO). 보조 볼륨은 복제 대상으로 남아 있는 동안 마운트할 수 없으므로 관계를 종료하고 쓰기를 사용 설정하려면 수동 개입이 필요합니다.

소스 영역 데이터를 사용할 수 없게 될 경우 장애 조치에 사용할 수 있는 복제된 데이터를 만들려면 영역 간에 스토리지 복제 관계를 구성해야 합니다. 이는 컨테이너 애플리케이션에 블록 스토리지를 사용하는 경우에 해당합니다.

시작하기 전에 인프라 운영자 (IO)가 영역 간에 블록 스토리지 복제를 허용하도록 StorageClusterPeering 및 StorageVirtualMachinePeering 커스텀 리소스를 만들고 구성했는지 확인합니다. 이 리소스는 루트 전역 API 서버에 배포되어야 합니다.

  1. VolumeReplicationRelationship 커스텀 리소스 YAML 파일을 만들고 전역 API 서버에 배포합니다.

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: storage.global.gdc.goog/v1
    kind: VolumeReplicationRelationship
    metadata:
      name: PVC_REPL_NAME
      namespace: PROJECT
    spec:
      source:
        pvc:
          clusterRef: SOURCE_PVC_CLUSTER
          pvcRef: SOURCE_PVC
        zoneRef: SOURCE_ZONE
    destination:
        pvc:
          clusterRef: DEST_PVC_CLUSTER
        zoneRef: DEST_ZONE
    EOF
    

    다음을 바꿉니다.

    • GLOBAL_API_SERVER: 전역 API 서버의 kubeconfig 파일입니다.
    • PVC_REPL_NAME: 볼륨 복제 관계의 이름입니다.
    • PROJECT: 스토리지 인프라가 있는 프로젝트입니다.
    • SOURCE_PVC_CLUSTER: PVC가 호스팅되는 Kubernetes 클러스터입니다.
    • SOURCE_PVC: 복제할 소스 영역의 PVC입니다.
    • SOURCE_ZONE: PVC가 호스팅되는 소스 영역입니다.
    • DEST_PVC_CLUSTER: PVC를 복제할 대상 Kubernetes 클러스터입니다.
    • DEST_ZONE: PVC를 복제할 대상 영역입니다.
  2. 대상 영역에 VolumeFailover 커스텀 리소스를 만듭니다. 그러면 어떤 이유로든 소스 영역을 사용할 수 없는 경우 대상 영역에 대한 복제가 중지됩니다.

    kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
    apiVersion: storage.gdc.goog/v1
    kind: VolumeFailover
    metadata:
      name: PVC_FAILOVER_NAME
      namespace: PROJECT
    spec:
      volumeReplicationRelationshipRef: PVC_REPL_NAME
    EOF
    

    다음을 바꿉니다.

    • MANAGEMENT_API_SERVER: 영역 관리 API 서버의 kubeconfig 파일입니다.
    • PVC_FAILOVER_NAME: PVC 장애 조치의 이름입니다.
    • PROJECT: 스토리지 인프라가 있는 프로젝트입니다.
    • PVC_REPL_NAME: 볼륨 복제 관계의 이름입니다.

다음 단계