Spec-Zone.ru › Ansible 2.10

community.okd.openshift_auth – Авторизация в кластерах OpenShift, требующих явного шага входа

Примечание

Этот плагин входит в коллекцию community.okd (версия 1.0.1).

Для его установки используйте: ansible-galaxy collection install community.okd.

Для использования в плейбуке укажите: community.okd.openshift_auth.

Новое в версии 0.2.0: коллекции community.okd

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

Обзор

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

Требования

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

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
api_key
строка
Если state задано как absent, это указывает на токен для аннулирования.
ca_cert
путь
Путь к файлу сертификата CA, используемому для проверки подключения к серверу API. Для предотвращения ошибок проверки сертификатов необходимо предоставить полный цепочку сертификатов.

псевдонимы: ssl_ca_cert
host
строка / обязательно
Укажите URL для доступа к серверу API.
password
строка
Укажите пароль для аутентификации на сервере API.
state
строка
    Варианты:
  • present ←
  • absent
Если установлено значение present, подключитесь к серверу API, используя URL, указанный в host, и попробуйте войти в систему.
Если установлено значение absent, попробуйте выйти из системы, аннулировав маркер аутентификации, указанный в api_key.
username
строка
Укажите имя пользователя для аутентификации на сервере API.
validate_certs
булево
    Варианты:
  • no
  • yes ←
Выполнять ли проверку SSL-сертификатов сервера API.

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

Примеры

- 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: openshift_passwords.yml

    - name: Log in (obtain access token)
      community.okd.openshift_auth:
        username: admin
        password: "{{ openshift_admin_password }}"
      register: openshift_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
      kubernetes.core.k8s_info:
        api_key: "{{ openshift_auth_results.openshift_auth.api_key }}"
        kind: Pod
      register: pod_list

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

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

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

Ключ Возвращаемое значение Описание
k8s_auth
сложный
success
То же, что и возвращаемое openshift_auth. Сохраняется только для обратной совместимости

api_key
строка
success
Токен аутентификации.

ca_cert
строка
success
Путь к файлу сертификата CA, используемому для проверки подключения к серверу API.

host
строка
success
URL для доступа к серверу API.

username
строка
success
Имя пользователя для аутентификации на сервере API.

validate_certs
булево
success
Выполнять ли проверку SSL-сертификатов сервера API.

openshift_auth
сложный
success
Данные о фактах аутентификации OpenShift.

api_key
строка
success
Токен аутентификации.

ca_cert
строка
success
Путь к файлу сертификата CA, используемому для проверки подключения к серверу API.

host
строка
success
URL для доступа к серверу API.

username
строка
success
Имя пользователя для аутентификации на сервере API.

validate_certs
булево
success
Выполнять ли проверку SSL-сертификатов сервера API.



Авторы

  • Команда KubeVirt (@kubevirt)
  • Fabian von Feilitzsch (@fabianvf)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/okd/openshift_auth_module.html

Spec-Zone.ru

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