Spec-Zone.ru › AWS CLI v2

[ aws . eks ]

удаление-группы-узлов

Описание

Удаляет управляемую группу узлов.

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

Синтаксис

  delete-nodegroup
--cluster-name <value>
--nodegroup-name <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 (строка)

Имя вашего кластера.

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

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

--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.

Примеры

Примечание

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

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

Пример 1: Удаление управляемой группы узлов для кластера Amazon EKS

Следующий delete-nodegroup пример удаляет управляемую группу узлов для кластера Amazon EKS.

aws eks delete-nodegroup \
    --cluster-name my-eks-cluster \
    --nodegroup-name my-eks-nodegroup

Вывод:

{
    "nodegroup": {
        "nodegroupName": "my-eks-nodegroup",
        "nodegroupArn": "arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-nodegroup/1ec75f5f-0e21-dcc0-b46e-f9c442685cd8",
        "clusterName": "my-eks-cluster",
        "version": "1.26",
        "releaseVersion": "1.26.12-20240329",
        "createdAt": "2024-04-08T13:25:15.033000-04:00",
        "modifiedAt": "2024-04-08T13:25:31.252000-04:00",
        "status": "DELETING",
        "capacityType": "SPOT",
        "scalingConfig": {
            "minSize": 1,
            "maxSize": 5,
            "desiredSize": 4
        },
        "instanceTypes": [
            "t3.large"
        ],
        "subnets": [
            "subnet-0e2907431c9988b72",
            "subnet-04ad87f71c6e5ab4d",
            "subnet-09d912bb63ef21b9a"
        ],
        "amiType": "AL2_x86_64",
        "nodeRole": "arn:aws:iam::111122223333:role/role-name",
        "labels": {
            "my-eks-nodegroup-label-2": "value-2",
            "my-eks-nodegroup-label-1": "value-1"
        },
        "taints": [
            {
                "key": "taint-key-1",
                "value": "taint-value-1",
                "effect": "NO_EXECUTE"
            }
        ],
        "diskSize": 50,
        "health": {
            "issues": []
        },
        "updateConfig": {
            "maxUnavailable": 2
        },
        "tags": {
            "my-eks-nodegroup-key-1": "value-1",
            "my-eks-nodegroup-key-2": "value-2"
        }
    }
}

Вывод

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

Полное описание удалённой группы узлов.

nodegroupName -> (строка)

Имя, связанное с управляемой группой узлов Amazon EKS.

nodegroupArn -> (строка)

Идентификатор ресурса Amazon (ARN), связанный с управляемой группой узлов.

clusterName -> (строка)

Имя вашего кластера.

version -> (строка)

Версия Kubernetes управляемой группы узлов.

releaseVersion -> (строка)

Если группа узлов была развернута с помощью шаблона запуска с настраиваемым AMI, то это идентификатор AMI, указанный в шаблоне запуска. Для групп узлов, которые не были развернуты с помощью шаблона запуска, это версия оптимизированного для Amazon EKS AMI, с которой была развернута группа узлов.

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

Временная метка эпохи Unix при создании объекта.

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

Временная метка эпохи Unix для последнего изменения объекта.

status -> (строка)

Текущий статус управляемой группы узлов.

capacityType -> (строка)

Тип ёмкости вашей управляемой группы узлов.

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

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

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

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

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

Максимальное количество узлов, до которого может масштабироваться управляемая группа узлов. Сведения о максимальном количестве, которое вы можете указать, см. в разделе Квоты сервиса Amazon EKS в руководстве пользователя Amazon EKS.

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

Текущее количество узлов, которое должна поддерживать управляемая группа узлов.

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

Если вы используете Kubernetes Cluster Autoscaler, не следует изменять значение непосредственно, так как это может привести к внезапному увеличению или уменьшению масштаба Cluster Autoscaler.

Всякий раз, когда этот параметр изменяется, количество рабочих узлов в группе узлов обновляется до указанного размера. Если этому параметру задано значение, меньшее, чем текущее количество работающих рабочих узлов, необходимое количество рабочих узлов завершает работу, чтобы соответствовать заданному значению. При использовании CloudFormation никаких действий не происходит, если вы удаляете этот параметр из шаблона CFN.

Этот параметр может отличаться от minSize в некоторых случаях, таких как начало работы с дополнительными хостами для тестирования. Этот параметр также может отличаться, когда вы хотите начать с приблизительного количества необходимых хостов, но позволить Cluster Autoscaler уменьшить количество, если их слишком много. При использовании Cluster Autoscaler параметр desiredSize изменяется Cluster Autoscaler (но может быть устаревшим в течение коротких периодов времени). Cluster Autoscaler не масштабирует управляемую группу узлов ниже minSize или выше maxSize.

instanceTypes -> (список)

