create-deployment-config
Описание
Создаёт конфигурацию развертывания.
См. также: Документация AWS API
Синтаксис
create-deployment-config
--deployment-config-name <value>
[--minimum-healthy-hosts <value>]
[--traffic-routing-config <value>]
[--compute-platform <value>]
[--zonal-config <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]
Параметры
--deployment-config-name (строка)
--minimum-healthy-hosts (структура)
Минимальное количество работоспособных экземпляров, которые должны быть доступны в любое время во время развертывания. Ожидаются два параметра: тип и значение.
Параметр типа принимает одно из следующих значений:
- HOST_COUNT: Параметр значения представляет минимальное количество работоспособных экземпляров как абсолютное значение.
- FLEET_PERCENT: Параметр значения представляет минимальное количество работоспособных экземпляров как процент от общего количества экземпляров в развертывании. Если вы укажете FLEET_PERCENT, в начале развертывания CodeDeploy преобразует процент в эквивалентное количество экземпляров и округляет дробные экземпляры вверх.
Параметр значения принимает целое число.
Например, чтобы установить минимум 95% работоспособных экземпляров, укажите тип FLEET_PERCENT и значение 95.
type -> (строка)
Тип минимального работоспособного экземпляра:
-
HOST_COUNT: Минимальное количество работоспособных экземпляров как абсолютное значение. -
FLEET_PERCENT: Минимальное количество работоспособных экземпляров как процент от общего количества экземпляров в развертывании.
В примере с девятью экземплярами, если указан HOST_COUNT 6, развертывание происходит до трёх экземпляров за раз. Развертывание завершается успешно, если 6 или более экземпляров развернуты успешно. В противном случае развертывание завершается неудачно. Если указан FLEET_PERCENT 40, развертывание происходит до пяти экземпляров за раз. Развертывание завершается успешно, если 4 или более экземпляров развернуты успешно. В противном случае развертывание завершается неудачно.
Примечание
При вызовеGetDeploymentConfig, CodeDeployDefault.OneAtATime возвращает минимальный тип работоспособных экземпляров MOST_CONCURRENCY и значение 1. Это означает развертывание только на один экземпляр за раз. (Вы не можете установить тип MOST_CONCURRENCY, только HOST_COUNT или FLEET_PERCENT.) Кроме того, с CodeDeployDefault.OneAtATime CodeDeploy пытается гарантировать, что все экземпляры, кроме одного, сохраняются в работоспособном состоянии во время развертывания. Хотя это позволяет одному экземпляру за раз выводиться из строя для нового развертывания, это также означает, что если развертывание на последний экземпляр завершается неудачно, общее развертывание всё равно считается успешным.Для получения дополнительной информации см. Здоровье экземпляров CodeDeploy в руководстве пользователя CodeDeploy.
value -> (целое число)
Сокращённый синтаксис:
type=string,value=integer
Синтаксис JSON:
{
"type": "HOST_COUNT"|"FLEET_PERCENT",
"value": integer
}
--traffic-routing-config (структура)
Конфигурация, которая определяет, как маршрутизируется трафик развертывания.
type -> (строка)
TimeBasedCanary или TimeBasedLinear) используемый конфигурацией развертывания.timeBasedCanary -> (структура)
Конфигурация, которая переключает трафик с одной версии функции Lambda или набора задач ECS на другую в двух этапах. Исходные и целевые версии функции Lambda или наборы задач ECS указаны в файле AppSpec развертывания.
canaryPercentage -> (целое число)
TimeBasedCanary.canaryInterval -> (целое число)
TimeBasedCanary.timeBasedLinear -> (структура)
Конфигурация, которая переключает трафик с одной версии функции Lambda или набора задач Amazon ECS на другую с равными приращениями, с равным количеством минут между каждым приращением. Исходные и целевые версии функции Lambda или наборы задач Amazon ECS указаны в файле AppSpec развертывания.
linearPercentage -> (целое число)
TimeBasedLinear.linearInterval -> (целое число)
TimeBasedLinear.Сокращённый синтаксис:
type=string,timeBasedCanary={canaryPercentage=integer,canaryInterval=integer},timeBasedLinear={linearPercentage=integer,linearInterval=integer}
Синтаксис JSON:
{
"type": "TimeBasedCanary"|"TimeBasedLinear"|"AllAtOnce",
"timeBasedCanary": {
"canaryPercentage": integer,
"canaryInterval": integer
},
"timeBasedLinear": {
"linearPercentage": integer,
"linearInterval": integer
}
}
--compute-platform (строка)
Тип целевой платформы для развертывания (Lambda, Server или ECS).
Возможные значения:
ServerLambdaECS
--zonal-config (структура)
Настройте объект ZonalConfig, если хотите, чтобы CodeDeploy развернул ваше приложение в одной зоне доступности за раз в регионе Amazon Web Services.
Дополнительную информацию о функции конфигурации зон см. в руководстве пользователя CodeDeploy.
firstZoneMonitorDurationInSeconds -> (длинное)
Период времени в секундах, который CodeDeploy должен подождать после завершения развертывания в первой зоне доступности. CodeDeploy подождёт это количество времени, прежде чем начать развертывание во вторую зону доступности. Вы можете установить этот параметр, чтобы обеспечить дополнительное время для «прогрева» первой зоны доступности. Если вы не укажете значение для firstZoneMonitorDurationInSeconds, CodeDeploy использует значение monitorDurationInSeconds для первой зоны доступности.
Дополнительную информацию о функции конфигурации зон см. в руководстве пользователя CodeDeploy.
monitorDurationInSeconds -> (длинное)
Период времени в секундах, который CodeDeploy должен подождать после завершения развертывания в зоне доступности. CodeDeploy подождёт это количество времени, прежде чем начать развертывание в следующую зону доступности. Подумайте о добавлении времени мониторинга, чтобы дать развертыванию некоторое время для доказательства себя (или «прогрева») в одной зоне доступности, прежде чем оно будет выпущено в следующей. Если вы не укажете monitorDurationInSeconds, CodeDeploy начнёт развертывание в следующей зоне доступности немедленно.
Дополнительную информацию о функции конфигурации зон см. в руководстве пользователя CodeDeploy.
minimumHealthyHostsPerZone -> (структура)
Количество или процент экземпляров, которые должны оставаться доступными в каждой зоне доступности во время развертывания. Этот параметр работает в сочетании с параметром MinimumHealthyHosts. Дополнительную информацию см. в разделе «О минимальном количестве работоспособных хостов в каждой зоне доступности» в руководстве пользователя CodeDeploy.
Если вы не укажете параметр minimumHealthyHostsPerZone, CodeDeploy использует значение по умолчанию - 0 процентов.
Дополнительную информацию о функции конфигурации зон см. в руководстве пользователя CodeDeploy.
type -> (строка)
type, связанная с параметром MinimumHealthyHostsPerZone.value -> (целое число)
value, связанная с параметром MinimumHealthyHostsPerZone.Сокращённый синтаксис:
firstZoneMonitorDurationInSeconds=long,monitorDurationInSeconds=long,minimumHealthyHostsPerZone={type=string,value=integer}
Синтаксис JSON:
{
"firstZoneMonitorDurationInSeconds": long,
"monitorDurationInSeconds": long,
"minimumHealthyHostsPerZone": {
"type": "HOST_COUNT"|"FLEET_PERCENT",
"value": integer
}
}
--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.
Создание пользовательской конфигурации развертывания
Следующий create-deployment-config пример создает пользовательскую конфигурацию развертывания и связывает её с учетной записью AWS пользователя.
aws deploy create-deployment-config \
--deployment-config-name ThreeQuartersHealthy \
--minimum-healthy-hosts type=FLEET_PERCENT,value=75
Вывод:
{
"deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
Вывод
deploymentConfigId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.