Jak vytvořit novou stavební úlohu v Jenkins Freestyle projekt

Od: Thomas Hamilton Thomas Hamilton
Hours aktualizováno

⚡ Chytré shrnutí

Jenkins Freestyle Project je opakovatelná úloha sestavení, která spojuje kontrolu zdrojového kódu, kroky sestavení a akce po sestavení do jedné konfigurovatelné úlohy, vytvořené výhradně prostřednictvím... Jenkins webové rozhraní bez nutnosti psaní kódu pro pipeline.

  • 🔘 Definice: Práce ve volném stylu je Jenkins'univerzální typ projektu, konfigurovaný pomocí formulářů, nikoli Jenkinssoubor.
  • ☑️ Předpoklady: Běh Jenkins Nejprve je vyžadován kontroler, JDK na agentu sestavení, plugin Git a dostupný repozitář.
  • (Tj. Deset kroků: Přihlaste se, vytvořte novou položku, pojmenujte ji, nastavte repozitář, přidejte krok sestavení, uložte ji, sestavte a přečtěte si výstup z konzole.
  • 🧪 Zpracovaný příklad: Projekt HelloWorld stažený z GitHubu se kompiluje s javac a běží s Javou uvnitř Windows krok dávkové sestavy.
  • 🛠️ Konfigurační mapa: Šest sekcí formuláře – Obecné, Zdroj Code Správa, Spouštěče sestavení, Prostředí sestavení, Kroky sestavení a Akce po sestavení – pokryjte všechny možnosti.
  • ⚙️ Omezení rozsahu: Volné styly úloh se hodí k automatizaci jednotlivých úkolů; vícestupňové doručování patří spíše do úlohy Pipeline s řízením verzí.
Přečíst více

Jak vytvořit novou stavební úlohu v Jenkins Freestyle projekt

Co je to Jenkins Freestyle projekt?

Jenkins Freestyle projekt je opakovatelná úloha sestavení, skript nebo kanál, který obsahuje kroky a akce po sestavení. Jedná se o vylepšenou úlohu nebo úkol, který může zahrnovat více operací. Umožňuje konfigurovat spouštěče sestavení a nabízí zabezpečení založené na projektu. Jenkins projekt. Nabízí také pluginy, které vám pomohou s kroki a akcemi po sestavení.

Typy akcí, které můžete provádět v Jenkins krok sestavení nebo akce po sestavení jsou poměrně omezené. V rámci Jenkins Freestyle Project vám pomůže tento problém překonat.

Níže uvedený diagram umisťuje freestyle práci do širšího průběžná integrace smyčka, od kontroly zdrojového kódu až po akce po sestavení, které hlásí výsledek.

Kroky k vytvoření pracovní pozice v Jenkins Freestyle projekt
Jak vytvořit pracovní místo v Jenkins

Předpoklady pro vytvoření Jenkins Práce ve volném stylu

Než bude deset kroků níže fungovat dokonale, musí být splněny čtyři věci. Chybějící jedna z nich je obvyklým důvodem, proč se první freestyle sestavení nezdaří s červeným míčkem místo modrého.

  • Běh Jenkins regulátor. Jenkins ve výchozím nastavení naslouchá na portu 8080. Pokud Jenkins zatím neběží, sledujte návod k instalaci .
  • JDK na počítači, na kterém se spouští sestavení. Zpracovaný příklad se zkompiluje Java, Takže javac musí být v cestě PATH kontroleru nebo agenta, který úlohu spouští. Potvrďte to jednořádkovým příkazem java -version krok sestavení před přidáním čehokoli dalšího.
  • Plugin pro Git. Jedno Git Možnost se zobrazí pouze v části Zdroj Code Správa po instalaci pluginu prostřednictvím Řídit Jenkins > Pluginy.
  • Dosažitelné úložiště. Veřejný HTTPS URL nepotřebuje žádné přihlašovací údaje. Soukromý repozitář potřebuje přihlašovací údaje uložené v Jenkins nejdříve, jinak se checkout nezdaří během úplně prvního sestavení.

Účet u Úloha/Vytvořit je také potřeba povolení – na novém jednouživatelském účtu Jenkins Účet administrátora to už má.

Jak vytvořit novou stavební úlohu v Jenkins

Freestyle build job je vysoce flexibilní a snadno použitelná možnost. Můžete jej použít pro jakýkoli typ projektu; snadno se nastavuje a mnoho jeho možností se objevuje v jiných úlohách sestavení. Níže je uveden postup vytvoření úlohy krok za krokem Jenkins.

Krok 1) Přihlášení Jenkins

Vytvoření Jenkins freestyle práce, přihlaste se ke svému Jenkins ovládací panel návštěvou Jenkins instalační cesta. Obvykle bude hostována na localhostu na adrese http://localhost:8080 Pokud máte instalovány Jenkins v jiné cestě použijte odpovídající URL pro přístup k vašemu řídicímu panelu, jak je znázorněno níže Jenkins příklad vytváření pracovních míst.

