Spec-Zone.ru › Ansible 2.10

google.cloud.gcp_container_cluster – Создаёт кластер GCP

Примечание

Этот плагин является частью коллекции google.cloud (версия 1.0.1).

Для его установки используйте: ansible-galaxy collection install google.cloud.

Чтобы использовать его в плейбуке, укажите: google.cloud.gcp_container_cluster.

  • Обзор
  • Требования
  • Параметры
  • Примеры
  • Значения возврата

Обзор

  • Кластер Google Container Engine.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

  • python >= 2.6
  • requests >= 2.18.4
  • google-auth >= 1.3.0

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
addons_config
словарь
Настройки для различных плагинов (addons), доступных для запуска в кластере.
horizontal_pod_autoscaling
словарь
Настройки для функции горизонтального масштабирования под (horizontal pod autoscaling), которая увеличивает или уменьшает количество реплицируемых под (replica pods) у контроллера репликации (replication controller) на основе использования ресурсов существующих под.
disabled
булево
    Варианты:
  • нет
  • да
Включена ли функция горизонтального масштабирования под в кластере. При включении она гарантирует, что в кластере запущен под Heapster, который также используется службой Cloud Monitoring.
http_load_balancing
словарь
Настройки для плагина контроллера балансировки HTTP (L7), который упрощает настройку балансировщиков HTTP для служб в кластере.
disabled
булево
    Варианты:
  • нет
  • да
Включен ли контроллер HTTP балансировки в кластере. При включении он запускает небольшой под в кластере, который управляет балансировщиками.
network_policy_config
словарь
Настройки для NetworkPolicy. Отслеживается только включение/выключение плагина на Master-узле, не отслеживается включение Network Policy на узлах.
disabled
булево
    Варианты:
  • нет
  • да
Включена ли NetworkPolicy для этого кластера.
auth_kind
строка / обязательно
    Варианты:
  • application
  • machineaccount
  • serviceaccount
Тип используемых учетных данных.
binary_authorization
словарь
Настройки для функции BinaryAuthorization.
enabled
булево
    Варианты:
  • нет
  • да
Если включено, все контейнерные образы будут проверены Binary Authorization.
cluster_ipv4_cidr
строка
Диапазон IP-адресов контейнерных под в этом кластере в формате CIDR (например, 10.96.0.0/14). Оставьте пустым, чтобы выбрать автоматически, или укажите блок /14 в 10.0.0.0/8.
default_max_pods_constraint
словарь
Значение по умолчанию для ограничения максимального количества под, которые могут выполняться одновременно на узле в пуле узлов этого кластера.
Действует только если кластер создан с поддержкой IP Alias.
max_pods_per_node
строка
Ограничение максимального числа под на узел.
description
строка
Необязательное описание этого кластера.
enable_tpu
булево
    Варианты:
  • нет
  • да
(Необязательно) Включить ресурсы Cloud TPU в этом кластере.
См. официальную документацию - https://cloud.google.com/tpu/docs/kubernetes-engine-setup .
env_type
строка
Указывает, в какой среде Ansible выполняется этот модуль.
Не устанавливать, если вы не знаете, что делаете.
Изменяет только строку User Agent для всех запросов к API.
initial_cluster_version
строка
Версия ПО мастер-узла и kubelet, используемых в кластере при его первом создании. Версию можно обновлять со временем.
initial_node_count
целое число
Количество узлов для создания в этом кластере. Необходимо убедиться, что квота ресурсов Compute Engine достаточна для этого количества экземпляров. Также необходимо убедиться в наличии квоты на брандмауэры и маршруты. Для запросов этот параметр следует использовать только вместо объекта "nodePool", поскольку эта настройка (вместе с "nodeConfig") будет использоваться для создания объекта "NodePool" с автоматически сгенерированным именем. Не используйте одновременно этот параметр и nodePool.
Этот параметр устарел. Используйте nodePool.initial_node_count вместо него.
ip_allocation_policy
словарь
Настройки для управления тем, как распределяются IP-адреса в кластере.
cluster_ipv4_cidr_block
строка
Диапазон IP-адресов для под кластера. Если этот параметр задан, то cluster.cluster_ipv4_cidr должен быть пустым.
Этот параметр применим только при useIpAliases = true.
Установите пустое значение для выбора диапазона с размером по умолчанию.
Установите /маска (например, /14) для выбора диапазона с заданной маской.
cluster_secondary_range_name
строка
Имя вторичного диапазона, используемого для блока CIDR кластера. Вторичный диапазон будет использован для адресов под.
Должен быть существующим вторичным диапазоном, связанным с подсетью кластера.
create_subnetwork
булево
    Варианты:
  • нет
  • да
