Managed Anthos Service Mesh supports VPC Service Controls (VPC-SC) as a generally available (GA) feature in the rapid channel, for GKE clusters with a release greater or equal to 1.22.1-gke.100. For the information about the preview VPC-SC in the Regular and Stable channels, see VPC Service Controls for managed Anthos Service Mesh.
At the moment only newly provisioned control planes support VPC-SC GA. We are gradually migrating the existing control planes and will provide instructions on how to identify whether a control plane has been migrated. If you want to determine whether an existing control plane has already been migrated, please contact support.
Before you begin
Configure the org-policy
If you provision a new managed Anthos Service Mesh control plane in the rapid channel, follow the instructions for GA below. Otherwise, follow the instructions for preview here.
The following instructions ensure that all new control planes support VPC-SC (either preview or GA). In other words, once the policy is set you will be able to provision the Rapid channel on a cluster running at least 1.22.1-gke.100 (it will have VPC-SC GA support). However, you will not be able to provision the Regular channel on such cluster without explicitly requesting VPC-SC preview. Without it you'd get a regular control plane as VPC-SC GA is not enabled in the Regular channel yet, and the policy prevents that.
Organization admins must configure the org-policy as described in this section, otherwise you risk accidentally provisioning control planes that do not enforce VPC-SC. Edit the org-policy for your organization or for individual projects, and set the constraint 'Allowed VPC-SC mode for ASM Managed Control Planes' to 'COMPATIBLE', using the Console or the following gcloud command:
gcloud resource-manager org-policies allow \ meshconfig.allowedVpcscModes COMPATIBLE \ --project=PROJECT_ID
- PROJECT_ID is the ID of the project that you want to update.
gcloud resource-manager org-policies allow \ meshconfig.allowedVpcscModes COMPATIBLE \ --organization=ORGANIZATION_ID
- ORGANIZATION_ID is the ID of the organization that you want to update.
Set up your VPC-SC service perimeter
Create or update your service perimeter:
Add your cluster project(s) and fleet project to the service perimeter. Having a service mesh spread across multiple VPC-SC perimeters is not supported.
Add restricted services to the service perimeter.
You must add specific services to the allowed and restricted services lists in the service perimeter so that your Anthos Service Mesh cluster can access them. Access to these services is also restricted within your cluster's Virtual Private Cloud (VPC) network.
Not adding these services may cause the Anthos Service Mesh installation to fail or to not function properly. For example, if you don't add the Mesh Configuration API to the service perimeter, the installation will fail and the workloads will not receive their Envoy configuration from the managed control plane.
- Follow the steps in Updating a service perimeter to edit the perimeter.
- Click on the Edit VPC Service Perimeter page.
- Under Restricted Services, Services to protect, click Add Services.
- On the Specify services to restrict dialog, click Filter services, and enter Mesh Configuration API.
- Select the service's checkbox.
- Click Add Mesh Configuration API.
- Repeat steps c - f, to add:
- Cloud Service Mesh Certificate Authority API
- GKE Hub API
- Cloud IAM API
- Cloud Monitoring API
- Cloud Trace API
- Cloud Monitoring API
- Google Cloud Resource Manager API
- Cloud Run API
- Google Compute Engine API
- Google Container Registry API
- Artifact Registry API
- Google Cloud Storage API
- Click Save.
To update the list of restricted services, use the
updatecommand and specify the services to add as a comma-delimited list:
gcloud access-context-manager perimeters update PERIMETER_NAME \ --add-restricted-services=meshconfig.googleapis.com,meshca.googleapis.com,gkehub.googleapis.com,iam.googleapis.com,monitoring.googleapis.com,cloudtrace.googleapis.com,monitoring.googleapis.com,cloudresourcemanager.googleapis.com,run.googleapis.com,compute.googleapis.com,containerregistry.googleapis.com,artifactregistry.googleapis.com,storage.googleapis.com \ --policy=POLICY_NAME
PERIMETER_NAME is the name of the service perimeter that you want to update.
POLICY_NAME is the numeric name of your organization's access policy. For example,
Click on VPC Accessible services and set it to 'All restricted services', so that services restricted at the step above are still accessible from within the VPC-SC perimeter.
Unless you are installing Anthos Service Mesh from an in-perimeter network, add an ingress rule to allow the identity running the
asmclicommand access to the service perimeter.
For more information, see Updating a service perimeter.
Differences from VPC-SC preview
The difference between VPC-SC GA and preview is in the ease of provisioning control planes. Control planes with VPC-SC GA enabled honor VPC-SC perimeter configuration (or lack of thereof) at all times, and do not require any knowledge of VPC-SC at the time of provisioning (no need for explicit enablement). On the other hand, VPC-SC preview has to be enabled explicitly at provisioning time and does not work as expected if there is no VPC-SC perimeter configured.
If you follow the VPC-SC preview instructions to provision a control plane that would be eligible for VPC-SC GA, VPC-SC GA is enabled instead.
Install the managed Anthos Service Mesh in a VPC-SC perimeter
This section does not require organization admin privileges. Follow the steps in Configure managed Anthos Service Mesh page. Then, verify the control plane has been successfully provisioned and there are no VPC-SC related errors.
Containers are not able to download their images.
This may happen if the images are located outside of the service perimeter. Either move the images to a bucket located inside the perimeter, or update the perimeter to add an Egress rule. Typically, the Egress rule may allow selected identities to access the Container Registry API, Artifact Registry API, and Cloud Storage API.
The Status field of the
ControlPlaneRevision CRD displays VPC-SC errors
Run this command to get more info about the error:
gcloud logging read --project=PROJECT_ID \ 'protoPayload.metadata.@type=type.googleapis.com/google.cloud.audit.VpcServiceControlAuditMetadata'
- PROJECT_ID is the project ID of the project encountering errors.