Spec-Zone.ru › Ansible 2.4

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
создание или удаление проекта.
Возможные значения: 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API