Создавать ли автоматически новую подсеть для кластера.
node_ipv4_cidr_block
строка
Диапазон IP-адресов экземпляров в этом кластере.
Применим только если createSubnetwork = true.
Установите пустое значение для выбора диапазона с размером по умолчанию.
Установите /маска (например, /14) для выбора диапазона с заданной маской.
services_ipv4_cidr_block
строка
Диапазон IP-адресов для служб в этом кластере. Если пусто, будет выбран диапазон с размером по умолчанию.
Применим только если useIpAliases = true.
Установите пустое значение для выбора диапазона с размером по умолчанию.
Установите /маска (например, /14) для выбора диапазона с заданной маской.
services_secondary_range_name
строка
Имя вторичного диапазона, используемого для блока CIDR служб. Вторичный диапазон будет использован для service ClusterIPs. Должен быть существующим вторичным диапазоном, связанным с подсетью кластера.
subnetwork_name
строка
Настраиваемое имя подсети, если createSubnetwork = true.
Если поле пустое, для новой подсети будет выбрано автоматическое имя.
tpu_ipv4_cidr_block
строка
Диапазон IP-адресов Cloud TPUs в этом кластере. Если не указан, будет выбран диапазон с размером по умолчанию.
Применим только если useIpAliases = true.
Если не указан, используется диапазон по умолчанию.
Установите /маска (например, /14) для выбора диапазона с заданной маской.
use_ip_aliases
булево
    Варианты:
  • нет
  • да
Использовать ли алиасы IP для адресов под в кластере.
kubectl_context
строка
Имя контекста для файла конфигурации kubectl. По умолчанию — имя кластера.
kubectl_path
строка
Путь к файлу конфигурации kubectl.
Файл не будет создан, если этот путь не задан.
Любой существующий файл по этому пути будет полностью перезаписан.
Требуется библиотека PyYaml.
legacy_abac
словарь
Настройки для режима авторизации ABAC.
enabled
булево
    Варианты:
  • нет
  • да
Включен ли модуль ABAC для этого кластера. При включении идентификаторы в системе, включая учетные записи служб, узлы и контроллеры, получат статические разрешения сверх предоставленных конфигурацией RBAC или IAM.
location
строка / обязательно
Расположение, где развернут кластер.

алиасы: зона
locations
список / элементы=строка
Список зон Google Compute Engine, в которых должны находиться узлы кластера.

алиасы: nodeLocations
logging_service
строка
Сервис ведения журналов, который должен использоваться кластером для записи журналов. Доступные варианты: logging.googleapis.com — сервис Google Cloud Logging. none — журналы из кластера не будут экспортироваться. Если оставлено пустым, будет использоваться logging.googleapis.com.
Некоторые допустимые значения включают: "logging.googleapis.com", "none"
master_auth
словарь
Информация об авторизации для доступа к мастер-точке входа.
client_certificate_config
словарь
Настройка для аутентификации с помощью сертификата клиента в кластере. Для кластеров до версии v1.12, если конфигурация не указана, сертификат клиента выдаётся.
issue_client_certificate
логическое значение
    Варианты:
  • no
  • yes
Выдать сертификат клиента.
password
строка
Пароль для использования в аутентификации по протоколу HTTP Basic с мастер-точкой входа. Поскольку мастер-точка входа открыта для интернета, следует создать надёжный пароль с длиной не менее 16 символов.
username
строка
Имя пользователя для использования в аутентификации по протоколу HTTP Basic с мастер-точкой входа.
master_authorized_networks_config
словарь
Настройка для управления распределением IP-адресов в кластере.
cidr_blocks
список / элементы=словарь
Определите до 50 внешних сетей, которые могут получить доступ к мастер-узлу Kubernetes через HTTPS.
cidr_block
строка
Блок, указанный в CIDR-нотации.
display_name
строка
Необязательное поле, используемое для идентификации блоков cidr.
enabled
логическое значение
    Варианты:
  • no
  • yes
