gitlab_project – Creates/updates/deletes GitLab Projects

• Synopsis
• Requirements
• Parameters
• Examples
• Return Values
• Status

Synopsis

• When the project does not exist in GitLab, it will be created.
• When the project does exists and state=absent, the project will be deleted.
• When changes are made to the project, the project will be updated.

Requirements

The below requirements are needed on the host that executes this module.

• python >= 2.7
• python-gitlab python module <= 1.12.1

Parameters

Examples

- name: Delete GitLab Project
  gitlab_project:
    api_url: https://gitlab.example.com/
    api_token: "{{ access_token }}"
    validate_certs: False
    name: my_first_project
    state: absent
  delegate_to: localhost

- name: Create GitLab Project in group Ansible
  gitlab_project:
    api_url: https://gitlab.example.com/
    validate_certs: True
    api_username: dj-wasabi
    api_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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Status

• This module is not guaranteed to have a backwards compatible interface. [preview]
• This module is maintained by the Ansible Community. [community]

Authors

• Werner Dijkerman (@dj-wasabi)
• Guillaume Martinez (@Lunik)