k8s_auth – Авторизация в кластерах Kubernetes, требующих явную процедуру входа

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

Обзор

• Этот модуль обрабатывает аутентификацию в кластерах Kubernetes, требующих явных процедур аутентификации, то есть таких, где клиент входит в систему (получает токен аутентификации), выполняет операции API с использованием этого токена, а затем выходит из системы (отменяет токен). Примером дистрибутива Kubernetes, требующего этого модуля, является OpenShift.
• С другой стороны, популярная конфигурация аутентификации по имени пользователя и паролю использует HTTP Basic Auth, который не включает дополнительных шагов входа/выхода (вместо этого учетные данные для входа можно прикрепить к каждому вызову API) и поэтому обрабатывается непосредственно модулем k8s (и другими модулями, специфичными для ресурсов) с использованием параметров host, username и password. Для получения более подробной информации см. документацию по вашему предпочитаемому модулю.

Требования

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

• python >= 2.7
• urllib3
• requests
• requests-oauthlib

Параметры

Примеры

- hosts: localhost
  module_defaults:
    group/k8s:
      host: https://k8s.example.com/
      ca_cert: ca.pem
  tasks:
  - block:
    # It's good practice to store login credentials in a secure vault and not
    # directly in playbooks.
    - include_vars: k8s_passwords.yml

    - name: Log in (obtain access token)
      k8s_auth:
        username: admin
        password: "{{ k8s_admin_password }}"
      register: k8s_auth_results

    # Previous task provides the token/api_key, while all other parameters
    # are taken from module_defaults
    - name: Get a list of all pods from any namespace
      k8s_info:
        api_key: "{{ k8s_auth_results.k8s_auth.api_key }}"
        kind: Pod
      register: pod_list

    always:
    - name: If login succeeded, try to log out (revoke access token)
      when: k8s_auth_results.k8s_auth.api_key is defined
      k8s_auth:
        state: absent
        api_key: "{{ k8s_auth_results.k8s_auth.api_key }}"

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

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

Статус

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

Авторы

• Команда KubeVirt (@kubevirt)