What do you get with Print?

Instant access to your digital copy whilst your Print order is Shipped

Paperback book shipped to your preferred address

Redeem a companion digital copy on all Print orders

Access this title in our online reader with advanced features

DRM FREE - Read whenever, wherever and however you want

Gitlab Cookbook

Chapter 1. Introduction and Installation

In this chapter, we will cover the following recipes:

Using the Omnibus package
Setting up the server dependencies for source installation
Setting up the database for source installation
Installing GitLab from source
Using Chef and GitLab Cookbook
Logging in for the first time
Creating your first project

Using the Omnibus package

The people from GitLab have created an Omnibus package for the major Linux distributions (Ubuntu, Debian, and CentOS). These packages are an easy way of installing your GitLab installation, as they have all the dependencies packaged with them.

For this recipe, we are going to use the Ubuntu version of the Omnibus package.

Getting ready

Before we start installing, you need to have a server installed with a Ubuntu 12.04 64-bit system, and have SSH access to the server.

How to do it…

Here is how you can install GitLab using Omnibus:

Download the package, change the X.Y.Z portion to the version you want to download. At the time of writing, 7.3.2 is the latest version:
```
wget https://downloads-packages.s3.amazonaws.com/ubuntu-12.04/gitlab_X.Y.Z-omnibus.5.1.0.ci-1_amd64.deb
```
Install the OpenSSH server:
```
sudo apt-get install openssh-server
```
Install Postfix:
```
sudo apt-get install postfix
```
Postfix will ask you what kind of installation you want; choose the Internet Site option.
Enter the fully qualified domain name for the domain you want GitLab to send e-mails from (that is, gitlab.example.com).
Install the Omnibus package, and replace the X.Y.Z part with your version:
```
sudo dpkg -i gitlab_7.3.2-omnibus.5.1.0.ci-1_amd64.deb
```
Now, we will configure your GitLab instance by running the following command:
```
sudo gitlab-ctl reconfigure
```
Check to see whether all the services are running using the following command:
```
sudo gitlab-ctl status
```
The output should look like the following screenshot:

You can now log in with the username root and password 5iveL!fe.

How it works…

We have just installed GitLab via the Omnibus installer. Omnibus is a way to package your application and install all the dependencies that are required to run it.

GitLab makes good use of this capability. As you only have to install a mail server and an OpenSSH server, all the other parts are automatically installed for you.

GitLab will auto configure itself with the recommended settings. If you want to change your configuration, you have to first create the configuration file. You can do this as follows:

$ sudo mkdir -p /etc/gitlab
$ sudo touch /etc/gitlab/gitlab.rb
$ sudo chmod 600 /etc/gitlab/gitlab.rb

The settings that you are most likely to change are the ones that are in the gitlab.yml file (https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example).

You need to make a small translation change in order to make this work, so let's say you want to change the port that GitLab is running on; normally, you would change the port value in the GitLab file, but now you have to add an entry to /etc/gitlab/gitlab.rb.

So, for the port, the entry in gitlab.yml would look like the following code:

production: &base
  gitlab:
    port: 80

In the gitlab.rb file, you need to create the following entry: gitlab_rails['port'] = 80.

Installing GitLab from source

In this recipe, I will help you install GitLab from source. Installing from source means that we will take the source code from gitlab.com and use that to code in order to install it on our server.

At the time of writing, 7.4 is the latest version. If you want to be sure that you have the latest version, please check https://gitlab.com/gitlab-org/gitlab-ce/blob/master/VERSION.

If you want the latest bleeding edge version, you can change 7.4 to master in this recipe.

Getting ready

To install GitLab on your own server, you need to have a few things installed already. Here is a list of prerequisites:

A server running Debian or Ubuntu; preferably one of the latest versions, and running as 64-bit
Git Version 1.7 or higher
A text editor; in the examples, I'll be using Vim
Sudo; on Debian this is not installed by default
A working mail server
You have to set up the database
You have to install all the server dependencies

