From Gentoo Wiki
Jump to:navigation Jump to:search


Gitlab is currently deployed in a testing capacity on and is not yet publicly available.

Gitlab for users

Gitlab Authentication

Currently only "Gentoo SSO" is supported. This means only developers can login at this time. We expect to add other omniauth login sources later (google, github, gitlab, etc.)


Gitlab backups are taken nightly.


The current pace by gitlab upstream is 1 minor release per month. We try stay within 3 minor releases of :latest.

SSH Keys

Currently we do not synchronize SSH keys with any identity platform, but we likely need to add syncing of ssh keys from LDAP.


We currently do not synchronize any group data from anywhere. Again this is an open item we need to address before going public.


The physical machine hosting gitlab has 2 IPs (both on v4 and v6.) sshing to will try to connect to the specific IP for gitlab and you will be connected to gitlab's ssh.

Gitlab's ssh uses its own set of host keys and wrappers like a normal gitlab.

Gitlab for Infrastructure

Gitlab is configured a bit by puppet (see dist/gitlab) and a bit by hand.

We use the omnibus containers to deploy gitlab. The gitlab config is at /etc/gitlab/docker-compose.yml.

Starting gitlab

cd /etc/gitlab/ docker-compose up -d

Stopping gitlab

cd /etc/gitlab docker-compose down

Upgrading gitlab

We need to upgrade about every 2-4 weeks to stay up to date with gitlab development. Upgrades cause downtime, but its typically brief (15-20 minutes.) Announce it in #gentoo-dev beforehand, then:

  1. Head to the admin area to see what version we are on:
  2. Then head to the gitlab docker repo to see what version are available:
  3. Don't jump more than 1 minor version at a time (minor versions are the second version component.)

The docker image is 'gitlab/gitlab-ce:<VERSION>' (so for example: 'gitlab/gitlab-ce:14.10.0-ce.0') You can see an example tag in dist/gitlab/manifests/server.pp. Construct the new docker tag based on the next version of gitlab we need.

For example, if we want to upgrade to 14.3.2; the image would be: 'gitlab/gitlab-ce:14.3.2-ce.0') Verify this on the dockerhub!

  1. ssh
  2. sudo -i
  3. cd /etc/gitlab
  4. docker image pull <IMAGE_NAME> # we determined this earlier!
  5. Then edit puppet's dist/gitlab/manifests/server.pp, change to the new image!
  6. commit your changes, push them, then wait 30 minutes OR
  7. run puppet agent --no-daemonize --verbose on towhee; and it should take the update.
  8. This start may take 15-20 minutes (to run the upgrade.)

SSHing into the gitlab host for infra

Currently gitlab runs on towhee, you need to 'ssh' to get to the host; sshing into '' will ssh into the gitlab container, which you do not want.

What about Gitolite?

Currently we plan to keep gentoo repos mastered in gitolite. We can set up automatic pushes to gitlab in gitolite configs. We will consider migrating repos to gitlab in the future.

TODOs for gitlab setup

  • Add Icinga monitoring for https (done)
  • Add lines for gitlab.
  • Add ssh key sync
  • add group sync
  • add more admins to gitlab
  • add Gentoo org admins
  • add terraform for admnistration?