WARNING: database "gitlabhq_production" has a collation version mismatch
DETAIL: The database was created using collation version 2.36, but the operating system provides version 2.41.
HINT: Rebuild all objects in this database that use the default collation and run ALTER DATABASE gitlabhq_production REFRESH COLLATION VERSION, or build PostgreSQL with the right library version.

Significa che è necessario ricostruire gli indici del database postgreSQL. Vediamo in sequenza la procedura da fare:

Effettua prima un backup di sicurezza:

gitlab-backup create

Fermiamo gitlab:

gitlab-ctl stop

Avviamo solo postgreSQL:

gitlab-ctl start postgresql

Accediamo ora a postgreSQL per eseguire le query che ci interessano:

gitlab-psql -d gitlabhq_production

E qui digitiamo:

SET statement_timeout = 0; REINDEX DATABASE gitlabhq_production;

A seguire:

ALTER DATABASE gitlabhq_production REFRESH COLLATION VERSION;

Ed infine usciamo con:

\q

Riavviamo ora gitlab:

gitlab-ctl start

Verifichiamo che tutti i servizi siano UP:

gitlab-ctl status

e ricontrolliamo che non ci siano più messaggi di warning:

gitlab-rake gitlab:env:info

enjoy!

Per l’isntallazione bastano pochi comandi:

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | bash
apt-get install -y gitlab-runner

Poi accediamo all’interfaccia web di GitLab, andiamo nel progetto che ci interessa, poi “Settings” e “CI/CD“. Qui apriamo la sezione “Runners” e clicchiamo sul pulsante “Create project runner“. La procedura mostrerà un comando da scrivere nel terminale per agganciare il runner del progetto, in particolare c’è una chiave che serve per abilitare il runner. Recuperiamo la chiave e poi digitiamo:

sudo gitlab-runner register \
  --non-interactive \
  --url "SITE_URL" \
  --token "RUNNER_TOKEN" \
  --executor "docker" \
  --docker-image alpine:latest \
  --docker-pull-policy "if-not-present" \
  --description "docker-runner"

sostituendo SITE_URL con l’url del sito dove avete installato GitLab e RUNNER_TOKEN con il token recuperato nella procedura “Create project runner” avviata prima.

enjoy!

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "INDIRIZZO_SERVER_MAIL"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "USERNAME"
gitlab_rails['smtp_password'] = "PASSWORD"
#gitlab_rails['smtp_domain'] = "NON_CONFIGURARE"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false

e sempre nello stesso file, nella sezione “Email Settings“:

gitlab_rails['gitlab_email_enabled'] = true
gitlab_rails['gitlab_email_from'] = 'git@DOMINIO_MITTENTE'
gitlab_rails['gitlab_email_display_name'] = 'GIT Server'
gitlab_rails['gitlab_email_reply_to'] = 'git@DOMINIO_MITTENTE'

Ora riconfiguriamo il servizio:

gitlab-ctl reconfigure

Infine, provamo l’invio. Avviamo la console:

gitlab-rails console

ed aspettiamo che ci venga restituito il prompt, poi inseriamo la richiesta di invio email:

Notify.test_email('INDIRIZZO_TEST@gmail.com', 'Message Subject', 'Message Body').deliver_now

se tutto ok vi arriverà l’email, altrimenti potrete vedere i messaggi di errore

enjoy!

Vecchie versioni di GitLab consentono di fare una serie di cose senza autorizzazioni, pertanto aggiornate quanto prima se non lo avete fatto.

Qualora il load del server sia stranamente alto, bisogna investigare. Innanzitutto con il comando top cerchiamo di capire se c’è un processo in particolare che richiede troppa cpu. Spesso si tratta di kthreaddk. In questo caso:

• Fermiamo GitLab: gitlab-ctl stop
• Terminiamo il processo sospetto: pkill kthreaddk
• Verifica se ci sono altri processi con utente git (significa che non solo effettivamente legati a gitlab): top -u git
• Cancelliamo tutto il contenuto di /tmp/.git: rm -fr /tmp/.git
• Cancelliamo file di cron di git (non devono esserci): crontab -u git -r
• Controllare se ci sono entry strane (ovvero che non iniziano per command="…. no-pty) in /var/opt/gitlab/.ssh/authorized_keys
• Riavviare GitLab: gitlab-ctl start
• Cancellare gli utenti che non abbiamo creato noi manualmente.

enjoy!

Se si sono saltati un po’ di aggiornamenti e ci sono nuove major-release, è necessario prestare attenzione a non fare il passaggio direttamente dalla versione attuale, ma seguire lo schema di aggiornamento pubblicato qui da GitLab.

Ad esempio, se abbiamo attiva la versione 13.9.2 e vogliamo passare alla 14.1.6, dovremo fare questi aggiornamenti intermedi: 13.9.2 -> 13.12.12 -> 14.0.11 -> 14.1.6.

Importante seguire attentamente queste indicazioni, perché altrimenti rischiate di portare GitLab ad una situazione inconsistente e non riuscire più a riavviarlo.

Qualora sia necessario effettuare un backup, si può procedere con:

gitlab-rake gitlab:backup:create

e poi verificare il backup in var/opt/gitlab/backups/XXXXXXXXX_gitlab_backup.tar. Il backup potrà poi essere ripristinato con:

gitlab-rake gitlab:backup:restore BACKUP=XXXXXXXXX

Innanzitutto consiglio di eseguire la procedura di attivazione del corretto repository in APT:

curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | bash

Per vedere l’attuale versione di GitLab possiamo digitare:

grep gitlab /opt/gitlab/version-manifest.txt

oppure:

cat /opt/gitlab/embedded/service/gitlab-rails/VERSION

Controllare se si ha gitlab-ce oppure gitlab-ee e poi per aggiornare, ad esempio, gitlab-ce alla versione 13.12.12, possiamo digitare:

apt install gitlab-ce=13.12.12-ce.0

e così via…

All’indirizzo https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/ c’è un semplice tool dove indicare la versione attuale, la versione a cui si vuole aggiornare e verranno mostrati i vari comani da digitare per i vari sistemi operativi.

Qualora fosse necessario riconfigurare GitLab a termine dell’upgrade, faremo:

gitlab-ctl reconfigure

In caso di errori relativi a migrations non completate, consiglio:

sudo gitlab-rake db:migrate 

Che dovrebbe mostrare maggiori dettagli per capire cosa accade. Questo comando mostra una serie di informazioni e poi un Finalize it manualy by running seguito dal comando da eseguire a mano. Solitamente eseguendo questo comando, torna tutto a posto e si può ripetere il gitlab-ctl reconfigure per verificare.

Per verificare lo stato di configurazione di GitLab possiamo usare:

gitlab-ctl status
gitlab-rake gitlab:check SANITIZE=true

enjoy!

Iniziamo ad installare dei pacchetti che possono servire in seguito:
apt-get -y install curl openssh-server ca-certificates postfix

Alla domanda su come configurare postfix, scegliere “Internet site” e poi indicare l’hostname del server.

Scarichiamo ed installiamo gitlab:
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | bash

apt-get -y install gitlab-ce

Ora passiamo alla configurazione:
gitlab-ctl reconfigure

Per l’installazione completa di git e gitlab, consiglio di seguire questa guida.

enjoy!