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 строка / обязательно |
| Тип используемых учетных данных. | ||
| 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 логическое значение |
| Выдать сертификат клиента. | ||
| password строка | Пароль для использования в аутентификации по протоколу HTTP Basic с мастер-точкой входа. Поскольку мастер-точка входа открыта для интернета, следует создать надёжный пароль с длиной не менее 16 символов. | |||
| username строка | Имя пользователя для использования в аутентификации по протоколу HTTP Basic с мастер-точкой входа. | |||
| master_authorized_networks_config словарь | Настройка для управления распределением IP-адресов в кластере. | |||
| cidr_blocks список / элементы=словарь | Определите до 50 внешних сетей, которые могут получить доступ к мастер-узлу Kubernetes через HTTPS. | |||
| cidr_block строка | Блок, указанный в CIDR-нотации. | |||
| display_name строка | Необязательное поле, используемое для идентификации блоков cidr. | |||
| enabled логическое значение |
| Включена ли настройка авторизации сетей мастер-узла. | ||
| 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 логическое значение |
| Включена ли политика сети в кластере. | ||
| 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 логическое значение |
| Создаются ли узлы в виде виртуальных машин с возможностью прерывания. Дополнительную информацию об экземплярах виртуальных машин с возможностью прерывания см. в: https://cloud.google.com/compute/docs/instances/preemptible. | ||
| service_account строка | Учетная запись службы Google Cloud Platform, которая должна использоваться виртуальными машинами узлов. Если учетная запись службы не указана, используется учетная запись службы "default". | |||
| shielded_instance_config словарь | Параметры защищённых экземпляров. | |||
| enable_integrity_monitoring boolean |
| Определяет, включена ли проверка целостности для экземпляра. Включает мониторинг и подтверждение целостности загрузки экземпляра. Подтверждение выполняется по отношению к эталонной политике целостности. Этот эталон первоначально извлекается из неявно доверенного загрузочного образа при создании экземпляра. | ||
| enable_secure_boot boolean |
| Определяет, включена ли безопасная загрузка для экземпляра. Безопасная загрузка помогает гарантировать, что система запускает только аутентифицированное программное обеспечение, проверяя цифровую подпись всех загрузочных компонентов и останавливая процесс загрузки, если проверка подписи завершается неудачно. | ||
| 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 |
| Используется ли внутренний IP-адрес мастера в качестве конечной точки кластера. | ||
| enable_private_nodes boolean |
| Используются ли узлы только с внутренними 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 |
| Должен ли данный объект существовать в 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 | Минимальная платформа процессора, которая должна использоваться этим экземпляром. Экземпляр может быть запланирован на указанную или более новую платформу процессора. | ||
| 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