Spec-Zone.ru › AWS CLI v2

[ aws . opsworks ]

создание-слоя

Описание

Создаёт слой. Для получения дополнительной информации, ознакомьтесь с разделом Как создать слой .

Примечание

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

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

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

Синтаксис

  create-layer
--stack-id <value>
--type <value>
--name <value>
--shortname <value>
[--attributes <value>]
[--cloud-watch-logs-configuration <value>]
[--custom-instance-profile-arn <value>]
[--custom-json <value>]
[--custom-security-group-ids <value>]
[--packages <value>]
[--volume-configurations <value>]
[--enable-auto-healing | --no-enable-auto-healing]
[--auto-assign-elastic-ips | --no-auto-assign-elastic-ips]
[--auto-assign-public-ips | --no-auto-assign-public-ips]
[--custom-recipes <value>]
[--install-updates-on-boot | --no-install-updates-on-boot]
[--use-ebs-optimized-instances | --no-use-ebs-optimized-instances]
[--lifecycle-event-configuration <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 (строка)

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

--type (строка)

Тип слоя. Стек не может содержать более одного встроенного слоя одного типа. Он может содержать любое количество пользовательских слоев. Встроенные слои недоступны в стеках Chef 12.

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

  • aws-flow-ruby
  • ecs-cluster
  • java-app
  • lb
  • web
  • php-app
  • rails-app
  • nodejs-app
  • memcached
  • db-master
  • monitoring-master
  • custom

--name (строка)

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

--shortname (строка)

Только для пользовательских слоев, используйте этот параметр для указания короткого имени слоя, используемого внутри стеков OpsWorks и рецептами Chef. Короткое имя также используется в качестве имени каталога, где устанавливаются ваши файлы приложения. Оно может содержать не более 32 символов, ограниченных алфавитно-цифровыми символами, ‘-’, ‘_’ и ‘.’.

Короткие имена встроенных слоев определяются стеками OpsWorks. Для получения дополнительной информации см. Справочник по слоям.

--attributes (массив)

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

Чтобы создать слой кластера, установите атрибут EcsClusterArn на ARN кластера.

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

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

Краткая синтаксическая конструкция:

  KeyName1=string,KeyName2=string

Where valid key names are:
  EcsClusterArn
  EnableHaproxyStats
  HaproxyStatsUrl
  HaproxyStatsUser
  HaproxyStatsPassword
  HaproxyHealthCheckUrl
  HaproxyHealthCheckMethod
  MysqlRootPassword
  MysqlRootPasswordUbiquitous
  GangliaUrl
  GangliaUser
  GangliaPassword
  MemcachedMemory
  NodejsVersion
  RubyVersion
  RubygemsVersion
  ManageBundler
  BundlerVersion
  RailsStack
  PassengerVersion
  Jvm
  JvmVersion
  JvmOptions
  JavaAppServer
  JavaAppServerVersion

Синтаксис JSON:

{"EcsClusterArn"|"EnableHaproxyStats"|"HaproxyStatsUrl"|"HaproxyStatsUser"|"HaproxyStatsPassword"|"HaproxyHealthCheckUrl"|"HaproxyHealthCheckMethod"|"MysqlRootPassword"|"MysqlRootPasswordUbiquitous"|"GangliaUrl"|"GangliaUser"|"GangliaPassword"|"MemcachedMemory"|"NodejsVersion"|"RubyVersion"|"RubygemsVersion"|"ManageBundler"|"BundlerVersion"|"RailsStack"|"PassengerVersion"|"Jvm"|"JvmVersion"|"JvmOptions"|"JavaAppServer"|"JavaAppServerVersion": "string"
  ...}

--cloud-watch-logs-configuration (структура)

Указывает параметры конфигурации CloudWatch Logs для слоя. Для получения дополнительной информации см. CloudWatchLogsLogStream.

Enabled -> (булево)

Включено ли CloudWatch Logs для слоя.

LogStreams -> (список)

Список параметров конфигурации для CloudWatch Logs.

(структура)

Описывает конфигурацию CloudWatch Logs для слоя. Для подробной информации о членах этого типа данных см. Справочник по агенту CloudWatch Logs.

LogGroupName -> (строка)

Указывает целевую группу журналов. Группа журналов создается автоматически, если она еще не существует. Имена групп журналов могут иметь длину от 1 до 512 символов. Допустимые символы включают a-z, A-Z, 0-9, ‘_’ (нижнее подчеркивание), ‘-’ (дефис), ‘/’ (слеш) и ‘.’ (точка).

DatetimeFormat -> (строка)

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

TimeZone -> (строка)

Указывает часовой пояс меток времени событий журнала.

File -> (строка)

Указывает файлы журналов, которые необходимо отправлять в CloudWatch Logs.

File может указывать на определенный файл или несколько файлов (используя символы подстановки, такие как /var/log/system.log* ). В CloudWatch Logs отправляется только последний файл, на основе времени изменения файла. Рекомендуется использовать символы подстановки для указания ряда файлов одного типа, таких как access_log.2014-06-01-01 , access_log.2014-06-01-02 и так далее, используя шаблон, подобный access_log.* . Не используйте подстановку для сопоставления нескольких типов файлов, таких как access_log_80 и access_log_443 . Для указания нескольких различных типов файлов добавьте в конфигурационный файл еще одну запись потока журналов, чтобы каждый тип файла журналов хранился в отдельной группе журналов.

Архивированные файлы не поддерживаются.

FileFingerprintLines -> (строка)

Указывает диапазон строк для идентификации файла. Допустимые значения — одно число или два числа, разделенные дефисом, такие как ‘1’, ‘2-5’. Значение по умолчанию — ‘1’, что означает использование первой строки для расчета отпечатка. Строки отпечатков не отправляются в CloudWatch Logs, если все указанные строки недоступны.

MultiLineStartPattern -> (строка)

Указывает шаблон для идентификации начала сообщения журнала.

InitialPosition -> (строка)

Указывает, где начинать чтение данных (начало_файла или конец_файла). По умолчанию — начало_файла. Это значение используется только в том случае, если состояние для этого потока журналов не сохранено.

Encoding -> (строка)

Указывает кодировку файла журнала для корректного чтения файла. По умолчанию — utf_8 . Здесь можно использовать кодировки, поддерживаемые Python codecs.decode().

BufferDuration -> (целое число)

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

BatchCount -> (целое число)

Указывает максимальное количество событий журнала в пакете, до 10000. Значение по умолчанию — 1000.

BatchSize -> (целое число)

Указывает максимальный размер событий журнала в пакете в байтах, до 1048576 байт. Значение по умолчанию — 32768 байт. Этот размер рассчитывается как сумма всех сообщений событий в UTF-8 плюс 26 байт для каждого события журнала.

Краткая синтаксическая конструкция:

Enabled=boolean,LogStreams=[{LogGroupName=string,DatetimeFormat=string,TimeZone=string,File=string,FileFingerprintLines=string,MultiLineStartPattern=string,InitialPosition=string,Encoding=string,BufferDuration=integer,BatchCount=integer,BatchSize=integer},{LogGroupName=string,DatetimeFormat=string,TimeZone=string,File=string,FileFingerprintLines=string,MultiLineStartPattern=string,InitialPosition=string,Encoding=string,BufferDuration=integer,BatchCount=integer,BatchSize=integer}]

Синтаксис JSON:

{
  "Enabled": true|false,
  "LogStreams": [
    {
      "LogGroupName": "string",
      "DatetimeFormat": "string",
      "TimeZone": "LOCAL"|"UTC",
      "File": "string",
      "FileFingerprintLines": "string",
      "MultiLineStartPattern": "string",
      "InitialPosition": "start_of_file"|"end_of_file",
      "Encoding": "ascii"|"big5"|"big5hkscs"|"cp037"|"cp424"|"cp437"|"cp500"|"cp720"|"cp737"|"cp775"|"cp850"|"cp852"|"cp855"|"cp856"|"cp857"|"cp858"|"cp860"|"cp861"|"cp862"|"cp863"|"cp864"|"cp865"|"cp866"|"cp869"|"cp874"|"cp875"|"cp932"|"cp949"|"cp950"|"cp1006"|"cp1026"|"cp1140"|"cp1250"|"cp1251"|"cp1252"|"cp1253"|"cp1254"|"cp1255"|"cp1256"|"cp1257"|"cp1258"|"euc_jp"|"euc_jis_2004"|"euc_jisx0213"|"euc_kr"|"gb2312"|"gbk"|"gb18030"|"hz"|"iso2022_jp"|"iso2022_jp_1"|"iso2022_jp_2"|"iso2022_jp_2004"|"iso2022_jp_3"|"iso2022_jp_ext"|"iso2022_kr"|"latin_1"|"iso8859_2"|"iso8859_3"|"iso8859_4"|"iso8859_5"|"iso8859_6"|"iso8859_7"|"iso8859_8"|"iso8859_9"|"iso8859_10"|"iso8859_13"|"iso8859_14"|"iso8859_15"|"iso8859_16"|"johab"|"koi8_r"|"koi8_u"|"mac_cyrillic"|"mac_greek"|"mac_iceland"|"mac_latin2"|"mac_roman"|"mac_turkish"|"ptcp154"|"shift_jis"|"shift_jis_2004"|"shift_jisx0213"|"utf_32"|"utf_32_be"|"utf_32_le"|"utf_16"|"utf_16_be"|"utf_16_le"|"utf_7"|"utf_8"|"utf_8_sig",
      "BufferDuration": integer,
      "BatchCount": integer,
      "BatchSize": integer
    }
    ...
  ]
}

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

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

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

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

--custom-security-group-ids (список)

Массив, содержащий идентификаторы пользовательских групп безопасности слоя.

(строка)

Синтаксис:

"string" "string" ...

--packages (список)

Массив объектов Package, описывающих пакеты слоя.

(строка)

Синтаксис:

"string" "string" ...

--volume-configurations (список)

Объект VolumeConfigurations, описывающий тома Amazon EBS слоя.

(структура)

Описывает конфигурацию тома Amazon EBS.

MountPoint -> (строка)

Точка монтирования тома. Например, “/dev/sdh”.

RaidLevel -> (целое число)

Уровень RAID тома.

NumberOfDisks -> (целое число)

Количество дисков в томе.

Size -> (целое число)

Размер тома.

VolumeType -> (строка)

Тип тома. Дополнительную информацию см. в разделе Типы томов Amazon EBS.

  • standard - Магнитный. Магнитные тома должны иметь минимальный размер 1 ГБ и максимальный размер 1024 ГБ.
  • io1 - Provisioned IOPS (SSD). Тома PIOPS должны иметь минимальный размер 4 ГБ и максимальный размер 16384 ГБ.
  • gp2 - Общего назначения (SSD). Тома общего назначения должны иметь минимальный размер 1 ГБ и максимальный размер 16384 ГБ.
  • st1 - Жесткий диск с высокой пропускной способностью (HDD). Тома HDD с высокой пропускной способностью должны иметь минимальный размер 125 ГБ и максимальный размер 16384 ГБ.
  • sc1 - Жесткий диск с низкой пропускной способностью. Тома HDD с низкой пропускной способностью должны иметь минимальный размер 125 ГБ и максимальный размер 16384 ГБ.

Iops -> (целое число)

Для томов PIOPS — IOPS на диск.

Encrypted -> (булево)

Указывает, зашифрован ли том Amazon EBS. Дополнительную информацию см. в разделе Шифрование Amazon EBS.

Краткая синтаксическая конструкция:

MountPoint=string,RaidLevel=integer,NumberOfDisks=integer,Size=integer,VolumeType=string,Iops=integer,Encrypted=boolean ...

Синтаксис JSON:

[
  {
    "MountPoint": "string",
    "RaidLevel": integer,
    "NumberOfDisks": integer,
    "Size": integer,
    "VolumeType": "string",
    "Iops": integer,
    "Encrypted": true|false
  }
  ...
]

--enable-auto-healing | --no-enable-auto-healing (булево)

Отключить автоматическое исправление для слоя.

--auto-assign-elastic-ips | --no-auto-assign-elastic-ips (булево)

Автоматически назначить Elastic IP-адрес инстансам слоя. Дополнительную информацию см. в разделе Как изменить слой.

--auto-assign-public-ips | --no-auto-assign-public-ips (булево)

Для стеков, работающих в VPC, автоматически назначить публичный IP-адрес инстансам слоя. Дополнительную информацию см. в разделе Как изменить слой.

--custom-recipes (структура)

Объект LayerCustomRecipes, который определяет пользовательские рецепты слоя.

Setup -> (список)

Массив имен пользовательских рецептов, которые необходимо выполнить после события setup.

(строка)

Configure -> (список)

Массив имен пользовательских рецептов, которые необходимо выполнить после события configure.

(строка)

Deploy -> (список)

Массив имен пользовательских рецептов, которые необходимо выполнить после события deploy.

(строка)

Undeploy -> (список)

Массив имен пользовательских рецептов, которые необходимо выполнить после события undeploy.

(строка)

Shutdown -> (список)

Массив имен пользовательских рецептов, которые необходимо выполнить после события shutdown.

(строка)

Краткая синтаксическая конструкция:

Setup=string,string,Configure=string,string,Deploy=string,string,Undeploy=string,string,Shutdown=string,string

Синтаксис JSON:

{
  "Setup": ["string", ...],
  "Configure": ["string", ...],
  "Deploy": ["string", ...],
  "Undeploy": ["string", ...],
  "Shutdown": ["string", ...]
}

--install-updates-on-boot | --no-install-updates-on-boot (булево)

Устанавливать ли обновления операционной системы и пакетов при загрузке инстанса. Значение по умолчанию — true. Для управления установкой обновлений установите это значение в false. Затем необходимо вручную обновить ваши инстансы, используя команду создания развертывания для выполнения команды стека update_dependencies или вручную выполнив yum (Amazon Linux) или apt-get (Ubuntu) на инстансах.

Примечание

Для обеспечения наличия последних обновлений безопасности настоятельно рекомендуется использовать значение по умолчанию — true.

--use-ebs-optimized-instances | --no-use-ebs-optimized-instances (булево)

Использовать инстансы с оптимизацией Amazon EBS.

--lifecycle-event-configuration (структура)

Объект LifeCycleEventConfiguration, который можно использовать для конфигурации события Shutdown, чтобы указать таймаут выполнения и включить или отключить сброс соединений Elastic Load Balancer.

Shutdown -> (структура)

Объект ShutdownEventConfiguration, который определяет конфигурацию события Shutdown.

ExecutionTimeout -> (целое число)

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

DelayUntilElbConnectionsDrained -> (булево)

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

Краткая синтаксическая конструкция:

Shutdown={ExecutionTimeout=integer,DelayUntilElbConnectionsDrained=boolean}

Синтаксис JSON:

{
  "Shutdown": {
    "ExecutionTimeout": integer,
    "DelayUntilElbConnectionsDrained": true|false
  }
}

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

--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-layer команда создает слой PHP App Server под именем MyPHPLayer в заданном стеке.

aws opsworks create-layer --region us-east-1 --stack-id f6673d70-32e6-4425-8999-265dd002fec7 --type php-app --name MyPHPLayer --shortname myphplayer

Вывод:

{
  "LayerId": "0b212672-6b4b-40e4-8a34-5a943cf2e07a"
}

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

Для получения дополнительной информации см. раздел Как создать слой в руководстве пользователя AWS OpsWorks.

Вывод

LayerId -> (строка)

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

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API