File: //snap/google-cloud-cli/current/lib/surface/services/vpc_peerings/enable_vpc_service_controls.py
# -*- coding: utf-8 -*- #
# Copyright 2020 Google LLC. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""services vpc-peerings enable-vpc-service-controls command."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.cloudresourcemanager import projects_api
from googlecloudsdk.api_lib.services import peering
from googlecloudsdk.api_lib.services import services_util
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.projects import util as projects_util
from googlecloudsdk.core import log
from googlecloudsdk.core import properties
OP_BASE_CMD = 'gcloud services vpc-peerings operations '
OP_WAIT_CMD = OP_BASE_CMD + 'wait {0}'
@base.ReleaseTracks(
base.ReleaseTrack.ALPHA,
base.ReleaseTrack.BETA,
base.ReleaseTrack.GA,
)
class EnableVpcServiceControls(base.SilentCommand):
"""Enable VPC Service Controls for the peering connection."""
detailed_help = {
'DESCRIPTION':
"""\
This command configures IPv4 routes and DNS zones applicable to a
service producer VPC network (for example, servicenetworking). The
route and DNS configuration match those recommended for using the
restricted.googleapis.com VIP:
When enabled, Google Cloud makes the following route configuration
changes in the service producer VPC network: Google Cloud removes the
IPv4 default route (destination 0.0.0.0/0, next hop default internet
gateway). Google Cloud then creates an IPv4 route for destination
199.36.153.4/30 using the default internet gateway next hop.
When enabled, Google Cloud also creates Cloud DNS managed private
zones and authorizes those zones for the service producer VPC network.
The zones include googleapis.com, pkg.dev, gcr.io, and other necessary
domains or host names for Google APIs and services that are compatible
with VPC Service Controls. Record data in the zones resolves all host
names to 199.36.153.4, 199.36.153.5, 199.36.153.6, and 199.36.153.7.
When disabled, Google Cloud makes the following route configuration
changes in the service producer VPC network: Google Cloud restores a
default route (destination 0.0.0.0/0, next hop default internet
gateway). Google Cloud also deletes the Cloud DNS managed private
zones that provided the host name overrides.
While enabled, the service producer VPC network can still import
static and dynamic routes from the peered customer network if you
enable custom route export. These custom routes can include a default
route. For this reason, this command is not to be used solely as a
means for preventing access to the internet.
""",
'EXAMPLES':
"""\
To enable VPC Service Controls for a connection peering a network
called `my-network` on the current project to a service called
`your-service`, run:
$ {command} --network=my-network --service=your-service
To run the same command asynchronously (non-blocking), run:
$ {command} --network=my-network --service=your-service --async
""",
}
@staticmethod
def Args(parser):
"""Args is called by calliope to gather arguments for this command.
Args:
parser: An argparse parser that can be used to add arguments that go on
the command line after this command. Positional arguments are allowed.
"""
parser.add_argument(
'--network',
metavar='NETWORK',
required=True,
help='The network in the current project that is peered with the service.'
)
parser.add_argument(
'--service',
metavar='SERVICE',
default='servicenetworking.googleapis.com',
help='The service to enable VPC service controls for.')
base.ASYNC_FLAG.AddToParser(parser)
def Run(self, args):
"""Run 'services vpc-peerings enable-vpc-service-controls'.
Args:
args: argparse.Namespace, The arguments that this command was invoked
with.
"""
project = properties.VALUES.core.project.Get(required=True)
project_number = _GetProjectNumber(project)
op = peering.EnableVpcServiceControls(project_number, args.service,
args.network)
if args.async_:
cmd = OP_WAIT_CMD.format(op.name)
log.status.Print('Asynchronous operation is in progress... '
'Use the following command to wait for its '
'completion:\n {0}'.format(cmd))
return
op = services_util.WaitOperation(op.name, peering.GetOperation)
services_util.PrintOperation(op)
def _GetProjectNumber(project_id):
return projects_api.Get(projects_util.ParseProject(project_id)).projectNumber