Jenkins Ενσωμάτωση GitHub: Πώς να εγκαταστήσετε το πρόσθετο Git;

Έχετε ήδη μάθει τι Jenkins είναι και πώς να εγκαταστήστε το σε ένα Windows σύστημαΥποθέτοντας ότι αυτά τα βασικά βήματα έχουν ολοκληρωθεί, θα προχωρήσουμε τώρα στη διαχείριση πρόσθετων (plugins).

Jenkins έχει εξαιρετική υποστήριξη plugin. Πάνω από χίλια plugin εφαρμογών τρίτων είναι διαθέσιμα. Για να ελέγξετε αν Jenkins υποστηρίζει την εφαρμογή τρίτου κατασκευαστή που έχετε κατά νου, αναζητήστε τον κατάλογο πρόσθετων στη διεύθυνση https://plugins.jenkins.io/.

Εγκατάσταση πρόσθετων (plugins) σε Jenkins

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

Το GitHub είναι ένα διαδικτυακό αποθετήριο κώδικα που παίζει σημαντικό ρόλο στο DevOps. Παρέχει μια κοινή πλατφόρμα για πολλούς προγραμματιστές που εργάζονται στον ίδιο κώδικα ή έργο για να ανεβάζουν και να ανακτούν ενημερωμένο κώδικα, διευκολύνοντας έτσι τη συνεχή ενσωμάτωση.

Jenkins χρειάζεται την εγκατάσταση του πρόσθετου Git πριν μπορέσει να αντλήσει κώδικα από ένα αποθετήριο GitHub. Τα δύο ονόματα πρόσθετων συχνά συγχέονται, επομένως ο παρακάτω πίνακας τα διαχωρίζει:

Δεν χρειάζεται να εγκαταστήσετε αυτά τα πρόσθετα (plugins) εάν έχετε ήδη αποδεχτεί τα προτεινόμενα πρόσθετα (plugins) κατά τη διάρκεια της Jenkins ρύθμιση εγκατάστασης, καθώς το πρόσθετο Git είναι μέρος αυτού του συνόλου. Εάν όχι, δείτε πώς μπορείτε να τα εγκαταστήσετε και να αντλήσετε κώδικα από ένα αποθετήριο GitHub.

Πώς να εγκαταστήσετε το πρόσθετο Git στο Jenkins

Ακολουθεί μια βήμα προς βήμα διαδικασία για την εγκατάσταση του πρόσθετου Git στο Jenkins:

Βήμα 1: Ανοίξτε τον πίνακα ελέγχου σας.
Κάντε κλικ στο Διαχειριστείτε Jenkins κουμπί στο δικό σας Jenkins ταμπλό:

Βήμα 2: Βρείτε την επιλογή plugins.
Κάντε κλικ στο Πρόσθετα. Στο ρεύμα Jenkins κυκλοφορίες αυτή η καταχώρηση έχει απλώς ετικέτα Πρόσθετα; παλαιότερες κυκλοφορίες με την ίδια ετικέτα οθόνης Διαχείριση των προσθηκών.

Βήμα 3: Στη σελίδα Πρόσθετα, ανοίξτε το Διαθέσιμα πρόσθετα καρτέλα και στη συνέχεια:

1. Επιλέξτε το Git συνδέω
2. Πατήστε Εγκατάσταση χωρίς επανεκκίνησηΗ λήψη της προσθήκης διαρκεί λίγα λεπτά, ανάλογα με τη σύνδεσή σας στο διαδίκτυο, και εγκαθίσταται αυτόματα.
3. Μπορείτε αντ' αυτού να επιλέξετε Κατεβάστε τώρα και εγκαταστήστε μετά την επανεκκίνηση, οπότε το πρόσθετο εφαρμόζεται όταν Jenkins ξεκινάει η επόμενη.
4. Εάν το πρόσθετο υπάρχει ήδη, εμφανίζεται στο Εγκατεστημένο καρτέλα και δεν προσφέρεται καμία ενημέρωση.

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

Με το πρόσθετο στη θέση του, Jenkins μπορεί τώρα να κατευθυνθεί σε ένα πραγματικό αποθετήριο.

Πώς να ενσωματώσετε Jenkins Με το GitHub

Θα δούμε τώρα τη διαδικασία ενσωμάτωσης Jenkins και το GitHub σε ένα Windows Σύστημα:

