ansible.builtin.gitlab_group (v2.3.0.0-1) — module

Creates/updates/deletes Gitlab Groups

| "added in version" 2.1 of ansible.builtin"

Authors: Werner Dijkerman (@dj-wasabi)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.3.0.0.post1

Description

When the group does not exists in Gitlab, it will be created.

When the group does exists and state=absent, the group will be deleted.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete Gitlab Group
  gitlab_group:
    server_url: http://gitlab.example.com
    validate_certs: False
    login_token: WnUzDsxjy8230-Dy_k
    name: my_first_group
    state: absent
  delegate_to: localhost
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create Gitlab Group
  gitlab_group:
    server_url: https://gitlab.example.com
    validate_certs: True
    login_user: dj-wasabi
    login_password: MySecretPassword
    name: my_first_group
    path: my_first_group
    state: present
  delegate_to: localhost

Inputs

    
name:
    description:
    - Name of the group you want to create.
    required: true

path:
    default: null
    description:
    - The path of the group you want to create, this will be server_url/group_path
    - If not supplied, the group_name will be used.
    required: false

state:
    choices:
    - present
    - absent
    default: present
    description:
    - create or delete group.
    - Possible values are present and absent.
    required: false

login_user:
    default: null
    description:
    - Gitlab user name.
    required: false

server_url:
    description:
    - Url of Gitlab server, with protocol (http or https).
    required: true

login_token:
    default: null
    description:
    - Gitlab token for logging in.
    required: false

login_password:
    default: null
    description:
    - Gitlab password for login_user
    required: false

validate_certs:
    aliases:
    - verify_ssl
    default: true
    description:
    - When using https if SSL certificate needs to be verified.
    required: false