Spec-Zone.ru › AWS CLI v2

[ aws . opsworks ]

Настройка автоматического масштабирования по нагрузке

Описание

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

Примечание

Для использования автоматического масштабирования по нагрузке необходимо создать набор экземпляров, масштабируемых по нагрузке. Автоматическое масштабирование по нагрузке работает только с экземплярами из этого набора, поэтому необходимо убедиться, что вы создали достаточно экземпляров для обработки максимальной ожидаемой нагрузки.

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

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

Синтаксис

  set-load-based-auto-scaling
--layer-id <value>
[--enable | --no-enable]
[--up-scaling <value>]
[--down-scaling <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]

Параметры

--layer-id (строка)

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

--enable | --no-enable (логическое значение)

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

--up-scaling (структура)

Объект AutoScalingThresholds с конфигурацией порога повышения масштабируемости. Если нагрузка превысит эти пороги в течение определённого времени, OpsWorks Stacks запустит определённое количество экземпляров.

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

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

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

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

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

Время (в минутах) после события масштабирования, в течение которого OpsWorks Stacks должен игнорировать метрики и подавлять дополнительные события масштабирования. Например, OpsWorks Stacks добавляет новые экземпляры после события повышения масштабирования, но экземпляры не начнут уменьшать нагрузку, пока не будут загружены и настроены. Нет смысла поднимать дополнительные события масштабирования во время этой операции, которая обычно занимает несколько минут. IgnoreMetricsTime позволяет направить OpsWorks Stacks на подавление событий масштабирования на достаточное время, чтобы новые экземпляры подключились.

CpuThreshold -> (двойное число)

Порог использования ЦП, выраженный в процентах от доступного ЦП. Значение -1 отключает порог.

MemoryThreshold -> (двойное число)

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

LoadThreshold -> (двойное число)

Порог нагрузки. Значение -1 отключает порог. Дополнительную информацию о том, как вычисляется нагрузка, см. в разделе Нагрузка (вычисление).

Alarms -> (список)

Настраиваемые оповещения автомасштабирования CloudWatch, используемые в качестве порогов. Этот параметр принимает список до пяти имён оповещений, которые чувствительны к регистру и должны находиться в той же области, что и стек.

Примечание

Чтобы использовать настраиваемые оповещения, необходимо обновить роль службы, чтобы разрешить cloudwatch:DescribeAlarms. Вы можете либо позволить OpsWorks Stacks обновить роль при первом использовании этой функции, либо вручную отредактировать роль. Дополнительную информацию см. в разделе Разрешение OpsWorks Stacks действовать от вашего имени.

(строка)

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

InstanceCount=integer,ThresholdsWaitTime=integer,IgnoreMetricsTime=integer,CpuThreshold=double,MemoryThreshold=double,LoadThreshold=double,Alarms=string,string

Синтаксис JSON:

{
  "InstanceCount": integer,
  "ThresholdsWaitTime": integer,
  "IgnoreMetricsTime": integer,
  "CpuThreshold": double,
  "MemoryThreshold": double,
  "LoadThreshold": double,
  "Alarms": ["string", ...]
}

--down-scaling (структура)

Объект AutoScalingThresholds с конфигурацией порога уменьшения масштабируемости. Если нагрузка опустится ниже этих порогов в течение определённого времени, OpsWorks Stacks остановит определённое количество экземпляров.

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

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

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

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

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

Время (в минутах) после события масштабирования, в течение которого OpsWorks Stacks должен игнорировать метрики и подавлять дополнительные события масштабирования. Например, OpsWorks Stacks добавляет новые экземпляры после события повышения масштабирования, но экземпляры не начнут уменьшать нагрузку, пока не будут загружены и настроены. Нет смысла поднимать дополнительные события масштабирования во время этой операции, которая обычно занимает несколько минут. IgnoreMetricsTime позволяет направить OpsWorks Stacks на подавление событий масштабирования на достаточное время, чтобы новые экземпляры подключились.

CpuThreshold -> (двойное число)

Порог использования ЦП, выраженный в процентах от доступного ЦП. Значение -1 отключает порог.

MemoryThreshold -> (двойное число)

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

LoadThreshold -> (двойное число)

Порог нагрузки. Значение -1 отключает порог. Дополнительную информацию о том, как вычисляется нагрузка, см. в разделе Нагрузка (вычисление).

Alarms -> (список)

Настраиваемые оповещения автомасштабирования CloudWatch, используемые в качестве порогов. Этот параметр принимает список до пяти имён оповещений, которые чувствительны к регистру и должны находиться в той же области, что и стек.

Примечание

Чтобы использовать настраиваемые оповещения, необходимо обновить роль службы, чтобы разрешить cloudwatch:DescribeAlarms. Вы можете либо позволить OpsWorks Stacks обновить роль при первом использовании этой функции, либо вручную отредактировать роль. Дополнительную информацию см. в разделе Разрешение OpsWorks Stacks действовать от вашего имени.

(строка)

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

InstanceCount=integer,ThresholdsWaitTime=integer,IgnoreMetricsTime=integer,CpuThreshold=double,MemoryThreshold=double,LoadThreshold=double,Alarms=string,string

Синтаксис JSON:

{
  "InstanceCount": integer,
  "ThresholdsWaitTime": integer,
  "IgnoreMetricsTime": integer,
  "CpuThreshold": double,
  "MemoryThreshold": double,
  "LoadThreshold": double,
  "Alarms": ["string", ...]
}

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

--generate-cli-skeleton (строка) Выводит скелет JSON в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводится пример входного JSON, который может быть использован в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, будет выведен пример входного YAML, который может быть использован с --cli-input-yaml. Если предоставлено значение output, проверяются входные данные команд и возвращается пример выходного JSON для этой команды. Сгенерированный скелет JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном скелете JSON.

Глобальные параметры

--debug (логическое значение)

Включить отладку протоколирования.

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

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • 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.

Для настройки конфигурации масштабирования по нагрузке для слоя

В следующем примере включено масштабирование по нагрузке для указанного слоя и настройка конфигурации для этого слоя. Для добавления экземпляров, масштабируемых по нагрузке, к слою необходимо использовать create-instance.

aws opsworks --region us-east-1 set-load-based-auto-scaling --layer-id 523569ae-2faf-47ac-b39e-f4c4b381f36d --enable --up-scaling file://upscale.json --down-scaling file://downscale.json

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

{
  "InstanceCount": 2,
  "ThresholdsWaitTime": 3,
  "IgnoreMetricsTime": 3,
  "CpuThreshold": 85,
  "MemoryThreshold": 85,
  "LoadThreshold": 85
}

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

{
"InstanceCount": 2,
"ThresholdsWaitTime": 3,
"IgnoreMetricsTime": 3,
"CpuThreshold": 35,
"MemoryThreshold": 30,
"LoadThreshold": 30
}

Вывод: Ничего.

Дополнительная информация

Дополнительную информацию см. в разделе Использование автоматического масштабирования по нагрузке в руководстве пользователя AWS OpsWorks.

Вывод

Нет

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

Spec-Zone.ru

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