가상 호스트의 환경 그룹 누락

ApigeeApigee Hybrid 문서입니다.
이 주제에 해당하는 Apigee Edge 문서가 없습니다.

증상

apigee 네임스페이스의 리소스를 보면 ReasonAIS_VIRTUALHOST_MISSING_ENVGROUPApigeeIssue가 표시됩니다.

오류 메시지

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

원인: Virtualhost에 환경 그룹 누락

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-eg 환경 그룹은 my-org Apigee 조직에 필요합니다.

  2. 다음 방법 중 하나를 사용하여 문제를 해결합니다.
    1. 환경 그룹 만들기:
      1. 환경 그룹을 만듭니다.
      2. 환경을 추가합니다.
      3. 프록시를 만듭니다.
      4. 이 환경에 프록시를 배포합니다.
    2. 환경 그룹 삭제:
      1. 텍스트 편집기에서 overrides.yaml를 엽니다.
      2. virtualhost에서 my-eg를 삭제합니다.
      3. overrides.yaml 파일을 저장합니다.
      4. overrides.yaml 파일을 다시 적용합니다.
        apigeectl apply --settings virtualhosts

진단 정보 수집 필요

위 안내를 따른 후에도 문제가 지속되면 다음 진단 정보를 수집한 후 Apigee 지원팀에 연락합니다.

  1. Google Cloud 프로젝트 ID
  2. Apigee Hybrid 조직의 이름
  3. ApigeeIssueSpec.Details 필드