обновить-конфигурацию-кластера

Описание

Обновляет конфигурацию кластера Amazon EKS. Ваш кластер продолжает функционировать во время обновления. В выходных данных ответа содержится идентификатор обновления, который можно использовать для отслеживания статуса обновления кластера с помощью DescribeUpdate .

Вы можете использовать эту операцию для следующих действий:

• Вы можете использовать эту операцию API для включения или отключения экспорта журналов управления Kubernetes для вашего кластера в CloudWatch Logs. По умолчанию журналы управления кластера не экспортируются в CloudWatch Logs. Дополнительную информацию см. в разделе Журналы управления кластером Amazon EKS в * Руководстве пользователя Amazon EKS *.

• Вы также можете использовать эту операцию API для включения или отключения публичного и частного доступа к конечной точке API-сервера Kubernetes вашего кластера. По умолчанию публичный доступ включен, а частный доступ отключен. Дополнительную информацию см. в разделе Управление доступом к конечным точкам кластера Amazon EKS в * Руководстве пользователя Amazon EKS *.
• Вы также можете использовать эту операцию API для выбора различных подсетей и групп безопасности для кластера. Вы должны указать как минимум две подсети, которые находятся в разных зонах доступности. Вы не можете изменить VPC, из которого происходят подсети, подсети должны находиться в той же VPC, что и подсети, с которыми был создан кластер. Дополнительную информацию о требованиях к VPC см. в https://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html в * Руководстве пользователя Amazon EKS *.
• Вы также можете использовать эту операцию API для включения или отключения смещения зон ARC. Если смещение зон включено, Amazon Web Services настраивает автоматическое смещение зон для кластера.
• Вы также можете использовать эту операцию API для добавления, изменения или удаления конфигурации в кластере для узлов EKS Hybrid. Чтобы удалить конфигурацию, используйте ключ remoteNetworkConfig со словарем, содержащим оба подключа, с пустыми массивами для каждого. Вот пример в строке: "remoteNetworkConfig": { "remoteNodeNetworks": [], "remotePodNetworks": [] } .

Обновления кластера выполняются асинхронно и должны завершиться в течение нескольких минут. Во время обновления статус кластера переходит в состояние UPDATING (эта переход состояния является согласованной по времени). Когда обновление завершено (либо Failed, либо Successful), состояние кластера переходит в Active .

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

Синтаксис

  update-cluster-config
--name <value>
[--resources-vpc-config <value>]
[--logging <value>]
[--client-request-token <value>]
[--access-config <value>]
[--upgrade-policy <value>]
[--zonal-shift-config <value>]
[--compute-config <value>]
[--kubernetes-network-config <value>]
[--storage-config <value>]
[--remote-network-config <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 (строка)

--resources-vpc-config (структура)

Краткая форма синтаксиса:

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", ...]
}

--logging (структура)

Синтаксис JSON:

{
  "clusterLogging": [
    {
      "types": ["api"|"audit"|"authenticator"|"controllerManager"|"scheduler", ...],
      "enabled": true|false
    }
    ...
  ]
}

--client-request-token (строка)

--access-config (структура)

Краткая форма синтаксиса:

authenticationMode=string

Синтаксис JSON:

{
  "authenticationMode": "API"|"API_AND_CONFIG_MAP"|"CONFIG_MAP"
}

--upgrade-policy (структура)

Краткая форма синтаксиса:

supportType=string

Синтаксис JSON:

{
  "supportType": "STANDARD"|"EXTENDED"
}

--zonal-shift-config (структура)

Краткая форма синтаксиса:

enabled=boolean

Синтаксис JSON:

{
  "enabled": true|false
}

--compute-config (структура)

Краткая форма синтаксиса:

enabled=boolean,nodePools=string,string,nodeRoleArn=string

Синтаксис JSON:

{
  "enabled": true|false,
  "nodePools": ["string", ...],
  "nodeRoleArn": "string"
}

--kubernetes-network-config (структура)

Краткая форма синтаксиса:

serviceIpv4Cidr=string,ipFamily=string,elasticLoadBalancing={enabled=boolean}

Синтаксис JSON:

{
  "serviceIpv4Cidr": "string",
  "ipFamily": "ipv4"|"ipv6",
  "elasticLoadBalancing": {
    "enabled": true|false
  }
}

--storage-config (структура)

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

blockStorage={enabled=boolean}

Синтаксис JSON:

{
  "blockStorage": {
    "enabled": true|false
  }
}

--remote-network-config (структура)

Синтаксис JSON:

{
  "remoteNodeNetworks": [
    {
      "cidrs": ["string", ...]
    }
    ...
  ],
  "remotePodNetworks": [
    {
      "cidrs": ["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)

Файл сертификатов 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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, 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 eks update-cluster-config --name example \
--resources-vpc-config endpointPublicAccess=false,endpointPrivateAccess=true

Вывод:

{
    "update": {
        "id": "ec883c93-2e9e-407c-a22f-8f6fa6e67d4f",
        "status": "InProgress",
        "type": "EndpointAccessUpdate",
        "params": [
            {
                "type": "EndpointPublicAccess",
                "value": "false"
            },
            {
                "type": "EndpointPrivateAccess",
                "value": "true"
            }
        ],
        "createdAt": 1565806986.506,
        "errors": []
    }
}

Включение ведения журнала для кластера

В этом примере команды включается ведение журнала для всех типов узлов управления кластера для кластера под названием example.

Команда:

aws eks update-cluster-config --name example \
--logging '{"clusterLogging":[{"types":["api","audit","authenticator","controllerManager","scheduler"],"enabled":true}]}'

Вывод:

{
    "update": {
        "id": "7551c64b-1d27-4b1e-9f8e-c45f056eb6fd",
        "status": "InProgress",
        "type": "LoggingUpdate",
        "params": [
            {
                "type": "ClusterLogging",
                "value": "{\"clusterLogging\":[{\"types\":[\"api\",\"audit\",\"authenticator\",\"controllerManager\",\"scheduler\"],\"enabled\":true}]}"
            }
        ],
        "createdAt": 1565807210.37,
        "errors": []
    }
}

Вывод

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