Jenkins palubní deska dosažená na Jenkins instalační cesta po přihlášení

Krok 2) Vytvořte novou položku

Klikněte na "Nový předmět„v levém horním rohu řídicího panelu.“ Snímek obrazovky níže ukazuje, kde se tento odkaz nachází.

Odkaz Nová položka v levém horním rohu Jenkins přístrojová deska

Krok 3) Zadejte podrobnosti o položce

Na další obrazovce

  1. Zadejte název položky, kterou chcete vytvořit. Pro toto demo použijeme „Ahoj světe“.
  2. Vyberte projekt Freestyle
  3. Klikněte na OK

Pole s názvem položky s vybraným projektem Freestyle před kliknutím na OK

Krok 4) Zadejte podrobnosti o projektu

Zadejte podrobnosti o projektu, který chcete otestovat. Otevře se konfigurační stránka, která je zobrazena níže.

Detaily projektu zadané na Jenkins konfigurační stránka freestyle úlohy

Krok 5) Vstupte do repozitáře URL

V části Zdroj Code Správa, Vstupte do svého repozitáře URLMáme testovací repozitář umístěný na adrese https://github.com/kriru/firstJava.git

Zdroj Code Sekce pro správu s testovacím repozitářem Git URL Zadáno

Je také možné použít místní úložiště.

Pokud je váš repozitář GitHub soukromý, Jenkins nejprve ověří vaše přihlašovací údaje pomocí GitHubu a teprve poté stáhne zdrojový kód z vašeho repozitáře GitHub.

SOUVISEJÍCÍ ČLÁNKY

Krok 6) Upravte nastavení

Nyní, když jste zadali všechny podrobnosti, je čas sestavit kód. Upravte nastavení v sekci stavět sekce pro vytvoření kódu v požadovaný čas. Můžete dokonce naplánovat sestavení tak, aby probíhalo pravidelně v nastavenou dobu.

Ve výstavbě,

  1. Klikněte na "Přidat krok sestavení"
  2. Klikněte na "Provést Windows dávkový příkaz“ a přidejte příkazy, které chcete provést během procesu sestavení.

Rozbalovací nabídka se seznamem dostupných kroků sestavení vypadá takto.

Na stránce konfigurace úlohy Freestyle se otevřel rozbalovací seznam pro přidání kroku sestavení.

⚠️ Poznámka k verzi: nedávný Jenkins vydání označují tuto oblast Budujte kroky spíše než Vytvořita na Linuxu nebo macOS agenti ekvivalentní možností je Spustit shellTlačítko se stále nazývá Přidat krok sestavení.

Zde jsem přidal příkazy java pro kompilaci kódu java.

Přidal jsem následující příkazy systému Windows:

javac HelloWorld.java
java HelloWorld

Příkazové pole s těmito dvěma zadanými řádky je zobrazeno níže.

Provést Windows příkazové pole dávkového příkazu obsahující příkazy javac a java

Krok 7) Uložte projekt

Když zadáte všechna data,

  1. klikněte Přihláška
  2. Uložit projekt.

Krok 8) Vytvořte zdrojový kód

Nyní na hlavní obrazovce klikněte na tlačítko Build Now na levé straně a vytvořte zdrojový kód.

Tlačítko Sestavit nyní na levé straně obrazovky projektu ve freestyle

Krok 9) Zkontrolujte stav

Po kliknutí na Build now uvidíte stav sestavení, které spustíte, v části Historie sestavení.

Panel historie sestavení zobrazující stav spuštěného freestyle sestavení

Krok 10) Podívejte se na výstup konzoly

Klikněte na číslo sestavení a poté klikněte na výstup konzole, abyste viděli stav spuštěného sestavení. Mělo by se zobrazit hlášení o úspěchu, pokud jste správně provedli nastavení, jak je znázorněno níže. Jenkins příklad vytvoření nové práce.

Výstupní obrazovka konzole zobrazující zprávu o úspěšném dokončení sestavení

Stručně řečeno, spustili jsme program HelloWorld hostovaný na GitHubu. Jenkins stahuje kód ze vzdáleného repozitáře a průběžně jej sestavuje s frekvencí, kterou definujete.

Jenkins Vysvětlení sekcí konfigurace projektu Freestyle

Výše uvedený návod se dotýká pouze polí, která příklad HelloWorld potřebuje. Samotná konfigurační stránka je rozdělena do šesti sekcí formuláře a znalost toho, co každá z nich vlastní, značně usnadňuje nalezení zbývajících možností.

