create-cluster
Описание
Создаёт управляющую плоскость Amazon EKS.
Управляющая плоскость Amazon EKS состоит из экземпляров управляющей плоскости, на которых выполняется программное обеспечение Kubernetes, например, etcd и API-сервер. Управляющая плоскость работает в аккаунте, управляемом Amazon Web Services, а API Kubernetes предоставляется с помощью конечной точки API-сервера Amazon EKS. Каждая управляющая плоскость кластера Amazon EKS является однопользовательской и уникальной. Она выполняется на собственном наборе экземпляров Amazon EC2.
Управляющая плоскость кластера развертывается в нескольких зонах доступности и поддерживается сетевым балансировщиком Elastic Load Balancing. Amazon EKS также разворачивает эластичные сетевые интерфейсы в подсетях вашей VPC, чтобы обеспечить подключение от экземпляров управляющей плоскости к узлам (например, для поддержки kubectl exec , logs и proxy потоков данных).
Узлы Amazon EKS работают в вашем аккаунте Amazon Web Services и подключаются к управляющей плоскости вашего кластера через конечную точку API-сервера Kubernetes и файл сертификата, созданный для вашего кластера.
Вы можете использовать параметры endpointPublicAccess и endpointPrivateAccess для включения или отключения публичного и частного доступа к конечной точке API-сервера Kubernetes вашего кластера. По умолчанию публичный доступ включен, а частный — отключён. Дополнительную информацию см. в разделе Управление доступом к конечной точке кластера Amazon EKS в * Руководстве пользователя Amazon EKS *.
Вы можете использовать параметр logging для включения или отключения экспорта журналов управляющей плоскости Kubernetes вашего кластера в CloudWatch Logs. По умолчанию журналы управляющей плоскости кластера не экспортируются в CloudWatch Logs. Дополнительную информацию см. в разделе Журналы управляющей плоскости кластера Amazon EKS в * Руководстве пользователя Amazon EKS *.
Примечание
Скорость загрузки, архивирования и сканирования данных в CloudWatch Logs относится к экспортируемым журналам управляющей плоскости. Дополнительную информацию см. в разделе Цены на CloudWatch.В большинстве случаев создание кластера занимает несколько минут. После создания кластера Amazon EKS необходимо настроить ваши инструменты Kubernetes для взаимодействия с API-сервером и запуска узлов в ваш кластер. Дополнительную информацию см. в разделе Разрешение пользователям доступа к вашему кластеру и Запуск узлов Amazon EKS в * Руководстве пользователя Amazon EKS *.
См. также: Документация API AWS
Синопсис
create-cluster
--name <value>
--role-arn <value>
--resources-vpc-config <value>
[--kubernetes-network-config <value>]
[--logging <value>]
[--client-request-token <value>]
[--tags <value>]
[--encryption-config <value>]
[--outpost-config <value>]
[--access-config <value>]
[--bootstrap-self-managed-addons | --no-bootstrap-self-managed-addons]
[--upgrade-policy <value>]
[--zonal-shift-config <value>]
[--remote-network-config <value>]
[--compute-config <value>]
[--storage-config <value>]
[--kubernetes-version <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 (строка)
--role-arn (строка)
--resources-vpc-config (структура)
Настройка VPC, используемая управляющей плоскостью кластера. Ресурсы VPC Amazon EKS имеют определенные требования для правильной работы с Kubernetes. Дополнительную информацию см. в разделах Cluster VPC Considerations и Cluster Security Group Considerations в Руководстве пользователя Amazon EKS. Вы должны указать как минимум два подсети. Вы можете указать до пяти групп безопасности. Однако рекомендуется использовать отдельную группу безопасности для управляющей плоскости кластера.
subnetIds -> (список)
Укажите подсети для узлов Amazon EKS. Amazon EKS создает сетевые интерфейсы с кросс-аккаунтным доступом в этих подсетях, чтобы разрешить взаимодействие между вашими узлами и управляющей плоскостью Kubernetes.
(строка)
securityGroupIds -> (список)
Укажите одну или несколько групп безопасности для кросс-аккаунтных сетевых интерфейсов, которые Amazon EKS создает для обеспечения взаимодействия между вашими узлами и управляющей плоскостью Kubernetes. Если вы не указываете группы безопасности, ознакомьтесь с различиями между значениями по умолчанию Amazon EKS для кластеров, развернутых с Kubernetes. Дополнительную информацию см. в разделе Amazon EKS security group considerations в * Руководстве пользователя Amazon EKS *.
(строка)
endpointPublicAccess -> (булево)
false, чтобы отключить общедоступный доступ к конечному пункту API сервера Kubernetes вашего кластера. Если вы отключите общедоступный доступ, сервер API Kubernetes вашего кластера может принимать запросы только изнутри VPC кластера. Значение по умолчанию для этого параметра — true, что включает общедоступный доступ для вашего сервера API Kubernetes. Дополнительную информацию см. в разделе Amazon EKS cluster endpoint access control в * Руководстве пользователя Amazon EKS *.endpointPrivateAccess -> (булево)
true, чтобы включить частный доступ к конечному пункту API сервера Kubernetes вашего кластера. Если вы включите частный доступ, запросы к API Kubernetes изнутри VPC вашего кластера используют частный конечный пункт VPC. Значение по умолчанию для этого параметра — false, что отключает частный доступ для вашего сервера API Kubernetes. Если вы отключите частный доступ и у вас есть узлы или Fargate-поды в кластере, убедитесь, что publicAccessCidrs включает необходимые CIDR-блоки для взаимодействия с узлами или Fargate-подами. Дополнительную информацию см. в разделе Amazon EKS cluster endpoint access control в * Руководстве пользователя Amazon EKS *.publicAccessCidrs -> (список)
CIDR-блоки, которым разрешен доступ к общедоступному конечному пункту API сервера Kubernetes вашего кластера. Взаимодействие с конечным пунктом из адресов за пределами указанных вами CIDR-блоков запрещено. Значение по умолчанию — 0.0.0.0/0. Если вы отключили частный доступ к конечному пункту, убедитесь, что вы указали необходимые CIDR-блоки для каждого узла и Fargate-подов Pod в кластере. Дополнительную информацию см. в разделе Amazon EKS cluster endpoint access control в * Руководстве пользователя Amazon EKS *.
(строка)
Сокращенная синтаксическая запись:
subnetIds=string,string,securityGroupIds=string,string,endpointPublicAccess=boolean,endpointPrivateAccess=boolean,publicAccessCidrs=string,string
Синтаксис JSON:
{
"subnetIds": ["string", ...],
"securityGroupIds": ["string", ...],
"endpointPublicAccess": true|false,
"endpointPrivateAccess": true|false,
"publicAccessCidrs": ["string", ...]
}
--kubernetes-network-config (структура)
Конфигурация сети Kubernetes для кластера.
serviceIpv4Cidr -> (строка)
Не указывайте значение, если вы выбрали ipv6 для ipFamily. CIDR-блок для присвоения адресов IP-сервисов Kubernetes. Если вы не указываете блок, Kubernetes присваивает адреса из 10.100.0.0/16 или 172.20.0.0/16 CIDR-блоков. Рекомендуется указать блок, не перекрывающийся с ресурсами в других сетях, которые объединены или подключены к вашей VPC. Блок должен соответствовать следующим требованиям:
- Внутри одного из следующих блоков частных IP-адресов:
10.0.0.0/8,172.16.0.0/12или192.168.0.0/16. - Не перекрывается с любым CIDR-блоком, назначенным VPC, выбранной для VPC.
- Между
/24и/12.
Предупреждение
Вы можете указать только пользовательский CIDR-блок при создании кластера. Вы не можете изменить это значение после создания кластера.ipFamily -> (строка)
Укажите, какая семейство IP используется для назначения адресов IP-под и сервисов Kubernetes. Если вы не указываете значение, по умолчанию используется ipv4. Вы можете указать семейство IP только при создании кластера и не можете изменить это значение после создания кластера. Если вы укажете ipv6, VPC и подсети, которые вы указываете для создания кластера, должны иметь назначенные как IPv4, так и IPv6 CIDR-блоки. Вы не можете указать ipv6 для кластеров в регионах Китая.
Вы можете указать только ipv6 для кластеров 1.21 и более поздних версий, использующих версию 1.10.1 или более позднюю плагина Amazon VPC CNI. Если вы указываете ipv6, убедитесь, что ваша VPC соответствует требованиям, указанным в разделах по рассмотрению вопросов, приведенных в разделе Назначение IPv6-адресов под и сервисов в Руководстве пользователя Amazon EKS. Kubernetes назначает сервисам IPv6 адреса из уникального диапазона локальных адресов (fc00::/7). Вы не можете указать пользовательский IPv6 CIDR-блок. Адреса под присваиваются из IPv6 CIDR подсети.
elasticLoadBalancing -> (структура)
Запрос на включение или отключение возможности балансировки нагрузки на вашем кластере EKS в режиме Автоматический. Дополнительную информацию см. в разделе Возможность балансировки нагрузки в режиме EKS Auto Mode в Руководстве пользователя Amazon EKS.
enabled -> (булево)
Сокращенная синтаксическая запись:
serviceIpv4Cidr=string,ipFamily=string,elasticLoadBalancing={enabled=boolean}
Синтаксис JSON:
{
"serviceIpv4Cidr": "string",
"ipFamily": "ipv4"|"ipv6",
"elasticLoadBalancing": {
"enabled": true|false
}
}
--logging (структура)
Включить или отключить экспорт журналов управляющей плоскости Kubernetes вашего кластера в CloudWatch Logs. По умолчанию журналы управляющей плоскости кластера не экспортируются в CloudWatch Logs. Дополнительную информацию см. в разделе Amazon EKS Cluster control plane logs в * Руководстве пользователя Amazon EKS *.
Примечание
Скорости загрузки, архивации и сканирования данных CloudWatch Logs применяются к экспортируемым журналам управляющей плоскости. Дополнительную информацию см. в разделе Цены CloudWatch.clusterLogging -> (список)
Конфигурация ведения журнала управляющей плоскости кластера для вашего кластера.
(структура)
Объект, представляющий включенные или отключенные журналы управляющей плоскости Kubernetes для вашего кластера.
types -> (список)
Доступные типы журналов управляющей плоскости кластера.
(строка)
enabled -> (булево)
--client-request-token (строка)
--tags (массив)
Метаданные, которые помогают с категоризацией и организацией. Каждый тег состоит из ключа и необязательного значения. Вы определяете оба. Теги не распространяются на другие кластеры или ресурсы Amazon Web Services.
key -> (строка)
value -> (строка)
Сокращенная синтаксическая запись:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--encryption-config (список)
Конфигурация шифрования для кластера.
(структура)
Конфигурация шифрования для кластера.
resources -> (список)
Указывает ресурсы, которые должны быть зашифрованы. Поддерживается только значение secrets.
(строка)
provider -> (структура)
Ключ Key Management Service (KMS). Можно использовать либо ARN, либо псевдоним.
keyArn -> (строка)
Сокращенная синтаксическая запись:
resources=string,string,provider={keyArn=string} ...
Синтаксис JSON:
[
{
"resources": ["string", ...],
"provider": {
"keyArn": "string"
}
}
...
]
--outpost-config (структура)
Объект, представляющий конфигурацию вашего локального кластера Amazon EKS в Amazon Web Services Outpost. Перед созданием локального кластера в Outpost, ознакомьтесь с разделом Локальные кластеры для Amazon EKS в Amazon Web Services Outposts в Руководстве пользователя Amazon EKS . Этот объект недоступен для создания кластеров Amazon EKS в облаке Amazon Web Services.
outpostArns -> (список)
ARN Outpost, который вы хотите использовать для своего локального кластера Amazon EKS в Outposts. Поддерживается только один Outpost ARN.
(строка)
controlPlaneInstanceType -> (строка)
Тип экземпляра Amazon EC2, который вы хотите использовать для своего локального кластера Amazon EKS в Outposts. Выберите тип экземпляра на основе количества узлов в вашем кластере. Дополнительную информацию см. в разделе Учет емкости в Руководстве пользователя Amazon EKS .
Указанный вами тип экземпляра используется для всех экземпляров управления Kubernetes. Тип экземпляра изменить нельзя после создания кластера. Amazon EKS не масштабирует плоскость управления автоматически.
controlPlanePlacement -> (структура)
Объект, представляющий конфигурацию размещения всех экземпляров плоскости управления вашего локального кластера Amazon EKS в Amazon Web Services Outpost. Дополнительную информацию см. в разделе Учет емкости в Руководстве пользователя Amazon EKS .
groupName -> (строка)
Краткий синтаксис:
outpostArns=string,string,controlPlaneInstanceType=string,controlPlanePlacement={groupName=string}
Синтаксис JSON:
{
"outpostArns": ["string", ...],
"controlPlaneInstanceType": "string",
"controlPlanePlacement": {
"groupName": "string"
}
}
--access-config (структура)
Конфигурация доступа к кластеру.
bootstrapClusterCreatorAdminPermissions -> (логическое значение)
true .authenticationMode -> (строка)
CONFIG_MAP . Если вы создаете кластер с помощью консоли управления Amazon Web Services, значение по умолчанию — API_AND_CONFIG_MAP .Краткий синтаксис:
bootstrapClusterCreatorAdminPermissions=boolean,authenticationMode=string
Синтаксис JSON:
{
"bootstrapClusterCreatorAdminPermissions": true|false,
"authenticationMode": "API"|"API_AND_CONFIG_MAP"|"CONFIG_MAP"
}
--bootstrap-self-managed-addons | --no-bootstrap-self-managed-addons (логическое значение)
Если вы установите это значение в False при создании кластера, плагины сети по умолчанию не будут установлены.
Плагины сети по умолчанию включают vpc-cni, coredns и kube-proxy.
Используйте этот параметр, если вы планируете установить сторонние плагины или самостоятельно управлять плагинами сети по умолчанию.
--upgrade-policy (структура)
В новых кластерах по умолчанию включена расширенная поддержка. Вы можете отключить расширенную поддержку при создании кластера, установив это значение в STANDARD .
supportType -> (строка)
Если для кластера установлено значение EXTENDED , он перейдет к расширенной поддержке по окончании стандартной поддержки. Если для кластера установлено значение STANDARD , он будет автоматически обновлен по окончании стандартной поддержки.
Краткий синтаксис:
supportType=string
Синтаксис JSON:
{
"supportType": "STANDARD"|"EXTENDED"
}
--zonal-shift-config (структура)
Включить или отключить сдвиг зоны ARC для кластера. Если сдвиг зоны включен, Amazon Web Services настраивает автоматический сдвиг зон для кластера.
Сдвиг зоны — это функция контроллера восстановления приложений Amazon (ARC). Сдвиг зоны ARC предназначен для временных мер, позволяющих переместить трафик ресурса из поврежденной зоны AZ до истечения срока действия сдвига или его отмены. При необходимости можно продлить сдвиг зоны.
Вы можете начать сдвиг зоны для кластера Amazon EKS или разрешить Amazon Web Services сделать это за вас, включив *автоматический сдвиг зоны*. Этот сдвиг обновит поток трафика между узлами внутри кластера, учитывая только сетевые конечные точки для Pod, работающих на рабочих узлах в работоспособных зонах AZ. Кроме того, любые ALB или NLB, обрабатывающие входящий трафик для приложений в вашем кластере Amazon EKS, автоматически перенаправят трафик на цели в работоспособных зонах AZ. Дополнительную информацию о сдвиге зон в EKS см. в разделе Узнайте о сдвиге зон Amazon Application Recovery Controller (ARC) в Amazon EKS в * Руководстве пользователя Amazon EKS * .
enabled -> (логическое значение)
Краткий синтаксис:
enabled=boolean
Синтаксис JSON:
{
"enabled": true|false
}
--remote-network-config (структура)
Настройка кластера для узлов EKS Hybrid Nodes. Вы можете добавить, изменить или удалить эту настройку после создания кластера.
remoteNodeNetworks -> (список)
Список CIDR-блоков сети, которые могут содержать гибридные узлы.
Эти CIDR-блоки определяют ожидаемый диапазон IP-адресов гибридных узлов, присоединяющихся к кластеру. Обычно эти блоки определяются вашим системным администратором.
Введите один или несколько IPv4 CIDR-блоков в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в
IPv4диапазоне сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном CIDR-блоков VPC для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
- Каждый блок должен иметь маршрут к VPC, использующий блоки CIDR VPC, а не публичные IP-адреса или Elastic IP-адреса. Существует множество вариантов, включая Transit Gateway, VPN «точка-точка» или Direct Connect.
- Каждый хост должен допускать исходящее соединение с контрольной плоскостью кластера EKS по TCP-портам
443и10250. - Каждый хост должен допускать входящее соединение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций журналов, exec и перенаправления портов.
- Каждый хост должен допускать TCP и UDP сетевое соединение с другими хостами, на которых запущен
CoreDNS, по UDP-порту53для имен сервисов и под.
(структура)
CIDR-блок сети, который может содержать гибридные узлы.
Эти CIDR-блоки определяют ожидаемый диапазон IP-адресов гибридных узлов, присоединяющихся к кластеру. Обычно эти блоки определяются вашим системным администратором.
Введите один или несколько IPv4 CIDR-блоков в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в
IPv4диапазоне сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном CIDR-блоков VPC для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
- Каждый блок должен иметь маршрут к VPC, использующий блоки CIDR VPC, а не публичные IP-адреса или Elastic IP-адреса. Существует множество вариантов, включая Transit Gateway, VPN «точка-точка» или Direct Connect.
- Каждый хост должен допускать исходящее соединение с контрольной плоскостью кластера EKS по TCP-портам
443и10250. - Каждый хост должен допускать входящее соединение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций журналов, exec и перенаправления портов.
- Каждый хост должен допускать TCP и UDP сетевое соединение с другими хостами, на которых запущен
CoreDNS, по UDP-порту53для имен сервисов и под.
cidrs -> (список)
CIDR-блок сети, который может содержать гибридные узлы.
Эти CIDR-блоки определяют ожидаемый диапазон IP-адресов гибридных узлов, присоединяющихся к кластеру. Обычно эти блоки определяются вашим системным администратором.
Введите один или несколько IPv4 CIDR-блоков в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в
IPv4диапазоне сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном CIDR-блоков VPC для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
- Каждый блок должен иметь маршрут к VPC, использующий блоки CIDR VPC, а не публичные IP-адреса или Elastic IP-адреса. Существует множество вариантов, включая Transit Gateway, VPN «точка-точка» или Direct Connect.
- Каждый хост должен допускать исходящее соединение с контрольной плоскостью кластера EKS по TCP-портам
443и10250. - Каждый хост должен допускать входящее соединение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций журналов, exec и перенаправления портов.
- Каждый хост должен допускать TCP и UDP сетевое соединение с другими хостами, на которых запущен
CoreDNS, по UDP-порту53для имен сервисов и под.
(строка)
remotePodNetworks -> (список)
Список CIDR-блоков сети, которые могут содержать под, выполняющие Kubernetes-вебхуки на гибридных узлах.
Эти CIDR-блоки определяются путем настройки плагина Container Network Interface (CNI). Мы рекомендуем плагины Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и периферийных местоположений.
Введите один или несколько IPv4 CIDR-блоков в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в
IPv4диапазоне сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном CIDR-блоков VPC для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
(структура)
CIDR-блок сети, который может содержать под, выполняющие Kubernetes-вебхуки на гибридных узлах.
Эти CIDR-блоки определяются путем настройки плагина Container Network Interface (CNI). Мы рекомендуем плагины Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и периферийных местоположений.
Введите один или несколько IPv4 CIDR-блоков в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в
IPv4диапазоне сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном CIDR-блоков VPC для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
cidrs -> (список)
CIDR-блок сети, который может содержать под, выполняющие Kubernetes-вебхуки на гибридных узлах.
Эти CIDR-блоки определяются путем настройки плагина Container Network Interface (CNI). Мы рекомендуем плагины Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и периферийных местоположений.
Введите один или несколько IPv4 CIDR-блоков в десятичной точечной нотации (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в
IPv4диапазоне сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен перекрываться с диапазоном CIDR-блоков VPC для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
(строка)
Синтаксис JSON:
{
"remoteNodeNetworks": [
{
"cidrs": ["string", ...]
}
...
],
"remotePodNetworks": [
{
"cidrs": ["string", ...]
}
...
]
}
--compute-config (структура)
Включить или выключить вычислительные возможности EKS Auto Mode при создании кластера EKS Auto Mode. Если возможность включена, EKS Auto Mode будет создавать и удалять управляемые EC2-инстансы в вашей учетной записи Amazon Web Services.
enabled -> (булево)
nodePools -> (список)
Настройка пулов узлов, определяющая вычислительные ресурсы для вашего кластера EKS Auto Mode. Дополнительные сведения см. в разделе «Пулы узлов EKS Auto Mode» в руководстве пользователя Amazon EKS.
(строка)
nodeRoleArn -> (строка)
Краткая синтаксическая запись:
enabled=boolean,nodePools=string,string,nodeRoleArn=string
Синтаксис JSON:
{
"enabled": true|false,
"nodePools": ["string", ...],
"nodeRoleArn": "string"
}
--storage-config (структура)
Включить или выключить возможность работы с блочными хранилищами в EKS Auto Mode при создании кластера EKS Auto Mode. Если возможность включена, EKS Auto Mode будет создавать и удалять тома EBS в вашей учетной записи Amazon Web Services.
blockStorage -> (структура)
Запрос на настройку параметров EBS Block Storage для вашего кластера EKS Auto Mode.
enabled -> (булево)
Краткая синтаксическая запись:
blockStorage={enabled=boolean}
Синтаксис JSON:
{
"blockStorage": {
"enabled": true|false
}
}
--kubernetes-version (строка)
Желаемая версия Kubernetes для вашего кластера. Если вы не укажете значение, используется версия по умолчанию, доступная в Amazon EKS.
Примечание
Версия по умолчанию может не быть последней доступной версией.--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)
Файл сертификатов CA для проверки 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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. Подробнее см. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для создания нового кластера
Эта команда создает кластер с именем prod в вашем стандартном регионе.
Команда:
aws eks create-cluster --name prod \
--role-arn arn:aws:iam::012345678910:role/eks-service-role-AWSServiceRoleForAmazonEKS-J7ONKE3BQ4PI \
--resources-vpc-config subnetIds=subnet-6782e71e,subnet-e7e761ac,securityGroupIds=sg-6979fe18
Вывод:
{
"cluster": {
"name": "prod",
"arn": "arn:aws:eks:us-west-2:012345678910:cluster/prod",
"createdAt": 1527808069.147,
"version": "1.10",
"roleArn": "arn:aws:iam::012345678910:role/eks-service-role-AWSServiceRoleForAmazonEKS-J7ONKE3BQ4PI",
"resourcesVpcConfig": {
"subnetIds": [
"subnet-6782e71e",
"subnet-e7e761ac"
],
"securityGroupIds": [
"sg-6979fe18"
],
"vpcId": "vpc-950809ec"
},
"status": "CREATING",
"certificateAuthority": {}
}
}
Для создания нового кластера с доступом к частному шлюзу и включенным логированием
Эта команда создает кластер с именем example в вашем стандартном регионе с отключенным общедоступным доступом, включенным доступом к частному шлюзу и включенным всем типам логирования.
Команда:
aws eks create-cluster --name example --kubernetes-version 1.12 \
--role-arn arn:aws:iam::012345678910:role/example-cluster-ServiceRole-1XWBQWYSFRE2Q \
--resources-vpc-config subnetIds=subnet-0a188dccd2f9a632f,subnet-09290d93da4278664,subnet-0f21dd86e0e91134a,subnet-0173dead68481a583,subnet-051f70a57ed6fcab6,subnet-01322339c5c7de9b4,securityGroupIds=sg-0c5b580845a031c10,endpointPublicAccess=false,endpointPrivateAccess=true \
--logging '{"clusterLogging":[{"types":["api","audit","authenticator","controllerManager","scheduler"],"enabled":true}]}'
Вывод:
{
"cluster": {
"name": "example",
"arn": "arn:aws:eks:us-west-2:012345678910:cluster/example",
"createdAt": 1565804921.901,
"version": "1.12",
"roleArn": "arn:aws:iam::012345678910:role/example-cluster-ServiceRole-1XWBQWYSFRE2Q",
"resourcesVpcConfig": {
"subnetIds": [
"subnet-0a188dccd2f9a632f",
"subnet-09290d93da4278664",
"subnet-0f21dd86e0e91134a",
"subnet-0173dead68481a583",
"subnet-051f70a57ed6fcab6",
"subnet-01322339c5c7de9b4"
],
"securityGroupIds": [
"sg-0c5b580845a031c10"
],
"vpcId": "vpc-0f622c01f68d4afec",
"endpointPublicAccess": false,
"endpointPrivateAccess": true
},
"logging": {
"clusterLogging": [
{
"types": [
"api",
"audit",
"authenticator",
"controllerManager",
"scheduler"
],
"enabled": true
}
]
},
"status": "CREATING",
"certificateAuthority": {},
"platformVersion": "eks.3"
}
}
Вывод
кластер -> (структура)
Полное описание нового кластера.
name -> (строка)
arn -> (строка)
createdAt -> (временная метка)
version -> (строка)
endpoint -> (строка)
roleArn -> (строка)
resourcesVpcConfig -> (структура)
Конфигурация VPC, используемая узлом управления кластера. У Amazon EKS VPC есть конкретные требования для корректной работы с Kubernetes. Дополнительную информацию см. в разделах «Учётные записи VPC для кластеров» и «Учётные записи группы безопасности для кластеров» в руководстве пользователя Amazon EKS.
subnetIds -> (список)
Подсети, связанные с вашим кластером.
(строка)
securityGroupIds -> (список)
Группы безопасности, связанные с сетевыми интерфейсами elastic межаккаунтовой связи, которые используются для обеспечения связи между вашими узлами и узлом управления Kubernetes.
(строка)
clusterSecurityGroupId -> (строка)
vpcId -> (строка)
endpointPublicAccess -> (булево)
endpointPrivateAccess -> (булево)
publicAccessCidrs содержит необходимые CIDR-блоки для связи с узлами или контейнерами Fargate. Дополнительную информацию см. в разделе «Управление доступом к конечным точкам кластера Amazon EKS» в руководстве пользователя Amazon EKS.publicAccessCidrs -> (список)
CIDR-блоки, которым разрешён доступ к общедоступному конечном пункту сервера API Kubernetes вашего кластера.
(строка)
kubernetesNetworkConfig -> (структура)
Конфигурация сети Kubernetes для кластера.
serviceIpv4Cidr -> (строка)
Pod и Service назначают адреса объектов IP. Kubernetes назначает адреса из IPv4 CIDR-блока, назначенного подсети, в которой находится узел. Если вы не указали CIDR-блок при создании кластера, Kubernetes назначит адреса из 10.100.0.0/16 или 172.20.0.0/16 CIDR-блоков. Если это было указано, то это было указано при создании кластера и не может быть изменено.serviceIpv6Cidr -> (строка)
ipv6 для ipFamily при создании кластера. Kubernetes назначает адреса служб из диапазона адресов уникальных локальных адресов (fc00::/7 ), так как вы не можете указать настраиваемый CIDR-блок IPv6 при создании кластера.ipFamily -> (строка)
Pod и Service. Семейство IP всегда равно ipv4 , если у вас нет кластера 1.21 или более поздней версии, работающей с плагином Amazon VPC CNI для Kubernetes версии 1.10.1 или более поздней, и вы указали ipv6 при создании кластера.elasticLoadBalancing -> (структура)
Указывает текущую конфигурацию возможности балансировки нагрузки в вашем кластере Amazon EKS в режиме «Авто». Например, если эта возможность включена или выключена.
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).
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).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в пределах
IPv4диапазона сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен пересекаться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
- Каждый блок должен иметь маршрут к VPC, использующий блоки VPC CIDR, а не публичные IP-адреса или Elastic IP. Существует множество вариантов, включая шлюз транзитной сети, VPN «точка-точка» или Direct Connect.
- Каждый хост должен разрешать исходящее подключение к контрольной плоскости кластера EKS по TCP-портам
443и10250. - Каждый хост должен разрешать входящее подключение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций журналов, exec и переадресации портов.
- Каждый хост должен разрешать TCP и UDP сетевое подключение к другим хостам, на которых запущена
CoreDNS, по UDP-порту53для имен служб и под.
cidrs -> (список)
CIDR сеть, которая может содержать гибридные узлы.
Эти блоки CIDR определяют ожидаемый диапазон IP-адресов гибридных узлов, присоединяющихся к кластеру. Эти блоки обычно определяются вашим сетевым администратором.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной записи (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в пределах
IPv4диапазона сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен пересекаться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
- Каждый блок должен иметь маршрут к VPC, использующий блоки VPC CIDR, а не публичные IP-адреса или Elastic IP. Существует множество вариантов, включая шлюз транзитной сети, VPN «точка-точка» или Direct Connect.
- Каждый хост должен разрешать исходящее подключение к контрольной плоскости кластера EKS по TCP-портам
443и10250. - Каждый хост должен разрешать входящее подключение от контрольной плоскости кластера EKS по TCP-порту 10250 для операций журналов, exec и переадресации портов.
- Каждый хост должен разрешать TCP и UDP сетевое подключение к другим хостам, на которых запущена
CoreDNS, по UDP-порту53для имен служб и под.
(строка)
remotePodNetworks -> (список)
Список CIDR сетей, которые могут содержать под, выполняющие Kubernetes webhooks на гибридных узлах.
(структура)
CIDR сеть, которая может содержать под, выполняющие Kubernetes webhooks на гибридных узлах.
Эти блоки CIDR определяются настройкой вашего плагина Container Network Interface (CNI). Рекомендуется использовать Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и граничных расположений.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной записи (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в пределах
IPv4диапазона сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен пересекаться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
cidrs -> (список)
CIDR сеть, которая может содержать под, выполняющие Kubernetes webhooks на гибридных узлах.
Эти блоки CIDR определяются настройкой вашего плагина Container Network Interface (CNI). Рекомендуется использовать Calico CNI или Cilium CNI. Обратите внимание, что плагин Amazon VPC CNI для Kubernetes недоступен для локальных и граничных расположений.
Введите один или несколько блоков IPv4 CIDR в десятичной точечной записи (например, 10.2.0.0/16).
Он должен удовлетворять следующим требованиям:
- Каждый блок должен находиться в пределах
IPv4диапазона сети RFC-1918. Минимальный разрешенный размер — /24, максимальный — /8. Публично маршрутизируемые адреса не поддерживаются. - Каждый блок не должен пересекаться с диапазоном блоков VPC CIDR для ваших ресурсов EKS или блоком диапазона IP-адресов Kubernetes-сервиса.
(строка)
computeConfig -> (структура)
Указывает текущую конфигурацию вычислительных возможностей вашего кластера EKS в режиме Автоматического масштабирования. Например, если возможность включена или отключена. Если вычислительная возможность включена, 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.