обновить-кластер
Описание
Обновляет кластер SageMaker HyperPod.
См. также: Документацию API AWS
Синтаксис
update-cluster
--cluster-name <value>
--instance-groups <value>
[--node-recovery <value>]
[--instance-groups-to-delete <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]
Параметры
--cluster-name (строка)
--instance-groups (список)
Укажите группы экземпляров для обновления.
(структура)
Технические характеристики группы экземпляров, которые необходимо определить.
InstanceCount -> (целое число)
InstanceGroupName -> (строка)
InstanceType -> (строка)
LifeCycleConfig -> (структура)
Указывает конфигурацию LifeCycle для группы экземпляров.
SourceS3Uri -> (строка)
Путь к ведру Amazon S3, где хранятся ваши скрипты жизненного цикла.
Предупреждение
Убедитесь, что путь к ведру S3 начинается сs3://sagemaker-. Роль IAM для SageMaker HyperPod имеет прикреплённую управляемую роль ` AmazonSageMakerClusterInstanceRolePolicy https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-cluster.html`__, которая позволяет получить доступ к ведрам S3 со специфическим префиксом sagemaker-.OnCreate -> (строка)
SourceS3Uri. Этот скрипт точки входа выполняется во время создания кластера.ExecutionRole -> (строка)
ThreadsPerCore -> (целое число)
1 для отключения многопоточности и 2 для включения многопоточности. Для типов экземпляров, которые не поддерживают многопоточность, укажите 1. Дополнительную информацию см. в справочной таблице процессорных ядер и потоков на процессорное ядро на тип экземпляра в «Руководстве пользователя Amazon Elastic Compute Cloud».InstanceStorageConfigs -> (список)
Указывает дополнительные конфигурации хранения для экземпляров в группе экземпляров кластера SageMaker HyperPod.
(структура с маркированным объединением)
Определяет конфигурацию для подключения дополнительного хранилища к экземплярам в группе экземпляров кластера SageMaker HyperPod. Дополнительную информацию см. в заметках к релизу SageMaker HyperPod: 20 июня 2024 г.
Примечание
Это структура с маркированным объединением. Только один из следующих верхних ключей может быть установлен:EbsVolumeConfig.EbsVolumeConfig -> (структура)
Определяет конфигурацию для подключения дополнительных томов Amazon Elastic Block Store (EBS) к экземплярам в группе экземпляров кластера SageMaker HyperPod. Дополнительный том EBS подключается к каждому экземпляру внутри группы экземпляров кластера SageMaker HyperPod и монтируется на /opt/sagemaker.
VolumeSizeInGB -> (целое число)
/opt/sagemaker.OnStartDeepHealthChecks -> (список)
Флаг, указывающий, следует ли выполнять глубокую проверку работоспособности при создании или обновлении группы экземпляров кластера.
(строка)
TrainingPlanArn -> (строка)
Идентификатор ресурса Amazon (ARN) плана обучения, который необходимо использовать для этой группы экземпляров кластера.
Дополнительную информацию о резервировании вычислительной мощности GPU для кластеров SageMaker HyperPod с помощью Amazon SageMaker Training Plan см. в разделе `` CreateTrainingPlan ``.
OverrideVpcConfig -> (структура)
Для настройки многозонных развертываний настройте конфигурацию Amazon VPC на уровне группы экземпляров. Вы можете указать разные подсети и группы безопасности в разных зонах доступности в спецификации группы экземпляров, чтобы переопределить стандартную конфигурацию Amazon VPC кластера SageMaker HyperPod. Дополнительную информацию о развертывании кластера в нескольких зонах доступности см. в разделе Настройка кластеров SageMaker HyperPod в нескольких зонах доступности.
Примечание
Если ваша Amazon VPC и подсети поддерживают IPv6, сетевые коммуникации отличаются в зависимости от платформы оркестрации кластера:
- Кластеры, оркестрированные с помощью Slurm, автоматически настраивают узлы с двойными адресами IPv6 и IPv4, что позволяет немедленно использовать сетевые коммуникации IPv6.
- В кластерах, оркестрированных с помощью Amazon EKS, узлы получают адресацию двойного стека, но поддомены могут использовать IPv6 только в том случае, если кластер Amazon EKS явно настроен на IPv6. Дополнительную информацию о развертывании кластера Amazon EKS с IPv6 см. в разделе Развертывание кластера Amazon EKS с IPv6.
Дополнительные ресурсы для конфигурации IPv6:
- Дополнительную информацию о добавлении поддержки IPv6 в вашу VPC см. в разделе Поддержка IPv6 для VPC.
- Дополнительную информацию о создании новой совместимой с IPv6 VPC см. в разделе Руководство по созданию Amazon VPC.
- Дополнительную информацию о настройке SageMaker HyperPod с настраиваемой Amazon VPC см. в разделе Настройка настраиваемой Amazon VPC для SageMaker HyperPod.
SecurityGroupIds -> (список)
Идентификаторы групп безопасности VPC в формате sg-xxxxxxxx. Укажите группы безопасности для VPC, указанной в поле Subnets.
(строка)
Subnets -> (список)
Идентификатор подсетей в VPC, к которым вы хотите подключить свою задачу обучения или модель. Дополнительную информацию о доступности определённых типов экземпляров см. в разделе Поддерживаемые типы экземпляров и зоны доступности.
(строка)
ScheduledUpdateConfig -> (структура)
Объект конфигурации расписания, который SageMaker использует для обновления AMI.
ScheduleExpression -> (строка)
DeploymentConfig -> (структура)
Конфигурация, используемая при обновлении версий AMI.
RollingUpdatePolicy -> (структура)
Политика, которую SageMaker использует при обновлении версий AMI кластера.
MaximumBatchSize -> (структура)
Максимальное количество экземпляров в кластере, которое SageMaker может обновить за один раз.
Type -> (строка)
Value -> (целое число)
RollbackMaximumBatchSize -> (структура)
Максимальное количество экземпляров в кластере, которое SageMaker может откатить за один раз.
Type -> (строка)
Value -> (целое число)
WaitIntervalInSeconds -> (целое число)
AutoRollbackConfiguration -> (список)
Массив, содержащий тревоги, которые SageMaker отслеживает, чтобы узнать, следует ли откатить обновление AMI.
(структура)
Подробности тревоги для отслеживания во время обновления AMI.
AlarmName -> (строка)
Синтаксис JSON:
[
{
"InstanceCount": integer,
"InstanceGroupName": "string",
"InstanceType": "ml.p4d.24xlarge"|"ml.p4de.24xlarge"|"ml.p5.48xlarge"|"ml.trn1.32xlarge"|"ml.trn1n.32xlarge"|"ml.g5.xlarge"|"ml.g5.2xlarge"|"ml.g5.4xlarge"|"ml.g5.8xlarge"|"ml.g5.12xlarge"|"ml.g5.16xlarge"|"ml.g5.24xlarge"|"ml.g5.48xlarge"|"ml.c5.large"|"ml.c5.xlarge"|"ml.c5.2xlarge"|"ml.c5.4xlarge"|"ml.c5.9xlarge"|"ml.c5.12xlarge"|"ml.c5.18xlarge"|"ml.c5.24xlarge"|"ml.c5n.large"|"ml.c5n.2xlarge"|"ml.c5n.4xlarge"|"ml.c5n.9xlarge"|"ml.c5n.18xlarge"|"ml.m5.large"|"ml.m5.xlarge"|"ml.m5.2xlarge"|"ml.m5.4xlarge"|"ml.m5.8xlarge"|"ml.m5.12xlarge"|"ml.m5.16xlarge"|"ml.m5.24xlarge"|"ml.t3.medium"|"ml.t3.large"|"ml.t3.xlarge"|"ml.t3.2xlarge"|"ml.g6.xlarge"|"ml.g6.2xlarge"|"ml.g6.4xlarge"|"ml.g6.8xlarge"|"ml.g6.16xlarge"|"ml.g6.12xlarge"|"ml.g6.24xlarge"|"ml.g6.48xlarge"|"ml.gr6.4xlarge"|"ml.gr6.8xlarge"|"ml.g6e.xlarge"|"ml.g6e.2xlarge"|"ml.g6e.4xlarge"|"ml.g6e.8xlarge"|"ml.g6e.16xlarge"|"ml.g6e.12xlarge"|"ml.g6e.24xlarge"|"ml.g6e.48xlarge"|"ml.p5e.48xlarge"|"ml.p5en.48xlarge"|"ml.trn2.48xlarge"|"ml.c6i.large"|"ml.c6i.xlarge"|"ml.c6i.2xlarge"|"ml.c6i.4xlarge"|"ml.c6i.8xlarge"|"ml.c6i.12xlarge"|"ml.c6i.16xlarge"|"ml.c6i.24xlarge"|"ml.c6i.32xlarge"|"ml.m6i.large"|"ml.m6i.xlarge"|"ml.m6i.2xlarge"|"ml.m6i.4xlarge"|"ml.m6i.8xlarge"|"ml.m6i.12xlarge"|"ml.m6i.16xlarge"|"ml.m6i.24xlarge"|"ml.m6i.32xlarge"|"ml.r6i.large"|"ml.r6i.xlarge"|"ml.r6i.2xlarge"|"ml.r6i.4xlarge"|"ml.r6i.8xlarge"|"ml.r6i.12xlarge"|"ml.r6i.16xlarge"|"ml.r6i.24xlarge"|"ml.r6i.32xlarge"|"ml.i3en.large"|"ml.i3en.xlarge"|"ml.i3en.2xlarge"|"ml.i3en.3xlarge"|"ml.i3en.6xlarge"|"ml.i3en.12xlarge"|"ml.i3en.24xlarge"|"ml.m7i.large"|"ml.m7i.xlarge"|"ml.m7i.2xlarge"|"ml.m7i.4xlarge"|"ml.m7i.8xlarge"|"ml.m7i.12xlarge"|"ml.m7i.16xlarge"|"ml.m7i.24xlarge"|"ml.m7i.48xlarge"|"ml.r7i.large"|"ml.r7i.xlarge"|"ml.r7i.2xlarge"|"ml.r7i.4xlarge"|"ml.r7i.8xlarge"|"ml.r7i.12xlarge"|"ml.r7i.16xlarge"|"ml.r7i.24xlarge"|"ml.r7i.48xlarge",
"LifeCycleConfig": {
"SourceS3Uri": "string",
"OnCreate": "string"
},
"ExecutionRole": "string",
"ThreadsPerCore": integer,
"InstanceStorageConfigs": [
{
"EbsVolumeConfig": {
"VolumeSizeInGB": integer
}
}
...
],
"OnStartDeepHealthChecks": ["InstanceStress"|"InstanceConnectivity", ...],
"TrainingPlanArn": "string",
"OverrideVpcConfig": {
"SecurityGroupIds": ["string", ...],
"Subnets": ["string", ...]
},
"ScheduledUpdateConfig": {
"ScheduleExpression": "string",
"DeploymentConfig": {
"RollingUpdatePolicy": {
"MaximumBatchSize": {
"Type": "INSTANCE_COUNT"|"CAPACITY_PERCENTAGE",
"Value": integer
},
"RollbackMaximumBatchSize": {
"Type": "INSTANCE_COUNT"|"CAPACITY_PERCENTAGE",
"Value": integer
}
},
"WaitIntervalInSeconds": integer,
"AutoRollbackConfiguration": [
{
"AlarmName": "string"
}
...
]
}
}
}
...
]
--node-recovery (строка)
Режим восстановления узлов для применения к кластеру SageMaker HyperPod.
Возможные значения:
AutomaticNone
--instance-groups-to-delete (список)
Укажите имена групп экземпляров для удаления. Используйте единственную , в качестве разделителя между несколькими именами.
(строка)
Синтаксис:
"string" "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 (boolean)
Включить отладку протоколирования.
--endpoint-url (string)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл с корневым сертификатом для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (string)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пейджер cli для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
ClusterArn -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.