Skip to content

rvrangel/puppet-gitlab

 
 

Repository files navigation

Puppet-gitlab Build Status

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

Table of contents

  1. Overview
  2. Module description
  3. Parameters
  4. Usage
  5. Limitation
  6. Development

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.

Dependencies

GitLab web interface

  1. Add an ssh key to your account, or create another account
  2. Create a project
  3. 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-4-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_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)

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.

About

Puppet module for manage GitLab installation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 70.8%
  • Puppet 29.2%