[ aws . elasticbeanstalk ]
create-application-version
Описание
Создаёт версию приложения для указанного приложения. Вы можете создать версию приложения из пакета исходного кода в Amazon S3, коммита в AWS CodeCommit или результата построения AWS CodeBuild следующим образом:
Укажите коммит в репозитории AWS CodeCommit с помощью SourceBuildInformation .
Укажите построение в AWS CodeBuild с помощью SourceBuildInformation и BuildConfiguration .
Укажите пакет исходного кода в S3 с помощью SourceBundle
Опустите оба SourceBuildInformation и SourceBundle, чтобы использовать примерное приложение по умолчанию.
Примечание
После создания версии приложения с указанным расположением ведра и ключа Amazon S3, вы не сможете изменить это расположение Amazon S3. Если вы измените расположение Amazon S3, при попытке запуска среды из версии приложения будет возвращено исключение.См. также: Документация AWS API
Синтаксис
create-application-version
--application-name <value>
--version-label <value>
[--description <value>]
[--source-build-information <value>]
[--source-bundle <value>]
[--build-configuration <value>]
[--auto-create-application | --no-auto-create-application]
[--process | --no-process]
[--tags <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]
Параметры
--application-name (строка)
AutoCreateApplication равно false, возвращается ошибка InvalidParameterValue.--version-label (строка)
Метка, идентифицирующая эту версию.
Ограничение: должна быть уникальной для каждого приложения. Если версия приложения уже существует с этой меткой для указанного приложения, AWS Elastic Beanstalk возвращает ошибку InvalidParameterValue.
--description (строка)
--source-build-information (структура)
Укажите коммит в репозитории Git AWS CodeCommit для использования в качестве исходного кода для версии приложения.
SourceType -> (строка)
Тип репозитория.
GitZip
SourceRepository -> (строка)
Расположение, где хранится репозиторий.
CodeCommitS3
SourceLocation -> (строка)
Расположение исходного кода в формате строки, в зависимости от значения SourceRepository
- Для
CodeCommit, формат — имя репозитория и идентификатор коммита, разделенные слешем. Например,my-git-repo/265cfa0cf6af46153527f55d6503ec030551f57a. - Для
S3, формат — имя ведра S3 и ключ объекта, разделенные слешем. Например,my-s3-bucket/Folders/my-source-file.
Сокращённый синтаксис:
SourceType=string,SourceRepository=string,SourceLocation=string
Синтаксис JSON:
{
"SourceType": "Git"|"Zip",
"SourceRepository": "CodeCommit"|"S3",
"SourceLocation": "string"
}
--source-bundle (структура)
Ведро Amazon S3 и ключ, которые идентифицируют расположение пакета исходного кода для этой версии.
Примечание
Ведро Amazon S3 должно находиться в том же регионе, что и среда.Укажите пакет исходного кода в S3 или коммит в репозитории AWS CodeCommit (с SourceBuildInformation), но не оба. Если ни SourceBundle, ни SourceBuildInformation не заданы, Elastic Beanstalk использует примерное приложение.
S3Bucket -> (строка)
S3Key -> (строка)
Сокращённый синтаксис:
S3Bucket=string,S3Key=string
Синтаксис JSON:
{
"S3Bucket": "string",
"S3Key": "string"
}
--build-configuration (структура)
Настройки для построения AWS CodeBuild.
ArtifactName -> (строка)
CodeBuildServiceRole -> (строка)
ComputeType -> (строка)
Информация о вычислительных ресурсах, которые будет использовать проект построения.
BUILD_GENERAL1_SMALL: Use up to 3 GB memory and 2 vCPUs for buildsBUILD_GENERAL1_MEDIUM: Use up to 7 GB memory and 4 vCPUs for buildsBUILD_GENERAL1_LARGE: Use up to 15 GB memory and 8 vCPUs for builds
Image -> (строка)
TimeoutInMinutes -> (целое число)
Сокращённый синтаксис:
ArtifactName=string,CodeBuildServiceRole=string,ComputeType=string,Image=string,TimeoutInMinutes=integer
Синтаксис JSON:
{
"ArtifactName": "string",
"CodeBuildServiceRole": "string",
"ComputeType": "BUILD_GENERAL1_SMALL"|"BUILD_GENERAL1_MEDIUM"|"BUILD_GENERAL1_LARGE",
"Image": "string",
"TimeoutInMinutes": integer
}
--auto-create-application | --no-auto-create-application (логическое значение)
true, чтобы создать приложение с указанным именем, если оно ещё не существует.--process | --no-process (логическое значение)
Предварительно обрабатывает и проверяет манифест среды (env.yaml) и конфигурационные файлы (файлы *.config в папке .ebextensions) в пакете исходного кода. Проверка конфигурационных файлов может выявить проблемы до развертывания версии приложения в среде.
Обработку необходимо включить для версий приложений, созданных с помощью AWS CodeBuild или AWS CodeCommit. Для версий приложений, созданных из пакета исходного кода в Amazon S3, обработка необязательна.
Примечание
ПараметрProcess проверяет конфигурационные файлы Elastic Beanstalk. Он не проверяет конфигурационные файлы вашего приложения, такие как конфигурация прокси-сервера или Docker.--tags (список)
Указывает теги, применённые к версии приложения.
Elastic Beanstalk применяет эти теги только к версии приложения. Среды, которые используют версию приложения, теги не наследуют.
(структура)
Описывает тег, применённый к ресурсу в среде.
Key -> (строка)
Value -> (строка)
Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--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 (строка)
Регион для использования. Переопределяет настройки config/env.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить вывод цвета.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл с сертификатом CA для использования при проверке сертификатов SSL. Переопределяет настройки config/env.
--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-auto-prompt (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, подобные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Раздел "Использование кавычек с строками" в Руководстве пользователя AWS CLI.
Создание новой версии приложения
Следующая команда создаёт новую версию «v1» приложения с именем «MyApp»:
aws elasticbeanstalk create-application-version --application-name MyApp --version-label v1 --description MyAppv1 --source-bundle S3Bucket="amzn-s3-demo-bucket",S3Key="sample.war" --auto-create-application
Приложение будет создано автоматически, если оно ещё не существует, благодаря опции auto-create-application. Исходный пакет — это файл .war, хранящийся в ведре S3 с именем «amzn-s3-demo-bucket», который содержит примерное приложение Apache Tomcat.
Вывод:
{
"ApplicationVersion": {
"ApplicationName": "MyApp",
"VersionLabel": "v1",
"Description": "MyAppv1",
"DateCreated": "2015-02-03T23:01:25.412Z",
"DateUpdated": "2015-02-03T23:01:25.412Z",
"SourceBundle": {
"S3Bucket": "amzn-s3-demo-bucket",
"S3Key": "sample.war"
}
}
}
Вывод
ApplicationVersion -> (структура)
Описание версии приложения.
ApplicationVersionArn -> (строка)
ApplicationName -> (строка)
Description -> (строка)
VersionLabel -> (строка)
SourceBuildInformation -> (структура)
Если исходный код версии был получен из AWS CodeCommit, расположение исходного кода версии приложения.
SourceType -> (строка)
Тип репозитория.
GitZip
SourceRepository -> (строка)
Местоположение репозитория.
CodeCommitS3
SourceLocation -> (строка)
Расположение исходного кода в виде форматированной строки, зависящей от значения SourceRepository.
- Для
CodeCommitформат — это имя репозитория и идентификатор коммита, разделённые слэшем. Например,my-git-repo/265cfa0cf6af46153527f55d6503ec030551f57a. - Для
S3формат — это имя ведра S3 и ключ объекта, разделённые слэшем. Например,my-s3-bucket/Folders/my-source-file.
BuildArn -> (строка)
SourceBundle -> (структура)
Местоположение исходного пакета версии приложения в Amazon S3.
S3Bucket -> (строка)
S3Key -> (строка)
DateCreated -> (отметка времени)
DateUpdated -> (отметка времени)
Status -> (строка)
Статус обработки версии приложения. Отражает состояние версии приложения во время её создания. Многие значения применимы только если вы указали True для параметра Process действия CreateApplicationVersion. Следующий список описывает возможные значения.
-
Unprocessed– Версия приложения не была предварительно обработана или проверена. Elastic Beanstalk проверит файлы конфигурации во время развертывания версии приложения в среде. -
Processing– Elastic Beanstalk в настоящее время обрабатывает версию приложения. -
Building– Версия приложения в настоящее время проходит сборку в AWS CodeBuild. -
Processed– Elastic Beanstalk успешно прошла предварительную обработку и проверку. -
Failed– Сборка AWS CodeBuild завершилась неудачно или файлы конфигурации не прошли проверку. Эта версия приложения непригодна для использования.
© Copyright 2025, Amazon Web Services. Created using Sphinx.