ΣύνδεσηΚλείστε μια ενημέρωση

Κεφάλαιο 2.15

Δεύτερη ημέρα: λειτουργία του Nexus

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

Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

18 λεπτά ανάγνωσης

Την πρώτη φορά που έπεσε το ρεύμα στο server room της Harrow Port Authority, όλα επανήλθαν εκτός από τα μέρη που χρειάζονταν κλειδιά. Τα pods βρίσκονταν σε κατάσταση Running και η κονσόλα φόρτωνε. Κανείς δεν μπορούσε να ανοίξει κάποιο αρχείο. Ο Tomás Reilly είχε διαβάσει γι' αυτό, κι όμως του πήρε είκοσι λεπτά για να θυμηθεί το γιατί. Ο μηχανισμός αποσφράγισης του χώρου αποθήκευσης κλειδιών ξεκινά σφραγισμένος μετά από κάθε επανεκκίνηση του κόμβου του και μόνο ένας θεματοφύλακας (custodian) μπορεί να τον ανοίξει.

Αυτό το κεφάλαιο ακολουθεί τη ρουτίνα του χειριστή μετά την πρώτη εβδομάδα, από τον χώρο αποθήκευσης κλειδιών και τους θεματοφύλακές του έως την απεγκατάσταση. Κάθε ρήμα της εντολής nexusctl εδώ δέχεται την παράμετρο --explain, η οποία εμφανίζει τις λειτουργίες kubectl και helm που θα εκτελούσε, χωρίς να τις εκτελέσει. Χρησιμοποιήστε την την πρώτη φορά που εκτελείτε οτιδήποτε σε ένα cluster παραγωγής.

Φύλαξη χώρου αποθήκευσης κλειδιών

Μια εγκατάσταση διαθέτει δύο διακομιστές OpenBao στο namespace της. Ο χώρος αποθήκευσης κλειδιών, openbao, φυλάσσει κάθε κλειδί που χρησιμοποιεί το Nexus. Ο μηχανισμός αποσφράγισης (unsealer), openbao-unsealer, είναι ένας δεύτερος, μικρός OpenBao του οποίου η μόνη εργασία είναι να αποσφραγίζει τον χώρο αποθήκευσης κλειδιών. Ο χώρος αποθήκευσης κλειδιών αποσφραγίζεται μόνος του μέσω του transit key του μηχανισμού αποσφράγισης· ο μηχανισμός αποσφράγισης σφραγίζεται με το σχήμα του Shamir, ως 5 μερίδια (shares) εκ των οποίων οποιαδήποτε 3 τον αποσφραγίζουν.

Κατά την πρώτη εγκατάσταση, ένα custody Job αρχικοποιεί και τους δύο διακομιστές εντός του cluster. Κρυπτογραφεί τα μερίδια του μηχανισμού αποσφράγισης και τα κλειδιά ανάκτησης του χώρου αποθήκευσης κλειδιών στη δική του μνήμη για κάθε θεματοφύλακα που κατονομάζεται στο keys.custody.recipients, και αποθηκεύει μόνο το κρυπτογραφημένο κείμενο (τα Secrets openbao-unseal-shares-encrypted και openbao-recovery-keys-encrypted). Ανακαλεί και τα δύο root tokens στο ίδιο Job. Το πακέτο κάθε θεματοφύλακα περιέχει αρκετά μερίδια ώστε να κάνει την αποσφράγιση μόνο του, επομένως ένας θεματοφύλακας είναι το μόνο που χρειάζεστε μετά από μια επανεκκίνηση.

Μετά από επανεκκίνηση κόμβου

Μετά από οποιαδήποτε επανεκκίνηση του κόμβου στον οποίο εκτελείται ο μηχανισμός αποσφράγισης (διακοπή ρεύματος, επανεκκίνηση μηχανήματος, επανεκκίνηση του container runtime), ο μηχανισμός αποσφράγισης ξεκινά σφραγισμένος. Μέχρι να τον αποσφραγίσει ένας θεματοφύλακας, ο χώρος αποθήκευσης κλειδιών παραμένει επίσης σφραγισμένος και δεν λειτουργεί τίποτα που χρειάζεται κλειδί. Η κονσόλα εξακολουθεί να αποκρίνεται και οι χρήστες μπορούν να συνδεθούν, αλλά οποιαδήποτε ενέργεια χρειάζεται κλειδί από τον χώρο αποθήκευσης κλειδιών μπαίνει σε αναμονή: το άνοιγμα κρυπτογραφημένου περιεχομένου, ένα αίτημα (claim), ένας έλεγχος ενός μεταγλωττισμένου τμήματος.

Ρωτήστε το ίδιο το OpenBao, μέσα σε κάθε pod. Αυτός είναι ο μηχανισμός αποσφράγισης:

kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
  bao status -format=json -address=https://127.0.0.1:8200 \
  -ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"

Εκτελέστε την ίδια εντολή στο openbao-0 με -tls-server-name=openbao για τον χώρο αποθήκευσης κλειδιών. Η εντολή bao status επιστρέφει τον κωδικό εξόδου 0 όταν ο διακομιστής είναι αποσφραγισμένος, 2 όταν είναι σφραγισμένος και 1 όταν δεν μπόρεσε να απαντήσει. Ένας κωδικός εξόδου 1 δεν οδηγεί σε κανένα συμπέρασμα, επειδή το pod μπορεί να μην έχει ξεκινήσει ακόμα. Περιμένετε ένα λεπτό και ρωτήστε ξανά. Εάν ο μηχανισμός αποσφράγισης είναι αποσφραγισμένος και ο χώρος αποθήκευσης κλειδιών είναι ακόμα σφραγισμένος, ο χώρος αποθήκευσης κλειδιών αποσφραγίζεται μόνος του και δεν χρειάζεται να κάνετε τίποτα.

Αριστερά: ένα εικονίδιο ατόμου με την ετικέτα «Θεματοφύλακας, με τη δική του ταυτότητα age». Ένα βέλος πηγαίνει δεξιά σε ένα πλαίσιο «unseal.sh στο μηχάνημα του θεματοφύλακα (μία αποκρυπτογράφηση)». Από εκεί, ένα βέλος με την ετικέτα «kubectl port-forward, έλεγχος Transport Layer Security (TLS) έναντι της αρχής πιστοποίησης (CA) του μηχανισμού αποσφράγισης» πηγαίνει σε ένα πλαίσιο «openbao-unsealer (5 μερίδια Shamir, οποιαδήποτε 3)». Από τον μηχανισμό αποσφράγισης, ένα δεύτερο βέλος με την ετικέτα «transit key, αυτόματο» πηγαίνει σε ένα πλαίσιο «openbao, ο χώρος αποθήκευσης κλειδιών». Από τον χώρο αποθήκευσης κλειδιών, μια βεντάλια από βέλη κατευθύνεται σε μικρά πλαίσια «nexus-keys», «nexus-auth», «οι υπόλοιπες υπηρεσίες». Μια σημείωση κάτω από τον θεματοφύλακα: «η ταυτότητα δεν φεύγει ποτέ από αυτό το μηχάνημα».
Τι κάνει ένας θεματοφύλακας μετά από επανεκκίνηση κόμβου.

Αποσφράγιση

Το chart περιλαμβάνει το unseal.sh, στον φάκελό του files/custody/, πανομοιότυπο byte προς byte σε κάθε έκδοση. Ένας θεματοφύλακας το εκτελεί στο δικό του μηχάνημα. Διαβάζει το κρυπτογραφημένο Secret, το αποκρυπτογραφεί μία φορά με την ταυτότητα του θεματοφύλακα (μια ταυτότητα Secure Enclave ζητά Touch ID μία φορά), υποβάλλει τα μερίδια στον μηχανισμό αποσφράγισης και επιβεβαιώνει ότι αποσφραγίστηκε. Κανένα μερίδιο δεν εγγράφεται ποτέ σε αρχείο ούτε τοποθετείται σε γραμμή εντολών.

Η Harrow το εκτελεί σε άμεση λειτουργία (direct mode), μέσω ενός port-forward:

kubectl -n nexus get secret openbao-unsealer-tls -o jsonpath='{.data.ca\.crt}' | base64 -d > unsealer-ca.crt
kubectl -n nexus port-forward pod/openbao-unsealer-0 28200:8200 &

AGE_IDENTITY=<path-to-your-custodian-identity> \
OPENBAO_NS=nexus \
UNSEAL_ADDR=https://127.0.0.1:28200 \
UNSEAL_CACERT=unsealer-ca.crt \
UNSEAL_RESOLVE=openbao-unsealer.<namespace>.svc \
UNSEAL_SECRET_JSON_CMD='kubectl -n nexus get secret openbao-unseal-shares-encrypted -o json' \
bash unseal.sh

Το <path-to-your-custodian-identity> είναι το αρχείο ταυτότητας age του θεματοφύλακα, το ιδιωτικό ήμισυ ενός από τους παραλήπτες στο keys.custody.recipients. Το UNSEAL_RESOLVE είναι το όνομα που φέρει το πιστοποιητικό του μηχανισμού αποσφράγισης (το <namespace> είναι το namespace στο οποίο είναι εγκατεστημένο το Nexus, nexus από προεπιλογή), επομένως το TLS ελέγχεται έναντι της CA του ίδιου του μηχανισμού αποσφράγισης, παρόλο που η σύνδεση πηγαίνει στο 127.0.0.1. Το σενάριο (script) δεν απενεργοποιεί ποτέ τον έλεγχο πιστοποιητικών.

