Jenkins Integrace s GitHubem: Jak nainstalovat plugin Git?

Už jsi se naučil/a, co Jenkins je a jak na to nainstalujte jej na Windows systémZa předpokladu, že jsou tyto základní kroky dokončeny, nyní přejdeme ke správě pluginů.

Jenkins má vynikající podporu pluginů. K dispozici je více než tisíc pluginů aplikací třetích stran. Chcete-li zkontrolovat, zda Jenkins podporuje aplikaci třetí strany, kterou máte na mysli, vyhledejte adresář pluginů na adrese https://plugins.jenkins.io/.

Instalace pluginů v Jenkins

Jenkins dodává se s poměrně základním nastavením, takže je nutné nainstalovat požadované pluginy, abyste umožnili podporu pro každou aplikaci třetích stran.

GitHub je webové úložiště kódu, které hraje hlavní roli v DevOps. Poskytuje společnou platformu pro více vývojářů pracujících na stejném kódu nebo projektu pro nahrávání a načítání aktualizovaného kódu, čímž usnadňuje průběžnou integraci.

Jenkins Před načítáním kódu z repozitáře GitHub je nutné mít nainstalovaný plugin Git. Názvy těchto dvou pluginů se často zaměňují, proto je tabulka níže odděluje:

Tyto pluginy nemusíte instalovat, pokud jste již navrhované pluginy přijali během Jenkins nastavení instalace, protože plugin Git je součástí této sady. Pokud ne, zde je návod, jak je nainstalovat a stáhnout kód z repozitáře GitHub.

Jak nainstalovat plugin Git Jenkins

Následuje podrobný postup, jak nainstalovat plugin Git. Jenkins:

Krok 1: Otevřete řídicí panel.
Klikněte na Řídit Jenkins tlačítko na vašem Jenkins přístrojová deska:

Krok 2: Najděte možnost pluginů.
Klikněte na pluginyAktuální Jenkins vydání, tento záznam je označen jednoduše pluginystarší verze označené stejnou obrazovkou Spravovat pluginy.

Krok 3: Na stránce Pluginy otevřete Dostupné pluginy záložka a poté:

1. Vybrat Git plugin
2. klikněte Instalovat bez restartuStažení pluginu trvá několik okamžiků v závislosti na vašem internetovém připojení a nainstaluje se automaticky.
3. Místo toho si můžete vybrat Stáhnout nyní a nainstalovat po restartu, v takovém případě se plugin použije, když Jenkins další starty.
4. Pokud je plugin již nainstalován, zobrazí se na Instalovaný záložka a není nabízena žádná aktualizace.

Krok 4: Jakmile jsou pluginy nainstalovány, přejděte na Řídit Jenkins > Pluginy > NainstalovanéVaše nové pluginy jsou uvedeny mezi ostatními.

S nainstalovaným pluginem, Jenkins nyní lze nasměrovat na skutečný repozitář.

Jak se integrovat Jenkins S GitHubem

Nyní si projdeme proces integrace Jenkins a GitHub na Windows Systém:

Krok 1) Vytvořte novou pracovní pozici v Jenkins. Otevři Jenkins palubní deska na vašem Jenkins URL, Například http://localhost:8080/, a klepněte na tlačítko Nový předmět:

Krok 2) Zadejte název položky, vyberte typ úlohy a klikněte na OK. Jako příklad vytvoříme projekt Freestyle.

Krok 3) Jakmile kliknete OK, stránka přesměruje na formulář pro konfiguraci projektu. Zde zadejte informace o projektu:

Krok 4) Uvidíte a Git možnost pod Zdroj Code management pokud byl nainstalován plugin Git Jenkins:

Poznámka: V případě, že Git možnost se nezobrazuje, znovu nainstalujte plugin, restartujte Jenkinsa znovu se přihlaste do řídicího panelu. Git Možnost se pak zobrazí, jak je znázorněno výše.

Krok 5) Vstupte do Git repozitáře URL stáhnout kód z GitHubu.

Krok 6) Při prvním vstupu do repozitáře se může zobrazit chybová zpráva. URL, Například:

K tomu dochází, když na počítači, na kterém běží, není nainstalován Git. Jenkins. Jenkins Neobsahuje vlastní binární soubor Git; plugin volá spustitelný soubor Git na hostiteli. Chcete-li Git nainstalovat lokálně, přejděte na https://git-scm.com/downloads.

Stáhněte si vhodný instalační program Gitu pro váš Operasystém – v tomto případě Windows — a nainstalujte jej na spuštěný počítač JenkinsDokončete instalaci podle pokynů na obrazovce.

Krok 7) Jenkins Po instalaci Gitu na počítači můžete spustit repozitáře Git. Instalaci potvrďte otevřením příkazového řádku, typ gita stiskněte klávesu Enter. Zobrazí se seznam možností Gitu:

:: Confirm the Git executable resolves and report its version
git --version

:: Expected output
git version 2.51.0.windows.1

:: Show the full path Jenkins should record in Global Tool Configuration
where git

Tím se potvrdí, že je Git nainstalován ve vašem systému.

Poznámka: Pokud je Git již nainstalován, přidejte git.exe cesta pod Řídit Jenkins > Nástroje (označené Globální konfigurace nástroje u starších vydání).

Krok 8) Se vším na svém místě přidejte Git URL do Jenkins znovu. Nezobrazí se žádná chybová zpráva, což potvrzuje Jenkins Integrace s Gitem:

Git je nyní ve vašem systému správně nakonfigurován. Veřejný repozitář se v tomto okamžiku naklonuje, ale soukromý stále potřebuje přihlašovací údaje, což je další krok.

Jak se autentizovat Jenkins S osobním přístupovým tokenem GitHubu

GitHub přestal v srpnu 2021 přijímat hesla k účtům pro operace s Gitem. Zadání uživatelského jména a hesla v Jenkins proto selže u jakéhokoli soukromého repozitáře s chybou ověřování, a to i v případě, že se na web GitHub přihlašují stejné přihlašovací údaje. Heslo nahrazuje osobní přístupový token a Jenkins ukládá jej do vlastního úložiště přihlašovacích údajů, nikoli do konfigurace úlohy.

Nejprve si vytvořte token na GitHubu:

1. V GitHubu otevřete Nastavení > Nastavení pro vývojáře > Osobní přístupové tokeny.
2. Vyberte si jemnozrnný token, kde je to možné, protože může být omezen na jeden repozitář nebo klasický token, pokud ho vaše organizace stále potřebuje.
3. Udělte přístup pro čtení obsahu repozitáře. Přidejte status commitu s přístupem pro zápis pouze tehdy, když chcete. Jenkins hlásit výsledky sestavení zpět do commitů.
4. Nastavte datum platnosti a okamžitě zkopírujte token – GitHub ho zobrazí přesně jednou.

Pak zaregistrujte token uvnitř Jenkins:

1. Přejít Řídit Jenkins > Přihlašovací údaje > Systém > Globální přihlašovací údaje a klepněte na tlačítko Přidat přihlašovací údaje.
2. vybrat Uživatelské jméno s heslem jako druh. Zadejte své uživatelské jméno na GitHubu a vložte známka do pole pro heslo.
3. Uveďte pro položku jasné ID, například github-pat takže je rozpoznatelný na obrazovkách konfigurace úlohy.
4. Návrat do práce, otevřeno Zdroj Code Správa > Gita vyberte nové přihlašovací údaje z pověřovací listiny dropdown.

Červená chyba ověření v repozitáři URL zmizí jednou Jenkins lze ověřit. Je třeba si zapamatovat dvě praktické poznámky. Zaprvé, tokeny expirují; úloha, která spolehlivě běžela měsíce a náhle selže při odevzdání, je téměř vždy expirovaný token, nikoli poškozený repozitář. Zadruhé, SSH klíč je platnou alternativou – přidejte soukromý klíč jako Uživatelské jméno SSH se soukromým klíčem pověření a použití git@github.com:owner/repo.git URL formulář místo formuláře HTTPS.

Jak spustit Jenkins Automatické sestavení pomocí webhooku na GitHubu

Výše vytvořená úloha se stále musí spouštět ručně, což maří účel kontinuální integrace. Webhook tuto mezeru uzavírá: GitHub odesílá HTTP požadavek na Jenkins při každém zatlačení a Jenkins okamžitě zahájí stavbu.

Jenkins Aby to fungovalo, musí být dostupné z GitHubu. Na notebooku s operačním systémem localhost:8080 není, takže buď hostitel Jenkins na veřejnosti URL nebo jej dočasně zpřístupnit tunelovací službě během testování.

1. Nainstalujte si plugin GitHub. Zpět na Řídit Jenkins > Pluginy > Dostupné pluginy a nainstalujte GitHubToto přidává možnost spouštění, kterou samotný plugin Git neposkytuje.
2. Povolte spouštěč v úloze. Otevřete konfiguraci úlohy a přejděte na Sestavte spouštěče, a zaškrtněte Spouštěč hooku GitHubu pro dotazování GITScm.
3. Přidejte webhook do GitHubu. V repozitáři otevřete Nastavení > Webhooky > Přidat webhook.
4. Nastavení užitečného zatížení URL tvému Jenkins adresa následovaná /github-webhook/Koncové lomítko je důležité.
5. Nastavení typu obsahu na application/json A zvolte Pouze událost push.
6. Uložit a otestovat. GitHub odesílá ping okamžitě. Zelená fajfka pod Nedávné dodávky znamená Jenkins přijal to.

# Payload URL format for the GitHub webhook
https://jenkins.example.com/github-webhook/

# Content type
application/json

# Verify from the Jenkins host that the endpoint answers
curl -I https://jenkins.example.com/github-webhook/

Odešlete commit pro potvrzení uzavření smyčky. Úloha by se měla objevit ve frontě sestavení během několika sekund bez nutnosti ručního zásahu. Pokud se nic nestane, otevřete webhook na GitHubu a přečtěte si Nedávné dodávky kód odpovědi: kód 403 obvykle ukazuje na Jenkins nastavení zabezpečení blokující anonymní přístup ke koncovému bodu, zatímco časový limit znamená, že GitHub se nemůže dostat k Jenkins URL vůbec.

Jakmile se sestavení spustí automaticky, zbývajícím problémem je obvykle hrstka opakujících se chyb.

Společný Jenkins Chyby a opravy integrace GitHubu

Téměř každá neúspěšná integrace spadá do jedné z níže uvedených kategorií a každá má zřetelný příznak, který přímo ukazuje na příčinu.

• V sekci Zdroj není k dispozici možnost Git. Code Řízení: Plugin Git není nainstalován nebo není načten. Znovu jej nainstalujte z Řídit Jenkins > Pluginy, restartujte Jenkinsa znovu načtěte stránku s konfigurací úlohy.
• „Nepodařilo se připojit k repozitáři“ na veřejném URL: Git chybí v Jenkins hostitel. Nainstalujte Git a poté potvrďte pomocí git --version a zaznamenejte cestu pod ní Řídit Jenkins > Nástroje.
• Ověření selhalo na soukromém repozitáři: Používá se heslo k účtu. Nahraďte ho osobním přístupovým tokenem, jak je popsáno výše, nebo přepněte na klíč SSH.
• Sestavení se po odeslání nikdy nezačne: buď Spouštěč hooku na GitHubu zaškrtávací políčko není zaškrtnuté nebo se GitHub nemůže dostat k Jenkins URLZkontrolujte protokol doručování webhooků v nastavení repozitáře.
• Je vytvořena nesprávná větev: ο Specifikátor větve stále drží výchozí nastavení */master zatímco repozitář používá mainAktualizujte specifikátor tak, aby odpovídal.
• Pokladna včera fungovala a dnes selhala: Platnost osobního přístupového tokenu vypršela. Vygenerujte náhradní a aktualizujte uložené přihlašovací údaje.

Také zkontrolujte: Nejlepší Jenkins Alternativy (otevřený zdroj a placené) a CI/CD potrubí návod, který navazuje na zde navázané spojení.

Nejčastější dotazy