create-service

Описание

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

Это асинхронная операция. При успешном вызове вы можете использовать возвращаемое значение OperationId и вызов ListOperations для отслеживания прогресса операции.

См. также: AWS API Documentation

Синтаксис

  create-service
--service-name <value>
--source-configuration <value>
[--instance-configuration <value>]
[--tags <value>]
[--encryption-configuration <value>]
[--health-check-configuration <value>]
[--auto-scaling-configuration-arn <value>]
[--network-configuration <value>]
[--observability-configuration <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]

Параметры

--service-name (строка)

Имя службы App Runner. Оно должно быть уникальным для всех работающих служб App Runner в вашей учетной записи Amazon Web Services в регионе Amazon Web Services.

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

Источник для развертывания в службу App Runner. Это может быть репозиторий кода или изображений.

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

Описание репозитория исходного кода.

Вы должны указать либо этот элемент, либо ImageRepository (но не оба).

RepositoryUrl -> (строка)

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

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

Версия, которая должна быть использована в репозитории исходного кода.

Type -> (строка)

Тип идентификатора версии.

Для репозиториев на основе Git ветви представляют версии.

Value -> (строка)

Версия исходного кода.

Для репозиториев на основе Git имя ветки соответствует определенной версии. App Runner использует последний коммит в ветке.

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

Настройка для сборки и запуска службы из репозитория исходного кода.

Примечание

CodeConfiguration требуется только для CreateService запроса.

ConfigurationSource -> (строка)

Источник конфигурации App Runner. Значения интерпретируются следующим образом:

REPOSITORY – App Runner считывает значения конфигурации из файла apprunner.yaml в репозитории исходного кода и игнорирует CodeConfigurationValues .
API – App Runner использует значения конфигурации, предоставленные в CodeConfigurationValues , и игнорирует файл apprunner.yaml в репозитории исходного кода.

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

Базовая конфигурация для сборки и запуска службы App Runner. Используйте ее для быстрого запуска службы App Runner без предоставления файла apprunner.yaml в репозитории исходного кода (или игнорирования файла, если он существует).

Runtime -> (строка)

Тип среды выполнения для сборки и запуска службы App Runner. Он представляет собой среду выполнения языка программирования.

BuildCommand -> (строка)

Команда, которую App Runner выполняет для сборки вашего приложения.

StartCommand -> (строка)

Команда, которую App Runner выполняет для запуска вашего приложения.

Port -> (строка)

Порт, на котором ваше приложение прослушивает в контейнере.

По умолчанию: 8080

RuntimeEnvironmentVariables -> (карта)

Переменные среды, доступные для вашей работающей службы App Runner. Массив пар ключ-значение.

key -> (строка)

value -> (строка)

RuntimeEnvironmentSecrets -> (карта)

Массив пар ключ-значение, представляющих секреты и параметры, которые ссылаются на вашу службу в качестве переменной среды. Поддерживаемые значения — это либо полное Amazon Resource Name (ARN) секрета Secrets Manager, либо полное ARN параметра в хранилище параметров Amazon Web Services Systems Manager.

Примечание

Если параметр хранилища параметров Amazon Web Services Systems Manager существует в том же регионе Amazon Web Services, что и запускаемая служба, вы можете использовать либо полное ARN, либо имя секрета. Если параметр находится в другом регионе, необходимо указать полное ARN.
В настоящее время перекрестная ссылка на параметры хранилища параметров Amazon Web Services Systems Manager в разных учетных записях не поддерживается.

key -> (строка)

value -> (строка)

SourceDirectory -> (строка)

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

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

Описание репозитория исходных изображений.

Вы должны указать либо этот элемент, либо CodeRepository (но не оба).

ImageIdentifier -> (строка)

Идентификатор изображения.

Для изображения в Amazon Elastic Container Registry (Amazon ECR) это имя изображения. Для формата имени изображения см. Вытягивание изображения в руководстве пользователя Amazon ECR.

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

Настройка для запуска идентифицированного изображения.

RuntimeEnvironmentVariables -> (карта)

Переменные среды, доступные для вашей работающей службы App Runner. Массив пар ключ-значение.

key -> (строка)

value -> (строка)

StartCommand -> (строка)

Необязательная команда, которую App Runner выполняет для запуска приложения в исходном изображении. Если указана, эта команда переопределяет команду запуска по умолчанию Docker-изображения.

