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:
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_NAMEResolusi
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
-
Periksa log pod
apigee-watcheruntuk 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:
-
ApigeeRouteyang 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}"}
-
-
Periksa resource
ApigeeRoutedi namespace Anda (apigeesecara default) untuk mengidentifikasi rute apa pun yang mengarah keApigeeDeploymentatau layanan yang tidak ada:kubectl get ApigeeRoute -n APIGEE_NAMESPACE kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
Resolusi
-
Hapus resource
ApigeeRouteyang tidak valid:kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
-
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
-
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 fileoverrides.yamlseperti 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
-
Periksa log pod
apigee-synchronizeruntuk mengetahui error autentikasi dan waktu tunggu koneksi:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
Cari error waktu tunggu
GoogleAuthExceptionsaat 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"
-
Periksa log pod
apigee-watcheruntuk mengetahui kegagalan konektivitas bidang kontrol:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
Cari error
control-plane connectivity test faileddengan waktu tunggu TCP ke port443:{"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
-
Periksa status pod
apigee-ingressgateway:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
Pastikan semua pod
apigee-ingressgatewayberada dalam statusRunningdengan container2/2siap. Jika pod gateway masuk tidak berjalan2/2,apigee-watchertidak dapat mengambil dump konfigurasi Envoy yang diperlukan untuk memverifikasi deployment. -
Periksa status pod
apigee-runtime:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
Jika pod
apigee-runtimeberstatusRunning, 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 errorREADINESS:VersionLoadProbeyang 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
- Memetakan host virtual ke deployment gateway masuk Apigee
- Menghapus lingkungan
- URL Google Cloud yang diizinkan untuk Hybrid
- Panduan pemecahan masalah Message Processor