Jenkins Integracija s GitHubom: Kako instalirati Git dodatak?

Već si naučio/la što Jenkins je i kako instalirajte ga na Windows sistemPod pretpostavkom da su ti osnovni koraci dovršeni, sada ćemo prijeći na upravljanje dodacima.

Jenkins ima izvrsnu podršku za dodatke. Dostupno je preko tisuću dodataka za aplikacije trećih strana. Da biste provjerili je li Jenkins podržava aplikaciju treće strane koju imate na umu, pretražite direktorij dodataka na https://plugins.jenkins.io/.

Instalacija dodataka u Jenkins

Jenkins dolazi s prilično osnovnim postavkama, tako da morate instalirati potrebne dodatke kako biste omogućili podršku za svaku aplikaciju treće strane.

GitHub je web-bazirani repozitorij koda koji igra glavnu ulogu u DevOpsu. Pruža zajedničku platformu za više programera koji rade na istom kodu ili projektu za prijenos i dohvaćanje ažuriranog koda, čime se olakšava kontinuirana integracija.

Jenkins Potrebno je instalirati Git dodatak prije nego što može preuzeti kod iz GitHub repozitorija. Nazivi dva dodatka se često brkaju, pa ih tablica u nastavku razdvaja:

Ne morate instalirati ove dodatke ako ste već prihvatili predložene dodatke tijekom Jenkins postavljanje instalacije, budući da je Git dodatak dio tog seta. Ako nije, evo kako ih instalirati i izvući kod iz GitHub repozitorija.

Kako instalirati Git dodatak u Jenkins

Slijedi korak-po-korak postupak instalacije Git dodatka u Jenkins:

Korak 1: Otvorite svoju nadzornu ploču.
Kliknite na upravljati Jenkins gumb na vašem Jenkins nadzorna ploča:

Korak 2: Pronađite opciju dodataka.
Kliknite na DodaciTrenutno Jenkins izdanja ovaj unos je označen jednostavno Dodacistarija izdanja označena istim zaslonom Upravljanje dodacima.

Korak 3: Na stranici Dodaci otvorite Dostupni dodaci kartica, a zatim:

1. Odaberite ići uključiti
2. Kliknite Instalirajte bez ponovnog pokretanjaPreuzimanje dodatka traje nekoliko trenutaka, ovisno o vašoj internetskoj vezi, i instalira se automatski.
3. Umjesto toga možete odabrati Preuzmite sada i instalirajte nakon ponovnog pokretanja, u kojem slučaju se dodatak primjenjuje kada Jenkins sljedeći počinje.
4. Ako je dodatak već prisutan, pojavljuje se na Instalirani kartica i ne nudi se ažuriranje.

Korak 4: Nakon što su dodaci instalirani, idite na upravljati Jenkins > Dodaci > InstaliranoVaši novi dodaci navedeni su među ostalima.

S instaliranim dodatkom, Jenkins sada se može usmjeriti na stvarno spremište.

Kako se integrirati Jenkins S GitHubom

Sada ćemo proći kroz proces integracije Jenkins i GitHub na Windows Sustav:

Korak 1) Stvori novi posao u Jenkins, Otvori Jenkins nadzorna ploča na vašem Jenkins URL, Na primjer http://localhost:8080/, i kliknite Nova stavka:

Korak 2) Unesite naziv stavke, odaberite vrstu posla i kliknite OK. Napravit ćemo Freestyle projekt kao primjer.

Korak 3) Nakon što kliknete OK, stranica preusmjerava na obrazac za konfiguraciju projekta. Ovdje unesite podatke o projektu:

Korak 4) Vidjet ćete ići opcija pod izvor Code Upravljanje ako je Git dodatak instaliran u Jenkins:

Bilješka: Ako ići opcija se ne pojavljuje, ponovno instalirajte dodatak, ponovno pokrenite Jenkinsi ponovno se prijavite na nadzornu ploču. ići opcija će tada biti vidljiva kao što je prikazano gore.

Korak 5) Uđite u Git repozitorij URL za preuzimanje koda s GitHuba.

