Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta
é a documentação da Apigee e da Apigee híbrida.
Não há documentação equivalente do
Apigee Edge para esse tópico.
Sintoma
Um ApigeeIssue com ReasonAIS_VIRTUALHOST_MISSING_ENVGROUP é mostrado ao visualizar recursos no namespace apigee.
Mensagens de erro
Depois de executar kubectl -n apigee get apigeeissues, o seguinte erro é exibido:
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
Causa: grupo de ambiente ausente no host virtual
Um dos virtualhosts definidos no overrides.yaml está sem o EnvironmentGroup correspondente.
Diagnóstico
Execute este comando:
kubectl -n apigee describe apigeeissue ISSUE_NAME
Em que ISSUE_NAME é o nome do problema. Por exemplo, vhost-missing-eg-my-eg.
Se o problema persistir mesmo depois de seguir as instruções acima, reúna
as seguintes informações de diagnóstico e entre em contato com o Suporte do Google Cloud:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eThis documentation specifically addresses \u003ccode\u003eApigee hybrid\u003c/code\u003e and does not have an equivalent for \u003ccode\u003eApigee Edge\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe error \u003ccode\u003eAIS_VIRTUALHOST_MISSING_ENVGROUP\u003c/code\u003e indicates that a defined \u003ccode\u003evirtualhost\u003c/code\u003e in \u003ccode\u003eoverrides.yaml\u003c/code\u003e lacks a corresponding \u003ccode\u003eEnvironmentGroup\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo resolve this issue, use the \u003ccode\u003ekubectl -n apigee describe apigeeissues ISSUE_NAME\u003c/code\u003e command to identify the missing \u003ccode\u003eEnvironmentGroup\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe problem can be corrected by either creating the missing \u003ccode\u003eEnvironmentGroup\u003c/code\u003e, or deleting the reference to the missing \u003ccode\u003eEnvironmentGroup\u003c/code\u003e from \u003ccode\u003eoverrides.yaml\u003c/code\u003e and reapplying the file via Helm.\u003c/p\u003e\n"],["\u003cp\u003eIf the problem continues after implementing the provided resolutions, you must gather specific diagnostic information, like the \u003ccode\u003eSpec.Details\u003c/code\u003e field of the \u003ccode\u003eApigeeIssue\u003c/code\u003e along with the Google Cloud project ID and the name of the Apigee hybrid organization, and contact Google Cloud Customer Care for further support.\u003c/p\u003e\n"]]],[],null,["# Virtual host missing environment group\n\n*You're viewing **Apigee** and **Apigee hybrid** documentation.\nThere is no equivalent\n[Apigee Edge](https://docs.apigee.com/api-platform/get-started/get-started) documentation for this topic.*\n| **Note:** This document is applicable for Apigee hybrid users only.\n\nSymptom\n-------\n\n\nAn `ApigeeIssue` with `Reason`\n`AIS_VIRTUALHOST_MISSING_ENVGROUP` is shown when viewing resources\nin the `apigee` namespace.\n\nError messages\n--------------\n\n\nAfter running `kubectl -n apigee get apigeeissues`, the following\nerror is displayed: \n\n```scdoc\nNAME SEVERITY REASON DOCUMENTATION AGE\nvhost-missing-eg-my-eg ERROR AIS_VIRTUALHOST_MISSING_ENVGROUP https://cloud.google.com/apigee/docs/api-platform/troubleshoot/playbooks/vh-missing-env-group 5h18m\n```\n\nCause: Virtualhost missing environment group\n--------------------------------------------\n\n\nOne of the `virtualhosts` defined in `overrides.yaml`\nis missing its corresponding `EnvironmentGroup`.\n\n### Diagnosis\n\n\nRun the following command: \n\n```\nkubectl -n apigee describe apigeeissue ISSUE_NAME\n```\n\n\nWhere \u003cvar translate=\"no\"\u003eISSUE_NAME\u003c/var\u003e is the name of the issue. For example,\n`vhost-missing-eg-my-eg`.\n\n\nSomething similar to the following is returned: \n\n```vb.net\nName: vhost-missing-eg-my-eg\nNamespace: apigee\nLabels: ais-reason=AIS_VIRTUALHOST_MISSING_ENVGROUP\nAnnotations: \u003cnone\u003e\nAPI Version: apigee.cloud.google.com/v1alpha1\nKind: ApigeeIssue\nMetadata:\n Creation Timestamp: 2023-04-05T14:29:38Z\n Generation: 1\n Managed Fields:\n API Version: apigee.cloud.google.com/v1alpha1\n Fields Type: FieldsV1\n fieldsV1:\n f:spec:\n .:\n f:details:\n f:documentation:\n f:reason:\n f:severity:\n Manager: apigeewatcher\n Operation: Update\n Time: 2023-04-05T14:29:38Z\n Resource Version: 28195\n UID: f7b62eb3-3f84-4a37-9ba8-9a0e1e9c3454\nSpec:\n Details: Expected EnvironmentGroup \"my-eg\" in ApigeeOrganization \"my-org\" for ApigeeRouteConfig \"my-org-my-eg\"\n Documentation: https://cloud.google.com/apigee/docs/api-platform/troubleshoot/playbooks/vh-missing-env-group\n Reason: AIS_VIRTUALHOST_MISSING_ENVGROUP\n Severity: ERROR\nEvents: \u003cnone\u003e\n``` \n\n```actionscript-3\nSpec:\n Details: Expected EnvironmentGroup \"my-eg\" in ApigeeOrganization \"my-org\" for ApigeeRouteConfig \"my-org-my-eg\"\n```\n\n\nThe contents of `Spec.Details` explains the name of the\n`EnvironmentGroup` that is expected to exist.\n\n### Resolution\n\n1. Use the `describe ApigeeIssue` command to display the name of the `EnvironmentGroup` which is expected to exist: \n\n ```\n kubectl -n apigee describe apigeeissues ISSUE_NAME\n ```\n\n\n Where \u003cvar translate=\"no\"\u003eISSUE_NAME\u003c/var\u003e is the name of the issue. For example,\n `vhost-missing-eg-my-eg`.\n\n\n In this example, the environment group `my-eg` is expected in\n the `my-org` Apigee organization.\n2. Use one of the following methods to correct the problem:\n 1. Create the environment group:\n 1. [Create an environment group](/apigee/docs/api-platform/fundamentals/environmentgroups-working-with#groups).\n 2. [Add an environment](/apigee/docs/api-platform/fundamentals/environmentgroups-working-with#adding).\n 3. [Create a proxy](/apigee/docs/api-platform/get-started/create-proxy).\n 4. [Deploy a proxy](/apigee/docs/api-platform/get-started/deploy-proxy) to that environment.\n 2. Delete the environment group:\n 1. Open `overrides.yaml` in a text editor.\n 2. Delete the removed environment group from the `virtualhosts`.\n 3. Save the `overrides.yaml` file.\n 4. Reapply the `overrides.yaml` file using the [Helm command](/apigee/docs/hybrid/latest/helm-reference):\n\n Dry run: \n\n ```\n helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \\\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n --set envgroup=ENV_GROUP \\\n -f overrides.yaml \\\n --dry-run=server\n ```\n\n Make sure to include all of the settings shown, including `--atomic`\n so that the action rolls back on failure.\n\n Your installation may or may not have been set up using an\n \u003cvar translate=\"no\"\u003eENV_GROUP_RELEASE_NAME\u003c/var\u003e that differs from \u003cvar translate=\"no\"\u003eENV_GROUP\u003c/var\u003e.\n For information on the settings, see\n [Install Apigee hybrid using Helm](/apigee/docs/hybrid/latest/install-helm-charts).\n\n Install the chart: \n\n ```\n helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \\\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n --set envgroup=ENV_GROUP \\\n -f overrides.yaml\n ```\n\n Retry and verify that the [error message](#error-messages) is no longer\n returned.\n\nMust gather diagnostic information\n----------------------------------\n\n\nIf the problem persists even after following the above instructions, gather\nthe following diagnostic information and then contact [Google Cloud Customer Care](https://cloud.google.com/support-hub/):\n\n1. The Google Cloud Project ID.\n2. The name of the Apigee hybrid organization.\n3. The `Spec.Details` field of the `ApigeeIssue`."]]
