Host virtual tidak memiliki grup lingkungan

Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Tidak ada dokumentasi Apigee Edge yang setara untuk topik ini.

Gejala

ApigeeIssue dengan Reason AIS_VIRTUALHOST_MISSING_ENVGROUP 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
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

Penyebab: Virtualhost tidak memiliki grup lingkungan

Salah satu virtualhosts yang ditentukan dalam overrides.yaml tidak memiliki EnvironmentGroup yang sesuai.

Diagnosis

Jalankan perintah berikut: 

kubectl -n apigee describe apigeeissue ISSUE_NAME

Dengan ISSUE_NAME adalah nama masalah. Misalnya, vhost-missing-eg-my-eg.

Sesuatu yang mirip dengan berikut ini akan ditampilkan: 

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"

Konten Spec.Details menjelaskan nama EnvironmentGroup yang diharapkan ada.

Resolusi

  1. Gunakan perintah describe ApigeeIssue untuk menampilkan nama EnvironmentGroup yang diharapkan ada: 
    kubectl -n apigee describe apigeeissues ISSUE_NAME

    Dengan ISSUE_NAME adalah nama masalah. Misalnya, vhost-missing-eg-my-eg.

    Dalam contoh ini, grup lingkungan my-eg diharapkan ada di organisasi Apigee my-org.

  2. Gunakan salah satu metode berikut untuk memperbaiki masalah:
    1. Buat grup lingkungan:
      1. Membuat grup lingkungan.
      2. Tambahkan lingkungan.
      3. Buat proxy.
      4. Deploy proxy ke lingkungan tersebut.
    2. Hapus grup lingkungan:
      1. Buka overrides.yaml di editor teks.
      2. Hapus grup lingkungan yang dihapus dari virtualhosts.
      3. Simpan file overrides.yaml.
      4. Terapkan kembali file overrides.yaml menggunakan perintah Helm:

        Uji coba:

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

        Pastikan untuk menyertakan semua setelan yang ditampilkan, termasuk --atomic sehingga tindakan akan di-roll back jika gagal.

        Penginstalan Anda mungkin telah atau belum disiapkan menggunakan ENV_GROUP_RELEASE_NAME yang berbeda dari ENV_GROUP. Untuk 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.yaml

        Coba lagi dan pastikan pesan error tidak lagi ditampilkan.

Harus mengumpulkan informasi diagnostik

Jika masalah berlanjut meskipun setelah mengikuti petunjuk di atas, kumpulkan informasi diagnostik berikut, lalu hubungi Layanan Pelanggan Google Cloud:

  1. Google Cloud Project ID.
  2. Nama organisasi Apigee Hybrid.
  3. Kolom Spec.Details dari ApigeeIssue.