Модуль azure.azcollection.azure_rm_aks – Управление экземпляром управляемого Azure Container Service (AKS)

aad_profile

словарь

Профиль конфигурации Azure Active Directory.

admin_group_object_ids

список / элементы=строка

ID объектов групп Azure AD, которые будут иметь роль администратора кластера.

client_app_id

строка

ID приложения клиента Azure AD.

enable_azure_rbac

логическое

Включить Azure RBAC для авторизации Kubernetes.

Варианты:

• false ← (по умолчанию)
• true

managed

логическое

Включить управляемый Azure AD.

Варианты:

• false ← (по умолчанию)
• true

server_app_id

строка

ID приложения сервера Azure AD.

server_app_secret

строка

Секрет приложения сервера Azure AD.

tenant_id

строка

ID клиента Azure AD для аутентификации.

Если не указано, будет использоваться клиент подписки развертывания.

ad_user

строка

Имя пользователя Active Directory. Используйте при аутентификации с пользователем Active Directory, а не с учетной записью службы.

addon

словарь

Профиль плагина управляемого кластера.

Ключ может быть http_application_routing, monitoring, virtual_node.

Значение должно быть словарем, содержащим логическую переменную enabled.

http_application_routing

псевдонимы: httpApplicationRouting

словарь

Решения HTTP application routing позволяет легко получить доступ к приложениям, развернутым в кластере.

enabled

логическое

Включить ли решение.

Варианты:

• false
• true ← (по умолчанию)

monitoring

псевдонимы: omsagent

словарь

Обеспечивает видимость производительности, собирая метрики памяти и процессора с контроллеров, узлов и контейнеров, доступных в Kubernetes через API метрик.

enabled

логическое

Включить ли решение.

Варианты:

• false
• true ← (по умолчанию)

log_analytics_workspace_resource_id

псевдонимы: logAnalyticsWorkspaceResourceID

строка / обязательно

Место хранения метрик контейнеров.

virtual_node

псевдонимы: aciConnector

словарь

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

Вам не нужно ждать, пока Kubernetes cluster autoscaler развернет узлы VM для выполнения дополнительных под.

enabled

логическое

Включить ли решение.

Варианты:

• false
• true ← (по умолчанию)

subnet_resource_id

псевдонимы: SubnetName

строка / обязательно

Подсеть, связанная с кластером.

adfs_authority_url

строка

Добавлено в azure.azcollection 0.0.1

URL авторизации Azure AD. Используйте при аутентификации с именем пользователя/паролем и собственной службой ADFS.

agent_pool_profiles

list / elements=dictionary

Подпараметры профиля пула агентов.

availability_zones

list / elements=integer

Зоны доступности для узлов. Необходимо использовать AgentPoolType VirtualMachineScaleSets.

Варианты:

• 1
• 2
• 3

count

integer / required

Количество агентов (виртуальных машин) для размещения контейнеров Docker.

Допустимые значения должны находиться в диапазоне от 1 до 100 (включительно).

dns_prefix

string

Префикс DNS, указанный при создании управляемого кластера.

enable_auto_scaling

boolean

Включить автомасштабирование.

Варианты:

• false
• true

max_count

integer

Максимальное количество узлов для автомасштабирования.

Обязательно, если enable_auto_scaling=True.

max_pods

integer

Максимальное количество подов, которые можно запланировать на узлах.

min_count

integer

Минимальное количество узлов для автомасштабирования.

Обязательно, если enable_auto_scaling=True.

mode

string

AgentPoolMode представляет режим пула агентов.

Возможные значения включают System и User.

Для режима AgentPoolMode System требуется минимальный размер виртуальной машины не менее 2 vCPU и 4 ГБ памяти.

Варианты:

• "System"
• "User"

name

string / required

Уникальное имя профиля пула агентов в контексте подписки и группы ресурсов.

node_labels

dictionary

Метки узлов пула агентов, которые будут сохраняться на всех узлах в пуле агентов.

orchestrator_version

string

Версия Kubernetes, работающая в пуле узлов.

