разрегистрировать-кластер
Описание
Разрегистрирует подключенный кластер, чтобы удалить его из управления Amazon EKS.
Подключенный кластер — это кластер Kubernetes, который вы подключили к своему контрольному узлу с помощью Amazon EKS Connector.
См. также: Документацию API AWS
Синтаксис
deregister-cluster
--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]
Параметры
--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 в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах применяются правила цитирования по аналогии с Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для разрегистрации подключенного кластера, чтобы удалить его из управления Amazon EKS
Следующий deregister-cluster пример разрегистрирует подключенный кластер, чтобы удалить его из управления Amazon EKS.
aws eks deregister-cluster \
--name my-eks-anywhere-cluster
Вывод:
{
"cluster": {
"name": "my-eks-anywhere-cluster",
"arn": "arn:aws:eks:us-east-2:111122223333:cluster/my-eks-anywhere-cluster",
"createdAt": "2024-04-12T12:38:37.561000-04:00",
"status": "DELETING",
"tags": {},
"connectorConfig": {
"activationId": "dfb5ad28-13c3-4e26-8a19-5b2457638c74",
"activationExpiry": "2024-04-15T12:38:37.082000-04:00",
"provider": "EKS_ANYWHERE",
"roleArn": "arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole"
}
}
}
Дополнительную информацию см. в разделе Разрегистрация кластера в Руководстве пользователя Amazon EKS.
Вывод
кластер -> (структура)
Объект, представляющий кластер Amazon EKS.
name -> (строка)
arn -> (строка)
createdAt -> (временная метка)
version -> (строка)
endpoint -> (строка)
roleArn -> (строка)
resourcesVpcConfig -> (структура)
Конфигурация VPC, используемая управляющей плоскостью кластера. Ресурсы VPC Amazon EKS имеют определённые требования для корректной работы с Kubernetes. Дополнительную информацию см. в разделе «Учетные соображения для VPC кластера» и «Учетные соображения для группы безопасности кластера» в руководстве пользователя Amazon EKS.
subnetIds -> (список)
Подсети, связанные с вашим кластером.
(строка)
securityGroupIds -> (список)
Группы безопасности, связанные с интерфейсами эластичной сети между учётными записями, используемыми для обеспечения связи между вашими узлами и управляющей плоскостью Kubernetes.
(строка)
clusterSecurityGroupId -> (строка)
vpcId -> (строка)
endpointPublicAccess -> (булево)
endpointPrivateAccess -> (булево)
publicAccessCidrs содержит необходимые блоки CIDR для связи с узлами или под-Fargate. Дополнительную информацию см. в разделе «Управление доступом к точке входа кластера Amazon EKS» в *руководстве пользователя Amazon EKS*.publicAccessCidrs -> (список)
Блоки CIDR, которым разрешён доступ к публичной точке входа API-сервера Kubernetes вашего кластера.
(строка)
kubernetesNetworkConfig -> (структура)
Конфигурация сети Kubernetes для кластера.
serviceIpv4Cidr -> (строка)
Pod и Service получают IP-адреса объектов. Kubernetes назначает адреса из блока CIDR IPv4, назначенного подсети, в которой находится узел. Если при создании кластера вы не указали блок CIDR, Kubernetes назначает адреса из блоков CIDR 10.100.0.0/16 или 172.20.0.0/16. Если это было указано, то это было указано при создании кластера и изменить это нельзя.serviceIpv6Cidr -> (строка)
ipv6 для ipFamily при создании кластера. Kubernetes назначает адреса сервисов из диапазона адресов частных сетей (fc00::/7), поскольку вы не можете указать собственный блок CIDR IPv6 при создании кластера.ipFamily -> (строка)
Pod и Service. Семейство IP всегда ipv4, если у вас нет кластера версии 1.21 или более поздней, работающего с плагином Amazon VPC CNI для Kubernetes версии 1.10.1 или более поздней и при создании кластера было указано ipv6.elasticLoadBalancing -> (структура)
Указывает текущую конфигурацию возможности балансировки нагрузки в вашем кластере EKS Auto Mode. Например, включена или выключена ли возможность.
enabled -> (булево)
logging -> (структура)
Конфигурация ведения журнала для вашего кластера.
clusterLogging -> (список)
Конфигурация ведения журнала управляющей плоскости кластера для вашего кластера.
(структура)
Объект, представляющий включённые или выключенные журналы управляющей плоскости Kubernetes для вашего кластера.
types -> (список)
Доступные типы журналов управляющей плоскости кластера.
(строка)
enabled -> (булево)
identity -> (структура)
Информация об идентификаторе источника для кластера.
oidc -> (структура)
Объект, представляющий информацию об идентификаторе источника OpenID Connect.
issuer -> (строка)
status -> (строка)
certificateAuthority -> (структура)
certificate-authority-data для вашего кластера.
data -> (строка)
certificate-authority-data файла kubeconfig для вашего кластера.clientRequestToken -> (строка)
platformVersion -> (строка)
tags -> (карта)
Метаданные, которые помогают с категоризацией и организацией. Каждый тег состоит из ключа и необязательного значения. Вы определяете оба. Теги не распространяются на другие кластеры или ресурсы Amazon Web Services.
key -> (строка)
key — это общее обозначение, которое действует как категория для более конкретных значений тегов.value -> (строка)
value выступает в качестве описания в категории тегов (ключ).encryptionConfig -> (список)
Конфигурация шифрования для кластера.
(структура)
Конфигурация шифрования для кластера.
resources -> (список)
Указывает ресурсы, которые необходимо зашифровать. Единственное поддерживаемое значение — secrets.
(строка)
provider -> (структура)
Ключ управления ключами (KMS). Можно использовать либо ARN, либо псевдоним.
keyArn -> (строка)
connectorConfig -> (структура)
Конфигурация, используемая для подключения к кластеру для регистрации.
activationId -> (строка)
activationCode -> (строка)
activationExpiry -> (временная метка)
provider -> (строка)
roleArn -> (строка)
id -> (строка)
health -> (структура)
Объект, представляющий состояние вашего кластера Amazon EKS.
issues -> (список)
Объект, представляющий проблемы со здоровьем вашего кластера Amazon EKS.
(структура)
Проблема с вашим кластером Amazon EKS.
code -> (строка)
message -> (строка)
resourceIds -> (список)
Идентификаторы ресурсов, к которым относится проблема.
(строка)
outpostConfig -> (структура)
Объект, представляющий конфигурацию вашего локального кластера Amazon EKS на Amazon Web Services Outpost. Этот объект недоступен для кластеров в облаке Amazon Web Services.
outpostArns -> (список)
ARN Outpost, который вы указали для использования с вашим локальным кластером Amazon EKS на Outposts.
(строка)
controlPlaneInstanceType -> (строка)
controlPlanePlacement -> (структура)
Объект, представляющий конфигурацию размещения для всех экземпляров управляющей плоскости вашего локального кластера Amazon EKS на Amazon Web Services Outpost. Дополнительную информацию см. в разделе «Учетные соображения для ресурсов» в руководстве пользователя Amazon EKS.
groupName -> (строка)
accessConfig -> (структура)
Конфигурация доступа к кластеру.
bootstrapClusterCreatorAdminPermissions -> (булево)
authenticationMode -> (строка)
upgradePolicy -> (структура)
Это значение указывает, включена или выключена расширенная поддержка для кластера.
supportType -> (строка)
Если для кластера установлено значение EXTENDED, он перейдет на расширенную поддержку в конце стандартной поддержки. Если для кластера установлено значение STANDARD, он будет автоматически обновлен в конце стандартной поддержки.
zonalShiftConfig -> (структура)
Конфигурация зонального сдвига для кластера.
enabled -> (boolean)
remoteNetworkConfig -> (структура)
Конфигурация в кластере для узлов EKS Hybrid. Вы можете добавить, изменить или удалить эту конфигурацию после создания кластера.
remoteNodeNetworks -> (список)
Список сетевых CIDR, которые могут содержать гибридные узлы.
(структура)
Сетевой CIDR, который может содержать гибридные узлы.
Эти блоки CIDR определяют ожидаемый диапазон IP-адресов гибридных узлов, которые присоединяются к кластеру. Эти блоки обычно определяются вашим системным администратором.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в диапазоне сети
IPv4RFC-1918. Минимальный допустимый размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes Service.
- Каждый блок должен иметь маршрут к VPC, использующему блоки VPC CIDR, а не публичные IP-адреса или Elastic IP-адреса. Существует много вариантов, включая Transit Gateway, Site-to-Site VPN или Direct Connect.
- Каждый хост должен разрешать исходящее соединение с контрольной плоскостью кластера EKS по TCP-портам
443и10250. - Каждый хост должен разрешать входящее соединение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций логирования, exec и port-forward.
- Каждый хост должен разрешать TCP и UDP сетевое соединение с другими хостами, на которых запущен
CoreDNS, по UDP-порту53для имен служб и pod DNS.
cidrs -> (список)
Сетевой CIDR, который может содержать гибридные узлы.
Эти блоки CIDR определяют ожидаемый диапазон IP-адресов гибридных узлов, которые присоединяются к кластеру. Эти блоки обычно определяются вашим системным администратором.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в диапазоне сети
IPv4RFC-1918. Минимальный допустимый размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes Service.
- Каждый блок должен иметь маршрут к VPC, использующему блоки VPC CIDR, а не публичные IP-адреса или Elastic IP-адреса. Существует много вариантов, включая Transit Gateway, Site-to-Site VPN или Direct Connect.
- Каждый хост должен разрешать исходящее соединение с контрольной плоскостью кластера EKS по TCP-портам
443и10250. - Каждый хост должен разрешать входящее соединение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций логирования, exec и port-forward.
- Каждый хост должен разрешать TCP и UDP сетевое соединение с другими хостами, на которых запущен
CoreDNS, по UDP-порту53для имен служб и pod DNS.
(строка)
remotePodNetworks -> (список)
Список сетевых CIDR, которые могут содержать pod, выполняющие Kubernetes webhooks на гибридных узлах.
(структура)
Сетевой CIDR, который может содержать pod, выполняющие Kubernetes webhooks на гибридных узлах.
Эти блоки CIDR определяются путем настройки вашего плагина Container Network Interface (CNI). Рекомендуется использовать Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и периферийных расположений.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в диапазоне сети
IPv4RFC-1918. Минимальный допустимый размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes Service.
cidrs -> (список)
Сетевой CIDR, который может содержать pod, выполняющие Kubernetes webhooks на гибридных узлах.
Эти блоки CIDR определяются путем настройки вашего плагина Container Network Interface (CNI). Рекомендуется использовать Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и периферийных расположений.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в диапазоне сети
IPv4RFC-1918. Минимальный допустимый размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes Service.
(строка)
computeConfig -> (структура)
Указывает текущую конфигурацию вычислительных возможностей вашего кластера EKS в режиме Auto Mode. Например, если эта возможность включена или выключена. Если вычислительные возможности включены, EKS Auto Mode будет создавать и удалять управляемые экземпляры EC2 в вашей учетной записи Amazon Web Services. Для получения дополнительной информации см. вычислительные возможности EKS Auto Mode в руководстве пользователя Amazon EKS.
enabled -> (boolean)
nodePools -> (список)
Указывает текущую конфигурацию пулов узлов в вашем кластере EKS в режиме Auto Mode. Для получения дополнительной информации см. пулы узлов EKS Auto Mode в руководстве пользователя Amazon EKS.
(строка)
nodeRoleArn -> (строка)
storageConfig -> (структура)
Указывает текущую конфигурацию возможностей блочного хранения в вашем кластере EKS в режиме Auto Mode. Например, если возможность включена или выключена. Если возможность блочного хранения включена, EKS Auto Mode будет создавать и удалять тома EBS в вашей учетной записи Amazon Web Services. Для получения дополнительной информации см. возможность блочного хранения EKS Auto Mode в руководстве пользователя Amazon EKS.
blockStorage -> (структура)
Указывает текущую конфигурацию возможностей блочного хранения в вашем кластере EKS в режиме Auto Mode. Например, если возможность включена или выключена.
enabled -> (boolean)
© Copyright 2025, Amazon Web Services. Created using Sphinx.