Включена ли настройка авторизации сетей мастер-узла.
monitoring_service
строка
Сервис мониторинга, который должен использоваться кластером для записи метрик.
В настоящее время доступны следующие варианты: monitoring.googleapis.com — служба мониторинга Google Cloud.
none — метрики из кластера не будут экспортироваться.
Если оставить пустой строкой, будет использоваться monitoring.googleapis.com.
Некоторые допустимые значения: "monitoring.googleapis.com", "none"
name
строка
Имя этого кластера. Имя должно быть уникальным в рамках этого проекта и расположения и может содержать до 40 символов. Допустимы только строчные буквы, цифры и дефисы. Имя должно начинаться с буквы и заканчиваться цифрой или буквой.
network
строка
Имя сети Google Compute Engine, к которой подключён кластер. Если не указано, будет использоваться сеть по умолчанию.
network_policy
словарь
Параметры конфигурации функции NetworkPolicy.
enabled
логическое значение
    Варианты:
  • no
  • yes
Включена ли политика сети в кластере.
provider
строка
Выбранный поставщик политики сети.
Некоторые допустимые значения: "PROVIDER_UNSPECIFIED", "CALICO"
node_config
словарь
Параметры, используемые при создании узлов кластера.
Для запросов это поле должно использоваться вместо объекта "nodePool", так как эта конфигурация (вместе с "initialNodeCount") будет использована для создания объекта "NodePool" с автоматически сгенерированным именем. Не используйте это поле и nodePool одновременно. В ответах это поле будет заполняться с конфигурацией узла первого пула узлов. Если не указано, используются значения по умолчанию.
accelerators
список / элементы=словарь
Список аппаратных ускорителей, которые должны быть подключены к каждому узлу. Для получения дополнительной информации об поддержке графических процессоров см. https://cloud.google.com/compute/docs/gpus.
accelerator_count
строка
Количество плат ускорителей, подключённых к экземпляру.
accelerator_type
строка
Идентификатор ресурса типа ускорителя.
disk_size_gb
целое число
Размер диска, подключённого к каждому узлу, указанный в ГБ. Минимально допустимый размер диска — 10 ГБ. Если не указано, размер диска по умолчанию — 100 ГБ.
disk_type
строка
Тип диска, подключённого к каждому узлу (например, 'pd-standard' или 'pd-ssd'). Если не указано, тип диска по умолчанию — 'pd-standard'.
image_type
строка
Тип образа, который нужно использовать для этого узла. Обратите внимание, что для данного типа образа будет использована последняя версия.
labels
словарь
Карта меток Kubernetes (пар «ключ/значение»), которые будут применены к каждому узлу. Они будут добавлены к любым меткам по умолчанию, которые Kubernetes может применить к узлу. В случае конфликта ключей меток применённый набор может отличаться в зависимости от версии Kubernetes — лучше всего считать поведение неопределённым, и следует избегать конфликтов. Дополнительную информацию, включая использование и допустимые значения, см. в: http://kubernetes.io/v1.1/docs/user-guide/labels.html Объект, содержащий список пар «ключ»: значение.
Пример: { "name": "ключ", "mass": "1.3кг", "count": "3" }
local_ssd_count
целое число
Количество локальных дисков SSD, которые нужно подключить к узлу.
Предел для этого значения зависит от максимального количества дисков, доступных на машине в данном регионе. Дополнительную информацию см. в: https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits.
machine_type
строка
Имя типа машины Google Compute Engine (например,
n1-standard-1). Если не указано, используется тип машины по умолчанию n1-standard-1.
metadata
словарь
Ключи/значения метаданных, назначенные экземплярам в кластере.
Ключи должны соответствовать регулярному выражению [a-zA-Z0-9-_]+ и иметь длину менее 128 байт. Они отображаются как часть URL-адреса в сервере метаданных. Кроме того, чтобы избежать неоднозначности, ключи не должны конфликтовать с другими ключами метаданных для проекта или быть одним из четырёх зарезервированных ключей: "instance-template", "kube-env", "startup-script" и "user-data". Значения — свободные строки, и их смысл интерпретируется изображением, работающим в экземпляре. Единственное ограничение — размер каждого значения не должен превышать 32 КБ.
Общая длина всех ключей и значений должна быть меньше 512 КБ.
Объект, содержащий список пар «ключ»: значение.
Пример: { "name": "ключ", "mass": "1.3кг", "count": "3" }
min_cpu_platform
строка
Минимальная платформа процессора, используемая этим экземпляром. Экземпляр может планироваться на указанную или более новую платформу процессора.
oauth_scopes
список / элементы=строка
Набор облачных API-разрешений Google, доступных для всех виртуальных машин узлов в рамках учетной записи "default".
Рекомендуются следующие разрешения, но они необязательны и по умолчанию не включены: https://www.googleapis.com/auth/compute требуется для монтирования постоянного хранилища на узлах.
https://www.googleapis.com/auth/devstorage.read_only требуется для взаимодействия с gcr.io (Google Container Registry).
Если не указано, разрешения не добавляются, если не включены Cloud Logging или Cloud Monitoring, в таком случае будут добавлены необходимые разрешения.
preemptible
логическое значение
    Варианты:
  • no
  • yes
