28. Criar configurações zonais para a organização raiz

Tempo estimado para a conclusão: 15 minutos

Proprietário do componente operacional: RM

Perfil de habilidade: engenheiro de implantação

O recurso OrganizationZonalConfig é a fonte que controla as configurações por zona de uma organização. O recurso OrganizationZonalConfig raiz é necessário para gerenciar o ciclo de vida do cluster de administrador raiz para upgrades. Você precisa criar o recurso com IaC.

Siga estas etapas para criar o recurso raiz OrganizationZonalConfig:

1. Gere o recurso personalizado OrganizationZonalConfig raiz:

   get_capacity(){ CAPACITY="$(kubectl --kubeconfig ROOT_ADMIN_KUBECONFIG get organizations -n gpc-system root -o json | jq -r ".spec.resourceCapacities.\"$1\" | to_entries | map(\"\(.key)=\(.value)\") | join(\",\")")"; echo $([[ -z ${CAPACITY} ]] || echo "$2=${CAPACITY} "); }
   VERSION=$(kubectl --kubeconfig ROOT_ADMIN_KUBECONFIG get organization -n gpc-system root -o json | jq .spec.version)
   ZONE=$(kubectl --kubeconfig ROOT_ADMIN_KUBECONFIG get controlplane cp -n mz-system -ojsonpath='{.spec.zone}')
   gdcloud organizations zonal-configs create --name=root --zones=${ZONE?} --version=${VERSION?} $(get_capacity adminServers --admin-server) $(get_capacity storage --storage-sku)
   

   Substitua ROOT_ADMIN_KUBECONFIG pelo caminho para o arquivo kubeconfig do cluster de administrador raiz.

   Um exemplo do arquivo YAML de recurso personalizado OrganizationZonalConfig gerado é semelhante a este:

   apiVersion: resourcemanager.global.private.gdc.goog/v1alpha1
   kind: OrganizationZonalConfig
   metadata:
     namespace: gpc-system
     name: root-zone1-config
   spec:
     organizationRef:
       name: root
     zone: zone1
     version: "1.14.0-gdch.1594"
     capacities:
       adminServers:
         o1-highmem1-40-gdc-metal: 3
       storage:
         object-nearline: 10Ti
         object-standard: 10Ti
   

2. Copie o recurso personalizado OrganizationZonalConfig para o repositório de IaC.

   cp YAML_FILE_PATH IAC_REPO_PATH/iac/infrastructure/global/orgs/root/
   

   Substitua:

   • YAML_FILE_PATH: o caminho para o arquivo do recurso personalizado OrganizationZonalConfig.
   • IAC_REPO_PATH: o caminho do repositório de IAC.

3. Adicione o OrganizationZonalConfig raiz como um recurso da organização raiz.

   1. Abra o arquivo global-root-kustomization.yaml.

      vim IAC_REPO_PATH/iac/infrastructure/global/orgs/root/global-root-kustomization.yaml
      

   2. Adicione o OrganizationZonalConfig raiz como um recurso no final da lista de recursos atual:

      apiVersion: kustomize.config.k8s.io/v1beta1
      kind: Kustomization
      metadata:
        name: global-root-kustomization
      resources:
        - ... # existing resource items
        - FILE_NAME.yaml
      

4. Adicione e faça commit do arquivo YAML OrganizationZonalConfig e dos arquivos kustomize:

   git add "IAC_REPO_PATH/iac/infrastructure/global"
   git commit
   

5. Crie a solicitação de mesclagem:

   git checkout -b BRANCH_NAME
   git -c http.sslVerify=false push -o merge_request.create origin BRANCH_NAME
   

   Substitua BRANCH_NAME pelo nome escolhido para sua ramificação.

6. Aguarde a revisão e a fusão do código.

7. Use a configuração do Kubernetes do administrador para o cluster de administrador raiz e recupere a configuração do Kubernetes do administrador para a API global:

   kubectl get secrets -n global-kube-system kube-admin-test-kubeconfig -ojsonpath="{.data.value}" | base64 -d > HOME_DIRECTORY/root-global-kubeconfig
   

8. Encaminhe a porta da API global usando a configuração do administrador do Kubernetes para o cluster de administrador raiz:

   kubectl port-forward -n global-kube-system service/kube-svc 6449:6449 &> /dev/null &
   

   Essa etapa executa o comando de encaminhamento de portas em segundo plano. Se o processo parar inesperadamente, reinicie-o executando o mesmo comando.

9. Verifique se o recurso OrganizationZonalConfig está disponível no seu ambiente do GDC:

   kubectl --kubeconfig HOME_DIRECTORY/root-global-kubeconfig get organizationzonalconfig -A
   

   A saída precisa incluir a seguinte entrada, com possíveis diferenças no nome da zona:

   NAMESPACE    NAME               AGE
   gpc-system   rootzone1config    38h