[ 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 -> (строка)
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 -> (целое число)
kmsKeyId -> (строка)
snapshotId -> (строка)
volumeSize -> (целое число)
volumeType -> (строка)
throughput -> (целое число)
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-template-uri (строка)
--platform-override (строка)
Указывает платформу операционной системы при использовании пользовательского базового изображения.
Возможные значения:
WindowsLinuxmacOS
--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 (строка)
--client-token (строка)
--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 -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.