• Diff for "gitlab"

Gitlab is a git front end with repository management, graphs, links, goodies, commands to run, and review capabilities similar in feel to a self-hosted ?GitHub.

Debian is running its own Instance of GitLab under https://salsa.debian.org, which is not based on the packaged version.

Buster Fast Track (Recommended)

Gitlab 13.1.3 is available in unofficial fasttrack repo targeting buster as base distribution. (no open security issues).

Add to /etc/apt/sources.list

deb https://fasttrack.debian.net/debian/ buster-fasttrack main contrib
# For dependency packages not in testing only temporarily due to freeze, transitions or delayed by backports-new or NEW.
deb https://fasttrack.debian.net/debian/ buster-backports main contrib 
deb https://deb.debian.org/debian buster-backports contrib main
# To avoid some hours of delay between upload and availability in archive
deb http://incoming.debian.org/debian-buildd buildd-buster-backports main
# Eventually the packages in this repo will be moved to one of the previous two repos
deb https://people.debian.org/~praveen/gitaly buster-backports main

# apt update

You may encounter the following error message:

The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 0B76920762A6B785

If so, those commands can help:

# wget https://people.debian.org/~praveen/gitaly/praveen.key.new.asc
# wget http://fasttrack.debian.net/fasttrack-archive-key.asc
# apt-key add praveen.key.new.asc
# apt-key add fasttrack-archive-key.asc

Finally:

# apt -t buster-backports install gitlab

Note: https://gitlab.debian.net is running on this version.

Testing ruby 2.7 in fasttrack

Upstream no longer support ruby 2.5 and we already saw some bugs with ruby 2.5. So we are adding ruby 2.7 to buster-fasttrack and this will require rebuilding all native libraries with the new ruby version as well as updating any pure ruby libraries that does not support ruby 2.7 in buster/buster-backports.

Add https://people.debian.org/~praveen/fasttrack-staging/ and https://people.debian.org/~srud/fasttrack-staging/ repos with buster-fasttrack suite to /etc/apt/sources.list.

deb https://people.debian.org/~praveen/fasttrack-staging/ buster-fasttrack main
deb https://people.debian.org/~srud/fasttrack-staging/  buster-fasttrack main

wget https://people.debian.org/~srud/fasttrack-staging/srud.key.asc
apt-key add srud.key.asc 

Update pure ruby libraries for ruby 2.7 support,

apt -t buster-backports install ruby-babosa ruby-batch-loader ruby-declarative ruby-gettext ruby-json-schema ruby-premailer-rails ruby-recursive-open-struct ruby-tzinfo ruby-get-process-mem

Now update ruby to 2.7 and verify the list of packages marked for removal does not include gitlab or gitaly.

apt install ruby rubygems-integration

See https://git.fosscommunity.in/debian-ruby/TaskTracker/-/issues/166 for current status of rebuilds/testing.

Unstable (be careful when updating packages)

Gitlab 12.6.8 is available in unstable (many security issues), and installation is broken. Please use experimental.

We try to keep the version in unstable in a good shape with the latest security updates, but some times dependency updates break GitLab.

Experimental - During freeze and transitions

Gitlab 13.1.3 is available in experimental (no open security issues).

If you are using experimental for the first time, check DebianExperimental.

Some rails 6 transition is delaying upload to unstable.

Install some dependencies from experimental,

# apt install git 
# apt -t experimental install ruby-rails
# apt install ruby-aws-sdk/experimental ruby-rails-i18n/experimental
# apt install ruby-gitaly/experimental  gitaly/experimental gitlab-common/experimental

Now install gitlab from experimental,

# apt install gitlab/experimental

Gitlab on Stretch

This is moved to gitlab/stretch now.

Gitlab with apache2

Gitlab can use apache instead of nginx. To get a working configuration for your version the best thing to do is to follow the (gitlab-recipes repository) instructions.

Basically you will have to : Disable nginx Set www-data as web server user. Allow Modules dependencies # mod_rewrite # mod_ssl # mod_proxy # mod_proxy_http # mod_headers

a2enmod rewrite proxy_http headers

and as says in recipe

