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, используя небезопасный локальный порт (по умолчанию locahost: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 обязательно	Варианты: absent present ← replace update	Желаемое действие для данных Kubernetes.
url_password		Пароль HTTP Basic Auth для API-конечной точки. Он должен быть установлен, если не используется параметр `'insecure'`. псевдонимы: password
url_username	По умолчанию: "admin"	Имя пользователя HTTP Basic Auth для API-конечной точки. Он должен быть установлен, если не используется параметр `'insecure'`. псевдонимы: username
validate_certs bool	Варианты: нет ← да	Включить/отключить проверку сертификатов. Обратите внимание, что это установлено как `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.6/modules/kubernetes_module.html