How to do it…

Follow these steps to install GitLab from source:

Download the source code:

$ cd /home/git
$ sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab-ce.git -b 6-9-stable gitlab

In config/gitlab.yml, we need to change the host to the fully-qualified domain name of your GitLab instance. Also change the email_from to the e-mail address you want to use as a from address for all the e-mails that are sent by GitLab:
```
$ cd /home/git/gitlab
$ sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml
$ sudo -u git -H editor config/gitlab.yml
```

Make sure that GitLab can write to the necessary folders using the following command lines:

$ sudo chown -R git log/ 
$ sudo chown -R git tmp/ 
$ sudo chmod -R u+rwX log/ 
$ sudo chmod -R u+rwX tmp/
$ sudo chmod -R u+rwX tmp/pids/ 
$ sudo chmod -R u+rwX tmp/sockets/
$ sudo chmod -R u+rwX  public/uploads

Create the directory for the GitLab satellites:

$ sudo -u git -H mkdir /home/git/gitlab-satellites 
$ sudo chmod u+rwx,g+rx,o-rwx /home/git/gitlab-satellites

Copy the Unicorn config file:

$ sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb

Copy the Rack attack config file:

$ sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb

Copy the init script and make GitLab start on boot:

$ sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab
$ sudo update-rc.d gitlab defaults 21

Set up Logrotate:

$ sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab

Set up the Git user. This helps when editing files via the GitLab web interface. Make sure that the user.email is the same as the e-mail address you entered in step 8:

$ sudo -u git -H git config --global user.name "GitLab" 
$ sudo -u git -H git config --global user.email "example@example.com" 
$ sudo -u git -H git config --global core.autocrlf input

Configure your GitLab database:

$ sudo -u git -H cp config/database.yml.postgresql config/database.yml

Make sure that the database.yml file is only readable for the git user:
```
$ sudo -u git -H chmod o-rwx config/database.yml
```

Install the GitLab dependencies:

$ sudo -u git -H bundle install --deployment --without development test mysql aws

Install the GitLab shell:

$ sudo -u git -H bundle exec rake gitlab:shell:install[v1.9.4] REDIS_URL=redis://localhost:6379 RAILS_ENV=production

Initialize the database:

$ sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production force=yes

Compile all the assets:

$ sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production

Start your GitLab instance:
```
$ sudo /etc/init.d/gitlab restart
```

How it works…

We have just installed GitLab on our server. We have done this by downloading the source code from gitlab.com and performing the preceding steps.

Let's take a look at what we did in every step.

In step 1, we downloaded the source code for GitLab. We haven't done anything with it yet, just downloaded it.

In step 2, we done the basic configuration of GitLab. We have changed the hostname to the fully-qualified domain name you want to access your GitLab on, for example, gitlab.example.com. Also, we have configured the e-mail addresses that GitLab will send mails from. The email_from will be used as the from address of all the e-mails that are sent via GitLab.

Next was the setup for the satellite directory. Satellites are used when you create a merge request, and GitLab has to check whether it is mergeable, and perform the actual merge. A satellite is just checking out of the repository that GitLab has access to.

We then went on to copy some files. The first file was the Unicorn configuration file. Unicorn was used as the application server and we copied the Rack Attack files. Rack Attack is used in order to prevent abusive requests to your GitLab server. One way to make sure that no harmful requests make it to your server is by request throttling. This means that we only allow 10 requests per 60 seconds to certain URLs.

The next important step is the configuration of the database. As we are using PostgreSQL on the same machine, the configuration is really straightforward: just copy the right database.yml file and we are done, well almost; we also need to protect our database.yml file so that it's only readable for the Git user.

The dependency installation is done via Bundler. Bundler is the package manager for Ruby. We have passed the flags --deployment and --without development test mysql aws. The first flag is passed to make sure that the dependencies are installed in the context of GitLab and not in a system-wide context. The second flag is passed to make sure that only the necessary dependencies are installed. If you want to learn more about Bundler, take a look at www.bundler.io.