Если группа узлов не была развернута с шаблоном запуска, то это тип экземпляра, связанный с группой узлов. Если группа узлов была развернута с шаблоном запуска, то это null.

(строка)

subnets -> (список)

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

(строка)

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

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

ec2SshKey -> (строка)

Имя ключа SSH Amazon EC2, обеспечивающего доступ для SSH-связи с узлами в управляемой группе узлов. Дополнительную информацию см. в разделе Пары ключей Amazon EC2 и виртуальные машины Linux в руководстве пользователя Amazon Elastic Compute Cloud для виртуальных машин Linux. Для Windows используется ключ SSH Amazon EC2 для получения пароля RDP. Дополнительную информацию см. в разделе Пары ключей Amazon EC2 и виртуальные машины Windows в руководстве пользователя Amazon Elastic Compute Cloud для виртуальных машин Windows.

sourceSecurityGroups -> (список)

Идентификаторы групп безопасности, которым разрешён SSH-доступ (порт 22) к узлам. Для Windows порт равен 3389. Если вы указываете ключ SSH Amazon EC2, но не указываете группу безопасности источника при создании управляемой группы узлов, то порт на узлах открыт для интернета (0.0.0.0/0). Дополнительную информацию см. в разделе Группы безопасности вашей VPC в руководстве пользователя Amazon Virtual Private Cloud.

(строка)

amiType -> (строка)

Если группа узлов была развернута с помощью шаблона запуска с настраиваемым AMI, то это CUSTOM. Для групп узлов, которые не были развернуты с помощью шаблона запуска, это тип AMI, указанный в конфигурации группы узлов.

nodeRole -> (строка)

Роль IAM, связанная с вашей группой узлов. Демон узла Amazon EKS kubelet выполняет вызовы API Amazon Web Services от вашего имени. Узлы получают разрешения на эти вызовы API через профиль экземпляра IAM и связанные политики.

labels -> (карта)

Применённые к узлам в группе узлов метки Kubernetes labels.

Примечание

Здесь показаны только метки labels, которые применяются с помощью API Amazon EKS. Могут быть применены другие метки Kubernetes labels к узлам в этой группе.

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

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

taints -> (список)

Применяемые к узлам в группе узлов метки Kubernetes, которые применяются при их создании. Эффект — это одно из значений No_Schedule, Prefer_No_Schedule или No_Execute. Метки Kubernetes могут использоваться вместе с допущениями для управления тем, как рабочие нагрузки планируются на ваши узлы. Дополнительную информацию см. в разделе Метки узлов в управляемых группах узлов.

(структура)

Свойство, которое позволяет узлу отражать Pod. Дополнительную информацию см. в разделе Метки узлов в управляемых группах узлов в руководстве пользователя Amazon EKS.

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

Ключ метки.

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

Значение метки.

эффект -> (строка)

Эффект метки.

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

Ресурсы, связанные с группой узлов, такие как группы автоматического масштабирования и группы безопасности для удалённого доступа.

autoScalingGroups -> (список)

Группы автоматического масштабирования, связанные с группой узлов.

(структура)

Группа автоматического масштабирования, связанная с управляемой группой узлов Amazon EKS.

name -> (строка)

Имя группы автоматического масштабирования, связанной с управляемой группой узлов Amazon EKS.

remoteAccessSecurityGroup -> (строка)

Группа безопасности удалённого доступа, связанная с группой узлов. Эта группа безопасности управляет SSH-доступом к узлам.

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

Если группа узлов не была развернута с помощью шаблона запуска, то это размер диска в конфигурации группы узлов. Если группа узлов была развернута с помощью шаблона запуска, то это null.

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

Статус работоспособности группы узлов. Если у вашей группы узлов есть проблемы с работоспособностью, они перечислены здесь.

issues -> (список)

Любые проблемы, связанные с группой узлов.

(структура)

Объект, представляющий проблему с ресурсом Amazon EKS.

code -> (строка)

