Come creare un nuovo lavoro di compilazione in Jenkins Progetto stile libero

⚡ Riepilogo intelligente

Jenkins Freestyle Project è un lavoro di compilazione ripetibile che raggruppa il checkout del codice sorgente, le fasi di compilazione e le azioni post-compilazione in un'unica attività configurabile, creata interamente tramite Jenkins interfaccia web senza scrivere codice pipeline.

  • 🔘 Definizione: Un lavoro freestyle è Jenkins' tipo di progetto generico, configurato tramite moduli anziché un Jenkinsfile.
  • ☑️ Prerequisiti: Una corsa Jenkins Innanzitutto sono necessari un controller, un JDK sull'agente di compilazione, il plugin Git e un repository raggiungibile.
  • ✅ Dieci passi: Accedi, crea un nuovo elemento, assegnagli un nome, imposta il repository, aggiungi una fase di compilazione, salva, esegui la compilazione e leggi l'output della console.
  • 🧪 Esempio pratico: Un progetto HelloWorld scaricato da GitHub viene compilato con javac e viene eseguito con java all'interno di un Windows Fase di compilazione in batch.
  • ️ Mappa di configurazione: Sei sezioni del modulo: Generale, Fonte Code Gestione, trigger di compilazione, ambiente di compilazione, fasi di compilazione e azioni post-compilazione: ogni opzione è coperta.
  • ⚙️ Limite di portata: I lavori freestyle si prestano all'automazione di singole attività; i lavori di consegna a più fasi, invece, si adattano meglio a un processo Pipeline con controllo di versione.

Come creare un nuovo lavoro di compilazione in Jenkins Progetto stile libero

Che cos'è un Jenkins Progetto di freestyle?

Jenkins Progetto stile libero è un processo di compilazione ripetibile, uno script o una pipeline che contiene passaggi e azioni post-compilazione. È un processo o un'attività migliorata che può estendersi su più operazioni. Consente di configurare i trigger di compilazione e offre sicurezza basata sul progetto per il tuo Jenkins progetto. Offre anche plugin per aiutarti a creare passaggi e azioni post-compilazione.

I tipi di azioni che puoi eseguire in un Jenkins La fase di compilazione o l'azione post-compilazione sono piuttosto limitate. Sono disponibili molti plugin standard all'interno di un Jenkins Freestyle Project ti aiuterà a superare questo problema.

Il diagramma sottostante colloca il lavoro freestyle all'interno del più ampio integrazione continua Il ciclo, dal prelievo del codice sorgente fino alle azioni post-compilazione che riportano il risultato.

Passaggi per creare un lavoro in Jenkins Progetto stile libero
Come creare un lavoro in Jenkins

Prerequisiti per la creazione di un Jenkins Lavoro freestyle

Prima che i dieci passaggi seguenti funzionino correttamente, è necessario che siano presenti quattro elementi. La mancanza di uno qualsiasi di questi è solitamente la ragione per cui un primo tentativo di costruzione freestyle fallisce con una palla rossa anziché blu.

  • Una corsa Jenkins controllore. Jenkins ascolta sulla porta 8080 per impostazione predefinita. Se Jenkins non è ancora in esecuzione, segui il procedura di installazione prima.
  • Un JDK sulla macchina che esegue la compilazione. L'esempio svolto compila Java, Così javac deve trovarsi nel PERCORSO del controller o dell'agente che esegue il lavoro. Conferma questo con una riga java -version Fase di compilazione prima di aggiungere qualsiasi altra cosa.
  • Il plugin Git. Migliori Idiota l'opzione appare solo sotto Sorgente Code Gestione una volta installato il plugin, tramite gestire Jenkins > Plugin.
  • Un archivio accessibile. Un HTTPS pubblico URL non richiede credenziali. Un repository privato richiede una credenziale memorizzata in Jenkins Innanzitutto, altrimenti il ​​checkout fallisce durante la primissima build.

Un account con il Lavoro/Crea È necessaria anche l'autorizzazione — su un nuovo utente singolo Jenkins L'account amministratore lo possiede già.

Come creare un nuovo lavoro di compilazione in Jenkins

Il lavoro di costruzione freestyle è un'opzione altamente flessibile e facile da usare. Puoi usarlo per qualsiasi tipo di progetto; è facile da configurare e molte delle sue opzioni compaiono in altri lavori di costruzione. Di seguito è riportato un processo passo passo per creare un lavoro Jenkins.

Passaggio 1) Accedi a Jenkins

Per creare un' Jenkins lavoro freestyle, accedi al tuo Jenkins dashboard visitando il tuo Jenkins percorso di installazione. Di solito, verrà ospitato su localhost all'indirizzo http://localhost:8080 Se ancora non avete partecipato installato Jenkins in un altro percorso, utilizzare l'appropriato URL per accedere alla dashboard come mostrato di seguito Jenkins Esempio di creazione di un posto di lavoro.