Sekce Co ovládá Typické nastavení
obecně Popis úlohy, zahození starých sestavení, parametry a to, zda úloha běží na konkrétním agentovi. Description plus limit pro udržení sestavení
Zdroj Code management Který repozitář si ověřit a s jakými přihlašovacími údaji a pobočkou Git, HTTPS URL, větev */master or */main
Sestavte spouštěče Co automaticky spustí sestavení Dotazování SCM, pravidelné sestavování nebo webhook z GitHubu
Prostředí pro sestavení Obálky aplikované kolem celé sestavy Před zahájením sestavení smazat pracovní prostor; přidat časová razítka do protokolu konzole
Budujte kroky Příkazy, které vykonávají práci, běží odshora dolů Provést Windows dávkový příkaz nebo spuštění shellu
Akce po sestavení Co se stane po dokončení kroků, ať už je výsledek jakýkoli Archimít artefakty, publikovat testovací zprávu, poslat e-mail

Dva návyky ušetří spoustu ladění později. Přidejte kroky sestavení v pořadí, v jakém se musí spustit, protože Jenkins zpracuje je odshora dolů a zastaví se při prvním selhání. Poté archivuje vše, co sestavení vygeneruje, jako akci po sestavení, protože pracovní prostor je znovu použit dalším sestavením, zatímco archivované artefakty jsou uchovávány podle čísla sestavení.

Freestyle Project vs. Pipeline: Který byste měli použít?

Freestyle není jediný typ projektu na obrazovce Nová položka a ne vždy je to ten správný. Níže uvedená tabulka jej porovnává s... Práce s potrubím v bodech, které rozhodují o většině skutečných rozhodnutí.

Bod srovnání Freestyle projekt Potrubí
Jak je definována Webové formuláře uložené v souboru úlohy config.xml na ovladači A Jenkinssoubor potvrzený kódem aplikace
Historie změn Držen Jenkinsmimo váš repozitář Revprohlíženo a verzováno jako jakýkoli jiný zdrojový soubor
Fáze a paralelní práce Jeden plochý seznam kroků sestavení Pojmenované fáze, paralelní větve a zobrazení fáze
Křivka učení Není potřeba žádné skriptování Vyžaduje deklarativní syntaxi kanálu
Nejlépe sedí Jedna kompilace, jeden skript, jedna naplánovaná úloha nebo učení Jenkins Vícestupňové postupy sestavování, testování a nasazení napříč prostředími

Praktické pravidlo: sáhněte po freestyle, dokud se jedná o jednorázový úkol a stále se učíte používat nástroj, a práci přesuňte do CI/CD potrubí jakmile dosáhne druhé fáze nebo je potřeba jej zkontrolovat spolu s kódem. Týmy, které se spojují Jenkins s nástroji pro tvorbu se často dosáhnou tohoto bodu rychle – a Maven a Selenium Nastavení je běžným spouštěčem pro přepnutí a stejné zdůvodnění platí pro jakékoli testování automatizace sada, která probíhá v několika fázích.

Nejčastější dotazy

Výstup konzole uvádí příčinu. Tři běžné příčiny jsou chybějící javac v cestě agenta PATH, privátní repozitář bez uložených přihlašovacích údajů a nesprávný název větve. Opravte nahlášený řádek a poté znovu spusťte příkaz Build Now.

Otevřete Spouštěče sestavení a zaškrtněte Pravidelně sestavujtea poté zadejte syntaxi cronu, například H 2 * * * na noční běh. H rozkládá zátěž po celou hodinu. Anketa SCM používá stejnou syntaxi, ale sestavuje se pouze při změně repozitáře.

Vybrat Spustit shell z nabídky Přidat krok sestavení namísto Spustit Windows dávkový příkaz. Zobrazená možnost závisí na operačním systému řadiče nebo agenta, ke kterému je úloha vázána, nikoli na vašem vlastním počítači.

Uložte token nebo SSH klíč jednou pod Řídit Jenkins > Pověřenía poté jej vyberte z rozbalovací nabídky Pověření v nabídce Zdroj Code Sekce managementu. Jenkins ověří to před odesláním, takže špatné přihlašovací údaje okamžitě selžou při sestavení.

Nástroje strojového učení čtou protokoly konzole a clusterují opakované chyby, čímž oddělují skutečnou chybu kompilace od nespolehlivého agenta nebo časového limitu. Toto třídění vás nasměruje na jeden důležitý řádek, namísto ručního procházení dlouhého protokolu.

GitHub Copilot vytváří dávkový nebo shellový skript v kroku sestavení a jeho rozhraní CLI může shrnout protokol neúspěšné konzole. Nelze proklikat konfigurační formulář, proto si před uložením zkontrolujte každý vygenerovaný příkaz.

přidat Archive artefaktech jako akci po sestavení a přidat jí vzor, ​​například **/*.class. ArchiSoubory ved se ukládají podle čísla sestavení, takže přežijí i opětovné použití nebo vyčištění pracovního prostoru při dalším spuštění.

Každá práce žije v JENKINS_HOME/jobs/<job-name>s nastavením formuláře v config.xml a každý běh pod builds/Zálohování této složky stačí k přesunutí nebo obnovení úlohy.

Shrňte tento příspěvek takto: