Τρόπος λήψης και εγκατάστασης Jenkins on Windows

Jenkins μπορεί να εγκατασταθεί είτε σε Windows ή πλατφόρμες Unix, αλλά αυτή η αναλυτική παρουσίαση εστιάζει στις Windows μόνο για εγκατάσταση. Το Windows Μητρώα εγκατάστασης MSI Jenkins ως Windows υπηρεσία και επιλέγει ένα 64-bit Java runtime για εσάς, γεγονός που το καθιστά την ταχύτερη διαδρομή προς έναν λειτουργικό διακομιστή αυτοματισμού. Πριν ανοίξετε το πρόγραμμα εγκατάστασης, επιβεβαιώστε ότι το μηχάνημά σας πληροί τις απαιτήσεις που αναφέρονται στην επόμενη ενότητα.

Jenkins Προαπαιτούμενα και απαιτήσεις συστήματος

Jenkins Είναι ελαφρύ σε κατάσταση ηρεμίας, αλλά αναπτύσσεται γρήγορα μόλις συσσωρευτεί το ιστορικό κατασκευής, οι χώροι εργασίας και τα πρόσθετα. Η σωστή διαμόρφωση του μηχανήματος στην αρχή αποφεύγει μια επώδυνη μετεγκατάσταση αργότερα.

Απαιτήσεις υλικού:

Απαιτήσεις λογισμικού:

• Jenkins τρέχει Java, άρα ένα υποστηριζόμενο Java Κιτ ανάπτυξης (JDK) ή Java Πρέπει να υπάρχει το περιβάλλον εκτέλεσης (JRE). Τρέχον Jenkins οι εκδόσεις απαιτούν Java 21 ή αργότερα; Java Τα 8, 11 και 17 δεν υποστηρίζονται πλέον από τη νεότερη γραμμή Μακροπρόθεσμης Υποστήριξης.
• Απαιτείται ένα σύγχρονο πρόγραμμα περιήγησης ιστού για την πρόσβαση στο Jenkins ταμπλό.
• Ένας λογαριασμός με δικαιώματα διαχειριστή στο Windows απαιτείται μηχάνημα για την καταχώριση του Jenkins υπηρεσία.

Επιβεβαιώστε την εγκατάσταση Java έκδοση από τη Γραμμή εντολών πριν συνεχίσετε. Εάν η εντολή αποτύχει ή αναφέρει μια έκδοση πριν από την 21, εγκαταστήστε πρώτα ένα υποστηριζόμενο JDK.

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

Τύποι έκδοσης

Jenkins δημοσιεύει δύο γραμμές έκδοσης και η επιλογή επηρεάζει τη συχνότητα αναβάθμισης.

Αυτή η αναλυτική παρουσίαση χρησιμοποιεί την έκδοση LTS, αν και η διαδικασία εγκατάστασης είναι ίδια με την εβδομαδιαία έκδοση. Με τις προϋποθέσεις που έχουν οριστεί, η λήψη μπορεί να ξεκινήσει.

Πως να κατεβάσω Jenkins?

Ακολουθήστε τα παρακάτω βήματα για να αποκτήσετε το Windows εγκαταστάτη και ολοκληρώστε μια επιτυχημένη εγκατάσταση:

Βήμα 1) Πηγαίνετε στο https://www.jenkins.io/download/ και επιλέξτε την πλατφόρμα. Στην περίπτωσή μας, Windows.

Βήμα 2) Μεταβείτε στη θέση λήψης στον τοπικό σας υπολογιστή και αποσυμπιέστε το ληφθέν πακέτο. Double-κάντε κλικ στο αποσυμπιεσμένο jenkins.msi αρχείο. Jenkins μπορεί επίσης να εκτελεστεί από ένα αρχείο WAR (Web application ARchive), αλλά αυτή η διαδρομή δεν συνιστάται σε Windows επειδή παραλείπει την εγγραφή υπηρεσίας που χειρίζεται ο εγκαταστάτης.

Σημείωση: Windows Το SmartScreen ενδέχεται να αναφέρει ότι εμπόδισε την εκκίνηση μιας άγνωστης εφαρμογής. Επιλέξτε Πληροφορίες, Τότε Τρέξτε ούτως ή άλλως, για να συνεχιστεί το υπογεγραμμένο Jenkins εγκαταστάτη.

Βήμα 3) Στο Jenkins Οθόνη ρύθμισης, κάντε κλικ στην επιλογή Επόμενο.

