Τι σας προσφέρει η σύνδεσή του
Η σύνδεση του GitHub με ένα διακριτικό (token) επιτρέπει την ανάπτυξη ενός ιστότοπου από ένα από τα αποθετήριά σας: κάνετε push στον κλάδο και ο ιστότοπος ενημερώνεται. Επίσης, μας επιτρέπει να δημοσιεύουμε στο GitHub Pages στον λογαριασμό σας, εφόσον το επιλέξετε ως πάροχο φιλοξενίας ενός ιστότοπου.
Εάν τα αποθετήριά σας ανήκουν σε κάποιον οργανισμό, προτιμήστε αντ' αυτού την εφαρμογή Zinn® GitHub — δείτε το Εγκατάσταση της εφαρμογής Zinn® GitHub. Ένα διακριτικό ανήκει σε ένα μόνο άτομο και παύει να λειτουργεί όταν αυτό αποχωρήσει.
Πριν ξεκινήσετε
Έναν λογαριασμό GitHub με πρόσβαση στα αποθετήρια που θέλετε να αναπτύξετε. Εάν ανήκουν σε κάποιον οργανισμό, ίσως χρειαστεί ένας κάτοχος να εγκρίνει λεπτομερή διακριτικά (fine-grained tokens) για αυτόν.
1. Δημιουργήστε το κλειδί στο GitHub
Στο GitHub, κάντε κλικ στην εικόνα του προφίλ σας και, στη συνέχεια, επιλέξτε Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Ονομάστε το και επιλέξτε ημερομηνία λήξης. Στην ενότητα Repository access, επιλέξτε Only select repositories και διαλέξτε εκείνα που αναπτύσσετε — τη στενότερη δυνατή πρόσβαση που εξυπηρετεί.
Στην ενότητα Repository permissions, παραχωρήστε δικαιώματα Read and write στα εξής:
- Contents
- Pages
- Administration
Πατήστε Generate token και αντιγράψτε το — το GitHub το εμφανίζει μόνο μία φορά.
2. Συνδέστε το εδώ
Ανοίξτε την ενότητα Integrations στον πίνακα ελέγχου σας και επιλέξτε Connect an account. Επιλέξτε Code hosting ως ομάδα και GitHub ως λογαριασμό, συμπληρώστε το API token και πατήστε Connect account.
Ελέγχουμε αυτό που επικολλάτε προτού αποθηκευτεί οτιδήποτε. Ένα κλειδί που δεν λειτουργεί δεν αποθηκεύεται ποτέ και η απάντηση αναφέρει τι ήταν εσφαλμένο σε αυτό. Ένα κλειδί που λειτουργεί διατηρείται κρυπτογραφημένο στο θησαυροφυλάκιο μυστικών μας — ποτέ στη βάση δεδομένων μας — και δεν εμφανίζεται ποτέ ξανά, ούτε καν σε εσάς.
Τι συμβαίνει στη συνέχεια
- Ένας ιστότοπος μπορεί να αναπτυχθεί απευθείας από ένα αποθετήριο σε αυτόν τον λογαριασμό: επιλέξτε το στη σύνδεση αποθετηρίου του ιστότοπου, διαλέξτε το αποθετήριο και τον κλάδο, και ένα push εκτελεί την ανάπτυξη.
- Κάθε άλλος κλάδος μπορεί να αποκτήσει τη δική του προεπισκόπηση, ώστε να μπορείτε να ελέγξετε μια αλλαγή προτού φτάσει στον ζωντανό ιστότοπο.
- Πάροχοι στατικής φιλοξενίας βασισμένοι στο Git, όπως οι Render και Azure Static Web Apps, χρησιμοποιούν αυτήν τη σύνδεση ως πηγή του κώδικα του ιστότοπου.
Εάν δεν συνδέεται
Ένα αποθετήριο δεν εμφανίζεται. Η πρόσβαση αποθετηρίου του διακριτικού δεν το περιλαμβάνει. Επεξεργαστείτε το διακριτικό στο GitHub και προσθέστε το αποθετήριο.
Λειτούργησε και μετά σταμάτησε. Τα λεπτομερή διακριτικά (fine-grained tokens) λήγουν την ημερομηνία που επιλέξατε. Δημιουργήστε ένα νέο και συνδέστε το· το GitHub σας στέλνει email προτού λήξει ένα διακριτικό.
Αναφέρει ότι το κλειδί απορρίφθηκε. Σχεδόν πάντα οφείλεται σε ένα από τα εξής τρία: αντιγράφηκε μαζί του ένα κενό διάστημα ή μια αλλαγή γραμμής, το κλειδί έχει λήξει, ή το κλειδί ανακλήθηκε ή δημιουργήθηκε εκ νέου αφού το αντιγράψατε. Δημιουργήστε ένα νέο και επικολλήστε το ξανά.
Συνδέεται, αλλά αργότερα κάτι αποτυγχάνει. Το κλειδί επαληθεύει την ταυτότητα αλλά δεν διαθέτει ένα δικαίωμα που απαιτεί η ενέργεια. Δημιουργήστε ένα νέο κλειδί με τα δικαιώματα που αναφέρονται παραπάνω, αποσυνδέστε την παλιά σύνδεση και συνδέστε το νέο κλειδί.
Αποσύνδεση
Ανοίξτε την ενότητα Integrations, βρείτε τον λογαριασμό και πατήστε Disconnect. Αυτό διαγράφει αμέσως το αποθηκευμένο κλειδί. Οτιδήποτε το χρησιμοποιούσε σταματά στην επόμενη ενέργειά του, και οι οθόνες που εξαρτώνταν από αυτό το αναφέρουν ρητά αντί να αποτυγχάνουν σιωπηρά.
Η αποσύνδεση δεν αναιρεί ό,τι έχει ήδη γίνει — εγγραφές, αναπτύξεις ή ρυθμίσεις που αλλάξαμε στον λογαριασμό σας παραμένουν ως έχουν. Εάν πιστεύετε ότι το ίδιο το κλειδί μπορεί να έχει διαρρεύσει, ανακαλέστε το επίσης στον πάροχο· η αποσύνδεση αφαιρεί το δικό μας αντίγραφο, όχι το δικό τους.