gitlab_project – Создаёт/обновляет/удаляет проекты Gitlab
Новая версия с 2.1.
Обзор
- Если проект не существует в Gitlab, он будет создан.
- Если проект существует и state=absent, проект будет удалён.
- Если в проект внесены изменения, проект будет обновлён.
Требования
Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.
- pyapi-gitlab модуль python
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| description - | Описание проекта. | |
| group - | Название группы, к которой принадлежит этот проект. Если не указано, проект будет принадлежать пользователю, настроенному в 'login_user' или 'login_token'. Если указано имя пользователя, проект будет создан для этого пользователя. 'login_user' или 'login_token' должны иметь права администратора. | |
| import_url boolean |
| Git репозиторий, который будет импортирован в gitlab. Сервер Gitlab должен иметь права на чтение этого Git репозитория. |
| issues_enabled boolean |
| Нужно ли создавать задачи? Возможные значения — true и false. |
| login_password - | Пароль Gitlab для login_user | |
| login_token - | Токен Gitlab для входа. | |
| login_user - | Имя пользователя Gitlab. | |
| merge_requests_enabled boolean |
| Разрешить или нет создание запросов на слияние? Возможные значения — true и false. |
| name - / обязательно | Название проекта | |
| path - | Путь проекта, который вы хотите создать, это будет server_url/<group>/путь Если не указано, будет использовано имя. | |
| public boolean |
| Доступ к проекту общедоступен или нет? Установить true равносильно установке visibility_level в 20. Возможные значения — true и false. |
| server_url - / обязательно | URL сервера Gitlab с протоколом (http или https). | |
| snippets_enabled boolean |
| Должны ли быть доступны фрагменты кода? Возможные значения — true и false. |
| state - |
| Создать или удалить проект. Возможные значения — present и absent. |
| validate_certs boolean |
| При использовании https, необходимо ли проверять сертификат SSL. псевдонимы: verify_ssl |
| visibility_level - | По умолчанию: 0 | Приватный. visibility_level равен 0. Доступ к проекту необходимо предоставить для каждого пользователя. Внутренний. visibility_level равен 10. Любой авторизованный пользователь может клонировать проект. Общедоступный. visibility_level равен 20. Любой пользователь может клонировать проект без авторизации. Возможные значения — 0, 10 и 20. |
| wiki_enabled boolean |
| Нужна ли вики-страница для проекта? Возможные значения — 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. [сообщество]
Авторы
- 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.7/modules/gitlab_project_module.html
