환경 그룹이 누락된 가상 호스트

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

증상

apigee 네임스페이스의 리소스를 보면 Reason이 AIS_VIRTUALHOST_MISSING_ENVGROUP인 ApigeeIssue가 표시됩니다.

오류 메시지

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 이름을 설명합니다.

해결 방법

describe ApigeeIssue 명령어를 사용하여 존재해야 할 EnvironmentGroup 이름을 표시합니다.
```
kubectl -n apigee describe apigeeissues ISSUE_NAME
```
여기서 ISSUE_NAME은 문제의 이름입니다. 예를 들면 vhost-missing-eg-my-eg입니다.

이 예시에서는 my-org Apigee 조직에 my-eg 환경 그룹이 필요합니다.
다음 방법 중 하나를 사용하여 문제를 해결합니다.
1. 환경 그룹 만들기:
  1. 환경 그룹을 만듭니다.
  2. 환경을 추가합니다.
  3. 프록시를 만듭니다.
  4. 이 환경에 프록시를 배포합니다.
2. 환경 그룹 삭제:
  1. 텍스트 편집기에서 overrides.yaml를 엽니다.
  2. virtualhosts에서 삭제된 환경 그룹을 삭제합니다.
  3. overrides.yaml 파일을 저장합니다.
  4. Helm 명령어를 사용하여 overrides.yaml 파일을 다시 적용합니다.
    테스트 실행을 수행합니다.
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set envgroup=ENV_GROUP \
  -f overrides.yaml \
  --dry-run=server
```
    작업이 실패 시 롤백되도록 --atomic을 비롯하여 표시된 모든 설정을 포함해야 합니다.
    
    설치가 ENV_GROUP과 다른 ENV_GROUP_RELEASE_NAME을 사용하여 설정되었을 수도 있고 아닐 수도 있습니다. 설정에 관한 자세한 내용은 Helm을 사용하여 Apigee Hybrid 설치를 참고하세요.
    
    차트를 설치합니다.
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set envgroup=ENV_GROUP \
  -f overrides.yaml
```
    다시 시도하여 오류 메시지가 더 이상 반환되지 않는지 확인합니다.

진단 정보 수집 필요

위 안내를 따른 후에도 문제가 지속되면 다음 진단 정보를 수집한 후 Google Cloud Customer Care에 문의하세요.

Google Cloud 프로젝트 ID
Apigee Hybrid 조직의 이름
ApigeeIssue의 Spec.Details 필드