create-stack

Описание

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

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

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

Синтаксис

  create-stack
--name <value>
[--vpc-id <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]
[--use-opsworks-security-groups | --no-use-opsworks-security-groups]
[--custom-cookbooks-source <value>]
[--default-ssh-key-name <value>]
[--default-root-device-type <value>]
[--agent-version <value>]
--stack-region <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]

Параметры

--name (строка)

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

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

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

Если ваш аккаунт поддерживает EC2-Classic, значение по умолчанию — no VPC.
Если ваш аккаунт не поддерживает EC2-Classic, значение по умолчанию — стандартная VPC для указанного региона.

Если идентификатор VPC соответствует стандартной VPC и вы указали только параметр DefaultAvailabilityZone или только параметр DefaultSubnetId, OpsWorks Stacks выведет значение другого параметра. Если вы не указали ни один из этих параметров, OpsWorks Stacks установит эти параметры на первую доступную зону доступности для указанного региона и соответствующий идентификатор подсети стандартной VPC.

Если вы указали идентификатор нестандартной VPC, обратите внимание на следующее:

Он должен принадлежать VPC в вашем аккаунте, находящейся в указанном регионе.
Вы должны указать значение для DefaultSubnetId.

Дополнительную информацию о работе OpsWorks Stacks с VPC см. в разделе Запуск стека в VPC. Дополнительную информацию о стандартной VPC и EC2-Classic см. в разделе Поддерживаемые платформы.

--attributes (отображение)

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

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

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

Краткая синтаксическая запись:

  KeyName1=string,KeyName2=string

Where valid key names are:
  Color

Синтаксис JSON:

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

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

IAM-роль стека, которая позволяет OpsWorks Stacks работать с ресурсами Amazon Web Services от вашего имени. Вы должны установить этот параметр на Amazon Resource Name (ARN) существующей IAM-роли. Дополнительную информацию об IAM ARN см. в разделе Использование идентификаторов.

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

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

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

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

--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 (строка)

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

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

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

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

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

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

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

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

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

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

Название. Этот параметр должен быть установлен в значение Chef.

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

Версия Chef. Этот параметр должен быть установлен в значение 12, 11.10 или 11.4 для стеков Linux и 12.2 для стеков Windows. Значение по умолчанию для стеков 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 (логическое значение)

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

--use-opsworks-security-groups | --no-use-opsworks-security-groups (логическое значение)

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

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

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

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

--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 установит открытый ключ на экземпляре, и вы сможете использовать закрытый ключ с клиентом SSH для входа в экземпляр. Дополнительную информацию см. в разделе Использование SSH для связи с экземпляром и Управление доступом SSH. Вы можете переопределить это значение, указав другую пару ключей или отсутствие пары ключей при создании экземпляра.

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

Тип устройства корневого тома по умолчанию. Это значение является значением по умолчанию для всех экземпляров в стеке, но вы можете переопределить его при создании экземпляра. Значение по умолчанию — instance-store.

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

ebs
instance-store

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

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

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

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

Примечание

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

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

Регион Amazon Web Services стека, например, ap-south-1. Дополнительную информацию о регионах Amazon Web Services см. в разделе Регионы и конечные точки .

Примечание

В CLI этот API соответствует параметру --stack-region. Если параметр --stack-region и общий параметр CLI --region установлены в одно и то же значение, стек использует региональный конечный пункт. Если параметр --stack-region не установлен, но параметр CLI --region установлен, это также приводит к созданию стека с региональным конечным пунктом. Однако, если параметр --region установлен на us-east-1, а параметр --stack-region установлен на одно из следующих значений, то стек использует устаревший или классический регион: us-west-1, us-west-2, sa-east-1, eu-central-1, eu-west-1, ap-northeast-1, ap-southeast-1, ap-southeast-2. В этом случае фактический конечный пункт API стека находится в us-east-1. Только указанные выше регионы поддерживаются в качестве классических регионов в конечном пункте API us-east-1. Поскольку рекомендуется выбирать региональный конечный пункт, наиболее близкий к месту управления Amazon Web Services, мы рекомендуем использовать региональные конечные пункты для новых стеков. Общий параметр CLI --region всегда указывает региональный конечный пункт API; он не может использоваться для указания классического региона OpsWorks Stacks.

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

Примеры

Примечание

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

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

Создание стека

Следующая команда create-stack создает стек с именем CLI Stack.

aws opsworks create-stack --name "CLI Stack" --stack-region "us-east-1" --service-role-arn arn:aws:iam::123456789012:role/aws-opsworks-service-role --default-instance-profile-arn arn:aws:iam::123456789012:instance-profile/aws-opsworks-ec2-role --region us-east-1

Параметры service-role-arn и default-instance-profile-arn являются обязательными. Обычно вы используете те, которые AWS OpsWorks создаёт для вас при создании первого стека. Чтобы получить Amazon Resource Names (ARN) для вашей учетной записи, перейдите в консоль IAM, выберите Roles в навигационном меню, выберите роль или профиль и вкладку Summary.

Вывод:

{
  "StackId": "f6673d70-32e6-4425-8999-265dd002fec7"
}

Дополнительная информация

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

Вывод

StackId -> (строка)

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