Korak 6) Možda ćete dobiti poruku o pogrešci prilikom prvog ulaska u repozitorij URL, Na primjer:

To se događa kada Git nije instaliran na računalu na kojem se izvršava Jenkins. Jenkins ne uključuje vlastitu Git binarnu datoteku; dodatak poziva Git izvršnu datoteku na hostu. Za lokalnu instalaciju Gita, idite na https://git-scm.com/downloads.

Preuzmite odgovarajući Git instalacijski program za svoj Operating sustav - u ovom slučaju Windows — i instalirajte ga na pokrenuti stroj JenkinsSlijedite upute na zaslonu kako biste dovršili instalaciju.

Korak 7) Jenkins može pokrenuti Git repozitorije nakon što je Git instaliran na računalu. Za potvrdu instalacije otvorite naredbeni redaktipa giti pritisnite Enter. Pojavit će se popis Gitovih opcija:

:: 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

Ovo potvrđuje da je Git instaliran na vašem sustavu.

Bilješka: Ako je Git već instaliran, dodajte git.exe put ispod upravljati Jenkins > Alati (označen Globalna konfiguracija alata na starijim izdanjima).

Korak 8) Kada je sve na svom mjestu, dodajte Git URL u Jenkins ponovno. Ne pojavljuje se poruka o pogrešci, što potvrđuje Jenkins Integracija s Gitom:

Git je sada ispravno konfiguriran na vašem sustavu. Javni repozitorij će se u ovom trenutku klonirati, ali privatni i dalje treba vjerodajnice, što je sljedeći korak.

Kako se autentificirati Jenkins S osobnim pristupnim tokenom za GitHub

GitHub je prestao prihvaćati lozinke računa za Gitove operacije u kolovozu 2021. Navođenje korisničkog imena i lozinke u Jenkins stoga ne uspijeva protiv bilo kojeg privatnog repozitorija s greškom autentifikacije, čak i kada se isti vjerodajnici prijavljuju na GitHub web stranicu. Osobni token za pristup zamjenjuje lozinku i Jenkins pohranjuje ga u vlastito spremište vjerodajnica, a ne u konfiguraciju posla.

Prvo kreirajte token u GitHubu:

1. U GitHubu otvorite Postavke > Postavke za razvojne programere > Osobni tokeni za pristup.
2. Odaberite sitnozrnast token gdje je to moguće, jer se može ograničiti na jedno spremište ili klasik token ako vaša organizacija još uvijek zahtijeva jedan.
3. Omogućite pristup za čitanje sadržaja repozitorija. Dodajte status potvrde s pristupom za pisanje samo kada želite. Jenkins za prijavu rezultata izgradnje natrag na commitove.
4. Postavite datum isteka i odmah kopirajte token — GitHub ga prikazuje točno jednom.

Zatim registrirajte token unutra Jenkins:

1. Idi na upravljati Jenkins > Vjerodajnice > Sustav > Globalne vjerodajnice i kliknite Dodaj vjerodajnice.
2. odabrati Korisničko ime s lozinkom kao vrstu. Unesite svoje korisničko ime za GitHub i zalijepite znak u polje za lozinku.
3. Dajte unosu jasan ID kao što je github-pat tako da je prepoznatljiv na ekranima za konfiguraciju posla.
4. Povratak na posao, otvoreno izvor Code Upravljanje > Giti odaberite novu vjerodajnicu iz akreditiv padajućeg.

Crvena greška validacije ispod repozitorija URL nestaje jednom Jenkins može autentificirati. Vrijedi zapamtiti dvije praktične napomene. Prvo, tokeni istječu; posao koji je pouzdano radio mjesecima i iznenada ne uspije prilikom odjave gotovo je uvijek istekli token, a ne pokvareno spremište. Drugo, SSH ključ je valjana alternativa - dodajte privatni ključ kao SSH korisničko ime s privatnim ključem vjerodajnicu i koristite git@github.com:owner/repo.git URL obrazac umjesto HTTPS obrasca.

Kako pokrenuti Jenkins Automatski se gradi pomoću GitHub webhooka

Gore kreirani posao i dalje se mora ručno pokrenuti, što poništava svrhu kontinuirane integracije. Webhook zatvara tu prazninu: GitHub šalje HTTP zahtjev na Jenkins pri svakom guranju i Jenkins odmah započinje s gradnjom.

Jenkins mora biti dostupno s GitHuba da bi ovo funkcioniralo. Na prijenosnom računalu s localhost:8080 nije, pa bilo koji domaćin Jenkins na javnom URL ili ga privremeno izložiti putem usluge tuneliranja tijekom testiranja.

1. Instalirajte dodatak za GitHub. Vrati se na upravljati Jenkins > Dodaci > Dostupni dodaci i instalirajte GitHubOvo dodaje opciju okidača koju sam Git dodatak ne pruža.
2. Omogućite okidač na zadatku. Otvorite konfiguraciju posla, pomaknite se do Okidači za izgradnjui označite GitHub hook okidač za GITScm anketiranje.
3. Dodajte webhook u GitHub. U repozitoriju, otvorite Postavke > Webhookovi > Dodaj webhook.
4. Postavite korisni teret URL na vaše Jenkins adresa nakon koje slijedi /github-webhook/Završna kosa crta je važna.
5. Postavite vrstu sadržaja do application/json I odaberite Samo događaj push-a.
6. Spremi i testiraj. GitHub šalje ping odmah. Zelena kvačica ispod Nedavne isporuke sredstva Jenkins prihvatio 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/

Potvrdite da je petlja zatvorena pritiskom na commit. Posao bi se trebao pojaviti u redu čekanja za izradu u roku od nekoliko sekundi bez ikakve ručne radnje. Ako se ništa ne dogodi, otvorite webhook u GitHubu i pročitajte Nedavne isporuke kod odgovora: 403 obično pokazuje na Jenkins sigurnosne postavke blokiraju anonimni pristup krajnjoj točki, dok vremensko ograničenje znači da GitHub ne može dosegnuti Jenkins URL uopće.

Nakon što se izgradnje pokrenu automatski, preostali problem obično je nekoliko ponavljajućih pogrešaka.

Zajednički Jenkins Greške i ispravci integracije GitHuba

Gotovo svaka neuspješna integracija spada u jednu od dolje navedenih kategorija, a svaka ima zaseban simptom koji izravno ukazuje na uzrok.

• Nema opcije Git pod Izvorni kod Code Upravljanje: Git dodatak nije instaliran ili nije učitan. Ponovno ga instalirajte iz upravljati Jenkins > Dodaci, ponovno pokrenite Jenkinsi ponovno učitajte stranicu za konfiguraciju posla.
• „Nije uspjelo povezivanje s repozitorijem“ na javnoj URL: Git nedostaje iz Jenkins host. Instalirajte Git, a zatim potvrdite s git --version i zabilježite put ispod upravljati Jenkins > Alati.
• Autentifikacija nije uspjela na privatnom repozitoriju: Koristi se lozinka računa. Zamijenite je osobnim pristupnim tokenom kao što je gore opisano ili prebacite na SSH ključ.
• Izgradnja nikad ne počinje nakon guranja: ili Okidač hook-a na GitHubu potvrdni okvir nije označen ili GitHub ne može doći do Jenkins URLProvjerite zapisnik isporuke webhooka u postavkama repozitorija.
• Izgrađena je pogrešna grana: o Specifikacija grane još uvijek drži zadanu vrijednost */master dok repozitorij koristi mainAžurirajte specifikator da se podudara.
• Naplata je jučer radila, a danas ne uspijeva: Osobni pristupni token je dosegao datum isteka. Generirajte zamjenski i ažurirajte pohranjene vjerodajnice.

Također provjerite: Najbolje Jenkins Alternative (otvoreni kod i plaćeno) i CI/CD cjevovod vodič, koji se nadovezuje na ovdje uspostavljenu vezu.

Pitanja i odgovori