Βήμα 1) Δημιουργήστε μια νέα θέση εργασίας στο Jenkins. Ανοιξε το Jenkins ταμπλό στο δικό σας Jenkins URL, Για παράδειγμα http://localhost:8080/, και κάντε κλικ στο κουμπί Νέο στοιχείο:

Βήμα 2) Εισαγάγετε το όνομα του στοιχείου, επιλέξτε τον τύπο εργασίας και κάντε κλικ στο OK. Θα δημιουργήσουμε ένα έργο Freestyle ως παράδειγμα.

Βήμα 3) Μόλις κάνετε κλικ OK, η σελίδα ανακατευθύνει στη φόρμα διαμόρφωσης έργου. Εισαγάγετε τις πληροφορίες του έργου εδώ:

Βήμα 4) Θα δείτε ένα Git κάτω από την επιλογή Πηγή Code Κοινωνικών Δικτύων αν το πρόσθετο Git έχει εγκατασταθεί στο Jenkins:

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

Βήμα 5) Εισέλθετε στο αποθετήριο Git URL για να ανακτήσετε τον κώδικα από το GitHub.

Βήμα 6) Ενδέχεται να λάβετε ένα μήνυμα σφάλματος την πρώτη φορά που θα εισέλθετε στο αποθετήριο URL. Για παράδειγμα:

Αυτό συμβαίνει όταν το Git δεν είναι εγκατεστημένο στον υπολογιστή που εκτελείται. Jenkins. Jenkins δεν ομαδοποιεί το δικό του δυαδικό αρχείο Git. Το πρόσθετο καλεί το εκτελέσιμο αρχείο Git στον κεντρικό υπολογιστή. Για να εγκαταστήσετε το Git τοπικά, μεταβείτε στη διεύθυνση https://git-scm.com/downloads.

Κατεβάστε το κατάλληλο πρόγραμμα εγκατάστασης Git για εσάς Operating System — σε αυτή την περίπτωση Windows — και εγκαταστήστε το στον υπολογιστή που λειτουργεί Jenkins. Ολοκληρώστε τις οδηγίες στην οθόνη για να ολοκληρώσετε την εγκατάσταση.

Βήμα 7) Jenkins μπορεί να εκτελέσει αποθετήρια Git μόλις εγκατασταθεί το Git στον υπολογιστή. Για να επιβεβαιώσετε την εγκατάσταση, ανοίξτε ένα γραμμή εντολών, τύπου gitκαι πατήστε Enter. Εμφανίζεται μια λίστα με επιλογές Git:

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

Αυτό επιβεβαιώνει ότι το Git είναι εγκατεστημένο στο σύστημά σας.

Σημείωση: Αν το Git είναι ήδη εγκατεστημένο, προσθέστε το git.exe μονοπάτι κάτω από Διαχειριστείτε Jenkins > Εργαλεία (με ετικέτα Καθολική διαμόρφωση εργαλείου σε παλαιότερες εκδόσεις).

Βήμα 8) Αφού όλα είναι στη θέση τους, προσθέστε το Git URL σε Jenkins ξανά. Δεν εμφανίζεται μήνυμα σφάλματος, το οποίο επιβεβαιώνει το Jenkins Ενσωμάτωση Git:

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

Πώς να κάνετε έλεγχο ταυτότητας Jenkins Με ένα διακριτικό προσωπικής πρόσβασης GitHub

Το GitHub σταμάτησε να δέχεται κωδικούς πρόσβασης λογαριασμών για λειτουργίες Git τον Αύγουστο του 2021. Παροχή ονόματος χρήστη και κωδικού πρόσβασης στο Jenkins επομένως, αποτυγχάνει σε οποιοδήποτε ιδιωτικό αποθετήριο με σφάλμα ελέγχου ταυτότητας, ακόμα και όταν τα ίδια διαπιστευτήρια συνδέονται στον ιστότοπο GitHub. Ένα προσωπικό διακριτικό πρόσβασης αντικαθιστά τον κωδικό πρόσβασης και Jenkins το αποθηκεύει στο δικό του χώρο αποθήκευσης διαπιστευτηρίων και όχι στη διαμόρφωση της εργασίας.

Δημιουργήστε πρώτα το διακριτικό στο GitHub:

1. Στο GitHub, ανοίξτε Ρυθμίσεις > Ρυθμίσεις προγραμματιστή > Προσωπικά διακριτικά πρόσβασης.
2. Επιλέξτε λεπτόκοκκος διακριτικό όπου είναι δυνατόν, επειδή μπορεί να χρησιμοποιηθεί σε ένα μόνο αποθετήριο ή σε ένα κλασικό διακριτικό εάν ο οργανισμός σας εξακολουθεί να χρειάζεται ένα.
3. Παραχωρήστε πρόσβαση ανάγνωσης στα περιεχόμενα του αποθετηρίου. Προσθέστε πρόσβαση εγγραφής σε κατάσταση commit μόνο όταν το επιθυμείτε. Jenkins για να αναφέρετε τα αποτελέσματα της κατασκευής πίσω στις υποβολές.
4. Ορίστε μια ημερομηνία λήξης και αντιγράψτε το διακριτικό αμέσως — το GitHub το εμφανίζει ακριβώς μία φορά.

Στη συνέχεια, καταχωρήστε το διακριτικό μέσα Jenkins:

1. Πηγαίνετε στο Διαχειριστείτε Jenkins > Διαπιστευτήρια > Σύστημα > Καθολικά διαπιστευτήρια και κάντε κλικ στο κουμπί Προσθήκη διαπιστευτηρίων.
2. Αγορά Όνομα χρήστη με κωδικό πρόσβασης ως είδος. Εισαγάγετε το όνομα χρήστη GitHub και επικολλήστε το ένδειξη στο πεδίο κωδικού πρόσβασης.
3. Δώστε στην καταχώρηση ένα σαφές αναγνωριστικό, όπως π.χ. github-pat επομένως είναι αναγνωρίσιμο στις οθόνες διαμόρφωσης εργασίας.
4. Επιστροφή στην εργασία, άνοιγμα Πηγή Code Διαχείριση > Gitκαι επιλέξτε το νέο πιστοποιητικό από το Διαπιστεύσεις αναπτυσσόμενο.

Το κόκκινο σφάλμα επικύρωσης κάτω από το αποθετήριο URL εξαφανίζεται μία φορά Jenkins μπορεί να κάνει έλεγχο ταυτότητας. Αξίζει να θυμόμαστε δύο πρακτικές σημειώσεις. Πρώτον, τα διακριτικά λήγουν. μια εργασία που έχει εκτελεστεί αξιόπιστα για μήνες και αποτυγχάνει ξαφνικά κατά την ολοκλήρωση της αγοράς είναι σχεδόν πάντα ένα ληγμένο διακριτικό και όχι ένα κατεστραμμένο αποθετήριο. Δεύτερον, ένα κλειδί SSH είναι μια έγκυρη εναλλακτική λύση — προσθέστε το ιδιωτικό κλειδί ως Όνομα χρήστη SSH με ιδιωτικό κλειδί διαπιστευτήριο και χρησιμοποιήστε το git@github.com:owner/repo.git URL φόρμα αντί για τη φόρμα HTTPS.

Πώς να ενεργοποιήσετε Jenkins Δημιουργείται αυτόματα με ένα Webhook GitHub

Η εργασία που δημιουργήθηκε παραπάνω πρέπει να ξεκινήσει χειροκίνητα, κάτι που ακυρώνει τον σκοπό της συνεχούς ενσωμάτωσης. Ένα webhook καλύπτει αυτό το κενό: Το GitHub στέλνει ένα αίτημα HTTP σε Jenkins σε κάθε σπρώξιμο, και Jenkins ξεκινάει αμέσως την κατασκευή.

Jenkins πρέπει να είναι προσβάσιμο από το GitHub για να λειτουργήσει αυτό. Σε φορητό υπολογιστή που εκτελεί localhost:8080 δεν είναι, οπότε είτε ο κεντρικός υπολογιστής Jenkins σε δημόσιο URL ή να το εκθέσετε προσωρινά μέσω μιας υπηρεσίας σήραγγας κατά τη διάρκεια των δοκιμών.

