254 lines
8.3 KiB
Python
254 lines
8.3 KiB
Python
# -*- coding: utf-8 -*- #
|
|
# Copyright 2018 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.
|
|
"""bigtable app profiles create command."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import unicode_literals
|
|
|
|
import textwrap
|
|
|
|
from apitools.base.py.exceptions import HttpError
|
|
from googlecloudsdk.api_lib.bigtable import app_profiles
|
|
from googlecloudsdk.api_lib.bigtable import util
|
|
from googlecloudsdk.calliope import base
|
|
from googlecloudsdk.command_lib.bigtable import arguments
|
|
from googlecloudsdk.core import log
|
|
|
|
|
|
@base.DefaultUniverseOnly
|
|
@base.ReleaseTracks(base.ReleaseTrack.GA)
|
|
class CreateAppProfile(base.CreateCommand):
|
|
"""Create a new Bigtable app profile."""
|
|
|
|
detailed_help = {
|
|
'EXAMPLES': textwrap.dedent("""\
|
|
To create an app profile with a multi-cluster routing policy, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any
|
|
|
|
To create an app profile with a single-cluster routing policy which
|
|
routes all requests to `my-cluster-id`, run:
|
|
|
|
$ {command} my-single-cluster-app-profile --instance=my-instance-id --route-to=my-cluster-id
|
|
|
|
To create an app profile with a friendly description, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any --description="Routes requests for my use case"
|
|
|
|
To create an app profile with a request priority of PRIORITY_MEDIUM,
|
|
run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM
|
|
|
|
To create an app profile with row-affinity routing enabled, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any --row-affinity
|
|
|
|
To create an app profile with Data Boost enabled which bills usage to the host project, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --data-boost --data-boost-compute-billing-owner=HOST_PAYS
|
|
|
|
"""),
|
|
}
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
arguments.AddAppProfileResourceArg(parser, 'to create')
|
|
(
|
|
arguments.ArgAdder(parser)
|
|
.AddDescription('app profile', required=False)
|
|
.AddAppProfileRouting()
|
|
.AddIsolation()
|
|
.AddForce('create')
|
|
)
|
|
|
|
def _CreateAppProfile(self, app_profile_ref, args):
|
|
"""Creates an AppProfile with the given arguments.
|
|
|
|
Args:
|
|
app_profile_ref: A resource reference of the new app profile.
|
|
args: an argparse namespace. All the arguments that were provided to this
|
|
command invocation.
|
|
|
|
Raises:
|
|
ConflictingArgumentsException,
|
|
OneOfArgumentsRequiredException:
|
|
See app_profiles.Create(...)
|
|
|
|
Returns:
|
|
Created app profile resource object.
|
|
"""
|
|
return app_profiles.Create(
|
|
app_profile_ref,
|
|
cluster=args.route_to,
|
|
description=args.description,
|
|
multi_cluster=args.route_any,
|
|
restrict_to=args.restrict_to,
|
|
transactional_writes=args.transactional_writes,
|
|
row_affinity=args.row_affinity,
|
|
priority=args.priority,
|
|
data_boost=args.data_boost,
|
|
data_boost_compute_billing_owner=args.data_boost_compute_billing_owner,
|
|
force=args.force,
|
|
)
|
|
|
|
def Run(self, args):
|
|
"""This is what gets called when the user runs this command.
|
|
|
|
Args:
|
|
args: an argparse namespace. All the arguments that were provided to this
|
|
command invocation.
|
|
|
|
Raises:
|
|
ConflictingArgumentsException,
|
|
OneOfArgumentsRequiredException:
|
|
See _CreateAppProfile(...)
|
|
|
|
Returns:
|
|
Created resource.
|
|
"""
|
|
app_profile_ref = args.CONCEPTS.app_profile.Parse()
|
|
try:
|
|
result = self._CreateAppProfile(app_profile_ref, args)
|
|
except HttpError as e:
|
|
util.FormatErrorMessages(e)
|
|
else:
|
|
log.CreatedResource(app_profile_ref.Name(), kind='app profile')
|
|
return result
|
|
|
|
|
|
@base.ReleaseTracks(base.ReleaseTrack.BETA)
|
|
class CreateAppProfileBeta(CreateAppProfile):
|
|
"""Create a new Bigtable app profile."""
|
|
|
|
detailed_help = {
|
|
'EXAMPLES': textwrap.dedent("""\
|
|
To create an app profile with a multi-cluster routing policy, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any
|
|
|
|
To create an app profile with a single-cluster routing policy which
|
|
routes all requests to `my-cluster-id`, run:
|
|
|
|
$ {command} my-single-cluster-app-profile --instance=my-instance-id --route-to=my-cluster-id
|
|
|
|
To create an app profile with a friendly description, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any --description="Routes requests for my use case"
|
|
|
|
To create an app profile with a request priority of PRIORITY_MEDIUM,
|
|
run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM
|
|
|
|
To create an app profile with Data Boost enabled which bills usage to the host project, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --data-boost --data-boost-compute-billing-owner=HOST_PAYS
|
|
|
|
To create an app profile with row-affinity routing enabled, run:
|
|
|
|
$ {command} my-app-profile-id --instance=my-instance-id --route-any --row-affinity
|
|
|
|
"""),
|
|
}
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
arguments.AddAppProfileResourceArg(parser, 'to create')
|
|
(
|
|
arguments.ArgAdder(parser)
|
|
.AddDescription('app profile', required=False)
|
|
.AddAppProfileRouting()
|
|
.AddIsolation()
|
|
.AddForce('create')
|
|
)
|
|
|
|
def _CreateAppProfile(self, app_profile_ref, args):
|
|
"""Creates an AppProfile with the given arguments.
|
|
|
|
Args:
|
|
app_profile_ref: A resource reference of the new app profile.
|
|
args: an argparse namespace. All the arguments that were provided to this
|
|
command invocation.
|
|
|
|
Raises:
|
|
ConflictingArgumentsException,
|
|
OneOfArgumentsRequiredException:
|
|
See app_profiles.Create(...)
|
|
|
|
Returns:
|
|
Created app profile resource object.
|
|
"""
|
|
return app_profiles.Create(
|
|
app_profile_ref,
|
|
cluster=args.route_to,
|
|
description=args.description,
|
|
multi_cluster=args.route_any,
|
|
restrict_to=args.restrict_to,
|
|
transactional_writes=args.transactional_writes,
|
|
row_affinity=args.row_affinity,
|
|
priority=args.priority,
|
|
data_boost=args.data_boost,
|
|
data_boost_compute_billing_owner=args.data_boost_compute_billing_owner,
|
|
force=args.force,
|
|
)
|
|
|
|
|
|
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
|
|
class CreateAppProfileAlpha(CreateAppProfileBeta):
|
|
"""Create a new Bigtable app profile."""
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
arguments.AddAppProfileResourceArg(parser, 'to create')
|
|
(
|
|
arguments.ArgAdder(parser)
|
|
.AddDescription('app profile', required=False)
|
|
.AddAppProfileRouting()
|
|
.AddIsolation()
|
|
.AddForce('create')
|
|
)
|
|
|
|
def _CreateAppProfile(self, app_profile_ref, args):
|
|
"""Creates an AppProfile with the given arguments.
|
|
|
|
Args:
|
|
app_profile_ref: A resource reference of the new app profile.
|
|
args: an argparse namespace. All the arguments that were provided to this
|
|
command invocation.
|
|
|
|
Raises:
|
|
ConflictingArgumentsException,
|
|
OneOfArgumentsRequiredException:
|
|
See app_profiles.Create(...)
|
|
|
|
Returns:
|
|
Created app profile resource object.
|
|
"""
|
|
return app_profiles.Create(
|
|
app_profile_ref,
|
|
cluster=args.route_to,
|
|
description=args.description,
|
|
multi_cluster=args.route_any,
|
|
restrict_to=args.restrict_to,
|
|
transactional_writes=args.transactional_writes,
|
|
row_affinity=args.row_affinity,
|
|
priority=args.priority,
|
|
data_boost=args.data_boost,
|
|
data_boost_compute_billing_owner=args.data_boost_compute_billing_owner,
|
|
force=args.force,
|
|
)
|