Instalacja i konfiguracja gitlab na Ubuntu 18.04

Od jednego z klientów otrzymałem zlecenie na instalacje i konfigurację Gitlab na serwerze VPS opartym na systemie Ubuntu 18.04.
Ponieważ poprzedni wpis był bardzo skromny, opierał się na systemie Debian 7 i zawierał sam opis instalacji postanowiłem go znacznie rozwinąć

Wprowadzenie

GitLab CE lub Community Edition to aplikacja typu open source używana głównie do hostowania repozytoriów Git z dodatkowymi funkcjami związanymi z programowaniem, takimi jak śledzenie problemów. Został zaprojektowany do hostowania przy użyciu własnej infrastruktury i zapewnia elastyczność w zakresie wdrażania jako wewnętrzny magazyn repozytoriów dla zespołu programistów, jako sposób na komunikację z użytkownikami, a nawet jako sposób na udostępnianie własnych projektów.

Projekt GitLab sprawia, że ​​stosunkowo proste jest skonfigurowanie instancji GitLab na własnym sprzęcie za pomocą łatwego mechanizmu instalacji. W tym przewodniku omówię, jak zainstalować i skonfigurować GitLab na serwerze Ubuntu 18.04.

Wymagania wstępne

Aby cokolwiek zrobić potrzebujesz oczywiście serwera VPS – minimalne zalecane parametry to 2 rdzenie CPU i 4 GB RAM.
W poradniku będę korzystał z konta root-a, jednak polecam utworzenie użytkownika, dodanie mu uprawnień i korzystanie z sudo.

Instalowanie zależności
Zanim będziemy mogli zainstalować samą GitLab, musimy zainstalować zależności – dostępne są one w standardowym repozytorium Ubuntu.

Aktualizujemy więc pakiety i i instalujemy zależności:

Postfixa użyjemy do wysyłania powiadomień systemowych – jeśli masz zainstalowany inny serwer mailowy, bądź chcesz skorzystać z zewnętrznego serwera poczty to nie musisz go instalować.

Instalowanie GitLab

Pobieramy skrypt instalacyjny do katalogu /tmp i instalujemy Gitlaba (polecam spojrzeć w zawartość pliku by wiedzieć co on dokładnie robi):

Skrypt skonfiguruje serwer do korzystania z utrzymanych repozytoriów GitLab. Pozwala to zarządzać GitLab przy użyciu tych samych narzędzi do zarządzania pakietami, które są używane w innych pakietach systemowych. Po zakończeniu można zainstalować rzeczywistą aplikację GitLab z apt:

 

Spowoduje to zainstalowanie niezbędnych składników w systemie.

Edytowanie pliku konfiguracyjnego GitLab

Przed użyciem aplikacji należy zaktualizować jeden plik konfiguracyjny i uruchomić polecenie rekonfiguracji.
Najpierw otwórz plik konfiguracyjny Gitlaba:

U góry jest external_url – zaktualizuj go, aby pasował do Twojej domeny lub adresu IP:

Teraz uruchom następujące polecenie, aby ponownie skonfigurować Gitlab:

Spowoduje to zainicjowanie GitLab przy użyciu informacji o serwerze. Jest to całkowicie zautomatyzowany proces, więc nie będziesz musiał odpowiadać na żadne pytania.

Przeprowadzanie wstępnej konfiguracji za pośrednictwem interfejsu internetowego

Teraz, gdy GitLab jest uruchomiony, możemy przeprowadzić wstępną konfigurację aplikacji za pośrednictwem przeglądarki.

Pierwsze logowanie
Odwiedź domenę swojego serwera GitLab w przeglądarce:

http://IP_SERWERA

Podczas pierwszej wizyty powinieneś zobaczyć prośbę o ustawienie hasła do konta administracyjnego:

W pierwszym pytaniu o hasło podaj i potwierdź bezpieczne hasło do konta administratora. Po zakończeniu kliknij przycisk “Change your password” .

Nastąpi przekierowanie na tradycyjną stronę logowania GitLab:

Tutaj możesz zalogować się za pomocą właśnie ustawionego hasła. Dane to:

Nazwa użytkownika: root
Hasło: [ustawione hasło]
Wprowadź te wartości  i kliknij przycisk Zaloguj się . Zostaniesz zalogowany do aplikacji i przeniesiony na stronę docelową, która poprosi Cię o rozpoczęcie dodawania projektów:

 

Zadania poinstalacyjne

Po poprawnym zainstalowaniu warto “przeklikać” sobie cały panel i pozmieniać niektóre opcje na bardziej optymalne.
Poniżej przedstawiam tylko kilka z nich:

Nazwa i adres e-mail

Kliknij ikonę użytkownika w prawym górnym rogu interfejsu. Z menu rozwijanego, które się pojawi, wybierz Settings  – zostaniesz przeniesiony do sekcji Profil w swoich ustawieniach:

Zmień pole Name i E-mail na twoją nazwę oraz adres e-mail.
Wybrana nazwa będzie wyświetlana innym użytkownikom, a wiadomość e-mail będzie używana do domyślnego wykrywania awatarów, powiadomień, akcji Git za pośrednictwem interfejsu itp.

Zmiana nazwy swojego konta

W drugiej zakładce po lewej stronie wybieramy zakładkę “Account” i w opcji “Change username” zmieniamy nazwę root na inną, mniej “uniwersalną” i trudniejszą do odgadnięcia.

Klucz SSH

Kolejną wartą do skonfigurowania opcją jest dodanie swojego klucza SSH – zrobisz to w opcji “ssh keys”

Ograniczanie lub wyłączanie rejestracji 

Być może zauważyłeś, że każdy, kto odwiedza twoją stronę główną GitLab, może zarejestrować  konto.  Nie zawsze jest to pożądane, więc warto przynajmniej do momentu pełnej konfiguracji wyłączyć lub ograniczyć rejestrację

Udaj się do panelu administracyjnego klikając ikonę klucza na pasku menu u góry strony:

W menu po lewej stronie na samym dole wybieramy opcję “Settings”, i tam możemy albo całkowicie wyłączyć rejestrację odznaczając checkboxa:

Albo ograniczyć ją tylko do zaufanych domen (czyli adresów mailowych w danej domenie):

Powinieneś teraz mieć działającą instancję  hostowaną na własnym serwerze. Możesz zacząć importować lub tworzyć nowe projekty i konfigurować odpowiedni poziom dostępu dla swojego zespołu. GitLab regularnie dodaje funkcje i aktualizuje swoją platformę, więc koniecznie sprawdź stronę główną projektu, aby być na bieżąco z wszelkimi ulepszeniami lub ważnymi powiadomieniami.

Oceń wpis

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Pola, których wypełnienie jest wymagane, są oznaczone symbolem *