Passaggio 10: controlla l'idoneità del cluster

Verifica l'idoneità del cluster ibrido

Prima di applicare la configurazione e installare i grafici Helm ibridi, devi verificare che il tuo cluster Kubernetes sia pronto per l'installazione ibrida di Apigee.

Per verificare l'idoneità del tuo cluster, dovrai creare un file YAML con una definizione di job Kubernetes e applicare quel file con i comandi kubectl per controllare il cluster. Puoi quindi controllare lo stato del job di test Kubernetes con un comando kubectl get jobs.

  1. Verifica che kubectl sia impostato sul contesto corretto utilizzando il seguente comando. Il contesto attuale deve essere impostato sul cluster su cui stai eseguendo il deployment di Apigee hybrid.
    kubectl config current-context

    Il risultato dovrebbe includere il nome del cluster in cui stai eseguendo il deployment di Apigee hybrid. Ad esempio, su GKE, il nome contesto è solitamente nel formato gke_project-id_cluster-location_cluster-name, ad esempio:

    gke_my-project_us-central1_my-cluster

    Se il nome del cluster dei nomi nel contesto non corrisponde, il comando seguente otterrà le credenziali gcloud del cluster e imposterà il contesto kubectl:

    Cluster a livello di regione

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

    Cluster di zona

    gcloud container clusters get-credentials $CLUSTER_NAME \
    --zone $CLUSTER_LOCATION \
    --project $PROJECT_ID
  2. Nella directory helm-charts, crea una directory cluster-check:
    mkdir $APIGEE_HELM_CHARTS_HOME/cluster-check
  3. Nella directory $APIGEE_HELM_CHARTS_HOME/cluster-check, crea un file denominato apigee-k8s-cluster-ready-check.yaml con il seguente contenuto:
    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.12.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. Applica apigee-k8s-cluster-ready-check.yaml con il seguente comando kubectl. Verrà eseguito il test:
    kubectl apply -f $APIGEE_HELM_CHARTS_HOME/cluster-check/apigee-k8s-cluster-ready-check.yaml
  5. Controlla lo stato del job Kubernetes con il comando seguente:
    kubectl get jobs apigee-k8s-cluster-ready-check

    Se il cluster è pronto, l'output dovrebbe essere simile al seguente:

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

    Se il test non è riuscito e il cluster non è pronto, l'output sarà simile al seguente:

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

    Cerca il numero di completamenti:

    • 1/1 Operazione riuscita, il cluster è pronto per l'installazione ibrida di Apigee.
    • 0/1 Il test non è riuscito. Il cluster non è pronto. Procedi con i passaggi seguenti per risolvere i problemi del cluster.

  6. Se il test non è riuscito, controlla i log con i comandi seguenti.
    1. Recupera il nome del pod per il job di controllo preliminare del cluster:
      kubectl get pods | grep apigee-k8s-cluster-ready-check
    2. Recupera i log di Kubernetes per il pod:
      kubectl logs pod_name

      Dove pod_name è il nome del pod apigee-k8s-cluster-ready-check.

  7. Esegui la pulizia prima di andare al passaggio successivo. Elimina il job Kubernetes con il comando seguente:
    kubectl delete -f $APIGEE_HELM_CHARTS_HOME/cluster-check/apigee-k8s-cluster-ready-check.yaml

Ora hai verificato che il cluster ibrido Apigee sia pronto. Quindi, installiamo i grafici per applicare la configurazione al runtime ibrido.

Risoluzione dei problemi

  1. Controllo DNS di Cassandra: se trovi log degli errori simili a DNS resolution was successful but IP doesn't match POD IP, could not resolve hostname o error determining hostname, significa che il DNS del tuo cluster non è configurato correttamente per una configurazione multiregionale. Puoi ignorare questo errore se non intendi configurare più regioni.
  2. Controllo della connettività del piano di controllo: se trovi log di errori simili a error creating TCP connection with host, devi risolvere la connettività dal cluster ad apigee.googleapis.com ed eseguire nuovamente il job.

Passaggio successivo

1 2 3 4 5 6