update-nodegroup-version

Описание

Обновляет версию Kubernetes или версию AMI управляемой группы узлов Amazon EKS.

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

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

Если вы обновляете без шаблона запуска, то вы можете обновить до последней доступной версии AMI для текущей версии Kubernetes группы узлов, не указывая версию Kubernetes в запросе. Вы можете обновить до последней версии AMI для текущей версии Kubernetes вашего кластера, указав версию Kubernetes вашего кластера в запросе. Сведения о версиях Linux см. в Руководстве пользователя Amazon EKS в разделе «Оптимизированные версии Amazon Linux AMI для Amazon EKS». Сведения о версиях Windows см. в Руководстве пользователя Amazon EKS в разделе «Оптимизированные версии AMI Windows для Amazon EKS».

Вы не можете откатить группу узлов к более ранней версии Kubernetes или AMI.

При завершении работы узла в управляемой группе узлов из-за действия масштабирования или обновления, все Pod на этом узле сначала выводятся. Amazon EKS пытается выполнить вывод узлов плавно и завершится неудачей, если это невозможно. Вы можете force обновление, если Amazon EKS не может вывести узлы из-за проблемы с Pod бюджетом прерываний.

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

Синтаксис

  update-nodegroup-version
--cluster-name <value>
--nodegroup-name <value>
[--release-version <value>]
[--launch-template <value>]
[--force | --no-force]
[--client-request-token <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]

Параметры

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

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

--release-version (строка)

--launch-template (структура)

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

name=string,version=string,id=string

Синтаксис JSON:

{
  "name": "string",
  "version": "string",
  "id": "string"
}

--force | --no-force (булево)

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

--kubernetes-version (строка)

--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
• text
• таблица
• 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.

Примеры

Пример 1: Обновление версии Kubernetes или AMI управляемой группы узлов Amazon EKS

Следующий update-nodegroup-version пример обновляет версию Kubernetes или версию AMI управляемой группы узлов Amazon EKS до последней доступной версии для вашего кластера Kubernetes.

aws eks update-nodegroup-version \
    --cluster-name my-eks-cluster \
    --nodegroup-name my-eks-nodegroup \
    --no-force

Вывод:

{
    "update": {
        "id": "a94ebfc3-6bf8-307a-89e6-7dbaa36421f7",
        "status": "InProgress",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "1.26"
            },
            {
                "type": "ReleaseVersion",
                "value": "1.26.12-20240329"
            }
        ],
        "createdAt": "2024-04-08T13:16:00.724000-04:00",
        "errors": []
    }
}

Дополнительные сведения см. в Руководстве пользователя Amazon EKS в разделе «Обновление управляемой группы узлов».

Пример 2: Обновление версии Kubernetes или AMI управляемой группы узлов Amazon EKS

Следующий update-nodegroup-version пример обновляет версию Kubernetes или версию AMI управляемой группы узлов Amazon EKS до указанной версии AMI.

aws eks update-nodegroup-version \
    --cluster-name my-eks-cluster \
    --nodegroup-name my-eks-nodegroup \
    --kubernetes-version '1.26' \
    --release-version '1.26.12-20240307' \
    --no-force

Вывод:

{
    "update": {
        "id": "4db06fe1-088d-336b-bdcd-3fdb94995fb7",
        "status": "InProgress",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "1.26"
            },
            {
                "type": "ReleaseVersion",
                "value": "1.26.12-20240307"
            }
        ],
        "createdAt": "2024-04-08T13:13:58.595000-04:00",
        "errors": []
    }
}

Дополнительные сведения см. в `Обновление управляемой группы узлов - <https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html>``__ в Руководстве пользователя Amazon EKS.

Вывод

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