Com instal·lar i configurar GitLab a Ubuntu 18.04

GitLab CE és un gestor de repositoris de Git gratuït i de codi obert escrit en Ruby. Proporciona una interfície basada en el web per a la gestió d'incidències, la revisió de codi, la supervisió, la integració i el desplegament continus. És molt similar a GitHub i et permet allotjar el teu propi magatzem intern de repositoris per al teu equip de desenvolupament.

GitLab et dona control total sobre els teus repositoris. Si el que busques és allotjar i administrar repositoris git en un servidor centralitzat, GitLab és la millor opció per a tu.

En aquest tutorial, aprendràs a instal·lar i configurar GitLab CE en un servidor cloud que funciona amb Ubuntu 18.04.

Requisits

• Un servidor vps cloud a Espanya que funcioni amb Ubuntu 18.04.
• Uns recursos mínims de 4 GB RAM i 2 vCores de CPU.
• Una contrasenya root configurada.

Comencem

Abans de començar, et recomanem que actualitzis el repositori de paquets del sistema a l'última versió. Pots fer l'actualització amb l'ordre següent:

# apt-get update && apt-get upgrade -y

Un cop el sistema estigui actualitzat, caldrà que hi instal·lis algunes dependències. Pots fer-ho amb l'ordre següent:

# apt-get install ca-certificates curl openssh-server postfix -y

Durant la instal·lació, se't preguntarà el tipus de configuració del servidor de correu. Selecciona ‘Internet Site’ i fes clic a ‘OK’.

A continuació, et demanarà que proporcionis el nom del sistema de correu. Proporciona el nom adequat per a la configuració del teu servidor i fes clic a ‘Ok’ per finalitzar la instal·lació.

Instal·la GitLab

Per defecte, GitLab no està disponible al repositori per defecte d'Ubuntu 18.04. Per això, hauràs d'afegir el repositori de GitLab al teu sistema.

Pots afegir el repositori amb l'ordre següent:

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

Un cop s'hagi afegit el repositori, hauries de veure el resultat següent:

  Running apt-get update... done.
  Installing apt-transport-https... done.
  Installing /etc/apt/sources.list.d/gitlab_gitlab-ce.list...done.
  Importing packagecloud gpg key... done.
  Running apt-get update... done.
  ¡El repositorio ya está incorporado! Ahora ya puedes instalar los paquetes.

A continuació, instal·la GitLab CE amb l'ordre següent:

# apt-get install gitlab-ce -y

Un cop la instal·lació s'hagi completat correctament, hauries de veure el resultat següent:

It looks like GitLab has not been configured yet; skipping the upgrade script.

       *.                  *.
      ***                 ***
     *****               *****
    .******             *******
    ********            ********
   ,,,,,,,,,***********,,,,,,,,,
  ,,,,,,,,,,,*********,,,,,,,,,,,
  .,,,,,,,,,,,*******,,,,,,,,,,,,
      ,,,,,,,,,*****,,,,,,,,,.
         ,,,,,,,****,,,,,,
            .,,,***,,,,
                ,*,.
  


     _______ __  __          __
    / ____(_) /_/ /   ____ _/ /_
   / / __/ / __/ /   / __ `/ __ \
  / /_/ / / /_/ /___/ /_/ / /_/ /
  \____/_/\__/_____/\__,_/_.___/
  

Thank you for installing GitLab!
GitLab was unable to detect a valid hostname for your instance.
Please configure a URL for your GitLab instance by setting `external_url`
configuration in /etc/gitlab/gitlab.rb file.
Then, you can start your GitLab instance by running the following command:
  sudo gitlab-ctl reconfigure

For a comprehensive list of configuration options please see the Omnibus GitLab readme
https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md

Configura GitLab

A continuació, caldrà que configuris GitLab amb el teu nom de domini. Pots editar el fitxer de configuració de GitLab tal com es mostra més avall:

# nano /etc/gitlab/gitlab.rb

Canvia la línia següent pel teu nom de domini:

# external_url ‘http://gitlab.example.com’

Desa i tanca el fitxer. Després, executa l'ordre següent per reconfigurar GitLab:

# gitlab-ctl reconfigure

Hauries d'obtenir el resultat següent:

Recipe: 
 * service[unicorn] action restart
 - restart service service[unicorn]
 * service[sidekiq] action restart
 - restart service service[sidekiq]
Recipe: gitlab::gitlab-rails
 * execute[clear the gitlab-rails cache] action run
 - execute /opt/gitlab/bin/gitlab-rake cache:clear
Recipe: 
 * service[nginx] action restart
 - restart service service[nginx]
 * service[grafana] action restart
 - restart service service[grafana]

Running handlers:
Running handlers complete
Chef Client finished, 12/699 resources updated in 31 seconds
gitlab Reconfigured!

Accedeix a GitLab

Ara GitLab ja està instal·lat i configurat. És hora d'accedir a la interfície web de GitLab.

Obre el navegador web i escriu l'URL http://gitlab.example.com. Se't redirigirà a la pàgina següent:

A continuació, escriu la contrasenya que vulguis per a l'usuari root de GitLab i fes clic al botó “Cambiar tu contraseña”. Hauries de veure el resultat següent:

A continuació, proporciona el teu nom d'usuari i fes clic al botó “Registro”. Hauries de veure el tauler de control de GitLab per defecte a la pàgina següent:

Ara, fes clic al botó “Crear un proyecto” per crear el teu primer projecte. Hauries de veure la pàgina següent:

Proporciona tota la informació requerida i fes clic al botó “Crear proyecto”. Hauries de veure la pàgina següent:

 Prova GitLab

Primer, inicia sessió en un altre sistema i estableix el nom d'usuari global i el correu electrònic per a Git amb l'ordre següent:

# git config --global user.name "root"
# git config --global user.email "admin@gitlab.example.com"

A continuació, clona el teu repositori amb l'ordre següent:

# git clone http://gitlab.example.com/root/project1.git

Hauries de veure el resultat següent:

Cloning into 'project1'...
Username for 'http://gitlab.example.com': root
Password for 'http://root@gitlab.example.com': 
warning: You appear to have cloned an empty repository.
Checking connectivity... done.

Ara canvia el directori a proyecto1 i crea el fitxer nou README.md:

# cd project1
# touch README.md

Després, destina un fitxer nou al directori proyecto1:

# git add README.md
# git commit -m "add README"

Hauries de veure el resultat següent:

[master (root-commit) 7bf8685] add README
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 README.md

Finalment, puja els resultats al teu servidor de repositoris GitLab:

# git push -u origin master

Proporciona el teu nom d'usuari de GitLab, la contrasenya i fes clic a “Enter” per continuar. Hauries de veure el resultat següent:

Username for 'http://gitlab.example.com': root
Password for 'http://root@gitlab.example.com': 
Counting objects: 3, done.
Writing objects: 100% (3/3), 210 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To http://gitlab.example.com/root/project1.git
 * [new branch] master -> master
Branch master set up to track remote branch master from origin.

Ara accedeix a la interfície web del teu servidor GitLab i fes clic a proyecto1. Hauries de veure que el fitxer README.md s'ha afegit al repositori:

Felicitats! Has instal·lat i configurat correctament GitLab CE al teu servidor cloud que funciona amb Ubuntu 18.04. Ara ja pots crear un altre projecte i configurar el nivell d'accés adequat per al teu equip de desenvolupament.