Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Tidak ada dokumentasi
Apigee Edge yang setara untuk topik ini.
Gejala
ApigeeIssue
dengan Reason
AIS_INGRESS_CERT_MISMATCH
ditampilkan saat melihat resource di namespace apigee
.
Pesan error
Setelah menjalankan kubectl -n apigee get apigeeissues
, error berikut akan ditampilkan:
NAME SEVERITY REASON DOCUMENTATION AGE ingress-cert-mismatch-my-org-my-virtualhost ERROR AIS_INGRESS_CERT_MISMATCH https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_INGRESS_CERT_MISMATCH 5h18m
Penyebab: Ketidakcocokan sertifikat Ingress
Kunci pribadi dan sertifikat yang disimpan dalam secret Kubernetes yang dirujuk oleh
ApigeeRouteConfig
tidak cocok.
Diagnosis
Jalankan perintah berikut:
kubectl -n apigee describe apigeeissue ISSUE_NAME
Dengan ISSUE_NAME adalah nama masalah. Contoh,
ingress-cert-mismatch-my-org-my-virtualhost
.
Sesuatu yang mirip dengan berikut ini akan ditampilkan:
Name: ingress-cert-mismatch-my-org-my-virtualhost Namespace: apigee Labels: ais-reason=AIS_INGRESS_CERT_MISMATCH Annotations: <none> API Version: apigee.cloud.google.com/v1alpha1 Kind: ApigeeIssue Metadata: Creation Timestamp: 2023-06-12T17:03:43Z Generation: 1 Owner References: API Version: apigee.cloud.google.com/v1alpha2 Kind: ApigeeOrganization Name: my-org UID: 7e83a52c-ce00-4bed-98be-55835ada1817 Resource Version: 3281563 UID: adc775c2-376d-4bf9-9860-500b2b2b8273 Spec: Details: Ingress cert and private key in secret "my-org-my-virtualhost" for ApigeeRouteConfig "my-org-my-virtualhost" do not match Documentation: https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_INGRESS_CERT_MISMATCH Reason: AIS_INGRESS_CERT_MISMATCH Severity: ERROR Events: <none>
Spec: Details: Ingress cert and private key in secret "my-org-my-virtualhost" for ApigeeRouteConfig "my-org-my-virtualhost" do not match
Konten Spec.Details
menjelaskan nama
ApigeeRouteConfig
yang merujuk ke secret Kubernetes yang berisi sertifikat
ingress dan kunci pribadi.
Resolusi
-
Gunakan
kubectl describe
untuk menampilkan namaApigeeRouteConfig
yang memiliki kunci dan sertifikat ingress yang tidak cocok:kubectl -n apigee describe apigeeissue ISSUE_NAME
Dengan ISSUE_NAME adalah nama masalah. Misalnya,
ingress-cert-mismatch-my-org-my-virtualhost
.Dalam contoh ini,
ApigeeRouteConfig
my-org-my-virtualhost
mereferensikanmy-org-my-virtualhost
rahasia. -
Tentukan nama
virtualhost
dariApigeeRouteConfig
.Nama
ApigeeRouteConfig
menggunakan format:<Apigee organization>-<virtualhost name>
.Dalam contoh ini,
my-org
adalah organisasi Apigee dan nama virtualhost adalahmy-virtualhost
. -
Temukan virtualhost yang sesuai di
overrides.yaml
Anda.virtualhosts: ... - name: my-virtualhost selector: app: apigee-ingressgateway sslCertPath: ./certs/vhost.pem sslKeyPath: ./certs/vhost.key ...
-
Validasi bahwa file kunci dan sertifikat yang digunakan cocok.
Dengan menggunakan
sslCertPath
dansslKeyPath
dari langkah sebelumnya, validasi kecocokan jumlah MD5 menggunakanopenssl
:openssl x509 -noout -modulus -in SSL_CERT_PATH | openssl md5
openssl rsa -noout -modulus -in SSL_KEY_PATH | openssl md5
-
Dengan SSL_CERT_PATH adalah
sslCertPath
dari langkah sebelumnya. Misalnya,./certs/vhost.pem
. -
Dengan SSL_KEY_PATH adalah
sslKeyPath
dari langkah sebelumnya. Misalnya,./certs/vhost.key
.
Output dari dua perintah di atas harus cocok:
openssl x509 -noout -modulus -in ./certs/vhost.pem | openssl md5 MD5(stdin)= 40ba189dbe9d6fbfbdde1a8ef803d2d4
openssl rsa -noout -modulus -in ./certs/vhost.key | openssl md5 MD5(stdin)= 40ba189dbe9d6fbfbdde1a8ef803d2d4
-
Dengan SSL_CERT_PATH adalah
-
Jika output dari perintah sebelumnya tidak cocok, gunakan salah satu metode berikut untuk memperbaiki masalah:
-
Perbarui
sslCertPath
dansslKeyPath
virtualhost agar mengarah ke jalur file yang benar. -
Perbaiki konten file
sslCertPath
atausslKeyPath
agar berisi sertifikat dan pasangan kunci yang cocok.
-
Perbarui
-
Terapkan perubahan pada virtualhost:
Helm
helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \ --namespace apigee \ --set envgroup=ENV_GROUP_NAME \ -f overrides.yaml
apigeectl
apigeectl apply -f overrides.yaml --settings virtualhosts
Harus mengumpulkan informasi diagnostik
Jika masalah berlanjut meskipun setelah mengikuti petunjuk di atas, kumpulkan informasi diagnostik berikut, lalu hubungi Layanan Pelanggan Google Cloud:
- ID Project Google Cloud.
- Nama organisasi Apigee Hybrid.
- Kolom
Spec.Details
dariApigeeIssue
. -
(opsional) File yang dirujuk oleh
sslCertPath
dansslKeyPath
untuk virtualhost yang terpengaruh.