Aggiornare GitLab in modo corretto

L’aggiornamento di GitLab è solitamente tutto automatizzato, ma questo se viene fatto periodicamente, in modo da aggiornare man mano alle nuove relese.

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!

Ti interessa acquistare un dominio a prezzi ultraconvenienti? clicca qui

Se hai trovato utili le informazioni su questo blog,
Fai una donazione!
Clicca sul bottone qui sotto o almeno clicca sul banner pubblicitario 🙂