Создаются ли узлы в виде виртуальных машин с возможностью прерывания. Дополнительную информацию об экземплярах виртуальных машин с возможностью прерывания см. в: https://cloud.google.com/compute/docs/instances/preemptible.
service_account
строка
Учетная запись службы Google Cloud Platform, которая должна использоваться виртуальными машинами узлов. Если учетная запись службы не указана, используется учетная запись службы "default".
shielded_instance_config
словарь
Параметры защищённых экземпляров.
enable_integrity_monitoring
boolean
    Варианты:
  • no
  • yes
Определяет, включена ли проверка целостности для экземпляра.
Включает мониторинг и подтверждение целостности загрузки экземпляра.
Подтверждение выполняется по отношению к эталонной политике целостности. Этот эталон первоначально извлекается из неявно доверенного загрузочного образа при создании экземпляра.
enable_secure_boot
boolean
    Варианты:
  • no
  • yes
Определяет, включена ли безопасная загрузка для экземпляра.
Безопасная загрузка помогает гарантировать, что система запускает только аутентифицированное программное обеспечение, проверяя цифровую подпись всех загрузочных компонентов и останавливая процесс загрузки, если проверка подписи завершается неудачно.
tags
list / elements=string
Список тегов экземпляра, применяемых ко всем узлам. Теги используются для определения допустимых источников или целевых адресов для сетевых брандмауэров и задаются клиентом при создании кластера или пула узлов. Каждый тег в списке должен соответствовать RFC1035.
taints
list / elements=dictionary
Список пометок Kubernetes, которые будут применены к каждому узлу.
Для получения дополнительной информации, включая использование и допустимые значения, см.: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ .
effect
string
Эффект метки.
Некоторые допустимые значения: "EFFECT_UNSPECIFIED", "NO_SCHEDULE", "PREFER_NO_SCHEDULE", "NO_EXECUTE"
key
string
Ключ для метки.
value
string
Значение для метки.
private_cluster_config
dictionary
Настройка для частного кластера.
enable_private_endpoint
boolean
    Варианты:
  • no
  • yes
Используется ли внутренний IP-адрес мастера в качестве конечной точки кластера.
enable_private_nodes
boolean
    Варианты:
  • no
  • yes
Используются ли узлы только с внутренними IP-адресами. Если включено, всем узлам назначаются только частные адреса RFC 1918, и они взаимодействуют с мастером через частную сеть.
master_ipv4_cidr_block
string
Диапазон IP-адресов в нотации CIDR, используемый для размещённой главной сети. Этот диапазон будет использован для назначения внутренних IP-адресов мастеру или группе мастеров, а также для VIP-адреса ILB. Этот диапазон не должен пересекаться с другими диапазонами, используемыми в сети кластера.
project
string
Используемый проект Google Cloud Platform.
resource_labels
dictionary
Метки ресурсов кластера для аннотации связанных ресурсов Google Compute Engine.
scopes
list / elements=string
Массив используемых областей доступа.
service_account_contents
jsonarg
Содержимое файла JSON учетной записи службы, либо в виде словаря, либо в виде JSON-строки, его представляющей.
service_account_email
string
Факультативный адрес электронной почты учетной записи службы, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию.
service_account_file
path
Путь к файлу JSON учетной записи службы, если тип выбран как serviceaccount.
state
string
    Варианты:
  • present ←
  • absent
Должен ли данный объект существовать в GCP
subnetwork
string
Имя подсети Google Compute Engine, к которой подключен кластер.

Примеры

- name: create a cluster
  google.cloud.gcp_container_cluster:
    name: my-cluster
    initial_node_count: 2
    master_auth:
      username: cluster_admin
      password: my-secret-password
    node_config:
      machine_type: n1-standard-4
      disk_size_gb: 500
    location: us-central1-a
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:

Ключ Возвращаемое значение Описание
addonsConfig
complex
success
Настройки для различных дополнительных компонентов, доступных для запуска в кластере.

horizontalPodAutoscaling
complex
success
Настройка функции автоматического масштабирования горизонтальных поддомов, которая увеличивает или уменьшает количество реплик поддомов контроллера репликации на основе использования ресурсов существующих поддомов.

