File: //snap/google-cloud-cli/current/lib/googlecloudsdk/command_lib/domains/flags.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.
"""Shared flags for Cloud Domains commands."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
import enum
from googlecloudsdk.api_lib.domains import registrations
from googlecloudsdk.api_lib.util import apis
from googlecloudsdk.calliope import actions
from googlecloudsdk.calliope import arg_parsers
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.util.apis import arg_utils
# Alpha API = Beta API = GA API
# It doesn't matter which one is used to generate flags.
API_VERSION_FOR_FLAGS = registrations.GA_API_VERSION
class MutationOp(enum.Enum):
"""Different types of mutation operations."""
REGISTER = 1
UPDATE = 2
TRANSFER = 3
RENEWAL = 4
def AddConfigureDNSSettingsFlagsToParser(parser):
"""Get flags for changing DNS settings.
Args:
parser: argparse parser to which to add these flags.
"""
_AddDNSSettingsFlagsToParser(parser, mutation_op=MutationOp.UPDATE)
base.Argument( # This is not a go/gcloud-style#commonly-used-flags.
'--unsafe-dns-update',
default=False,
help='Use this flag to allow DNS changes that may make '
'your domain stop serving.',
action=actions.DeprecationAction(
'--unsafe-dns-update',
warn=('The {flag_name} option is deprecated. To complete an unsafe '
'DNS operation first disable DNSSEC, then change name servers, '
'then (optionally) enable DNSSEC.'),
removed=False,
action='store_true'),
).AddToParser(parser)
def AddConfigureContactsSettingsFlagsToParser(parser):
"""Get flags for changing contact settings.
Args:
parser: argparse parser to which to add these flags.
"""
_AddContactSettingsFlagsToParser(parser, mutation_op=MutationOp.UPDATE)
messages = apis.GetMessagesModule('domains', API_VERSION_FOR_FLAGS)
base.Argument( # This is not a go/gcloud-style#commonly-used-flags.
'--notices',
help='Notices about special properties of contacts.',
metavar='NOTICE',
type=arg_parsers.ArgList(
element_type=str, choices=ContactNoticeEnumMapper(
messages).choices)).AddToParser(parser)
def AddTransferFlagsToParser(parser):
"""Get flags for transferring a domain.
Args:
parser: argparse parser to which to add these flags.
"""
_AddDNSSettingsFlagsToParser(parser, mutation_op=MutationOp.TRANSFER)
_AddContactSettingsFlagsToParser(parser, mutation_op=MutationOp.TRANSFER)
AddPriceFlagsToParser(parser, MutationOp.TRANSFER)
help_text = """\
A file containing the authorizaton code. In most cases, you must provide an
authorization code from the domain's current registrar to transfer the
domain.
Examples of file contents:
```
5YcCd!X&W@q0Xozj
```
"""
base.Argument(
'--authorization-code-from-file',
help=help_text,
metavar='AUTHORIZATION_CODE_FILE_NAME',
category=base.COMMONLY_USED_FLAGS).AddToParser(parser)
messages = apis.GetMessagesModule('domains', API_VERSION_FOR_FLAGS)
notice_choices = ContactNoticeEnumMapper(messages).choices.copy()
base.Argument( # This is not a go/gcloud-style#commonly-used-flags.
'--notices',
help='Notices about special properties of certain domains or contacts.',
metavar='NOTICE',
type=arg_parsers.ArgList(element_type=str,
choices=notice_choices)).AddToParser(parser)
def AddRegisterFlagsToParser(parser):
"""Get flags for registering a domain.
Args:
parser: argparse parser to which to add these flags.
"""
_AddDNSSettingsFlagsToParser(parser, mutation_op=MutationOp.REGISTER)
_AddContactSettingsFlagsToParser(parser, mutation_op=MutationOp.REGISTER)
AddPriceFlagsToParser(parser, MutationOp.REGISTER)
messages = apis.GetMessagesModule('domains', API_VERSION_FOR_FLAGS)
notice_choices = ContactNoticeEnumMapper(messages).choices.copy()
notice_choices.update({
'hsts-preloaded':
('By sending this notice you acknowledge that the domain is '
'preloaded on the HTTP Strict Transport Security list in browsers. '
'Serving a website on such domain will require an SSL certificate. '
'See https://support.google.com/domains/answer/7638036 for details.')
})
base.Argument( # This is not a go/gcloud-style#commonly-used-flags.
'--notices',
help='Notices about special properties of certain domains or contacts.',
metavar='NOTICE',
type=arg_parsers.ArgList(element_type=str,
choices=notice_choices)).AddToParser(parser)
def _AddDNSSettingsFlagsToParser(parser, mutation_op):
"""Get flags for providing DNS settings.
Args:
parser: argparse parser to which to add these flags.
mutation_op: operation for which we're adding flags.
"""
dnssec_help_text = ''
group_help_text = """\
Set the authoritative name servers for the given domain.
"""
if mutation_op == MutationOp.REGISTER:
dnssec_help_text = ('If the zone is signed, DNSSEC will be enabled by '
'default unless you pass --disable-dnssec.')
if mutation_op == MutationOp.UPDATE:
group_help_text = group_help_text + """
Warning: Do not change name servers if ds_records is non-empty.
Clear ds_records first by calling this command with the
--disable-dnssec flag, and wait 24 hours before changing
name servers. Otherwise your domain may stop serving.
"""
if mutation_op == MutationOp.TRANSFER:
dnssec_help_text = ('DNSSEC will be disabled and will need to be enabled '
'after the transfer completes, if desired.')
group_help_text = group_help_text + """
Warning: If your DNS is hosted by your old registrar, we do not
recommend keeping your current DNS settings, as these services
often terminate when you transfer out. Instead, you should
switch to another DNS provider such as Cloud DNS. To avoid
downtime during the transfer, copy your DNS records to your new
DNS provider before initiating transfer.
Warning: If you are changing your DNS settings and your domain
currently has DS records, make sure to remove the DS records at
your old registrar and wait a day before initiating transfer.
If you are keeping your current DNS settings, then no changes
to DS records are necessary.
"""
dns_group = base.ArgumentGroup(
mutex=True, help=group_help_text, category=base.COMMONLY_USED_FLAGS)
# Disable this flag for the transfer case.
if mutation_op != MutationOp.TRANSFER:
dns_group.AddArgument(
base.Argument(
'--name-servers',
help='List of DNS name servers for the domain.',
metavar='NAME_SERVER',
type=arg_parsers.ArgList(str, min_length=2)))
cloud_dns_transfer_help_text = ''
if mutation_op == MutationOp.TRANSFER:
cloud_dns_transfer_help_text = (
' To avoid downtime following transfer, make sure the zone is '
'configured correctly before proceeding.')
cloud_dns_help_text = (
'The name of the Cloud DNS managed-zone to set as the name '
'server for the domain.\n'
'If it\'s in the same project, you can use short name. If not, '
'use the full resource name, e.g.: --cloud-dns-zone='
'projects/example-project/managedZones/example-zone.{}\n'
'{}').format(cloud_dns_transfer_help_text, dnssec_help_text)
google_dns_transfer_help_text = ''
if mutation_op == MutationOp.TRANSFER:
google_dns_transfer_help_text = (
' This blank-slate option cannot be configured before transfer.')
google_dns_help_text = (
'Use free name servers provided by Google Domains.{}\n'
'{}').format(google_dns_transfer_help_text, dnssec_help_text)
dns_group.AddArgument(
base.Argument('--cloud-dns-zone', help=cloud_dns_help_text))
dns_group.AddArgument(
base.Argument(
'--use-google-domains-dns',
help=google_dns_help_text,
default=False,
action=actions.DeprecationAction(
'--use-google-domains-dns',
warn=(
'The {flag_name} option is deprecated; See'
' https://cloud.google.com/domains/docs/deprecations/feature-deprecations.'
),
# Removed for REGISTER, Deprecated for UPDATE.
removed=(mutation_op == MutationOp.REGISTER),
action='store_true',
),
)
)
if mutation_op == MutationOp.TRANSFER:
dns_group.AddArgument(
base.Argument(
'--keep-dns-settings',
help=(
'Keep the domain\'s current DNS configuration from its current '
'registrar. Use this option only if you are sure that the '
'domain\'s current DNS service will not cease upon transfer, as'
' is often the case for DNS services provided for free by the '
'registrar.'),
default=False,
action='store_true'))
if mutation_op == MutationOp.UPDATE:
help_text = """\
A YAML file containing the required DNS settings.
If specified, its content will replace the values currently used in the
registration resource. If the file is missing some of the dns_settings
fields, those fields will be cleared.
Examples of file contents:
```
googleDomainsDns:
dsState: DS_RECORDS_PUBLISHED
glueRecords:
- hostName: ns1.example.com
ipv4Addresses:
- 8.8.8.8
- hostName: ns2.example.com
ipv4Addresses:
- 8.8.8.8
```
```
customDns:
nameServers:
- new.ns1.com
- new.ns2.com
dsRecords:
- keyTag: 24
algorithm: RSASHA1
digestType: SHA256
digest: 2e1cfa82b035c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d
- keyTag: 42
algorithm: RSASHA1
digestType: SHA256
digest: 2e1cfa82bf35c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d
```
"""
dns_group.AddArgument(
base.Argument(
'--dns-settings-from-file',
help=help_text,
metavar='DNS_SETTINGS_FILE_NAME'))
dns_group.AddToParser(parser)
if mutation_op != MutationOp.TRANSFER:
base.Argument(
'--disable-dnssec',
help="""\
Use this flag to disable DNSSEC, or to skip enabling it when switching
to a Cloud DNS Zone or Google Domains nameservers.
""",
default=False,
action='store_true').AddToParser(parser)
def _AddContactSettingsFlagsToParser(parser, mutation_op):
"""Get flags for providing Contact settings.
Args:
parser: argparse parser to which to add these flags.
mutation_op: operation for which we're adding flags.
"""
help_text = """\
A YAML file containing the contact data for the domain's three contacts:
registrant, admin, and technical.
The file can either specify a single set of contact data with label
'allContacts', or three separate sets of contact data with labels
'adminContact' and 'technicalContact'.
{}
Each contact data must contain values for all required fields: email,
phoneNumber and postalAddress in google.type.PostalAddress format.
For more guidance on how to specify postalAddress, please see:
https://support.google.com/business/answer/6397478
Examples of file contents:
```
allContacts:
email: 'example@example.com'
phoneNumber: '+1.8005550123'
postalAddress:
regionCode: 'US'
postalCode: '94043'
administrativeArea: 'CA'
locality: 'Mountain View'
addressLines: ['1600 Amphitheatre Pkwy']
recipients: ['Jane Doe']
```
{}
```
registrantContact:
email: 'registrant@example.com'
phoneNumber: '+1.8005550123'
postalAddress:
regionCode: 'US'
postalCode: '94043'
administrativeArea: 'CA'
locality: 'Mountain View'
addressLines: ['1600 Amphitheatre Pkwy']
recipients: ['Registrant Jane Doe']
adminContact:
email: 'admin@example.com'
phoneNumber: '+1.8005550123'
postalAddress:
regionCode: 'US'
postalCode: '94043'
administrativeArea: 'CA'
locality: 'Mountain View'
addressLines: ['1600 Amphitheatre Pkwy']
recipients: ['Admin Jane Doe']
technicalContact:
email: 'technical@example.com'
phoneNumber: '+1.8005550123'
postalAddress:
regionCode: 'US'
postalCode: '94043'
administrativeArea: 'CA'
locality: 'Mountain View'
addressLines: ['1600 Amphitheatre Pkwy']
recipients: ['Technic Jane Doe']
```
"""
if mutation_op == MutationOp.UPDATE:
help_text = help_text.format(
"""
If 'registrantContact', 'adminContact' or 'technicalContact' labels are used
then only the specified contacts are updated.
""", """
```
adminContact:
email: 'admin@example.com'
phoneNumber: '+1.8005550123'
postalAddress:
regionCode: 'US'
postalCode: '94043'
administrativeArea: 'CA'
locality: 'Mountain View'
addressLines: ['1600 Amphitheatre Pkwy']
recipients: ['Admin Jane Doe']
```
""")
else:
help_text = help_text.format('', '')
base.Argument(
'--contact-data-from-file',
help=help_text,
metavar='CONTACT_DATA_FILE_NAME',
category=base.COMMONLY_USED_FLAGS).AddToParser(parser)
def _ChoiceValueType(value):
"""Copy of base._ChoiceValueType."""
return value.replace('_', '-').lower()
messages = apis.GetMessagesModule('domains', API_VERSION_FOR_FLAGS)
base.Argument(
'--contact-privacy',
choices=ContactPrivacyEnumMapper(messages).choices,
type=_ChoiceValueType,
help=(
'The contact privacy mode to use. Supported privacy modes depend on'
' the domain.'
),
required=False,
category=base.COMMONLY_USED_FLAGS,
action=actions.DeprecationAction(
'--contact-privacy=private-contact-data',
show_message=lambda choice: choice == 'private-contact-data',
show_add_help=False,
warn=(
'The {flag_name} option is deprecated; See'
' https://cloud.google.com/domains/docs/deprecations/feature-deprecations.'
),
removed=False,
),
).AddToParser(parser)
def AddPriceFlagsToParser(parser, mutation_op):
get_price_method = ''
if mutation_op == MutationOp.REGISTER:
get_price_method = 'using the get-register-parameters command'
elif mutation_op == MutationOp.TRANSFER:
get_price_method = 'using the get-transfer-parameters command'
elif mutation_op == MutationOp.RENEWAL:
get_price_method = ('by calling the renew-domain command without the '
'--yearly-price flag')
base.Argument( # This is not a go/gcloud-style#commonly-used-flags.
'--yearly-price',
help=('Accept the domain\'s yearly price in the interactive flow or by '
'using this flag. Use a number followed by a currency code, for '
'example, "12.00 USD". Get the price {}.'.format(get_price_method)),
).AddToParser(parser)
def AddValidateOnlyFlagToParser(parser, verb, noun='registration'):
"""Adds validate_only flag as go/gcloud-style#commonly-used-flags."""
base.Argument(
'--validate-only',
help='Don\'t actually {} {}. Only validate arguments.'.format(verb, noun),
default=False,
action='store_true',
category=base.COMMONLY_USED_FLAGS).AddToParser(parser)
def AddAsyncFlagToParser(parser):
"""Adds async flag. It's not marked as go/gcloud-style#commonly-used-flags."""
base.ASYNC_FLAG.AddToParser(parser)
def AddTagFlagToParser(parser):
base.Argument(
'--tag',
help=('The Tag of the new registrar. Can be found at '
'https://nominet.uk/registrar-list/'),
).AddToParser(parser)
def AddManagementSettingsFlagsToParser(parser):
"""Get flags for configure management command.
Args:
parser: argparse parser to which to add these flags.
"""
messages = apis.GetMessagesModule('domains', API_VERSION_FOR_FLAGS)
TransferLockEnumMapper(messages).choice_arg.AddToParser(parser)
RenewalMethodEnumMapper(messages).choice_arg.AddToParser(parser)
def _GetContactPrivacyEnum(domains_messages):
"""Get Contact Privacy Enum from api messages."""
return domains_messages.ContactSettings.PrivacyValueValuesEnum
def ContactPrivacyEnumMapper(domains_messages):
return arg_utils.ChoiceEnumMapper(
'--contact-privacy',
_GetContactPrivacyEnum(domains_messages),
custom_mappings={
'PRIVATE_CONTACT_DATA': (
'private-contact-data',
(
"(DEPRECATED) Your contact info won't be available to the"
' public. To help protect your info and prevent spam, a third'
' party provides alternate (proxy) contact info for your'
' domain in the public directory at no extra cost. They will'
' forward received messages to you.'
' The private-contact-data option is deprecated; See'
' https://cloud.google.com/domains/docs/deprecations/feature-deprecations.'
),
),
'REDACTED_CONTACT_DATA': (
'redacted-contact-data',
(
'Limited personal information will be available to the'
' public. The actual information redacted depends on the'
' domain. For more information see'
' https://support.google.com/domains/answer/3251242.'
),
),
'PUBLIC_CONTACT_DATA': (
'public-contact-data',
(
'All the data from contact config is publicly available. To'
' set this value, you must also pass the --notices flag with'
' value public-contact-data-acknowledgement or agree to the'
' notice interactively.'
),
),
},
required=False,
help_str=(
'The contact privacy mode to use. Supported privacy modes '
'depend on the domain.'
),
)
def PrivacyChoiceStrength(privacy):
"""Returns privacy strength (stronger privacy means higher returned value)."""
if privacy == 'public-contact-data':
return 0
if privacy == 'redacted-contact-data':
return 1
if privacy == 'private-contact-data':
return 2
def _GetContactNoticeEnum(domains_messages):
"""Get ContactNoticeEnum from api messages."""
return domains_messages.ConfigureContactSettingsRequest.ContactNoticesValueListEntryValuesEnum
def ContactNoticeEnumMapper(domains_messages):
return arg_utils.ChoiceEnumMapper(
'--notices',
_GetContactNoticeEnum(domains_messages),
custom_mappings={
'PUBLIC_CONTACT_DATA_ACKNOWLEDGEMENT':
('public-contact-data-acknowledgement',
('By sending this notice you acknowledge that using '
'public-contact-data contact privacy makes all the data '
'from contact config publicly available.')),
},
required=False,
help_str=('Notices about special properties of contacts.'))
def _GetTransferLockEnum(domains_messages):
"""Get TransferLockStateValueValuesEnum from api messages."""
return domains_messages.ManagementSettings.TransferLockStateValueValuesEnum
def TransferLockEnumMapper(domains_messages):
return arg_utils.ChoiceEnumMapper(
'--transfer-lock-state',
_GetTransferLockEnum(domains_messages),
custom_mappings={
'LOCKED': ('locked', ('The transfer lock is locked.')),
'UNLOCKED': ('unlocked', ('The transfer lock is unlocked.')),
},
required=False,
help_str=('Transfer Lock of a registration. It needs to be unlocked '
'in order to transfer the domain to another registrar.'))
def _GetRenewalMethodEnum(domains_messages):
"""Get PreferredRenewalMethodValueValuesEnum from api messages."""
return (
domains_messages.ManagementSettings.PreferredRenewalMethodValueValuesEnum
)
def RenewalMethodEnumMapper(domains_messages):
return arg_utils.ChoiceEnumMapper(
'--preferred-renewal-method',
_GetRenewalMethodEnum(domains_messages),
custom_mappings={
'AUTOMATIC_RENEWAL': (
'automatic-renewal',
'The domain is automatically renewed each year.',
),
'RENEWAL_DISABLED': (
'renewal-disabled',
(
"The domain won't be renewed and will expire at its "
'expiration time.'
),
),
},
required=False,
help_str=(
'Preferred Renewal Method of a registration. '
'It defines how the registration should be renewed. '
'The actual Renewal Method can be set to renewal-disabled in case of '
'e.g. problems with the Billing Account or reporeted domain abuse.'
),
)