Έξοδος Τελευταία γραμμή Σημασία
0 UNSEALED nexus/openbao-unsealer-0 Αποσφραγίστηκε. Εάν ήταν ήδη, δεν στάλθηκε τίποτα
1 STILL-SEALED … Ακόμα σφραγισμένο, ή απέτυχε μια κλήση αποσφράγισης
2 UNSEAL-REFUSED … Λείπει ένα προαπαιτούμενο, το οποίο κατονομάζεται στο μήνυμα
3 UNSEAL-REFUSED … Αυτή η ταυτότητα δεν μπορεί να αποκρυπτογραφήσει τα μερίδια, επομένως δεν είναι θεματοφύλακας αυτής της εγκατάστασης. Δεν στάλθηκε τίποτα

Μέσα σε ένα λεπτό ο χώρος αποθήκευσης κλειδιών ακολουθεί από μόνος του. Ελέγξτε με το kubectl -n nexus get deploy,statefulset ότι όλα είναι και πάλι έτοιμα.

Οι θεματοφύλακες επιλέγονται πριν από την εγκατάσταση και ο καθένας δημιουργεί το δικό του κλειδί στο δικό του μηχάνημα. Το chart βλέπει μόνο το δημόσιο ήμισυ:

age-keygen -o custodian.key
age-plugin-se keygen --access-control=any-biometry -o custodian.key

Η πρώτη εντολή δημιουργεί μια τυπική ταυτότητα age· ο παραλήπτης της είναι η γραμμή # public key: age1... στο αρχείο. Η δεύτερη δημιουργεί μία που φυλάσσεται στο Secure Enclave ενός Mac, με παραλήπτη που ξεκινά με age1se1. Οποιοσδήποτε από τους δύο παραλήπτες μπαίνει στο keys.custody.recipients. Το αρχείο ταυτότητας παραμένει στον θεματοφύλακά του, εκτός σύνδεσης (offline).

Δημιουργία αντιγράφων ασφαλείας και επαναφορά

Η σελίδα «Δημιουργία αντιγράφων ασφαλείας και επαναφορά» (Back up and restore) εμφανίζει κάθε χώρο αποθήκευσης με το τελευταίο του αντίγραφο ασφαλείας και την τελευταία φορά που δοκιμάστηκε πραγματικά μια επαναφορά του. Ένα αντίγραφο ασφαλείας αποδεικνύεται αξιόπιστο μόνο αφού επαναφερθεί, επομένως η σελίδα παρακολουθεί και τα δύο. Δημιουργούνται αντίγραφα ασφαλείας για έξι χώρους αποθήκευσης. Η κύρια βάση δεδομένων περιέχει τα άτομα και τις ρυθμίσεις, τις εργασίες και το αρχείο καταγραφής ελέγχου (audit log). Δίπλα της βρίσκονται το γράφημα γνώσης (knowledge graph) και το ευρετήριο αναζήτησης, και έπειτα ο χώρος αποθήκευσης αρχείων και ο χώρος αποθήκευσης μνήμης. Τα κλειδιά είναι ο έκτος χώρος, σφραγισμένα και φυλαγμένα χωριστά από τα δεδομένα. Τα αντίγραφα ασφαλείας πηγαίνουν στον δικό σας χώρο αποθήκευσης, κρυπτογραφημένα με τα δικά σας κλειδιά, και η Adverant δεν μπορεί να τα διαβάσει. Όταν ένας χώρος αποθήκευσης δεν έχει υποβληθεί σε δοκιμαστική επαναφορά εντός του κανόνα που έχετε ορίσει, η σελίδα εμφανίζει την ένδειξη RESTORE_TEST_OVERDUE με ένα κουμπί «Δοκιμή τώρα» (Test it now). Μια δοκιμαστική επαναφορά εκτελείται σε ξεχωριστό χώρο και κανείς δεν την αντιλαμβάνεται.

Οι ίδιες δύο ενέργειες είναι διαθέσιμες από τη γραμμή εντολών:

nexusctl backup now
nexusctl backup verify

Το backup now λαμβάνει ένα αντίγραφο ασφαλείας κάθε χώρου αποθήκευσης ταυτόχρονα. Το backup verify ελέγχει το πιο πρόσφατο αντίγραφο ασφαλείας. Εκτελέστε και τα δύο πριν από οποιαδήποτε αλλαγή σας προκαλεί ανησυχία.

