kubernetes - Управление ресурсами Kubernetes.
Новое в версии 2.1.
Обзор
- Этот модуль может управлять ресурсами Kubernetes в существующем кластере, используя API сервера Kubernetes. Пользователи могут указать данные API в строковом формате или использовать существующий YAML-файл Kubernetes. В настоящее время этот модуль поддерживает только HTTP Basic Auth, только «стратегическое слияние» для обновления, http://goo.gl/fCPYxT сертификаты SSL не работают, используйте «validate_certs=off» для отключения
Параметры
| параметр | обязательно | по умолчанию | значения | комментарии |
|---|---|---|---|---|
| api_endpoint | да | IPv4 адрес API-эндпоинта кластера Kubernetes. псевдонимы: endpoint | ||
| certificate_authority_data | нет | Данные сертификата Уполномоченного центра сертификации для сервера Kubernetes. Должны быть в стандартном формате PEM или в кодировке base64 PEM-данных. Обратите внимание, что проверка сертификатов не работает до тех пор, пока Ansible не будет поддерживать версию `match_hostname`, которая может сопоставлять IP-адрес с данными CA. | ||
| file_reference | нет | Укажите полный путь к YAML-файлу Kubernets, который нужно отправить на API-эндпоинт. Этот параметр взаимоисключающий с 'inline_data'. | ||
| inline_data | да | Данные Kubernetes YAML, которые нужно отправить на API-эндпоинт. Этот параметр взаимоисключающий с 'file_reference'. | ||
| insecure | нет | Возвращает подключение к использованию HTTP вместо HTTPS. Этот параметр следует использовать только при выполнении модуля 'kubernetes' локально в кластере Kubernetes с использованием небезопасного локального порта (по умолчанию locahost:8080). | ||
| patch_operation (добавлен в 2.4)
| нет | Стратегическое слияние |
| - Укажите операцию патча для обновления ресурса Kubernetes. Подробности см. в описании операций PATCH на https://github.com/kubernetes/kubernetes/blob/release-1.5/docs/devel/api-conventions.md#patch-operations. псевдонимы: patch_strategy |
| state | да | present |
| Желаемое действие для данных Kubernetes. |
| url_password | нет | Пароль HTTP Basic Auth для API-эндпоинта. Его следует установить, если не используется параметр 'insecure'. псевдонимы: password | ||
| url_username | нет | admin | Имя пользователя HTTP Basic Auth для API-эндпоинта. Его следует установить, если не используется параметр 'insecure'. псевдонимы: username | |
| validate_certs | нет | Включить/выключить проверку сертификатов. Обратите внимание, что это значение установлено в false, пока Ansible не сможет поддерживать соответствие имени хоста сертификата на основе IP-адреса (существует в >= python3.5.0). |
Примеры
# Create a new namespace with in-line YAML.
- name: Create a kubernetes namespace
kubernetes:
api_endpoint: 123.45.67.89
url_username: admin
url_password: redacted
inline_data:
kind: Namespace
apiVersion: v1
metadata:
name: ansible-test
labels:
label_env: production
label_ver: latest
annotations:
a1: value1
a2: value2
state: present
# Create a new namespace from a YAML file.
- name: Create a kubernetes namespace
kubernetes:
api_endpoint: 123.45.67.89
url_username: admin
url_password: redacted
file_reference: /path/to/create_namespace.yaml
state: present
# Do the same thing, but using the insecure localhost port
- name: Create a kubernetes namespace
kubernetes:
api_endpoint: 123.45.67.89
insecure: true
file_reference: /path/to/create_namespace.yaml
state: present
Значения возврата
Общие значения возврата описаны здесь Значения возврата, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| api_response | Необработанный ответ от API Kubernetes, содержание зависит от API. | успех | сложный | |||||||||||||||||||||||||||||||
| содержит: |
| |||||||||||||||||||||||||||||||||
Статус
Этот модуль помечен как preview, что означает, что интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если вы так решите, пожалуйста, ознакомьтесь с Информация и участие в сообществе, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/kubernetes_module.html