Jenkins cruscotto raggiunto al Jenkins percorso di installazione dopo l'accesso

Passaggio 2) Crea un nuovo elemento

Clicca su "Nuovo elemento" in alto a sinistra della dashboard. Lo screenshot qui sotto mostra dove si trova quel link.

Nuovo collegamento elemento in alto a sinistra Jenkins cruscotto

Passaggio 3) Inserisci i dettagli dell'articolo

Nella schermata successiva,

  1. Inserisci il nome dell'elemento che desideri creare. Utilizzeremo "Hello world" per questa demo.
  2. Seleziona il progetto Freestyle
  3. Fare clic su OK

Casella del nome dell'elemento con progetto Freestyle selezionato prima di fare clic su OK

Passaggio 4) Inserisci i dettagli del progetto

Inserisci i dettagli del progetto che desideri testare. La pagina di configurazione che si aprirà è mostrata di seguito.

Dettagli del progetto inseriti su Jenkins pagina di configurazione del lavoro freestyle

Passaggio 5) Accedere al repository URL

Sotto la fonte Code Gestione, inserisci il tuo repository URLAbbiamo un repository di test situato a https://github.com/kriru/firstJava.git

Fonte Code Sezione di gestione con il repository di test Git URL inserito

È anche possibile utilizzare un repository locale.

Se il tuo repository GitHub è privato, Jenkins Verificherò prima le tue credenziali di accesso con GitHub e solo successivamente scaricherò il codice sorgente dal tuo repository GitHub.

Passaggio 6) Modificare le impostazioni

Ora che hai fornito tutti i dettagli, è il momento di creare il codice. Modifica le impostazioni sotto costruire sezione per creare il codice nel momento desiderato. Puoi anche programmare la creazione in modo che avvenga periodicamente, a orari prestabiliti.

In costruzione,

  1. Clicca su "Aggiungi fase di creazione".
  2. Clicca su "Eseguire Windows comando batch" e aggiungi i comandi che desideri eseguire durante il processo di compilazione.

Il menu a tendina che elenca le fasi di compilazione disponibili si presenta in questo modo.

Il menu a tendina "Aggiungi fase di compilazione" si è aperto nella pagina di configurazione del job freestyle.

⚠️ Nota sulla versione: recente Jenkins rilasci etichettano quest'area Costruisci passaggi anziché Costruiamoe su Linux o macOS agenti l'opzione equivalente è Esegui shellIl pulsante si chiama ancora Aggiungi fase di creazione.

Qui ho aggiunto i comandi Java per compilare il codice Java.

Ho aggiunto i seguenti comandi di Windows:

javac HelloWorld.java
java HelloWorld

La finestra di comando con le due righe inserite è mostrata di seguito.

Eseguire Windows Casella di comando batch contenente i comandi javac e java

Passaggio 7) Salvare il progetto

Una volta inseriti tutti i dati,

  1. Clicchi APPLICA
  2. Salva il progetto.

Passaggio 8) Crea il codice sorgente

Ora, nella schermata principale, fai clic sul pulsante Crea ora sul lato sinistro per creare il codice sorgente.

Il pulsante "Crea ora" si trova sul lato sinistro della schermata del progetto freestyle.

Passaggio 9) Controlla lo stato

Dopo aver fatto clic su Crea ora, puoi visualizzare lo stato della build eseguita in Cronologia build.

Pannello Cronologia build che mostra lo stato della build freestyle eseguita

Passaggio 10) Visualizza l'output della console

Fai clic sul numero di build e poi su output della console per visualizzare lo stato della build in esecuzione. Dovrebbe essere visualizzato un messaggio di successo, a condizione che tu abbia seguito correttamente la procedura di configurazione come mostrato di seguito. Jenkins esempio di creazione di un nuovo lavoro.

Schermata di output della console che mostra il messaggio di successo per la compilazione completata

In sintesi, abbiamo eseguito un programma HelloWorld ospitato su GitHub. Jenkins preleva il codice dal repository remoto e lo compila continuamente con una frequenza definita dall'utente.

Jenkins Spiegazione delle sezioni di configurazione del progetto Freestyle

La procedura descritta sopra illustra solo i campi necessari all'esempio HelloWorld. La pagina di configurazione è suddivisa in sei sezioni e sapere cosa contiene ciascuna di esse rende molto più facile trovare le opzioni rimanenti.