os_disk_size_gb

integer

Размер диска операционной системы.

os_type

string

Тип операционной системы.

Варианты:

• "Linux"
• "Windows"

ports

list / elements=integer

Список портов пула агентов.

storage_profiles

string

Профиль хранилища указывает, какой тип хранилища используется.

Варианты:

• "StorageAccount"
• "ManagedDisks"

type

string

AgentPoolType представляет типы пула агентов.

Возможные значения включают VirtualMachineScaleSets и AvailabilitySet.

Варианты:

• "VirtualMachineScaleSets"
• "AvailabilitySet"

vm_size

string / required

Размер виртуальной машины каждого из виртуальных машин пула агентов (например, Standard_F1 / Standard_D2v2).

vnet_subnet_id

string

Указывает идентификатор подсети виртуальной сети.

api_profile

string

added in azure.azcollection 0.0.1

Выбирает профиль API для использования при взаимодействии с службами Azure. Значение по умолчанию latest подходит для общедоступных облаков; будущие значения позволят использовать с Azure Stack.

По умолчанию: "latest"

api_server_access_profile

dictionary

Профиль конфигурации доступа к API.

authorized_ip_ranges

список / элементы=строка

Разрешенные диапазоны IP-адресов для сервера API Kubernetes.

Не может быть включено при использовании частного кластера.

enable_private_cluster

логическое

Указывает, следует ли создавать кластер как частный или нет.

Не может быть изменено для существующего кластера.

Варианты:

• false
• true

append_tags

логическое

Управление тем, является ли поле тегов стандартным или добавляется к существующим тегам.

При стандартном формате любые теги, отсутствующие в параметре тегов, будут удалены из метаданных объекта.

Варианты:

• false
• true ← (по умолчанию)

auth_source

строка

добавлен в azure.azcollection 0.0.1

Управляет источником учетных данных для аутентификации.

Также может быть задан через переменную среды ANSIBLE_AZURE_AUTH_SOURCE.

При значении auto (по умолчанию) приоритет: параметры модуля -> env -> credential_file -> cli.

При значении env, учетные данные будут считаны из переменных среды.

При значении credential_file, профиль будет считаться из ~/.azure/credentials.

При значении cli, учетные данные будут получены из профиля Azure CLI. subscription_id или переменная среды AZURE_SUBSCRIPTION_ID могут быть использованы для определения идентификатора подписки, если их несколько, в противном случае используется стандартная подписка az cli.

При значении msi, хост-машина должна быть ресурсом Azure с включенным расширением MSI. subscription_id или переменная среды AZURE_SUBSCRIPTION_ID могут быть использованы для определения идентификатора подписки, если ресурсу предоставлен доступ к нескольким подпискам, в противном случае выбирается первая подписка.

msi был добавлен в Ansible 2.6.

Варианты:

• "auto" ← (по умолчанию)
• "cli"
• "credential_file"
• "env"
• "msi"

auto_upgrade_profile

словарь

Профиль автоматического обновления для управляемого кластера.

node_os_upgrade_channel

строка

Способ обновления операционной системы на ваших узлах.

Варианты:

• "None"
• "Unmanaged"
• "SecurityPatch"
• "NodeImage" ← (по умолчанию)

upgrade_channel

строка

Установка канала автоматического обновления кластера AKS.

Варианты:

• "rapid"
• "stable"
• "patch"
• "node-image" ← (по умолчанию)
• "none"

cert_validation_mode

строка

добавлен в azure.azcollection 0.0.1

Управляет поведением проверки сертификатов для конечных точек Azure. По умолчанию все модули проверяют сертификат сервера, но при использовании HTTPS-прокси или работе с Azure Stack может потребоваться отключить это поведение, передав ignore. Также может быть задано через профиль файла учетных данных или переменную среды AZURE_CERT_VALIDATION.

Варианты:

• "ignore"
• "validate"

client_id

строка

Идентификатор клиента Azure. Используется при аутентификации с помощью сервисного принципала или управляемой идентичности (msi).

Также может быть задан через переменную среды AZURE_CLIENT_ID.