Port -> (строка)

Порт, на котором ваше приложение прослушивает в контейнере.

По умолчанию: 8080

RuntimeEnvironmentSecrets -> (карта)

Примечание

Если параметр хранилища параметров Amazon Web Services Systems Manager существует в том же регионе Amazon Web Services, что и запускаемая служба, вы можете использовать либо полное ARN, либо имя секрета. Если параметр находится в другом регионе, необходимо указать полное ARN.
В настоящее время перекрестная ссылка на параметры хранилища параметров Amazon Web Services Systems Manager в разных учетных записях не поддерживается.

key -> (строка)

value -> (строка)

ImageRepositoryType -> (строка)

Тип репозитория изображений. Это отражает поставщика репозитория и является ли репозиторий частным или общедоступным.

AutoDeploymentsEnabled -> (булево)

Если true , непрерывная интеграция из репозитория исходного кода включена для службы App Runner. Каждое изменение репозитория (включая любой коммит исходного кода или новую версию изображения) запускает развертывание.

По умолчанию: App Runner устанавливает значение false для исходного изображения, использующего общедоступный репозиторий ECR или репозиторий ECR в другой учетной записи Amazon Web Services, чем та, в которой находится служба. App Runner устанавливает значение true во всех остальных случаях (которые в настоящее время включают репозиторий исходного кода или исходное изображение, использующее репозиторий ECR в той же учетной записи).

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

Описание ресурсов, необходимых для проверки подлинности доступа к некоторым репозиториям исходного кода.

ConnectionArn -> (строка)

Amazon Resource Name (ARN) подключения App Runner, которое позволяет службе App Runner подключаться к репозиторию исходного кода. Требуется для репозиториев кода GitHub.

AccessRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, которая предоставляет службе App Runner доступ к репозиторию исходного кода. Требуется для репозиториев изображений ECR (но не для общедоступных репозиториев ECR).

Синтаксис JSON:

{
  "CodeRepository": {
    "RepositoryUrl": "string",
    "SourceCodeVersion": {
      "Type": "BRANCH",
      "Value": "string"
    },
    "CodeConfiguration": {
      "ConfigurationSource": "REPOSITORY"|"API",
      "CodeConfigurationValues": {
        "Runtime": "PYTHON_3"|"NODEJS_12"|"NODEJS_14"|"CORRETTO_8"|"CORRETTO_11"|"NODEJS_16"|"GO_1"|"DOTNET_6"|"PHP_81"|"RUBY_31"|"PYTHON_311"|"NODEJS_18"|"NODEJS_22",
        "BuildCommand": "string",
        "StartCommand": "string",
        "Port": "string",
        "RuntimeEnvironmentVariables": {"string": "string"
          ...},
        "RuntimeEnvironmentSecrets": {"string": "string"
          ...}
      }
    },
    "SourceDirectory": "string"
  },
  "ImageRepository": {
    "ImageIdentifier": "string",
    "ImageConfiguration": {
      "RuntimeEnvironmentVariables": {"string": "string"
        ...},
      "StartCommand": "string",
      "Port": "string",
      "RuntimeEnvironmentSecrets": {"string": "string"
        ...}
    },
    "ImageRepositoryType": "ECR"|"ECR_PUBLIC"
  },
  "AutoDeploymentsEnabled": true|false,
  "AuthenticationConfiguration": {
    "ConnectionArn": "string",
    "AccessRoleArn": "string"
  }
}

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

Конфигурация времени выполнения экземпляров (масштабируемых единиц) вашей службы.

Cpu -> (строка)

Количество единиц ЦП, зарезервированных для каждого экземпляра вашей службы App Runner.

По умолчанию: 1 vCPU

Memory -> (строка)

Объем памяти в МБ или ГБ, зарезервированный для каждого экземпляра вашей службы App Runner.

По умолчанию: 2 GB

InstanceRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, которая предоставляет разрешения вашей службе App Runner. Это разрешения, которые нужен вашему коду при вызове любых API Amazon Web Services.

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

Cpu=string,Memory=string,InstanceRoleArn=string

Синтаксис JSON:

{
  "Cpu": "string",
  "Memory": "string",
  "InstanceRoleArn": "string"
}

--tags (список)

Необязательный список метаданных, которые вы можете связать с ресурсом службы App Runner. Тег — это пара ключ-значение.