Βήμα 4) Επιλέξτε την τοποθεσία όπου το Jenkins θα πρέπει να εγκατασταθεί η παρουσία. Η προεπιλεγμένη τοποθεσία στα τρέχοντα προγράμματα εγκατάστασης 64-bit είναι C: \ Program Files \JenkinsΣημειώστε αυτήν τη διαδρομή, επειδή ο αρχικός κωδικός πρόσβασης διαχειριστή είναι αποθηκευμένος μέσα σε αυτήν. Κάντε κλικ στο Επόμενο.

Βήμα 5) Στη συνέχεια, το πρόγραμμα εγκατάστασης ζητά τα διαπιστευτήρια σύνδεσης της υπηρεσίας και τον αριθμό θύρας. Παρέχετε έναν αποκλειστικό τοπικό λογαριασμό ή λογαριασμό τομέα και κάντε κλικ στο Διαπιστευτήρια δοκιμής, στη συνέχεια ορίστε τη θύρα και κάντε κλικ Θύρα δοκιμής. Λιμάνι 8080 είναι η προεπιλογή. Εκτέλεση Jenkins κάτω από έναν επώνυμο λογαριασμό υπηρεσίας είναι ασφαλέστερο από την επιλογή LocalSystem, η οποία παρέχει Jenkins πλήρη πρόσβαση στο μηχάνημα.

Βήμα 6) Επιβεβαιώστε το Java στον αρχικό κατάλογο που εντοπίζει το πρόγραμμα εγκατάστασης, ελέγξτε τις επιλογές προσαρμοσμένης ρύθμισης και κάντε κλικ στο εγκαταστήστε κουμπί. Μόλις ολοκληρωθεί η εγκατάσταση, κάντε κλικ στο φινίρισμα.

Βήμα 7) Κατά τη διάρκεια της διαδικασίας εγκατάστασης, ενδέχεται να εμφανιστεί ένας πίνακας πληροφοριών που θα σας ενημερώνει ότι απαιτείται επανεκκίνηση στο τέλος της τρέχουσας εγκατάστασης. Κάντε κλικ στο OK κουμπί όταν εμφανιστεί ο πίνακας πληροφοριών.

Τα αρχεία βρίσκονται πλέον στον δίσκο και η υπηρεσία έχει καταχωρηθεί. Το επόμενο στάδιο ξεκλειδώνει τη διεπαφή ιστού.

Πώς να ξεμπλοκάρετε Jenkins?

Μετά την ολοκλήρωση του Jenkins στη φάση εγκατάστασης, ο ελεγκτής κλειδώνεται μέχρι να δώσετε έναν αυτόματα δημιουργημένο κωδικό πρόσβασης. Τα παρακάτω βήματα εξηγούν πώς να ξεμπλοκάρετε τον Jenkins εφαρμογή:

Βήμα 1) Αφού ολοκληρωθεί η διαδικασία εγκατάστασης, ανοίγει μια καρτέλα του προγράμματος περιήγησης και ζητά τον αρχικό κωδικό πρόσβασης διαχειριστή. Για να αποκτήσετε πρόσβαση Jenkins, μεταβείτε στην ακόλουθη διαδρομή στο πρόγραμμα περιήγησής σας στο web.
http://localhost:8080

Εάν η παραπάνω διεύθυνση φορτωθεί, η εγκατάσταση ολοκληρώθηκε με επιτυχία και η υπηρεσία εκτελείται.

Βήμα 2) Ο αρχικός κωδικός πρόσβασης διαχειριστή αποθηκεύεται στον Jenkins διαδρομή εγκατάστασης που ορίσατε στο Βήμα 4 της εγκατάστασης. Για την προεπιλεγμένη τοποθεσία C: \ Program Files \Jenkins, ένα αρχείο με όνομα αρχικός κωδικός πρόσβασης Admin βρίσκεται κάτω από C: \ Program Files \Jenkins\μυστικά. Εάν επιλέχθηκε μια προσαρμοσμένη διαδρομή, επιλέξτε αυτήν την τοποθεσία. Η ίδια τιμή εγγράφεται επίσης στο jenkins.err.log αρχείο στο Jenkins αρχικός κατάλογος.

Βήμα 3) Ανοίξτε το επιλεγμένο αρχείο και αντιγράψτε τα περιεχόμενά του αρχικός κωδικός πρόσβασης Admin αρχείο.

Βήμα 4) Επικολλήστε τον κωδικό πρόσβασης στο Κωδικός πρόσβασης διαχειριστή πεδίο στο Ξεκλείδωμα Jenkins σελίδα στο πρόγραμμα περιήγησής σας και κάντε κλικ στο ΣΥΝΕΧΕΙΑ κουμπί.

Με τον ελεγκτή ξεκλείδωτο, ο οδηγός εγκατάστασης προχωρά στα πρόσθετα και στον πρώτο λογαριασμό χρήστη.

Προσαρμόστε Jenkins

