Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
  • oel
  • v0.7.4
  • v0.7.3
  • v0.7.2
  • v0.7.1
  • v0.7.0
7 results

cookbook-gitlab

  • Clone with SSH
  • Clone with HTTPS
    • Name Last commit Last update
    attributes
    doc
    example
    recipes
    spec
    templates/default
    .gitignore
    .rspec
    Berksfile
    Berksfile.lock
    CONTRIBUTING.md
    Gemfile
    Gemfile.lock
    LICENSE
    README.md
    Thorfile
    Vagrantfile
    metadata.rb
    solo.json.production_example
    README.md

    GitLab Cookbook

    Chef cookbook with recipes to install GitLab and its dependencies:

    • GitLab: 7.2
    • GitLab Shell: 1.9.7
    • Ruby: 2.1.2
    • Redis: 2.6.13
    • Git: 2.0.0
    • Nginx: 1.1.19
    • PostgreSQL: 9.3
    • MySQL: 5.5.34

    Compatible operating systems

    Cookbook has been tested and it is known to work on:

    • Ubuntu (12.04, 12.10, 14.04)
    • RHEL/CentOS (6.5)

    Installation

    Development installation

    Production installation

    If you want to do a production installation using AWS Opsworks please see the cookbook for GitLab on AWS Opsworks repository.

    Recipes

    clone

    Clones the GitLab repository. Recipe uses the attributes in attributes/default.rb and, depending on the environment set, attributes/development.rb or attributes/production.rb.

    database_mysql

    Use to setup mysql database. Available attributes are listed in attributes/default.rb.

    database_posgresql

    Use to setup postgresql database. Available attributes are listed in attributes/default.rb.

    default

    Default recipe, it includes two recipes: setup and deploy. Default recipe is being used to do the complete GitLab installation.

    deploy

    Used to clone, configure, setup and start a GitLab instance. deploy recipe can be used with AWS OpsWorks to deploy GitLab to an instance. To use with AWS OpsWorks:

    1. Use a preset Rails App Server layer or create a custom one
    2. Edit the layer
    3. Under section Custom Chef Recipes and Deploy fill in gitlab::deploy and save

    NOTE: Must be used in combination with gitlab::setup recipe.

    gems

    This recipe decides what will be included and what will be omitted from the bundle install command and then it runs the bundle install. Inclusion or exclusion is decided based on the database selected and environment, using attributes in attributes/default.rb

    git

    Installs packages required for git and compiles it from source. Uses attributes provided in attributes/git.rb.

    gitlab_shell_clone

    Clones the gitlab-shell repository. Recipe uses the attributes in attributes/default.rb and, depending on the environment set, attributes/development.rb or attributes/production.rb.

    gitlab_shell_install

    Creates a gitlab-shell config.yml from attributes in attributes/default.rb and, depending on the environment set, attributes/development.rb or attributes/production.rb. Runs gitlab-shell install script and install it.

    install

    Creates a gitlab config.yml, database.yml from attributes in attributes/default.rb and, depending on the environment set, attributes/development.rb or attributes/production.rb. Creates GitLab required directories and sets permissions. Copies the example files to their locations. Runs db:setup, db:migrate, db:seed_fu to prepare selected database for GitLab.

    nginx

    Installs and configures nginx for usage.

    packages

    Installs all GitLab dependency packages supplied in attributes/default.rb.

    ruby

    Compiles ruby from source based on attributes in attributes/default.rb.

    setup

    Includes packages, ruby, users and database recipes to prepare the server for GitLab. setup recipe can be used with AWS OpsWorks to setup requirements for GitLab. To use with AWS OpsWorks:

    1. Use a preset Rails App Server layer or create a custom one
    2. Edit the layer
    3. Under section Custom Chef Recipes and Setup fill in gitlab::setup and save

    NOTE: Must be used in combination with gitlab::deploy recipe.

    start

    Enables gitlab service and starts GitLab.

    users

    Creates a GitLab user called git.

    Testing the cookbook

    First install the necessary gems

    bundle install

    To check for syntax errors run foodcritic:

    foodcritic .

    assuming that you are inside cookbook-gitlab directory.

    Run tests with:

    bundle exec rspec

    Acknowledgements

    This cookbook was based on a cookbbook by ogom, thank you ogom! We would also like to thank Eric G. Wolfe for making the first cookbook for CentOS, thanks Eric!

    Contributing

    Please see the Contributing doc.

    Links

    Authors

    License