Τι προσφέρει η σύνδεση
Η εγκατάσταση της εφαρμογής Zinn® GitHub επιτρέπει σε έναν ιστότοπο να πραγματοποιεί ανάπτυξη από τα αποθετήριά σας — και σε έναν πίνακα έργου να παραμένει συγχρονισμένος με το GitHub — χωρίς να μας παραχωρείτε προσωπικό διακριτικό. Διαθέτουμε μόνο τον αριθμό εγκατάστασης της εφαρμογής, ο οποίος είναι άχρηστος από μόνος του, και δημιουργούμε ένα διακριτικό διάρκειας μίας ώρας κάθε φορά που το χρειαζόμαστε. Αποτελεί καλύτερη επιλογή για έναν οργανισμό, επειδή δεν ανήκει σε κάποιο συγκεκριμένο άτομο και δεν σταματά να λειτουργεί όταν κάποιος αποχωρεί.
Πριν ξεκινήσετε
Ένας λογαριασμός GitHub ή δικαιώματα κατόχου στον οργανισμό όπου θέλετε να εγκαταστήσετε την εφαρμογή. Οι οργανισμοί που απαγορεύουν εφαρμογές τρίτων απαιτούν την έγκριση ενός κατόχου· αν αυτό δεν είναι εφικτό, χρησιμοποιήστε αντί αυτού ένα λεπτομερές διακριτικό (Σύνδεση του λογαριασμού σας στο GitHub).
1. Δημιουργία του κsλειδιού στο GitHub
Δεν υπάρχει κλειδί προς δημιουργία. Εγκαταστήστε την εφαρμογή Zinn® GitHub στον προσωπικό σας λογαριασμό ή στον οργανισμό σας και επιλέξτε είτε όλα τα αποθετήρια είτε μόνο αυτά από τα οποία θέλετε να πραγματοποιούμε ανάπτυξη.
Στη συνέχεια, βρείτε τον αριθμό εγκατάστασης:
- Προσωπικός λογαριασμός — Settings → Applications → Installed GitHub Apps, και Configure δίπλα στην εφαρμογή Zinn®.
- Οργανισμός — Your organizations → Settings → GitHub Apps, και Configure δίπλα στην εφαρμογή Zinn®.
Ο αριθμός στο τέλος της γραμμής διευθύνσεων σε αυτή τη σελίδα — για παράδειγμα github.com/settings/installations/12345678 — είναι ο αριθμός εγκατάστασης.
2. Σύνδεση εδώ
Η εφαρμογή επιλέγεται στο σημείο όπου χρησιμοποιείται και όχι στην οθόνη Integrations:
- Σε μια σύνδεση αποθετηρίου ιστότοπου, επιλέξτε GitHub (app install).
- Σε έναν σύνδεσμο GitHub πίνακα έργου, επιλέξτε The Zinn® GitHub app.
Επικολλήστε τον Installation number και συνεχίστε. Ελέγχουμε την εγκατάσταση πριν αποθηκεύσουμε οτιδήποτε· ένας αριθμός στον οποίο δεν μπορούμε να έχουμε πρόσβαση δεν αποθηκεύεται ποτέ.
Τι συμβαίνει στη συνέχεια
- Τα αποθετήρια στα οποία παραχωρήσατε πρόσβαση στην εφαρμογή εμφανίζονται ώστε να πραγματοποιεί ανάπτυξη ο ιστότοπος, και μια ενέργεια push εκτελεί ανάπτυξη.
- Κάθε ενέργεια που πραγματοποιούμε εμφανίζεται στο αρχείο καταγραφής ελέγχου (audit log) της εγκατάστασης στο GitHub υπό το όνομα της εφαρμογής, και όχι το δικό σας.
- Για να μας δώσετε περισσότερα αποθετήρια, αλλάξτε την πρόσβαση αποθετηρίου της εφαρμογής στην ίδια σελίδα Configure — δεν χρειάζεται επανασύνδεση.
Εάν η σύνδεση αποτύχει
Λείπει ένα αποθετήριο. Η εγκατάσταση καλύπτει μόνο τα αποθετήρια που επιλέξατε. Ανοίξτε το Configure και προσθέστε το.
Ο αριθμός απορρίπτεται. Ελέγξτε ότι πρόκειται για τον αριθμό εγκατάστασης από τη γραμμή διευθύνσεων και όχι για το αναγνωριστικό της ίδιας της εφαρμογής, και ότι η εφαρμογή είναι ακόμα εγκατεστημένη — μια απεγκατεστημένη εφαρμογή δεν διαθέτει εγκατάσταση.
Αναφέρεται ότι το κλειδί απορρίφθηκε. Σχεδόν πάντα οφείλεται σε έναν από τους τρεις εξής λόγους: αντιγράφηκε μαζί με ένα κενό διάστημα ή μια αλλαγή γραμμής, το κλειδί έχει λήξει ή το κλειδί ανακλήθηκε ή αναδημιουργήθηκε αφότου το αντιγράψατε. Δημιουργήστε ένα νέο και επικολλήστε το ξανά.
Συνδέεται, αλλά κάτι αποτυγχάνει αργότερα. Το κλειδί πραγματοποιεί έλεγχο ταυτότητας αλλά στερείται μιας άδειας που απαιτείται για την ενέργεια. Δημιουργήστε ένα νέο κλειδί με τις άδειες που αναφέρονται παραπάνω, στη συνέχεια αποσυνδέστε την παλιά σύνδεση και συνδέστε το νέο κλειδί.
Αποσύνδεση
Ανοίξτε το Integrations, εντοπίστε τον λογαριασμό και πατήστε Disconnect. Αυτή η ενέργεια διαγράφει αμέσως το αποθηκευμένο κλειδί. Οτιδήποτε το χρησιμοποιούσε σταματά στην επόμενη ενέργειά του και οι οθόνες που εξαρτώνταν από αυτό το επισημαίνουν αντί να αποτυγχάνουν σιωπηρά.
Η αποσύνδεση δεν αναιρεί όσα είχαν ήδη πραγματοποιηθεί — τα αρχεία καταγραφής, οι αναπτύξεις ή οι ρυθμίσεις που αλλάξαμε στον λογαριασμό σας παραμένουν ως έχουν. Εάν πιστεύετε ότι το ίδιο το κλειδί μπορεί να έχει διαρρεύσει, ανακαλέστε το επίσης στον πάροχο· η αποσύνδεση αφαιρεί το δικό μας αντίγραφο, όχι το δικό τους.