Μπορείτε επίσης να προσαρμόσετε το δικό σας Jenkins περιβάλλον χρησιμοποιώντας τα παρακάτω βήματα:

Βήμα 1) Κάντε κλικ στο Εγκαταστήστε προτεινόμενα πρόσθετα κουμπί έτσι ώστε Jenkins ανακτά και εγκαθιστά τα απαραίτητα πρόσθετα (plugins).

Jenkins ξεκινά η λήψη και εγκατάσταση όλων των πρόσθετων (plugins) που απαιτούνται για τη δημιουργία νέων Jenkins θέσεις εργασίας.

Σημείωση: Μπορείτε να επιλέξετε την επιλογή Επιλέξτε πρόσθετα για εγκατάσταση και επιλέξτε μόνο τα πρόσθετα που θέλετε. Τα πρόσθετα μπορούν να προστεθούν ή να αφαιρεθούν αργότερα από Διαχειριστείτε Jenkins > Πρόσθετα, επομένως αυτή η επιλογή δεν είναι μόνιμη.

Βήμα 2) Αφού εγκατασταθούν όλα τα προτεινόμενα πρόσθετα, το Δημιουργία πρώτου χρήστη διαχειριστή εμφανίζεται το πλαίσιο. Συμπληρώστε όλα τα πεδία με τα στοιχεία του επιθυμητού λογαριασμού και κάντε κλικ στο Αποθήκευση και Τέλος κουμπί.

Βήμα 3) Jenkins ζητάει τελικά την URL όπου θα προσπελαστεί η παρουσία. Αφήστε την προεπιλεγμένη τιμή για να αποφύγετε σύγχυση αργότερα. Εάν μια άλλη εφαρμογή χρησιμοποιεί ήδη τη θύρα 8080, δώστε μια διαφορετική θύρα εδώ και, στη συνέχεια, κάντε κλικ στο Αποθήκευση και συνέχεια κουμπί.

Συγχαρητήρια! Ένα νέο Jenkins ο διακομιστής είναι πλέον εγκατεστημένος. Κάντε κλικ στο Ξεκινήστε να χρησιμοποιείτε Jenkins κουμπί.

The Jenkins η παρουσία είναι ενεργοποιημένη και λειτουργική, έτοιμη για την πρώτη σας εργασία. Μια σύντομη Jenkins σεμινάριο για αρχάριους εξηγεί πώς να δημιουργήσετε αυτήν την εργασία.

Πώς να επαληθεύσετε το Jenkins Εγκατάσταση και Διαχείριση της Υπηρεσίας

Ένας πίνακας ελέγχου που φορτώνει μία φορά δεν αποτελεί απόδειξη μιας εύρυθμης εγκατάστασης. Επειδή το πρόγραμμα εγκατάστασης MSI καταχωρείται Jenkins ως Windows υπηρεσία, η υπηρεσία πρέπει να αντέξει σε μια επανεκκίνηση και να επανεκκινείται καθαρά κατόπιν αιτήματος. Επεξεργαστείτε τους παρακάτω ελέγχους αμέσως μετά το κλείσιμο του οδηγού εγκατάστασης.

1. Επιβεβαιώστε ότι η υπηρεσία υπάρχει. Τύπος Win + R, τύπου services.mscκαι πατήστε Enter. Εντοπίστε την καταχώρηση με το όνομα Jenkins και επιβεβαιώστε ότι η κατάσταση είναι Τρέξιμο και ο τύπος εκκίνησης διαβάζεται Αυτόματο.
2. Ελέγξτε τον λογαριασμό που χρησιμοποιείται. Άνοιγμα των ιδιοτήτων του Jenkins υπηρεσία και να ελέγξετε την συνδεθείτε με καρτέλα. Ένας αποκλειστικός λογαριασμός υπηρεσίας είναι προτιμότερος από το LocalSystem για οτιδήποτε πέρα ​​από τον τοπικό πειραματισμό.
3. Επαληθεύστε τη θύρα ακρόασης. τρέξιμο netstat -ano | findstr :8080 από τη Γραμμή Εντολών. Μια καταχώρηση ΑΚΡΟΑΣΗΣ επιβεβαιώνει ότι Jenkins κρατάει το λιμάνι.
4. Διαβάστε το banner της έκδοσης. Συνδεθείτε στο http://localhost:8080 και διαβάστε τον αριθμό έκδοσης στην κάτω δεξιά γωνία του πίνακα ελέγχου. Συγκρίνετέ τον με την έκδοση που κατεβάσατε.
5. Κάντε επανεκκίνηση μία φορά. επανεκκίνηση Windows και περιηγηθείτε ξανά στον πίνακα ελέγχου χωρίς να ξεκινήσετε τίποτα χειροκίνητα. Εάν η σελίδα φορτώσει, η υπηρεσία είναι πραγματικά αυτόματη.

