community.general.gitlab_hook – Управляет хуками проекта GitLab.
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в книге задач, укажите: community.general.gitlab_hook.
Обзор
- Добавляет, обновляет и удаляет хуки проекта.
Требования
Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.
- python >= 2.7
- модуль python-gitlab
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_password строка | Пароль, используемый для аутентификации по API. | |
| api_token строка | Токен GitLab для входа. | |
| api_url строка | Адрес API. | |
| api_username строка | Имя пользователя для аутентификации по API. | |
| hook_url строка / обязательно | URL, на который GitLab должен отправлять POST-запросы. Используется в качестве первичного ключа для обновлений и удаления. | |
| hook_validate_certs булево |
| Включить проверку SSL при активации хука. Псевдонимы: enable_ssl_verification |
| issues_events булево |
| Активировать хук при событиях с вопросами. |
| job_events булево |
| Активировать хук при событиях с заданиями. |
| merge_requests_events булево |
| Активировать хук при событиях с запросами на слияние. |
| note_events булево |
| Активировать хук при событиях с заметками или добавлении комментариев. |
| pipeline_events булево |
| Активировать хук при событиях с конвейером. |
| project строка / обязательно | ID или полный путь к проекту в формате группа/название. | |
| push_events булево |
| Активировать хук при событиях с push. |
| push_events_branch_filter строка добавлено в 0.2.0 community.general | Имя ветки или шаблон для активации хука при событиях с push. | |
| state строка |
| При значении present, хук будет обновлен в соответствии с вводом или создан, если он не существует.При значении absent, хук будет удален, если он существует. |
| tag_push_events булево |
| Активировать хук при событиях с push тегов. |
| token строка | Секретный токен для проверки сообщений хука на стороне получателя. Если указан, всегда приведет к изменению, так как его нельзя получить из GitLab. Будет отображен в заголовке HTTP-запроса X-GitLab-Token. | |
| validate_certs булево |
| Выполнять проверку SSL-сертификатов при указании HTTPS-адреса. |
| wiki_page_events булево |
| Активировать хук при событиях с вики-страницами. |
Примеры
- name: "Adding a project hook"
community.general.gitlab_hook:
api_url: https://gitlab.example.com/
api_token: "{{ access_token }}"
project: "my_group/my_project"
hook_url: "https://my-ci-server.example.com/gitlab-hook"
state: present
push_events: yes
tag_push_events: yes
hook_validate_certs: no
token: "my-super-secret-token-that-my-ci-server-will-check"
- name: "Delete the previous hook"
community.general.gitlab_hook:
api_url: https://gitlab.example.com/
api_token: "{{ access_token }}"
project: "my_group/my_project"
hook_url: "https://my-ci-server.example.com/gitlab-hook"
state: absent
- name: "Delete a hook by numeric project id"
community.general.gitlab_hook:
api_url: https://gitlab.example.com/
api_token: "{{ access_token }}"
project: 10
hook_url: "https://my-ci-server.example.com/gitlab-hook"
state: absent
Значения возврата
Общие значения возврата описаны здесь. Ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| error строка | ошибка | Сообщение об ошибке, возвращенное API GitLab. Пример: 400: путь уже используется |
| hook словарь | всегда | Объект API. |
| msg строка | всегда | Сообщение об успехе или ошибке. Пример: Успешно |
| result словарь | всегда | Обработанный ответ сервера в формате JSON. |
Авторы
- Marcus Watkins (@marwatk)
- 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.10/collections/community/general/gitlab_hook_module.html
