clone-stack

Описание

Создает клон указанного стека. Дополнительную информацию см. в разделе Clone a Stack . По умолчанию все параметры устанавливаются в значения, используемые родительским стеком.

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

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

Синтаксис

  clone-stack
--source-stack-id <value>
[--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>]
[--clone-permissions | --no-clone-permissions]
[--clone-app-ids <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]

Параметры

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

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

--name (строка)

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

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

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

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

Если идентификатор VPC соответствует стандартной VPC, и вы указали только параметр DefaultAvailabilityZone или DefaultSubnetId, OpsWorks Stacks выведет значение другого параметра. Если вы не укажете ни один из параметров, OpsWorks Stacks установит эти параметры в соответствии с первым доступным Availability Zone для указанного региона и соответствующим идентификатором подсети стандартной 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. Если вы создаете стек с помощью консоли OpsWorks Stacks, роль создается автоматически. Вы можете получить ARN IAM существующего стека программно, вызвав DescribePermissions. Дополнительную информацию об ARN IAM см. в разделе Использование идентификаторов.

Примечание

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

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

Amazon Resource Name (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
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 Stacks.

Примечание

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

--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, подсеть должна находиться в той же зоне. Дополнительная информация — в описании параметра VpcId.

--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. Этот параметр должен быть установлен на 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 имеет следующие настройки:

Истина — OpsWorks Stacks автоматически связывает соответствующую встроенную группу безопасности с каждым слоем (значение по умолчанию). Вы можете связать дополнительные группы безопасности со слоем после его создания, но удалить встроенную группу безопасности нельзя.
Ложь — OpsWorks Stacks не связывает встроенные группы безопасности со слоями. Вы должны создать соответствующие группы безопасности Amazon 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 по умолчанию. Значение по умолчанию — нет. Если вы указываете имя пары ключей, OpsWorks установит открытый ключ на экземпляр, и вы можете использовать закрытый ключ с SSH-клиентом для входа в экземпляр. Дополнительную информацию см. в разделе Использование SSH для взаимодействия с экземпляром и Управление SSH-доступом. Вы можете переопределить эту настройку, указав другую пару ключей или без пары ключей при создании экземпляра.

--clone-permissions | --no-clone-permissions (логическое значение)

Клонировать ли разрешения исходного стека.

--clone-app-ids (список)

Список идентификаторов приложений исходного стека, которые следует включить в клонированный стек.

(строка)

Синтаксис:

"string" "string" ...

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

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

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

ebs
instance-store

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

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

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

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

Примечание

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

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

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

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

Вывод

StackId -> (строка)

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