Allow gitlab-workhorse to listen on port 8181, edit or create /etc/default/gitlab and change or add the following:

 gitlab_workhorse_options="-listenUmask 0 -listenNetwork tcp -listenAddr 127.0.0.1:8181 -authBackend http://127.0.0.1:8080"

Gitlab Common Errors

If you have this kind of error

  Cloning into'public-test-project-ssh'...
  Received disconnect from YOUR_SERVER_IP port 22:2: Too many authentication failures
  Disconnected from YOUR_SERVER_IP port 22
  fatal: Can't read distant repository.

on an ssh clone

  git clone gitlab@ssh.your-gitlab-instance.org:public-test-group/public-test-project.git public-test-project-ssh

To be sure you should find a line like the following in /var/log/auth.log

User gitlab from YOUR_CLIENT_IP not allowed because not listed in AllowUsers

You may have to allow gitlab user in /etc/ssh/sshd_config

AllowUsers user1 user2 gitlab
AllowGroups user1 group2 gitlab

Do not forget to restart the service

service ssh restart

Debug installation and configuration

Gitlab is composed of several parts. As always logs (/var/log/gitlab), debian specific documentation (/usr/share/doc/gitlab/) and (official) documentation provide lots of information.

gitlab-rake is convenience script to easily run rake commands provided by gitlab in debian environment.

# gitlab-rake gitlab:check
# gitlab-rake gitlab:env:info

gitlab-rails-console is another convenience script to launch a rails console in gitlab debian environment.

# gitlab-rails-console

Just make sure you don't have any gems installed from rubygems.org conflicting with debian packaged versions of the gems required by gitlab. /var/lib/gems/<ruby_version> (/var/lib/gems/2.5.0 or /var/lib/gems/2.7.0) should not have any gems.

rake aborted errors during installation

If your update failed for some reason (usually when dependencies are not satisfied for bundle install --local), and you retry installation after fixing dependencies, you may see errors like

rake aborted!
NameError: uninitialized constant Gitlab::Patch::ActiveRecordQueryCache
/usr/share/gitlab/config/initializers/active_record_query_cache.rb:3:in `<top (required)>'

You will have to manually remove problem creating initializers from /etc/gitlab/initializers. A list of such initializers can be found from gitlab source package or from https://salsa.debian.org/ruby-team/gitlab in debian/maintscript file. All lines starting with rm_conffile and corresponding versions are what you need to check.

Contact maintainers

You can reach the maintainers of the gitlab package via

1. Matrix at #debian-gitlab:poddery.com (join via browser)

2. IRC #debian-gitlab on OFTC network (join via browser)

Maintainer's corner

1. Installing gitlab on an lxc container to test - See gitlab/lxc

2. Updating gitlab package to newer versions - See Teams/Ruby/Packaging/newUpstreamRailsApp

3. Backport/Fasttrack checklist - See gitlab/BackportChecklist

4. Dependencies Transitions checklist - See gitlab/DependenciesTransitions

5. Managing Components - See gitlab/ManagingComponents

6. Plan to move gitlab-common binary to gitlab-shell source package - See ?gitlab/gitlab-common-to-gitlab-shell-plan

TODO

1. Aim to get gitlab back in main by bullseye release by packaging all node dependencies. current status This is now an Outreachy project (from December 2019 to March 2020).

2. Get autopkgtest working so we can detect problems when someone updates dependencies without coordinating with us.

Omnibus Packages

Note: this section is about the installation of upstream-provided unofficial packages.

Install

all actions are performed under the root user, in ~ unless otherwise noted.

Step 1

navigate to https://about.gitlab.com/install/ and copy down the link to the Debian deb package.

as of this writing @ June 5, 2014

run

• wget https://downloads-packages.s3.amazonaws.com/debian-7.4/gitlab_6.9.2-omnibus-1_amd64.deb

Step 2

run

• dpkg -i gitlab*

Step 3

i got errors 1st time around 2nd time around gitlab looked like it set everything and ran well.

To avoid errors, execute /opt/gitlab/embedded/bin/runsvdir-start for one minute, more or less (tested in 7.9.0 and 7.9.1 omnibus versions).

run

• gitlab-ctl reconfigure

to verify that things are running

run

• gitlab-ctl status

Step 4

navigate to your servers IP address or domain name, and login as:

user: root password: 5iveL!fe

External Resources

https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md