Jak skonfigurować serwer GitLab na serwerze Windows z Hyper-V

Aby skonfigurować GitLab Self-Managed na serwerze Windows Server, uruchom obsługiwaną maszynę wirtualną Ubuntu Server w Hyper-V i zainstaluj GitLab w systemie gościa Linux. Windows Server pozostaje hostem; GitLab działa z oficjalnego pakietu Linux. Aktualny przewodnik GitLab po pakietach Ubuntu zawiera listę Ubuntu 22.04 i 24.04, dlatego w tym przewodniku wykorzystano Ubuntu Server 24.04 LTS.

Zanim zaczniesz, upewnij się, że host może zarezerwowac procesor, pamięć RAM i dysk dla gościa. Bazowa wartość pojedynczego węzła GitLab to 8 wirtualnych procesorów (vCPU) i 16 GB pamięci RAM; budżet 40 GB na aplikację, 5–12 GB na bazę danych plus miejsce na repozytorium. Użyj dysków SSD i zostaw zasoby dla systemu Windows Server.

1. Zainstaluj rolę Hyper-V

W Menedżerze serwera wybierz Zarządzaj > Dodaj role i funkcje , wybierz serwer lokalny i włącz Hyper-V . Dodaj narzędzia zarządzania i zezwól na wymagane ponowne uruchomienie. Możesz również uruchomić program PowerShell jako administrator i zainstalować rolę lokalną za pomocą:

Install-WindowsFeature -Name Hyper-V -IncludeManagementTools -Restart

Instalacja Hyper-V powoduje ponowne uruchomienie hosta. Jeśli Twój serwer korzysta z innej konfiguracji zarządzania, zapoznaj się z instrukcją instalacji Hyper-V firmy Microsoft.

2. Utwórz wirtualny przełącznik dla gościa

W Menedżerze Hyper-V otwórz Menedżera przełączników wirtualnych i utwórz przełącznik zewnętrzny na karcie sieciowej hosta. Wybierz, czy system Windows ma go udostępniać. Dzięki temu Ubuntu uzyska adres LAN i autoryzowane urządzenia będą mogły uzyskać dostęp do GitLab. Użyj zaufanej sieci LAN lub VPN; postępuj zgodnie z zasadami sieciowymi przed uzyskaniem dostępu publicznego. Zobacz przewodnik po przełącznikach wirtualnych firmy Microsoft .

3. Utwórz maszynę wirtualną Ubuntu

Pobierz Ubuntu Server 24.04 LTS . W Menedżerze Hyper-V utwórz maszynę wirtualną o nazwie GitLab-Ubuntu, wybierz Generację 2 , podłącz przełącznik zewnętrzny i utwórz dysk VHDX z dyskiem SSD. Użyj bazy GitLab z 8 procesorami wirtualnymi i 16 GB pamięci dla pojedynczego węzła; laboratorium może zacząć od mniejszej pamięci, z niższą wydajnością.

Podłącz obraz ISO do wirtualnego napędu DVD. Jeśli Ubuntu się nie uruchamia, ustaw szablon bezpiecznego rozruchu maszyny wirtualnej drugiej generacji na Microsoft UEFI Certificate Authority .

4. Zainstaluj Ubuntu i podaj mu stabilny adres

Uruchom maszynę wirtualną i zakończ instalację Ubuntu Server. Utwórz konto administratora, użyj nazwy hosta, takiej jak gitlab, i włącz OpenSSH do zdalnej administracji. Przypisz maszynie wirtualnej statyczny adres IP lub rezerwację DHCP, aby jej adres pozostał stabilny.

Po pierwszym zalogowaniu zainstaluj dostępne aktualizacje i uruchom ponownie komputer, jeśli zostaniesz o to poproszony:

sudo apt update && sudo apt upgrade -y

5. Ustaw DNS i zezwól tylko na wymagany ruch

Utwórz rekord DNS, który gitlab.example.comodpowiada stabilnemu adresowi maszyny wirtualnej. Zezwól na przychodzące porty TCP: 22 dla Git przez SSH, 80 dla HTTP i walidacji certyfikatów Let's Encrypt oraz 443 dla HTTPS. Zastosuj pasujące reguły w zaporze Ubuntu, zaporze sieciowej/systemu Windows oraz na dowolnym routerze lub zaporze w chmurze przed hostem. W miarę możliwości ogranicz dostęp SSH i dostęp do internetu do docelowych użytkowników lub sieci.

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

6. Zainstaluj pakiet GitLab Linux

Te polecenia instalują pakiet Community Edition. Zastąp przykładową nazwę hosta skonfigurowaną nazwą DNS. W przypadku wersji Enterprise Edition użyj opcji EE z oficjalnego podręcznika instalacji Ubuntu w serwisie GitLab . Przed uruchomieniem skryptu konfiguracji repozytorium jako administrator zapoznaj się ze skryptem.

sudo apt update
sudo apt install -y curl
curl --location "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh" | sudo bash
sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

Dzięki prawidłowej publicznej nazwie DNS i dostępowi HTTP w ruchu przychodzącym, GitLab może zażądać certyfikatu Let's Encrypt podczas instalacji. W przypadku serwera wewnętrznego należy skonfigurować certyfikat zaufany w organizacji i postępować zgodnie z aktualnymi instrukcjami GitLab dotyczącymi protokołu TLS. Przed określeniem rozmiaru produkcyjnej maszyny wirtualnej sprawdź wymagania instalacyjne GitLab .

7. Zaloguj się, zabezpiecz instancję i przetestuj repozytorium

Po zakończeniu instalacji otwórz https://gitlab.example.com. Zaloguj się jako root; pobierz początkowe hasło z /etc/gitlab/initial_root_passwordmaszyny wirtualnej Ubuntu. GitLab usunie ten plik po 24 godzinach, więc zmień hasło natychmiast i bezpiecznie przechowuj nowe dane uwierzytelniające.

Utwórz projekt testowy, dodaj plik README i sklonuj go przez HTTPS lub SSH z komputera klienckiego, aby potwierdzić działanie DNS, reguł zapory sieciowej i uwierzytelniania. Przed zaproszeniem zespołu zapoznaj się z zalecanymi przez GitLab kolejnymi krokami , włącz uwierzytelnianie dwuskładnikowe i ogranicz publiczne rejestracje, jeśli instancja jest prywatna. Skonfiguruj zaplanowane kopie zapasowe i skopiuj je z maszyny wirtualnej; przewodnik GitLab dotyczący tworzenia kopii zapasowych wyjaśnia, co obejmuje polecenie backup i co należy utworzyć osobno.

Stosuj poprawki systemów Windows i Ubuntu, obserwuj wzrost dysku i testuj przywracanie kopii zapasowej przed wykorzystaniem ważnych repozytoriów na danej instancji.