Sezione Cosa controlla Impostazione tipica
General Descrizione del lavoro, eliminazione delle build obsolete, parametri e se il lavoro viene eseguito su un agente specifico Descriptione più un limite di ritenzione della costruzione
Fonte Code Management Quale repository controllare e con quali credenziali e ramo Git, un HTTPS URL, ramo */master or */main
Trigger di build Cosa avvia automaticamente la build? Interroga il sistema di controllo versione, esegui una build periodica o un webhook da GitHub
Ambiente di costruzione Avvolgimenti applicati attorno all'intera struttura Elimina l'area di lavoro prima dell'avvio della build; aggiungi i timestamp al log della console.
Costruisci passaggi I comandi che svolgono il lavoro vanno dall'alto verso il basso Eseguire Windows comando batch o esegui shell
Azioni post-compilazione Cosa succede dopo che le fasi sono terminate, qualunque sia il risultato? Archirecuperare gli artefatti, pubblicare un rapporto di prova, inviare un'e-mail

Due abitudini ti risparmiano un sacco di debug in seguito. Aggiungi i passaggi di compilazione nell'ordine in cui devono essere eseguiti, perché Jenkins Elabora i file dall'alto verso il basso e si ferma al primo errore. Quindi archivia tutto ciò che la build produce come azione post-compilazione, poiché l'area di lavoro viene riutilizzata dalla build successiva, mentre gli artefatti archiviati vengono conservati per ogni numero di build.

Freestyle Project o Pipeline: quale scegliere?

Freestyle non è l'unico tipo di progetto nella schermata Nuovo elemento e non è sempre quello giusto. La tabella seguente lo confronta con un Lavoro di oleodotto sui punti che determinano la maggior parte delle scelte reali.

Punto di confronto Progetto Freestyle Conduttura
Come viene definito moduli web memorizzati nel lavoro config.xml sul controller A Jenkinsfile inserito insieme al codice dell'applicazione
Cambia la storia Tenuto da Jenkins, al di fuori del tuo repository Revvisualizzato e versionato come qualsiasi altro file sorgente
Fasi e lavoro parallelo Un unico elenco piatto di passaggi di costruzione Fasi denominate, ramificazioni parallele e vista della fase
Curva di apprendimento Non è necessario alcuno script Richiede la sintassi dichiarativa della pipeline
miglior vestibilità Una compilazione, uno script, un'attività pianificata o un apprendimento Jenkins Flussi di compilazione, test e distribuzione a più fasi in diversi ambienti.

Una regola pratica: usa lo stile libero mentre il lavoro è un singolo compito e stai ancora imparando lo strumento e sposta il lavoro in un Conduttura CI/CD non appena cresce una seconda fase o deve essere rivisto insieme al codice. I team che si accoppiano Jenkins con gli strumenti di build spesso si raggiunge rapidamente quel punto — un Maven e Selenium setup è un fattore scatenante comune per l'interruttore, e lo stesso ragionamento si applica a qualsiasi test di automazione suite che si articola in diverse fasi.

DOMANDE FREQUENTI

L'output della console indica la causa. Le tre cause più comuni sono: javac mancante nel PATH dell'agente, un repository privato senza credenziali memorizzate e un nome di ramo errato. Correggi la riga segnalata, quindi esegui nuovamente la compilazione.

Apri Trigger di compilazione e seleziona Costruisci periodicamente, quindi inserisci la sintassi cron come H 2 * * * per una corsa notturna. H distribuisce il carico nell'arco dell'ora. Sondaggio SCM utilizza la stessa sintassi ma viene compilato solo quando il repository è cambiato.

Scegli Esegui shell dal menu Aggiungi passaggio di compilazione anziché Esegui Windows Comando batch. L'opzione mostrata dipende dal sistema operativo del controller o dell'agente a cui è collegato il job, non dal sistema operativo del tuo computer.

Conserva il token o la chiave SSH una volta gestire Jenkins > Credenziali, quindi selezionalo dal menu a discesa Credenziali nella Sorgente Code Sezione di gestione. Jenkins Lo convalida prima del checkout, quindi una credenziale errata fa fallire immediatamente la build.

Gli strumenti di machine learning leggono i log della console e raggruppano gli errori ripetuti, distinguendo un vero errore di compilazione da un agente instabile o da un timeout. Questa analisi preliminare ti indirizza alla riga rilevante, evitando di dover scorrere manualmente un lungo file di log.

Copilota GitHub Genera lo script batch o shell all'interno di una fase di compilazione e la sua interfaccia a riga di comando può riassumere un log di console non riuscito. Non può procedere passo passo nel modulo di configurazione, quindi è necessario rivedere ogni comando generato prima di salvarlo.

Aggiungi Archive gli artefatti come azione post-compilazione e assegnale uno schema come **/*.class. ArchiI file ved vengono memorizzati per numero di build, quindi permangono anche se l'area di lavoro viene riutilizzata o eliminata dalla successiva esecuzione.

ogni lavoro vive in JENKINS_HOME/jobs/<job-name>, con le impostazioni del modulo in config.xml e ciascuno eseguito sotto builds/È sufficiente eseguire il backup di quella cartella per spostare o ripristinare il lavoro.

Riassumi questo post con: