gitlab_project - Создаёт/обновляет/удаляет проекты Gitlab
Новое в версии 2.1.
Описание
- Если проект не существует в Gitlab, он будет создан.
- Если проект существует и state=absent, проект будет удалён.
- Если в проекте внесены изменения, проект будет обновлён.
Требования (к хосту, на котором выполняется модуль)
- pyapi-gitlab модуль Python
Параметры
| Параметр | Обязательный | Значение по умолчанию | Возможные значения | Комментарии |
|---|---|---|---|---|
| описание | нет | Описание проекта. | ||
| группа | нет | Имя группы, к которой принадлежит проект. Если не указано, проект будет принадлежать пользователю, настроенному в 'login_user' или 'login_token'. Если указано имя пользователя, проект будет создан для этого пользователя. 'login_user' или 'login_token' должны иметь права администратора. | ||
| import_url | нет | Git-репозиторий, который будет импортирован в Gitlab. Сервер Gitlab должен иметь права чтения для этого Git-репозитория. | ||
| issues_enabled | нет | True | Разрешить создание задач или нет. Возможные значения: true и false. | |
| login_password | нет | Пароль Gitlab для login_user | ||
| login_token | нет | Токен Gitlab для входа. | ||
| login_user | нет | Имя пользователя Gitlab. | ||
| merge_requests_enabled | нет | True | Разрешить создание запросов на слияние или нет. Возможные значения: true и false. | |
| имя | да | Имя проекта | ||
| путь | нет | Путь проекта, который вы хотите создать, это будет server_url/<группа>/путь Если не указано, используется имя. | ||
| public | нет | Доступ к проекту публичный или нет. Установка значения в true эквивалентна установке visibility_level в 20. Возможные значения: true и false. | ||
| server_url | да | URL сервера Gitlab, с протоколом (http или https). | ||
| snippets_enabled | нет | True | Разрешить создание фрагментов кода или нет. Возможные значения: true и false. | |
| state | нет | present |
| создание или удаление проекта. Возможные значения: present и absent. |
| validate_certs | нет | True | При использовании https, требуется проверка SSL-сертификата. Синонимы: verify_ssl | |
| visibility_level | нет | Приватный. visibility_level равен 0. Доступ к проекту должен быть предоставлен явно для каждого пользователя. Внутренний. visibility_level равен 10. Проект может быть скопирован любым авторизованным пользователем. Публичный. visibility_level равен 20. Проект может быть скопирован без авторизации. Возможные значения: 0, 10 и 20. | ||
| wiki_enabled | нет | True | Доступ к вики-проекту разрешён или нет. Возможные значения: 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
Статус
Этот модуль помечен как предварительный, что означает, что гарантии обратной совместимости нет.
Для получения помощи в разработке модулей, если вас это интересует, пожалуйста, ознакомьтесь с информацией по сообществу и участию в нём, тестированием Ansible и разработкой модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/gitlab_project_module.html