disabled
boolean
success
Включена ли функция автоматического масштабирования горизонтальных поддомов в кластере. При включении она гарантирует, что в кластере запущен поддом Heapster, который также используется службой мониторинга Cloud.

httpLoadBalancing
complex
success
Настройка дополнительного компонента контроллера балансировки нагрузки HTTP (L7), который упрощает настройку балансировщиков нагрузки HTTP для служб в кластере.

disabled
boolean
success
Включен ли контроллер балансировки нагрузки HTTP в кластере. При включении он запускает небольшой поддом в кластере, который управляет балансировщиками нагрузки.

networkPolicyConfig
complex
success
Настройка NetworkPolicy. Отслеживает только включен ли компонент в Мастер, не отслеживает включение сетевой политики для узлов.

disabled
boolean
success
Включена ли сетевая политика для этого кластера.

binaryAuthorization
complex
success
Настройка функции BinaryAuthorization.

enabled
boolean
success
Если включено, все контейнерные образы будут проверены с помощью Binary Authorization.

clusterIpv4Cidr
string
success
Диапазон IP-адресов контейнерных поддомов в этом кластере в формате CIDR (например, 10.96.0.0/14). Оставьте пустым, чтобы автоматически выбрать или укажите блок /14 в 10.0.0.0/8.

conditions
complex
success
Какие условия привели к текущему состоянию кластера.

code
string
success
Машинно-ориентированное представление условия.

message
string
success
Представление условия, понятное человеку.

createTime
string
success
Время создания кластера в формате RFC3339.

currentMasterVersion
string
success
Текущая версия программного обеспечения конечной точки мастера.

currentNodeCount
integer
success
Количество узлов в кластере в настоящее время.

currentNodeVersion
string
success
Текущая версия программных компонентов узлов. Если они в настоящее время находятся на нескольких версиях, потому что находятся в процессе обновления, это отражает минимальную версию всех узлов.

defaultMaxPodsConstraint
complex
success
Умолчание ограничения максимального числа поддомов, которые могут выполняться одновременно на узле в пуле узлов этого кластера.
Игнорируется, если кластер создан без поддержки IP Alias.

maxPodsPerNode
string
success
Ограничение, накладываемое на максимальное количество поддомов на узел.

description
string
success
Необязательное описание этого кластера.

enableTpu
boolean
success
(Необязательно) Включить ресурсы Cloud TPU в этом кластере.
См. официальную документацию - https://cloud.google.com/tpu/docs/kubernetes-engine-setup .

endpoint
string
success
IP-адрес конечной точки мастера этого кластера.
К конечной точке можно получить доступ из Интернета по адресу https://username:password@endpoint/ См. свойство masterAuth этого ресурса для получения информации о имени пользователя и пароле.

expireTime
string
success
Время автоматического удаления кластера в формате RFC3339.

initialClusterVersion
string
success
Версия программного обеспечения конечной точки мастера и kubelets, используемых в кластере при его первоначальном создании. Версия может быть обновлена со временем.

initialNodeCount
integer
success
Количество узлов для создания в этом кластере. Вы должны убедиться, что ваш квота ресурсов Compute Engine достаточна для этого количества экземпляров. Вам также должны быть доступны квоты на брандмауэр и маршруты. Для запросов это поле следует использовать только вместо объекта "nodePool", так как эта конфигурация (вместе с "nodeConfig") будет использоваться для создания объекта "NodePool" с автоматически сгенерированным именем. Не используйте это и nodePool одновременно.
Это поле устарело. Пожалуйста, используйте nodePool.initial_node_count вместо него.

ipAllocationPolicy
complex
success
Настройка управления выделением IP-адресов в кластере.

clusterIpv4CidrBlock
string
success
Диапазон IP-адресов для поддомов кластера. Если это поле установлено, то cluster.cluster_ipv4_cidr должно быть пустым.
Это поле применимо только в случае, если useIpAliases равно true.
Установите пустым, чтобы выбрать диапазон с размером по умолчанию.
Установите /маска сети (например, /14), чтобы выбрать диапазон с определённой маской сети.

clusterSecondaryRangeName
string
success
Имя вторичного диапазона, используемого для блока CIDR кластера. Вторичный диапазон будет использоваться для IP-адресов поддомов.
Он должен быть существующим вторичным диапазоном, связанным с подсетью кластера.

createSubnetwork
boolean
success
Создавать ли новую подсеть автоматически для кластера.

