仮想ホストに環境グループが存在しない

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

注: このドキュメントは、Apigee ハイブリッド ユーザーを対象としています。

症状

apigee 名前空間のリソースを表示すると、ApigeeIssue（Reason AIS_VIRTUALHOST_MISSING_ENVGROUP）が表示されます。

エラー メッセージ

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

NAME                     SEVERITY   REASON                             DOCUMENTATION                                                                                  AGE
vhost-missing-eg-my-eg   ERROR      AIS_VIRTUALHOST_MISSING_ENVGROUP   https://cloud.google.com/apigee/docs/api-platform/troubleshoot/playbooks/vh-missing-env-group   5h18m

原因: 仮想ホストに環境グループがない

overrides.yaml で定義された virtualhosts のいずれかに、対応する EnvironmentGroup がありません。

診断

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

kubectl -n apigee describe apigeeissue ISSUE_NAME

ここで ISSUE_NAME は問題の名前です。例: vhost-missing-eg-my-eg。

次のようなバージョン名が返されます。

Name:         vhost-missing-eg-my-eg
Namespace:    apigee
Labels:       ais-reason=AIS_VIRTUALHOST_MISSING_ENVGROUP
Annotations:  <none>
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2023-04-05T14:29:38Z
  Generation:          1
  Managed Fields:
    API Version:  apigee.cloud.google.com/v1alpha1
    Fields Type:  FieldsV1
    fieldsV1:
      f:spec:
        .:
        f:details:
        f:documentation:
        f:reason:
        f:severity:
    Manager:         apigeewatcher
    Operation:       Update
    Time:            2023-04-05T14:29:38Z
  Resource Version:  28195
  UID:               f7b62eb3-3f84-4a37-9ba8-9a0e1e9c3454
Spec:
  Details:        Expected EnvironmentGroup "my-eg" in ApigeeOrganization "my-org" for ApigeeRouteConfig "my-org-my-eg"
  Documentation:  https://cloud.google.com/apigee/docs/api-platform/troubleshoot/playbooks/vh-missing-env-group
  Reason:         AIS_VIRTUALHOST_MISSING_ENVGROUP
  Severity:       ERROR
Events:           <none>

Spec:
  Details:        Expected EnvironmentGroup "my-eg" in ApigeeOrganization "my-org" for ApigeeRouteConfig "my-org-my-eg"

Spec.Details の内容には、存在するはずの EnvironmentGroup の名前が記述されています。

解決策

1. describe ApigeeIssue コマンドを使用して、存在するはずの EnvironmentGroup の名前を表示します。

   kubectl -n apigee describe apigeeissues ISSUE_NAME

   ここで ISSUE_NAME は問題の名前です。例: vhost-missing-eg-my-eg。

   この例では、my-org Apigee 組織に環境グループ my-eg が存在するはずだとします。

2. 次のいずれかの方法で問題を修正します。
   1. 環境グループを作成する:
      1. 環境グループを作成します。
      2. 環境を追加します。
      3. プロキシを作成します。
      4. その環境にプロキシをデプロイします。
   2. 環境グループを削除する:
      1. テキスト エディタで overrides.yaml を開きます。
      2. virtualhost から my-eg を削除します。
      3. overrides.yaml ファイルを保存します。
      4. overrides.yaml ファイルを再適用します。

         apigeectl apply --settings virtualhosts

診断情報の収集が必要な場合

上記の手順でも問題が解決しない場合は、次の診断情報を収集して Google Cloud カスタマーケアに連絡してください。

1. Google Cloud プロジェクト ID。
2. Apigee ハイブリッド組織の名前。
3. ApigeeIssue の Spec.Details フィールド。