Εκτέλεση διακομιστή Connect
Το Control Center Connect εκτελεί τις συνδέσεις παρόχων (GitHub, Google Calendar, Linear, Slack) για διακομιστές που δεν έχουν καταχωρίσει δικές τους εφαρμογές. Αυτός ο οδηγός δείχνει πώς να εκτελέσετε το δικό σας Connect, ώστε οι εφαρμογές παρόχων, τα μυστικά τους και η λίστα των διακομιστών που επιτρέπεται να τις χρησιμοποιούν να μένουν όλα σε εσάς.
Τι μπορεί και τι δεν μπορεί να δει το Connect περιγράφεται στην αναφορά του Connect. Διαβάστε την πρώτα αν αποφασίζετε αν θα εκτελέσετε ένα.
Προϋποθέσεις
Ενότητα με τίτλο «Προϋποθέσεις»- Μια δημόσια διεύθυνση HTTPS για το Connect, όπως
https://connect.example.com, πίσω από έναν διακομιστή μεσολάβησης που τερματίζει το TLS. Το σκέτοhttpγίνεται δεκτό μόνο στο loopback - Docker ή ένας
cc_serverπου μπορείτε να επανεκκινήσετε με επιπλέον μεταβλητές περιβάλλοντος - Δικαίωμα καταχώρισης εφαρμογών σε κάθε πάροχο που θέλετε να εξυπηρετήσετε
- Οι διακομιστές που θα το χρησιμοποιούν, με τους ιδιοκτήτες τους διαθέσιμους: ο καθένας έχει ένα αναγνωριστικό εγκατάστασης που προσθέτετε στη λίστα επιτρεπόμενων του Connect
Βήμα 1: Επιλέξτε τη διεύθυνση
Ενότητα με τίτλο «Βήμα 1: Επιλέξτε τη διεύθυνση»Επιλέξτε το URL τώρα και κρατήστε το. Το CONNECT_PUBLIC_URL συμμετέχει σε
οτιδήποτε κάνει το Connect: οι υπογραφές αιτημάτων, τα σφραγισμένα
διαπιστευτήρια, τα URL ανακατεύθυνσης των παρόχων και το αναγνωριστικό
εγκατάστασης κάθε διακομιστή είναι όλα δεμένα σε αυτό. Αν το αλλάξετε αργότερα,
πρέπει να καταχωρίσετε ξανά τις ανακατευθύνσεις και όλοι να συνδεθούν ξανά.
Βήμα 2: Καταχωρίστε τις εφαρμογές παρόχων
Ενότητα με τίτλο «Βήμα 2: Καταχωρίστε τις εφαρμογές παρόχων»Καταχωρίστε μόνο τους παρόχους που θέλετε να εξυπηρετήσετε. Ένας πάροχος με
ελλιπείς μεταβλητές μένει εκτός της διαμόρφωσης του Connect, και οι διακομιστές
τον βλέπουν ως μη διαθέσιμο. Παρακάτω, το <base> είναι το CONNECT_PUBLIC_URL
σας.
| Πάροχος | Καταχώριση | Κρατήστε |
|---|---|---|
| Εφαρμογή GitHub | Callback URL <base>/oauth/github/callback. Setup URL <base>/oauth/github/setup με το Redirect on update ενεργό. Αφήστε το Request user authorization (OAuth) during installation ανενεργό: όταν είναι ενεργό, το GitHub αγνοεί το setup URL. Κρατήστε το Expire user authorization tokens ενεργό |
App id, slug, client id, client secret, ένα ιδιωτικό κλειδί |
Ένας OAuth client τύπου Web application με redirect URI <base>/oauth/google/callback και ενεργοποιημένο το Google Calendar API |
Client id, client secret | |
| Linear | Μια εφαρμογή OAuth με callback URLs <base>/oauth/linear/callback και <base>/oauth/linear_app/callback |
Μόνο το client id |
| Slack | Redirect URLs <base>/oauth/slack_oidc/callback και <base>/oauth/slack/callback. Event Subscriptions στο <base>/v1/hooks/slack/events (app_mention, message.*, assistant_thread_*, app_uninstalled, tokens_revoked). Slash commands στο <base>/v1/hooks/slack/commands. Token rotation ενεργό |
App id, client id, client secret, signing secret |
Δώστε στη GitHub App αυτά τα δικαιώματα αποθετηρίου: Metadata ανάγνωση, Contents ανάγνωση και εγγραφή, Pull requests ανάγνωση και εγγραφή, Issues ανάγνωση και εγγραφή, Checks, Actions και Commit statuses ανάγνωση. Προσθέστε Members οργανισμού ανάγνωση για αιτήματα αξιολόγησης από ομάδες. Τα webhooks μπορούν να μείνουν ανενεργά: οι διακομιστές κάνουν περιοδικό έλεγχο.
Το Connect χρειάζεται το ιδιωτικό κλειδί της GitHub App (Generate a private key στις ρυθμίσεις της App). Υπογράφει τα αιτήματα της App που βρίσκουν την εγκατάσταση που καλύπτει ένα αποθετήριο (ή, όταν το αποθετήριο δεν έχει καμία, την εγκατάσταση του ιδιοκτήτη) και εκδίδει ένα token εγκατάστασης για ένα αποθετήριο, μόνο αφού η σύνδεση του ανθρώπου που ζητά απέδειξε την πρόσβαση σε εκείνο το αποθετήριο.
Κάθε διακομιστής στο Connect σας μοιράζεται το bot της App. Μπορεί να διαβάζει, να σχολιάζει, να βάζει ετικέτες και να αντιδρά ως bot σε οποιονδήποτε από αυτούς. Η ανασκόπηση pull requests ως bot επιτρέπεται μόνο στους διακομιστές που καταχωρίζετε στο CONNECT_GITHUB_REVIEW_BOT_INSTALLS (τα αναγνωριστικά εγκατάστασής τους, χωρισμένα με κόμμα)· κάθε άλλος διακομιστής δημοσιεύει ανασκοπήσεις με το token του ίδιου του ελεγκτή. Η ώθηση δεν γίνεται ποτέ ως bot. Για να ανασκοπεί ως bot ένας δικός σας διακομιστής, προσθέστε εκεί το αναγνωριστικό εγκατάστασής του και κάντε επανεκκίνηση. Κρατήστε το αρχείο κλειδιού ως μυστικό, όπως το κλειδί σφράγισης. Το Linear δεν χρειάζεται μυστικό: το Connect επιστρέφει τον κωδικό στον διακομιστή, ο οποίος ολοκληρώνει μόνος του την ανταλλαγή.
Βήμα 3: Συγκεντρώστε τα αναγνωριστικά εγκατάστασης
Ενότητα με τίτλο «Βήμα 3: Συγκεντρώστε τα αναγνωριστικά εγκατάστασης»Το Connect απαντά μόνο στους διακομιστές της λίστας επιτρεπόμενων. Σε κάθε διακομιστή, κατευθύνετέ τον στο Connect σας και μετά διαβάστε το αναγνωριστικό εγκατάστασής του:
- Μεταβείτε στις Ρυθμίσεις → Διακομιστής → Ενιαία σύνδεση, ανοίξτε την κάρτα Control Center Connect και επιλέξτε Χρήση προσαρμοσμένου διακομιστή Connect
- Εισαγάγετε το URL σας και αποθηκεύστε. Η κάρτα δείχνει το Αναγνωριστικό εγκατάστασης του διακομιστή
Από ένα τερματικό στον κεντρικό υπολογιστή του διακομιστή, το ίδιο γίνεται έτσι:
cc_server connect enable --url https://connect.example.comcc_server connect statusΤο status εκτυπώνει το αναγνωριστικό εγκατάστασης. Δείχνει install_blocked
μέχρι να ολοκληρωθεί το Βήμα 5, κάτι που είναι αναμενόμενο.
Ένα αναγνωριστικό εγκατάστασης παράγεται ανά διεύθυνση Connect, οπότε ο ίδιος διακομιστής έχει διαφορετικό αναγνωριστικό για κάθε Connect με το οποίο επικοινωνεί. Αλλάζει μόνο όταν ο ιδιοκτήτης του εναλλάσσει το κλειδί.
Βήμα 4: Δημιουργήστε ένα κλειδί σφράγισης
Ενότητα με τίτλο «Βήμα 4: Δημιουργήστε ένα κλειδί σφράγισης»Το Connect κρυπτογραφεί κάθε διαπιστευτήριο που επιστρέφει με ένα κλειδί σφράγισης. Δημιουργήστε ένα και κρατήστε το ως αρχείο μυστικού:
docker run --rm ghcr.io/samuelalev/cc-connect:latest \ cc-connect-config seal-key > seal_keyschmod 600 seal_keysΑν χάσετε το κλειδί σφράγισης, όλοι αποσυνδέονται: καμία σφραγίδα δεν ανοίγει χωρίς αυτό.
Βήμα 5: Ξεκινήστε το κοντέινερ
Ενότητα με τίτλο «Βήμα 5: Ξεκινήστε το κοντέινερ»Κάθε έκδοση δημοσιεύει το ghcr.io/samuelalev/cc-connect με προέλευση build
(build provenance). Καρφιτσώστε ένα tag έκδοσης στην παραγωγή.
docker run -d --name cc-connect -p 8790:8790 \ -e CONNECT_PUBLIC_URL=https://connect.example.com \ -e CONNECT_ALLOWED_INSTALLS=<install id>,<install id> \ -e CONNECT_SEAL_KEYS_FILE=/run/secrets/seal_keys \ -v "$PWD/seal_keys:/run/secrets/seal_keys:ro" \ -e CONNECT_GITHUB_APP_ID=123456 \ -e CONNECT_GITHUB_APP_SLUG=acme-control-center \ -e CONNECT_GITHUB_CLIENT_ID=Iv23li0123456789abcd \ -e CONNECT_GITHUB_CLIENT_SECRET_FILE=/run/secrets/github \ -v "$PWD/github_secret:/run/secrets/github:ro" \ -e CONNECT_GITHUB_APP_PRIVATE_KEY_FILE=/run/secrets/github_key \ -v "$PWD/github_app_key.pem:/run/secrets/github_key:ro" \ -v cc-connect-data:/data \ ghcr.io/samuelalev/cc-connect:latestΚατευθύνετε τον αντίστροφο διακομιστή μεσολάβησης στη θύρα 8790, και ορίστε το CONNECT_TRUST_PROXY στον αριθμό των διακομιστών μεσολάβησης μπροστά από το Connect, ώστε το όριο ανά διεύθυνση να βλέπει τη διεύθυνση κάθε πελάτη. Η εικόνα εκτελείται ως χρήστης χωρίς προνόμια, κρατά την κατάστασή της στον τόμο /data και έχει ενσωματωμένο έλεγχο υγείας (cc-connect --healthcheck, που ελέγχει το /healthz: η διεργασία απαντά). Το /readyz ελέγχει επιπλέον ότι οι αποθήκες κατάστασης και δεσμεύσεων απαντούν και ότι το Redis, αν χρησιμοποιείται, εκτελείται με maxmemory-policy noeviction· δείξτε εκεί τον έλεγχο ετοιμότητας ενός orchestrator.
Η σελίδα συγκατάθεσης σύνδεσης απαντά με form post που το Connect δέχεται μόνο από τη δική του σελίδα: το Sec-Fetch-Site, όταν στέλνεται, πρέπει να είναι same-origin, και το Origin, όταν στέλνεται, πρέπει να είναι η προέλευση του CONNECT_PUBLIC_URL· ένα post χωρίς κανένα από τα δύο απορρίπτεται. Άρα ο διακομιστής μεσολάβησης πρέπει να περνά και τα δύο headers αναλλοίωτα, και το CONNECT_PUBLIC_URL πρέπει να είναι η διεύθυνση που χρησιμοποιούν πράγματι οι περιηγητές των ανθρώπων. Αν η συνέχεια από αυτή τη σελίδα δείχνει πάντα «Αυτός ο σύνδεσμος έχει λήξει» και το αρχείο καταγραφής δείχνει oauth.done_refused με αιτία origin ή no_origin, ένα από τα δύο είναι λάθος.
Το Connect αρνείται να εκκινήσει (κωδικός εξόδου 78) όταν η διαμόρφωσή του είναι
ανοιχτή, μη ασφαλής ή μισοτελειωμένη, και εκτυπώνει ποια μεταβλητή είναι λάθος.
Μια λίστα επιτρεπόμενων που λείπει, μια διεύθυνση http εκτός loopback, ένα
κακοσχηματισμένο κλειδί σφράγισης ή ταυτόχρονος ορισμός των NAME και
NAME_FILE το σταματούν όλα.
Σημείο ελέγχου: σε κάθε διακομιστή, η κάρτα Connect γράφει Λειτουργεί, και το
Πού εκτελείται κάθε σύνδεση αναφέρει Connect για κάθε πάροχο που
καταχωρίσατε. Το cc_server connect status εκτυπώνει Health: ok και τις ίδιες
λωρίδες.
Προσάρτηση του Connect μέσα στο cc_server
Ενότητα με τίτλο «Προσάρτηση του Connect μέσα στο cc_server»Ένας διακομιστής μπορεί να φιλοξενεί ο ίδιος το Connect αντί για ξεχωριστό κοντέινερ. Η προσαρτημένη υπηρεσία είναι η ίδια που εκτελεί η εικόνα.
- Βάλτε τις μεταβλητές
CONNECT_*στο αρχείο.envτου διακομιστή, όπως στο Βήμα 5. Ο διακομιστής αρνείται να εκκινήσει όταν ένα μυστικό του Connect, συμπεριλαμβανομένου τουCONNECT_SENTRY_DSN, είναι ορισμένο στο περιβάλλον του - Προσθέστε
CC_SERVER_CONNECT_HOST=on - Επανεκκινήστε τον διακομιστή. Το αρχείο καταγραφής του εκτυπώνει
embedded Connect at <url>
CC_SERVER_CONNECT_HOST=onCONNECT_ALLOWED_INSTALLS=<install id>CONNECT_SEAL_KEYS=<output of cc-connect-config seal-key>CONNECT_GITHUB_APP_ID=123456CONNECT_GITHUB_APP_SLUG=acme-control-centerCONNECT_GITHUB_CLIENT_ID=Iv23li0123456789abcdCONNECT_GITHUB_CLIENT_SECRET=<secret>CONNECT_GITHUB_APP_PRIVATE_KEY_FILE=/etc/cc/github_app_key.pemΤο Connect εξυπηρετείται τότε στο <server>/connect:
- Το
CONNECT_PUBLIC_URLέχει προεπιλογή την προέλευση του δημόσιου URL του διακομιστή συν/connect. Ορίστε το ρητά πίσω από διακομιστή μεσολάβησης. Η διαδρομή του πρέπει να είναι ακριβώς/connectκαι πρέπει να είναι HTTPS, εκτός αν είναι loopback - Μόνο οι μεταβλητές
CONNECT_*φτάνουν στην προσαρτημένη υπηρεσία, οπότε δεν δανείζεται ποτέ τις δικές εφαρμογές παρόχων του διακομιστή - Το
CONNECT_ALLOWED_INSTALLSεξακολουθεί να απαιτείται, και για τον ίδιο τον διακομιστή που το φιλοξενεί - Μια λανθασμένα διαμορφωμένη προσάρτηση εμποδίζει την εκκίνηση του διακομιστή, αντί να εξυπηρετεί έναν ανοιχτό μεσολαβητή
- Ο διακομιστής επίδειξης δεν το προσαρτά ποτέ
Καταχωρίστε τις ανακατευθύνσεις των παρόχων στο https://<server>/connect και
μετά κατευθύνετε τους διακομιστές (μαζί με αυτόν που το φιλοξενεί) σε εκείνο το URL
όπως στο Βήμα 3.
Αναφορά διαμόρφωσης
Ενότητα με τίτλο «Αναφορά διαμόρφωσης»Κάθε ρύθμιση είναι μια μεταβλητή περιβάλλοντος. Κάθε μυστικό μπορεί να προέρχεται
αντί γι’ αυτό από ένα προσαρτημένο αρχείο: ορίστε NAME_FILE στη θέση του NAME.
Το Connect διαβάζει ξανά το αρχείο το πολύ κάθε 30 δευτερόλεπτα και κρατά την
τελευταία έγκυρη τιμή. Τα μυστικά με την ένδειξη διπλό δέχονται επίσης
NAME_PREVIOUS (ή NAME_PREVIOUS_FILE) κατά τη διάρκεια μιας εναλλαγής.
Διεύθυνση και πρόσβαση
Ενότητα με τίτλο «Διεύθυνση και πρόσβαση»| Μεταβλητή | Προεπιλογή | Σημασία |
|---|---|---|
CONNECT_PUBLIC_URL |
απαιτείται | Το κανονικό δημόσιο URL. HTTPS, ή http μόνο στο loopback. Μια διαδρομή σημαίνει προσάρτηση. Χωρίς query ή fragment |
CONNECT_ALLOWED_INSTALLS |
απαιτείται | Αναγνωριστικά εγκατάστασης χωρισμένα με κόμμα. Το * γίνεται δεκτό μόνο μαζί με το CONNECT_SIGNED_CONFIG_FILE |
CONNECT_DENY_INSTALLS |
Αναγνωριστικά εγκατάστασης που απορρίπτονται ακόμη κι αν επιτρέπονται | |
CONNECT_GITHUB_ALLOWED_OWNERS |
Αριθμητικά id ιδιοκτητών GitHub. Όταν ορίζεται, tokens αποθετηρίου εκδίδονται μόνο για αποθετήρια που τους ανήκουν. Δεν περιορίζει ποιος συνδέεται: ένα πρόσωπο που επιτρέπεται να χρησιμοποιεί αυτό το Connect λαμβάνει ακόμη το δικό του token χρήστη της App. Για να εξυπηρετεί μόνο έναν οργανισμό, κρατήστε την App ιδιωτική σε αυτόν | |
CONNECT_GITHUB_REVIEW_BOT_INSTALLS |
Αναγνωριστικά εγκατάστασης που μπορούν να έχουν το bot της App να ανασκοπεί pull requests. Κενό από προεπιλογή· το * απορρίπτεται, και κάθε αναγνωριστικό πρέπει να είναι επιτρεπτό επίσης |
|
CONNECT_HOST, CONNECT_PORT |
0.0.0.0, 8790 |
Διεύθυνση σύνδεσης και θύρα |
CONNECT_TRUST_PROXY |
0 |
Αξιόπιστα βήματα διακομιστή μεσολάβησης στο X-Forwarded-For (0 έως 8). Χρησιμοποιείται μόνο για τα όρια ανά διεύθυνση, για την ένδειξη δικτύου της σελίδας σύνδεσης και για τη διεύθυνση που καταγράφεται. Πίσω από διακομιστή μεσολάβησης, το 0 μετράει κάθε πελάτη ως τον ίδιο τον διακομιστή μεσολάβησης, και το αρχείο καταγραφής το λέει μία φορά |
Λωρίδες παρόχων
Ενότητα με τίτλο «Λωρίδες παρόχων»| Μεταβλητή | Προεπιλογή | Σημασία |
|---|---|---|
CONNECT_GITHUB_APP_ID, CONNECT_GITHUB_APP_SLUG, CONNECT_GITHUB_CLIENT_ID |
Η GitHub App | |
CONNECT_GITHUB_CLIENT_SECRET |
Μυστικό, διπλό | |
CONNECT_GITHUB_APP_PRIVATE_KEY |
Μυστικό. Το ιδιωτικό κλειδί της App (PEM) | |
CONNECT_GOOGLE_CLIENT_ID, CONNECT_GOOGLE_CLIENT_SECRET |
Ο client της Google. Το μυστικό είναι διπλό | |
CONNECT_LINEAR_CLIENT_ID |
Η εφαρμογή Linear. Χωρίς μυστικό | |
CONNECT_SLACK_APP_ID, CONNECT_SLACK_CLIENT_ID |
Η εφαρμογή Slack | |
CONNECT_SLACK_CLIENT_SECRET, CONNECT_SLACK_SIGNING_SECRET |
Μυστικά, διπλά | |
CONNECT_KLIPY_APP_KEY |
Κλειδί αναζήτησης GIF του Klipy. Μυστικό, διπλό | |
CONNECT_KLIPY_MODE |
proxy |
Το proxy κρατά το κλειδί στο Connect· το key το παραδίδει στους διακομιστές |
CONNECT_<LANE>_SECRET_GENERATION |
1 |
GitHub, Google και Slack: η γενιά που καταγράφεται στις νέες σφραγίδες |
CONNECT_<LANE>_MIN_SEAL_GENERATION |
1 |
GitHub, Google και Slack: για παλαιότερες σφραγίδες απαιτείται νέα σύνδεση |
CONNECT_<LANE>_ACCEPTS_NEW |
true |
Κάθε λωρίδα: το false σταματά τις νέες συνδέσεις ενώ οι υπάρχουσες συνεχίζουν να ανανεώνονται |
Σφραγίδες, κατάσταση και αποθήκευση
Ενότητα με τίτλο «Σφραγίδες, κατάσταση και αποθήκευση»| Μεταβλητή | Προεπιλογή | Σημασία |
|---|---|---|
CONNECT_SEAL_BACKEND |
local |
local ή gcp-kms |
CONNECT_SEAL_KEYS |
Μυστικό, απαιτείται για local. Καταχωρίσεις kid:key χωρισμένες με κόμμα, η νεότερη πρώτη· οι παλαιότερες εξακολουθούν να αποκρυπτογραφούν |
|
CONNECT_KMS_KEY |
projects/…/locations/…/keyRings/…/cryptoKeys/…, απαιτείται για gcp-kms |
|
CONNECT_STATE |
memory |
memory για ένα στιγμιότυπο, redis για περισσότερα. Μια γεμάτη αποθήκη μνήμης απορρίπτει νέες συνδέσεις και αιτήματα αντί να ξεχάσει μια ζωντανή εγγραφή |
CONNECT_REDIS_URL |
Μυστικό. redis:// ή rediss://. Redis 6.2 ή νεότερο με maxmemory-policy noeviction, και τα δύο ελέγχονται κατά την εκκίνηση |
|
CONNECT_REDIS_CA_FILE |
Δέσμη CA για rediss:// |
|
CONNECT_BINDINGS |
file |
Πού βρίσκονται οι δεσμεύσεις ομάδων Slack: file ή firestore |
CONNECT_DATA_DIR |
data (/data στην εικόνα) |
Περιέχει το bindings.json. Το κλειδώνει ένα Connect· ένα δεύτερο στον ίδιο κατάλογο δεν εκκινεί |
CONNECT_FIRESTORE_PROJECT, CONNECT_FIRESTORE_DATABASE |
βάση δεδομένων (default) |
Για CONNECT_BINDINGS=firestore. Το Connect δεν εκκινεί όταν το Firestore δεν απαντά |
Διαμόρφωση, αρχεία καταγραφής και όρια
Ενότητα με τίτλο «Διαμόρφωση, αρχεία καταγραφής και όρια»| Μεταβλητή | Προεπιλογή | Σημασία |
|---|---|---|
CONNECT_SIGNED_CONFIG_FILE |
Μια διαμόρφωση υπογεγραμμένη εκτός σύνδεσης, που εξυπηρετείται ως έχει. Τη χρησιμοποιεί το φιλοξενούμενο Connect του Control Center | |
CONNECT_CONFIG_PUBLIC_KEYS |
Κλειδιά με τα οποία πρέπει να επαληθεύεται η υπογεγραμμένη διαμόρφωση | |
CONNECT_CONFIG_EPOCH |
1 |
Η εποχή της διαμόρφωσης που παράγει ένα αυτοφιλοξενούμενο Connect |
CONNECT_LOG_HMAC_KEY |
τυχαίο ανά διεργασία | Μυστικό. Ορίστε το ώστε οι ετικέτες που αντικαθιστούν τα αναγνωριστικά εγκατάστασης να μένουν σταθερές σε επανεκκινήσεις και στιγμιότυπα |
CONNECT_SENTRY_DSN |
Μυστικό. Ένα https Sentry DSN στο οποίο αναφέρονται οι γραμμές σφαλμάτων: ο τύπος σφάλματος, τα stack frames, η διαδρομή και το αναγνωριστικό αιτήματος, ποτέ μήνυμα, σώμα ή κεφαλίδα | |
CONNECT_SENTRY_ENVIRONMENT |
self-hosted |
Το περιβάλλον του Sentry |
CONNECT_VERSION, CONNECT_IMAGE_DIGEST |
Αναφέρονται από το /v1/version |
|
CONNECT_RATE_INSTALL_PER_MINUTE |
600 |
Αιτήματα ανά εγκατάσταση |
CONNECT_RATE_IP_PER_MINUTE |
300 |
Αιτήματα ανά διεύθυνση (μια διεύθυνση IPv6 μετράει ανά /64) |
CONNECT_RATE_GLOBAL_PER_SECOND |
500 |
Αιτήματα για ολόκληρο το στιγμιότυπο |
CONNECT_RATE_SLACK_HOOK_IP_PER_MINUTE |
600 |
Συμβάντα και εντολές Slack ανά διεύθυνση, μετρημένα χωριστά από τα άλλα αιτήματα |
CONNECT_RATE_SLACK_HOOK_GLOBAL_PER_SECOND |
100 |
Συμβάντα και εντολές Slack για ολόκληρο το στιγμιότυπο |
CONNECT_RATE_SLACK_TEAM_PER_MINUTE |
600 |
Συμβάντα Slack ανά ομάδα |
CONNECT_RATE_KLIPY_PER_MINUTE |
120 |
Αναζητήσεις GIF ανά εγκατάσταση |
CONNECT_RATE_KLIPY_IP_PER_MINUTE |
240 |
Αναζητήσεις GIF ανά διεύθυνση, σε όλους τους διακομιστές |
CONNECT_RATE_LOGINS_IP_PER_10_MINUTES |
60 |
Συνδέσεις που ξεκινούν ανά διεύθυνση |
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_PER_HOUR |
30 |
Tokens GitHub που εκδίδονται ανά λογαριασμό GitHub σε έναν διακομιστή (συνδέσεις, ανανεώσεις, tokens αποθετηρίων) |
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_CEILING_PER_HOUR |
4 × το παραπάνω (120) |
Το ίδιο ανά λογαριασμό GitHub σε όλους τους διακομιστές |
CONNECT_RATE_GITHUB_TOKENS_IP_PER_HOUR |
600 |
Tokens GitHub που εκδίδονται ανά διεύθυνση |
CONNECT_RATE_GITHUB_EXCHANGE_CEILING_PER_HOUR |
500 |
Νέες συνδέσεις GitHub για ολόκληρη την εφαρμογή |
CONNECT_RATE_GITHUB_APP_MINTS_INSTALL_PER_HOUR |
120 |
Tokens bot ανά διακομιστή |
CONNECT_RATE_GITHUB_APP_MINTS_ACCOUNT_PER_HOUR |
240 |
Tokens bot ανά λογαριασμό GitHub που ζητά, σε όλους τους διακομιστές |
CONNECT_RATE_GITHUB_APP_CEILING_PER_HOUR |
3000 |
Tokens bot για ολόκληρη την εφαρμογή |
CONNECT_RATE_GITHUB_TOKEN_CEILING_PER_HOUR |
1500 |
Ανανεώσεις και tokens αποθετηρίων για ολόκληρη την εφαρμογή. Οι νέες συνδέσεις έχουν το δικό τους όριο παραπάνω |
CONNECT_GITHUB_TOKEN_CAP_WARN |
10 |
Ζωντανά tokens αποθετηρίων που μπορεί να έχει ένας λογαριασμός GitHub πριν το Connect καταγράψει προειδοποίηση |
CONNECT_RATE_RETIRE_IP_PER_HOUR |
10 |
Αναγνωριστικά εγκατάστασης που ανακαλούνται ανά διεύθυνση (ανά /48 για IPv6) |
Κλήση πέρα από όριο απαντάται rate_limited. Οι διακομιστές ξαναδοκιμάζουν αργότερα και δεν αποσυνδέουν ποτέ κανέναν εξαιτίας αυτού.
Εκτέλεση περισσότερων από ένα στιγμιότυπων
Ενότητα με τίτλο «Εκτέλεση περισσότερων από ένα στιγμιότυπων»Ένα στιγμιότυπο με CONNECT_STATE=memory αρκεί για τους περισσότερους
οργανισμούς. Πολλά στιγμιότυπα πίσω από μία διεύθυνση χρειάζονται CONNECT_STATE=redis και
CONNECT_BINDINGS=firestore, ώστε μια σύνδεση που ξεκίνησε σε ένα στιγμιότυπο να
μπορεί να ολοκληρωθεί σε άλλο και κάθε στιγμιότυπο να βλέπει τις ίδιες δεσμεύσεις
Slack και τα ίδια ανακληθέντα αναγνωριστικά εγκατάστασης. Ένας κοινόχρηστος
CONNECT_DATA_DIR δεν δουλεύει: το πρώτο Connect τον κλειδώνει. Τα όρια αιτημάτων
ανά εγκατάσταση, ανά διεύθυνση και για ολόκληρο το στιγμιότυπο ισχύουν ανά
στιγμιότυπο· τα όρια για συνδέσεις, tokens GitHub, tokens bot, αναζητήσεις GIF ανά
διεύθυνση, ανακλήσεις και ομάδες Slack είναι κοινά μέσω της αποθήκης κατάστασης.
Εναλλαγή μυστικού παρόχου
Ενότητα με τίτλο «Εναλλαγή μυστικού παρόχου»Κανείς δεν αποσυνδέεται:
- Δημιουργήστε το νέο μυστικό στον πάροχο και κρατήστε το παλιό
- Μεταφέρετε την παλιά τιμή στο
NAME_PREVIOUS, βάλτε τη νέα στοNAMEκαι αυξήστε τοCONNECT_<LANE>_SECRET_GENERATION. Τα προσαρτημένα αρχεία εντοπίζονται μέσα σε 30 δευτερόλεπτα - Περιμένετε να ανανεωθούν οι συνδέσεις, μετά διαγράψτε το παλιό μυστικό στον
πάροχο και αφαιρέστε το
NAME_PREVIOUS
Για να εναλλάξετε ένα κλειδί σφράγισης, βάλτε μια νέα καταχώριση
cc-connect-config seal-key πρώτη στο CONNECT_SEAL_KEYS και κρατήστε την παλιά
καταχώριση μέχρι να ανανεωθούν οι σφραγίδες της.
Αλλαγή εφαρμογής
Ενότητα με τίτλο «Αλλαγή εφαρμογής»Οι διακομιστές θυμούνται τα id εφαρμογής και client που ανακοίνωσε το Connect σας την πρώτη φορά που το χρησιμοποίησαν. Αν αντικαταστήσετε μια εφαρμογή, η κάρτα Connect κάθε διακομιστή δείχνει Οι εφαρμογές του Connect άλλαξαν, και οι συνδέσεις μέσω του Connect παύουν μέχρι ο ιδιοκτήτης του να πατήσει Εμπιστοσύνη στις νέες εφαρμογές. Ενημερώστε τους ιδιοκτήτες διακομιστών πριν κάνετε την αλλαγή, ώστε να ξέρουν ότι το μήνυμα προέρχεται από εσάς.
Αποκλεισμός διακομιστή
Ενότητα με τίτλο «Αποκλεισμός διακομιστή»Προσθέστε το αναγνωριστικό εγκατάστασής του στο CONNECT_DENY_INSTALLS και κάντε
επανεκκίνηση. Ο ιδιοκτήτης του βλέπει «Το Connect έχει αποκλείσει το
αναγνωριστικό εγκατάστασης αυτού του διακομιστή. Επικοινωνήστε με τον διαχειριστή του διακομιστή Connect σας.» και κάθε σύνδεση μέσω Connect σε αυτόν σταματά.
Ένας διακομιστής ανακαλεί επίσης το παλιό αναγνωριστικό εγκατάστασής του όταν ο ιδιοκτήτης του εναλλάσσει το κλειδί. Αποδεικνύει ότι το αναγνωριστικό είναι δικό του με μία σφράγιση διαπιστευτηρίου που έκανε για αυτόν αυτό το Connect, οπότε μόνο ένας διακομιστής που έχει ήδη συνδέσει κάποιον μπορεί να ανακαλέσει ένα αναγνωριστικό. Το Connect κρατά τα ανακληθέντα αναγνωριστικά για πάντα, οπότε το παλιό κλειδί και κάθε σφράγιση που έγινε για αυτό παύουν να λειτουργούν, και αποδεσμεύει τους χώρους εργασίας Slack που ήταν δεμένοι με το παλιό αναγνωριστικό. Τα tokens που έχουν ήδη δοθεί λήγουν μόνα τους: μέσα σε 8 ώρες για των ανθρώπων, 1 ώρα για των bot. Το Connect κρατά το πολύ 100.000 ανακληθέντα αναγνωριστικά· πέρα από αυτό, μια εναλλαγή απορρίπτεται και το αρχείο καταγραφής το λέει σε επίπεδο σφάλματος.
Αντιμετώπιση προβλημάτων
Ενότητα με τίτλο «Αντιμετώπιση προβλημάτων»Ένας διακομιστής λέει ότι το Connect τον έχει αποκλείσει
Ενότητα με τίτλο «Ένας διακομιστής λέει ότι το Connect τον έχει αποκλείσει»Το αναγνωριστικό εγκατάστασής του δεν βρίσκεται στο CONNECT_ALLOWED_INSTALLS, βρίσκεται
στο CONNECT_DENY_INSTALLS, ή ανακλήθηκε από εναλλαγή κλειδιού. Το αναγνωριστικό αλλάζει
όταν ο ιδιοκτήτης του εναλλάσσει το κλειδί· ζητήστε το νέο.
Κάθε σύνδεση σε έναν πάροχο αποτυγχάνει
Ενότητα με τίτλο «Κάθε σύνδεση σε έναν πάροχο αποτυγχάνει»Μπορεί να λείπει μία από τις μεταβλητές του, οπότε το Connect άφησε τη λωρίδα εκτός. Ελέγξτε το αρχείο καταγραφής εκκίνησης και τους παραπάνω πίνακες. Το GitHub χρειάζεται και τα πέντε: app id, slug, client id, client secret και ιδιωτικό κλειδί· η Google χρειάζεται και το client id και το μυστικό.
Οι συνδέσεις αποτυγχάνουν με αναντιστοιχία ανακατεύθυνσης
Ενότητα με τίτλο «Οι συνδέσεις αποτυγχάνουν με αναντιστοιχία ανακατεύθυνσης»Η ανακατεύθυνση που καταχωρίστηκε στον πάροχο δεν ταιριάζει ακριβώς με το
CONNECT_PUBLIC_URL. Συγκρίνετε σχήμα, κεντρικό υπολογιστή, θύρα και, για ένα
προσαρτημένο Connect, τη διαδρομή /connect.
Όλοι χρειάστηκε να συνδεθούν ξανά
Ενότητα με τίτλο «Όλοι χρειάστηκε να συνδεθούν ξανά»Το κλειδί σφράγισης άλλαξε ή χάθηκε, ένας διακομιστής έκανε εναλλαγή του κλειδιού του ή τα δεδομένα ενός διακομιστή επαναφέρθηκαν σε άλλο μηχάνημα. Ένα σφραγισμένο διαπιστευτήριο ανοίγει μόνο για την εγκατάσταση και το Connect που το δημιούργησαν.