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:
Jeśli jesteś już zapisany - Kliknij "Zaloguj się" i podaj swojego maila - treść zostanie odblokowana:
Instalowanie GitLab
Pobieramy skrypt instalacyjny do katalogu /tmp i instalujemy Gitlaba (polecam spojrzeć w zawartość pliku by wiedzieć co on dokładnie robi):
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:
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.