(структура)

Описание тега, примененного к ресурсу App Runner. Тег — это элемент метаданных, состоящий из пары ключ-значение.

Key -> (строка)

Ключ тега.

Value -> (строка)

Значение тега.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

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

Необязательный пользовательский ключ шифрования, который App Runner использует для шифрования копии вашего репозитория исходного кода, который он поддерживает, и ваших журналов службы. По умолчанию App Runner использует управляемый Amazon Web Services ключ.

KmsKey -> (строка)

ARN ключа KMS, используемого для шифрования.

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

KmsKey=string

Синтаксис JSON:

{
  "KmsKey": "string"
}

--health-check-configuration (структура)

Настройки проверки состояния, которые App Runner выполняет для мониторинга состояния службы App Runner.

Protocol -> (строка)

Протокол IP, который App Runner использует для выполнения проверок состояния вашей службы.

Если вы установите Protocol на HTTP , App Runner отправляет запросы проверки состояния на указанный в Path путь HTTP.

По умолчанию: TCP

Path -> (строка)

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

Path применимо только в том случае, если вы устанавливаете Protocol на HTTP .

По умолчанию: "/"

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

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

По умолчанию: 5

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

Время ожидания ответа проверки состояния в секундах до определения его как неудачного.

По умолчанию: 2

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

Количество последовательных проверок, которые должны быть успешными, прежде чем App Runner определит, что служба работает в штатном режиме.

По умолчанию: 1

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

Количество последовательных проверок, которые должны завершиться неудачно, прежде чем App Runner определит, что служба неисправна.

По умолчанию: 5

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

Protocol=string,Path=string,Interval=integer,Timeout=integer,HealthyThreshold=integer,UnhealthyThreshold=integer

Синтаксис JSON:

{
  "Protocol": "TCP"|"HTTP",
  "Path": "string",
  "Interval": integer,
  "Timeout": integer,
  "HealthyThreshold": integer,
  "UnhealthyThreshold": integer
}

--auto-scaling-configuration-arn (строка)

Идентификатор ресурса Amazon (ARN) конфигурации автоматического масштабирования App Runner, которую вы хотите связать со своим сервисом. Если не указано, App Runner связывает последнюю версию конфигурации автоматического масштабирования по умолчанию.

Укажите ARN с именем и номером версии, чтобы связать эту версию. Например: arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/3

Укажите только имя, чтобы связать последнюю версию. Например: arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability

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

Настройки конфигурации, связанные с сетевым трафиком веб-приложения, которое выполняет сервис App Runner.

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

Настройки сетевой конфигурации для исходящего трафика сообщений.

EgressType -> (строка)

Тип конфигурации исходящего трафика.

Установите значение в DEFAULT для доступа к ресурсам, размещённым в общедоступных сетях.

Установите значение в VPC, чтобы связать свой сервис с пользовательской VPC, указанной в VpcConnectorArn.

VpcConnectorArn -> (строка)

Идентификатор ресурса Amazon (ARN) коннектора VPC App Runner, который вы хотите связать со своим сервисом App Runner. Действителен только при EgressType = VPC.

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

Настройки сетевой конфигурации для входящего трафика сообщений.

IsPubliclyAccessible -> (булево)

Указывает, доступен ли ваш сервис App Runner публично. Установите значение в True, чтобы сделать сервис общедоступным. Установите значение в False, чтобы сделать сервис доступным только изнутри Amazon VPC.

IpAddressType -> (строка)

App Runner предоставляет вам возможность выбрать между Internet Protocol версии 4 (IPv4) и двойным стеком (IPv4 и IPv6) для вашей конфигурации входящего общедоступного сетевого трафика. Это необязательный параметр. Если вы не укажете IpAddressType, по умолчанию будет выбран IPv4.

Примечание

В настоящее время App Runner поддерживает двойной стек только для общедоступного конечного пункта. Для частного конечного пункта поддерживается только IPv4. Если вы обновите сервис, использующий двойной стек для общедоступного конечного пункта, до частного конечного пункта, ваш сервис App Runner по умолчанию будет поддерживать только IPv4 для частного конечного пункта и не сможет получать трафик, исходящий от IPv6 конечного пункта.

Сокращенная синтаксическая запись:

EgressConfiguration={EgressType=string,VpcConnectorArn=string},IngressConfiguration={IsPubliclyAccessible=boolean},IpAddressType=string

