New in version 2.1.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
description | An description for the project. | |
group | The name of the group of which this projects belongs to. When not provided, project will belong to user which is configured in 'login_user' or 'login_token' When provided with username, project will be created for this user. 'login_user' or 'login_token' needs admin rights. | |
import_url bool |
| Git repository which will be imported into gitlab. Gitlab server needs read access to this git repository. |
issues_enabled bool |
| Whether you want to create issues or not. Possible values are true and false. |
login_password | Gitlab password for login_user | |
login_token | Gitlab token for logging in. | |
login_user | Gitlab user name. | |
merge_requests_enabled bool |
| If merge requests can be made or not. Possible values are true and false. |
name required | The name of the project | |
path | The path of the project you want to create, this will be server_url/<group>/path If not supplied, name will be used. | |
public bool |
| If the project is public available or not. Setting this to true is same as setting visibility_level to 20. Possible values are true and false. |
server_url required | Url of Gitlab server, with protocol (http or https). | |
snippets_enabled bool |
| If creating snippets should be available or not. Possible values are true and false. |
state |
| create or delete project. Possible values are present and absent. |
validate_certs bool |
| When using https if SSL certificate needs to be verified. aliases: verify_ssl |
visibility_level | Default: 0 | Private. visibility_level is 0. Project access must be granted explicitly for each user. Internal. visibility_level is 10. The project can be cloned by any logged in user. Public. visibility_level is 20. The project can be cloned without any authentication. Possible values are 0, 10 and 20. |
wiki_enabled bool |
| If an wiki for this project should be available or not. Possible values are true and 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
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/gitlab_project_module.html