create-deployment-group
Описание
Создаёт группу развертывания, в которую будут развёртываться новые версии приложения.
См. также: Документация API AWS
Синтаксис
create-deployment-group
--application-name <value>
--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>]
[--tags <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 (строка)
--deployment-group-name (строка)
--deployment-config-name (строка)
Если указано, имя конфигурации развертывания может быть одним из предопределённых конфигураций, предоставляемых CodeDeploy, или пользовательской конфигурацией развертывания, созданной с помощью операции создания конфигурации развертывания.
CodeDeployDefault.OneAtATime — это конфигурация развертывания по умолчанию. Она используется, если конфигурация не указана для развертывания или группы развертывания.Дополнительную информацию о предопределённых конфигурациях развертывания в CodeDeploy см. в разделе Работа с конфигурациями развертывания в CodeDeploy в руководстве пользователя CodeDeploy.
--ec2-tag-filters (список)
Теги Amazon EC2, по которым выполняется фильтрация. В группу развертывания включаются экземпляры Amazon EC2 со всеми указанными тегами. Нельзя использовать в одном вызове с ec2TagSet.
(структура)
Информация о фильтре тегов 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 (список)
Теги на локальных экземплярах, по которым выполняется фильтрация. В группу развертывания включаются локальные экземпляры со всеми указанными тегами. Нельзя использовать в одном вызове с OnPremisesTagSet .
(структура)
Информация о фильтре тегов локальных экземпляров.
Ключ -> (строка)
Значение -> (строка)
Тип -> (строка)
Тип фильтра тегов локального экземпляра:
- 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 (список)
Список связанных групп Amazon EC2 Auto Scaling.
(строка)
Синтаксис:
"string" "string" ...
--service-role-arn (строка)
--trigger-configurations (список)
Информация о триггерах, которые будут созданы при создании группы развертывания. Примеры см. в руководстве пользователя CodeDeploy.
(структура)
Информация о триггерах уведомлений для группы развертывания.
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 Resource Name (ARN) одного слушателя. Слушатель определяет маршрут между целевой группой и балансировщиком нагрузки. Это массив строк с максимальным размером один.
(строка)
testTrafficRoute -> (структура)
Необязательный путь, используемый балансировщиком нагрузки для перенаправления тестового трафика после развертывания Amazon ECS. Валидация может выполняться, пока тестовый трафик обрабатывается во время развертывания.
listenerArns -> (список)
Amazon Resource Name (ARN) одного слушателя. Слушатель определяет маршрут между целевой группой и балансировщиком нагрузки. Это массив строк с максимальным размером один.
(строка)
Синтаксис JSON:
{
"elbInfoList": [
{
"name": "string"
}
...
],
"targetGroupInfoList": [
{
"name": "string"
}
...
],
"targetGroupPairInfoList": [
{
"targetGroups": [
{
"name": "string"
}
...
],
"prodTrafficRoute": {
"listenerArns": ["string", ...]
},
"testTrafficRoute": {
"listenerArns": ["string", ...]
}
}
...
]
}
--ec2-tag-set (структура)
Информация о группах тегов, применяемых к экземплярам Amazon EC2. В группе развертывания содержатся только экземпляры Amazon EC2, идентифицированные всеми группами тегов. Нельзя использовать в одном вызове с ec2TagFilters.
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 (структура)
Информация о группах тегов, примененных к локальным экземплярам. В группе развертывания содержатся только локальные экземпляры, идентифицированные всеми группами тегов. Нельзя использовать в одном вызове с onPremisesInstanceTagFilters.
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"
}
...
]
...
]
}
--tags (список)
Метаданные, которые вы применяете к группам развертывания CodeDeploy для организации и категоризации. Каждый тег состоит из ключа и необязательного значения, которые вы определяете.
(структура)
Информация о теге.
Key -> (строка)
Value -> (строка)
Сокращенный синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--termination-hook-enabled | --no-termination-hook-enabled (логическое значение)
Этот параметр применяется только при использовании CodeDeploy с Amazon EC2 Auto Scaling. Дополнительную информацию см. в руководстве пользователя CodeDeploy — Интеграция CodeDeploy с Amazon EC2 Auto Scaling.
Установите terminationHookEnabled в значение true, чтобы CodeDeploy установил обработчик завершения в вашу группу Auto Scaling при создании группы развертывания. При установке этого обработчика CodeDeploy выполнит развертывания завершения.
Дополнительную информацию о развертываниях завершения см. в руководстве пользователя CodeDeploy — Включение развертываний завершения во время событий масштабирования Auto Scaling.
Дополнительную информацию о событиях масштабирования 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-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическую запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, похожие на Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для создания группы развертывания
Следующий create-deployment-group пример создает группу развертывания и связывает ее со специфицированным приложением и учетной записью AWS пользователя.
aws deploy create-deployment-group \
--application-name WordPress_App \
--auto-scaling-groups CodeDeployDemo-ASG \
--deployment-config-name CodeDeployDefault.OneAtATime \
--deployment-group-name WordPress_DG \
--ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE \
--service-role-arn arn:aws:iam::123456789012:role/CodeDeployDemoRole
Вывод:
{
"deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
Вывод
deploymentGroupId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.