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