Come scaricare e installare Jenkins on Windows

Jenkins può essere installato su entrambi Windows o piattaforme Unix, ma questa guida si concentra su Windows solo installazione. L Windows Il programma di installazione MSI registra Jenkins come Windows servizio e seleziona un sistema a 64 bit Java Il runtime è a tua disposizione, il che lo rende il percorso più veloce per ottenere un server di automazione funzionante. Prima di aprire il programma di installazione, verifica che il tuo computer soddisfi i requisiti elencati nella sezione successiva.

Jenkins Prerequisiti e requisiti di sistema

Jenkins È leggero a riposo, ma cresce rapidamente una volta che si accumulano cronologia delle build, aree di lavoro e plugin. Dimensionare correttamente la macchina all'inizio evita una migrazione complessa in seguito.

Requisiti hardware:

Requisiti software:

• Jenkins gira su Java, quindi supportato Java Kit di sviluppo (JDK) o Java L'ambiente di runtime (JRE) deve essere presente. Corrente Jenkins rilasci richiedono Java 21 o successivo; Java I modelli 8, 11 e 17 non sono più supportati dalla nuova linea di assistenza a lungo termine.
• Per raggiungere il browser web moderno è necessario un browser web moderno Jenkins cruscotto.
• Un account con diritti amministrativi sul Windows è necessaria la macchina per registrare il Jenkins servizio.

Conferma l'installazione Java Prima di continuare, verifica la versione del JDK dal prompt dei comandi. Se il comando non riesce o segnala una versione inferiore alla 21, installa prima un JDK supportato.

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

Tipi di rilascio

Jenkins pubblica due linee di rilascio e la scelta influisce sulla frequenza degli aggiornamenti.

Questa guida si basa sulla versione LTS, sebbene il processo di installazione sia identico anche per la versione settimanale. Una volta soddisfatti i prerequisiti, è possibile avviare il download.

Come scaricare Jenkins?

Segui i passaggi seguenti per ottenere il Windows installatore e completare un'installazione corretta:

Passo 1) Vai su https://www.jenkins.io/download/ e selezionare la piattaforma. Nel nostro caso, Windows.

Passo 2) Accedete alla cartella di download sul vostro computer locale ed estraete il pacchetto scaricato. Double-clicca sul file decompresso jenkins.msi file. Jenkins può anche essere eseguito da un file WAR (Web application ARchive), ma questa strada non è consigliata su Windows perché salta la registrazione del servizio gestita dal programma di installazione.

Nota: Windows SmartScreen potrebbe segnalare di aver impedito l'avvio di un'applicazione non riconosciuta. Seleziona Ulteriori informazioni, poi Corri comunque, per continuare con il firmato Jenkins installatore.

Passo 3) Nel Jenkins Schermata di configurazione, fare clic Avanti.

Passo 4) Scegli il luogo in cui il Jenkins L'istanza dovrebbe essere installata. La posizione predefinita negli attuali programmi di installazione a 64 bit è C: \ Program Files \Jenkins. Prendi nota di questo percorso, perché al suo interno è memorizzata la password iniziale dell'amministratore. Fai clic Avanti.

Passo 5) Il programma di installazione richiede quindi le credenziali di accesso al servizio e il numero di porta. Fornire un account locale o di dominio dedicato e fare clic su Credenziali di prova, quindi imposta la porta e fai clic Porta di prova. Porta 8080 è l'impostazione predefinita. In esecuzione Jenkins sotto un account di servizio denominato è più sicuro dell'opzione LocalSystem, che garantisce Jenkins pieno accesso alla macchina.

Passo 6) Confermare la Java directory home che il programma di installazione rileva, rivedi le opzioni di configurazione personalizzate e fai clic su Installazione pulsante. Una volta completata l'installazione, fare clic Finitura.

Passo 7) Durante il processo di installazione, potrebbe apparire un pannello informativo per informarti che è necessario riavviare il sistema al termine dell'installazione corrente. Fai clic sul pannello informativo. OK premere il pulsante quando viene visualizzato il pannello informativo.

I file sono ora sul disco e il servizio è registrato. La fase successiva prevede lo sblocco dell'interfaccia web.

Come sbloccare Jenkins?

Dopo aver completato il Jenkins durante la fase di installazione, il controller è bloccato finché non si fornisce una password generata automaticamente. I passaggi seguenti spiegano come sbloccare il Jenkins applicazione:

Passo 1) Al termine del processo di installazione, si apre una scheda del browser che richiede la password iniziale dell'amministratore. Per raggiungere Jenkins, accedi al seguente percorso nel tuo browser web.
http://localhost:8080

Se l'indirizzo sopra indicato si carica, l'installazione è andata a buon fine e il servizio è in esecuzione.

Passo 2) La password iniziale dell'amministratore è memorizzata sotto Jenkins percorso di installazione impostato nel passaggio 4 dell'installazione. Per la posizione predefinita C: \ Program Files \Jenkins, un file chiamato password amministratore iniziale si trova sotto C: \ Program Files \Jenkinssegreti. Se è stato selezionato un percorso personalizzato, controlla invece quella posizione. Lo stesso valore viene anche scritto nel jenkins.err.log file nella Jenkins directory principale.

Passo 3) Apri il file evidenziato e copia il contenuto del password amministratore iniziale file.

Passo 4) Incolla la password nel Password dell'amministratore campo su Sblocca Jenkins pagina nel tuo browser e fai clic su Continua pulsante.

Una volta sbloccato il controller, la procedura guidata di configurazione passa ai plugin e al primo account utente.

