Phenquestions
Met GitLab kunt u uw projecten plannen en methodologieën zoals Agile implementeren voor uw teamleden. Problemen en ontwikkelingscyclus volgen. Implementeer een CD/CI-pijplijn, onderhoud containerregisters en automatiseer de containerisatie van nieuw verzonden versies. Je kunt ook documentatie schrijven en privéwiki's onderhouden, de omgeving en het gebruik van hulpbronnen van de software bewaken in verschillende fasen, zoals testen of productie.
Vereisten
Volgens de minimale vereisten van GitLab Community heb je nodig:
- 1 vCPU maar 2 wordt aanbevolen voor optimale prestaties
- Minimaal 4 GB RAM met 4 GB swapruimte
- Root-toegang of sudo-rechten over de server
Als u experimenteert op uw lokale netwerk (bijvoorbeeld bij u thuis), heeft u geen openbaar IP-adres of een Fully Qualified Domain Name (FQDN) nodig, maar voor gebruik in de echte wereld is het ten zeerste aan te raden om het volgende te hebben:
- Een statisch openbaar IP-adres naar de server waarop GitLab moet worden geïnstalleerd
- Een FQDN die naar dat IP verwijst
Meer dan wat dan ook, zal een FQDN je helpen GitLab te integreren met LetsEncrypt, wat vrij essentieel is vanuit een veiligheids- en privacyperspectief.
We zullen het hebben over LetsEncrypt-integratie, maar voor het grootste deel wordt de demo gedaan via een lokaal netwerk waarbij GitLab wordt uitgevoerd achter een NAT met een privé-IP. Ten slotte willen we dat onze server een schone installatie uitvoert Ubuntu 18.04 LTS-server om het real-world scenario nauwkeurig na te bootsen.
Afhankelijkheden installeren en opslagplaatsen toevoegen
De eerste stap die we zouden moeten uitvoeren, is de gebruikelijke update en upgrade van het systeem:
$ sudo apt-update$ sudo apt upgrade -y
Vervolgens moeten we controleren of de volgende pakketten: - ca-certificaten, software-eigenschappen-common en openssh-server zijn geïnstalleerd. De kans is groot dat je al bent ingelogd met OpenSSH en de andere pakketten komen uit de doos met Ubuntu 18.04. Toch is het een goed idee om grondig te zijn.
$ sudo apt install ca-certificates openssh-server software-properties-commonEen belangrijke afhankelijkheid die tijdens de installatie mogelijk enige hulp nodig heeft, is Postfix, een agent voor e-mailoverdracht. GitLab heeft het nodig om via e-mail met de gebruikers te communiceren.
$ sudo apt install postfixHier wordt u gevraagd om te selecteren welk type installatie het is, Selecteer Website, en zorg er vervolgens voor dat de FQDN.
Vervolgens moeten we een domeinnaam toevoegen, in het geval dat u een openbaar of privé IP-adres gebruikt, kunt u dat IP-adres ook gewoon toevoegen. Ik heb een lokale DNS ingesteld en het GitLab wordt geïnstalleerd op ubuntu.lokaal. Als u een FQDN gebruikt, zoals: gitlab.voorbeeld.com voor uw GitLab-instantie, gebruik die domeinnaam hier.
Nu zijn we klaar om GitLab toe te voegen aan onze lijst met repositories die dan zouden worden geïnstalleerd.
$ curl https://pakketten.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bashDit script zal een paar extra afhankelijkheden installeren, gpg-sleutels toevoegen voor de officiële repositories en de repository toevoegen aan de lijst met bronnen. Ons systeem klaar maken voor de laatste stap van de installatie.
GitLab installeren en configureren
GitLab installeren is nu net zo eenvoudig als uitvoeren:
$ sudo apt install gitlab-ceDit kan even duren, omdat het pakket zelf enorm groot is (ongeveer 470 MB op het moment van schrijven) en het downloaden en uitpakken kan even duren. Zodra dat is gebeurd, zijn we nu klaar om GitLab . te configureren.
Open het bestand /etc/gitlab.rb met uw favoriete teksteditor (met sudo privileges) en bewerk de regel die zegt: externe_url zoals hieronder weergegeven:
Als u het op de openbare hostingservice installeert, met een FQDN, kunt u dat als een waarde toevoegen. Ook kunt u gebruik maken van https, in plaats van http. Dus als uw domeinnaam is gitlab.voorbeeld.com het wordt ingevoerd als:
Maar we zullen http gebruiken, omdat het een lokale installatie is.
LetsEncrypt-integratie (HTTPS)
Deze stap is alleen van toepassing op mensen die een FQDN gebruiken en hebben ingesteld externe_url gebruiken https, in de bovenstaande stap:.
In hetzelfde bestand /etc/gitlab/gitlab.rb, zoek naar de sectie die over LetsEncrypt gaat (zoek naar "Let's Encrypt Integration") en schakel Let's Encrypt in, samen met het toevoegen van uw huidige e-mailaccount, voor het geval LetsEncrypt u op de hoogte wil stellen van ongeplande/geplande certificaatvernieuwingen.
De twee regels die hier zijn gewijzigd zijn:
# letsencrypt['enable'] = true# letsencrypt['contact_emails'] = ['[email protected]']
Nu kunt u het bestand opslaan en de GitLab-toepassing starten met de gewijzigde configuratie.
$ sudo gitlab-ctl opnieuw configurerenDat is het! Je GitLab-instantie is actief. Gebruik uw browser om het configuratiescherm te bezoeken op http://IP_ADDRESS of https://gitlab.voorbeeld.com voor het geval je FQDN met SSL hebt gebruikt.
Initiële setup
Bij het bezoeken van de website in uw browser, wordt u eerst gevraagd om een wachtwoord in te stellen voor de "wortel" gebruiker
Stel een wachtwoord in en log vervolgens in als gebruiker “wortel"hetzelfde gebruiken". Vanaf hier begint je gratis GitHub-reis. Neem de controle over uw projecten, voeg uw teamleden toe en wees weer productief!
Conclusie
Hoewel ik persoonlijk denk dat Microsoft de afgelopen jaren een goede rentmeester is geweest van de open source-gemeenschap, is het toch goed om te weten dat er opties zoals GitLab zijn voor gebruikers die iets anders willen. Monopolies zijn nooit goed voor de gemeenschap. In deze notitie komen we terug op het onderwerp GitLab en zien we in een vervolg hoe je een containerregister kunt opzetten. Blijf daarvoor op de hoogte!
