Ingress 証明書の期限切れ

ここに表示されているのは、Apigee と Apigee ハイブリッドのドキュメントです。
このトピックに対応する Apigee Edge のドキュメントはありません。

症状

apigee 名前空間のリソースを表示したときに、ApigeeIssue（Reason = AIS_INGRESS_CERT_EXPIREY）が表示されます。

エラーメッセージ

kubectl -n apigee get apigeeissues を実行すると、次のようなエラーが表示されます。

NAME                                         SEVERITY   REASON                     DOCUMENTATION                                                                          AGE
ingress-cert-expired-my-org-my-virtualhost   ERROR      AIS_INGRESS_CERT_EXPIREY   https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_INGRESS_CERT_EXPIREY   5h18m

考えられる原因

原因	説明
Ingress 証明書はまもなく期限切れになる	構成された Ingress 証明書の有効期限が 14 日以内に切れます。
Ingress 証明書の有効期限が切れている	構成された Ingress 証明書の有効期限が切れています。

原因: Ingress 証明書の有効期限がもうすぐ切れる

ApigeeRouteConfig によって参照される Kubernetes シークレットに格納されている Ingress 証明書の有効期限が 14 日以内に切れます。

診断

次のコマンドを実行します。

kubectl -n apigee describe apigeeissue ISSUE_NAME

ここで ISSUE_NAME は問題の名前です。例: ingress-cert-expiring-soon-my-org-my-virtualhost

出力は次のようになります。

Name:         ingress-cert-expiring-soon-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_INGRESS_CERT_EXPIREY
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 certificate in secret "my-org-my-virtualhost" for ApigeeRouteConfig "my-org-my-virtualhost" is expiring in 5.409373245s at 2024-03-11 19:04:12 +0000 UTC
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_INGRESS_CERT_EXPIREY
  Reason:         AIS_INGRESS_CERT_EXPIREY
  Severity:       WARNING
Events:           <none>

Spec:
  Details:        Ingress certificate in secret "my-org-my-virtualhost" for ApigeeRouteConfig "my-org-my-virtualhost" is expiring in 5.409373245s at 2024-03-11 19:04:12 +0000 UTC

Spec.Details の内容は、まもなく期限切れになる Ingress 証明書を含む Kubernetes Secret を参照する ApigeeRouteConfig の名前について説明しています。

解決策

kubectl describe を使用して、まもなく期限切れになる Ingress 証明書を持つ ApigeeRouteConfig の名前を表示します。
```
kubectl -n apigee describe apigeeissue ISSUE_NAME
```
ここで ISSUE_NAME は問題の名前です。例: ingress-cert-expiring-soon-my-org-my-virtualhost。

この例では、ApigeeRouteConfig my-org-my-virtualhost が Secret my-org-my-virtualhost を参照しています。
ApigeeRouteConfig から virtualhost の名前を特定します。

ApigeeRouteConfig の名前は <Apigee organization>-<virtualhost name> の形式になっています。

この例では、Apigee 組織は my-org で、仮想ホスト名は my-virtualhost です。

overrides.yaml で、対応する仮想ホストを探します。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  sslCertPath: ./certs/vhost.pem
  sslKeyPath: ./certs/vhost.key
...

sslCertPath ファイルと sslKeyPath ファイルに記載されている証明書と鍵を更新します。

変更を仮想ホストに適用します。

helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml

原因: Ingress 証明書の期限が切れている

ApigeeRouteConfig によって参照される Kubernetes Secret に格納されている Ingress 証明書の有効期限が切れています。

診断

次のコマンドを実行します。

kubectl -n apigee describe apigeeissue ISSUE_NAME

ここで ISSUE_NAME は問題の名前です。例: ingress-cert-expired-my-org-my-virtualhost。

次のような結果が返されます。

Name:         ingress-cert-expired-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_INGRESS_CERT_EXPIREY
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 certificate in secret "my-org-my-virtualhost" for ApigeeRouteConfig "my-org-my-virtualhost" expired at: 2024-03-11 19:12:10 +0000 UTC
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_INGRESS_CERT_EXPIREY
  Reason:         AIS_INGRESS_CERT_EXPIREY
  Severity:       ERROR
Events:           <none>

Spec:
  Details:        Ingress certificate in secret "my-org-my-virtualhost" for ApigeeRouteConfig "my-org-my-virtualhost" expired at: 2024-03-11 19:12:10 +0000 UTC

Spec.Details の内容は、期限切れの Ingress 証明書を含む Kubernetes Secret を参照する ApigeeRouteConfig の名前について説明しています。

解決策

kubectl describe を使用して、期限切れの Ingress 証明書を持つ ApigeeRouteConfig の名前を表示します。
```
kubectl -n apigee describe apigeeissue ISSUE_NAME
```
ここで ISSUE_NAME は問題の名前です。例: ingress-cert-expired-my-org-my-virtualhost。

この例では、ApigeeRouteConfig my-org-my-virtualhost が Secret my-org-my-virtualhost を参照しています。
ApigeeRouteConfig から virtualhost の名前を特定します。

ApigeeRouteConfig の名前は <Apigee organization>-<virtualhost name> の形式になっています。

この例では、Apigee 組織は my-org で、仮想ホスト名は my-virtualhost です。