Spec-Zone.ru › AWS CLI v2

[ aws . amplify ]

create-app

Описание

Создает новую приложение Amplify.

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

Синтаксис

  create-app
--name <value>
[--description <value>]
[--repository <value>]
[--platform <value>]
[--compute-role-arn <value>]
[--iam-service-role-arn <value>]
[--oauth-token <value>]
[--access-token <value>]
[--environment-variables <value>]
[--enable-branch-auto-build | --no-enable-branch-auto-build]
[--enable-branch-auto-deletion | --no-enable-branch-auto-deletion]
[--enable-basic-auth | --no-enable-basic-auth]
[--basic-auth-credentials <value>]
[--custom-rules <value>]
[--tags <value>]
[--build-spec <value>]
[--custom-headers <value>]
[--enable-auto-branch-creation | --no-enable-auto-branch-creation]
[--auto-branch-creation-patterns <value>]
[--auto-branch-creation-config <value>]
[--cache-config <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]

Параметры

--name (строка)

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

--description (строка)

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

--repository (строка)

Репозиторий Git для приложения Amplify.

--platform (строка)

Платформа для приложения Amplify. Для статического приложения установите тип платформы в WEB . Для динамического приложения с серверной отрисовкой (SSR) установите тип платформы в WEB_COMPUTE . Для приложения, требующего только исходную поддержку SSR Amplify Hosting, установите тип платформы в WEB_DYNAMIC .

Если вы развертываете только приложение SSG с Next.js версии 14 или выше, вы должны установить тип платформы в WEB_COMPUTE и установить артефакты baseDirectory в .next в настройках сборки приложения. Пример настроек спецификации сборки см. в руководстве пользователя Amplify Hosting в разделе «Настройки сборки Amplify для приложения Next.js 14 SSG».

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

  • WEB
  • WEB_DYNAMIC
  • WEB_COMPUTE

--compute-role-arn (строка)

Идентификатор ресурса Amazon (ARN) роли IAM для назначения приложению SSR. Роль вычислений SSR позволяет службе вычислений Amplify Hosting безопасно получать доступ к определенным ресурсам Amazon Web Services на основе разрешений роли. Дополнительную информацию о роли вычислений SSR см. в руководстве пользователя Amplify в разделе «Добавление роли вычислений SSR».

--iam-service-role-arn (строка)

Идентификатор ресурса Amazon (ARN) роли службы IAM для приложения Amplify.

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

Токен OAuth для системы управления исходным кодом сторонних разработчиков для приложения Amplify. Токен OAuth используется для создания веб-хука и ключа для чтения только для развертывания с использованием SSH-клонирования. Токен OAuth не сохраняется.

Для поставщиков репозиториев, отличных от GitHub, таких как Bitbucket или CodeCommit, используйте oauthToken. Для авторизации доступа к GitHub в качестве поставщика репозитория используйте accessToken.

При создании нового приложения необходимо указать либо oauthToken, либо accessToken.

Существующие приложения Amplify, развернутые из репозитория GitHub с использованием OAuth, по-прежнему работают с CI/CD. Однако мы настоятельно рекомендуем мигрировать эти приложения на использование приложения GitHub. Дополнительную информацию см. в руководстве пользователя Amplify в разделе «Миграция существующего приложения OAuth в приложение Amplify GitHub».

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

Личный токен доступа к репозиторию GitHub для приложения Amplify. Личный токен доступа используется для авторизации доступа к репозиторию GitHub с помощью приложения Amplify GitHub. Токен не сохраняется.

Используйте accessToken только для репозиториев GitHub. Для авторизации доступа к поставщику репозиториев, такому как Bitbucket или CodeCommit, используйте oauthToken.

При создании нового приложения необходимо указать либо accessToken, либо oauthToken.

Существующие приложения Amplify, развернутые из репозитория GitHub с использованием OAuth, по-прежнему работают с CI/CD. Однако мы настоятельно рекомендуем мигрировать эти приложения на использование приложения GitHub. Дополнительную информацию см. в руководстве пользователя Amplify в разделе «Миграция существующего приложения OAuth в приложение Amplify GitHub».

--environment-variables (массив)

Карта переменных окружения для приложения Amplify.

Список переменных окружения, доступных для Amplify по умолчанию, см. в руководстве пользователя Amplify Hosting в разделе «Переменные окружения Amplify».

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

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

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--enable-branch-auto-build | --no-enable-branch-auto-build (логическое)

Включает автоматическую сборку ветвей для приложения Amplify.

--enable-branch-auto-deletion | --no-enable-branch-auto-deletion (логическое)

Автоматически отключает ветвь в консоли Amplify при удалении ветви из вашего репозитория Git.

--enable-basic-auth | --no-enable-basic-auth (логическое)

Включает базовые авторизации для приложения Amplify. Это будет применяться ко всем ветвям, которые являются частью этого приложения.

--basic-auth-credentials (строка)

Данные для базовой авторизации для приложения Amplify. Данные авторизации необходимо закодировать в Base64 и предоставить в формате user:password .

--custom-rules (список)

Настраиваемые правила перенаправления и переписывания для приложения Amplify.

(структура)

Описание настраиваемого правила переписывания или перенаправления.

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

Шаблон источника для правила переписывания или перенаправления URL.

цель -> (строка)

Шаблон назначения для правила переписывания или перенаправления URL.

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

Код состояния для правила переписывания или перенаправления URL.

200

Представляет правило переписывания 200.

301

Представляет правило перенаправления 301 (перемещено постоянно). Все будущие запросы должны направляться на целевой URL.

302

Представляет временное правило перенаправления 302.

404

Представляет правило перенаправления 404.

404-200

Представляет правило переписывания 404.

условие -> (строка)

Условие для правила переписывания или перенаправления URL, например, код страны.

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

source=string,target=string,status=string,condition=string ...

Синтаксис JSON:

[
  {
    "source": "string",
    "target": "string",
    "status": "string",
    "condition": "string"
  }
  ...
]

--tags (массив)

Тег для приложения Amplify.

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

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

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--build-spec (строка)

Спецификация сборки (build spec) для приложения Amplify.

--custom-headers (строка)

Пользовательские HTTP-заголовки для приложения Amplify.

--enable-auto-branch-creation | --no-enable-auto-branch-creation (логическое)

Включает автоматическое создание ветвей для приложения Amplify.

--auto-branch-creation-patterns (список)

Шаблоны glob для автоматического создания ветвей для приложения Amplify.

(строка)

Синтаксис:

"string" "string" ...

--auto-branch-creation-config (структура)

Настройка автоматического создания ветвей для приложения Amplify.

этап -> (строка)

Описание текущего этапа для автоматически созданной ветви.

фреймворк -> (строка)

Фреймворк для автоматически созданной ветви.

включитьАвтоСборку -> (логическое)

Включает автоматическую сборку для автоматически созданной ветви.

переменныеОкружения -> (массив)

Переменные окружения для автоматически созданной ветви.

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

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

credentialsBasicAuth -> (строка)

Данные базовой авторизации для автоматически созданной ветви. Данные авторизации необходимо закодировать в Base64 и предоставить в формате user:password .

включитьBasicAuth -> (логическое)

Включает базовые авторизации для автоматически созданной ветви.

включитьРежимВысокойПроизводительности -> (логическое)

Включает режим высокой производительности для ветви.

Режим высокой производительности оптимизирован для более быстрого времени работы хостинга, сохраняя кэшированный контент на кромке сети в течение более длительного периода. При включенном режиме высокой производительности изменения конфигурации хостинга или кода могут занимать до 10 минут для развертывания.

buildSpec -> (строка)

Спецификация сборки (build spec) для автоматически созданной ветви.

включитьПредварительныйПросмотрPullRequest -> (логическое)

Включает предварительные просмотры pull request для автоматически созданной ветви.

pullRequestEnvironmentName -> (строка)

Имя среды Amplify для pull request.

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

stage=string,framework=string,enableAutoBuild=boolean,environmentVariables={KeyName1=string,KeyName2=string},basicAuthCredentials=string,enableBasicAuth=boolean,enablePerformanceMode=boolean,buildSpec=string,enablePullRequestPreview=boolean,pullRequestEnvironmentName=string