Δημιουργία αντιγράφων ασφαλείας και επαναφορά
Δημιουργία αντιγράφων ασφαλείας και επαναφορά
Κάθε χώρος αποθήκευσης με το τελευταίο του αντίγραφο ασφαλείας και την τελευταία δοκιμασμένη επαναφορά του. Το ευρετήριο αναζήτησης έχει καθυστερήσει να υποβληθεί σε δοκιμή και η ένδειξη προσφέρει την εκτέλεση μίας τώρα.

Για να κάνετε επαναφορά, ορίζετε το όνομα του αντιγράφου ασφαλείας:

nexusctl restore --from <backup-id>

Το <backup-id> προέρχεται από τη λίστα στη σελίδα «Δημιουργία αντιγράφων ασφαλείας και επαναφορά». Μια επαναφορά χρειάζεται ένα δεύτερο άτομο για να την εγκρίνει και, ενώ εκτελείται, η λωρίδα προόδου την εμφανίζει μαζί με την ώρα που ξεκίνησε και το ποιος την ενέκρινε. Όλοι έχουν πρόσβαση μόνο για ανάγνωση κατά τη διάρκεια της επαναφοράς, κάτι που διαφέρει από τον αποκλεισμό πρόσβασης: οι χρήστες μπορούν να συνδεθούν και να διαβάσουν. Οι εργασίες δεν ξεκινούν (οι προγραμματισμένες εργασίες περιμένουν και αναπληρώνουν αργότερα) και η αναζήτηση επανέρχεται όταν επιστρέψει το ευρετήριο αναζήτησης. Οτιδήποτε γράφτηκε μετά τη λήψη του αντιγράφου ασφαλείας χάνεται, επομένως η αναφορά επαναφοράς το καταγράφει ανά κάτοχο ώστε να μπορούν να το επαναλάβουν.

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

Κρατήστε ένα ακόμη στοιχείο μαζί με τα αντίγραφα ασφαλείας σας: το Secret nexus-generated στο namespace nexus. Το chart δημιουργεί τους παραγόμενους κωδικούς πρόσβασης και τα κλειδιά κρυπτογράφησης της εγκατάστασης κατά την πρώτη εγκατάσταση και τα διαβάζει ξανά από αυτό το Secret σε κάθε αναβάθμιση. Τα δεδομένα που είναι σφραγισμένα υπό το EXTERNAL_KEY_ENCRYPTION_KEY ανοίγουν μόνο με αυτό το κλειδί. Αποθηκεύστε ένα αντίγραφο του Secret όπου φυλάσσετε το πιο ευαίσθητο υλικό που έχετε, επειδή όποιος το κατέχει, κατέχει και αυτά τα κλειδιά.

Αναβαθμίσεις

Ο Tomás κάνει την αναβάθμιση σε δύο βήματα. Πρώτα ρωτά τι θα αλλάξει:

nexusctl upgrade plan --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tar

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

nexusctl upgrade apply --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tar

Η εφαρμογή λαμβάνει πρώτα ένα αντίγραφο ασφαλείας και εκτελεί τον προκαταρκτικό έλεγχο (preflight). Στη συνέχεια μετακινεί τις μηχανές (engines) κατά κύματα και κάθε κύμα περιμένει μέχρι το προηγούμενο να παραμείνει υγιές για 10 λεπτά. Η σελίδα «Αναβάθμιση» (Upgrade) εμφανίζει κάθε κύμα καθώς εξελίσσεται και την υγεία της εγκατάστασης στο μεταξύ. Αναφέρει επίσης μέχρι πότε παραμένει ανοιχτός ο δρόμος της επιστροφής· μετά από αυτή την ημερομηνία, η επιστροφή στην προηγούμενη κατάσταση απαιτεί επαναφορά από αντίγραφο ασφαλείας. Εάν ένα βήμα αποτύχει, το Nexus επαναφέρει (rolls back) κάθε μηχανή στην προηγούμενη έκδοση και τις ελέγχει. Η ειδοποίηση UPGRADE_ROLLED_BACK κατονομάζει τότε το βήμα που απέτυχε και αναφέρει ότι τα δεδομένα δεν αλλάχθηκαν. Η οδηγία διόρθωσης εμφανίζεται πριν από το κουμπί «Δοκιμάστε ξανά» (Try again) και το πακέτο υποστήριξης απέχει μόλις ένα κλικ.

Για μια εγκατάσταση χωρίς εξωτερική σύνδεση, το πακέτο καταφθάνει σε αποθηκευτικό μέσο. Η «Εισαγωγή από μέσο» (Import from media) ελέγχει την υπογραφή της έκδοσης έναντι του κλειδιού έκδοσης της Adverant που είναι εγκατεστημένο στην εγκατάσταση και ελέγχει ότι οι εκδόσεις προχωρούν μόνο προς τα εμπρός. Τα αρχεία που έχουν υπογραφεί από οποιονδήποτε άλλον απορρίπτονται με MEDIA_SIGNATURE_INVALID: δεν φορτώνεται τίποτα και η τρέχουσα έκδοση συνεχίζει να εκτελείται.