nodeIpv4CidrBlock
string
success
Диапазон IP-адресов IP-адресов экземпляров в этом кластере.
Это применимо только в случае, если createSubnetwork равно true.
Установите пустым, чтобы выбрать диапазон с размером по умолчанию.
Установите /маска сети (например, /14), чтобы выбрать диапазон с определённой маской сети.

servicesIpv4CidrBlock
string
success
Диапазон IP-адресов служб в этом кластере. Если пусто, будет автоматически выбран диапазон с размером по умолчанию.
Это поле применимо только в случае, если useIpAliases равно true.
Установите пустым, чтобы выбрать диапазон с размером по умолчанию.
Установите /маска сети (например, /14), чтобы выбрать диапазон с определённой маской сети.

servicesSecondaryRangeName
string
success
Имя вторичного диапазона, используемого для блока CIDR служб. Вторичный диапазон будет использоваться для адресов кластеров служб. Он должен быть существующим вторичным диапазоном, связанным с подсетью кластера.

subnetworkName
string
success
Настраиваемое имя подсети, которое будет использоваться, если createSubnetwork равно true.
Если это поле пустое, для новой подсети будет выбрано автоматическое имя.

tpuIpv4CidrBlock
string
success
Диапазон IP-адресов Cloud TPUs в этом кластере. Если не указано, будет выбран диапазон с размером по умолчанию.
Это поле применимо только в случае, если useIpAliases равно true.
Если не указано, диапазон будет использовать размер по умолчанию.
Установите /маска сети (например, /14), чтобы выбрать диапазон с определённой маской сети.

useIpAliases
boolean
success
Использовать ли алиасы IP для адресов поддомов в кластере.

kubectlContext
string
success
Имя контекста для файла конфигурации kubectl. Будет установлено по умолчанию как имя кластера.

kubectlPath
string
success
Путь, по которому будет сохранён файл конфигурации kubectl.
Файл не будет создан, если этот путь не задан.
Любой существующий файл в этом пути будет полностью перезаписан.
Требуется библиотека PyYaml.

labelFingerprint
string
success
Отпечаток метки для этого кластера.

legacyAbac
complex
success
Конфигурация для режима авторизации ABAC устаревшего типа.

enabled
boolean
success
Включен ли модуль авторизации ABAC для данного кластера. При включении, идентификаторам в системе, включая учетные записи сервисов, узлы и контроллеры, будут статически предоставлены разрешения, выходящие за рамки разрешений, предоставляемых конфигурацией RBAC или IAM.

location
string
success
Расположение, где развернут кластер.

locations
list / elements=string
success
Список зон Google Compute Engine, в которых должны располагаться узлы кластера.

loggingService
string
success
Услуга ведения журналов, которую должен использовать кластер для записи журналов. Доступные варианты: logging.googleapis.com — служба Google Cloud Logging.
none — журналы из кластера не будут экспортироваться.
Если оставлено пустым, будет использоваться logging.googleapis.com.

masterAuth
complex
success
Информация об авторизации для доступа к мастер-точке.

clientCertificate
string
success
Публичный сертификат в кодировке Base64, используемый клиентами для аутентификации на конечную точку кластера.

clientCertificateConfig
complex
success
Настройка аутентификации по клиентскому сертификату в кластере. Для кластеров до версии v1.12, если конфигурация не указана, клиентский сертификат выдается.

issueClientCertificate
boolean
success
Выдать клиентский сертификат.

clientKey
string
success
Приватный ключ в кодировке Base64, используемый клиентами для аутентификации на конечную точку кластера.

clusterCaCertificate
string
success
Публичный сертификат в кодировке Base64, являющийся корневым сертификатом доверия для кластера.

password
string
success
Пароль для аутентификации по HTTP с использованием базовой аутентификации на мастер-конечную точку. Поскольку мастер-конечная точка открыта для интернета, необходимо создать надежный пароль с длиной не менее 16 символов.

username
string
success
Имя пользователя для аутентификации по HTTP с использованием базовой аутентификации на мастер-конечную точку.

masterAuthorizedNetworksConfig
complex
success
Конфигурация для управления выделением IP-адресов в кластере.

cidrBlocks
complex
success
Определите до 50 внешних сетей, которые могут получить доступ к мастер-компоненту Kubernetes через HTTPS.

cidrBlock
string
success
Блок, заданный в CIDR-нотации.

displayName
string
success
Необязательное поле для идентификации CIDR-блоков.