Синтаксис JSON:

{
  "stage": "PRODUCTION"|"BETA"|"DEVELOPMENT"|"EXPERIMENTAL"|"PULL_REQUEST",
  "framework": "string",
  "enableAutoBuild": true|false,
  "environmentVariables": {"string": "string"
    ...},
  "basicAuthCredentials": "string",
  "enableBasicAuth": true|false,
  "enablePerformanceMode": true|false,
  "buildSpec": "string",
  "enablePullRequestPreview": true|false,
  "pullRequestEnvironmentName": "string"
}

--cache-config (структура)

Настройка кэша для приложения Amplify.

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

Тип настройки кэша для использования в приложении Amplify.

Настройка кэша AMPLIFY_MANAGED автоматически применяет оптимизированную настройку кэша для вашего приложения на основе его платформы, правил маршрутизации и правил переписывания. Это значение по умолчанию.

Тип кэша AMPLIFY_MANAGED_NO_COOKIES аналогичен типу AMPLIFY_MANAGED, за исключением того, что из ключа кэша исключены все куки.

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

type=string

Синтаксис JSON:

{
  "type": "AMPLIFY_MANAGED"|"AMPLIFY_MANAGED_NO_COOKIES"
}

--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 (boolean)

Включить отладку регистрации.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Используемый регион. Переопределяет параметры конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--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 (boolean)

Отключить вывод страницы для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

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

Представляет различные ветви репозитория для построения, развертывания и размещения приложения Amplify.

appId -> (строка)

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

appArn -> (строка)

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

name -> (строка)

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

tags -> (массив)

Тег для приложения Amplify.

key -> (строка)

value -> (строка)

description -> (строка)

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

repository -> (строка)

Git-репозиторий для приложения Amplify.

platform -> (строка)

Платформа для приложения Amplify. Для статического приложения установите тип платформы в WEB . Для динамического приложения с серверной отрисовкой (SSR) установите тип платформы в WEB_COMPUTE . Для приложения, требующего исходную поддержку SSR Amplify Hosting, установите тип платформы в WEB_DYNAMIC .

Если вы разворачиваете приложение SSG только с Next.js 14 или более поздней версией, вы должны использовать тип платформы WEB_COMPUTE .

createTime -> (временная метка)

Временная метка создания приложения Amplify.

updateTime -> (временная метка)

Временная метка обновления приложения Amplify.

computeRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM для приложения SSR. Роль Compute позволяет сервису вычислений Amplify Hosting безопасно получать доступ к определенным ресурсам Amazon Web Services на основе разрешений роли. Более подробную информацию о роли Compute SSR см. в разделе «Добавление роли Compute SSR» в руководстве пользователя Amplify.

iamServiceRoleArn -> (строка)

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

environmentVariables -> (массив)

Переменные среды для приложения Amplify.

Список переменных среды, доступных Amplify по умолчанию, см. в руководстве пользователя Amplify Hosting в разделе «Переменные среды Amplify».

key -> (строка)

value -> (строка)

defaultDomain -> (строка)

Домен по умолчанию для приложения Amplify.

enableBranchAutoBuild -> (boolean)

Включает автоматическое построение веток для приложения Amplify.

enableBranchAutoDeletion -> (boolean)

Автоматически отключает ветвь в консоли Amplify, когда вы удаляете ветвь из вашего Git-репозитория.

enableBasicAuth -> (boolean)

Включает базовый аутентификацию для веток приложения Amplify.

basicAuthCredentials -> (строка)

Базовые учетные данные аутентификации для веток приложения Amplify. Вы должны закодировать учетные данные аутентификации в base64 и предоставить их в формате user:password .

customRules -> (список)

Описание настраиваемых правил перенаправления и перезаписи для приложения Amplify.

(структура)

Описание пользовательского правила перезаписи или перенаправления.

source -> (строка)

Шаблон источника для правила перезаписи или перенаправления URL.

target -> (строка)

Шаблон назначения для правила перезаписи или перенаправления URL.

status -> (строка)

Код состояния для правила перезаписи или перенаправления URL.

200

Представляет правило перезаписи 200.