Синтаксис JSON:

{
  "EgressConfiguration": {
    "EgressType": "DEFAULT"|"VPC",
    "VpcConnectorArn": "string"
  },
  "IngressConfiguration": {
    "IsPubliclyAccessible": true|false
  },
  "IpAddressType": "IPV4"|"DUAL_STACK"
}

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

Настройка наблюдаемости вашего сервиса.

ObservabilityEnabled -> (булево)

При значении true конфигурация наблюдаемости связана со службой, и указан ObservabilityConfigurationArn.

ObservabilityConfigurationArn -> (строка)

Идентификатор ресурса Amazon (ARN) конфигурации наблюдаемости, связанной со службой. Указывается только при значении ObservabilityEnabled, равном true.

Укажите ARN с именем и номером версии, чтобы связать эту версию. Например: arn:aws:apprunner:us-east-1:123456789012:observabilityconfiguration/xray-tracing/3

Укажите только имя, чтобы связать последнюю версию. Например: arn:aws:apprunner:us-east-1:123456789012:observabilityconfiguration/xray-tracing

Сокращенная синтаксическая запись:

ObservabilityEnabled=boolean,ObservabilityConfigurationArn=string

Синтаксис JSON:

{
  "ObservabilityEnabled": true|false,
  "ObservabilityConfigurationArn": "string"
}

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение null или строка 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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. См. руководство по началу работы в Руководстве пользователя AWS CLI для получения дополнительной информации.

Если не указано иное, все примеры используют правила цитирования типа Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Пример 1: Создание сервиса хранилища исходного кода

Следующий create-service пример создает сервис App Runner на основе репозитория исходного кода Python.

aws apprunner create-service \
    --cli-input-json file://input.json

Содержимое input.json:

{
    "ServiceName": "python-app",
    "SourceConfiguration": {
        "AuthenticationConfiguration": {
            "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
        },
        "AutoDeploymentsEnabled": true,
        "CodeRepository": {
            "RepositoryUrl": "https://github.com/my-account/python-hello",
            "SourceCodeVersion": {
                "Type": "BRANCH",
                "Value": "main"
            },
            "CodeConfiguration": {
                "ConfigurationSource": "API",
                "CodeConfigurationValues": {
                    "Runtime": "PYTHON_3",
                    "BuildCommand": "pip install -r requirements.txt",
                    "StartCommand": "python server.py",
                    "Port": "8080",
                    "RuntimeEnvironmentVariables": [
                        {
                            "NAME": "Jane"
                        }
                    ]
                }
            }
        }
    },
    "InstanceConfiguration": {
        "CPU": "1 vCPU",
        "Memory": "3 GB"
    }
}

Вывод:

{
    "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
    "Service": {
        "CreatedAt": "2020-11-20T19:05:25Z",
        "UpdatedAt": "2020-11-20T19:05:25Z",
        "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
        "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
        "ServiceName": "python-app",
        "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
        "SourceConfiguration": {
            "AuthenticationConfiguration": {
                "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
            },
            "AutoDeploymentsEnabled": true,
            "CodeRepository": {
                "CodeConfiguration": {
                    "CodeConfigurationValues": {
                        "BuildCommand": "pip install -r requirements.txt",
                        "Port": "8080",
                        "Runtime": "PYTHON_3",
                        "RuntimeEnvironmentVariables": [
                            {
                                "NAME": "Jane"
                            }
                        ],
                        "StartCommand": "python server.py"
                    },
                    "ConfigurationSource": "Api"
                },
                "RepositoryUrl": "https://github.com/my-account/python-hello",
                "SourceCodeVersion": {
                    "Type": "BRANCH",
                    "Value": "main"
                }
            }
        },
        "Status": "OPERATION_IN_PROGRESS",
        "InstanceConfiguration": {
            "CPU": "1 vCPU",
            "Memory": "3 GB"
        }
    }
}

Пример 2: Создание сервиса хранилища исходного кода

Следующий create-service пример создаёт сервис App Runner на основе репозитория исходного кода Python.

aws apprunner create-service \
    --cli-input-json file://input.json

Содержимое input.json:

