Stay organized with collections
Save and categorize content based on your preferences.
You're viewing Apigee and Apigee hybrid documentation.
There is no equivalent
Apigee Edge documentation for this topic.
Symptom
An ApigeeIssue with ReasonAIS_VIRTUALHOST_MISSING_ENVGROUP is shown when viewing resources
in the apigee namespace.
Error messages
After running kubectl -n apigee get apigeeissues, the following
error is displayed:
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
Cause: Virtualhost missing environment group
One of the virtualhosts defined in overrides.yaml
is missing its corresponding EnvironmentGroup.
Diagnosis
Run the following command:
kubectl -n apigee describe apigeeissue ISSUE_NAME
Where ISSUE_NAME is the name of the issue. For example,
vhost-missing-eg-my-eg.
Make sure to include all of the settings shown, including --atomic
so that the action rolls back on failure.
Your installation may or may not have been set up using an
ENV_GROUP_RELEASE_NAME that differs from ENV_GROUP.
For information on the settings, see
Install Apigee hybrid using Helm.
Retry and verify that the error message is no longer
returned.
Must gather diagnostic information
If the problem persists even after following the above instructions, gather
the following diagnostic information and then contact Google Cloud Customer Care:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 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`."]]
