gitlab_project - Создаёт/обновляет/удаляет проекты Gitlab
Новое в версии 2.1.
Описание
- Если проект не существует в Gitlab, он будет создан.
- Если проект существует и значение state=absent, проект будет удалён.
- Если в проекте внесены изменения, проект будет обновлён.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- pyapi-gitlab модуль Python
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| description | Значение по умолчанию: None | Описание проекта. |
| group | Значение по умолчанию: None | Имя группы, к которой принадлежит этот проект. Если не указано, проект будет принадлежать пользователю, настроенному в 'login_user' или 'login_token' Если указано имя пользователя, проект будет создан для этого пользователя. 'login_user' или 'login_token' должны иметь права администратора. |
| import_url | Значение по умолчанию: no | Репозиторий Git, который будет импортирован в Gitlab. Сервер Gitlab должен иметь права чтения для этого репозитория Git. |
| issues_enabled | Значение по умолчанию: yes | Нужно ли создавать задачи? Возможные значения: true и false. |
| login_password | Значение по умолчанию: None | Пароль Gitlab для login_user |
| login_token | Значение по умолчанию: None | Токен Gitlab для входа. |
| login_user | Значение по умолчанию: None | Имя пользователя Gitlab. |
| merge_requests_enabled | Значение по умолчанию: yes | Можно ли создавать запросы на слияние? Возможные значения: true и false. |
| name обязательно | Имя проекта | |
| path | Значение по умолчанию: None | Путь к проекту, который вы хотите создать, это будет server_url/<group>/path Если не указано, используется имя. |
| public | Значение по умолчанию: no | Доступ к проекту публичный или нет. Указание true эквивалентно установке visibility_level в 20. Возможные значения: true и false. |
| server_url обязательно | URL сервера Gitlab с протоколом (http или https). | |
| snippets_enabled | Значение по умолчанию: yes | Доступ к фрагментам кода должен быть доступен или нет. Возможные значения: true и false. |
| state |
| создание или удаление проекта. Возможные значения: present и absent. |
| validate_certs | Значение по умолчанию: yes | При использовании https, нужно ли проверять сертификат SSL. Псевдонимы: verify_ssl |
| visibility_level | Значение по умолчанию: 0 | Приватный. visibility_level равен 0. Доступ к проекту должен быть предоставлен явно для каждого пользователя. Внутренний. visibility_level равен 10. К проекту может получить доступ любой вошедший пользователь. Публичный. visibility_level равен 20. К проекту может получить доступ любой пользователь без аутентификации. Возможные значения: 0, 10 и 20. |
| wiki_enabled | Значение по умолчанию: yes | Нужна ли вики для этого проекта? Возможные значения: true и false. |
Примеры
- name: Delete Gitlab Project
gitlab_project:
server_url: http://gitlab.example.com
validate_certs: False
login_token: WnUzDsxjy8230-Dy_k
name: my_first_project
state: absent
delegate_to: localhost
- name: Create Gitlab Project in group Ansible
gitlab_project:
server_url: https://gitlab.example.com
validate_certs: True
login_user: dj-wasabi
login_password: MySecretPassword
name: my_first_project
group: ansible
issues_enabled: False
wiki_enabled: True
snippets_enabled: True
import_url: http://git.example.com/example/lab.git
state: present
delegate_to: localhost
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость.
Автор
- Werner Dijkerman (@dj-wasabi)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/gitlab_project_module.html