переключение-сине-зеленого-развертывания

Описание

Переключает сине-зеленое развертывание.

Перед переключением трафик производства направляется на базы данных в синем окружении. После переключения трафик производства направляется на базы данных в зеленом окружении.

Дополнительную информацию см. в разделе Использование Amazon RDS сине-зеленых развертываний для обновлений баз данных в Руководстве пользователя Amazon RDS и Использование Amazon RDS сине-зеленых развертываний для обновлений баз данных в Руководстве пользователя Amazon Aurora.

См. также: Документация API AWS

Синтаксис

  switchover-blue-green-deployment
--blue-green-deployment-identifier <value>
[--switchover-timeout <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--blue-green-deployment-identifier (строка)

Идентификатор ресурса сине-зеленого развертывания.

Ограничения:

Должен соответствовать существующему идентификатору ресурса сине-зеленого развертывания.

--switchover-timeout (целое число)

Время в секундах для завершения переключения.

По умолчанию: 300

Если переключение занимает больше указанного времени, все изменения отменяются, и никакие изменения в средах не производятся.

--cli-input-json | --cli-input-yaml (строка) Чтение аргументов из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перепишут значения, предоставленные через JSON. Невозможно передавать произвольные двоичные значения, используя предоставленное значение JSON, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который может использоваться в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, оно выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно валидирует входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладку логгирования.

--endpoint-url (строка)

Переопределяет URL по умолчанию команды на указанный URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого соединения SSL AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

json
текст
таблица
yaml
yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из вашего файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

включить
выключить
авто

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для конфигурированного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить пагинатор CLI для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры входных данных CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическую запрос параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Пример 1: Переключение сине-зеленого развертывания для экземпляра базы данных RDS

Следующий switchover-blue-green-deployment пример продвигает указанную зеленую среду в качестве новой среды производства.

aws rds switchover-blue-green-deployment \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake \
    --switchover-timeout 300

Вывод:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
        "BlueGreenDeploymentName": "bgd-cli-test-instance",
        "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
        "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-k5fv7u",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ggsh8m",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-o2vwm0",
                "Status": "AVAILABLE"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "COMPLETED"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "COMPLETED"
            },
            {
                "Name": "CONFIGURE_BACKUPS",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATING_TOPOLOGY_OF_SOURCE",
                "Status": "COMPLETED"
            }
        ],
        "Status": "SWITCHOVER_IN_PROGRESS",
        "CreateTime": "2022-02-25T22:33:22.225000+00:00"
    }
}

Дополнительную информацию см. в разделе Переключение сине-зеленого развертывания в Руководстве пользователя Amazon RDS.

Пример 2: Продвижение сине-зеленого развертывания для кластера базы данных Aurora MySQL

aws rds switchover-blue-green-deployment \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake \
    --switchover-timeout 300

Вывод:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
        "BlueGreenDeploymentName": "my-blue-green-deployment",
        "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
        "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-bvxc73",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-7wc4ie",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-p4xxkz",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-np1ikl",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-miszlf",
                "Status": "AVAILABLE"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "COMPLETED"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATE_CUSTOM_ENDPOINTS",
                "Status": "COMPLETED"
            }
        ],
        "Status": "SWITCHOVER_IN_PROGRESS",
        "CreateTime": "2022-02-25T22:38:49.522000+00:00"
    }
}

Дополнительную информацию см. в разделе Переключение сине-зеленого развертывания в Руководстве пользователя Amazon Aurora.

Вывод

BlueGreenDeployment -> (структура)

Подробности о развертывании синего/зеленого.

Дополнительную информацию см. в разделе «Использование развертываний Amazon RDS синего/зеленого для обновлений баз данных» в Руководстве пользователя Amazon RDS и в разделе «Использование развертываний Amazon RDS синего/зеленого для обновлений баз данных» в Руководстве пользователя Amazon Aurora.

BlueGreenDeploymentIdentifier -> (строка)

Уникальный идентификатор развертывания синего/зеленого.

BlueGreenDeploymentName -> (строка)

Имя развертывания синего/зеленого, заданное пользователем.

Source -> (строка)

База данных-источник для развертывания синего/зеленого.

Перед переключением база данных-источник является рабочей базой данных в синем окружении.

Target -> (строка)

База данных-цель для развертывания синего/зеленого.

Перед переключением база данных-цель является клонированной базой данных в зеленом окружении.

SwitchoverDetails -> (список)

Подробности о каждом источнике и ресурсе-цели в развертывании синего/зеленого.

(структура)

Содержит подробности о развертывании синего/зеленого.

SourceMember -> (строка)

Amazon Resource Name (ARN) ресурса в синем окружении.

TargetMember -> (строка)

Amazon Resource Name (ARN) ресурса в зеленом окружении.

Status -> (строка)

Статус переключения ресурса в развертывании синего/зеленого.

Значения:

PROVISIONING - Ресурс подготавливается к переключению.
AVAILABLE - Ресурс готов к переключению.
SWITCHOVER_IN_PROGRESS - Ресурс переключается.
SWITCHOVER_COMPLETED - Ресурс переключен.
SWITCHOVER_FAILED - Переключение ресурса завершилось неудачей.
MISSING_SOURCE - Ресурс-источник удален.
MISSING_TARGET - Ресурс-цель удален.

Tasks -> (список)

Задачи, которые необходимо выполнить или которые были выполнены на базе данных-цели перед переключением.

(структура)

Подробности о задаче для развертывания синего/зеленого.

Name -> (строка)

Имя задачи развертывания синего/зеленого.

Status -> (строка)

Статус задачи развертывания синего/зеленого.

Допустимые значения:

PENDING - Ресурс подготавливается к развертыванию.
IN_PROGRESS - Ресурс развертывается.
COMPLETED - Ресурс развернут.
FAILED - Развертывание ресурса завершилось неудачей.

Status -> (строка)

Статус развертывания синего/зеленого.

Допустимые значения:

PROVISIONING - Ресурсы создаются в зеленом окружении.
AVAILABLE - Ресурсы доступны в зеленом окружении.
SWITCHOVER_IN_PROGRESS - Развертывание переключается из синего окружения в зеленое.
SWITCHOVER_COMPLETED - Переключение из синего окружения в зеленое завершено.
INVALID_CONFIGURATION - Ресурсы в зеленом окружении неверны, поэтому переключение невозможно.
SWITCHOVER_FAILED - Попытка переключения завершилась неудачей.
DELETING - Развертывание синего/зеленого удаляется.

StatusDetails -> (строка)

Дополнительная информация о статусе развертывания синего/зеленого.

CreateTime -> (временная метка)

Время создания развертывания синего/зеленого в универсальном координированном времени (UTC).

DeleteTime -> (временная метка)

Время удаления развертывания синего/зеленого в универсальном координированном времени (UTC).

TagList -> (список)

Список тегов.

Дополнительную информацию см. в разделе «Размещение тегов ресурсов Amazon RDS» в Руководстве пользователя Amazon RDS или в разделе «Размещение тегов ресурсов Amazon Aurora и Amazon RDS» в Руководстве пользователя Amazon Aurora.

(структура)

Метаданные, назначенные ресурсу Amazon RDS, состоящие из пары ключ-значение.

Key -> (строка)

Ключ — это обязательное имя тега. Строковое значение может иметь длину от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).

Value -> (строка)

Значение — это необязательное значение тега. Строковое значение может иметь длину от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).