Έκδοση 1.0.0-alpha.1τελευταία
Κεφάλαιο 2.9
Το είδωλο δίσκου του προγράμματος εγκατάστασης
Εκκινήστε έναν γυμνό διακομιστή ή μια εικονική μηχανή από το είδωλο εγκατάστασης του Nexus και αυτό θα εγκαταστήσει το λειτουργικό σύστημα, το k3s, το cert-manager και το Nexus χωρίς δίκτυο, ελέγχοντας κάθε αρχείο πριν χρησιμοποιηθεί.
Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

Το γραφείο του λιμενάρχη στην ανατολική προκυμαία του Harrow διαθέτει έναν διακομιστή, καθόλου σύνδεση στο διαδίκτυο και κανέναν στον χώρο που να διαχειρίζεται Kubernetes. Ο Tomás Reilly χρειαζόταν ωστόσο το Nexus σε αυτόν. Έγραψε το είδωλο (image) σε ένα στικ USB (Universal Serial Bus), τοποθέτησε δίπλα του ένα δεύτερο, μικρό στικ με τέσσερις γραμμές ρυθμίσεων και εκκίνησε τον διακομιστή. Μία ώρα αργότερα, η οθόνη έδειξε τη διεύθυνση της κονσόλας και τις τρεις γραμμές που έπρεπε να προστεθούν στο αρχείο hosts. Δεν πληκτρολόγησε ούτε μία εντολή Kubernetes.
Αυτή είναι η δουλειά του ειδώλου δίσκου του προγράμματος εγκατάστασης. Γράφει ένα ελάχιστο λειτουργικό σύστημα στον δίσκο του διακομιστή και, στη συνέχεια, κατά την πρώτη εκκίνηση ελέγχει κάθε αρχείο που φέρει σε σχέση με το κλειδί έκδοσης της Adverant, εγκαθιστά το k3s χωρίς δίκτυο, εισάγει κάθε είδωλο, εγκαθιστά το cert-manager και το Nexus, και ελέγχει ότι κάθε pod εκτελείται. Κάθε βήμα σταματά με μια συγκεκριμένη αιτιολογία τη στιγμή που κάτι δεν πάει καλά. Δεν υπάρχει υποβαθμισμένη λειτουργία ούτε προεπιλεγμένος κωδικός πρόσβασης πουθενά.
Τα δύο είδωλα
Κάθε έκδοση διατίθεται σε δύο είδη ειδώλων, για δύο αρχιτεκτονικές επεξεργαστών, amd64 και arm64.
| Αρχείο | Τι περιέχει | Ποιος μπορεί να το κατεβάσει |
|---|---|---|
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso |
Μόνο το πρόγραμμα εγκατάστασης: το λειτουργικό σύστημα, το k3s v1.33.6+k3s1, το cert-manager v1.21.3 και το πρόγραμμα εγκατάστασης πρώτης εκκίνησης. Λειτουργεί και για τις δύο εκδόσεις και δεν περιέχει είδωλα του Nexus. | Οποιοσδήποτε, από το downloads.adverant.ai |
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso |
Το ίδιο πρόγραμμα εγκατάστασης με το πακέτο εκτός σύνδεσης (offline bundle) της εκάστοτε έκδοσης προστιθέμενο ως δεύτερη κατάτμηση με την ετικέτα NEXUS-BUNDLE. Ένα μέσο εγκαθιστά τα πάντα. |
Community: οποιοσδήποτε. Enterprise: μόνο από τον λογαριασμό σας στην Adverant |
Το <arch> είναι amd64 ή arm64, και το <edition> είναι community ή enterprise.
Το πρόγραμμα εγκατάστασης αναζητά πάντοτε μόνο ένα σύστημα αρχείων με την ετικέτα NEXUS-BUNDLE. Στο ολοκληρωμένο είδωλο (all-in-one), αυτή είναι η κατάτμηση στο ίδιο το είδωλο. Με το είδωλο που περιέχει μόνο το πρόγραμμα εγκατάστασης, φέρνετε το πακέτο σε έναν δεύτερο δίσκο ή στικ με αυτή την ετικέτα, κάτι που είναι πρακτικό όταν εγκαθιστάτε σε πολλές τοποθεσίες από ένα στικ εγκατάστασης και αλλάζετε μόνο το πακέτο. Το Κεφάλαιο 2.10, Εγκατάσταση σε απομονωμένο δίκτυο (Air-gapped), περιγράφει το πακέτο.
Τα είδωλα Enterprise και τα πακέτα Enterprise δεν είναι ποτέ ανώνυμα. Τα κατεβάζετε από τον λογαριασμό σας στην Adverant στο https://account.adverant.ai, στη σελίδα Λήψεις (Downloads), δίπλα στην άδεια χρήσης σας. Τα είδωλα και τα πακέτα Community είναι δημόσια.
Από τι αποτελείται το είδωλο
Το λειτουργικό σύστημα βασίζεται στο Debian 13 και δεν αποτελεί επίσημο είδωλο του Debian. Περιέχει το βασικό σύστημα Debian και τίποτα άλλο: κανένα επιπλέον πακέτο, κανένα περιβάλλον εργασίας (desktop) και κανέναν διακομιστή κατοπτρισμού (mirror). Το k3s φέρνει το δικό του περιβάλλον εκτέλεσης κοντέινερ και τη δική του δικτύωση. Η αλυσίδα εκκίνησης (shim, GRUB, ο πυρήνας και ο αρχικός δίσκος RAM) είναι, byte προς byte, αυτή που διαθέτει το Debian, επομένως ένα μηχάνημα με ενεργοποιημένο το Secure Boot το εκκινεί όπως οποιοδήποτε πρόγραμμα εγκατάστασης Debian.
Δύο δομήσεις (builds) της ίδιας έκδοσης δίνουν πανομοιότυπα είδωλα, byte προς byte, και η έκδοση δεν δημοσιεύεται αν αυτό δεν συμβεί. Τα πακέτα πηγαίου κώδικα του Debian για κάθε δυαδικό αρχείο στο είδωλο δημοσιεύονται δίπλα του ως nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar, στην ίδια λίστα αθροισμάτων ελέγχου (checksum).
Ελέγξτε τη λήψη πριν την εγγράψετε
Ο κατάλογος ειδώλων στο downloads.adverant.ai περιέχει τα είδωλα, ένα αρχείο SHA256SUMS που καλύπτει κάθε δημοσιευμένο αρχείο, και το SHA256SUMS.sigstore.json, την υπογραφή επί αυτής της λίστας που δημιουργήθηκε με το κλειδί έκδοσης της Adverant. Λάβετε το δημόσιο κλειδί έκδοσης ξεχωριστά, αποθηκεύστε το ως release.pub και ελέγξτε το αποτύπωμά του όπως περιγράφει το κεφάλαιο 2.4, Λήψη και επαλήθευση μιας έκδοσης.
- Επαληθεύστε την υπογραφή στη λίστα αθροισμάτων ελέγχου. Δεν υπάρχει αρχείο καταγραφής διαφάνειας (transparency log) για τις εκδόσεις του Nexus, επομένως η σημαία (flag) που παρακάμπτει την αναζήτηση στο αρχείο καταγραφής είναι απαραίτητη.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSVerified OK
- Ελέγξτε το είδωλο που κατεβάσατε σε σχέση με τη λίστα:
grep nexus-alpha-community-1.0.0-alpha.1-amd64.iso SHA256SUMS | sha256sum -c -nexus-alpha-community-1.0.0-alpha.1-amd64.iso: OK
Σε Mac, χρησιμοποιήστε το shasum -a 256 -c - αντί του sha256sum -c -.
- Γράψτε το είδωλο σε ένα στικ USB με το εργαλείο που χρησιμοποιείτε συνήθως ή προσαρτήστε το στην εικονική μηχανή ως οπτικό δίσκο.
Το k3s δημοσιεύει αθροίσματα ελέγχου για τα αρχεία της έκδοσής του και όχι υπογραφή, επομένως τα αρχεία k3s εντός του ειδώλου ελέγχονται με βάση τα αθροίσματα ελέγχου που δημοσιεύει το k3s, από την ίδια προέλευση με τα αρχεία. Οτιδήποτε έχει κατασκευαστεί από την Adverant είναι υπογεγραμμένο.
Πακέτα σε τμήματα
Ένα πακέτο που μεταφέρετε σε ξεχωριστό στικ έχει μέγεθος αρκετά gigabyte. Ορισμένα συστήματα αρχείων, μεταξύ των οποίων και το FAT (File Allocation Table), δεν μπορούν να φιλοξενήσουν αρχείο 4 GiB ή μεγαλύτερο, επομένως τα αρχεία πακέτων δημοσιεύονται σε τμήματα των 2047 MiB που χωρούν σε οποιοδήποτε στικ. Ενώστε ξανά τα τμήματα με τη σειρά και ελέγξτε το ενωμένο αρχείο με βάση το .sha256 του πριν το χρησιμοποιήσετε.
Το υλικό που απαιτείται
Η πρώτη εκκίνηση ελέγχει το μηχάνημα πριν αγγίξει οτιδήποτε και αρνείται να συνεχίσει όταν το μηχάνημα είναι πολύ μικρό.
| Έλεγχος | Η βάση (The floor) | Πότε ελέγχεται |
|---|---|---|
| Αρχιτεκτονική | Του ίδιου του ειδώλου: ένα είδωλο amd64 σε amd64, arm64 σε arm64 | Πρώτη εκκίνηση |
| Μνήμη | 16 GiB | Πρώτη εκκίνηση |
| Δίσκος προορισμού | Ακριβώς ένας κενός δίσκος τουλάχιστον 64 GB, ή ο δίσκος που ορίζει το αρχείο αρχικοποίησης (seed) | Πριν εγγραφεί το λειτουργικό σύστημα |
Ελεύθερος χώρος στο / |
50 GB αφού τοποθετηθεί το λειτουργικό σύστημα | Πρώτη εκκίνηση |
| Ρολόι | Όχι παλαιότερο από την ημερομηνία κατασκευής του ειδώλου | Πρώτη εκκίνηση |
Αυτά είναι τα κατώτατα όρια, όχι σύσταση. Με τις προεπιλογές του chart, οι τόμοι του Nexus από μόνοι τους φτάνουν συνολικά τα 142 GiB, επομένως ένας δίσκος 64 GB περνά τον έλεγχο του προγράμματος εγκατάστασης αλλά γεμίζει μέσα σε λίγες ημέρες. Χρησιμοποιήστε αυτό που πρέπει να έχει ένας μεμονωμένος κόμβος: 8 vCPU (virtual central processing units), 32 GiB μνήμης και έναν δίσκο SSD (solid-state drive) 250 GB. Τέσσερις vCPU, 16 GiB και 200 GB επαρκούν για μια αξιολόγηση.
Ο έλεγχος του ρολογιού υπάρχει επειδή ο διακομιστής δεν έχει δίκτυο, και επομένως καμία υπηρεσία ώρας, κατά την εγκατάσταση. Τα πιστοποιητικά και οι υπογραφές ελέγχονται με βάση το ρολόι. Εάν το ρολόι υλικού του μηχανήματος βρίσκεται πίσω από την ημερομηνία κατασκευής του ειδώλου, η πρώτη εκκίνηση σταματά και σας ζητά να το ρυθμίσετε. Ρυθμίστε το στις ρυθμίσεις του υλικολογισμικού (firmware) και εκκινήστε ξανά.
Φυσικοί διακομιστές (Bare metal) και εικονικές μηχανές
Το είδωλο εκκινεί σε υλικολογισμικό UEFI (Unified Extensible Firmware Interface), τόσο σε φυσικούς διακομιστές όσο και σε εικονικές μηχανές. Εγκαθιστά τον φορτωτή εκκίνησης (boot loader) στη διαδρομή αφαιρούμενων μέσων καθώς και στη συνήθη διαδρομή, ώστε μια VM (virtual machine) χωρίς αποθηκευμένες καταχωρίσεις εκκίνησης να το βρίσκει και πάλι μετά την πρώτη επανεκκίνηση. Δώστε σε μια VM τη μνήμη και τον δίσκο που αναφέρονται στον παραπάνω πίνακα, έναν κενό εικονικό δίσκο και το είδωλο ως CD.
Το πρόγραμμα εγκατάστασης επιλέγει τον δίσκο προορισμού με έναν αυστηρό κανόνα και δεν επιλέγει ποτέ «τον πρώτο δίσκο».
- Παρακάμπτει το μέσο από το οποίο εκκίνησε.
- Παρακάμπτει τους αφαιρούμενους δίσκους, εκτός εάν το αρχείο αρχικοποίησης (seed) ορίζει κάποιον.
- Παρακάμπτει οποιονδήποτε δίσκο έχει ήδη πίνακα κατατμήσεων, οποιουδήποτε είδους.
- Παρακάμπτει δίσκους κάτω των 64 GB και το αναφέρει στην κονσόλα.
- Εγκαθιστά μόνο όταν απομένει ακριβώς ένας δίσκος.
Σε έναν διακομιστή με δύο κενούς δίσκους, σταματά και σας ζητά να επιλέξετε. Επιλέγετε ορίζοντας το όνομα του δίσκου στο αρχείο αρχικοποίησης (seed), με το wipe: true, που είναι ο μόνος τρόπος με τον οποίο θα γράψει ποτέ σε έναν δίσκο που έχει ήδη κατατμήσεις.
Ο τόμος NEXUS-SEED
Το seed είναι ένας μικρός τόμος, συνήθως ένα στικ USB, με σύστημα αρχείων που φέρει την ετικέτα NEXUS-SEED και ένα αρχείο seed.yaml στο ανώτατο επίπεδό του. Το πρόγραμμα εγκατάστασης τον προσαρτά μόνο για ανάγνωση, διαβάζει τις ρυθμίσεις και τον προσαρτά ξανά με δυνατότητα εγγραφής μόνο στο τέλος, για να σας αφήσει τον κωδικό πρόσβασης του λειτουργικού συστήματος.
# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m| Κλειδί | Τι καθορίζει | Όταν λείπει |
|---|---|---|
domain |
Τον τομέα (domain) της εγκατάστασης. Το πρόγραμμα εγκατάστασης παράγει τους τρεις κεντρικούς υπολογιστές (hosts) από αυτόν: console.<domain>, api.<domain> και auth.<domain>. |
Ζητείται στην κονσόλα του διακομιστή |
adminEmail |
Το email του ατόμου που θα είναι ο πρώτος διαχειριστής | Ζητείται στην κονσόλα του διακομιστή |
edition |
community ή enterprise. Όταν οριστεί, πρέπει να συμφωνεί με την έκδοση του πακέτου. |
Λαμβάνεται από το πακέτο |
timeout |
Πόσο χρόνο μπορεί να διαρκέσει η εγκατάσταση του cert-manager και του Nexus, ως διάρκεια όπως 30m ή 1h |
30m |
time |
Την τρέχουσα ώρα σε UTC, στη μορφή που εμφανίζει το μήνυμα του ρολογιού (2026-11-14T09:00:00Z), για ένα μηχάνημα του οποίου το ρολόι υλικού δεν μπορεί να ρυθμιστεί ή δεν διατηρεί τη ρύθμισή του. Ένα μηχάνημα εκτός σύνδεσης δεν έχει διακομιστή ώρας για να ρωτήσει. |
Χρησιμοποιείται το ρολόι υλικού |
disk |
Ο δίσκος προορισμού, ως /dev/<name>, που χρησιμοποιείται μόνο μαζί με το wipe: true |
Ο παραπάνω κανόνας κενού δίσκου |
wipe |
Το true επιτρέπει στο πρόγραμμα εγκατάστασης να διαγράψει τον δίσκο που ορίζει το disk |
Δεν διαγράφεται ποτέ κανένας δίσκος |
Για την έκδοση Enterprise, τοποθετήστε το αρχείο άδειας χρήσης στον ίδιο τόμο ως licence.json. Χωρίς αυτό, η πρώτη εκκίνηση σταματά στο βήμα του seed και αναφέρει ότι λείπει η άδεια χρήσης. Η έκδοση Community δεν χρειάζεται άδεια χρήσης, και για την Community ολόκληρο το seed είναι προαιρετικό: το πρόγραμμα εγκατάστασης ζητά τον τομέα και το email στην κονσόλα και συνεχίζει.
Το πρόγραμμα εγκατάστασης διαβάζει κάθε γραμμή ως key: value στην αρχή της γραμμής. Γράψτε ένα κλειδί ανά γραμμή, στο ανώτατο επίπεδο, χωρίς εισαγωγικά και χωρίς εσοχές. Μια τιμή σε εισαγωγικά διαβάζεται μαζί με τα εισαγωγικά της.
Κατά την πρώτη εκκίνηση, το πρόγραμμα εγκατάστασης ζητά επίσης στην κονσόλα τον θεματοφύλακα (custodian) του χώρου αποθήκευσης κλειδιών: το δημόσιο ήμισυ ενός κλειδιού age, age1..., που δημιουργήθηκε στο μηχάνημα του ίδιου του θεματοφύλακα με το age-keygen -o custodian.key. Ο χώρος αποθήκευσης κλειδιών σφραγίζει τα κλειδιά ανάκτησής του σε αυτό. Το Κεφάλαιο 2.8, Εγκαταστάσεις σε ένα μηχάνημα, εξηγεί τους θεματοφύλακες. Ο θεματοφύλακας φυλάσσει το ιδιωτικό ήμισυ εκτός σύνδεσης και με ασφάλεια: χωρίς αυτό, κανείς δεν μπορεί να αποσφραγίσει τον χώρο αποθήκευσης κλειδιών μετά από επανεκκίνηση.
Τι συμβαίνει, από την ενεργοποίηση έως τη διεύθυνση της κονσόλας
Στάδιο πρώτο: το λειτουργικό σύστημα
Το είδωλο εκκινεί σε ένα ανεπιτήρητο πρόγραμμα εγκατάστασης Debian. Δεν διαμορφώνει δίκτυο, δεν χρησιμοποιεί διακομιστή κατοπτρισμού (mirror) ούτε εγκαθιστά οποιοδήποτε πακέτο πέρα από το βασικό σύστημα. Ορίζει τη ζώνη ώρας σε UTC (Coordinated Universal Time), απενεργοποιεί τη σύνδεση root και δημιουργεί έναν χρήστη, τον nexus, του οποίου ο κωδικός πρόσβασης είναι κλειδωμένος. Επιλέγει τον δίσκο προορισμού σύμφωνα με τον παραπάνω κανόνα και γράφει έναν δίσκο GPT (globally unique identifier partition table) με μια κατάτμηση συστήματος EFI (Extensible Firmware Interface) και ένα σύστημα αρχείων root ext4, χωρίς swap.
Στο τέλος, αντιγράφει το πρόγραμμα εγκατάστασης του Nexus στο νέο σύστημα, ελέγχει κάθε αντιγραμμένο αρχείο με βάση τη λίστα αθροισμάτων ελέγχου του ειδώλου και ενεργοποιεί μια υπηρεσία πρώτης εκκίνησης. Εάν οποιοδήποτε αντιγραμμένο αρχείο δεν συμφωνεί, σταματά εκεί. Στη συνέχεια, εξάγει το μέσο και επανεκκινεί.
Στάδιο δεύτερο: η πρώτη εκκίνηση
Κατά την πρώτη εκκίνηση, η υπηρεσία nexus-install εκτελείται μία φορά. Κάθε βήμα εμφανίζεται στην κονσόλα του διακομιστή και στο αρχείο καταγραφής (journal), και καταγράφεται ως ολοκληρωμένο, ώστε μια νέα προσπάθεια να ξεκινά από το πρώτο βήμα που δεν έχει ολοκληρωθεί. Η υπηρεσία συνολικά μπορεί να εκτελείται για έως και τέσσερις ώρες προτού το systemd τη σταματήσει, κάτι που αφήνει περιθώριο για έναν αργό δίσκο και μία ώρα αναμονής για το στικ του πακέτου.
- Preflight. Η αρχιτεκτονική, το ρολόι, η μνήμη και ο ελεύθερος χώρος στον δίσκο, όπως στον παραπάνω πίνακα.
- Payload. Τα αρχεία του ίδιου του προγράμματος εγκατάστασης: η υπογραφή στη λίστα αθροισμάτων ελέγχου του με το κλειδί έκδοσης που φέρει, και στη συνέχεια κάθε αρχείο σε σχέση με αυτή τη λίστα.
- Seed. Διαβάζει το
seed.yamlκαι ζητά στην κονσόλα οτιδήποτε λείπει. - Bundle. Βρίσκει τον τόμο με την ετικέτα
NEXUS-BUNDLEκαι τον προσαρτά μόνο για ανάγνωση. Εάν δεν υπάρχει, εμφανίζειwaiting-for-bundleκαι περιμένει έως και μία ώρα για να τον συνδέσετε. Στη συνέχεια, εκτελεί τον πλήρη έλεγχο του πακέτου, καταλήγοντας σεVERIFY-BUNDLE PASS, με το κλειδί έκδοσης που φέρει, προτού εισαχθεί οτιδήποτε. Ένα πακέτο Enterprise χρειάζεται τοlicence.jsonστο seed, και η έκδοση του seed πρέπει να συμφωνεί με αυτή του πακέτου. - k3s. Εγκαθιστά το k3s v1.33.6+k3s1 από τα αρχεία του ίδιου του ειδώλου με τις λήψεις απενεργοποιημένες και περιμένει έως και δέκα λεπτά μέχρι ο κόμβος να είναι σε κατάσταση Ready. Στη συνέχεια, αφαιρεί το αρχείο ειδώλων air-gap του k3s, ώστε τα είδωλα να μην εισάγονται ξανά σε κάθε εκκίνηση.
- Import. Εισάγει κάθε επαληθευμένο είδωλο από το πακέτο, καθώς και τα είδωλα του cert-manager, στον χώρο αποθήκευσης κοντέινερ του κόμβου. Τίποτα δεν αντλείται ποτέ από μητρώο (registry).
- cert-manager, και μετά Nexus. Εγκαθιστά το cert-manager v1.21.3 και στη συνέχεια το chart του Nexus από το πακέτο, και τα δύο εντός του
timeoutτου seed. - Acceptance. Ελέγχει ότι κάθε pod βρίσκεται σε κατάσταση Running και ότι κάθε εργασία (Job) τύπου hook έχει ολοκληρωθεί.
- Credential. Δίνει στον χρήστη λειτουργικού συστήματος
nexusέναν νέο τυχαίο κωδικό πρόσβασης, τον εμφανίζει μία φορά στην κονσόλα και τον γράφει στοnexus-os-password.txtστον τόμο του seed όταν είναι δυνατή η εγγραφή στον τόμο.
Ο έλεγχος του πακέτου στο βήμα 4 είναι η ίδια δέσμη ενεργειών (script) που εκτελείτε χειροκίνητα στο κεφάλαιο 2.10, Εγκατάσταση σε απομονωμένο δίκτυο (Air-gapped), και εμφανίζει τις ίδιες γραμμές:
1 SHA256SUMS OK files=<n>
2 SHA256SUMS signature OK
3 images signed + SBOM-attested: <n>
4 helm lint --strict OK nexus-1.0.0-alpha.1.tgz
5 coverage OK rendered=<n> lock=<n>
6 source offer OK images=5 files=<n>
VERIFY-BUNDLE PASS files=<n> images=<n>
Η γραμμή 3 καταμετρά τα είδωλα που φέρουν έγκυρη υπογραφή και υπογεγραμμένο SBOM (software bill of materials), δηλαδή τη λίστα με το τι περιέχει κάθε είδωλο. Οι αριθμοί (<n>) εξαρτώνται από την έκδοση. Αυτό που έχει σημασία είναι η τελευταία γραμμή.
Η εγκατάσταση γράφει τιμές στην τρέχουσα μορφή του chart: το global.domain και τα τρία ονόματα hosts.* από τον τομέα του seed, και το keys.custody.recipients από τον θεματοφύλακα που δώσατε στην κονσόλα. Εγκαθιστά από το chart και τα είδωλα του ίδιου του πακέτου, επομένως η έκδοση στον δίσκο είναι ακριβώς η έκδοση που ελέγχθηκε.
Οι τελευταίες γραμμές στην κονσόλα
Όταν ολοκληρωθούν επιτυχώς όλα τα βήματα, η κονσόλα εμφανίζει μία φορά τον κωδικό πρόσβασης του λειτουργικού συστήματος και τη διεύθυνση που πρέπει να ανοίξετε:
nexus-install: OS login: user nexus, password <shown-once> (shown once; change it with passwd)
nexus-install: DONE: https://console.harrow.example (add to /etc/hosts: 10.20.4.15 console.harrow.example api.harrow.example auth.harrow.example)
Σημειώστε τον κωδικό πρόσβασης ή πάρτε τον από το στικ του seed, στη συνέχεια συνδεθείτε ως nexus και αλλάξτε τον με την εντολή passwd. Κανείς, συμπεριλαμβανομένης της Adverant, δεν γνωρίζει κάποιον προεπιλεγμένο κωδικό πρόσβασης για αυτό το μηχάνημα, επειδή δεν υπάρχει.
Η διεύθυνση στη γραμμή hosts είναι η διεύθυνση του ίδιου του διακομιστή. Χωρίς DNS (Domain Name System) στην προκυμαία, ο Tomás πρόσθεσε αυτή τη μία γραμμή στο αρχείο hosts κάθε φορητού υπολογιστή που θα χρησιμοποιούσε την κονσόλα. Σε μια τοποθεσία με DNS, προσθέστε αντ' αυτού εγγραφές για τα τρία ονόματα.
Μετά την εγκατάσταση
Η εγκατάσταση δεν έχει διεκδικηθεί (unclaimed). Κανείς δεν μπορεί να συνδεθεί μέχρι κάποιος να τη διεκδικήσει σε ένα πρόγραμμα περιήγησης, συγκρίνοντας το αποτύπωμα της εγκατάστασης με αυτό που εμφανίζει ο διακομιστής. Το Κεφάλαιο 2.12, Η πρώτη εκτέλεση, καλύπτει τη διεκδίκηση, τον πρώτο διαχειριστή και το passkey. Ο πρώτος διαχειριστής θα πρέπει να είναι το άτομο του οποίου το email βρίσκεται στο seed.
Το kubeconfig του ίδιου του κόμβου βρίσκεται στο /etc/rancher/k3s/k3s.yaml, αναγνώσιμο μόνο από τον χρήστη root. Για να εργαστείτε στη συστοιχία (cluster) από έναν σταθμό εργασίας, η εντολή nexusctl kubeconfig το εμφανίζει, όπως περιγράφει το κεφάλαιο 2.8, Εγκαταστάσεις σε ένα μηχάνημα.
Οι ενημερώσεις καταφθάνουν με τον ίδιο τρόπο που έγινε και η εγκατάσταση: μια έκδοση σε υπογεγραμμένο μέσο, η οποία ελέγχεται με βάση το κλειδί που είναι ήδη εγκατεστημένο στον διακομιστή και ποτέ με βάση ένα κλειδί που φέρει μαζί του ο δίσκος. Το Κεφάλαιο 2.10, Εγκατάσταση σε απομονωμένο δίκτυο (Air-gapped), περιγράφει αυτόν τον έλεγχο.
Αν αυτό αποτύχει
Κάθε αποτυχία εμφανίζει nexus-install: FAILED <step>: <what is missing> στην κονσόλα και γράφει το ίδιο στο /var/lib/nexus/install.state. Διορθώστε την αιτία και εκτελέστε ξανά την εγκατάσταση από το πρώτο βήμα που δεν έχει ολοκληρωθεί:
sudo nexus-install retry| Μήνυμα | Τι σημαίνει | Τι πρέπει να κάνετε |
|---|---|---|
FAILED preflight: payload is for arm64, this machine is amd64 |
Εκκινήσατε το είδωλο της άλλης αρχιτεκτονικής. | Χρησιμοποιήστε το είδωλο για την αρχιτεκτονική αυτού του μηχανήματος. |
FAILED preflight: memory 11 GiB, need >= 16 GiB |
Το μηχάνημα διαθέτει λιγότερη από το κατώτατο όριο. | Προσθέστε μνήμη ή δώστε περισσότερη στη VM. |
FAILED preflight: free disk 38 GB on /, need >= 50 GB |
Το σύστημα αρχείων root είναι πολύ μικρό. | Εγκαταστήστε σε μεγαλύτερο δίσκο. |
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed |
Το ρολόι υλικού βρίσκεται πίσω από την ημερομηνία κατασκευής του προγράμματος εγκατάστασης. | Ρυθμίστε το ρολόι στο υλικολογισμικό (firmware), ή δώστε το time στο seed.yaml, και προσπαθήστε ξανά. |
FAILED payload: SHA256SUMS signature does not verify |
Τα αρχεία του ίδιου του προγράμματος εγκατάστασης δεν είναι αυτά που υπέγραψε η Adverant. | Σταματήστε. Κατεβάστε ξανά το είδωλο και ελέγξτε το πριν την εγγραφή. |
FAILED seed: the installation domain and the first administrator e-mail are required |
Ούτε το seed ούτε η κονσόλα τα έδωσαν. | Προσθέστε τα στο seed.yaml ή απαντήστε στις προτροπές. |
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) |
Το πακέτο είναι Enterprise και το seed δεν έχει άδεια χρήσης. | Τοποθετήστε το licence.json στον τόμο του seed. |
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h |
Δεν συνδέθηκε κανένα πακέτο εγκαίρως. | Συνδέστε το στικ του πακέτου και προσπαθήστε ξανά. |
FAILED bundle: the bundle does not verify with this installer's release key |
Ο έλεγχος του πακέτου δεν κατέληξε σε VERIFY-BUNDLE PASS. Η δική του έξοδος, πάνω από το μήνυμα, κατονομάζει το βήμα. |
Σταματήστε. Μην χρησιμοποιήσετε αυτό το πακέτο. Προμηθευτείτε ένα νέο. |
FAILED bundle: the seed asks for enterprise, the bundle is community |
Το seed και το πακέτο διαφωνούν. | Διορθώστε το edition στο seed ή φέρτε το σωστό πακέτο. |
FAILED k3s: node not Ready within 10 min |
Το k3s δεν εκκίνησε. | Ελέγξτε το αρχείο καταγραφής (journal) για το k3s και, στη συνέχεια, προσπαθήστε ξανά. |
FAILED nexus: helm install nexus |
Το chart δεν εγκαταστάθηκε εντός του χρονικού ορίου. | Δείτε το kubectl -n nexus get pods,jobs, αυξήστε το timeout στο seed εάν το μηχάνημα είναι αργό, και προσπαθήστε ξανά. |
FAILED acceptance: pods not ready |
Ορισμένα pods δεν εκτελούνται μετά την εγκατάσταση. | Το μήνυμα κατονομάζει έως και πέντε. Διαβάστε τα συμβάντα (events) τους, διορθώστε τα και προσπαθήστε ξανά. |
FAILED acceptance: jobs not complete: <jobs> |
Μια εργασία (Job) τύπου hook δεν έχει ολοκληρωθεί. | Διαβάστε το αρχείο καταγραφής της κατονομαζόμενης εργασίας (Job) με την εντολή kubectl -n nexus logs job/<name>, διορθώστε αυτό που αναφέρει και προσπαθήστε ξανά. |
Πριν εγγραφεί το λειτουργικό σύστημα, η επιλογή δίσκου μπορεί επίσης να σταματήσει την εγκατάσταση. Το μήνυμά της ξεκινά με nexus select-disk: REFUSED:. Το πιο συνηθισμένο είναι το found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Ορίστε το όνομα του δίσκου στο seed και εκκινήστε ξανά.
Ένας αποτυχημένος έλεγχος πακέτου είναι αυτός που πρέπει να λάβετε σοβαρά υπόψη. Σημαίνει ότι τα αρχεία στον δίσκο δεν είναι τα αρχεία που υπέγραψε η Adverant, ή ότι προστέθηκε κάποιο αρχείο. Το πρόγραμμα εγκατάστασης δεν έχει εισαγάγει τίποτα σε εκείνο το σημείο, επομένως ο διακομιστής παραμένει αμετάβλητος. Κρατήστε τον δίσκο για την ομάδα ασφαλείας σας.