enabled
boolean
success
Включены ли авторизованные сети мастер-узла.

monitoringService
string
success
Сервис мониторинга, который должен использовать кластер для записи метрик.
Доступные варианты: monitoring.googleapis.com — служба Google Cloud Monitoring.
none — метрики из кластера не будут экспортироваться.
Если оставлено пустым, будет использоваться monitoring.googleapis.com.

name
string
success
Имя данного кластера. Имя должно быть уникальным в рамках данного проекта и расположения, и может содержать до 40 символов. Допускаются только строчные буквы, цифры и дефисы. Должно начинаться с буквы. Должно заканчиваться цифрой или буквой.

network
string
success
Имя сети Google Compute Engine, к которой подключен кластер. Если не указано, будет использована сеть по умолчанию.

networkPolicy
complex
success
Параметры конфигурации для функции NetworkPolicy.

enabled
boolean
success
Включена ли политика сети в кластере.

provider
string
success
Выбранный поставщик политики сети.

nodeConfig
complex
success
Параметры, используемые при создании узлов кластера.
Для запросов это поле следует использовать только вместо объекта "nodePool", так как эта конфигурация (вместе с "initialNodeCount") будет использована для создания объекта "NodePool" с автоматически сгенерированным именем. Не используйте это поле и nodePool одновременно. Для ответов это поле будет заполнено конфигурацией узла первого пула узлов. Если не указано, используются значения по умолчанию.

accelerators
complex
success
Список аппаратных ускорителей, которые будут подключены к каждому узлу. Подробнее об поддержке графических процессоров см. https://cloud.google.com/compute/docs/gpus.

acceleratorCount
string
success
Количество карт ускорителей, подключенных к экземпляру.

acceleratorType
string
success
Имя ресурса типа ускорителя.

diskSizeGb
integer
success
Размер диска, подключенного к каждому узлу, указанный в ГБ. Минимальный размер диска составляет 10 ГБ. Если не указано, размер диска по умолчанию составляет 100 ГБ.

diskType
string
success
Тип диска, подключенного к каждому узлу (например, 'pd-standard' или 'pd-ssd'). Если не указано, тип диска по умолчанию — 'pd-standard'.

imageType
string
success
Тип образа, который будет использоваться для данного узла. Обратите внимание, что для данного типа образа будет использована самая последняя версия.

labels
dictionary
success
Словарь меток Kubernetes (пар ключ/значение), которые будут применены к каждому узлу. Они будут добавлены в дополнение к любым меткам по умолчанию, которые Kubernetes может применить к узлу. В случае конфликта ключей меток, примененный набор может отличаться в зависимости от версии Kubernetes — лучше всего предположить, что поведение не определено, и конфликтов следует избегать. Дополнительную информацию, включая использование и допустимые значения, см.: http://kubernetes.io/v1.1/docs/user-guide/labels.html Объект, содержащий список пар "ключ": значение.
Пример: { "name": "ключ", "масса": "1,3кг", "количество": "3" }

localSsdCount
integer
success
Количество локальных дисков SSD, которые должны быть подключены к узлу.
Ограничение для этого значения зависит от максимального количества дисков, доступных на машине в зоне. Дополнительную информацию см. в разделе: https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits.

machineType
string
success
Имя типа машины Google Compute Engine (например,
n1-standard-1). Если не указано, тип машины по умолчанию — n1-standard-1.

metadata
dictionary
success
Ключевые пары метаданных, назначенные экземплярам в кластере.
Ключи должны соответствовать регулярному выражению [a-zA-Z0-9-_]+ и иметь длину менее 128 байтов. Они отображаются как часть URL-адреса на сервере метаданных. Кроме того, для избежания неоднозначности, ключи не должны конфликтовать с другими ключами метаданных для проекта или быть одним из четырех зарезервированных ключей: "instance-template", "kube-env", "startup-script" и "user-data". Значения — свободные строки и имеют смысл только в интерпретации образа, работающего в экземпляре. Единственное ограничение, наложенное на них, заключается в том, что размер каждого значения должен быть меньше или равен 32 КБ.
Общий размер всех ключей и значений должен быть меньше 512 КБ.
Объект, содержащий список пар "ключ": значение.
Пример: { "name": "ключ", "масса": "1,3кг", "количество": "3" }

minCpuPlatform
string
success
Минимальная платформа процессора, которая должна использоваться этим экземпляром. Экземпляр может быть запланирован на указанную или более новую платформу процессора.