Αναβάθμιση
Αναβάθμιση
Μια αναβάθμιση σε εξέλιξη. Λήφθηκε πρώτα ένα αντίγραφο ασφαλείας, το δεύτερο από τα τρία κύματα βρίσκεται σε κίνηση και ο δρόμος της επιστροφής παραμένει ανοιχτός μέχρι μια καθορισμένη ημερομηνία.
Η αναβάθμιση απέτυχε και έγινε επαναφορά στην προηγούμενη έκδοση
Η αναβάθμιση απέτυχε και έγινε επαναφορά στην προηγούμενη έκδοση
Ένα κύμα απέτυχε επειδή εξαντλήθηκε ο χώρος σε έναν τόμο (volume). Κάθε μηχανή έχει επιστρέψει στην προηγούμενη έκδοση με τα δεδομένα ανέπαφα, και η οδηγία διόρθωσης παρατίθεται πριν από το «Δοκιμάστε ξανά».

Τι συμβαίνει στο παρασκήνιο

Το nexusctl upgrade apply εκτελεί το helm upgrade στο chart. Εάν κάνετε την αναβάθμιση με το Helm μόνοι σας, ισχύουν οι ίδιοι κανόνες:

helm upgrade nexus oci://registry.adverant.ai/nexus/charts/nexus --version <version> -n nexus -f harrow-values.yaml
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s

Το σχήμα (schema) μετακινείται πριν ξεκινήσουν τα νέα pods. Οι μεταφορές (migrations) του chart είναι pre-upgrade hooks που εκτελούνται με τη σειρά: πρώτα το bootstrap της βάσης δεδομένων, έπειτα οι μεταφορές κάθε υπηρεσίας και, τέλος, εκείνες του backend for frontend (BFF) της κονσόλας. Το custody Job εκτελείται επίσης και, σε μια εγκατάσταση που έχει ήδη αρχικοποιηθεί, το επιβεβαιώνει και δεν αλλάζει τίποτα. Κάθε hook Job έχει όριο επανάληψης (backoff limit) 0, επομένως μια μεταφορά που αποτυγχάνει σταματά την αναβάθμιση και δεν επαναλαμβάνεται ποτέ σιωπηλά: διαβάστε το αρχείο καταγραφής της με το kubectl -n nexus logs job/<hook-job> πριν δοκιμάσετε ξανά.

Το pod κάθε υπηρεσίας περιμένει σε ένα init container, το wait-for-schema, μέχρι το καθολικό εκδόσεων (release ledger) να δείξει ότι οι μεταφορές του έχουν εφαρμοστεί για το image της νέας έκδοσης. Μετά από μια επαναφορά στην προηγούμενη έκδοση (rollback), ή μια αναβάθμιση που άλλαξε μόνο τιμές (values), ένα pod που επανεκκινείται βρίσκει την εγγραφή του και ξεκινά αμέσως.

Πριν από την αναβάθμιση

Τρία σημεία από τις σημειώσεις έκδοσης αξίζουν προγραμματισμό:

  1. Κάντε την αναβάθμιση σε μια ήσυχη περίοδο. Κατά την πρώτη αναβάθμιση μιας εγκατάστασης που δημιουργήθηκε από παλαιότερο chart, η εργασία bootstrap αφαιρεί τα παλιά προεπιλεγμένα δικαιώματα πινάκων και κάθε υπηρεσία ανακτά τα δικά της από τη δική της μεταφορά (migration). Μέχρι να εκτελεστεί αυτή η μεταφορά, μια υπηρεσία δεν μπορεί να χρησιμοποιήσει τους πίνακές της. Το κενό διαρκεί δευτερόλεπτα. Εάν τα δευτερόλεπτα έχουν σημασία, κλιμακώστε πρώτα τις υπηρεσίες στο μηδέν και κλιμακώστε τις ξανά προς τα πάνω μόλις ολοκληρωθούν οι εργασίες μεταφοράς.
  2. Δώστε σε κάθε κλειδί διεπαφής προγραμματισμού εφαρμογών (API) έναν οργανισμό. Ένα κλειδί χωρίς οργανισμό απορρίπτεται με 403 TOKEN_ORG_MISSING από κάθε υπηρεσία που ελέγχει κλειδιά μέσω του nexus-auth, συμπεριλαμβανομένου του nexus-graphrag. Πριν κάνετε αναβάθμιση, δώστε σε κάθε τέτοιο κλειδί έναν οργανισμό ή εκδώστε ένα νέο κλειδί. Τα παλιά κλειδιά bcrypt συνεχίζουν να λειτουργούν μέχρι την ημερομηνία οριστικής ανάκλησής τους (hard-revoke date).
  3. Εκκαθαρίστε τα προσωρινά αποθηκευμένα κλειδιά API στη συνέχεια. Έως και μία ώρα προσωρινά αποθηκευμένων καταχωρίσεων κλειδιών φέρουν λάθος όνομα εφαρμογής μέχρι να το κάνετε. Εκτελέστε το παρακάτω στην προσωρινή μνήμη (cache) του nexus-auth, το Valkey της εγκατάστασης (nexus-valkey, με τον κωδικό πρόσβασης στο Secret nexus-generated υπό το VALKEY_PASSWORD):
