Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

обновить-услугу-контейнера

Описание

Обновляет конфигурацию вашей службы Amazon Lightsail контейнеров, такой как мощность, масштабирование и общедоступные доменные имена.

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

Синтаксис

  update-container-service
--service-name <value>
[--power <value>]
[--scale <value>]
[--is-disabled | --no-is-disabled]
[--public-domain-names <value>]
[--private-registry-access <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 (строка)

Имя службы контейнеров для обновления.

--power (строка)

Мощность для службы контейнеров.

Мощность определяет объем памяти, vCPU и базовую ежемесячную стоимость каждого узла службы контейнеров. power и scale службы контейнеров составляют ее конфигурированную емкость. Чтобы определить ежемесячную стоимость вашей службы контейнеров, умножьте базовую стоимость power на scale (количество узлов) службы.

Используйте действие GetContainerServicePowers для просмотра спецификаций каждого варианта мощности.

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

  • nano
  • micro
  • small
  • medium
  • large
  • xlarge

--scale (целое число)

Масштабирование для службы контейнеров.

Масштабирование определяет выделенные вычислительные узлы службы контейнеров. power и scale службы контейнеров составляют ее конфигурированную емкость. Чтобы определить ежемесячную стоимость вашей службы контейнеров, умножьте базовую стоимость power на scale (количество узлов) службы.

--is-disabled | --no-is-disabled (булево)

Булево значение, указывающее, отключена ли служба контейнеров.

--public-domain-names (карта)

Общедоступные доменные имена для использования со службой контейнеров, такие как example.com и www.example.com.

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

Если вы не укажете общедоступные доменные имена, то можете использовать стандартный домен службы контейнеров.

Предупреждение

Вы должны создать и проверить сертификат SSL/TLS, прежде чем сможете использовать общедоступные доменные имена со своей службой контейнеров. Используйте действие CreateCertificate для создания сертификата для общедоступных доменных имен, которые вы хотите использовать со своей службой контейнеров.

Вы можете указать общедоступные доменные имена, используя карту строки к массиву, как показано в примере далее на этой странице.

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

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

(строка)

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

KeyName1=string,string,KeyName2=string,string

Синтаксис JSON:

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

--private-registry-access (структура)

Объект для описания конфигурации службы контейнеров для доступа к закрытым репозиториям изображений контейнеров, таким как закрытые репозитории Amazon Elastic Container Registry (Amazon ECR).

Дополнительную информацию см. в разделе Настройка доступа к частному репозиторию Amazon ECR для службы контейнеров Amazon Lightsail в Руководстве разработчика Amazon Lightsail.

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

Объект для описания запроса на активацию или деактивацию роли, которую вы можете использовать для предоставления службе контейнеров Amazon Lightsail доступа к закрытым репозиториям Amazon Elastic Container Registry (Amazon ECR).

isActive -> (булево)

Булево значение, указывающее, следует ли активировать роль.

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

ecrImagePullerRole={isActive=boolean}

Синтаксис JSON:

{
  "ecrImagePullerRole": {
    "isActive": 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.

Вывод

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

Объект, описывающий контейнерную службу.

containerServiceName -> (строка)

Имя контейнерной службы.

arn -> (строка)

Amazon Resource Name (ARN) контейнерной службы.

createdAt -> (метка времени)

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

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

Объект, описывающий расположение контейнерной службы, например, Amazon Web Services регион и зону доступности.

availabilityZone -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимая).

regionName -> (строка)

Имя региона Amazon Web Services.

resourceType -> (строка)

Тип ресурса Lightsail для контейнерной службы.

tags -> (список)

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

(структура)

Описывает ключ тега и необязательное значение, назначенное ресурсу Amazon Lightsail.

Более подробную информацию о тегах в Lightsail можно найти в руководстве разработчика Amazon Lightsail.

key -> (строка)

Ключ тега.

Ограничения: Ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

value -> (строка)

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

Ограничения: Значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

power -> (строка)

Спецификация мощности контейнерной службы.

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

powerId -> (строка)

Идентификатор мощности контейнерной службы.

state -> (строка)

Текущее состояние контейнерной службы.

Возможны следующие состояния контейнерной службы:

  • PENDING - Контейнерная служба создается.
  • READY - Контейнерная служба работает, но активное развертывание контейнеров отсутствует.
  • DEPLOYING - Контейнерная служба запускает развертывание контейнеров.
  • RUNNING - Контейнерная служба работает и имеет активное развертывание контейнеров.
  • UPDATING - Обновляется мощность контейнерной службы или ее пользовательские домены.
  • DELETING - Контейнерная служба удаляется.
  • DISABLED - Контейнерная служба отключена, и ее активное развертывание и контейнеры (если таковые имеются) остановлены.

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

Объект, описывающий текущее состояние контейнерной службы.

Примечание

Подробности состояния заполняются только при состоянии контейнерной службы PENDING, DEPLOYING или UPDATING.

code -> (строка)

Код состояния контейнерной службы.

Возможны следующие коды состояния:

  • Следующие коды состояния возможны, если ваша контейнерная служба находится в состоянии DEPLOYING или UPDATING:
    • CREATING_SYSTEM_RESOURCES - Системные ресурсы вашей контейнерной службы создаются.
    • CREATING_NETWORK_INFRASTRUCTURE - Сеть вашей контейнерной службы создается.
    • PROVISIONING_CERTIFICATE - Сертификат SSL/TLS вашей контейнерной службы создается.
    • PROVISIONING_SERVICE - Ваша контейнерная служба проходит настройку.
    • CREATING_DEPLOYMENT - Развертывание создается на вашей контейнерной службе.
    • EVALUATING_HEALTH_CHECK - Оценивается состояние здоровья вашего развертывания.
    • ACTIVATING_DEPLOYMENT - Ваше развертывание активируется.
  • Следующие коды состояния возможны, если ваша контейнерная служба находится в состоянии PENDING:
    • CERTIFICATE_LIMIT_EXCEEDED - Сертификат SSL/TLS, необходимый для вашей контейнерной службы, превышает максимальное количество сертификатов, разрешенное для вашей учетной записи.
    • UNKNOWN_ERROR - Во время создания контейнерной службы произошла ошибка.

message -> (строка)

Сообщение, предоставляющее дополнительную информацию о коде состояния.

Примечание

Подробности состояния заполняются только при состоянии контейнерной службы PENDING, DEPLOYING или UPDATING.

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

Спецификация масштабирования контейнерной службы.

Масштабирование определяет выделенные вычислительные узлы контейнерной службы.

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

Объект, описывающий текущее развертывание контейнеров контейнерной службы.

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

Номер версии развертывания.

state -> (строка)

Состояние развертывания.

Развертывание может находиться в одном из следующих состояний:

  • ACTIVATING - Развертывание создается.
  • ACTIVE - Развертывание успешно создано и в настоящее время выполняется на контейнерной службе. Контейнерная служба может иметь только одно развертывание в активном состоянии одновременно.
  • INACTIVE - Развертывание ранее успешно создано, но в настоящее время не выполняется на контейнерной службе.
  • FAILED - Развертывание завершилось неудачно. Используйте действие GetContainerLog, чтобы просмотреть журналы событий контейнеров в развертывании, чтобы попытаться определить причину сбоя.

containers -> (карта)

Объект, описывающий конфигурацию контейнеров развертывания.

key -> (строка)

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

Описание настроек контейнера, который будет запущен или запущен в Amazon Lightsail контейнерной службе.

image -> (строка)

Имя изображения, используемого для контейнера.

Изображения контейнеров, полученные из вашей контейнерной службы Lightsail, которые зарегистрированы и хранятся на вашей службе, начинаются с двоеточия (:). Например, если имя вашей контейнерной службы container-service-1, метка изображения контейнера mystaticsite, и вы хотите использовать третью (3) версию зарегистрированного изображения контейнера, то вы должны указать :container-service-1.mystaticsite.3. Чтобы использовать последнюю версию изображения контейнера, укажите latest вместо номера версии (например, :container-service-1.mystaticsite.latest). Lightsail автоматически будет использовать самую высокую версию зарегистрированного изображения контейнера.

Изображения контейнеров, полученные из общедоступного репозитория, например, Docker Hub, не начинаются с двоеточия. Например, nginx:latest или nginx.

command -> (список)

Команда запуска контейнера.

(строка)

environment -> (карта)

Переменные среды контейнера.

key -> (строка)

value -> (строка)

ports -> (карта)

Открытые порты брандмауэра контейнера.

key -> (строка)

value -> (строка)

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

Объект, описывающий конечную точку развертывания.

containerName -> (строка)

Имя записи контейнера развертывания, к которому применяется конфигурация конечной точки.

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

Порт указанного контейнера, на который перенаправляется трафик.

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

Объект, описывающий конфигурацию проверки работоспособности контейнера.

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

Количество последовательных успешных проверок работоспособности, необходимых для перевода контейнера в состояние Healthy. Значение по умолчанию равно 2.

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

Количество последовательных неудачных проверок работоспособности, необходимых для перевода контейнера в состояние Unhealthy. Значение по умолчанию равно 2.

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

Количество секунд, в течение которых отсутствие ответа означает неудачную проверку работоспособности. Можно указать значения от 2 до 60. Значение по умолчанию равно 2.

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

Приблизительный интервал в секундах между проверками работоспособности отдельных контейнеров. Можно указать значения от 5 до 300. Значение по умолчанию равно 5.

path -> (строка)

Путь в контейнере, на котором выполняется проверка работоспособности. Значение по умолчанию равно /.

successCodes -> (строка)

HTTP-коды, используемые при проверке успешного ответа от контейнера. Можно указать значения от 200 до 499. Можно указать несколько значений (например, 200,202) или диапазон значений (например, 200-299).

createdAt -> (метка времени)

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

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

Объект, описывающий следующее развертывание службы контейнеров.

Это значение является null, когда развертывания нет в состоянии pending.

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

Номер версии развертывания.

state -> (строка)

Состояние развертывания.

Развертывание может находиться в одном из следующих состояний:

  • ACTIVATING - Развертывание создается.
  • ACTIVE - Развертывание было успешно создано и в настоящее время выполняется в службе контейнеров. Служба контейнеров может иметь только одно развертывание в активном состоянии одновременно.
  • INACTIVE - Развертывание было ранее успешно создано, но в настоящее время не выполняется в службе контейнеров.
  • FAILED - Развертывание завершилось неудачно. Используйте действие GetContainerLog, чтобы просмотреть события журнала для контейнеров в развертывании и попытаться определить причину сбоя.

containers -> (карта)

Объект, описывающий конфигурацию контейнеров развертывания.

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

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

Описывает настройки контейнера, который будет запущен или уже запущен в службе Amazon Lightsail контейнеров.

image -> (строка)

Имя образа, используемого для контейнера.

Образы контейнеров, полученные из вашей службы контейнеров Lightsail, зарегистрированные и сохраненные в вашей службе, начинаются с двоеточия (:). Например, если имя вашей службы контейнеров - container-service-1, метка образа контейнера - mystaticsite, и вы хотите использовать третью (3) версию зарегистрированного образа контейнера, то вы должны указать :container-service-1.mystaticsite.3. Чтобы использовать последнюю версию образа контейнера, укажите latest вместо номера версии (например, :container-service-1.mystaticsite.latest). Lightsail автоматически будет использовать самую высокую версию зарегистрированного образа контейнера.

Образы контейнеров, полученные из общедоступного реестра, такого как Docker Hub, не начинаются с двоеточия. Например, nginx:latest или nginx.

command -> (список)

Команда запуска контейнера.

(строка)

environment -> (карта)

Переменные среды контейнера.

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

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

ports -> (карта)

Открытые порты брандмауэра контейнера.

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

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

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

Объект, описывающий конечную точку развертывания.

containerName -> (строка)

Имя записи контейнера развертывания, к которому применяется конфигурация конечной точки.

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

Порт указанного контейнера, на который перенаправляется трафик.

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

Объект, описывающий конфигурацию проверки состояния контейнера.

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

Количество последовательных успешных проверок состояния, необходимых для перевода контейнера в состояние Healthy. Значение по умолчанию - 2.

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

Количество последовательных неудачных проверок состояния, необходимых для перевода контейнера в состояние Unhealthy. Значение по умолчанию - 2.

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

Время в секундах, в течение которого отсутствие ответа означает неудачную проверку состояния. Вы можете указать значения от 2 до 60 секунд. Значение по умолчанию - 2.

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

Приблизительный интервал в секундах между проверками состояния отдельного контейнера. Вы можете указать значения от 5 до 300 секунд. Значение по умолчанию - 5.

path -> (строка)

Путь в контейнере, в котором выполняется проверка состояния. Значение по умолчанию - /.

successCodes -> (строка)

HTTP-коды, используемые для проверки успешного ответа от контейнера. Вы можете указать значения от 200 до 499. Вы можете указать несколько значений (например, 200,202) или диапазон значений (например, 200-299).

createdAt -> (метка времени)

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

isDisabled -> (булево)

Булево значение, указывающее, отключена ли служба контейнеров.

principalArn -> (строка)

Principal ARN службы контейнеров.

Principal ARN может быть использован для создания отношений доверия между вашей стандартной учетной записью Amazon Web Services и вашей службой контейнеров Lightsail. Это позволяет вашей службе получить разрешения на доступ к ресурсам в вашей стандартной учетной записи Amazon Web Services.

privateDomainName -> (строка)

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

Доступ к приватному доменному имени возможен только для других ресурсов внутри виртуальной частной сети (VPC) вашей учетной записи Lightsail.

publicDomainNames -> (карта)

Публичное доменное имя службы контейнеров, например example.com и www.example.com.

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

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

Предупреждение

Перед использованием публичных доменных имен со службой контейнеров необходимо создать и проверить сертификат SSL/TLS. Используйте действие CreateCertificate для создания сертификата для публичных доменных имен, которые вы хотите использовать со службой контейнеров.

См. CreateContainerService или UpdateContainerService для получения информации о том, как указать публичные доменные имена для службы контейнеров Lightsail.

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

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

(строка)

url -> (строка)

Публично доступный URL-адрес службы контейнеров.

Если в currentDeployment не указана публичная конечная точка, этот URL-адрес возвращает ответ 404.

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

Объект, описывающий конфигурацию службы контейнеров для доступа к частным репозиториям изображений контейнеров, таким как частные репозитории Amazon Elastic Container Registry (Amazon ECR).

Дополнительную информацию можно найти в разделе Настройка доступа к частному репозиторию Amazon ECR для службы контейнеров Amazon Lightsail в руководстве разработчика Amazon Lightsail.

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

Объект, описывающий статус активации роли, которую можно использовать для предоставления службе контейнеров Lightsail доступа к частным репозиториям Amazon ECR. Если роль активирована, также указан Amazon Resource Name (ARN) роли.

isActive -> (булево)

Булево значение, указывающее, активирована ли роль.

principalArn -> (строка)

Amazon Resource Name (ARN) роли, если она активирована.

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

Spec-Zone.ru

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