{
    "ServiceName": "python-app",
    "SourceConfiguration": {
        "AuthenticationConfiguration": {
            "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
        },
        "AutoDeploymentsEnabled": true,
        "CodeRepository": {
            "RepositoryUrl": "https://github.com/my-account/python-hello",
            "SourceCodeVersion": {
                "Type": "BRANCH",
                "Value": "main"
            },
            "CodeConfiguration": {
                "ConfigurationSource": "API",
                "CodeConfigurationValues": {
                    "Runtime": "PYTHON_3",
                    "BuildCommand": "pip install -r requirements.txt",
                    "StartCommand": "python server.py",
                    "Port": "8080",
                    "RuntimeEnvironmentVariables": [
                        {
                            "NAME": "Jane"
                        }
                    ]
                }
            }
        }
    },
    "InstanceConfiguration": {
        "CPU": "1 vCPU",
        "Memory": "3 GB"
    }
}

Вывод:

{
    "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
    "Service": {
        "CreatedAt": "2020-11-20T19:05:25Z",
        "UpdatedAt": "2020-11-20T19:05:25Z",
        "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
        "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
        "ServiceName": "python-app",
        "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
        "SourceConfiguration": {
            "AuthenticationConfiguration": {
                "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
            },
            "AutoDeploymentsEnabled": true,
            "CodeRepository": {
                "CodeConfiguration": {
                    "CodeConfigurationValues": {
                        "BuildCommand": "pip install -r requirements.txt",
                        "Port": "8080",
                        "Runtime": "PYTHON_3",
                        "RuntimeEnvironmentVariables": [
                            {
                                "NAME": "Jane"
                            }
                        ],
                        "StartCommand": "python server.py"
                    },
                    "ConfigurationSource": "Api"
                },
                "RepositoryUrl": "https://github.com/my-account/python-hello",
                "SourceCodeVersion": {
                    "Type": "BRANCH",
                    "Value": "main"
                }
            }
        },
        "Status": "OPERATION_IN_PROGRESS",
        "InstanceConfiguration": {
            "CPU": "1 vCPU",
            "Memory": "3 GB"
        }
    }
}

Пример 3: Создание сервиса хранилища изображений

Следующий create-service пример создаёт сервис App Runner, основанный на изображении, хранящемся в Elastic Container Registry (ECR).

aws apprunner create-service \
    --cli-input-json file://input.json

Содержимое input.json:

{
    "ServiceName": "golang-container-app",
    "SourceConfiguration": {
        "AuthenticationConfiguration": {
            "AccessRoleArn": "arn:aws:iam::123456789012:role/my-ecr-role"
        },
        "AutoDeploymentsEnabled": true,
        "ImageRepository": {
            "ImageIdentifier": "123456789012.dkr.ecr.us-east-1.amazonaws.com/golang-app:latest",
            "ImageConfiguration": {
                "Port": "8080",
                "RuntimeEnvironmentVariables": [
                    {
                        "NAME": "Jane"
                    }
                ]
            },
            "ImageRepositoryType": "ECR"
        }
    },
    "InstanceConfiguration": {
        "CPU": "1 vCPU",
        "Memory": "3 GB"
    }
}

Вывод:

{
    "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
    "Service": {
        "CreatedAt": "2020-11-06T23:15:30Z",
        "UpdatedAt": "2020-11-06T23:15:30Z",
        "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/golang-container-app/51728f8a20ce46d39b25398a6c8e9d1a",
        "ServiceId": "51728f8a20ce46d39b25398a6c8e9d1a",
        "ServiceName": "golang-container-app",
        "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
        "SourceConfiguration": {
            "AuthenticationConfiguration": {
                "AccessRoleArn": "arn:aws:iam::123456789012:role/my-ecr-role"
            },
            "AutoDeploymentsEnabled": true,
            "ImageRepository": {
                "ImageIdentifier": "123456789012.dkr.ecr.us-east-1.amazonaws.com/golang-app:latest",
                "ImageConfiguration": {
                    "Port": "8080",
                    "RuntimeEnvironmentVariables": [
                        {
                            "NAME": "Jane"
                        }
                    ]
                },
                "ImageRepositoryType": "ECR"
            }
        },
        "Status": "OPERATION_IN_PROGRESS",
        "InstanceConfiguration": {
            "CPU": "1 vCPU",
            "Memory": "3 GB"
        }
    }
}

Вывод

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

Описание созданного этим запросом сервиса App Runner.

ИмяСервиса -> (строка)

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

ИдентификаторСервиса -> (строка)

