update-deployment-group
Описание
Изменяет информацию о группе развертывания.
См. также: Документацию API AWS
Синтаксис
update-deployment-group
--application-name <value>
--current-deployment-group-name <value>
[--new-deployment-group-name <value>]
[--deployment-config-name <value>]
[--ec2-tag-filters <value>]
[--on-premises-instance-tag-filters <value>]
[--auto-scaling-groups <value>]
[--service-role-arn <value>]
[--trigger-configurations <value>]
[--alarm-configuration <value>]
[--auto-rollback-configuration <value>]
[--outdated-instances-strategy <value>]
[--deployment-style <value>]
[--blue-green-deployment-configuration <value>]
[--load-balancer-info <value>]
[--ec2-tag-set <value>]
[--ecs-services <value>]
[--on-premises-tag-set <value>]
[--termination-hook-enabled | --no-termination-hook-enabled]
[--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]
Параметры
--application-name (строка)
--current-deployment-group-name (строка)
--new-deployment-group-name (строка)
--deployment-config-name (строка)
--ec2-tag-filters (список)
Заменяемый набор тегов Amazon EC2, по которым нужно отфильтровать, если вы хотите их изменить. Для сохранения существующих тегов введите их имена. Для удаления тегов не вводите имена тегов.
(структура)
Информация об отфильтровывании тегов EC2.
Ключ -> (строка)
Значение -> (строка)
Тип -> (строка)
Тип фильтра тегов:
-
KEY_ONLY: Только ключ. -
VALUE_ONLY: Только значение. -
KEY_AND_VALUE: Ключ и значение.
Сокращённый синтаксис:
Key=string,Value=string,Type=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string",
"Type": "KEY_ONLY"|"VALUE_ONLY"|"KEY_AND_VALUE"
}
...
]
--on-premises-instance-tag-filters (список)
Заменяемый набор тегов локальных экземпляров, по которым нужно отфильтровать, если вы хотите их изменить. Для сохранения существующих тегов введите их имена. Для удаления тегов не вводите имена тегов.
(структура)
Информация об отфильтровывании тегов локальных экземпляров.
Ключ -> (строка)
Значение -> (строка)
Тип -> (строка)
Тип фильтра тегов локального экземпляра:
- KEY_ONLY: Только ключ.
- VALUE_ONLY: Только значение.
- KEY_AND_VALUE: Ключ и значение.
Сокращённый синтаксис:
Key=string,Value=string,Type=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string",
"Type": "KEY_ONLY"|"VALUE_ONLY"|"KEY_AND_VALUE"
}
...
]
--auto-scaling-groups (список)
Заменяемый список групп Auto Scaling, которые нужно включить в группу развертывания, если вы хотите их изменить.
- Для сохранения групп Auto Scaling введите их имена или не указывайте этот параметр.
- Для удаления групп Auto Scaling укажите список имён групп Auto Scaling, чтобы отсоединить все управляемые CodeDeploy жизненные циклы хуков Auto Scaling. Примеры см. в Руководстве пользователя CodeDeploy, в разделе Amazon EC2 instances in an Amazon EC2 Auto Scaling group fail to launch and receive the error “Heartbeat Timeout”.
(строка)
Синтаксис:
"string" "string" ...
--service-role-arn (строка)
--trigger-configurations (список)
Информация о триггерах для изменения при обновлении группы развертывания. Примеры см. в Руководстве пользователя CodeDeploy, в разделе Edit a Trigger in a CodeDeploy Deployment Group.
(структура)
Информация о триггерах уведомлений для группы развертывания.
triggerName -> (строка)
triggerTargetArn -> (строка)
triggerEvents -> (список)
Тип или типы событий, для которых запускаются уведомления.
(строка)
Сокращённый синтаксис:
triggerName=string,triggerTargetArn=string,triggerEvents=string,string ...
Синтаксис JSON:
[
{
"triggerName": "string",
"triggerTargetArn": "string",
"triggerEvents": ["DeploymentStart"|"DeploymentSuccess"|"DeploymentFailure"|"DeploymentStop"|"DeploymentRollback"|"DeploymentReady"|"InstanceStart"|"InstanceSuccess"|"InstanceFailure"|"InstanceReady", ...]
}
...
]
--alarm-configuration (структура)
Информация для добавления или изменения параметров Amazon CloudWatch при обновлении группы развертывания.
enabled -> (булево)
ignorePollAlarmFailure -> (булево)
Указывает, следует ли продолжить развертывание, если информация о текущем состоянии сигнализации не может быть получена из Amazon CloudWatch. По умолчанию значение равно false.
-
true: Развертывание продолжается, даже если информация о состоянии сигнализации не может быть получена из Amazon CloudWatch. -
false: Развертывание останавливается, если информация о состоянии сигнализации не может быть получена из Amazon CloudWatch.
alarms -> (список)
Список сигналов, настроенных для развертывания или группы развертывания. Максимальное количество сигналов — 10.
(структура)
Информация о сигнале.
name -> (строка)
Сокращённый синтаксис:
enabled=boolean,ignorePollAlarmFailure=boolean,alarms=[{name=string},{name=string}]
Синтаксис JSON:
{
"enabled": true|false,
"ignorePollAlarmFailure": true|false,
"alarms": [
{
"name": "string"
}
...
]
}
--auto-rollback-configuration (структура)
Информация для автоматической отката, которая добавляется или изменяется при обновлении группы развертывания.
enabled -> (булево)
events -> (список)
Тип или типы событий, которые запускают откат.
(строка)
Сокращённый синтаксис:
enabled=boolean,events=string,string
Синтаксис JSON:
{
"enabled": true|false,
"events": ["DEPLOYMENT_FAILURE"|"DEPLOYMENT_STOP_ON_ALARM"|"DEPLOYMENT_STOP_ON_REQUEST", ...]
}
--outdated-instances-strategy (строка)
Указывает, что происходит, когда новые экземпляры Amazon EC2 запускаются во время развертывания и не получают развернутую версию приложения.
Если этот параметр установлен на UPDATE или не указан, CodeDeploy запускает одно или несколько развертываний «автоматического обновления устаревших экземпляров», чтобы применить развернутую версию приложения к новым экземплярам Amazon EC2.
Если этот параметр установлен на IGNORE , CodeDeploy не запускает развертывание для обновления новых экземпляров Amazon EC2. Это может привести к тому, что на экземплярах будут разные версии.
Возможные значения:
UPDATEIGNORE
--deployment-style (структура)
Информация о типе развертывания (локальном или blue/green) и о том, следует ли маршрутизировать трафик развертывания через балансировщик нагрузки.
deploymentType -> (строка)
deploymentOption -> (строка)
Сокращённый синтаксис:
deploymentType=string,deploymentOption=string
Синтаксис JSON:
{
"deploymentType": "IN_PLACE"|"BLUE_GREEN",
"deploymentOption": "WITH_TRAFFIC_CONTROL"|"WITHOUT_TRAFFIC_CONTROL"
}
--blue-green-deployment-configuration (структура)
Информация о параметрах развертывания blue/green для группы развертывания.
terminateBlueInstancesOnDeploymentSuccess -> (структура)
Информация о том, следует ли завершать экземпляры в исходном флоте во время развертывания blue/green.
action -> (строка)
Действие, которое нужно выполнить с экземплярами в исходной среде после успешного развертывания blue/green.
-
TERMINATE: Экземпляры завершаются после указанного периода ожидания. -
KEEP_ALIVE: Экземпляры остаются работающими после их от регистрации из балансировщика нагрузки и удаления из группы развертывания.
terminationWaitTimeInMinutes -> (целое число)
Для развертывания Amazon EC2 количество минут, которое нужно подождать после успешного развертывания blue/green, прежде чем завершать экземпляры из исходной среды.
Для развертывания Amazon ECS количество минут, которое нужно подождать перед удалением исходного (синего) набора задач. Во время развертывания Amazon ECS CodeDeploy переключает трафик с исходного (синего) набора задач на новый (зелёный) набор задач.
Максимальное значение — 2880 минут (2 дня).
deploymentReadyOption -> (структура)
Информация о действии, которое следует выполнить, когда новые экземпляры готовы принимать трафик при развертывании blue/green.
actionOnTimeout -> (строка)
Информация о том, когда следует перенаправить трафик из исходной среды в заменяющую среду при развертывании blue/green.
- CONTINUE_DEPLOYMENT: Немедленно зарегистрировать новые экземпляры в балансировщике нагрузки после установки новой версии приложения на экземпляры в заменяющей среде.
- STOP_DEPLOYMENT: Не регистрировать новые экземпляры в балансировщике нагрузки, пока вручную не будет начато перенаправление трафика с помощью ContinueDeployment . Если перенаправление трафика не будет запущено до истечения заданного периода ожидания, статус развертывания изменится на Stopped.
waitTimeInMinutes -> (целое число)
STOP_DEPLOYMENT для actionOnTimeout .greenFleetProvisioningOption -> (структура)
Информация о том, как развертываются экземпляры для заменяющей среды при развертывании blue/green.
action -> (строка)
Метод добавления экземпляров в заменяющую среду.
-
DISCOVER_EXISTING: Использовать экземпляры, которые уже существуют или будут созданы вручную. -
COPY_AUTO_SCALING_GROUP: Использовать настройки из указанной группы Auto Scaling для определения и создания экземпляров в новой группе Auto Scaling.
Сокращённый синтаксис:
terminateBlueInstancesOnDeploymentSuccess={action=string,terminationWaitTimeInMinutes=integer},deploymentReadyOption={actionOnTimeout=string,waitTimeInMinutes=integer},greenFleetProvisioningOption={action=string}
Синтаксис JSON:
{
"terminateBlueInstancesOnDeploymentSuccess": {
"action": "TERMINATE"|"KEEP_ALIVE",
"terminationWaitTimeInMinutes": integer
},
"deploymentReadyOption": {
"actionOnTimeout": "CONTINUE_DEPLOYMENT"|"STOP_DEPLOYMENT",
"waitTimeInMinutes": integer
},
"greenFleetProvisioningOption": {
"action": "DISCOVER_EXISTING"|"COPY_AUTO_SCALING_GROUP"
}
}
--load-balancer-info (структура)
Информация о балансировщике нагрузки, используемом в развертывании.
elbInfoList -> (список)
Массив, содержащий информацию о балансировщиках нагрузки, используемых для балансировки нагрузки в развертывании. Если вы используете классические балансировщики нагрузки, укажите их в этом массиве.
Примечание
Вы можете добавить до 10 балансировщиков нагрузки в массив.Примечание
Если вы используете балансировщики приложений или сетевые балансировщики, используйте массивtargetGroupInfoList вместо этого.(структура)
Информация о классическом балансировщике нагрузки в Elastic Load Balancing для использования в развертывании. В рамках данного способа экземпляры регистрируются непосредственно у балансировщика, и трафик направляется к балансировщику.
name -> (строка)
targetGroupInfoList -> (список)
Массив, содержащий информацию о целевых группах для использования в балансировке нагрузки в развертывании. Если вы используете балансировщики приложений и сетевые балансировщики, укажите их связанные целевые группы в этом массиве.
Примечание
Вы можете добавить до 10 целевых групп в массив.Примечание
Если вы используете классические балансировщики нагрузки, используйте массивelbInfoList вместо этого.(структура)
Информация о целевой группе в Elastic Load Balancing для использования в развертывании. Экземпляры регистрируются как цели в целевой группе, и трафик направляется к целевой группе.
name -> (строка)
targetGroupPairInfoList -> (список)
Информация о паре целевых групп. Это массив объектов TargeGroupPairInfo с максимальным размером один.
(структура)
Информация о двух целевых группах и о том, как трафик направляется во время развертывания Amazon ECS. Можно указать необязательный маршрут тестового трафика.
targetGroups -> (список)
Одна пара целевых групп. Одна связана с исходным набором задач. Вторая связана с набором задач, обслуживающим трафик после завершения развертывания.
(структура)
Информация о целевой группе в Elastic Load Balancing для использования в развертывании. Экземпляры регистрируются как цели в целевой группе, и трафик направляется к целевой группе.
name -> (строка)
prodTrafficRoute -> (структура)
Маршрут, используемый балансировщиком для перенаправления производственного трафика по завершении развертывания Amazon ECS.
listenerArns -> (список)
Идентификатор ресурса Amazon (ARN) одного слушателя. Слушатель определяет маршрут между целевой группой и балансировщиком нагрузки. Это массив строк с максимальным размером один.
(строка)
testTrafficRoute -> (структура)
Необязательный маршрут, используемый балансировщиком для перенаправления тестового трафика после развертывания Amazon ECS. Валидация может выполняться, пока тестовый трафик обслуживается во время развертывания.
listenerArns -> (список)
Идентификатор ресурса Amazon (ARN) одного слушателя. Слушатель определяет маршрут между целевой группой и балансировщиком нагрузки. Это массив строк с максимальным размером один.
(строка)
Синтаксис JSON:
{
"elbInfoList": [
{
"name": "string"
}
...
],
"targetGroupInfoList": [
{
"name": "string"
}
...
],
"targetGroupPairInfoList": [
{
"targetGroups": [
{
"name": "string"
}
...
],
"prodTrafficRoute": {
"listenerArns": ["string", ...]
},
"testTrafficRoute": {
"listenerArns": ["string", ...]
}
}
...
]
}
--ec2-tag-set (структура)
Информация о группах тегов, примененных к локальным экземплярам. Группа развертываний включает только экземпляры Amazon EC2, идентифицированные всеми группами тегов.
ec2TagSetList -> (список)
Список, содержащий другие списки групп тегов экземпляров Amazon EC2. Для включения экземпляра в группу развертываний он должен быть идентифицирован всеми группами тегов в списке.
(список)
(структура)
Информация о фильтре тегов EC2.
Key -> (строка)
Value -> (строка)
Type -> (строка)
Тип фильтра тегов:
-
KEY_ONLY: Только ключ. -
VALUE_ONLY: Только значение. -
KEY_AND_VALUE: Ключ и значение.
Синтаксис JSON:
{
"ec2TagSetList": [
[
{
"Key": "string",
"Value": "string",
"Type": "KEY_ONLY"|"VALUE_ONLY"|"KEY_AND_VALUE"
}
...
]
...
]
}
--ecs-services (список)
Целевые службы Amazon ECS в группе развертывания. Это относится только к группам развертываний, использующим платформу вычислений Amazon ECS. Целевая служба Amazon ECS указывается как пара имени кластера и службы Amazon ECS в формате <clustername>:<servicename>.
(структура)
Содержит имена службы и кластера, используемые для идентификации целевого объекта развертывания Amazon ECS.
serviceName -> (строка)
clusterName -> (строка)
Сокращенный синтаксис:
serviceName=string,clusterName=string ...
Синтаксис JSON:
[
{
"serviceName": "string",
"clusterName": "string"
}
...
]
--on-premises-tag-set (структура)
Информация о наборе тегов экземпляра локального сервера. Группа развертываний включает только локальные экземпляры, идентифицированные всеми группами тегов.
onPremisesTagSetList -> (список)
Список, содержащий другие списки групп тегов экземпляров локального сервера. Для включения экземпляра в группу развертываний он должен быть идентифицирован всеми группами тегов в списке.
(список)
(структура)
Информация о фильтре тегов экземпляра локального сервера.
Key -> (строка)
Value -> (строка)
Type -> (строка)
Тип фильтра тегов экземпляра локального сервера:
- KEY_ONLY: Только ключ.
- VALUE_ONLY: Только значение.
- KEY_AND_VALUE: Ключ и значение.
Синтаксис JSON:
{
"onPremisesTagSetList": [
[
{
"Key": "string",
"Value": "string",
"Type": "KEY_ONLY"|"VALUE_ONLY"|"KEY_AND_VALUE"
}
...
]
...
]
}
--termination-hook-enabled | --no-termination-hook-enabled (булево)
Этот параметр применим только при использовании CodeDeploy с Amazon EC2 Auto Scaling. Дополнительную информацию см. в разделе «Интеграция CodeDeploy с Amazon EC2 Auto Scaling» в руководстве пользователя CodeDeploy.
Установите terminationHookEnabled в значение true, чтобы CodeDeploy установил обработчик завершения в вашей группе Auto Scaling при обновлении группы развертывания. При установке этого обработчика CodeDeploy выполнит развертывания завершения.
Дополнительную информацию о развертываниях завершения см. в разделе «Включение развертываний завершения во время событий масштабирования Auto Scaling» в руководстве пользователя CodeDeploy.
Дополнительную информацию об событиях масштабирования Auto Scaling см. в разделе «Масштабирование» в руководстве пользователя Amazon EC2 Auto Scaling.
--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 (boolean)
Включить отладку логирования.
--endpoint-url (string)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один запрос для первой страницы результатов.
--output (string)
Стиль форматирования вывода команд.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использование определенного профиля из файла учетных данных.
--region (string)
Используемый регион. Переопределяет настройки из конфигурации/окружения.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл с набором CA-сертификатов для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/окружения.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (boolean)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Изменение информации о группе развертывания
Следующий update-deployment-group пример изменяет настройки группы развертывания, связанной с указанным приложением.
aws deploy update-deployment-group \
--application-name WordPress_App \
--auto-scaling-groups My_CodeDeployDemo_ASG \
--current-deployment-group-name WordPress_DG \
--deployment-config-name CodeDeployDefault.AllAtOnce \
--ec2-tag-filters Key=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo \
--new-deployment-group-name My_WordPress_DepGroup \
--service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2
Эта команда не производит вывод.
Вывод
hooksNotCleanedUp -> (список)
Если вывод не содержит данных, и соответствующая группа развертывания содержала по крайней мере одну группу Auto Scaling, CodeDeploy успешно удалил все соответствующие жизненно важные события Auto Scaling из учетной записи Amazon Web Services. Если вывод содержит данные, CodeDeploy не смог удалить некоторые жизненно важные события Auto Scaling из учетной записи Amazon Web Services.
(структура)
Информация о группе Auto Scaling.
name -> (строка)
hook -> (строка)
Имя запускаемого крючка, который CodeDeploy установил в группе Auto Scaling.
Дополнительную информацию о запускаемом крючке см. в разделе Как Amazon EC2 Auto Scaling работает с CodeDeploy в руководстве пользователя CodeDeploy.
terminationHook -> (строка)
Имя крючка завершения, который CodeDeploy установил в группе Auto Scaling.
Дополнительную информацию о крючке завершения см. в разделе Включение развертываний завершения во время событий масштабирования Auto Scaling в руководстве пользователя CodeDeploy.
© Copyright 2025, Amazon Web Services. Created using Sphinx.