update-stack

Описание

Обновляет указанный стек.

Требуемые разрешения : Для использования этого действия пользователь IAM должен иметь уровень разрешений «Управление стеком» или прикреплённую политику, которая явно предоставляет разрешения. Дополнительную информацию о разрешениях пользователей см. в разделе Управление разрешениями пользователей .

См. также: AWS API Documentation

Синтаксис

  update-stack
--stack-id <value>
[--name <value>]
[--attributes <value>]
[--service-role-arn <value>]
[--default-instance-profile-arn <value>]
[--default-os <value>]
[--hostname-theme <value>]
[--default-availability-zone <value>]
[--default-subnet-id <value>]
[--custom-json <value>]
[--configuration-manager <value>]
[--chef-configuration <value>]
[--use-custom-cookbooks | --no-use-custom-cookbooks]
[--custom-cookbooks-source <value>]
[--default-ssh-key-name <value>]
[--default-root-device-type <value>]
[--use-opsworks-security-groups | --no-use-opsworks-security-groups]
[--agent-version <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]

Параметры

--stack-id (строка)

Идентификатор стека.

--name (строка)

Новое имя стека. Имена стеков могут содержать не более 64 символов.

--attributes (словарь)

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

ключ -> (строка)

значение -> (строка)

Сокращенная форма записи:

  KeyName1=string,KeyName2=string

Where valid key names are:
  Color

Формат JSON:

{"Color": "string"
  ...}

--service-role-arn (строка)

Не используйте этот параметр. Вы не можете обновить роль службы стека.

--default-instance-profile-arn (строка)

ARN профиля IAM, который является профилем по умолчанию для всех EC2-инстансов стека. Дополнительную информацию об ARN IAM см. в разделе Использование идентификаторов.

--default-os (строка)

Операционная система стека, которая должна быть установлена в одно из следующих значений:

Поддерживаемая операционная система Linux: версия Amazon Linux, например Amazon Linux 2 , Amazon Linux 2018.03 , Amazon Linux 2017.09 , Amazon Linux 2017.03 , Amazon Linux 2016.09 , Amazon Linux 2016.03 , Amazon Linux 2015.09 или Amazon Linux 2015.03 .
Поддерживаемая операционная система Ubuntu, например Ubuntu 18.04 LTS , Ubuntu 16.04 LTS , Ubuntu 14.04 LTS или Ubuntu 12.04 LTS .
CentOS Linux 7
Red Hat Enterprise Linux 7
Поддерживаемая операционная система Windows, например Microsoft Windows Server 2012 R2 Base , Microsoft Windows Server 2012 R2 with SQL Server Express , Microsoft Windows Server 2012 R2 with SQL Server Standard или Microsoft Windows Server 2012 R2 with SQL Server Web .
Пользовательский AMI: Custom . Вы указываете нужный пользовательский AMI при создании инстансов. Дополнительную информацию о том, как использовать пользовательские AMI с OpsWorks, см. в разделе Использование пользовательских AMI.

По умолчанию используется текущая операционная система стека. Не все операционные системы поддерживаются всеми версиями Chef. Дополнительную информацию о поддерживаемых операционных системах см. в разделе Операционные системы стеков OpsWorks.

--hostname-theme (строка)

Новая тема имени хоста стека, в которой пробелы заменены символами подчеркивания. Тема используется для генерации имен хостов для инстансов стека. По умолчанию HostnameTheme устанавливается в Layer_Dependent, что создает имена хостов путем добавления целых чисел к короткому имени уровня. Другие темы:

Baked_Goods
Clouds
Europe_Cities
Fruits
Greek_Deities_and_Titans
Legendary_creatures_from_Japan
Planets_and_Moons
Roman_Deities
Scottish_Islands
US_Cities
Wild_Cats

Чтобы получить сгенерированное имя хоста, вызовите GetHostNameSuggestion, которая возвращает имя хоста на основе текущей темы.

--default-availability-zone (строка)

Указанный по умолчанию Availability Zone стека, который должен находиться в регионе стека. Дополнительная информация приведена в разделе Регионы и конечные точки. Если вы также указали значение для DefaultSubnetId, подсеть должна находиться в той же зоне. Дополнительная информация приведена в разделе CreateStack.

--default-subnet-id (строка)

Идентификатор подсети VPC по умолчанию для стека. Этот параметр требуется, если вы указали значение для параметра VpcId. Все инстансы запускаются в этой подсети, если не указано иное при создании инстанса. Если вы также указали значение для параметра DefaultAvailabilityZone, подсеть должна находиться в этой зоне. Дополнительная информация о значениях по умолчанию и когда этот параметр требуется, приведена в описании параметра VpcId.

--custom-json (строка)

Строка, содержащая пользовательские данные в формате JSON. Она может использоваться для переопределения соответствующих значений конфигурации стека по умолчанию в формате JSON или для передачи данных в рецепты. Строка должна быть в следующем формате:

"{\"key1\": \"value1\", \"key2\": \"value2\",...}"

Дополнительную информацию о пользовательском JSON см. в разделе Использование пользовательского JSON для изменения атрибутов конфигурации стека.

--configuration-manager (структура)

Менеджер конфигурации. При обновлении стека рекомендуется использовать менеджер конфигурации для указания версии Chef: 12, 11.10 или 11.4 для стеков Linux или 12.2 для стеков Windows. По умолчанию для стеков Linux сейчас используется 12.

Имя -> (строка)

Имя. Этот параметр должен быть установлен в Chef.

Версия -> (строка)

Версия Chef. Для стеков Linux этот параметр должен быть установлен в 12, 11.10 или 11.4, а для стеков Windows — в 12.2. Значение по умолчанию для стеков Linux — 12.