Идентификатор, сгенерированный App Runner для этого сервиса. Он уникален в регионе Amazon Web Services.

ArnСервиса -> (строка)

Amazon Resource Name (ARN) этого сервиса.

UrlСервиса -> (строка)

Поддомен URL, сгенерированный App Runner для этого сервиса. Вы можете использовать этот URL для доступа к вашему веб-приложению сервиса.

ДатаСоздание -> (временная метка)

Время создания сервиса App Runner. В формате временной метки Unix.

ДатаОбновления -> (временная метка)

Время последнего обновления сервиса App Runner. В формате временной метки Unix.

ДатаУдаления -> (временная метка)

Время удаления сервиса App Runner. В формате временной метки Unix.

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

Текущее состояние сервиса App Runner. Значения означают следующее.

CREATE_FAILED – Сервис не смог быть создан. Неудачный сервис неприменим и всё ещё учитывается в вашей квоте сервисов. Для устранения неполадок прочитайте события и логи ошибок, измените любые параметры, которые нужно исправить, и перестройте свой сервис с помощью UpdateService .
DELETE_FAILED – Сервис не смог быть удалён и не может быть успешно восстановлен. Повторите вызов удаления сервиса, чтобы убедиться, что все связанные ресурсы удалены.

КонфигурацияИсточника -> (структура)

Источник, развернутый в сервис App Runner. Может быть кодом или репозиторием изображений.

РепозиторийКода -> (структура)

Описание репозитория исходного кода.

Вы должны предоставить либо этот элемент, либо ImageRepository (но не оба).

UrlРепозитория -> (строка)

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

ВерсияИсходногоКода -> (структура)

Версия, которая должна использоваться в репозитории исходного кода.

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

Тип идентификатора версии.

Для репозитория на основе git ветки представляют версии.

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

Версия исходного кода.

Для репозитория на основе git имя ветки соответствует конкретной версии. App Runner использует последний коммит в ветке.

КонфигурацияКода -> (структура)

Конфигурация для сборки и запуска сервиса из репозитория исходного кода.

Примечание

CodeConfiguration требуется только для CreateService запроса.

ИсточникКонфигурации -> (строка)

Источник конфигурации App Runner. Значения интерпретируются следующим образом:

REPOSITORY – App Runner считывает значения конфигурации из файла apprunner.yaml в репозитории исходного кода и игнорирует CodeConfigurationValues .
API – App Runner использует значения конфигурации, предоставленные в CodeConfigurationValues , и игнорирует файл apprunner.yaml в репозитории исходного кода.

ЗначенияКонфигурацииКода -> (структура)

Базовая конфигурация для сборки и запуска сервиса App Runner. Используйте ее для быстрого запуска сервиса App Runner без предоставления файла apprunner.yaml в репозитории исходного кода (или игнорирования файла, если он существует).

СредствоВыполнения -> (строка)

Тип среды выполнения для сборки и запуска сервиса App Runner. Представляет среду выполнения языка программирования.

КомандаСборки -> (строка)

Команда, которую App Runner выполняет для сборки вашего приложения.

КомандаЗапуска -> (строка)

Команда, которую App Runner выполняет для запуска вашего приложения.

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

Порт, на котором ваше приложение прослушивает в контейнере.

По умолчанию: 8080

ПеременныеСредыВыполнения -> (массив)

Переменные среды, доступные для вашего работающего сервиса App Runner. Массив пар ключ-значение.

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

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

СекретыСредыВыполнения -> (массив)

Массив пар ключ-значение, представляющих секреты и параметры, которые ссылаются на ваш сервис как на переменную окружения. Поддерживаемые значения — это либо полный Amazon Resource Name (ARN) секрета Secrets Manager, либо полный ARN параметра в хранилище параметров Amazon Web Services Systems Manager.

Примечание

Если параметр хранилища параметров Amazon Web Services Systems Manager существует в том же регионе Amazon Web Services, что и запускаемый вами сервис, вы можете использовать либо полный ARN, либо имя секрета. Если параметр существует в другом регионе, необходимо указать полный ARN.
В настоящее время не поддерживается ссылка на параметры хранилища параметров Amazon Web Services Systems Manager через разные аккаунты.

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

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

ДиректорияИсточника -> (строка)

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

РепозиторийИзображений -> (структура)

Описание репозитория исходного изображения.

