Spec-Zone.ru › AWS CLI v2

[ aws . opsworks ]

create-app

Описание

Создаёт приложение для указанного стека. Дополнительную информацию можно найти в разделе Создание приложений .

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

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

Синтаксис

  create-app
--stack-id <value>
[--shortname <value>]
--name <value>
[--description <value>]
[--data-sources <value>]
--type <value>
[--app-source <value>]
[--domains <value>]
[--enable-ssl | --no-enable-ssl]
[--ssl-configuration <value>]
[--attributes <value>]
[--environment <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 (строка)

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

--shortname (строка)

Короткое имя приложения.

--name (строка)

Имя приложения.

--description (строка)

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

--data-sources (список)

Источник данных приложения.

(структура)

Описывает источник данных приложения.

Тип -> (строка)

Тип источника данных, AutoSelectOpsworksMysqlInstance , OpsworksMysqlInstance , RdsDbInstance или None .

Arn -> (строка)

ARN источника данных.

DatabaseName -> (строка)

Имя базы данных.

Краткая форма:

Type=string,Arn=string,DatabaseName=string ...

Синтаксис JSON:

[
  {
    "Type": "string",
    "Arn": "string",
    "DatabaseName": "string"
  }
  ...
]

--type (строка)

Тип приложения. Каждый поддерживаемый тип связан с определённым слоем. Например, приложения PHP связаны со слоем PHP. OpsWorks Stacks развёртывает приложение на тех экземплярах, которые являются членами соответствующего слоя. Если ваше приложение не относится к стандартным типам или вы предпочитаете реализовывать собственные рецепты развертывания, укажите other .

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

  • aws-flow-ruby
  • java
  • rails
  • php
  • nodejs
  • static
  • other

--app-source (структура)

Объект Source, который задаёт репозиторий приложения.

Тип -> (строка)

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

Url -> (строка)

URL источника. Вот пример URL-адреса источника Amazon S3: https://s3.amazonaws.com/opsworks-demo-bucket/opsworks_cookbook_demo.tar.gz .

Username -> (строка)

Этот параметр зависит от типа репозитория.

  • Для пакетов Amazon S3 укажите Username соответствующий идентификатор ключа доступа IAM.
  • Для пакетов HTTP, репозиториев Git и Subversion, укажите Username имя пользователя.

Password -> (строка)

Если этот параметр включён в запросе, он зависит от типа репозитория.

  • Для пакетов Amazon S3 укажите Password соответствующий секретный ключ доступа IAM.
  • Для пакетов HTTP и репозиториев Subversion укажите Password пароль.

Дополнительную информацию о безопасном обращении с учетными данными IAM см. в https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html .

В ответах OpsWorks Stacks возвращает *****FILTERED***** вместо фактического значения.

SshKey -> (строка)

В запросах – SSH-ключ репозитория.

В ответах OpsWorks Stacks возвращает *****FILTERED***** вместо фактического значения.

Revision -> (строка)

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

Краткая форма:

Type=string,Url=string,Username=string,Password=string,SshKey=string,Revision=string

Синтаксис JSON:

{
  "Type": "git"|"svn"|"archive"|"s3",
  "Url": "string",
  "Username": "string",
  "Password": "string",
  "SshKey": "string",
  "Revision": "string"
}

--domains (список)

Настройки виртуального хоста приложения, с несколькими доменами, разделенными запятыми. Например: 'www.example.com, example.com'

(строка)

Синтаксис:

"string" "string" ...

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

Включить SSL для приложения.

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

Объект SslConfiguration с настройками SSL.

Certificate -> (строка)

Содержимое файла сертификата domain.crt.

PrivateKey -> (строка)

Приватный ключ; содержимое файла сертификата domain.kex.

Chain -> (строка)

Необязательно. Может использоваться для указания промежуточного сертификата авторизации ключа или ключа аутентификации клиента.

Краткая форма:

Certificate=string,PrivateKey=string,Chain=string

Синтаксис JSON:

{
  "Certificate": "string",
  "PrivateKey": "string",
  "Chain": "string"
}

--attributes (словарь)

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

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

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

Краткая форма:

  KeyName1=string,KeyName2=string

Where valid key names are:
  DocumentRoot
  RailsEnv
  AutoBundleOnDeploy
  AwsFlowRubySettings

Синтаксис JSON:

{"DocumentRoot"|"RailsEnv"|"AutoBundleOnDeploy"|"AwsFlowRubySettings": "string"
  ...}

--environment (список)

Массив объектов EnvironmentVariable, которые задают переменные окружения, которые будут связаны с приложением. После развертывания приложения эти переменные определяются на соответствующем экземпляре сервера приложения. Дополнительную информацию можно найти в разделе Переменные окружения .

Нет ограничений на количество переменных окружения. Однако размер связанной структуры данных (включая имена, значения и флаги защиты переменных) не может превышать 20 КБ. Этого должно быть достаточно для большинства, если не для всех, случаев использования. Превышение этого значения приведёт к исключению с сообщением «Environment: слишком большой (максимум 20 КБ)».

Примечание

Если вы указали одну или несколько переменных окружения, вы не можете изменить версию Chef стека.

(структура)

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

Key -> (строка)

(Обязательно) Имя переменной окружения, которое может содержать до 64 символов и должно быть указано. Имя может содержать прописные и строчные буквы, цифры и символы подчеркивания (_), но оно должно начинаться с буквы или символа подчеркивания.

Value -> (строка)

(Необязательно) Значение переменной окружения, которое можно оставить пустым. Если вы укажете значение, оно может содержать до 256 символов, которые должны быть печатными.

Secure -> (булево)

(Необязательно) Возвращается ли значение переменной действием DescribeApps. Чтобы скрыть значение переменной окружения, установите Secure в true . DescribeApps возвращает *****FILTERED***** вместо фактического значения. Значение по умолчанию для Secure равно false .

Краткая форма:

Key=string,Value=string,Secure=boolean ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string",
    "Secure": 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.

Пример 1: Создание приложения

В следующем примере создаётся приложение PHP под названием SimplePHPApp, код которого хранится в репозитории GitHub. Команда использует сокращённую форму определения исходного кода приложения.

aws opsworks create-app \
    --region us-east-1 \
    --stack-id f6673d70-32e6-4425-8999-265dd002fec7 \
    --name SimplePHPApp \
    --type php \
    --app-source Type=git,Url=git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git,Revision=version1

Вывод:

{
    "AppId": "6cf5163c-a951-444f-a8f7-3716be75f2a2"
}

Пример 2: Создание приложения с подключённой базой данных

В следующем примере создаётся JSP-приложение из кода, хранящегося в архиве .zip в общедоступном ведре S3. Он подключает экземпляр базы данных RDS для использования в качестве хранилища данных приложения. Исходные данные приложения и базы данных определены в отдельных файлах JSON, находящихся в каталоге, из которого вы запускаете команду.

aws opsworks create-app \
    --region us-east-1 \
    --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 \
    --name SimpleJSP \
    --type java \
    --app-source file://appsource.json \
    --data-sources file://datasource.json

Информация об исходном коде приложения находится в appsource.json и содержит следующее.

{
    "Type": "archive",
    "Url": "https://s3.amazonaws.com/opsworks-demo-assets/simplejsp.zip"
}

Информация об исходном коде базы данных находится в datasource.json и содержит следующее.

[
    {
        "Type": "RdsDbInstance",
        "Arn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
        "DatabaseName": "mydb"
    }
]

Примечание: Для экземпляра базы данных RDS необходимо сначала использовать register-rds-db-instance для регистрации экземпляра в стеке. Для экземпляров MySQL App Server задайте Type на OpsworksMysqlInstance. Эти экземпляры создаются AWS OpsWorks, поэтому их не нужно регистрировать.

Вывод:

{
    "AppId": "26a61ead-d201-47e3-b55c-2a7c666942f8"
}

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

Вывод

AppId -> (строка)

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

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

Spec-Zone.ru

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