cloud_environment

строка

добавлен в azure.azcollection 0.0.1

Для облачных сред, отличных от общедоступного облака США, имя среды (определено Azure Python SDK, например, AzureChinaCloud, AzureUSGovernment) или URL-адрес конечной точки обнаружения метаданных (требуется для Azure Stack). Также может быть задан через профиль файла учетных данных или переменную среды AZURE_CLOUD_ENVIRONMENT.

По умолчанию: "AzureCloud"

disable_instance_discovery

логическое

добавлен в azure.azcollection 2.3.0

Определяет, будет ли выполняться обнаружение экземпляра при попытке аутентификации. Установка в значение true полностью отключит как обнаружение экземпляра, так и проверку полномочий. Эта функция предназначена для использования в сценариях, где конечная точка метаданных недоступна, например, в частных облаках или Azure Stack. Процесс обнаружения экземпляра включает получение метаданных полномочий с https://login.microsoft.com/ для проверки полномочий. Установив это значение в **True**, проверка полномочий отключается. Поэтому крайне важно убедиться, что настроенный хост полномочий является корректным и надёжным.

Задаётся через профиль файла учетных данных или переменную среды AZURE_DISABLE_INSTANCE_DISCOVERY.

Варианты:

• false ← (по умолчанию)
• true

dns_prefix

строка

Префикс DNS, указанный при создании управляемого кластера.

enable_rbac

логическое

Включить RBAC.

Существующие кластеры AKS, не настроенные на RBAC, в настоящее время не могут быть обновлены для использования RBAC.

Варианты:

• false ← (по умолчанию)
• true

identity

словарь

добавлен в azure.azcollection 2.4.0

Идентичность сервера.

type

string

Тип управляемой идентификации

Выбор:

• "UserAssigned"
• "SystemAssigned" ← (по умолчанию)

user_assigned_identities

string

Управляемая идентификация пользователя

kubernetes_version

string

Версия Kubernetes, указанная при создании управляемого кластера.

linux_profile

dictionary

Подварианты профиля Linux.

Необязательно, указывать, если требуется доступ SSH к узлам кластера.

admin_username

string / обязательно

Имя администратора для кластера.

ssh_key

string / обязательно

Открытый ключ SSH, используемый для доступа к кластеру.

location

string

Допустимое расположение Azure. По умолчанию — расположение группы ресурсов.

log_mode

string

Родительский аргумент.

log_path

string

Родительский аргумент.

name

string / обязательно

Имя экземпляра управляемой службы Azure Container Services (AKS).

network_profile

dictionary

Профиль сетевой конфигурации.

dns_service_ip

string

IP-адрес, назначенный для службы DNS Kubernetes.

Он должен находиться в диапазоне адресов службы Kubernetes, указанном в serviceCidr.

docker_bridge_cidr

string

(устарело) Docker bridge cidr.

Диапазон IP-адресов в формате CIDR, назначенный сети Docker bridge.

Он не должен перекрываться с никакими диапазонами IP-адресов подсетей или диапазоном адресов службы Kubernetes.

Версия API выше 23.0.0, Модель ContainerServiceNetworkProfile больше не имеет параметра (docker_bridge_cidr).

Этот параметр будет удален в следующей версии.

load_balancer_sku

string

Наименование SKU балансировщика нагрузки для управляемого кластера.

Выбор:

• "standard"
• "basic"

network_plugin

string

Сетевой плагин, используемый для создания сети Kubernetes.

Это свойство изменить нельзя.

При использовании kubenet, узлы получают IP-адрес из подсети виртуальной сети Azure.

Функции AKS, такие как виртуальные узлы или сетевые политики, не поддерживаются с kubenet.

azure позволяет использовать Azure Container Networking Interface (CNI), каждый контейнер получает IP-адрес из подсети и может быть доступен напрямую.

Выбор:

• "azure"
• "kubenet"

network_plugin_mode

string

Режим сетевого плагина, используемого для создания сети Kubernetes.

Выбор:

• "Overlay"