Вы должны предоставить либо этот элемент, либо CodeRepository (но не оба).

ИдентификаторИзображения -> (строка)

Идентификатор изображения.

Для изображения в Amazon Elastic Container Registry (Amazon ECR) это имя изображения. Для формата имени изображения см. Вытянутые изображения в Руководстве пользователя Amazon ECR.

КонфигурацияИзображения -> (структура)

Конфигурация для запуска идентифицированного изображения.

ПеременныеСредыВыполнения -> (массив)

Переменные среды, доступные для вашего работающего сервиса App Runner. Массив пар ключ-значение.

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

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

КомандаЗапуска -> (строка)

Необязательная команда, которую App Runner выполняет для запуска приложения в исходном изображении. Если задана, эта команда переопределяет команду запуска по умолчанию для Docker-изображения.

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

Порт, на котором ваше приложение прослушивает в контейнере.

По умолчанию: 8080

СекретыСредыВыполнения -> (массив)

Примечание

Если параметр хранилища параметров Amazon Web Services Systems Manager существует в том же регионе Amazon Web Services, что и запускаемый вами сервис, вы можете использовать либо полный ARN, либо имя секрета. Если параметр существует в другом регионе, необходимо указать полный ARN.
В настоящее время не поддерживается ссылка на параметры хранилища параметров Amazon Web Services Systems Manager через разные аккаунты.

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

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

ТипРепозиторияИзображений -> (строка)

Тип репозитория изображений. Отвечает за поставщика репозитория и то, является ли репозиторий частным или публичным.

ВключеныАвтоматическиеРазвертывания -> (булево)

Если true , непрерывная интеграция из репозитория исходного кода включена для сервиса App Runner. Каждое изменение репозитория (включая любой коммит исходного кода или новую версию изображения) запускает развертывание.

По умолчанию: App Runner устанавливает значение в false для исходного изображения, использующего публичный репозиторий ECR или репозиторий ECR, находящийся в учетной записи Amazon Web Services, отличной от той, в которой находится сервис. App Runner устанавливает значение в true во всех других случаях (в настоящее время это включает репозиторий исходного кода или исходное изображение, использующее репозиторий ECR в той же учетной записи).

КонфигурацияАутентификации -> (структура)

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

ConnectionArn -> (строка)

Amazon Resource Name (ARN) подключения App Runner, которое позволяет сервису App Runner подключаться к репозиторию исходного кода. Требуется для репозиториев кода GitHub.

AccessRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, предоставляющей сервису App Runner доступ к репозиторию исходного кода. Требуется для репозиториев изображений ECR (но не для публичных репозиториев ECR).

КонфигурацияИнстансов -> (структура)

Конфигурация времени выполнения инстансов (масштабируемых единиц) этого сервиса.

Cpu -> (строка)

Количество процессорных единиц, резервируемых для каждого инстанса вашего сервиса App Runner.

По умолчанию: 1 vCPU

Память -> (строка)

Объем памяти в МБ или ГБ, резервируемый для каждого инстанса вашего сервиса App Runner.

По умолчанию: 2 GB

InstanceRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, предоставляющей права вашему сервису App Runner. Это права, необходимые вашему коду при вызове любых API Amazon Web Services.

КонфигурацияШифрования -> (структура)

Ключ шифрования, который App Runner использует для шифрования журналов сервиса и копии репозитория исходного кода, которую App Runner сохраняет для сервиса. Он может быть либо ключом шифрования, предоставленным клиентом, либо управляемым ключом Amazon Web Services.

KmsKey -> (строка)

ARN ключа KMS, используемого для шифрования.

КонфигурацияПроверкиСостояния -> (структура)

Настройки проверки работоспособности, которые App Runner выполняет для мониторинга состояния этого сервиса.

Протокол -> (строка)

Протокол IP, который App Runner использует для выполнения проверок работоспособности вашего сервиса.

Если вы установите Protocol на HTTP, App Runner отправляет запросы проверки работоспособности на указанный в Path HTTP путь.

По умолчанию: TCP

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

URL, на который отправляются запросы проверки работоспособности.

Path применимо только в том случае, если вы установите Protocol на HTTP.

По умолчанию: "/"

Интервал -> (целое число)

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

По умолчанию: 5

Таймаут -> (целое число)

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

По умолчанию: 2

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

Количество последовательных успешных проверок, необходимых App Runner для определения работоспособности сервиса.

