GitLab je webový open-source správce Gitrepository napsaný v Ruby včetně wiki, správy problémů, kontroly kódu, monitorování a nepřetržité integrace a nasazení. Umožňuje vývojářům vytvářet, nasazovat a provozovat jejich aplikace.
K dispozici jsou tři různé edice GitLab, Community Edition (CE), Enterprise Edition (EE) a verze hostovaná GitLab.
Pokud chcete přesunout své projekty pryč od GitHubthen, měli byste GitLab rozhodně vyzkoušet. Dokáže importovat projekty a problémy z různých zdrojů včetně GitHubu, díky čemuž je proces migrace bezproblémový. Rozhraní GitLab je dobře navržené, čisté, intuitivní a z hlediska uživatelského zážitku a funkčnosti se blíží rozhraní GitHubu.
Existuje několik způsobů, jak nainstalovat GitLab v závislosti na vašich požadavcích a preferencích. Tento tutoriál popisuje kroky nezbytné pro instalaci a konfiguraci GitLab (CE) na systému CentOS 7 pomocí balíčků Omnibus.
Předpoklady #
Tento tutoriál předpokládá, že máte novou instalaci CentOS 7.
Podle stránky požadavků GitLab se doporučuje používat server s:
- alespoň 4 GB paměti RAM.
- 2 jádra CPU.
- nejméně 2 GB odkládacího prostoru.
- (volitelně) Doména nebo subdoména směřující na IP adresu serveru.
Pro další vrstvu zabezpečení se doporučuje nastavit základní firewall.
Uživatel, pod kterým se přihlašujete, musí mít oprávnění sudo, aby mohl instalovat balíčky.
Instalace požadovaných závislostí #
Obnovte místní index balíčků a nainstalujte závislosti pomocí následujících příkazů:
sudo yum install curl policycoreutils-python openssh-serverAby GitLab mohl posílat e-maily s upozorněním, můžete buď nainstalovat a používat Postfix, nebo použít nějakou transakční poštovní službu, jako je SendGrid, MailChimp, MailGun nebo SES, v takovém případě můžete přeskočit následující krok a nakonfigurovat [Nastavení SMTP GitLabu] (https://docs.gitlab.com/omnibus/settings/smtp.html) po dokončení instalace.
Spusťte následující příkazy k instalaci Postfixu na váš server CentOS:
sudo yum install postfix
Během instalace budete požádáni o výběr typu konfigurace poštovního serveru. Výchozí možnost je Internet Site . To je doporučená možnost, stačí stisknout TAB a poté ENTER .
Dále budete vyzváni k zadání System mail name který by měl být stejný jako název hostitele vašeho serveru.
Po dokončení instalace spusťte a povolte službu postfix spuštěním následujících příkazů:
sudo systemctl start postfixsudo systemctl enable postfix
Instalace GitLab #
Instalace GitLab je docela přímočarý proces. Balíček GitLab CE nainstalujeme pomocí yum správce balíčků.
Začněte přidáním úložiště GitLab do svého seznamu systémových zdrojů pomocí následujícího příkazu curl:
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bashSkript povolí úložiště a nainstaluje potřebné závislosti. Po dokončení nainstalujte balíček GitLab spuštěním následujícího příkazu:
sudo yum install gitlab-ce
Budete vyzváni k přijetí klíčů GPG úložiště GitLab. Zadejte y a stiskněte Enter .
Proces instalace může chvíli trvat a po úspěšné instalaci se zobrazí následující výstup:
Thank you for installing GitLab!
...
Complete!
Úprava pravidel brány firewall #
Průvodce nastavením základního firewallu je propojen v sekci předpoklady. Abyste mohli přistupovat k rozhraní GitLab, musíte otevřít porty 80 a 443 . Chcete-li tak učinit, spusťte následující příkazy:
sudo firewall-cmd --permanent --zone=public --add-service=httpsudo firewall-cmd --permanent --zone=public --add-service=httpssudo firewall-cmd --reload
Nastavit adresu URL GitLab #
Před vstupem do webového rozhraní GitLabu musíme nastavit URL, na které bude GitLab dostupný. Otevřete konfigurační soubor Gitlabu a proveďte následující změny:
sudo vim /etc/gitlab/gitlab.rb
V horní části konfiguračního souboru uvidíte řádek začínající external_url . Změňte hodnotu tak, aby odpovídala vaší doméně/subdoméně nebo IP adrese. Pokud máte doménu, použijte https a pokud chcete přistupovat k rozhraní GitLab přes IP adresu vašeho serveru, použijte http .
external_url 'https://gitlab.example.com'
Dále vyhledejte „Let’s Encrypt integration“, odkomentujte řádek začínající letsencrypt['enable'] a nastavte to na true. Volitelně, pokud chcete od Let’s Encrypt dostávat e-maily týkající se vaší domény, odkomentujte řádek začínající letsencrypt['contact_emails'] a přidejte svou e-mailovou adresu.
Pokud nastavíte external_url na IP adresu, pak byste neměli povolovat integraci Let’s Encrypt.
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['[email protected]'] # This should be an array of email addresses to add as contacts
Nakonec uložte a zavřete soubor a spusťte následující příkaz pro překonfigurování Gitlabu:
sudo gitlab-ctl reconfigurePříkaz překonfiguruje nastavení GitLabu a vygeneruje bezplatný certifikát Let’s encrypt SSL.
Konfigurace GitLab prostřednictvím webového rozhraní #
Nyní, když jste nakonfigurovali adresu URL GitLab, můžete začít s počáteční konfigurací prostřednictvím webového rozhraní GitLab.
Spusťte webový prohlížeč a přejděte na:
https://your_gitlab_domain_or_server_IP.com
1. Nastavení hesla účtu správce #
Při prvním přístupu k webovému rozhraní budete vyzváni k nastavení hesla pro účet správce.
Zadejte bezpečné heslo a klikněte na Change your password až budete hotovi.
Budete přesměrováni na přihlašovací stránku:
Výchozí uživatelské jméno administrativního účtu je root . Později v tomto tutoriálu vám ukážeme, jak změnit uživatelské jméno.
- Uživatelské jméno:root
- Heslo:[heslo, které jste nastavili]
Zadejte přihlašovací údaje a klikněte na Sign in a budete přesměrováni na uvítací stránku GitLab.
2. Úprava uživatelského profilu #
První věc, kterou budete chtít udělat, je upravit svůj uživatelský profil. Klikněte na avatar uživatele (pravý horní roh) a z rozbalovací nabídky vyberte Settings :
Zde můžete změnit své jméno, e-mail a další informace a nastavení profilu. Proveďte změny podle svých představ.
Až budete hotovi, klikněte na Update Profile settings a zanedlouho obdržíte potvrzovací e-mail na zadanou adresu. Chcete-li potvrdit svůj účet, postupujte podle pokynů uvedených v e-mailu.
3. Změna uživatelského jména #
Pro přístup na stránku profilu klikněte na Account odkaz z levé vertikální navigační nabídky.
Jak již víte, výchozí uživatelské jméno prvního účtu správce je root . Chcete-li jej změnit, zadejte své nové uživatelské jméno a klikněte na Update username tlačítko.
Na této obrazovce můžete také povolit dvoufaktorové ověřování.
Při příštím přihlášení do řídicího panelu GitLab budete muset zadat nové uživatelské jméno.
4. Přidání klíče SSH #
Abyste mohli přenést své místní změny git na server GitLab, přidejte svůj veřejný klíč SSH do svého účtu GitLab.
Pokud již máte ve svém lokálním systému vytvořený pár klíčů SSH, můžete veřejný klíč zobrazit zadáním:
cat ~/.ssh/id_rsa.pubVýstup by měl vypadat nějak takto:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDd/mnMzHwjUzK8g3ldfsfRpJuC16mhWamaXRk8ySQrD/dzpbRLfDnZsLxCzRoq+ZzFHGwcQlJergtergdHGRrO8FE5jl3IWRRp+mP12qYw== [email protected]
V případě, že příkaz výše vypíše No such file or directory to znamená, že na vašem počítači nemáte vygenerovaný pár klíčů SSH.
Chcete-li vygenerovat nový pár klíčů SSH, použijte následující příkaz:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
Zkopírujte výstup z příkazu cat a přejděte zpět do webového rozhraní GitLab. Klikněte na SSH Keys z levé vertikální navigační nabídky, abyste se dostali na konfigurační stránku SSH Keys.
V Key textarea vložte veřejný klíč, který jste dříve zkopírovali z místního počítače, nastavte popisný název a klikněte na Add key tlačítko:
Nyní byste měli být schopni přenést a stáhnout změny projektu z místního počítače, aniž byste museli poskytovat přihlašovací údaje k účtu GitLab.