pw=$(kubectl -n nexus get secret nexus-generated -o jsonpath='{.data.VALKEY_PASSWORD}' | base64 -d)
kubectl -n nexus exec nexus-valkey-0 -- sh -c \
  'valkey-cli -a "$1" --scan --pattern "apikey:prefix:*" | xargs -r valkey-cli -a "$1" del' _ "$pw"

Αυτό ισχύει για τον προεπιλεγμένο χώρο αποθήκευσης εντός του cluster. Με το dataTier.valkey.mode: external δεν υπάρχει τέτοιο pod: εκτελέστε την ίδια σάρωση και διαγραφή στον δικό σας κεντρικό υπολογιστή Valkey, με τον κωδικό πρόσβασης από το Secret που κατονομάζεται στο dataTier.valkey.external.existingSecret.

Επαναφορά σε προηγούμενη έκδοση (Rollback)

Εντός του χρονικού παραθύρου που εμφανίζει η σελίδα «Αναβάθμιση», η επιλογή «Επιστροφή» (Go back) επαναφέρει κάθε μηχανή στην προηγούμενη έκδοση. Μετά το πέρας του παραθύρου, η επιστροφή σημαίνει επαναφορά του αντιγράφου ασφαλείας που έλαβε πρώτο η αναβάθμιση.

Δύο τιμές δεν πρέπει να αλλάξουν ποτέ κατά τη διάρκεια μιας αναβάθμισης ή μιας επαναφοράς στην προηγούμενη έκδοση.

Το keys.installationName είναι μόνιμο. Το πρώτο bootstrap του χώρου αποθήκευσης κλειδιών δημιουργεί την ταυτότητα της εγκατάστασης υπό αυτό, και αυτή η ταυτότητα είναι εκείνη που κατονομάζει η άδειά σας. Χρησιμοποιήστε ακριβώς την ίδια τιμή σε κάθε αρχείο values που θα εφαρμόσετε ποτέ σε αυτή την εγκατάσταση.

Το Secret nexus-generated πρέπει να παραμείνει ως έχει. Σε κάθε αναβάθμιση, το chart διαβάζει το EXTERNAL_KEY_ENCRYPTION_KEY από αυτό και ελέγχει τη μορφή του. Μια τιμή που δεν είναι ούτε base64 των 32 bytes ούτε το ακατέργαστο κλειδί 32-byte μιας παλαιότερης εγκατάστασης σταματά την απόδοση (render) με EXTERNAL_KEY_ENCRYPTION_KEY_INVALID, και το chart δεν εμφανίζει ποτέ την τιμή. Αυτό σημαίνει ότι κάποιος επεξεργάστηκε ή αντικατέστησε το Secret. Επαναφέρετε το κλειδί υπό το οποίο είναι σφραγισμένα τα δεδομένα αυτής της εγκατάστασης, ως base64 των 32 bytes του (printf %s "$OLD" | base64), και κάντε ξανά αναβάθμιση. Ένα νέο τυχαίο κλειδί θα άφηνε μη αναγνώσιμο οτιδήποτε είναι σφραγισμένο υπό το παλιό.

Κλιμάκωση

Κάθε στοιχείο (component) έχει έναν διακόπτη και ένα μέγεθος στο αρχείο values. Τα απαιτούμενα στοιχεία δεν μπορούν να απενεργοποιηθούν: το chart τα εκτελεί ό,τι κι αν λέει ο διακόπτης τους. Στα υπόλοιπα μπορούν να δοθούν περισσότερα αντίγραφα (replicas) και περισσότεροι πόροι.

# harrow-values.yaml (Helm values): scaling
components:
  gateway:
    replicas: 2
    resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 3Gi } }
  graphrag:
    replicas: 2
  workflows:
    replicas: 2
workflows:
  concurrency: "8"
dataTier:
  qdrant:
    resources: { requests: { cpu: 200m, memory: 512Mi }, limits: { memory: 4Gi } }