Η υπηρεσία μπορεί επίσης να ελεγχθεί από μια αναβαθμισμένη γραμμή εντολών, η οποία είναι ταχύτερη από την γραφική κονσόλα και λειτουργεί καλά μέσα σε σενάρια ανάπτυξης:

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

💡 Συμβουλές: Ο σιωπηλός εγκαταστάτης αποδέχεται INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEκαι SERVICE_PASSWORD ως παρακάμψεις ιδιοτήτων. Οτιδήποτε δεν μεταβιβάζετε επιστρέφει στην προεπιλεγμένη τιμή του και σε αθόρυβη λειτουργία η υπηρεσία εκτελείται ως LocalSystem εκτός εάν παρέχεται λογαριασμός υπηρεσίας.

Εάν κάποιος από αυτούς τους ελέγχους αποτύχει, οι αιτίες είναι συνήθως προβλέψιμες, όπως δείχνει η επόμενη ενότητα.

Κοινός Jenkins Σφάλματα εγκατάστασης σε Windows και πώς να τα διορθώσετε

Οι περισσότεροι απέτυχαν Windows εγκαταστάσεις tracεπιστρέφουμε σε ένα μικρό σύνολο αιτιών: μια μη υποστηριζόμενη Java εκτέλεσης, μια κατειλημμένη θύρα ή ένας λογαριασμός υπηρεσίας που δεν έχει δικαίωμα σύνδεσης ως υπηρεσία. Κάθε ένα από αυτά προκαλεί ένα ξεχωριστό σύμπτωμα, επομένως η διόρθωση είναι συνήθως γρήγορη μόλις διαβαστεί προσεκτικά το μήνυμα.

• Μη έγκυρα διαπιστευτήρια σύνδεσης υπηρεσίας: Το πρόγραμμα εγκατάστασης απορρίπτει τον λογαριασμό κατά τη διάρκεια της Διαπιστευτήρια δοκιμής βήμα. Άνοιγμα secpol.msc, επεκτείνουν Τοπικές Πολιτικές > Εκχώρηση Δικαιωμάτων Χρήστη, Άνοιξε Συνδεθείτε ως υπηρεσίακαι προσθέστε τον λογαριασμό. Στη συνέχεια, δοκιμάστε ξανά τον έλεγχο διαπιστευτηρίων.
• Η θύρα 8080 χρησιμοποιείται ήδη: The Θύρα δοκιμής Το κουμπί γίνεται κόκκινο επειδή μια άλλη εφαρμογή, συχνά ένα τοπικό Tomcat ή ένας διακομιστής ανάπτυξης, κατέχει ήδη τη θύρα. Επιλέξτε μια ελεύθερη θύρα όπως η 8081 ή διακόψτε τη διεργασία που βρίσκεται σε διένεξη και αναγνωρίζεται από netstat -ano.
• Δεν υποστηρίζεται ή λείπει Java: Ο εγκαταστάτης δεν μπορεί να προσυμπληρώσει το Java στον αρχικό κατάλογο ή η υπηρεσία ξεκινά και σταματά αμέσως. Εγκαταστήστε ένα JDK 21 64-bit ή νεότερη έκδοση και, στη συνέχεια, κατευθύνετε το πρόγραμμα εγκατάστασης στον αρχικό κατάλογό του.
• Το SmartScreen μπλοκάρει το πρόγραμμα εγκατάστασης: Windows αναφέρει μια μη αναγνωρισμένη εφαρμογή. Επιλέξτε Πληροφορίες, Τότε Τρέξτε ούτως ή άλλως, αφού επιβεβαίωσε ότι το αρχείο προήλθε από την επίσημη Jenkins σελίδα λήψης.
• Το αρχείο initialAdminPassword δεν βρέθηκε: Επιλέχθηκε ένας προσαρμοσμένος κατάλογος εγκατάστασης. Δείτε μέσα στο secrets φάκελο αυτού του καταλόγου ή διαβάστε τον κωδικό πρόσβασης από jenkins.err.log στο Jenkins αρχικός κατάλογος.

Μια φορά Jenkins λειτουργεί αξιόπιστα, το επόμενο φυσικό βήμα είναι η σύνδεσή του με ένα αποθετήριο πηγαίου κώδικα και μια διοχέτευση κατασκευής. Οι οδηγίες στο Jenkins Ενσωμάτωση GitHub και την Σωλήνας CI/CD Εξηγήστε πώς η συνεχής ολοκλήρωση συναρμολογείται γύρω από αυτήν την εγκατάσταση.

Συχνές Ερωτήσεις