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

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

УСТЕРЕКШЕЕ
Описание
Параметры
Примеры
Значения возврата
Статус

УСТЕРЕКШЕЕ

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

Описание

Этот модуль может управлять ресурсами Kubernetes в существующем кластере, используя API сервера Kubernetes. Пользователи могут указать данные API в строке или указать существующий файл Kubernetes YAML.
В настоящее время этот модуль (1) поддерживает только HTTP Basic Auth (2) поддерживает только «стратегическое слияние» для обновления, http://goo.gl/fCPYxT сертификаты SSL не работают, используйте validate_certs=off для отключения.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_endpoint - / обязательно		IPv4 конечная точка API кластера Kubernetes. алиасы: endpoint
certificate_authority_data -		Данные Удостоверяющего центра для сервера Kubernetes. Должны быть в стандартном формате PEM или в кодированном данных PEM в формате base64. Обратите внимание, что проверка сертификатов не работает до тех пор, пока 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 Стратегическое слияние 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 конечной точки. Это значение должно быть установлено, если не используется параметр `'insecure'`. алиасы: password
url_username -	По умолчанию: "admin"	Имя пользователя HTTP Basic Auth для API конечной точки. Это значение должно быть установлено, если не используется параметр `'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. [устаревший]
Для получения дополнительной информации см. УСТЕРЕКШЕЕ.

Авторы

Эрик Джонсон (@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.7/modules/kubernetes_module.html