Spec-Zone.ru › Ansible 2.8

k8s – Запрос к API K8s

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

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

  • Использует OpenShift Python клиент для извлечения определенного объекта по имени, всех соответствующих объектов в заданном пространстве имён или всех соответствующих объектов для всех пространств имён, а также информацию о кластере.
  • Обеспечивает доступ ко всем возможностям API K8s.
  • Поддерживает аутентификацию через конфигурационный файл, сертификаты, пароль или токен.

Псевдонимы: openshift

Требования

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

  • python >= 2.7
  • openshift >= 0.6
  • PyYAML >= 3.11

Параметры

Параметр Варианты/Значения по умолчанию Конфигурация Комментарии
api_key
-
Токен, используемый для аутентификации с API. Также может быть указан через переменную среды K8S_AUTH_API_KEY.
api_version
-
По умолчанию:
"v1"
Используется для указания версии API. Если предоставлено определение resource, apiVersion из resource_definition переопределит этот параметр.
ca_cert
-
Путь к сертификату CA, используемому для аутентификации с API. Также может быть указан через переменную среды K8S_AUTH_SSL_CA_CERT.

Псевдонимы: ssl_ca_cert
client_cert
-
Путь к клиенту сертификату, используемому для аутентификации с API. Также может быть указан через переменную среды K8S_AUTH_CERT_FILE.

Псевдонимы: cert_file
client_key
-
Путь к файлу ключа, используемому для аутентификации с API. Также может быть указан через переменную среды K8S_AUTH_KEY_FILE.

Псевдонимы: key_file
cluster_info
-
Используется для указания типа информации о кластере, которую вы пытаетесь получить. Будет иметь приоритет над всеми другими параметрами.
context
-
Имя контекста, найденного в конфигурационном файле. Также может быть указан через переменную среды K8S_AUTH_CONTEXT.
field_selector
-
Конкретные поля для запроса. Игнорируется, когда задано resource_name.
host
-
Укажите URL для доступа к API. Также может быть указан через переменную среды K8S_AUTH_HOST.
kind
- / обязательно
Используется для указания модели объекта. Если предоставлено определение resource, kind из resource_definition переопределит этот параметр.
kubeconfig
-
Путь к существующему конфигурационному файлу Kubernetes. Если не указано и нет других параметров подключения, клиент OpenShift попытается загрузить конфигурационный файл по умолчанию из ~/.kube/config.json. Также может быть указан через переменную среды K8S_AUTH_KUBECONFIG.
label_selector
-
Дополнительные метки для включения в запрос. Игнорируется, когда задано resource_name.
namespace
-
Ограничивает возвращаемые объекты определённым пространством имён. Если предоставлено определение resource, значение metadata.namespace из resource_definition переопределит этот параметр.
password
-
Укажите пароль для аутентификации с API. Также может быть указан через переменную среды K8S_AUTH_PASSWORD.
resource_definition
-
Укажите YAML-конфигурацию для объекта. ПРИМЕЧАНИЕ: kind, api_version, resource_name и namespace будут перезаписаны соответствующими значениями, найденными в предоставленном resource_definition.
resource_name
-
Извлечь определенный объект по имени. Если предоставлено определение resource, значение metadata.name из resource_definition переопределит этот параметр.
src
-
Укажите путь к файлу, содержащему допустимое YAML-определение объекта. Взаимоисключающее с resource_definition. ПРИМЕЧАНИЕ: kind, api_version, resource_name и namespace будут перезаписаны соответствующими значениями, прочитанными из файла src.
Читает из локальной файловой системы. Для чтения из файловой системы контроллера Ansible используйте плагин поиска файлов или плагин поиска шаблонов, в сочетании с фильтром from_yaml, и передайте результат в resource_definition. См. примеры ниже.
username
-
Укажите имя пользователя для аутентификации с API. Также может быть указан через переменную среды K8S_AUTH_USERNAME.
validate_certs
boolean
    Варианты:
  • no
  • yes
Проверять или нет сертификаты SSL сервера API. Также может быть указан через переменную среды K8S_AUTH_VERIFY_SSL.

Псевдонимы: verify_ssl

Примечания

Примечание

  • Клиент OpenShift Python обертывает K8s Python клиент, предоставляя полный доступ ко всем API и моделям, доступным на обеих платформах. Для получения информации о версиях API и дополнительной информации посетите https://github.com/openshift/openshift-restclient-python

Примеры

- name: Fetch a list of namespaces
  set_fact:
    projects: "{{ lookup('k8s', api_version='v1', kind='Namespace') }}"

- name: Fetch all deployments
  set_fact:
    deployments: "{{ lookup('k8s', kind='Deployment') }}"

- name: Fetch all deployments in a namespace
  set_fact:
    deployments: "{{ lookup('k8s', kind='Deployment', namespace='testing') }}"

- name: Fetch a specific deployment by name
  set_fact:
    deployments: "{{ lookup('k8s', kind='Deployment', namespace='testing', resource_name='elastic') }}"

- name: Fetch with label selector
  set_fact:
    service: "{{ lookup('k8s', kind='Service', label_selector='app=galaxy') }}"

# Use parameters from a YAML config

- name: Load config from the Ansible controller filesystem
  set_fact:
    config: "{{ lookup('file', 'service.yml') | from_yaml }}"

- name: Using the config (loaded from a file in prior task), fetch the latest version of the object
  set_fact:
    service: "{{ lookup('k8s', resource_definition=config) }}"

- name: Use a config from the local filesystem
  set_fact:
    service: "{{ lookup('k8s', src='service.yml') }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого поиска:

Ключ Возвращаемое значение Описание
_list
сложный
Один или несколько определений объектов, возвращенных из API.

api_version
строка
успех
Версионированная схема этого представления объекта.

kind
строка
успех
Представляет REST-ресурс, который представляет этот объект.

metadata
сложный
успех
Стандартные метаданные объекта. Включает имя, пространство имен, аннотации, метки и т. д.

spec
сложный
успех
Конкретные атрибуты объекта. Будут различаться в зависимости от api_version и kind.

status
сложный
успех
Текущие подробности состояния объекта.



Статус

  • Данный поиск не гарантирует обратной совместимости интерфейса. [превью]
  • Этот поиск поддерживается сообществом Ansible. [community]

Авторы

  • НЕИЗВЕСТНО

Подсказка

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

Подсказка

Элементы конфигурации для каждого типа имеют порядок приоритета от низкого к высокому. Например, переменная, которая находится ниже в списке, переопределит переменную, которая находится выше.

© 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/plugins/lookup/k8s.html

Spec-Zone.ru

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