gitlab_user – Создаёт/обновляет/удаляет пользователей Gitlab
Новая версия 2.1.
Обзор
- Если пользователя в Gitlab нет, он будет создан.
- Если пользователь существует и state=absent, пользователь будет удалён.
- Если изменения внесены в пользователя, пользователь будет обновлён.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- python-gitlab модуль python <= 1.12.1
- права администратора на сервере Gitlab
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| access_level строка |
| Уровень доступа к группе. Можно использовать один из следующих вариантов. гость отчётчик разработчик мастер (псевдоним для администратора) администратор владелец |
| api_password строка | Пароль для аутентификации по API | |
| api_token строка | Токен Gitlab для входа. псевдонимы: login_token | |
| api_url строка | Резолвимый конечный пункт API | |
| api_username строка | Имя пользователя для аутентификации по API | |
| confirm булево добавлен в 2.4 |
| Требуется подтверждение. |
| email строка / обязательно | Электронный адрес пользователя. | |
| external булево добавлен в 2.8 |
| Определить внешний параметр для этого пользователя |
| group строка | ID или полное имя родительской группы в формате group/name Добавить пользователя в качестве члена этой группы. | |
| isadmin булево добавлен в 2.8 |
| Предоставить пользователю права администратора |
| login_password строка | Пароль Gitlab для пользователя входа | |
| login_user строка | Имя пользователя Gitlab. | |
| name строка / обязательно | Имя пользователя, которое вы хотите создать | |
| password строка / обязательно | Пароль пользователя. Сервер GitLab требует минимальную длину пароля в 8 символов, установите значение не менее 8 символов. | |
| server_url строка | URL сервера GitLab с протоколом (например, http или https). | |
| sshkey_file строка | Сам ключ ssh. | |
| sshkey_name строка | Имя ssh ключа | |
| state строка |
| создание или удаление группы. Возможные значения present и absent. |
| username строка / обязательно | Имя пользователя. | |
| validate_certs булево |
| Выполнять проверку SSL сертификатов при использовании https конечной точки. |
Примеры
- name: "Delete Gitlab User"
gitlab_user:
api_url: https://gitlab.example.com/
api_token: "{{ access_token }}"
validate_certs: False
username: myusername
state: absent
delegate_to: localhost
- name: "Create Gitlab User"
gitlab_user:
api_url: https://gitlab.example.com/
validate_certs: True
api_username: dj-wasabi
api_password: "MySecretPassword"
name: My Name
username: myusername
password: mysecretpassword
email: me@example.com
sshkey_name: MySSH
sshkey_file: ssh-rsa AAAAB3NzaC1yc...
state: present
group: super_group/mon_group
access_level: owner
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| error строка | ошибка | сообщение об ошибке, возвращённое API Gitlab Пример: 400: путь уже используется |
| msg строка | всегда | Сообщение об успехе или неудаче Пример: Успешно |
| result словарь | всегда | разбор JSON ответа от сервера |
| user словарь | всегда | Объект API |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Werner Dijkerman (@dj-wasabi)
- Guillaume Martinez (@Lunik)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 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/modules/gitlab_user_module.html
