Spec-Zone.ru › AWS CLI v2

[ aws . imagebuilder ]

создать-контейнер-рецепт

Описание

Создает новый рецепт контейнера. Рецепты контейнеров определяют, как конфигурируются, тестируются и оцениваются изображения.

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

Синтаксис

  create-container-recipe
--container-type <value>
--name <value>
[--description <value>]
--semantic-version <value>
--components <value>
[--instance-configuration <value>]
[--dockerfile-template-data <value>]
[--dockerfile-template-uri <value>]
[--platform-override <value>]
[--image-os-version-override <value>]
--parent-image <value>
[--tags <value>]
[--working-directory <value>]
--target-repository <value>
[--kms-key-id <value>]
[--client-token <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]

Параметры

--container-type (строка)

Тип создаваемого контейнера.

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

  • DOCKER

--name (строка)

Имя рецепта контейнера.

--description (строка)

Описание рецепта контейнера.

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

Семантическая версия рецепта контейнера. Эта версия соответствует синтаксису семантической версии.

Примечание

Семантическая версия имеет четыре узла: <major>.<minor>.<patch>/<build>. Вы можете назначить значения для первых трех и фильтровать по всем им.

Назначение: для первых трех узлов вы можете назначить любое положительное целое значение, включая ноль, с верхним пределом 2^30-1 или 1073741823 для каждого узла. Image Builder автоматически назначает номер сборки четвертому узлу.

Шаблоны: вы можете использовать любой числовой шаблон, который соответствует требованиям назначения для узлов, которые вы можете назначить. Например, вы можете выбрать шаблон версии программного обеспечения, такой как 1.0.0, или дату, такую как 2021.01.01.

--components (список)

Компоненты для сборки и тестирования, которые включены в рецепт контейнера. Рецепты требуют как минимум одного компонента сборки и могут содержать не более 20 компонентов сборки и тестирования в любой комбинации.

(структура)

Подробная информация о конфигурации компонента.

componentArn -> (строка)

Amazon Resource Name (ARN) компонента.

parameters -> (список)

Группа параметров настроек, которые Image Builder использует для конфигурации компонента для определенного рецепта.

(структура)

Содержит пару ключ/значение, которая задает параметр указанного компонента.

name -> (строка)

Имя параметра компонента, который нужно установить.

value -> (список)

Устанавливает значение параметра указанного компонента.

(строка)

Синтаксис JSON:

[
  {
    "componentArn": "string",
    "parameters": [
      {
        "name": "string",
        "value": ["string", ...]
      }
      ...
    ]
  }
  ...
]

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

Группа параметров, которые можно использовать для настройки экземпляра для сборки и тестирования контейнерных изображений.

image -> (строка)

Базовое изображение для экземпляра сборки и тестирования контейнера. Оно может содержать идентификатор AMI или указывать параметр Amazon Web Services Systems Manager (SSM) хранилища параметров, префикс которого ssm:, за которым следует имя параметра или ARN.

Если не указано, Image Builder использует соответствующий оптимизированный для ECS AMI в качестве базового изображения.

blockDeviceMappings -> (список)

Определяет устройства блоков для подключения для создания экземпляра из этого Image Builder AMI.

(структура)

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

deviceName -> (строка)

Устройство, к которому применяются эти сопоставления.

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

Используется для управления конфигурацией, специфичной для Amazon EBS, для этого сопоставления.

encrypted -> (булево)

Используется для конфигурации шифрования устройства.

deleteOnTermination -> (булево)

Используется для конфигурации удаления при завершении работы связанного устройства.

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

Используется для конфигурации IOPS устройства.

kmsKeyId -> (строка)

Используется для конфигурации ключа KMS для использования при шифровании устройства.

snapshotId -> (строка)

Снимок, который определяет содержимое устройства.

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

Используется для переопределения размера тома устройства.

volumeType -> (строка)

Используется для переопределения типа тома устройства.

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

Только для томов GP3 – Пропускная способность в MiB/с, которую поддерживает том.

virtualName -> (строка)

Используется для управления временными устройствами экземпляра.

noDevice -> (строка)

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

Синтаксис JSON:

{
  "image": "string",
  "blockDeviceMappings": [
    {
      "deviceName": "string",
      "ebs": {
        "encrypted": true|false,
        "deleteOnTermination": true|false,
        "iops": integer,
        "kmsKeyId": "string",
        "snapshotId": "string",
        "volumeSize": integer,
        "volumeType": "standard"|"io1"|"io2"|"gp2"|"gp3"|"sc1"|"st1",
        "throughput": integer
      },
      "virtualName": "string",
      "noDevice": "string"
    }
    ...
  ]
}

--dockerfile-template-data (строка)

Шаблон Dockerfile, используемый для построения изображения в виде встроенного блоба данных.

--dockerfile-template-uri (строка)

Amazon S3 URI для Dockerfile, который будет использоваться для построения контейнерного изображения.

--platform-override (строка)

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

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

  • Windows
  • Linux
  • macOS

--image-os-version-override (строка)

Указывает версию операционной системы для базового изображения.

--parent-image (строка)

Базовое изображение для рецепта контейнера.

--tags (карта)

Теги, прикрепленные к рецепту контейнера.

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--working-directory (строка)

Рабочий каталог для использования во время рабочих процессов сборки и тестирования.

--target-repository (структура)

Целевой репозиторий для контейнерного изображения.

service -> (строка)

Указывает службу, в которой было зарегистрировано это изображение.

repositoryName -> (строка)

Имя репозитория контейнеров, где хранится выходное контейнерное изображение. Это имя предваряется расположением репозитория. Например, <repository location url>/repository_name .

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

service=string,repositoryName=string

Синтаксис JSON:

{
  "service": "ECR",
  "repositoryName": "string"
}

--kms-key-id (строка)

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

--client-token (строка)

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы обеспечить идемпотентность запроса. Дополнительную информацию см. в разделе Обеспечение идемпотентности в Справочнике по API Amazon EC2 .

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

Вывод

requestId -> (строка)

Идентификатор запроса, который однозначно идентифицирует этот запрос.

clientToken -> (строка)

Маркер клиента, который однозначно идентифицирует запрос.

containerRecipeArn -> (строка)

Возвращает Amazon Resource Name (ARN) рецепта контейнера, созданного запросом.

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

Spec-Zone.ru

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