Εγκαταστήστε την εφαρμογή GitHub του Zinn® ώστε να μπορούμε να κάνουμε ανάπτυξη χωρίς διακριτικό μεγάλης διάρκειας

Τι σας προσφέρει η σύνδεσή της

Η εγκατάσταση της εφαρμογής Zinn® GitHub επιτρέπει σε έναν ιστότοπο να κάνει deploy από τα αποθετήριά σας — και σε έναν πίνακα έργου να παραμένει συγχρονισμένος με το GitHub — χωρίς να μας παραχωρείτε ένα προσωπικό διακριτικό (token). Διατηρούμε μόνο τον αριθμό εγκατάστασης της εφαρμογής, ο οποίος είναι άχρηστος από μόνος του, και εκδίδουμε ένα διακριτικό διάρκειας μίας ώρας κάθε φορά που χρειαζόμαστε ένα. Αποτελεί την καλύτερη επιλογή για έναν οργανισμό, επειδή δεν ανήκει σε κανένα μεμονωμένο άτομο και δεν σταματά να λειτουργεί όταν κάποιος αποχωρεί.

Πριν ξεκινήσετε

Ένας λογαριασμός GitHub ή δικαιώματα ιδιοκτήτη στον οργανισμό όπου θέλετε να εγκαταστήσετε την εφαρμογή. Οι οργανισμοί που απαγορεύουν εφαρμογές τρίτων απαιτούν από έναν ιδιοκτήτη να το επιτρέψει· εάν αυτό δεν είναι δυνατό, χρησιμοποιήστε αντ' αυτού ένα διακριτικό λεπτομερούς επιπέδου δικαιωμάτων (fine-grained token) (Σύνδεση του λογαριασμού σας GitHub).

1. Δημιουργήστε το κλειδί στο GitHub

Δεν υπάρχει κλειδί προς δημιουργία. Εγκαταστήστε την εφαρμογή Zinn® GitHub στον προσωπικό σας λογαριασμό ή στον οργανισμό σας και επιλέξτε είτε όλα τα αποθετήρια είτε μόνο εκείνα από τα οποία θέλετε να κάνουμε deploy.

Στη συνέχεια, βρείτε τον αριθμό εγκατάστασης:

• Προσωπικός λογαριασμός — Settings → Applications → Installed GitHub Apps, και Configure δίπλα στην εφαρμογή Zinn®.
• Οργανισμός — Your organizations → Settings → GitHub Apps, και Configure δίπλα στην εφαρμογή Zinn®.

Ο αριθμός στο τέλος της γραμμής διευθύνσεων σε αυτήν τη σελίδα — για παράδειγμα github.com/settings/installations/12345678 — είναι ο αριθμός εγκατάστασης.

2. Συνδέστε την εδώ

Η επιλογή της εφαρμογής γίνεται εκεί όπου χρησιμοποιείται και όχι στην οθόνη Ενοποιήσεις:

• Στη σύνδεση αποθετηρίου ενός ιστοτόπου, επιλέξτε GitHub (εγκατάσταση εφαρμογής).
• Στον σύνδεσμο GitHub ενός πίνακα έργου, επιλέξτε Η εφαρμογή Zinn® GitHub.

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

Τι συμβαίνει στη συνέχεια

• Τα αποθετήρια στα οποία παραχωρήσατε πρόσβαση στην εφαρμογή εμφανίζονται ώστε ο ιστότοπος να κάνει deploy από αυτά, και ένα push κάνει deploy.
• Κάθε ενέργεια που πραγματοποιούμε εμφανίζεται στο αρχείο καταγραφής ελέγχου (audit log) της εγκατάστασης στο GitHub υπό το όνομα της εφαρμογής, όχι το δικό σας.
• Για να μας παραχωρήσετε πρόσβαση σε περισσότερα αποθετήρια, αλλάξτε την πρόσβαση αποθετηρίων της εφαρμογής στην ίδια σελίδα Configure — δεν χρειάζεται επανασύνδεση για τίποτα.

Εάν δεν συνδέεται

Λείπει ένα αποθετήριο. Η εγκατάσταση καλύπτει μόνο τα αποθετήρια που επιλέξατε. Ανοίξτε το Configure και προσθέστε το.

Ο αριθμός απορρίπτεται. Ελέγξτε αν πρόκειται για τον αριθμό εγκατάστασης από τη γραμμή διευθύνσεων και όχι για το αναγνωριστικό (ID) της ίδιας της εφαρμογής, καθώς και ότι η εφαρμογή είναι ακόμα εγκατεστημένη — μια απεγκατεστημένη εφαρμογή δεν διαθέτει εγκατάσταση.

Αναφέρει ότι το κλειδί απορρίφθηκε. Σχεδόν πάντα πρόκειται για ένα από τα εξής τρία πράγματα: ένα κενό διάστημα ή μια αλλαγή γραμμής που αντιγράφηκε μαζί του, ένα κλειδί που έχει λήξει ή ένα κλειδί που ανακλήθηκε ή δημιουργήθηκε ξανά μετά την αντιγραφή του. Δημιουργήστε ένα νέο και επικολλήστε το ξανά.

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

Αποσύνδεση

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

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