Εφαρμόστε το με το helm upgrade όπως παραπάνω. Το μέγεθος των τόμων (volumes) καθορίζεται υπό το dataTier.<store>.size· ελέγξτε ότι η κλάση αποθήκευσής σας (storage class) μπορεί να επεκτείνει έναν τόμο πριν αυξήσετε κάποιον. Η σελίδα «Πώς τα πάει η εγκατάσταση» (How the installation is doing) απεικονίζει σε γράφημα πόσο απασχολημένοι ήταν οι επεξεργαστές και η μνήμη του cluster, μαζί με το περιθώριο που απομένει στο καθένα. Αυξήστε όποιο εξαντλείται πρώτο.

Πακέτα υποστήριξης

Όταν η Harrow χρειάζεται τη βοήθεια της Adverant, ο Tomás δημιουργεί ένα πακέτο υποστήριξης:

nexusctl support-bundle --out harrow-support-4471.tar.gz

Η σελίδα «Πακέτο υποστήριξης» (Support bundle) της κονσόλας δημιουργεί το ίδιο αρχείο. Συλλέγει τα αρχεία καταγραφής των μηχανών των τελευταίων 24 ωρών μαζί με λεπτομέρειες υγείας και έκδοσης. Οι ρυθμίσεις συμπεριλαμβάνονται χωρίς τα μυστικά τους (secrets), μαζί με τις αναφορές προκαταρκτικού ελέγχου (preflight) και εγκατάστασης. Πριν εγγραφεί οτιδήποτε, η απόκρυψη ευαίσθητων στοιχείων (redaction) αντικαθιστά τα ονόματα και τα μυστικά με δεσμευτικά θέσης (placeholders) και εσείς διαβάζετε μια προεπισκόπηση του τι ακριβώς θα αποσταλεί. Το προσωπικό περιεχόμενο των χρηστών δεν συλλέγεται ποτέ. Το πακέτο πηγαίνει στην Adverant είτε ως μεταφόρτωση στη σελίδα «Υποστήριξη και πακέτα υποστήριξης» (Support and support bundles) του λογαριασμού σας είτε ως αρχείο που μεταφέρεται σε αποθηκευτικό μέσο. Μόνο οι μηχανικοί υποστήριξης που κατονομάζονται στο αίτημα μπορούν να το ανοίξουν, και διαγράφεται οριστικά μετά από 30 ημέρες.

Πακέτο υποστήριξης
Πακέτο υποστήριξης
Δημιουργία πακέτου υποστήριξης. Η προεπισκόπηση απόκρυψης δείχνει τι κρύβεται πριν αποσταλεί οτιδήποτε, και μόνο οι κατονομαζόμενοι μηχανικοί μπορούν να το ανοίξουν.

Εξαγωγή αποδεικτικών στοιχείων

Οι ελεγκτές και η δική σας ομάδα συμμόρφωσης συχνά θέλουν αποδείξεις ότι η πλατφόρμα συμπεριφέρεται όπως περιγράφεται. Το nexusctl evidence export τις παράγει:

nexusctl evidence export --out harrow-evidence-2027-01

Παράλληλα με τις εγγραφές που εξάγει, η εντολή εκτελεί τους ελέγχους αποδοχής (acceptance probes) της πλατφόρμας: ο δρομολογητής τεχνητής νοημοσύνης (AI) είναι προσβάσιμος και απαντά, μια εργασία UNO αποστέλλεται και ολοκληρώνεται, και μια ανάγνωση μεταξύ διαφορετικών οργανισμών απορρίπτεται. Τα αποτελέσματά τους βρίσκονται στο probes.json στον φάκελο εξόδου.

Κατάσταση με μια ματιά

Το nexusctl status --json απαντά στο αν η εγκατάσταση είναι υγιής και σε ποια κατάσταση βρίσκεται κάθε στοιχείο. Αναφέρει επίσης την κατάσταση της άδειας μαζί με την ημερομηνία λήξης της, την έκδοση (edition) και την τρέχουσα κυκλοφορία (release). Κάθε μεταγλωττισμένο τμήμα παρατίθεται με τη σύνοψη (digest) και την υπογραφή του. Είναι η εντολή που μπορείτε να συνδέσετε με το δικό σας σύστημα παρακολούθησης (monitoring).

Απεγκατάσταση

nexusctl uninstall --profile <profile-file>

