Instance tidak melaporkan status untuk grup lingkungan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Gejala

Deployment proxy API atau alur bersama gagal dengan error Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME di UI Apigee hybrid.

Pesan Error

Error The Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME ditampilkan di menu Proxy API di tab Overview saat mengarahkan kursor ke tanda seru merah yang muncul di kolom Status di bagian Deployments:

instance-not-reporting-status

Kemungkinan Penyebab

Penyebab Deskripsi
Pemilih app: apigee-ingressgateway tidak ada Saat menggunakan ingress Apigee, file overrides.yaml harus memiliki pemilih app: apigee-ingressgateway di bagian virtualhosts.
ApigeeRoute yang sudah tidak berlaku atau lingkungan yang hanya dihapus di bidang kontrol Lingkungan atau deployment dihapus dari bidang kontrol atau cluster tanpa menyelesaikan alur kerja Full Delete, sehingga menyisakan resource ApigeeRoute atau lingkungan yang tidak berlaku di cluster.
Egress jaringan diblokir ke Google API Node worker cluster tidak dapat membuat koneksi keluar ke autentikasi Google dan API bidang kontrol Apigee di *.googleapis.com:443.
Pod runtime atau gateway ingress belum siap Pod apigee-ingressgateway tidak berjalan dengan semua container siap (2/2), atau pod apigee-runtime tidak siap (0/1) karena pemeriksaan READINESS:VersionLoadProbe gagal.

Penyebab: Pemilih app: apigee-ingressgateway tidak ada

Saat menggunakan gateway masuk Apigee, file overrides.yaml menyertakan bagian untuk konfigurasi virtualhosts yang mengharuskan pemilih app: apigee-ingressgateway dikonfigurasi.

Diagnosis

Pertama, pastikan Anda menggunakan gateway ingress Apigee yang tersedia dengan Hybrid versi 1.8 dan yang lebih baru (konfigurasi berikut tidak berfungsi untuk ASM Istio yang dikelola pelanggan). Dalam file overrides.yaml yang menyertakan grup lingkungan yang disebutkan dalam error, temukan bagian virtualhosts dan periksa apakah pemilih berikut tidak ada:

  selector:
    app: apigee-ingressgateway
    ingress_name: INGRESS_NAME

Resolusi

Edit file overrides.yaml sehingga bagian virtualhosts[].selector terlihat mirip dengan contoh berikut:

    virtualhosts:
    - name: my-environment-group
      sslCertPath: my-cert.crt
      sslKeyPath: my-cert.key
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
  

Setelah mengedit file overrides.yaml, terapkan konfigurasi baru menggunakan Helm:

Uji coba:

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
--namespace APIGEE_NAMESPACE \
--atomic \
--set envgroup=ENV_GROUP \
-f OVERRIDES_FILE \
--dry-run=server

Pastikan untuk menyertakan semua setelan yang ditampilkan, termasuk --atomic agar tindakan di-roll back jika terjadi kegagalan.

Penginstalan Anda mungkin telah atau belum disiapkan menggunakan ENV_GROUP_RELEASE_NAME yang berbeda dari ENV_GROUP. Untuk mengetahui informasi tentang setelan, lihat Menginstal Apigee hybrid menggunakan Helm.

Instal diagram:

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
--namespace APIGEE_NAMESPACE \
--atomic \
--set envgroup=ENV_GROUP \
-f OVERRIDES_FILE

Penyebab: ApigeeRoute yang sudah tidak berlaku atau lingkungan yang hanya dihapus di bidang kontrol

Jika deployment lingkungan atau runtime dihapus dari bidang kontrol atau cluster tanpa menyelesaikan alur kerja Full Delete, resource ApigeeRoute atau lingkungan yang tidak berlaku dapat tetap berada di cluster. Saat apigee-watcher mencoba merekonsiliasi perutean untuk grup lingkungan dan menemukan layanan, deployment, atau lingkungan bidang kontrol Kubernetes yang tidak ada, tidak dapat menyelesaikan update rute atau melaporkan status deployment ke bidang kontrol.

Diagnosis

  1. Periksa log pod apigee-watcher untuk menemukan error layanan atau lingkungan yang tidak ada:

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
    

    Cari entri log yang mirip dengan berikut ini:

    • ApigeeRoute yang sudah tidak berlaku merujuk ke layanan atau deployment runtime yang dihapus:

      {"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingressstatus","error":"INTERNAL: NOT_FOUND: failed to get service: services \"apigee-runtime-ORG_ENV_HASH\" not found"}
    • Lingkungan dihapus di bidang kontrol sementara resource runtime-nya tetap berada di cluster:

      {"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingress","error":"INVALID_ARGUMENT: err fetching environment data: NOT_FOUND: {\n  \"error\": {\n    \"code\": 404,\n    \"message\": \"generic::not_found: resource organizations/ORG_NAME/environments/ENV_NAME not found\",\n    \"status\": \"NOT_FOUND\"\n  }\n}"}
  2. Periksa resource ApigeeRoute di namespace Anda (apigee secara default) untuk mengidentifikasi rute apa pun yang mengarah ke ApigeeDeployment atau layanan yang tidak ada:

    kubectl get ApigeeRoute -n APIGEE_NAMESPACE
    kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    

Resolusi

  1. Hapus resource ApigeeRoute yang tidak valid:

    kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    
  2. Buat ulang konfigurasi rute dengan menerapkan kembali diagram Helm apigee-virtualhost:

    helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
      -n APIGEE_NAMESPACE \
      --atomic \
      --set envgroup=ENV_GROUP \
      -f OVERRIDES_FILE
    
  3. Jika lingkungan hanya dihapus di bidang kontrol (menyebabkan err fetching environment data: NOT_FOUND), uninstal rilis Helm lingkungan (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) dan hapus lingkungan dari file overrides.yaml seperti yang dijelaskan dalam Menghapus lingkungan.

Penyebab: Egress jaringan ke Google API diblokir

Komponen apigee-synchronizer melakukan polling pada bidang kontrol Apigee untuk mendownload kontrak konfigurasi runtime untuk pod apigee-runtime, dan apigee-watcher terhubung ke bidang kontrol untuk mengambil konfigurasi ingress dan melaporkan status deployment. Jika traffic keluar dari worker node cluster ke Google API diblokir, komponen ini tidak dapat melakukan autentikasi atau berkomunikasi dengan bidang kontrol.

Diagnosis

  1. Periksa log pod apigee-synchronizer untuk mengetahui error autentikasi dan waktu tunggu koneksi:

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
    

    Cari error waktu tunggu GoogleAuthException saat mengambil token akses:

    "logger":"CONTRACT-REPLICATION","exceptionStackTrace":"com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: SERVICE_ACCOUNT_EMAIL"
  2. Periksa log pod apigee-watcher untuk mengetahui kegagalan konektivitas bidang kontrol:

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
    

    Cari error control-plane connectivity test failed dengan waktu tunggu TCP ke port 443:

    {"level":"error","caller":"issuescan/cp_connectivity_scanner.go:68","msg":"control-plane connectivity test failed","organization":"ORG_NAME","error":"Get \"https://apigee.googleapis.com/v1/organizations/ORG_NAME\": oauth2: cannot fetch token: Post \"https://oauth2.googleapis.com/token\": dial tcp IP_ADDRESS:443: i/o timeout"}

Resolusi

Pastikan aturan firewall keluar, gateway NAT, ACL jaringan, dan konfigurasi proxy penerusan HTTP atau HTTPS Anda mengizinkan worker node cluster menjangkau *.googleapis.com:443 (termasuk apigee.googleapis.com dan oauth2.googleapis.com). Untuk mengetahui daftar lengkap domain yang diperlukan dan langkah-langkah pemecahan masalah konektivitas, lihat URL Google Cloud yang diizinkan untuk Hybrid dan Tidak ada konektivitas jaringan antara bidang runtime dan bidang kontrol.

Penyebab: Gateway ingress atau pod runtime belum siap

Untuk memverifikasi dan melaporkan status deployment, apigee-watcher mengambil dump konfigurasi perutean dari pod apigee-ingressgateway dan memeriksa kesiapan pod apigee-runtime. Jika pod gateway masuk tidak berjalan dan siap, atau jika pod runtime belum memuat kontrak lingkungan, pelaporan status deployment akan gagal.

Diagnosis

  1. Periksa status pod apigee-ingressgateway:

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
    

    Pastikan semua pod apigee-ingressgateway berada dalam status Running dengan container 2/2 siap. Jika pod gateway masuk tidak berjalan 2/2, apigee-watcher tidak dapat mengambil dump konfigurasi Envoy yang diperlukan untuk memverifikasi deployment.

  2. Periksa status pod apigee-runtime:

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
    

    Jika pod apigee-runtime berstatus Running, tetapi belum siap (0/1), periksa peristiwa dan log pod:

    kubectl describe pod RUNTIME_POD_NAME -n APIGEE_NAMESPACE
    kubectl logs RUNTIME_POD_NAME -n APIGEE_NAMESPACE
    

    Cari kegagalan pemeriksaan kesiapan (Readiness probe failed: HTTP probe failed with statuscode: 500) dan error READINESS:VersionLoadProbe yang menunjukkan bahwa kontrak runtime tidak dimuat:

    {"level":"SEVERE","className":"com.apigee.probe.ProbeServiceImpl","severity":"SEVERE","message":"probe \"READINESS:VersionLoadProbe\" execution failed due to Version not loaded by Message Processor","logger":"ProbeServiceImpl"}

Resolusi

Selesaikan kegagalan startup pod, batasan resource cluster (batas CPU atau memori), atau masalah download kontrak sinkronisasi sehingga pod apigee-ingressgateway mencapai 2/2 siap dan pod apigee-runtime mencapai 1/1 siap sebelum men-deploy ulang. Untuk langkah-langkah tambahan dalam memecahkan masalah kegagalan kesiapan apigee-runtime, lihat Panduan pemecahan masalah Message Processor.

Referensi