antik486 / puppet-gitlab

Puppet-gitlab

Tested successfully with Gitlab 6-5-stable on Ubuntu 12.04 and Debian Wheezy (7.2) with Puppet 3.2 or newer.

Overview

GitLab is a free project and repository management application

A Puppet Module is a collection of related content that can be used to model the configuration of a discrete service.

Module description

This module is based on the admin guides for gitlab, stable version.

puppet-gitlab on puppet forge.

Dependencies

puppetlabs/puppetlabs-stdlib See gitlab example.

GitLab web interface

access via your browser under the hostname (e.g. http://gitlab.domain.tld)
Login: admin@local.host
Password: 5iveL!fe

Add an ssh key to your account, or create another account
Create a project
Play !

Parameters

ensure: Ensure gitlab/gitlab-shell repo are present, latest. absent is not yet supported (default: present)
git_user: Name of the gitlab (default: git)
git_home: Home directory for gitlab repository (default: /home/git)
git_email: Email address for gitlab user (default: git@someserver.net)
git_comment: Gitlab user comment (default: GitLab)
gitlab_sources: Gitlab sources (default: git://github.com/gitlabhq/gitlabhq.git)
gitlab_branch: Gitlab branch (default: 6-5-stable)
gitlabshell_sources: Gitlab-shell sources (default: git://github.com/gitlabhq/gitlab-shell.git)
gitlabshell_branch: Gitlab-shell branch (default: v1.8.0)
gitlab_http_port: Port that NGINX listens on for HTTP traffic (default: 80)
gitlab_ssl_port: Port that NGINX listens on for HTTPS traffic (default: 443)
gitlab_http_timeout: HTTP timeout in seconds (unicorn/nginx) (default: 60)
gitlab_redishost: Redis host used for Sidekiq (default: localhost)
gitlab_redisport: Redis host used for Sidekiq (default: 6379)
gitlab_dbtype: Gitlab database type (default: mysql)
gitlab_dbname: Gitlab database name (default: gitlab_db)
gitlab_dbuser: Gitlab database user (default: gitlab_user)
gitlab_dbpwd: Gitlab database password (default: changeme)
gitlab_dbhost: Gitlab database host (default: localhost)
gitlab_dbport: Gitlab database port (default: 3306)
gitlab_domain: Gitlab domain (default $fqdn)
gitlab_repodir: Gitlab repository directory (default: $git_home)
gitlab_backup: Whether to enable automatic backups (default: false)
gitlab_backup_path: Path where Gitlab's backup rake task puts its files (default: tmp/backups)
gitlab_backup_keep_time: Retention time of Gitlab's backups (in seconds) (default: 0 == forever)
gitlab_backup_time: Time (hour) when the Gitlab backup task is run from cron (default: fqdn_rand(5)+1)
gitlab_backup_postscript: Path to one or more shell scripts to be executed after the backup (default: false)
gitlab_ssl: Enable SSL for GitLab (default: false)
gitlab_ssl_cert: SSL Certificate location (default: /etc/ssl/certs/ssl-cert-snakeoil.pem)
gitlab_ssl_key: SSL Key location (default: /etc/ssl/private/ssl-cert-snakeoil.key)
gitlab_ssl_self_signed: Set true if your SSL Cert is self signed (default: false)
gitlab_projects: GitLab default number of projects for new users (default: 10)
gitlab_username_change: Manage username changing in GitLab (default: true)
gitlab_unicorn_port: Port that unicorn listens on 172.0.0.1 for HTTP traffic (default: 8080)
gitlab_unicorn_worker: Number of unicorn workers (default: 2)
exec_path: PATH of executtion (default: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin)
ldap_enabled: Enable LDAP backend for gitlab web (see bellow) (default: false)
ldap_host: FQDN of LDAP server (default: ldap.domain.com)
ldap_base: LDAP base dn (default: dc=domain,dc=com)
ldap_uid: Uid for LDAP auth (default: uid)
ldap_port: LDAP port (default: 636)
ldap_method: Method to use (default: ssl)
ldap_bind_dn: User for LDAP bind auth (default: nil)
ldap_bind_password: Password for LDN bind auth (default: nil)
git_package_name: Package name for git (default: git-core)

Usage

Note: Assume that a database server is already installed on your server/infrastructure (see: vagrant-gitlab).

class {
  'gitlab':
    git_email         => 'notifs@foobar.fr',
    git_comment       => 'GitLab',
    gitlab_domain     => 'gitlab.foobar.fr',
    gitlab_dbtype     => 'mysql',
    gitlab_dbname     => $gitlab_dbname,
    gitlab_dbuser     => $gitlab_dbuser,
    gitlab_dbpwd      => $gitlab_dbpwd,
    ldap_enabled      => false,
}

Limitations

TBF

Development

Want to help - send a pull request.

Development environment with vagrant

See vagrant-gitlab.