Spec-Zone.ru › AWS CLI v2

[ 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 -> (строка)

Тип репозитория.

  • Git
  • Zip

SourceRepository -> (строка)

Расположение, где хранится репозиторий.

  • CodeCommit
  • S3

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 -> (строка)

Ведро Amazon S3, где хранятся данные.

S3Key -> (строка)

Ключ Amazon S3, где хранятся данные.

Сокращённый синтаксис:

S3Bucket=string,S3Key=string

Синтаксис JSON:

{
  "S3Bucket": "string",
  "S3Key": "string"
}

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

Настройки для построения AWS CodeBuild.

ArtifactName -> (строка)

Имя артефакта построения CodeBuild. Если задано, Elastic Beanstalk сохраняет артефакт построения в расположении S3 S3-bucket /resources/application-name /codebuild/codebuild-version-label -artifact-name .zip. Если не задано, Elastic Beanstalk сохраняет артефакт построения в расположении S3 S3-bucket /resources/application-name /codebuild/codebuild-version-label .zip.

CodeBuildServiceRole -> (строка)

Идентификатор ресурса Amazon (ARN) роли AWS Identity and Access Management (IAM), которая позволяет AWS CodeBuild взаимодействовать с зависимыми службами AWS от имени учетной записи AWS.

ComputeType -> (строка)

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

  • BUILD_GENERAL1_SMALL: Use up to 3 GB memory and 2 vCPUs for builds
  • BUILD_GENERAL1_MEDIUM: Use up to 7 GB memory and 4 vCPUs for builds
  • BUILD_GENERAL1_LARGE: Use up to 15 GB memory and 8 vCPUs for builds

Image -> (строка)

Идентификатор Docker-изображения для использования в этом проекте построения.

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

Время ожидания AWS CodeBuild в минутах (от 5 до 480 (8 часов)), до истечения времени ожидания любого связанного построения, которое не отмечено как завершённое. Значение по умолчанию — 60 минут.

Сокращённый синтаксис:

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 -> (строка)

Amazon Resource Name (ARN) версии приложения.

ApplicationName -> (строка)

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

Description -> (строка)

Описание версии приложения.

VersionLabel -> (строка)

Уникальный идентификатор версии приложения.

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

Если исходный код версии был получен из AWS CodeCommit, расположение исходного кода версии приложения.

SourceType -> (строка)

Тип репозитория.

  • Git
  • Zip

SourceRepository -> (строка)

Местоположение репозитория.

  • CodeCommit
  • S3

SourceLocation -> (строка)

Расположение исходного кода в виде форматированной строки, зависящей от значения SourceRepository.

  • Для CodeCommit формат — это имя репозитория и идентификатор коммита, разделённые слэшем. Например, my-git-repo/265cfa0cf6af46153527f55d6503ec030551f57a.
  • Для S3 формат — это имя ведра S3 и ключ объекта, разделённые слэшем. Например, my-s3-bucket/Folders/my-source-file.

BuildArn -> (строка)

Ссылка на артефакт из сборки AWS CodeBuild.

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

Местоположение исходного пакета версии приложения в Amazon S3.

S3Bucket -> (строка)

Ведро Amazon S3, где находятся данные.

S3Key -> (строка)

Ключ Amazon S3, где находятся данные.

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.

Spec-Zone.ru

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