GitLab has its own Git wrapper to perform Git commands on the server. This wrapper is called GitLab Shell. In step 11, we tell GitLab to fetch the code for GitLab Shell and install it.

In step 12, we set up the database. We create the database and load the database schema. We also create the first user, so that you can log in to your server.

Using Chef and GitLab Cookbook

You can install GitLab using chef-solo. It allows you to install a server and all of its dependencies through a pre-programmed script. GitLab Cookbook is also used as the base for the Omnibus Package.

If you want more information on Chef, please take a look at www.getchef.com.

For this recipe, we are going to use a Ubuntu-based installation.

Getting ready

Before we start installing, you need to have a server installed with Ubuntu and have SSH access to the server. Your server needs to have at least 2 GB of RAM to compile all the requirements.

How to do it…

We start with downloading some server dependencies:

sudo apt-get update && sudo apt-get install -y build-essential git curl

Download the chef-solo file:

curl -o /tmp/solo.json https://gitlab.com/gitlab-org/cookbook-gitlab/raw/master/solo.json.production_example

We have to edit the file we just downloaded so that it fits our needs:
```
vi /tmp/solo.json
```

As we will be using PostgreSQL, you can remove the MySQL part. Also, make sure you change the revision to the latest stable branch, 7.3 at time of writing. After you are done, your file should look like the following code, but with your own host and e-mail addresses:

  "gitlab": {
    "host": "gitlab.example.com",
    "url": "http://gitlab.example.com/",
    "email_from": "gitlab@example.com",
    "support_email": "support@gitlab.example.com",
    "database_adapter": "postgresql",
    "database_password": "super-secure-password",
    "revision": "6-9-stable"
  },
  "postgresql": {
    "password": {
      "postgres": "psqlpass"
    }
  },
  "postfix": {
    "mail_type": "client",
    "myhostname": "gitlab.example.com",
    "mydomain": "mydomain.com",
    "myorigin": "gitlab.example.com",
    "smtp_use_tls": "no"
  },
  "run_list": [
    "postfix",
    "gitlab::default"
  ]
}

Next, we download and install Chef to our server:

cd /tmp; curl -LO https://www.opscode.com/chef/install.sh; sudo bash ./install.sh -v 11.4.4; sudo /opt/chef/embedded/bin/gem install berkshelf --no-ri --no-rdoc

Now, we download the GitLab source from gitlab.com:

git clone https://gitlab.com/gitlab-org/cookbook-gitlab.git /tmp/cookbook-gitlab

Install all the GitLab-specific dependencies:

cd /tmp/cookbook-gitlab; /opt/chef/embedded/bin/berks vendor /tmp/cookbooks

We need to create one more Chef config file:
```
vi /tmp/solo.rb
```

Add the following content to the preceding config file:

cookbook_path    ["/tmp/cookbooks/"]
log_level        :debug

Save the file.
We are done with configuring everything and now let's install GitLab!
```
sudo chef-solo -c /tmp/solo.rb -j /tmp/solo.json
```

How it works…

We just installed GitLab via the Chef cookbook. This way of installation is a little more automated than the installation from source, but it still gives you a bit more control over your installation in comparison to the Omnibus package.

Let's go through the steps that we took to install GitLab in this way.

First, we had to install some server dependencies that were needed to install Chef, and we also cloned the code from GitLab. The dependencies included Curl and Git. We used Curl to download the chef.json file, and in step 4, to download the check installation file. Git was needed to clone the source of GitLab, and to make sure that GitLab, when installed, is able to serve your repositories.

Next, we had to download the config.json file. This JSON file keeps the configuration information for GitLab in order to install itself. You can compare this to the gitlab.yml file from the Installing GitLab from source recipe.

In this recipe, we installed GitLab using PostgreSQL. If you'd prefer to install it with MySQL, that's possible. Just keep in mind that PostgreSQL is the recommended way of running GitLab.

