tbadmus / gitlab-ansible

Ansible role for gitlab CE and git installation

gitlab-ansible

Small Ansible role for provisionning Gitlab behind an Apache2

It will also initialize some users groups and projects if you want it to.

Some fact will be then available for further uses :

• gitlab_api_groups_result.json
  • list of the existing groups
• gitlab_existing_group_path
  • set of the existing groups path (unique)
• gitlab_api_projects_result.json
  • list of the existing projects in gitlab
• gitlab_existing_projects_name
  • set of the existing prjects names (unique)
• gitlab_api_users_result.json
  • list of the existing users in gitlab
• gitlab_existing_users_name
  • set of the existing username (unique)

Requirements

You should have a {{gitlab_user}} present, with a home on your target host

Role Variables

{{gitlab_domain}} I personnaly set it in my inventory file as a host var.

Defaults vars :

---

# User use by gitlab. See template configruation file. This user must exist in your system.
gitlab_user: "gitlab"

# gitlab user group. See template configruation file.
gitlab_group: "gitlab"

# Where to find the debian package 
gitlab_package_url: "https://downloads-packages.s3.amazonaws.com/ubuntu-14.04/gitlab_7.9.2-omnibus-1_amd64.deb"

# unicorn porn use by gitlab 
gitlab_port: "8042"
# mail gitlab will use when mailing notifications
gitlab_admin_mail: "[email protected]"

# General config.
gitlab_external_url: "https://{{gitlab_domain}}/"
gitlab_internal_url: "http://127.0.0.1:{{gitlab_port}}/"

gitlab_git_data_dir: "/home/{{gitlab_user}}/gitlab"
gitlab_public_dir: "{{ gitlab_git_data_dir }}/public"

# SSL Configuration.
gitlab_ssl_certificate: "/etc/gitlab/ssl/gitlab.crt"
gitlab_ssl_certificate_key: "/etc/gitlab/ssl/gitlab.key"

# SSL Self-signed Certificate Configuration.
gitlab_create_self_signed_cert: true
gitlab_self_signed_cert_subj: "/C=FR/ST=France/L=Toulouse/O=IT/CN={{gitlab_domain}}"

# Feel free to modify
gitlab_init_root_passwd: "ThisShouldBeYourLittleSecretPassword"

# PID file location
gitlab_pidfile: "/opt/gitlab/var/unicorn/unicorn.pid"

# To let apache2 do things with gitlab
gitlab_external_user: "www-data"


# Gitlab groups to create see http://doc.gitlab.com/ce/api/groups.html for optional fields
# every txt file  in the groups dir  should be a group formatted like this : name=FoobarGroup&path=foo-bar&description=This%20a%20Project
gitlab_groups: 
  - { name: 'Group1', path: 'group1', description: 'Group N°1' }
 

# List of gitlabt project to initialize, see http://doc.gitlab.com/ce/api/projects.html for optional fields 
gitlab_projects: 
  - {name: 'project1'}
  
# list of users to create see http://doc.gitlab.com/ce/api/users.html for optinal fields
gitlab_users: 
  - {username: 'user1', email: '[email protected]', password: 'UnBreakablePassword', name: 'As your mom call you'}
  

Dependencies

No other role dependecy

Example Playbook

- hosts: gitlab_servers
  roles:
     - { role: radamanth.gitlab-ansible}

License

GPL V2

Author Information

I've been a computer science engineer for more than 10 years now, I've discovered Ansible in 2014, and fell in love with it. I use it in my company to manage different server since then. Feel free to visit our site www.neovia.fr

I'm also one of the founder of Immozeo, where Ansible is also greatly used.

www.immozeo.com