END_OF_DOCUMENT_MARKER
oauthScopes
list / elements=string
success
Набор Google API-разрешений, которые должны быть доступны на всех виртуальных машинах узлов в рамках учётной записи «по умолчанию».
Рекомендуются следующие разрешения, но они не обязательны и по умолчанию не включены: https://www.googleapis.com/auth/compute требуется для подключения постоянного хранилища к вашим узлам.
https://www.googleapis.com/auth/devstorage.read_only требуется для связи с gcr.io (Google Container Registry).
Если не указано, разрешения не добавляются, за исключением случаев, когда включены Cloud Logging или Cloud Monitoring, в этом случае будут добавлены необходимые разрешения.

preemptible
boolean
success
Указывает, создаются ли узлы как преемные виртуальные машины. См.: https://cloud.google.com/compute/docs/instances/preemptible для получения дополнительной информации о преемных виртуальных машинах.

serviceAccount
string
success
Учётная запись Google Cloud Platform Service Account, которая будет использоваться виртуальными машинами узлов. Если учётная запись Service Account не указана, используется учётная запись «по умолчанию».

shieldedInstanceConfig
complex
success
Параметры защищённого экземпляра.

enableIntegrityMonitoring
boolean
success
Определяет, включено ли отслеживание целостности для экземпляра.
Включает отслеживание и подтверждение целостности загрузки экземпляра.
Подтверждение выполняется по отношению к базовому уровню политики целостности. Этот базовый уровень изначально выводится из неявно надёжного загрузочного образа при создании экземпляра.

enableSecureBoot
boolean
success
Определяет, включен ли Secure Boot для экземпляра.
Secure Boot помогает гарантировать, что система запускает только аутентифицированное программное обеспечение, проверяя цифровую подпись всех загрузочных компонентов и останавливая процесс загрузки, если проверка подписи завершается неудачно.

tags
list / elements=string
success
Список меток экземпляра, применяемых ко всем узлам. Метки используются для определения допустимых источников или целей для сетевых брандмауэров и указываются клиентом при создании кластера или пула узлов. Каждая метка в списке должна соответствовать RFC1035.

taints
complex
success
Список пометок Kubernetes, которые будут применены к каждому узлу.
Для получения дополнительной информации, включая использование и допустимые значения, см.: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ .

effect
string
success
Эффект для метки.

key
string
success
Ключ для метки.

value
string
success
Значение для метки.

nodeIpv4CidrSize
integer
success
Размер адресного пространства на каждом узле для размещения контейнеров.
Это выделяется из диапазона container_ipv4_cidr.

nodePools
complex
success
Пулы узлов, принадлежащие этому кластеру.

name
string
success
Имя пула узлов.

privateClusterConfig
complex
success
Настройка для частного кластера.

enablePrivateEndpoint
boolean
success
Используется ли внутренний IP-адрес мастера в качестве конечной точки кластера.

enablePrivateNodes
boolean
success
Используются ли узлами только внутренние IP-адреса. При включении всем узлам предоставляются только частные адреса RFC 1918, и они взаимодействуют с мастером через частную сеть.

masterIpv4CidrBlock
string
success
Диапазон IP-адресов в CIDR-нотации для использования в сети хостинг-мастера. Этот диапазон будет использоваться для назначения внутренних IP-адресов мастеру или набору мастеров, а также для VIP-адреса ILB. Этот диапазон не должен пересекаться с другими диапазонами, используемыми в сети кластера.

privateEndpoint
string
success
Внутренний IP-адрес конечной точки мастера этого кластера.

publicEndpoint
string
success
Внешний IP-адрес конечной точки мастера этого кластера.

resourceLabels
dictionary
success
Метки ресурсов для кластера, используемые для аннотирования любых связанных ресурсов Google Compute Engine.

servicesIpv4Cidr
string
success
Диапазон IP-адресов Kubernetes-служб в этом кластере в CIDR-нотации (например, 1.2.3.4/29). Адреса служб обычно размещаются в последнем /16 из диапазона container CIDR.

status
string
success
Текущий статус этого кластера.

statusMessage
string
success
Дополнительная информация о текущем статусе этого кластера, если доступна.

subnetwork
string
success
Имя подсети Google Compute Engine, к которой подключен кластер.

tpuIpv4CidrBlock
string
success
Диапазон IP-адресов Cloud TPUs в этом кластере в [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) нотации (например, `1.2.3.4/29`).



Авторы

  • Google Inc. (@googlecloudplatform)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/google/cloud/gcp_container_cluster_module.html

Spec-Zone.ru

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