GitLab: In case you missed it

Mar 14, 2016

I've recently joined GitLab as a Developer Advocate. Part of my role will be traveling to community events where I hope we'll meet in person. I'm also an experienced Ruby developer. As a rubyist, naturally, I've heard about GitLab and even used it couple of times.

The first two weeks working with GitLab have been full of pleasant surprises and dispelled delusions. If you haven't been following GitLab for the last two years, this post is for you.

You don't have to download and install GitLab nowadays. You can simply sign up for and host your own repositories. Even the private ones. Yes, for free and without any restrictions. No, there is no catch.

It should be noted that repositories are actually called "projects".

And that is not the only thing that catches your eye at first. As it turns out, the terminology is justified.

The terminology

These aren't just fancy terms to stand out from the crowd. I strongly recommend reading the article about GitLab, GitHub and Bitbucket and terms comparison, if you wish to sort out the details. I'd like to bring up the "Merge requests" topic, as it's the most controversial.

My initial reaction, naturally, was rejection. Most of us are accustomed to "Pull requests", so what's the big idea? But then I remembered that the title "Pull request" never did make perfect sense to me because closing a pull request actually does branch merging.

As it turns out, there is a command git request-pull, hence the feature title.

Pull requests have nothing in common with this git command. So, technically the correct name is "merge request". Learn more on terminology differences, if you're interested.

The terminology was just a part of the deal. When reading the documentation, I discovered something called "omnibus" and found some mysterious "runners" and "shared runners" in the settings. But first things first. Runners are connected to CI. Omnibus is related to GitLab installation on your own server.

Continuous Integration (CI)

Continuous Integration is a best practice in software development. For example, a CI server runs your tests every time you push changes to the repository.

A lot of companies have a separate CI service but in GitLab, CI is embedded.

If you had to manually connect two services before, it just works on its own in GitLab. Though you can still use other continuous integration services such as Jenkins.

And it works through runners.


A runner is a virtual machine that runs your tests, builds your builds or generates static files for your websites. users are able to make use of a special Shared Runners pool to simply make everything work.

Since the pool is shared across all projects on, sometimes it can take a while to wait for your project's build to be processed.

If you are not satisfied with the Shared runners performance, you can setup a runner on your own server and connect it to one or more projects.

Don't forget that you can install GitLab on your own server as well.

GitLab installation with Omnibus

In the past, GitLab was installed manually. Now you can install and update the service from packages thanks to Omnibus. Omnibus is a tool developed by Chef that helps to create installation packages for complex software with a lot of components for various platforms.

Any installation using Omnibus lasts for 2-6 minutes tops, depending on your server performance. This is what GitLab installation looks like on Ubuntu 14.04 using a relatively slow VPS with 2Gb running memory:

Hint: in case you'd prefer not to mess with console installation and updates at all, you can simply rent a GitLab server on

Both Omnibus and built-in CI are just a portion of what is being done to make developers' jobs easier. Let us review a few features.

Small features that make a difference

Merge when build succeeds

With GitLab, you don't have to wait for your build to turn green to finally merge the branch. You can simply ask GitLab to do that for you.

Merge when build succeeds

Publishing with GitLab Pages

GitLab Pages runs on top of the built-in CI. Thanks to the feature, you can host websites created by any static site generators on GitLab.

Fork a repo from GitLab examples or figure out GitLab CI settings to forget all about the manual static generation. You simply push your changes to the repository and GitLab generates and deploys everything on its own.

Custom CNAME and TLS are supported.

These kinds of features have become possible due to the synergy between system components. There's much more coming.

GitLab Direction

Please don't be surprised once a crashed build creates a TODO automatically or GitLab introduces built-in chat.

If you want to know where GitLab is heading, keep an eye on the Direction page. This includes not only the short term objectives for the next release, but also the long-range vision.

Hopefully, this article has helped you to fill in the gaps in understanding what GitLab is now. I'm planning to write two more articles: about migrating personal projects to GitLab and about contributing to GitLab. Stay tuned and follow me on Twitter.

I'm always happy to answer your questions in comments or personally. Over the next several weeks I will be speaking at the following Ukrainian Ruby-meetups, where we can catch up:

Join our webcast about GitLab CI.

I mentioned Gitlab CI a few times in this blog post. If you're interested, we'll have a live webcast all about GitLab CI.

Can't make these times? Register anyway, and we'll send you a link to watch later. [webcast]:

Install GitLab on your own server in 2 minutes

Browse all posts

For the latest and most detailed news follow @gitlab on Twitter. Future blog posts suggestions.