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