kubernetes - Управление ресурсами Kubernetes

Новое в версии 2.1.

УСТАРЕВШЕЕ
Синопсис
Параметры
Примеры
Возвращаемые значения
Статус
- Автор

УСТАРЕВШЕЕ

Удалено в Ansible:
	версия: 2.9
Почему:	Этот модуль использовал инструмент командной строки oc, тогда как k8s_raw обращается к API REST.
Альтернатива:	Используйте k8s_raw вместо этого.

Синопсис

Этот модуль может управлять ресурсами Kubernetes в существующем кластере, используя API сервера Kubernetes. Пользователи могут указать данные API в строке или указать существующий файл YAML Kubernetes.
В настоящее время этот модуль (1) поддерживает только аутентификацию HTTP Basic Auth (2) поддерживает только «стратегическое слияние» для обновления, 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		Укажите полный путь к файлу Kubernets YAML, который нужно отправить в API эндпоинт. Этот параметр взаимоисключающий с `'inline_data'`.
inline_data обязательно		Данные Kubernetes YAML, которые нужно отправить на API эндпоинт. Этот параметр взаимоисключающий с `'file_reference'`.
insecure		Возвращает подключение к использованию HTTP вместо HTTPS. Этот параметр следует использовать только при выполнении модуля 'kubernetes' локально в кластере Kubernetes с использованием небезопасного локального порта (локальный хост:8080 по умолчанию).
patch_operation (добавлен в 2.4)	Варианты: JSON Patch Merge Patch Strategic Merge Patch ←	Укажите операцию обновления для ресурса Kubernetes. Подробности см. в описании операций PATCH в https://github.com/kubernetes/kubernetes/blob/release-1.5/docs/devel/api-conventions.md#patch-operations. псевдонимы: patch_strategy
state обязательно	Варианты: absent present ← replace update	Желаемое действие, которое нужно выполнить с данными Kubernetes.
url_password		Пароль HTTP Basic Auth для API эндпоинта. Необходимо установить, если не используется опция `'insecure'`. псевдонимы: password
url_username	По умолчанию: admin	Имя пользователя HTTP Basic Auth для API эндпоинта. Необходимо установить, если не используется опция `'insecure'`. псевдонимы: username
validate_certs	Варианты: no ← yes	Включить/выключить проверку сертификатов. Обратите внимание, что это установлено как `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.
	status
	kind
	spec
	apiVersion
	metadata

Статус

Этот модуль помечен как устаревший и будет удален в версии 2.9. Более подробная информация представлена в разделе УСТАРЕВШЕЕ.

Автор

Eric Johnson (@erjohnso) <erjohnso@google.com>

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/kubernetes_module.html