Etapa 8: Verificar a prontidão do cluster

Verificar a prontidão do cluster híbrido

Antes de aplicar a configuração e instalar o ambiente de execução híbrido, é necessário verificar se o cluster do Kubernetes está pronto para a instalação da Apigee híbrida.

Para verificar a prontidão do cluster, crie um arquivo YAML com uma definição de job do Kubernetes e aplique-o com comandos kubectl para verificar o cluster. Em seguida, verifique o status do job de teste do Kubernetes com um comando kubectl get jobs.

  1. Verifique se kubectl está definido para o contexto correto usando o seguinte comando. O contexto atual será definido como o cluster ao qual você está implantando a Apigee híbrida.
    kubectl config current-context

    O resultado precisa incluir o nome do cluster em que você está implantando a Apigee híbrida. Por exemplo, no GKE, o nome do contexto geralmente está no formato gke_project-id_cluster-location_cluster-name, como em:

    gke_my-project_us-central1_my-cluster

    Se o nome do cluster não for correspondente, o comando a seguir receberá as credenciais da gcloud do cluster e definirá o contexto kubectl:

    Clusters regionais

    gcloud container clusters get-credentials $CLUSTER_NAME \
    --region $CLUSTER_LOCATION \
    --project $PROJECT_ID

    Clusters zonais

    gcloud container clusters get-credentials $CLUSTER_NAME \
    --zone $CLUSTER_LOCATION \
    --project $PROJECT_ID
  2. No diretório de arquivos híbridos, crie um diretório cluster-check:
    mkdir $HYBRID_FILES/cluster-check
  3. No diretório $HYBRID_FILES/cluster-check, crie um arquivo chamado apigee-k8s-cluster-ready-check.yaml com o seguinte conteúdo:
    apiVersion: v1
    kind: ServiceAccount
    metadata:
      name: apigee-k8s-cluster-ready-check
    ---
    apiVersion: batch/v1
    kind: Job
    metadata:
      name: apigee-k8s-cluster-ready-check
    spec:
      template:
        spec:
          hostNetwork: true
          serviceAccountName: apigee-k8s-cluster-ready-check
          containers:
            - name: manager
              image: gcr.io/apigee-release/hybrid/apigee-operators:1.10.0
              command:
                - /manager
              args:
              - --k8s-cluster-ready-check
              env:
              - name: POD_IP
                valueFrom:
                  fieldRef:
                    fieldPath: status.podIP
              securityContext:
                runAsGroup: 998
                runAsNonRoot: true
                runAsUser: 999
          restartPolicy: Never
      backoffLimit: 1
    
  4. Aplique apigee-k8s-cluster-ready-check.yaml com o comando kubectl a seguir. Isso executará o teste:
    kubectl apply -f $HYBRID_FILES/cluster-check/apigee-k8s-cluster-ready-check.yaml
  5. Verifique o status do job do Kubernetes com o seguinte comando:
    kubectl get jobs apigee-k8s-cluster-ready-check

    Se o cluster estiver pronto, a saída será semelhante a esta:

    NAME                            COMPLETIONS   DURATION   AGE
    apigee-k8s-cluster-ready-check  1/1           8s         1h23m

    Se o teste falhar e o cluster não estiver pronto, a saída será semelhante a esta:

    NAME                            COMPLETIONS   DURATION   AGE
    apigee-k8s-cluster-ready-check  0/1           44s         44s

    Procure o número de conclusões:

    • 1/1 Seu cluster está pronto para a instalação da Apigee híbrida.
    • 0/1 O teste falhou. O cluster não está pronto. Prossiga para as etapas a seguir a fim de solucionar os problemas do cluster.

  6. Se o teste não foi bem-sucedido, verifique os registros com os comandos a seguir.
    1. Confira o nome do pod para o job de pré-verificação do cluster:
      kubectl get pods | grep apigee-k8s-cluster-ready-check
    2. Verifique os registros do Kubernetes para o pod:
      kubectl logs pod_name

      Em que pod_name é o nome do pod apigee-k8s-cluster-ready-check.

  7. Faça uma limpeza antes de prosseguir para a próxima etapa. Exclua o job do Kubernetes com o seguinte comando:
    kubectl delete -f $HYBRID_FILES/cluster-check/apigee-k8s-cluster-ready-check.yaml

Você acabou de verificar se o cluster da Apigee híbrida está pronto. Em seguida, aplique a configuração ao ambiente de execução híbrido e conclua a instalação da Apigee híbrida.

Solução de problemas

  1. Verificação de DNS do Cassandra: se você encontrar registros de erros semelhantes a DNS resolution was successful but IP doesn't match POD IP, could not resolve hostname ou error determining hostname, isso significa que o DNS do cluster não está configurado corretamente para uma configuração multirregional. Ignore esse erro se você não pretende usar a configuração multirregional.
  2. Verificação de conectividade do plano de controle: se você encontrar registros de erro semelhantes a error creating TCP connection with host, será necessário resolver a conectividade do cluster com apigee.googleapis.com e executar o job novamente.
1 2 3 4 5 6 7 8 (PRÓXIMA) Etapa 9: instalar o ambiente de execução híbrido 10 11