community.general.gitlab_group_members – Управление участниками группы в GitLab Server
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в книге задач, укажите: community.general.gitlab_group_members.
Введено в версии 1.2.0: of community.general
Обзор
- Этот модуль позволяет добавлять и удалять участников из группы, или изменять уровень доступа участника в группе в GitLab.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python-gitlab модуль python <= 1.15.0
- права администратора на сервере GitLab
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| access_level строка |
| Уровень доступа пользователя. Обязательно, если state=present, состояние пользователя установлено в present. |
| api_password строка | Пароль для аутентификации по API | |
| api_token строка / обязательно | Персональный токен доступа для аутентификации с API GitLab. | |
| api_url строка | Адрес API | |
| api_username строка | Имя пользователя для аутентификации по API | |
| gitlab_group строка / обязательно | Имя группы GitLab, к которой добавляется/удаляется участник. | |
| gitlab_user строка / обязательно | Имя пользователя участника, добавляемого/удаляемого из группы GitLab. | |
| state строка |
| Состояние участника в группе. В случае present, добавляет пользователя в группу GitLab.В случае absent, удаляет пользователя из группы GitLab. |
| validate_certs логическое |
| Требовать проверку SSL-сертификатов при использовании https-адреса. |
Примечания
Примечание
- Поддерживает
check_mode.
Примеры
- name: Add a user to a GitLab Group
community.general.gitlab_group_members:
api_url: 'https://gitlab.example.com'
api_token: 'Your-Private-Token'
gitlab_group: groupname
gitlab_user: username
access_level: developer
state: present
- name: Remove a user from a GitLab Group
community.general.gitlab_group_members:
api_url: 'https://gitlab.example.com'
api_token: 'Your-Private-Token'
gitlab_group: groupname
gitlab_user: username
state: absent
Авторы
- Zainab Alsaffar (@zanssa)
© 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/general/gitlab_group_members_module.html