Personalizzare Jenkins

Puoi anche personalizzare il tuo Jenkins ambiente seguendo i passaggi indicati di seguito:

Passo 1) Clicca su Installa i plugin consigliati pulsante in modo che Jenkins Recupera e installa i plugin essenziali.

Jenkins inizia a scaricare e installare tutti i plugin necessari per creare nuovi Jenkins posti di lavoro.

Nota: Puoi scegliere l'opzione Seleziona i plugin da installare e seleziona solo i plugin che desideri. I plugin possono essere aggiunti o rimossi in seguito da gestire Jenkins > Plugin, quindi questa scelta non è permanente.

Passo 2) Dopo aver installato tutti i plugin suggeriti, Crea il primo utente amministratore appare il pannello. Compila tutti i campi con i dettagli dell'account desiderati e fai clic su Salva e finisci pulsante.

Passo 3) Jenkins alla fine chiede il URL dove verrà raggiunta l'istanza. Lascia il valore predefinito per evitare confusione in seguito. Se un'altra applicazione utilizza già la porta 8080, specifica qui una porta diversa, quindi fai clic su Salva e continua pulsante.

Congratulazioni! Un nuovo Jenkins Il server è ora installato. Fai clic su Inizia a usare Jenkins pulsante.

Migliori Jenkins L'istanza è attiva e funzionante, pronta per il tuo primo lavoro. Un breve Jenkins tutorial per principianti spiega come creare quel lavoro.

Come verificare il Jenkins Installazione e gestione del servizio

Una dashboard che si carica una volta non è prova di un'installazione sana. Poiché il programma di installazione MSI registra Jenkins come Windows Il servizio deve sopravvivere a un riavvio e riavviarsi correttamente su richiesta. Eseguire i controlli seguenti immediatamente dopo la chiusura della procedura guidata di installazione.

1. Conferma che il servizio esiste. Stampa Win + R, Il tipo di services.msce premi Invio. Individua la voce denominata Jenkins e confermare che lo stato sia corsa e il tipo di avvio legge Automatico.
2. Verifica l'account in uso. Apri le proprietà del Jenkins servizio e revisione Accedi scheda. Per qualsiasi attività che vada oltre la sperimentazione locale, è preferibile utilizzare un account di servizio dedicato anziché LocalSystem.
3. Verificare la porta di ascolto. Correre netstat -ano | findstr :8080 dal prompt dei comandi. Una voce LISTENING conferma che Jenkins detiene il porto.
4. Leggi il banner della versione. Accedi a http://localhost:8080 e leggi il numero di versione nell'angolo in basso a destra della dashboard. Confrontalo con la versione che hai scaricato.
5. Riavviare una volta. Restart Windows e accedere nuovamente alla dashboard senza avviare nulla manualmente. Se la pagina si carica, il servizio è effettivamente automatico.

Il servizio può essere controllato anche tramite un prompt dei comandi con privilegi elevati, che è più veloce della console grafica e funziona bene all'interno degli script di distribuzione:

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

Suggerimento: Il programma di installazione silenzioso accetta INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEe SERVICE_PASSWORD come override delle proprietà. Tutto ciò che non viene passato torna al suo valore predefinito e, in modalità silenziosa, il servizio viene eseguito come LocalSystem a meno che non venga fornito un account di servizio.

Se uno qualsiasi di questi controlli fallisce, le cause sono generalmente prevedibili, come illustrato nella sezione successiva.

Uncommon Jenkins Errori di installazione su Windows e come risolverli

La maggior parte ha fallito Windows impianti trace tornare a un piccolo insieme di cause: un non supportato Java Il problema può essere dovuto a un errore di runtime, a una porta occupata o a un account di servizio privo dei diritti necessari per accedere come servizio. Ognuno di questi problemi produce un sintomo distinto, quindi la soluzione è solitamente rapida una volta letto attentamente il messaggio.

• Credenziali di accesso al servizio non valide: Il programma di installazione rifiuta l'account durante l' Credenziali di prova passo. Apri secpol.msc, espandi Criteri locali > Assegnazione dei diritti utente, Aperto Accedi come servizioe aggiungi l'account. Quindi riprova il test delle credenziali.
• La porta 8080 è già in uso: Migliori Porta di prova Il pulsante diventa rosso perché un'altra applicazione, spesso un Tomcat locale o un server di sviluppo, sta già occupando la porta. Scegli una porta libera come la 8081 oppure interrompi il processo in conflitto identificato da netstat -ano.
• Non supportato o mancante Java: L'installatore non può precompilare il Java directory home, oppure il servizio si avvia e si arresta immediatamente. Installa un JDK a 64 bit 21 o versioni successive, quindi indica al programma di installazione la sua directory home.
• SmartScreen blocca il programma di installazione: Windows segnala un'applicazione non riconosciuta. Seleziona Ulteriori informazioni, poi Corri comunque, dopo aver confermato che il file proveniva dall'ufficiale Jenkins pagina di download.
• File initialAdminPassword non trovato: È stata scelta una directory di installazione personalizzata. Guarda all'interno della secrets cartella di quella directory, oppure leggere la password da jenkins.err.log nella Jenkins directory principale.

Quando Jenkins Se funziona in modo affidabile, il passo successivo naturale è collegarlo a un repository sorgente e a una pipeline di compilazione. Le guide su Jenkins Integrazione con GitHub e Conduttura CI/CD Spiega come viene implementata l'integrazione continua attorno a questa installazione.

DOMANDE FREQUENTI