The next step was to download the GitLab source and to install the GitLab dependencies. After we had done that, we created the solo.rb file. This file is used by chef-solo to know where GitLab Cookbook is located.

The last step was to install GitLab itself. This step took a while because the command also downloaded and compiled Ruby for you.

Description

This book is aimed at developers and devops that have a GitLab server running, and want to be sure they use it to its full potential. This book will also be useful for people looking for a great Git platform, and learn how to set it up successfully. Some system administrating experience on a UNIX-based system would be useful, but is not required.

What you will learn

Install and maintain your GitLab instance

Work with multiple users, create groups, and configure your project visibility

Secure your code with the correct GitLab configuration

Make the most of the builtin issue tracker, including merge requests

Manage your projects through the GitLab API

Set up webhooks and system hooks to receive notifications

Manage your GitLab server using LDAP

What do you get with Print?

Instant access to your digital copy whilst your Print order is Shipped

Paperback book shipped to your preferred address

Redeem a companion digital copy on all Print orders

Access this title in our online reader with advanced features

DRM FREE - Read whenever, wherever and however you want

Frequently bought together

Git Essentials

Apr 2015 168 pages

3.9 (9)

eBook

€14.99 ~~€16.99~~

Git Best Practices Guide

Nov 2014 102 pages

1 (1)

eBook

€15.99 ~~€17.99~~

Gitlab Cookbook

Dec 2014 172 pages

3.3 (3)

eBook

€17.98 ~~€19.99~~

Total € 68.97

€20.99

€22.99

€24.99

Total € 68.97

dblessing Feb 24, 2015

This book covers all the details needed to get up and running with git and GitLab. Jeroen does a great job with tough topics for beginners in his introduction to git, installation of GitLab from source and the new Omnibus packages, basic troubleshooting and managing upgrades. This book also provides in-depth coverage of all the GitLab features, GitLab Continuous Integration server (GitLab CI), the GitLab API, and more. I was pleasantly surprised to see the section dedicated to LDAP integration, too. Overall, this book provides a good foundation for GitLab users.

Amazon Verified review

Erich S. Mar 08, 2016

Dieses Buch liefert in kurzen und verständlichen Beispielen die Grundzüge von GitLab. Da ich selbst von der Gerrit-Welt komme ist GitLab für mich ein weiter Sprung Richtung Development Zukunft.Schmerzlich vermisse ich jedoch Beispiele für die Anbindung an externe Systeme wie JIRA & Jenkins, welche jedoch State of the Art für Developers & DevOps sind.

John Pitton Sep 05, 2016

A lot of the material is outdated. Almost all of what this book covers is listed for free at gitlabdotcomslashhelp. It would be awesome if the book was periodically updated biannually.

Gitlab Cookbook: Over 60 hands-on recipes to efficiently self-host your own Git repository using GitLab

What do you get with Print?

Gitlab Cookbook

Chapter 1. Introduction and Installation

Introduction

Using the Omnibus package

Getting ready

How to do it…

How it works…

Setting up the server dependencies for source installation

How to do it…

How it works…

Set up the database for source installation

How to do it…

Installing GitLab from source

Getting ready

How to do it…

How it works…

Using Chef and GitLab Cookbook

Getting ready

How to do it…

How it works…

Logging in for the first time

How to do it…

How it works…

Creating your first project

How to do it…

Page 1 of 9

Description

What you will learn

Product Details

What do you get with Print?

Product Details

Frequently bought together

Table of Contents

Recommendations for you

Customer reviews

People who bought this also bought

About the author

FAQs

Gitlab Cookbook: Over 60 hands-on recipes to efficiently self-host your own Git repository using GitLab

What do you get with Print?

Contact Details

Shipping Address

Billing Address

Description

What you will learn

Product Details

What do you get with Print?

Contact Details

Shipping Address

Billing Address

Product Details

Packt Subscriptions

Frequently bought together

Table of Contents

Recommendations for you

Customer reviews

People who bought this also bought

About the author

FAQs