Spec-Zone.ru › Ansible 2.4

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)
нет Стратегическое слияние
  • JSON Patch
  • Merge Patch
  • Стратегическое слияние
- Укажите операцию патча для обновления ресурса Kubernetes. Подробности см. в описании операций PATCH на https://github.com/kubernetes/kubernetes/blob/release-1.5/docs/devel/api-conventions.md#patch-operations.
псевдонимы: patch_strategy
state
да present
  • present
  • absent
  • update
  • replace
Желаемое действие для данных 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.
успех сложный
содержит:
имя описание возвращается тип пример
статус
тип
spec
apiVersion
metadata

Статус

Этот модуль помечен как 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

Spec-Zone.ru

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