File: //snap/google-cloud-cli/current/lib/surface/filestore/instances/create.py
# -*- coding: utf-8 -*- #
# Copyright 2017 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.
"""Creates a Filestore instance."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.filestore import filestore_client
from googlecloudsdk.calliope import base
from googlecloudsdk.calliope import exceptions
from googlecloudsdk.command_lib.filestore.instances import flags as instances_flags
from googlecloudsdk.command_lib.util.args import labels_util
from googlecloudsdk.core import log
from googlecloudsdk.core import properties
import six
def _CommonArgs(parser, api_version=filestore_client.V1_API_VERSION):
instances_flags.AddInstanceCreateArgs(parser, api_version)
@base.UniverseCompatible
@base.ReleaseTracks(base.ReleaseTrack.GA)
class Create(base.CreateCommand):
"""Create a Filestore instance."""
_API_VERSION = filestore_client.V1_API_VERSION
detailed_help = {
'DESCRIPTION': 'Create a Filestore instance.',
'EXAMPLES': """\
The following command creates a Filestore instance named NAME with a single volume.
$ {command} NAME --description=DESCRIPTION --tier=TIER --protocol=PROTOCOL --file-share=name=VOLUME_NAME,capacity=CAPACITY --network=name=NETWORK_NAME,reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE,psc-endpoint-project=PSC_ENDPOINT_PROJECT --zone=ZONE --performance=max-iops-per-tb=MAX-IOPS-PER-TB --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE
Example json configuration file:
{
"--file-share":
{
"capacity": "61440",
"name": "my_vol",
"nfs-export-options": [
{
"access-mode": "READ_WRITE",
"ip-ranges": [
"10.0.0.0/8",
],
"squash-mode": "NO_ROOT_SQUASH",
},
{
"access-mode": "READ_ONLY",
"ip-ranges": [
"192.168.0.0/24"
],
"squash-mode": "ROOT_SQUASH",
"anon_uid": 1003,
"anon_gid": 1003
}
]
}
}
""",
}
@staticmethod
def Args(parser):
_CommonArgs(parser, Create._API_VERSION)
def Run(self, args):
"""Create a Filestore instance in the current project."""
instance_ref = args.CONCEPTS.instance.Parse()
client = filestore_client.FilestoreClient(self._API_VERSION)
tier = instances_flags.GetTierArg(client.messages).GetEnumForChoice(
args.tier
)
protocol = None
if args.protocol is not None:
protocol = instances_flags.GetProtocolArg(
client.messages
).GetEnumForChoice(args.protocol)
ldap = args.ldap or None
labels = labels_util.ParseCreateArgs(args,
client.messages.Instance.LabelsValue)
tags = instances_flags.GetTagsFromArgs(args,
client.messages.Instance.TagsValue)
try:
nfs_export_options = client.MakeNFSExportOptionsMsg(
messages=client.messages,
nfs_export_options=args.file_share.get('nfs-export-options', []))
except KeyError as err:
raise exceptions.InvalidArgumentException('--file-share',
six.text_type(err))
instance = client.ParseFilestoreConfig(
tier=tier,
protocol=protocol,
description=args.description,
file_share=args.file_share,
network=args.network,
performance=args.performance,
labels=labels,
tags=tags,
zone=instance_ref.locationsId,
nfs_export_options=nfs_export_options,
kms_key_name=instances_flags.GetAndValidateKmsKeyName(args),
ldap=ldap,
source_instance=args.source_instance,
deletion_protection_enabled=args.deletion_protection,
deletion_protection_reason=args.deletion_protection_reason)
result = client.CreateInstance(instance_ref, args.async_, instance)
if args.async_:
command = properties.VALUES.metrics.command_name.Get().split('.')
if command:
command[-1] = 'list'
log.status.Print(
'Check the status of the new instance by listing all instances:\n '
'$ {} '.format(' '.join(command)))
return result
@base.UniverseCompatible
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class CreateBeta(Create):
"""Create a Filestore instance."""
_API_VERSION = filestore_client.BETA_API_VERSION
detailed_help = {
'DESCRIPTION': 'Create a Filestore instance.',
'EXAMPLES': """\
The following command creates a Filestore instance named NAME with a single volume.
$ {command} NAME --description=DESCRIPTION --tier=TIER --protocol=PROTOCOL --file-share=name=VOLUME_NAME,capacity=CAPACITY --network=name=NETWORK_NAME,reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE,psc-endpoint-project=PSC_ENDPOINT_PROJECT --zone=ZONE --performance=max-iops-per-tb=MAX-IOPS-PER-TB --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT --managed-ad=domain=DOMAIN,computer=COMPUTER --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE
Example json configuration file:
{
"--file-share":
{
"capacity": "61440",
"name": "my_vol",
"nfs-export-options": [
{
"access-mode": "READ_WRITE",
"ip-ranges": [
"10.0.0.0/8",
],
"squash-mode": "NO_ROOT_SQUASH",
"security-flavors": [
"AUTH_SYS",
"KRB5P",
],
},
{
"access-mode": "READ_ONLY",
"ip-ranges": [
"192.168.0.0/24"
],
"squash-mode": "ROOT_SQUASH"
"anon_uid": 1003,
"anon_gid": 1003
}
],
}
}
""",
}
@staticmethod
def Args(parser):
_CommonArgs(parser, CreateBeta._API_VERSION)
def Run(self, args):
"""Creates a Filestore instance in the current project.
Note: This is a copied code from Run() of base.ReleaseTrack.GA.
Args:
args: A list of fields.
Returns:
A filestore instance.
"""
instance_ref = args.CONCEPTS.instance.Parse()
client = filestore_client.FilestoreClient(self._API_VERSION)
tier = instances_flags.GetTierArg(client.messages).GetEnumForChoice(
args.tier
)
protocol = None
if args.protocol is not None:
protocol = instances_flags.GetProtocolArg(
client.messages
).GetEnumForChoice(args.protocol)
backend_type = None
if args.backend_type is not None:
backend_type = instances_flags.GetBackendTypeArg(
client.messages
).GetEnumForChoice(args.backend_type)
managed_ad = args.managed_ad or None
ldap = args.ldap or None
source_instance = args.source_instance or None
labels = labels_util.ParseCreateArgs(
args, client.messages.Instance.LabelsValue)
tags = instances_flags.GetTagsFromArgs(args,
client.messages.Instance.TagsValue)
try:
nfs_export_options = client.MakeNFSExportOptionsMsgBeta(
messages=client.messages,
nfs_export_options=args.file_share.get('nfs-export-options', []))
except KeyError as err:
raise exceptions.InvalidArgumentException('--file-share',
six.text_type(err))
instance = client.ParseFilestoreConfig(
tier=tier,
protocol=protocol,
description=args.description,
file_share=args.file_share,
network=args.network,
performance=args.performance,
labels=labels,
tags=tags,
zone=instance_ref.locationsId,
nfs_export_options=nfs_export_options,
kms_key_name=instances_flags.GetAndValidateKmsKeyName(args),
managed_ad=managed_ad,
ldap=ldap,
source_instance=source_instance,
deletion_protection_enabled=args.deletion_protection,
deletion_protection_reason=args.deletion_protection_reason,
backend_type=backend_type,
)
result = client.CreateInstance(instance_ref, args.async_, instance)
if args.async_:
command = properties.VALUES.metrics.command_name.Get().split('.')
if command:
command[-1] = 'list'
log.status.Print(
'Check the status of the new instance by listing all instances:\n '
'$ {} '.format(' '.join(command)))
return result
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class CreateAlpha(Create):
"""Create a Filestore instance."""
_API_VERSION = filestore_client.ALPHA_API_VERSION
detailed_help = {
'DESCRIPTION':
'Create a Filestore instance.',
'EXAMPLES':
"""\
The following command creates a Filestore instance named NAME with a single volume.
$ {command} NAME \
--description=DESCRIPTION --tier=TIER \
--file-share=name=VOLUME_NAME,capacity=CAPACITY \
--network=name=NETWORK_NAME,reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE \
--zone=ZONE \
--flags-file=FLAGS_FILE
Example json configuration file:
{
"--file-share":
{
"capacity": "61440",
"name": "my_vol",
"nfs-export-options": [
{
"access-mode": "READ_WRITE",
"ip-ranges": [
"10.0.0.0/8",
],
"squash-mode": "NO_ROOT_SQUASH",
},
{
"access-mode": "READ_ONLY",
"ip-ranges": [
"192.168.0.0/24"
],
"squash-mode": "ROOT_SQUASH"
"anon_uid": 1003,
"anon_gid": 1003
}
],
}
}
"""
}
@staticmethod
def Args(parser):
_CommonArgs(parser, CreateAlpha._API_VERSION)
def Run(self, args):
"""Create a Filestore instance in the current project."""
instance_ref = args.CONCEPTS.instance.Parse()
client = filestore_client.FilestoreClient(self._API_VERSION)
tier = instances_flags.GetTierArg(client.messages).GetEnumForChoice(
args.tier
)
labels = labels_util.ParseCreateArgs(args,
client.messages.Instance.LabelsValue)
try:
nfs_export_options = client.MakeNFSExportOptionsMsg(
messages=client.messages,
nfs_export_options=args.file_share.get('nfs-export-options', []))
except KeyError as err:
raise exceptions.InvalidArgumentException('--file-share',
six.text_type(err))
instance = client.ParseFilestoreConfig(
tier=tier,
description=args.description,
file_share=args.file_share,
network=args.network,
labels=labels,
zone=instance_ref.locationsId,
nfs_export_options=nfs_export_options)
result = client.CreateInstance(instance_ref, args.async_, instance)
if args.async_:
command = properties.VALUES.metrics.command_name.Get().split('.')
if command:
command[-1] = 'list'
log.status.Print(
'Check the status of the new instance by listing all instances:\n '
'$ {} '.format(' '.join(command)))
return result