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

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

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

УСТАРЕВШИЙ

Удалено в Ansible:
	версия: 2.9
Почему:	Этот модуль использовал инструмент командной строки oc, в то время как k8s_raw работает через REST API.
Альтернатива:	Используйте 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-интерфейс endpoint. Этот параметр взаимоисключает `'inline_data'`.
inline_data - / обязательно		Данные Kubernetes YAML, которые нужно отправить на API-интерфейс endpoint. Этот параметр взаимоисключает `'file_reference'`.
insecure -		Возвращает подключение к использованию HTTP вместо HTTPS. Этот параметр следует использовать только при выполнении модуля 'kubernetes' локально в кластере Kubernetes, используя небезопасный локальный порт (по умолчанию локаhost:8080).
patch_operation - Добавлен в 2.4	Варианты: JSON Patch Merge Patch Стратегическое слияние Patch ←	Укажите операцию патчинга для обновления ресурса Kubernetes. Подробности см. в описании операций PATCH на https://github.com/kubernetes/kubernetes/blob/release-1.5/docs/devel/api-conventions.md#patch-operations. псевдонимы: patch_strategy
state - / обязательно	Варианты: отсутствует наличие ← заменить обновить	Желаемое действие, которое нужно выполнить с данными Kubernetes.
url_password -		Пароль HTTP Basic Auth для API-интерфейса endpoint. Следует установить, если не используется параметр `'insecure'`. псевдонимы: password
url_username -	По умолчанию: "admin"	Имя пользователя HTTP Basic Auth для API-интерфейса endpoint. Следует установить, если не используется параметр `'insecure'`. псевдонимы: username
validate_certs boolean	Варианты: нет ← да	Включить/выключить проверку сертификатов. Обратите внимание, что это установлено в `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.
	apiVersion -
	kind -
	metadata -
	spec -
	status -

Статус

Этот модуль будет удален в версии 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.8/modules/kubernetes_module.html