1. Εγκαταστήστε το πρόσθετο GitHub. Επιστροφή στην Διαχειριστείτε Jenkins > Πρόσθετα > Διαθέσιμα πρόσθετα και να εγκαταστήσετε GitHubΑυτό προσθέτει την επιλογή ενεργοποίησης που δεν παρέχει το πρόσθετο Git από μόνο του.
2. Ενεργοποιήστε την ενεργοποίηση στην εργασία. Ανοίξτε τη διαμόρφωση εργασίας, μεταβείτε στην επιλογή Δημιουργήστε κανόνες ετικέτας, και σημειώστε Ενεργοποίηση αγκίστρου GitHub για ψηφοφορία GITScm.
3. Προσθέστε το webhook στο GitHub. Στο αποθετήριο, ανοίξτε Ρυθμίσεις > Webhooks > Προσθήκη webhook.
4. Ορίστε το ωφέλιμο φορτίο URL να σας Jenkins διεύθυνση ακολουθούμενη από /github-webhook/Η κάθετος στο τέλος έχει σημασία.
5. Ορίστε τον τύπο περιεχομένου προς την application/json Και επιλέξτε Μόνο η εκδήλωση ώθησης.
6. Αποθήκευση και δοκιμή. Το GitHub στέλνει ένα ping αμέσως. Ένα πράσινο τικ από κάτω Πρόσφατες παραδόσεις μέσα Jenkins το δέχτηκε.

# 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/

Πιέστε μια υποβολή για να επιβεβαιώσετε ότι ο βρόχος έχει κλείσει. Η εργασία θα πρέπει να εμφανιστεί στην ουρά δημιουργίας μέσα σε λίγα δευτερόλεπτα χωρίς καμία χειροκίνητη ενέργεια. Εάν δεν συμβεί τίποτα, ανοίξτε το webhook στο GitHub και διαβάστε το Πρόσφατες παραδόσεις κωδικός απόκρισης: ένα 403 συνήθως δείχνει στο Jenkins οι ρυθμίσεις ασφαλείας εμποδίζουν την ανώνυμη πρόσβαση στο τελικό σημείο, ενώ ένα χρονικό όριο σημαίνει ότι το GitHub δεν μπορεί να φτάσει στο Jenkins URL καθόλου.

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

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

Σχεδόν κάθε αποτυχημένη ενσωμάτωση εμπίπτει σε μία από τις παρακάτω κατηγορίες και η καθεμία έχει ένα ξεχωριστό σύμπτωμα που υποδεικνύει κατευθείαν την αιτία.

• Δεν υπάρχει επιλογή Git στην ενότητα Source Code Διαχείριση: Το πρόσθετο Git δεν είναι εγκατεστημένο ή δεν έχει φορτωθεί. Επανεγκαταστήστε το από Διαχειριστείτε Jenkins > Πρόσθετα, επανεκκίνηση Jenkinsκαι επαναφορτώστε τη σελίδα διαμόρφωσης εργασίας.
• «Αποτυχία σύνδεσης με το αποθετήριο» σε δημόσιο URL: Το Git λείπει από το Jenkins host. Εγκαταστήστε το Git και, στη συνέχεια, επιβεβαιώστε με git --version και καταγράψτε τη διαδρομή κάτω από Διαχειριστείτε Jenkins > Εργαλεία.
• Η πιστοποίηση απέτυχε σε ένα ιδιωτικό αποθετήριο: Χρησιμοποιείται κωδικός πρόσβασης λογαριασμού. Αντικαταστήστε τον με ένα προσωπικό διακριτικό πρόσβασης όπως περιγράφεται παραπάνω ή μεταβείτε σε ένα κλειδί SSH.
• Οι κατασκευές δεν ξεκινούν ποτέ μετά από ένα πάτημα: είτε το Ενεργοποίηση αγκίστρου GitHub το πλαίσιο ελέγχου δεν είναι επιλεγμένο ή το GitHub δεν μπορεί να φτάσει στο Jenkins URLΕλέγξτε το αρχείο καταγραφής παράδοσης webhook στις ρυθμίσεις του αποθετηρίου.
• Δημιουργήθηκε λάθος κλάδος: ο Προσδιοριστής κλάδου εξακολουθεί να διατηρεί την προεπιλογή */master ενώ το αποθετήριο χρησιμοποιεί mainΕνημερώστε τον προσδιοριστή ώστε να ταιριάζει.
• Το checkout λειτούργησε χθες και αποτυγχάνει σήμερα: Το προσωπικό διακριτικό πρόσβασης έχει φτάσει στην ημερομηνία λήξης του. Δημιουργήστε ένα αντίγραφο και ενημερώστε τα αποθηκευμένα διαπιστευτήρια.

Επίσης ελέγξτε: καλυτερα Jenkins Εναλλακτικές λύσεις (ανοιχτού κώδικα και επί πληρωμή) και την Σωλήνας CI/CD αναλυτική παρουσίαση, η οποία βασίζεται στη σύνδεση που δημιουργείται εδώ.

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