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, подключитесь к серверу API, используя URL, указанный в host, и попробуйте войти в систему.Если установлено значение absent, попробуйте выйти из системы, аннулировав маркер аутентификации, указанный в api_key. |
| username строка | Укажите имя пользователя для аутентификации на сервере API. | |
| validate_certs булево |
| Выполнять ли проверку 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