gitlab-org--gitlab-foss/docker
2014-12-04 12:29:30 +01:00
..
Dockerfile Fix spelling error in dockerfile, thanks Vincent for noting it. 2014-12-04 12:29:30 +01:00
gitlab.rb Move commands to the readme, rename gitlab to gitlab_app, add PostgreSQL tweaks to gitlab.rb. 2014-12-03 12:41:47 +01:00
README.md Reword configuration to recommend an interactive command line 2014-12-04 10:38:35 +01:00
troubleshooting.md Move commands to the readme, rename gitlab to gitlab_app, add PostgreSQL tweaks to gitlab.rb. 2014-12-03 12:41:47 +01:00

What is GitLab?

GitLab offers git repository management, code reviews, issue tracking, activity feeds, wikis. It has LDAP/AD integration, handles 25,000 users on a single server but can also run on a highly available active/active cluster. A subscription gives you access to our support team and to GitLab Enterprise Edition that contains extra features aimed at larger organizations.

https://about.gitlab.com

GitLab Logo

How to use this image

At this moment GitLab doesn't have official Docker images. Build your own based on the Omnibus packages with the following command (it assumes you're in the GitLab repo root directory):

sudo docker build --tag gitlab_image docker/

We assume using a data volume container, this will simplify migrations and backups. This empty container will exist to persist as volumes the 3 directories used by GitLab, so remember not to delete it.

The directories on data container are:

  • /var/opt/gitlab for application data
  • /var/log/gitlab for logs
  • /etc/gitlab for configuration

Create the data container with:

sudo docker run --name gitlab_data gitlab_image /bin/true

After creating this run GitLab:

sudo docker run --detach --name gitlab_app --publish 8080:80 --publish 2222:22 --volumes-from gitlab_data gitlab_image

It might take a while before the docker container is responding to queries. You can follow the configuration process with docker logs -f gitlab.

You can then go to http://localhost:8080/ (or http://192.168.59.103:8080/ if you use boot2docker). You can login with username root and password 5iveL!fe. Next time, you can just use sudo docker start gitlab_app and sudo docker stop gitlab_app.

How to configure GitLab

This container uses the official Omnibus GitLab distribution, so all configuration is done in the unique configuration file /etc/gitlab/gitlab.rb.

To access GitLab configuration, you can start an interactive command line in a new container using the shared data volume container, you will be able to browse the 3 directories and use your favorite text editor:

docker run -ti -e TERM=linux --rm --volumes-from gitlab_data ubuntu 
vi /etc/gitlab/gitlab.rb

Note that GitLab will reconfigure itself at each container start. You will need to restart the container to reconfigure your GitLab.

You can find all available options in Omnibus GitLab documentation.

Troubleshooting

Please see the troubleshooting file in this directory.