21. 다중 영역 초기화

예상 소요 시간: 5분

작동 가능 구성요소 소유자: MZ

기술 프로필: 배포 엔지니어

이 페이지에서는 Google Distributed Cloud (GDC) 에어 갭 유니버스에서 새 영역을 초기화하는 방법을 설명합니다. 계속하기 전에 해당 지역이 모든 요구사항을 충족할 수 있는지 확인하세요.

21.1. 전역 API 네임스페이스 만들기

GDC 멀티 영역 기능은 여러 영역에 걸쳐 있는 etcd 클러스터로 지원되는 Kubernetes API 서버인 전역 API를 통해 사용 설정됩니다. 이 네임스페이스에는 이 영역에서 전역 API를 사용 설정하는 데 필요한 모든 리소스가 포함됩니다.

네임스페이스를 만드세요.

export KUBECONFIG=/root/release/root-admin/root-admin-kubeconfig
kubectl create namespace global-kube-system

다음 출력은 작업이 성공했음을 나타냅니다.

namespace/global-kube-system created

21.2. 유니버스 첫 번째 영역에서 멀티 영역 부트스트랩

이 안내는 유니버스의 첫 번째 시간대에만 적용됩니다. 유니버스의 추가 영역에서 사용되는 경우 해당 영역을 재부트스트랩해야 할 수 있습니다.

다중 영역 부트스트랩에서 조인 영역 추가를 비롯한 다중 영역의 나머지 부트스트랩 단계를 완료합니다.

21.2.1. 부트스트랩 리소스 만들기

루트 관리자 클러스터의 관리자 Kubernetes 구성을 사용합니다. Bootstrap 리소스를 만듭니다.

cat <<EOF | kubectl apply -f -
apiVersion: kubeapi.mz.private.gdc.goog/v1alpha1
kind: Bootstrap
metadata:
  name: kube
  namespace: global-kube-system
spec:
  clusterType: root-admin
EOF

21.2.2. 글로벌 API가 정상인지 확인

전역 API 부트스트랩 프로세스가 완료되면 상태 확인을 실행하여 API가 정상인지 확인합니다.

  1. 루트 관리자 클러스터의 API 서버에서 영역 이름을 가져옵니다.

    export ZONE_NAME=$(kubectl get controlplane -n mz-system cp -o jsonpath='{.spec.zone}')

  2. 전역 API의 마지막 하트비트 타임스탬프를 확인합니다.

    kubectl get globalapizone -n mz-system ${ZONE_NAME} -o yaml

    하트비트 타임스탬프는 status.lastHeartbeat에 채워집니다. 타임스탬프는 30초마다 업데이트됩니다. 정상적인 전역 API의 마지막 하트비트 타임스탬프는 30초 이내입니다.