Langkah 10: Periksa kesiapan cluster

Version 1.11 (latest)

Versi yang didukung:

• v1.12 (terbaru)                        
• v1.11                         
• v1.10                                        
• Daftar versi yang didukung

Versi yang tidak didukung:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Periksa kesiapan cluster hybrid

Sebelum menerapkan konfigurasi dan menginstal diagram hybrid helm, Anda harus memeriksa apakah cluster Kubernetes Anda sudah siap untuk penginstalan Apigee hybrid.

Untuk memeriksa kesiapan cluster, Anda akan membuat file YAML dengan definisi Tugas Kubernetes dan menerapkan file tersebut dengan perintah kubectl untuk memeriksa cluster. Anda kemudian memeriksa status tugas pengujian Kubernetes dengan perintah kubectl get jobs.

1. Pastikan kubectl disetel ke konteks yang benar menggunakan perintah berikut. Konteks saat ini harus ditetapkan ke cluster tempat Anda men-deploy Apigee Hybrid.

   kubectl config current-context

   Hasilnya akan menyertakan nama cluster tempat Anda men-deploy Apigee Hybrid. Misalnya, di GKE, nama konteks biasanya dalam bentuk gke_project-id_cluster-location_cluster-name, seperti:

   gke_my-project_us-central1_my-cluster

   Jika nama cluster nama dalam konteks tidak cocok, perintah berikut akan mendapatkan kredensial gcloud cluster dan menetapkan konteks kubectl:

   Cluster regional

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

   Cluster zona

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

2. Di direktori helm-charts, buat direktori cluster-check:

   mkdir $APIGEE_HELM_CHARTS_HOME/cluster-check

3. Dalam direktori $APIGEE_HELM_CHARTS_HOME/cluster-check, buat file bernama apigee-k8s-cluster-ready-check.yaml dengan konten berikut:

   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.11.1
             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. Terapkan apigee-k8s-cluster-ready-check.yaml dengan perintah kubectl berikut. Tindakan ini akan menjalankan pengujian:

   kubectl apply -f $APIGEE_HELM_CHARTS_HOME/cluster-check/apigee-k8s-cluster-ready-check.yaml

5. Periksa status tugas Kubernetes dengan perintah berikut:

   kubectl get jobs apigee-k8s-cluster-ready-check

   Jika cluster Anda sudah siap, output-nya akan terlihat seperti ini:

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

   Jika pengujian gagal dan cluster Anda belum siap, output-nya akan terlihat seperti ini:

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

   Cari jumlah penyelesaian:

   • 1/1 Berhasil, cluster Anda siap untuk penginstalan hybrid Apigee.
   • 0/1 Pengujian gagal. Cluster belum siap. Lanjutkan ke langkah-langkah berikut untuk memecahkan masalah cluster.

6. Jika pengujian tidak berhasil, periksa log dengan perintah berikut.
   1. Dapatkan nama pod untuk tugas pra-pemeriksaan cluster:

      kubectl get pods | grep apigee-k8s-cluster-ready-check

   2. Mendapatkan log Kubernetes untuk pod:

      kubectl logs pod_name

      Dengan pod_name adalah nama pod apigee-k8s-cluster-siap-check.

7. Lakukan pembersihan sebelum melanjutkan ke langkah berikutnya. Hapus tugas Kubernetes dengan perintah berikut:

   kubectl delete -f $APIGEE_HELM_CHARTS_HOME/cluster-check/apigee-k8s-cluster-ready-check.yaml

Tips: Di beberapa platform, seperti Anthos di Bare Metal atau GKE lokal, Anda mungkin melihat error resolusi DNS. Jika resolusi DNS tidak berfungsi, coba solusi ini.

Tambahkan entri host statis dalam file /etc/hosts dari setiap node pekerja cassandra yang mirip dengan yang berikut ini:

echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

atau

"\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

Anda kini telah memastikan cluster hybrid Apigee sudah siap. Selanjutnya, mari kita instal diagram untuk menerapkan konfigurasi Anda ke runtime hybrid.

Pemecahan masalah

1. Pemeriksaan DNS Cassandra: Jika Anda menemukan log error yang mirip dengan DNS resolution was successful but IP doesn't match POD IP, could not resolve hostname, atau error determining hostname, berarti DNS cluster Anda tidak dikonfigurasi dengan benar untuk penyiapan multi-region. Anda dapat mengabaikan error ini jika tidak ingin menyiapkan multi-region.
2. Kontrol pemeriksaan konektivitas Plane: Jika menemukan log error yang mirip dengan error creating TCP connection with host, Anda harus me-resolve konektivitas dari cluster ke apigee.googleapis.com dan menjalankan kembali tugas tersebut.

Langkah berikutnya

1 2 3 4 5 6 7812