301

Представляет правило перенаправления 301 (постоянно перемещено). Этот и все последующие запросы должны быть направлены на целевой URL.

302

Представляет правило временного перенаправления 302.

404

Представляет правило перенаправления 404.

404-200

Представляет правило перезаписи 404.

condition -> (строка)

Условие для правила перезаписи или перенаправления URL, например, код страны.

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

Описание информации о ветке производства приложения Amplify.

lastDeployTime -> (временная метка)

Последнее время развертывания ветки производства.

status -> (строка)

Статус ветки производства.

thumbnailUrl -> (строка)

URL миниатюры для ветки производства.

branchName -> (строка)

Имя ветки производства.

buildSpec -> (строка)

Описание содержимого спецификации сборки (спецификации сборки) приложения Amplify.

customHeaders -> (строка)

Описание настраиваемых HTTP-заголовков для приложения Amplify.

enableAutoBranchCreation -> (boolean)

Включает автоматическое создание веток для приложения Amplify.

autoBranchCreationPatterns -> (список)

Описание шаблонов создания веток с помощью glob для приложения Amplify.

(строка)

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

Описание конфигурации автоматического создания веток для приложения Amplify.

stage -> (строка)

Описание текущей стадии для автоматически созданной ветки.

framework -> (строка)

Фреймворк для автоматически созданной ветки.

enableAutoBuild -> (boolean)

Включает автоматическое построение для автоматически созданной ветки.

environmentVariables -> (массив)

Переменные среды для автоматически созданной ветки.

key -> (строка)

value -> (строка)

basicAuthCredentials -> (строка)

Учетные данные базовой аутентификации для автоматически созданной ветки. Вы должны закодировать учетные данные аутентификации в base64 и предоставить их в формате user:password.

enableBasicAuth -> (boolean)

Включает базовый аутентификацию для автоматически созданной ветки.

enablePerformanceMode -> (boolean)

Включает режим производительности для ветки.

Режим производительности оптимизирован для более высокой скорости работы хостинга, сохраняя содержимое кэшированным на периферии на более длительный интервал. При включенном режиме производительности внесение изменений в конфигурацию хостинга или в код может занять до 10 минут.

buildSpec -> (строка)

Спецификация сборки (спецификация сборки) для автоматически созданной ветки.

enablePullRequestPreview -> (boolean)

Включает предварительный просмотр запроса на вытягивание для автоматически созданной ветки.

pullRequestEnvironmentName -> (строка)

Имя среды Amplify для запроса на вытягивание.

repositoryCloneMethod -> (строка)

Примечание

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

Сервис Amplify использует этот параметр для указания протокола аутентификации для доступа к Git-репозиторию приложения Amplify. Amplify указывает TOKEN для GitHub-репозитория, SIGV4 для репозитория Amazon Web Services CodeCommit и SSH для репозиториев GitLab и Bitbucket.

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

Конфигурация кэша для приложения Amplify. Если вы не укажете конфигурацию кэша type , Amplify использует значение по умолчанию AMPLIFY_MANAGED .

type -> (строка)

Тип конфигурации кэша для использования с приложением Amplify.

Конфигурация кэша AMPLIFY_MANAGED автоматически применяет оптимизированную конфигурацию кэша для вашего приложения на основе его платформы, правил маршрутизации и правил перезаписи. Это значение по умолчанию.

Тип конфигурации кэша AMPLIFY_MANAGED_NO_COOKIES такой же, как и AMPLIFY_MANAGED, за исключением того, что он исключает все cookie из ключа кэша.

webhookCreateTime -> (временная метка)

Временная метка создания webhook в вашем Git-репозитории.

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

Описание конфигурации брандмауэра для приложения Amplify. Поддержка брандмауэра позволяет защитить ваши размещенные приложения с помощью прямой интеграции с WAF.

webAclArn -> (строка)

Amazon Resource Name (ARN) для web ACL, связанного с приложением Amplify.

wafStatus -> (строка)

Статус процесса привязки или отвязки web ACL к приложению Amplify.

statusReason -> (строка)

Причина текущего статуса конфигурации брандмауэра.

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

Spec-Zone.ru

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