Τι προσφέρει η σύνδεση
Η σύνδεση του GitHub με ένα διακριτικό επιτρέπει την ανάπτυξη ενός ιστότοπου από ένα από τα αποθετήριά σας: κάντε 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 και προσθέστε το αποθετήριο.
Λειτούργησε και στη συνέχεια σταμάτησε. Τα λεπτομερή διακριτικά λήγουν την ημερομηνία που επιλέξατε. Δημιουργήστε ένα νέο και συνδέστε το. Το GitHub στέλνει email ειδοποίησης προτού λήξει ένα διακριτικό.
Αναφέρεται ότι το κλειδί απορρίφθηκε. Σχεδόν πάντα οφείλεται σε έναν από τους τρεις εξής λόγους: αντιγράφηκε μαζί με κενό διάστημα ή αλλαγή γραμμής, το κλειδί έχει λήξει, ή το κλειδί ανακλήθηκε ή δημιουργήθηκε ξανά αφού το αντιγράψατε. Δημιουργήστε ένα νέο και επικολλήστε το ξανά.
Συνδέεται, αλλά κάτι αποτυγχάνει αργότερα. Το κλειδί πιστοποιείται αλλά του λείπει μια άδεια που απαιτείται για την ενέργεια. Δημιουργήστε ένα νέο κλειδί με τις άδειες που αναφέρονται παραπάνω, αποσυνδέστε την παλιά σύνδεση και συνδέστε το νέο κλειδί.
Αποσύνδεση
Ανοίξτε τις Integrations, εντοπίστε τον λογαριασμό και πατήστε Disconnect. Αυτή η ενέργεια διαγράφει αμέσως το αποθηκευμένο κλειδί. Οτιδήποτε το χρησιμοποιούσε σταματά στην επόμενη ενέργειά του, και οι οθόνες που εξαρτώνταν από αυτό το επισημαίνουν αντί να αποτυγχάνουν σιωπηρά.
Η αποσύνδεση δεν αναιρεί όσα έχουν ήδη γίνει — τα αρχεία καταγραφής, οι αναπτύξεις ή οι ρυθμίσεις που αλλάξαμε στον λογαριασμό σας παραμένουν ως έχουν. Εάν πιστεύετε ότι το ίδιο το κλειδί ενδέχεται να έχει διαρρεύσει, ανακαλέστε το επίσης στον πάροχο. Η αποσύνδεση αφαιρεί το δικό μας αντίγραφο, όχι το δικό τους.