network_policy

string

Сетевая политика, используемая для создания сети Kubernetes.

Выбор:

• "azure"
• "calico"

outbound_type

string

Как будет настраиваться исходящий трафик для кластера.

Выбор:

• "loadBalancer" ← (по умолчанию)
• "userDefinedRouting"
• "managedNATGateway"
• "userAssignedNATGateway"

pod_cidr

string

Диапазон IP-адресов в формате CIDR, из которого назначаются IP-адреса контейнеров, когда используется network_plugin=kubenet.

Он должен быть достаточно большим диапазоном, не используемым в вашей сетевой среде.

Этот диапазон должен быть достаточно большим, чтобы вместить ожидаемое количество узлов, масштабируемых до максимума.

service_cidr

string

Диапазон IP-адресов в формате CIDR, из которого назначаются IP-адреса кластера службы.

Он не должен перекрываться с никакими диапазонами IP-адресов подсетей.

Он должен быть диапазоном *.10 вашего диапазона адресов службы.

node_resource_group

string

Название группы ресурсов, содержащей узлы пула агентов.

Невозможно обновить.

пароль

строка

Пароль пользователя Active Directory. Используйте при аутентификации с пользователем Active Directory вместо сервисного принципала.

pod_identity_profile

словарь

Настройка идентификаторов под в управляемом кластере Kubernetes.

allow_network_plugin_kubenet

булево

Использовать ли плагин сети Kubenet с идентификатором под AAD.

Выбор:

• false
• true

enabled

булево

Включен ли модуль дополнения под идентификатора.

Выбор:

• false
• true

user_assigned_identities

список / элементы=словарь

Идентификаторы под для использования в кластере.

binding_selector

строка

Селектор привязки для использования с ресурсом AzureIdentityBinding.

identity

словарь / обязательно

Подробности назначенного пользователем идентификатора.

client_id

строка

Идентификатор клиента назначенного пользователем идентификатора.

object_id

строка

Идентификатор объекта назначенного пользователем идентификатора.

resource_id

строка

Идентификатор ресурса назначенного пользователем идентификатора.

name

строка / обязательно

Имя идентификатора под.

namespace

строка / обязательно

Пространство имен идентификатора под.

профиль

строка

Профиль безопасности, найденный в файле ~/.azure/credentials.

группа_ресурсов

строка / обязательно

Имя группы ресурсов, где существует или будет создан управляемый Azure Container Services (AKS).

секрет

строка

Секрет клиента Azure. Используйте при аутентификации с сервисным принципалом.

сервисный_принципал

словарь

Дополнительные параметры сервисного принципала.

client_id

строка / обязательно

Идентификатор сервисного принципала.

client_secret

строка

Секретный пароль, связанный с сервисным принципалом.

состояние

строка

Установите состояние AKS. Используйте present для создания или обновления AKS и absent для удаления.

Выбор:

• "absent"
• "present" ← (по умолчанию)

идентификатор_подписки

строка

Ваш идентификатор подписки Azure.

метки

словарь

Словарь пар строка:строка, назначаемых в качестве метаданных объекту.

Метаданные метки объекта будут обновлены с предоставленными значениями.

Чтобы удалить метки, установите параметр append_tags в false.

В настоящее время в зонах Azure DNS и службах Traffic Manager также не разрешается использование пробелов в метке.

Azure Front Door не поддерживает использование

Azure Automation и Azure CDN поддерживают только 15 меток на ресурсах.

арендатор

строка

Идентификатор аренды Azure. Используйте при аутентификации с сервисным принципалом.

отпечаток

строка

добавлен в azure.azcollection 1.14.0

Отпечаток частного ключа, указанного в x509_certificate_path.

Используйте при аутентификации с сервисным принципалом.

Требуется, если определён x509_certificate_path.

x509_certificate_path

path

added in azure.azcollection 1.14.0

Путь к сертификату X509, используемому для создания службы основных данных в формате PEM.

Сертификат должен быть добавлен к закрытому ключу.

Используйте при аутентификации с помощью службы основных данных.