Краткое описание ошибки.

  • AccessDenied : Amazon EKS или один или несколько управляемых узлов не могут пройти аутентификацию или авторизацию с сервером API вашего кластера Kubernetes.
  • AsgInstanceLaunchFailures : Ваша группа автоматического масштабирования испытывает сбои при попытке запуска экземпляров.
  • AutoScalingGroupNotFound : Мы не нашли группу автоматического масштабирования, связанную с управляемой группой узлов. Вы можете попытаться воссоздать группу автоматического масштабирования с теми же параметрами для восстановления.
  • ClusterUnreachable : Amazon EKS или один или несколько управляемых узлов не могут взаимодействовать с сервером API вашего кластера Kubernetes. Это может произойти из-за сетевых сбоев или если серверы API отключаются при обработке запросов.
  • Ec2InstanceTypeDoesNotExist : Один или несколько предоставленных типов экземпляров Amazon EC2 не существуют. Amazon EKS проверил указанные вами типы экземпляров в этом регионе Amazon Web Services, и один или несколько из них недоступны.
  • Ec2LaunchTemplateNotFound : Мы не нашли шаблон запуска Amazon EC2 для вашей управляемой группы узлов. Вы можете попытаться воссоздать шаблон запуска с теми же параметрами для восстановления.
  • Ec2LaunchTemplateVersionMismatch : Версия шаблона запуска Amazon EC2 для вашей управляемой группы узлов не совпадает с версией, созданной Amazon EKS. Вы можете попытаться вернуть версию, созданную Amazon EKS, для восстановления.
  • Ec2SecurityGroupDeletionFailure : Мы не смогли удалить группу безопасности удаленного доступа для вашей управляемой группы узлов. Удалите все зависимости от группы безопасности.
  • Ec2SecurityGroupNotFound : Мы не нашли группу безопасности кластера для кластера. Вам необходимо воссоздать свой кластер.
  • Ec2SubnetInvalidConfiguration : Один или несколько указанных для группы узлов подсетей Amazon EC2 не автоматически назначают общедоступные IP-адреса экземплярам, запущенным в них. Если вы хотите, чтобы вашим экземплярам был назначен общедоступный IP-адрес, вам нужно включить параметр auto-assign public IP address для подсети. См. Изменение атрибута адресации ``IPv4` для вашей подсети <https://docs.aws.amazon.com/vpc/latest/userguide/vpc-ip-addressing.html#subnet-public-ip>`__ в руководстве по Amazon VPC.
  • IamInstanceProfileNotFound : Мы не нашли профиль экземпляра IAM для вашей управляемой группы узлов. Вы можете попытаться воссоздать профиль экземпляра с теми же параметрами для восстановления.
  • IamNodeRoleNotFound : Мы не нашли роль IAM для вашей управляемой группы узлов. Вы можете попытаться воссоздать роль IAM с теми же параметрами для восстановления.
  • InstanceLimitExceeded : Ваш аккаунт Amazon Web Services не может запустить больше экземпляров указанного типа. Вы можете попытаться увеличить лимит экземпляров Amazon EC2 для восстановления.
  • InsufficientFreeAddresses : Одна или несколько подсетей, связанных с вашей управляемой группой узлов, не имеют достаточного количества доступных IP-адресов для новых узлов.
  • InternalFailure : Эти ошибки, как правило, вызваны проблемой на стороне сервера Amazon EKS.
  • NodeCreationFailure : Запущенные экземпляры не могут зарегистрироваться в вашем кластере Amazon EKS. Распространёнными причинами этого сбоя являются недостаточные разрешения роли IAM узла или отсутствие внешнего доступа в интернет для узлов.

message -> (строка)

Сообщение об ошибке, связанное с проблемой.

resourceIds -> (список)

Ресурсы Amazon Web Services, которые затронуты этой проблемой.

(строка)

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

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

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

Максимальное количество узлов, недоступных одновременно во время обновления версии. Узлы обновляются параллельно. Это значение или maxUnavailablePercentage должно иметь значение. Максимальное значение - 100.

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

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

updateStrategy -> (строка)

Настройка поведения при обновлении версии управляемой группы узлов. Вы выбираете между двумя возможными стратегиями замены узлов во время действия ` UpdateNodegroupVersion https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateNodegroupVersion.html`__.

Управляемая группа узлов Amazon EKS обновляется путём параллельной замены узлов новыми узлами с более новыми версиями AMI. Стратегия обновления изменяет поведение обновления управляемых узлов управляемой группы узлов для каждой единицы. Стратегия по умолчанию имеет защитные механизмы, чтобы защитить вас от неправильной настройки, и запускает новые экземпляры до завершения старых. Стратегия минимального уровня устраняет защитные механизмы и завершает старые экземпляры перед запуском новых. Эта минимальная стратегия полезна в ситуациях, когда вы ограничены ресурсами или затратами (например, с аппаратными ускорителями, такими как GPU).

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

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

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

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

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

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

name -> (строка)

Имя шаблона запуска.

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

version -> (строка)

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

id -> (строка)

Идентификатор шаблона запуска.

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

tags -> (карта)

Метаданные, которые помогают с категоризацией и организацией. Каждый тег состоит из ключа и необязательного значения. Вы определяете оба. Теги не распространяются на другие кластеры или ресурсы Amazon Web Services.

key -> (строка)

Одна часть пары ключ-значение, составляющей тег. key — это общий ярлык, который действует как категория для более конкретных значений тегов.

value -> (строка)

Необязательная часть пары ключ-значение, составляющей тег. value действует как описание в категории тегов (ключ).

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

Spec-Zone.ru

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