По умолчанию: 1

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

Количество последовательных неудачных проверок, необходимых App Runner для определения неработоспособности сервиса.

По умолчанию: 5

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

Сводная информация о ресурсе конфигурации автоматического масштабирования App Runner, связанном с этим сервисом.

AutoScalingConfigurationArn -> (строка)

Amazon Resource Name (ARN) этой конфигурации автоматического масштабирования.

AutoScalingConfigurationName -> (строка)

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

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

Ревизия этой конфигурации автоматического масштабирования. Она уникальна среди всех активных конфигураций ("Status": "ACTIVE" ) с тем же AutoScalingConfigurationName.

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

Текущее состояние конфигурации автоматического масштабирования. Если состояние ревизии конфигурации - INACTIVE, она была удалена и больше не может быть использована. Неактивные ревизии конфигураций удаляются навсегда некоторое время спустя после их удаления.

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

Время создания конфигурации автоматического масштабирования. Формат - временная метка Unix.

HasAssociatedService -> (булево)

Указывает, связана ли с этой конфигурацией автоматического масштабирования служба App Runner. Значение true указывает на то, что связана одна или несколько служб. Значение false указывает на отсутствие связанных служб.

IsDefault -> (булево)

Указывает, должна ли эта конфигурация автоматического масштабирования использоваться по умолчанию для новой службы App Runner, у которой отсутствует ARN конфигурации автоматического масштабирования, указанный при создании. В каждом аккаунте может быть только одна конфигурация по умолчанию AutoScalingConfiguration в каждом регионе. Конфигурация по умолчанию AutoScalingConfiguration может быть любой ревизией в рамках того же AutoScalingConfigurationName.

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

Настройки конфигурации, связанные с сетевым трафиком веб-приложения, выполняемого этой службой.

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

Настройки сетевой конфигурации для исходящего трафика сообщений.

EgressType -> (строка)

Тип конфигурации исходящего трафика.

Установите значение DEFAULT для доступа к ресурсам, размещенным в общедоступных сетях.

Установите значение VPC, чтобы связать вашу службу с настраиваемой VPC, указанной в VpcConnectorArn.

VpcConnectorArn -> (строка)

Amazon Resource Name (ARN) коннектора VPC App Runner, который вы хотите связать со своей службой App Runner. Действительно только при EgressType = VPC.

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

Настройки сетевой конфигурации для входящего трафика сообщений.

IsPubliclyAccessible -> (булево)

Указывает, доступна ли ваша служба App Runner для публичного доступа. Установите значение True, чтобы сделать службу доступной для публичного доступа. Установите значение False, чтобы сделать службу доступной только изнутри Amazon VPC.

IpAddressType -> (строка)

App Runner предоставляет вам возможность выбора между Internet Protocol версии 4 (IPv4) и дуальным стеком (IPv4 и IPv6) для вашей конфигурации входящей общедоступной сети. Это необязательный параметр. Если вы не укажете IpAddressType, по умолчанию будет выбран IPv4.

Примечание

В настоящее время App Runner поддерживает дуальный стек только для общедоступных конечных точек. Для частной конечной точки поддерживается только IPv4. Если вы обновите службу, использующую дуальный стек общедоступной конечной точки, на частную конечную точку, ваша служба App Runner по умолчанию будет поддерживать только IPv4 для частной конечной точки и не сможет получать трафик, исходящий из IPv6-конечной точки.

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

Конфигурация наблюдаемости этого сервиса.

ObservabilityEnabled -> (булево)

При значении true с сервисом связаны ресурсы конфигурации наблюдаемости, и указан ObservabilityConfigurationArn.

ObservabilityConfigurationArn -> (строка)

Amazon Resource Name (ARN) конфигурации наблюдаемости, связанной со службой. Указывается только при ObservabilityEnabled равном true.

Укажите ARN с именем и номером ревизии для привязки этой ревизии. Например: arn:aws:apprunner:us-east-1:123456789012:observabilityconfiguration/xray-tracing/3

Укажите только имя, чтобы связать последнюю ревизию. Например: arn:aws:apprunner:us-east-1:123456789012:observabilityconfiguration/xray-tracing

OperationId -> (строка)

Уникальный идентификатор асинхронной операции, начатой этим запросом. Вы можете использовать его в сочетании с вызовом ListOperations для отслеживания прогресса операции.