Jak zainstalować i skonfigurować GitLab na Ubuntu

GitLab to kompleksowa platforma DevOps, która oferuje szeroki wachlarz narzędzi, w tym repozytoria kodu źródłowego, system śledzenia błędów, mechanizmy CI/CD oraz wiele innych. Instalacja i konfiguracja GitLab na serwerze z systemem Ubuntu jest procesem stosunkowo prostym, który można zrealizować w kilku etapach.

W niniejszym artykule szczegółowo omówimy proces instalacji i konfiguracji GitLab na serwerze Ubuntu, krok po kroku. Przeanalizujemy również kluczowe aspekty konfiguracji, które pozwolą na dostosowanie środowiska GitLab do indywidualnych potrzeb.

Niezbędne Wymagania

Przed przystąpieniem do instalacji, upewnij się, że Twój serwer Ubuntu spełnia poniższe minimalne wymagania:

  • System Ubuntu w wersji 18.04 lub nowszej
  • Konto użytkownika z uprawnieniami administratora (sudo)
  • Co najmniej 2 GB pamięci operacyjnej RAM
  • Minimum 10 GB wolnej przestrzeni dyskowej

Etap 1: Dodanie Repozytorium GitLab

Pierwszym krokiem jest dodanie oficjalnego repozytorium GitLab do listy repozytoriów Twojego systemu. Możesz to zrobić, wykonując poniższe polecenia w terminalu:


sudo apt update
sudo apt install curl
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Etap 2: Instalacja GitLab

Po pomyślnym dodaniu repozytorium GitLab, możesz przejść do instalacji samego oprogramowania, korzystając z poniższej komendy:


sudo apt update
sudo apt install gitlab-ce

Proces instalacji może zająć kilka minut. Po zakończeniu GitLab będzie automatycznie uruchomiony i dostępny pod adresem http://localhost.

Etap 3: Konfiguracja GitLab

Po zainstalowaniu GitLab, konieczna jest jego konfiguracja w celu dostosowania do Twoich potrzeb. Główny plik konfiguracyjny znajduje się w lokalizacji /etc/gitlab/gitlab.rb. Otwórz go w edytorze tekstu.

Najistotniejsze opcje, które należy skonfigurować, to:

  • external_url: Adres URL, pod którym Twój GitLab będzie publicznie dostępny.
  • gitlab_rails['db_host']: Nazwa hosta lub adres IP serwera bazy danych.
  • gitlab_rails['db_username']: Nazwa użytkownika bazy danych.
  • gitlab_rails['db_password']: Hasło użytkownika bazy danych.
  • gitlab_rails['db_database']: Nazwa bazy danych.

Po dokonaniu niezbędnych zmian, zapisz plik konfiguracyjny i przeładuj konfigurację GitLab, wykonując następujące polecenie:


sudo gitlab-ctl reconfigure

Etap 4: Utworzenie Pierwszego Konta Użytkownika

Po skonfigurowaniu GitLab, należy utworzyć pierwsze konto administratora. Można to zrobić, wykonując następujące polecenie w terminalu:


sudo gitlab-rails runner "User.create!(email: 'uzytkownik@twojadomena.com', password: 'TwojeHaslo', name: 'TwojeImie', username: 'uzytkownik')"

Pamiętaj, aby zastąpić uzytkownik@twojadomena.com swoim adresem email, TwojeHaslo wybranym hasłem, TwojeImie Twoim imieniem i uzytkownik wybraną nazwą użytkownika.

Etap 5: Dostęp do Interfejsu Webowego

Po utworzeniu konta administratora możesz uzyskać dostęp do interfejsu webowego GitLab, wpisując w przeglądarce adres URL http://localhost (lub skonfigurowany w kroku 3 adres). Zaloguj się, używając utworzonych wcześniej danych uwierzytelniających.

Zaawansowane Ustawienia Konfiguracyjne

Oprócz podstawowych ustawień, istnieje szereg opcjonalnych konfiguracji, które pozwalają na jeszcze większe dostosowanie instalacji GitLab do Twoich potrzeb. Poniżej przedstawiamy kilka z nich:

Włączenie Protokółu HTTPS

Aby zabezpieczyć komunikację z Twoim GitLab przy użyciu protokołu HTTPS, należy zainstalować certyfikat SSL. Możesz to zrobić za pomocą następujących komend:


sudo apt install certbot
sudo certbot --nginx

Następnie, otwórz plik /etc/gitlab/gitlab.rb, odszukaj opcję gitlab_rails['https'] i ustaw jej wartość na true. Po wprowadzeniu zmian, zrestartuj GitLab:


sudo gitlab-ctl reconfigure

Konfiguracja Własnej Domeny

Jeżeli chcesz używać własnej domeny zamiast adresu IP, musisz odpowiednio skonfigurować rekord A lub CNAME dla swojej domeny. Następnie zmień wartość opcji external_url w pliku /etc/gitlab/gitlab.rb, ustawiając ją na adres Twojej domeny. Na koniec, przeładuj konfigurację GitLab:


sudo gitlab-ctl reconfigure

Integracja z Usługami Zewnętrznymi

GitLab umożliwia integrację z wieloma popularnymi usługami, takimi jak Jira, Slack czy Jenkins. Konfigurację integracji znajdziesz w panelu administracyjnym GitLab, w sekcji „Integracje”.

Podsumowanie

Instalacja i konfiguracja GitLab na serwerze Ubuntu nie jest skomplikowana i może być wykonana w kilku prostych krokach. Postępując zgodnie z powyższymi instrukcjami, możesz w krótkim czasie uruchomić własne środowisko GitLab.

Mamy nadzieję, że ten artykuł był dla Ciebie pomocny. Jeśli masz jakiekolwiek pytania, śmiało zadaj je w sekcji komentarzy poniżej.

Najczęściej Zadawane Pytania (FAQ)

1. Czym różni się GitLab CE od GitLab EE?

GitLab CE (Community Edition) jest wersją open-source, darmową, natomiast GitLab EE (Enterprise Edition) jest wersją komercyjną, oferującą dodatkowe funkcje.

2. Czy GitLab można zainstalować na innych dystrybucjach Linux?

Tak, GitLab może być zainstalowany na wielu dystrybucjach Linux, takich jak CentOS, Debian i Fedora.

3. Jak zaktualizować GitLab?

Aby zaktualizować GitLab, wykonaj następujące polecenia w terminalu:


sudo apt update
sudo apt upgrade

4. Jak zmienić hasło użytkownika GitLab?

Zaloguj się do interfejsu webowego GitLab, kliknij w ikonę użytkownika w prawym górnym rogu i wybierz „Profil”. W zakładce „Hasło” możesz wprowadzić nowe hasło.

5. Jak dodawać nowych użytkowników?

W panelu administracyjnym, w zakładce „Użytkownicy”, znajduje się przycisk „Dodaj użytkownika”, który pozwala na dodawanie nowych kont.

6. Jak utworzyć nowy projekt?

W panelu interfejsu webowego GitLab, kliknij „Projekty” na pasku bocznym, a następnie wybierz „Nowy projekt”.

7. Jak skonfigurować integrację z usługą zewnętrzną?

W panelu interfejsu webowego GitLab, kliknij „Integracje” na pasku bocznym i wybierz usługę, z którą chcesz się zintegrować.

8. Gdzie szukać pomocy?

Pomoc techniczną i dokumentację znajdziesz na oficjalnej stronie GitLab, a także w społeczności GitLab na forach i kanałach czatu.


newsblog.pl