File: //snap/google-cloud-cli/current/lib/surface/compute/target_http_proxies/create.py
# -*- coding: utf-8 -*- #
# Copyright 2014 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.
"""Command for creating target HTTP proxies."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.compute import base_classes
from googlecloudsdk.api_lib.compute import target_proxies_utils
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.compute import scope as compute_scope
from googlecloudsdk.command_lib.compute.target_http_proxies import flags
from googlecloudsdk.command_lib.compute.target_http_proxies import target_http_proxies_utils
from googlecloudsdk.command_lib.compute.url_maps import flags as url_map_flags
def _DetailedHelp():
return {
'brief': 'Create a target HTTP proxy.',
'DESCRIPTION': """\
*{command}* is used to create target HTTP proxies. A target
HTTP proxy is referenced by one or more forwarding rules which
specify the network traffic that the proxy is responsible for
routing. The target HTTP proxy points to a URL map that defines
the rules for routing the requests. The URL map's job is to map
URLs to backend services which handle the actual requests.
""",
'EXAMPLES': """\
If there is an already-created URL map with the name URL_MAP, create a
global target HTTP proxy pointing to this map by running:
$ {command} PROXY_NAME --url-map=URL_MAP
Create a regional target HTTP proxy by running:
$ {command} PROXY_NAME --url-map=URL_MAP --region=REGION_NAME
To create a proxy with a textual description, run:
$ {command} PROXY_NAME --url-map=URL_MAP --description="default proxy"
""",
}
def _Args(parser, traffic_director_security):
"""Add the target http proxies comamnd line flags to the parser."""
parser.display_info.AddFormat(flags.DEFAULT_LIST_FORMAT)
parser.add_argument(
'--description',
help='An optional, textual description for the target HTTP proxy.',
)
parser.display_info.AddCacheUpdater(flags.TargetHttpProxiesCompleter)
if traffic_director_security:
flags.AddProxyBind(parser, False)
target_proxies_utils.AddHttpKeepAliveTimeoutSec(parser)
def _Run(
args, holder, url_map_ref, target_http_proxy_ref, traffic_director_security
):
"""Issue a Target HTTP Proxy Insert request."""
client = holder.client
if traffic_director_security and args.proxy_bind:
target_http_proxy = client.messages.TargetHttpProxy(
description=args.description,
name=target_http_proxy_ref.Name(),
urlMap=url_map_ref.SelfLink(),
proxyBind=args.proxy_bind,
)
else:
target_http_proxy = client.messages.TargetHttpProxy(
description=args.description,
name=target_http_proxy_ref.Name(),
urlMap=url_map_ref.SelfLink(),
)
if args.IsSpecified('http_keep_alive_timeout_sec'):
target_http_proxy.httpKeepAliveTimeoutSec = args.http_keep_alive_timeout_sec
if target_http_proxies_utils.IsRegionalTargetHttpProxiesRef(
target_http_proxy_ref
):
request = client.messages.ComputeRegionTargetHttpProxiesInsertRequest(
project=target_http_proxy_ref.project,
region=target_http_proxy_ref.region,
targetHttpProxy=target_http_proxy,
)
collection = client.apitools_client.regionTargetHttpProxies
else:
request = client.messages.ComputeTargetHttpProxiesInsertRequest(
project=target_http_proxy_ref.project, targetHttpProxy=target_http_proxy
)
collection = client.apitools_client.targetHttpProxies
return client.MakeRequests([(collection, 'Insert', request)])
@base.ReleaseTracks(base.ReleaseTrack.BETA, base.ReleaseTrack.GA)
class Create(base.CreateCommand):
"""Create a target HTTP proxy."""
_traffic_director_security = False
URL_MAP_ARG = None
TARGET_HTTP_PROXY_ARG = None
detailed_help = _DetailedHelp()
@classmethod
def Args(cls, parser):
cls.TARGET_HTTP_PROXY_ARG = flags.TargetHttpProxyArgument()
cls.TARGET_HTTP_PROXY_ARG.AddArgument(parser, operation_type='create')
cls.URL_MAP_ARG = url_map_flags.UrlMapArgumentForTargetProxy()
cls.URL_MAP_ARG.AddArgument(parser)
_Args(parser, cls._traffic_director_security)
def Run(self, args):
"""Issue a Target HTTP Proxy Insert request."""
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
target_http_proxy_ref = self.TARGET_HTTP_PROXY_ARG.ResolveAsResource(
args, holder.resources, default_scope=compute_scope.ScopeEnum.GLOBAL
)
url_map_ref = target_http_proxies_utils.ResolveTargetHttpProxyUrlMap(
args, self.URL_MAP_ARG, target_http_proxy_ref, holder.resources
)
return _Run(
args,
holder,
url_map_ref,
target_http_proxy_ref,
self._traffic_director_security,
)
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class CreateAlpha(Create):
_traffic_director_security = True