Documentation

gitlab_user - Creates/updates/deletes Gitlab Users

New in version 2.1.

Synopsis

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

Requirements (on host that executes module)

  • pyapi-gitlab python module
  • administrator rights on the Gitlab server

Options

parameter required default choices comments
access_level
no
The access level to the group. One of the following can be used.
guest
reporter
developer
master
owner
confirm
(added in 2.4)
no True
Require confirmation.
email
yes
The email that belongs to the user.
group
no
Add user as an member to this group.
login_password
no
Gitlab password for login_user
login_token
no
Gitlab token for logging in.
login_user
no
Gitlab user name.
name
yes
Name of the user you want to create
password
yes
The password of the user.
server_url
yes
Url of Gitlab server, with protocol (http or https).
sshkey_file
no
The ssh key itself.
sshkey_name
no
The name of the sshkey
state
no present
  • present
  • absent
create or delete group.
Possible values are present and absent.
username
yes
The username of the user.
validate_certs
no True
When using https if SSL certificate needs to be verified.

aliases: verify_ssl

Examples

- name: Delete Gitlab User
  gitlab_user:
    server_url: http://gitlab.example.com
    validate_certs: False
    login_token: WnUzDsxjy8230-Dy_k
    username: myusername
    state: absent
  delegate_to: localhost

- name: Create Gitlab User
  gitlab_user:
    server_url: https://gitlab.dj-wasabi.local
    validate_certs: True
    login_user: dj-wasabi
    login_password: MySecretPassword
    name: My Name
    username: myusername
    password: mysecretpassword
    email: [email protected]
    sshkey_name: MySSH
    sshkey_file: ssh-rsa AAAAB3NzaC1yc...
    state: present
  delegate_to: localhost

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.