gitlab_group – Creates/updates/deletes Gitlab Groups

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

Synopsis

• When the group does not exist in Gitlab, it will be created.
• When the group does exist and state=absent, the group will be deleted.

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 Group"
  gitlab_group:
    api_url: https://gitlab.example.com/
    api_token: "{{ access_token }}"
    validate_certs: False
    name: my_first_group
    state: absent

- name: "Create Gitlab Group"
  gitlab_group:
    api_url: https://gitlab.example.com/
    validate_certs: True
    api_usersername: dj-wasabi
    api_password: "MySecretPassword"
    name: my_first_group
    path: my_first_group
    state: present

# The group will by created at https://gitlab.dj-wasabi.local/super_parent/parent/my_first_group
- name: "Create Gitlab SubGroup"
  gitlab_group:
    api_url: https://gitlab.example.com/
    validate_certs: True
    api_usersername: dj-wasabi
    api_password: "MySecretPassword"
    name: my_first_group
    path: my_first_group
    state: present
    parent: "super_parent/parent"

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)