134 lines
5.4 KiB
Python
134 lines
5.4 KiB
Python
# -*- coding: utf-8 -*- #
|
|
# Copyright 2013 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.
|
|
"""Promotes Cloud SQL read replica to a stand-alone instance."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import unicode_literals
|
|
|
|
import sys
|
|
import textwrap
|
|
|
|
from googlecloudsdk.api_lib.sql import api_util
|
|
from googlecloudsdk.api_lib.sql import instances
|
|
from googlecloudsdk.api_lib.sql import operations
|
|
from googlecloudsdk.api_lib.sql import validate
|
|
from googlecloudsdk.calliope import base
|
|
from googlecloudsdk.command_lib.sql import flags
|
|
from googlecloudsdk.core import log
|
|
from googlecloudsdk.core import properties
|
|
from googlecloudsdk.core.console import console_io
|
|
|
|
|
|
@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
|
|
base.ReleaseTrack.ALPHA)
|
|
class PromoteReplica(base.Command):
|
|
"""Promotes Cloud SQL read replica to a stand-alone instance."""
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
"""Args is called by calliope to gather arguments for this command.
|
|
|
|
Args:
|
|
parser: An argparse parser that you can use to add arguments that go
|
|
on the command line after this command. Positional arguments are
|
|
allowed.
|
|
"""
|
|
base.ASYNC_FLAG.AddToParser(parser)
|
|
parser.add_argument(
|
|
'replica',
|
|
completer=flags.InstanceCompleter,
|
|
help='Cloud SQL read replica ID.')
|
|
flags.AddFailoverFlag(parser)
|
|
|
|
def Run(self, args):
|
|
"""Promotes Cloud SQL read replica to a stand-alone instance.
|
|
|
|
Args:
|
|
args: argparse.Namespace, The arguments that this command was invoked
|
|
with.
|
|
|
|
Returns:
|
|
A dict object representing the operations resource describing the
|
|
promote-replica operation if the promote-replica was successful.
|
|
"""
|
|
client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
|
|
sql_client = client.sql_client
|
|
sql_messages = client.sql_messages
|
|
|
|
validate.ValidateInstanceName(args.replica)
|
|
instance_ref = client.resource_parser.Parse(
|
|
args.replica,
|
|
params={'project': properties.VALUES.core.project.GetOrFail},
|
|
collection='sql.instances')
|
|
|
|
instance_resource = sql_client.instances.Get(
|
|
sql_messages.SqlInstancesGetRequest(
|
|
project=instance_ref.project, instance=instance_ref.instance))
|
|
|
|
if instances.InstancesV1Beta4.IsMysqlDatabaseVersion(
|
|
instance_resource.databaseVersion):
|
|
database_type_fragment = 'mysql'
|
|
elif instances.InstancesV1Beta4.IsPostgresDatabaseVersion(
|
|
instance_resource.databaseVersion):
|
|
database_type_fragment = 'postgres'
|
|
else:
|
|
# TODO(b/144067325): currently the link below goes to extremely
|
|
# database-specific instructions to query the replication lag, so in case
|
|
# we (...somehow...) end up here for a db other than mysql or postgres,
|
|
# it's probably better to show nothing than to link to misleading info.
|
|
# Once the metrics are made uniform in b/144067325, then we could default
|
|
# to something here as we'd be giving the same instructions for all dbs
|
|
# anyway.
|
|
database_type_fragment = None
|
|
promote_replica_docs_link = None
|
|
if database_type_fragment:
|
|
promote_replica_docs_link = (
|
|
'Learn more:\n' +
|
|
'https://cloud.google.com/sql/docs/{}/replication/manage-replicas#promote-replica\n\n'
|
|
.format(database_type_fragment))
|
|
|
|
# Format the message ourselves here rather than supplying it as part of the
|
|
# 'message' to PromptContinue. Having the whole paragraph be automatically
|
|
# formatted by PromptContinue would leave it with a line break in the middle
|
|
# of the URL, rendering it unclickable.
|
|
sys.stderr.write(textwrap.TextWrapper().fill(
|
|
'Promoting a read replica stops replication and converts the instance '
|
|
'to a standalone primary instance with read and write capabilities. '
|
|
'This can\'t be undone. To avoid loss of data, before promoting the '
|
|
'replica, you should verify that the replica has applied all '
|
|
'transactions received from the primary.') + '\n\n')
|
|
if promote_replica_docs_link:
|
|
sys.stderr.write(promote_replica_docs_link)
|
|
|
|
console_io.PromptContinue(message='', default=True, cancel_on_no=True)
|
|
|
|
result = sql_client.instances.PromoteReplica(
|
|
sql_messages.SqlInstancesPromoteReplicaRequest(
|
|
project=instance_ref.project, instance=instance_ref.instance,
|
|
failover=args.failover))
|
|
operation_ref = client.resource_parser.Create(
|
|
'sql.operations', operation=result.name, project=instance_ref.project)
|
|
|
|
if args.async_:
|
|
return sql_client.operations.Get(
|
|
sql_messages.SqlOperationsGetRequest(
|
|
project=operation_ref.project, operation=operation_ref.operation))
|
|
|
|
operations.OperationsV1Beta4.WaitForOperation(sql_client, operation_ref,
|
|
'Promoting Cloud SQL replica')
|
|
|
|
log.status.write('Promoted [{instance}].\n'.format(instance=instance_ref))
|