Το <profile-file> είναι το προφίλ ανάπτυξης (deployment profile) για το cluster, το ίδιο αρχείο που περάσατε στο nexusctl handoff --profile <profile-file> --out <dir> εάν η ομάδα πλατφόρμας σας διαχειρίζεται το cluster. Το Handoff γράφει, για εκείνη την ομάδα, μια λίστα σε απλή γλώσσα με το τι χρειάζεται το Nexus από το cluster και τα manifests για να το καλύψει. Η απεγκατάσταση (Uninstall) αφαιρεί τα namespaces του Nexus και τίποτα άλλο, και διατηρεί τα αντίγραφα ασφαλείας σας. Η ταυτότητα της εγκατάστασης χάνεται μαζί της. Μια μεταγενέστερη εγκατάσταση στο ίδιο cluster αποτελεί μια νέα εγκατάσταση με νέα ταυτότητα, επομένως το αίτημα διεκδίκησής της (claim) είναι ένα νέο αίτημα και η άδειά της είναι μια νέα άδεια.

Οι σελίδες This installation

Οι χειριστές της εγκατάστασης έχουν τη δική τους ομάδα στο μενού, «Αυτή η εγκατάσταση» (This installation), και στις σελίδες της εκτυλίσσεται το μεγαλύτερο μέρος αυτού του κεφαλαίου μέσα στην κονσόλα. Ένα μέλος που ανοίγει μία από αυτές βλέπει τη σελίδα «Δεν είστε διαχειριστής» (Not an administrator), η οποία κατονομάζει ποιος μπορεί να ενεργήσει.

Σελίδα Σε τι χρησιμεύει
Η άδεια χρήσης και τι ξεκλειδώνει Η άδεια και οι ομάδες λειτουργιών της (κεφάλαιο 2.13, Άδειες)
Εάν λήξει η άδεια χρήσης Η κλίμακα λήξης με λόγια, με τις ημερομηνίες αυτής της άδειας
Μεταγλωττισμένα μέρη Κάθε αδειοδοτημένη λειτουργική μονάδα με τον νυχτερινό έλεγχο υπογραφής της
Δήλωση χρήσης για την Adverant Οι ετήσιοι μετρητές, αναγνώσιμοι πριν αποσταλούν
Εκδόσεις και αναβαθμίσεις Κάθε εγκατεστημένη έκδοση, με το ποιος την εγκατέστησε και πότε
Αναβάθμιση Η σταδιακή αναβάθμιση και ο δρόμος της επιστροφής
Δημιουργία αντιγράφων ασφαλείας και επαναφορά Κάθε χώρος αποθήκευσης, το τελευταίο του αντίγραφο ασφαλείας και η τελευταία δοκιμασμένη επαναφορά του
Πώς λειτουργεί η εγκατάσταση Κόμβοι, χωρητικότητα και κόστος λειτουργίας, με προειδοποιήσεις
Κλειδιά και οριστική διαγραφή Το κλειδί κάθε οργανισμού και η «Οριστική διαγραφή» (Erase) με αιτιολογία και δεύτερο άτομο
Περιστατικά Ανοιχτά και κλειστά προβλήματα, μαζί με το τι έγινε
Αποσύρονται σύντομα Λειτουργίες που απενεργοποιούνται, με ημερομηνίες, εξαγωγή και αντικατάσταση
Κατάσταση Κάθε τμήμα του Nexus τώρα και τις τελευταίες 30 ημέρες, με λόγια που μπορεί να διαβάσει ο καθένας
Πακέτο υποστήριξης Τι αποστέλλεται στην Adverant και πώς

Δύο από αυτές τις σελίδες αξίζουν μια αναφορά. Η σελίδα «Μεταγλωττισμένα τμήματα» (Compiled parts) ελέγχει κάθε αδειοδοτημένη λειτουργική μονάδα έναντι της υπογραφής της Adverant κάθε βράδυ. Ένα τροποποιημένο αντίγραφο μιας λειτουργικής μονάδας απορρίπτεται και δεν φορτώνεται ποτέ, ενώ το υπογεγραμμένο αντίγραφο συνεχίζει να εκτελείται, και η σελίδα μετρά τις απορρίψεις ανά μήνα ώστε ένα παραβιασμένο αντίγραφο να μην μπορεί να περάσει απαρατήρητο. Η σελίδα «Κατάσταση» (Status) είναι γραμμένη έτσι ώστε να μπορεί να τη διαβάσει οποιοσδήποτε στον οργανισμό. Δείχνει κάθε τμήμα του Nexus τώρα και κατά τις τελευταίες 30 ημέρες ως μια λωρίδα ημερών, με προγραμματισμένες εργασίες συντήρησης και πρόσφατα περιστατικά, ενώ ένας χειριστής προσθέτει ένα περιστατικό ή ένα παράθυρο συντήρησης από την ίδια σελίδα.

Μια εγκατάσταση Community έχει μία σελίδα, «Αυτή η εγκατάσταση (Community)», με την έκδοση, την υγεία και τις ενημερώσεις της. Οι σελίδες Enterprise εμφανίζονται σε αυτήν ως προεπισκοπήσεις (teasers) που κατονομάζουν ποιος μπορεί να τις ενεργοποιήσει.