Сокращенная форма записи:

Name=string,Version=string

Формат JSON:

{
  "Name": "string",
  "Version": "string"
}

--chef-configuration (структура)

Объект ChefConfiguration, который указывает, следует ли включить Berkshelf и версию Berkshelf в стеках Chef 11.10. Дополнительная информация приведена в разделе Создание нового стека.

ManageBerkshelf -> (булево)

Включить Berkshelf.

BerkshelfVersion -> (строка)

Версия Berkshelf.

Сокращенная форма записи:

ManageBerkshelf=boolean,BerkshelfVersion=string

Формат JSON:

{
  "ManageBerkshelf": true|false,
  "BerkshelfVersion": "string"
}

--use-custom-cookbooks | --no-use-custom-cookbooks (булево)

Использует ли стек пользовательские кулинарные книги.

--custom-cookbooks-source (структура)

Содержит информацию, необходимую для получения приложения или кулинарной книги из репозитория. Дополнительная информация приведена в разделе Добавление приложений или кулинарных книг и рецептов.

Тип -> (строка)

Тип репозитория.

Url -> (строка)

URL источника. Например, URL источника Amazon S3: https://s3.amazonaws.com/opsworks-demo-bucket/opsworks_cookbook_demo.tar.gz.

Имя пользователя -> (строка)

Этот параметр зависит от типа репозитория.

Для наборов Amazon S3 установите Username в соответствующий идентификатор ключа доступа IAM.
Для наборов HTTP, репозиториев Git и Subversion, установите Username в имя пользователя.

Пароль -> (строка)

Если этот параметр включен в запросе, он зависит от типа репозитория.

Для наборов Amazon S3 установите Password в соответствующий секретный ключ доступа IAM.
Для наборов HTTP и репозиториев Subversion, установите Password в пароль.

Дополнительную информацию о безопасном обращении с учетными данными IAM см. по адресу https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html.

В ответах OpsWorks Stacks возвращает *****FILTERED***** вместо фактического значения.

SshKey -> (строка)

В запросах — SSH-ключ репозитория.

В ответах OpsWorks Stacks возвращает *****FILTERED***** вместо фактического значения.

Ревизия -> (строка)

Версия приложения. OpsWorks Stacks позволяет легко развертывать новые версии приложения. Один из самых простых подходов — использование ветвей или ревизий в вашем репозитории, которые представляют собой различные версии, которые потенциально могут быть развернуты.

Сокращенная форма записи:

Type=string,Url=string,Username=string,Password=string,SshKey=string,Revision=string

Формат JSON:

{
  "Type": "git"|"svn"|"archive"|"s3",
  "Url": "string",
  "Username": "string",
  "Password": "string",
  "SshKey": "string",
  "Revision": "string"
}

--default-ssh-key-name (строка)

Имя пары ключей Amazon EC2 по умолчанию. Значение по умолчанию — none. Если вы укажете имя пары ключей, OpsWorks Stacks установит открытый ключ на инстансе, и вы сможете использовать закрытый ключ с SSH-клиентом для входа в инстанс. Дополнительную информацию см. в разделах Использование SSH для связи с инстансом и Управление доступом SSH. Вы можете переопределить это значение, указав другую пару ключей или не указывая никакой пары ключей при создании инстанса.

--default-root-device-type (строка)

Тип устройства корневого тома по умолчанию. Это значение используется по умолчанию для всех инстансов в стеке, но вы можете переопределить его при создании инстанса. Дополнительная информация приведена в разделе Хранилище для устройства корня.

Возможные значения:

ebs
instance-store

--use-opsworks-security-groups | --no-use-opsworks-security-groups (булево)

Связывать ли встроенные группы безопасности OpsWorks Stacks со слоями стека.

OpsWorks Stacks предоставляет стандартный набор встроенных групп безопасности, по одной на каждый уровень, которые по умолчанию связаны со слоями. UseOpsworksSecurityGroups позволяет указать собственные пользовательские группы безопасности вместо использования встроенных групп. UseOpsworksSecurityGroups имеет следующие параметры:

True — OpsWorks Stacks автоматически связывает соответствующую встроенную группу безопасности с каждым уровнем (параметр по умолчанию). Вы можете связать дополнительные группы безопасности с уровнем после его создания, но не можете удалить встроенную группу безопасности.
False — OpsWorks Stacks не связывает встроенные группы безопасности со слоями. Вам необходимо создать соответствующие группы безопасности EC2 и связать группу безопасности с каждым созданным уровнем. Однако вы по-прежнему можете вручную связать встроенную группу безопасности со слоем. Пользовательские группы безопасности требуются только для тех уровней, которым необходимы настраиваемые параметры.

Дополнительную информацию см. в разделе Создание нового стека.

--agent-version (строка)

Версия агента OpsWorks Stacks по умолчанию. У вас есть следующие варианты:

Автоматическое обновление — установите этот параметр в значение LATEST. OpsWorks Stacks автоматически устанавливает новые версии агента на инстансы стека, как только они появятся.
Фиксированная версия — установите этот параметр в предпочтительную версию агента. Чтобы обновить версию агента, необходимо изменить конфигурацию стека и указать новую версию. OpsWorks Stacks установит эту версию на инстансы стека.

Значение по умолчанию — LATEST. Чтобы указать версию агента, необходимо использовать полное число версии, а не сокращенное число, отображаемое на консоли. Список доступных номеров версий агента см. в вызове DescribeAgentVersions. AgentVersion не может быть установлен на Chef 12.2.

Примечание

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

--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
text
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

--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.

Вывод

Нет