Έκδοση 1.0.0-alpha.1τελευταία
Κεφάλαιο 2.4
Λήψη και επαλήθευση μιας έκδοσης (release)
Πού βρίσκεται κάθε μέρος μιας έκδοσης (release) του Nexus, πώς γίνεται η λήψη των images της έκδοσης Enterprise με ένα pull token και πώς να αποδείξετε εκτός σύνδεσης ότι κάθε image, chart και αρχείο λήψης προήλθε αναλλοίωτο από την Adverant, πριν εγκαταστήσετε οτιδήποτε.
Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

Κάθε εικόνα (image) σε μια έκδοση του Nexus είναι υπογεγραμμένη με το κλειδί έκδοσης της Adverant, και κάθε εικόνα ονομάζεται με το digest της, ποτέ με ετικέτα (tag). Το chart θα αποδώσει μόνο εικόνες που αναφέρονται με βάση το digest στο δικό του κλείδωμα εικόνων (images lock). Συνολικά, αυτό σημαίνει ότι μπορείτε να αποδείξετε, στον δικό σας σταθμό εργασίας και χωρίς σύνδεση με κανέναν, ότι αυτό που πρόκειται να εκτελέσετε είναι ακριβώς αυτό που κατασκεύασε η Adverant.
Στη Harrow Port Authority ελέγξαμε τα πάντα πριν από την πρώτη εγκατάσταση. Χρειάστηκαν περίπου είκοσι λεπτά, και το μεγαλύτερο μέρος αυτών ήταν ο βρόχος ελέγχου των εικόνων. Αυτό το κεφάλαιο ακολουθεί την ίδια διαδρομή: πού βρίσκεται κάθε μέρος της έκδοσης, το διακριτικό λήψης (pull token) για τις εικόνες Enterprise, το κλείδωμα εικόνων, τους ελέγχους cosign με τις ακριβείς εντολές τους, και τι πρέπει να κάνετε όταν ένας έλεγχος αποτύχει.
Πού βρίσκεται η έκδοση (release)
| Διεύθυνση | Τι λαμβάνετε από εκεί |
|---|---|
registry.adverant.ai |
Τις εικόνες της πλατφόρμας, στο registry.adverant.ai/nexus/<service>@sha256:<digest>, και το Helm chart, στο oci://registry.adverant.ai/nexus/charts/nexus |
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ |
Το δημόσιο κλειδί της έκδοσης και το αποτύπωμά του (fingerprint), τα εκτελέσιμα αρχεία nexusctl και τα πακέτα εκτός σύνδεσης (offline bundles) |
https://account.adverant.ai |
Τον λογαριασμό σας στην Adverant: Λήψεις (Downloads), Διακριτικά λήψης και εντολές εγκατάστασης (Pull tokens and install commands), Υλοποιήσεις (Deployments) και τις σελίδες αδειών χρήσης |
Οι εικόνες Community και το chart Community είναι δημόσια· μπορείτε να τα λάβετε χωρίς να συνδεθείτε. Οι εικόνες Enterprise λαμβάνονται με ένα διακριτικό λήψης από τον λογαριασμό σας, ενώ το chart και το πακέτο Enterprise βρίσκονται στη σελίδα Λήψεις (Downloads) του λογαριασμού, η οποία ακολουθεί την άδεια χρήσης σας.
Διαβάστε τις σημειώσεις έκδοσης πριν από οτιδήποτε άλλο
Οι σημειώσεις έκδοσης αποστέλλονται μέσα σε κάθε πακέτο ως docs/RELEASE-NOTES.md, καταγεγραμμένες στο SHA256SUMS του, ενώ οι ίδιες σημειώσεις βρίσκονται στη σελίδα της έκδοσης στον λογαριασμό σας. Διαβάστε τες πριν από την εγκατάσταση ή την αναβάθμιση. Για το 1.0.0-alpha.1 είναι σύντομες. Είναι η πρώτη έκδοση, επομένως μια νέα εγκατάσταση δεν έχει κανένα από τα σημεία αναβάθμισης που περιγράφουν, και η λίστα γνωστών ζητημάτων αναφέρει ότι τίποτα σε αυτήν δεν επηρεάζει μια νέα εγκατάσταση που ακολουθεί τα τεκμηριωμένα βήματα. Οι μεταγενέστερες εκδόσεις αναφέρουν κάθε γνωστό ζήτημα μαζί με την έκδοση που το επιδιορθώνει.
Η σελίδα της έκδοσης αναφέρει επίσης, σε τρεις γραμμές, τι υπόσχεται μια έκδοση alpha: οι δυνατότητες ενδέχεται να αλλάξουν πριν από την πρώτη σταθερή έκδοση, μια αναβάθμιση διατηρεί τα δεδομένα σας και λαμβάνει πρώτα αντίγραφο ασφαλείας, και οι επιδιορθώσεις ασφαλείας φτάνουν εντός 7 ημερών. Εκτυπώσαμε αυτή τη σελίδα και την τοποθετήσαμε στο αρχείο αλλαγών στη Harrow, επειδή είναι ό,τι πιο κοντινό σε μια δήλωση υποστήριξης θα ζητούσε το συμβούλιο αλλαγών.
Βήμα 1: λάβετε το κλειδί έκδοσης και ελέγξτε το μέσω δεύτερης οδού
Όλα τα παρακάτω βασίζονται σε ένα αρχείο: το δημόσιο κλειδί έκδοσης της Adverant. Ένα κλειδί που προήλθε από το ίδιο μέρος με το αντικείμενο για το οποίο εγγυάται αποδεικνύει ελάχιστα, επομένως ελέγξτε το αποτύπωμά του σε σχέση με ένα αντίγραφο που έφτασε σε εσάς με κάποιον άλλο τρόπο.
Κατεβάστε το κλειδί από τον φάκελο της έκδοσης στις Λήψεις (Downloads).
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pubΥπολογίστε το αποτύπωμά του. Το αποτύπωμα είναι το SHA-256 (Secure Hash Algorithm 256) του ίδιου του αρχείου κλειδιού.
sha256sum release.pubΣτο macOS, το
shasum -a 256 release.pubδίνει την ίδια απάντηση.Συγκρίνετέ το, χαρακτήρα προς χαρακτήρα, με το αποτύπωμα που είναι τυπωμένο στη σύμβασή σας με την Adverant και στις σημειώσεις έκδοσης. Η σελίδα Λήψεις (Downloads) δημοσιεύει επίσης το αποτύπωμα, αλλά αυτό το αντίγραφο ήρθε από την ίδια οδό με το κλειδί, επομένως δεν αποτελεί έλεγχο.
Εάν διαφέρει έστω και ένας χαρακτήρας, σταματήστε. Μην προχωρήσετε σε εγκατάσταση και μην αναζητήσετε άλλο αντίγραφο του κλειδιού στο διαδίκτυο. Ανοίξτε ένα αίτημα υποστήριξης από τον λογαριασμό σας και παραθέστε αυτό που είδατε.
Βήμα 2: λάβετε το nexusctl
Το nexusctl είναι η διεπαφή γραμμής εντολών (CLI) του χειριστή του Nexus. Εκτελείται στον σταθμό εργασίας σας και διαβάζει τη συστοιχία (cluster) σας μέσω του kubeconfig σας. Η σελίδα Λήψεις (Downloads) προσφέρει τέσσερις εκδόσεις κατασκευής (builds):
| Αρχείο | Πλατφόρμα |
|---|---|
nexusctl-linux-amd64 |
Linux σε Intel ή AMD |
nexusctl-darwin-arm64 |
macOS σε Apple silicon |
nexusctl-darwin-amd64 |
macOS σε Intel |
nexusctl-windows-amd64.exe |
Windows |
Δίπλα σε κάθε αρχείο βρίσκεται το πακέτο υπογραφής του, με το ίδιο όνομα και την κατάληξη .sigstore.json. Ελέγξτε το εκτελέσιμο αρχείο πριν το εκτελέσετε:
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/nexusctl-linux-amd64
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/nexusctl-linux-amd64.sigstore.json
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle nexusctl-linux-amd64.sigstore.json nexusctl-linux-amd64Verified OK
Στη συνέχεια, προσθέστε το στη διαδρομή σας (PATH) και ζητήστε την έκδοσή του:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionΑπό εδώ και πέρα, το nexusctl verify μπορεί να κάνει τους ελέγχους αρχείων για εσάς. Το Κεφάλαιο 2.5, Προέλεγχος (Preflight) με το nexusctl, καλύπτει την κύρια εργασία του, τον προέλεγχο.
Γιατί η σημαία (flag) γράφει "insecure"
Κάθε εντολή cosign σε αυτό το κεφάλαιο φέρει το --insecure-ignore-tlog=true. Οι εκδόσεις του Nexus υπογράφονται με το κλειδί της Adverant και δεν καταγράφονται σε κανένα δημόσιο αρχείο καταγραφής διαφάνειας (transparency log), έτσι ώστε ο έλεγχος μιας έκδοσης να μην χρειάζεται ποτέ σύνδεση με κανέναν, συμπεριλαμβανομένου του Sigstore. Από προεπιλογή, το cosign απαιτεί μια εγγραφή στο αρχείο καταγραφής· η σημαία τού υποδεικνύει να βασιστεί αποκλειστικά στο κλειδί. Χωρίς αυτήν, ο έλεγχος αποτυγχάνει ως εξής:
Error: not enough verified log entries from transparency log: 0 < 1
Όταν οριστεί η σημαία, το cosign εξακολουθεί να εμφανίζει την πρόταση "Existence of the claims in the transparency log was verified offline". Αυτή είναι μια σταθερή διατύπωση στο cosign· δεν υπάρχει καμία εγγραφή αρχείου καταγραφής πίσω από αυτήν. Ο έλεγχος της υπογραφής έναντι του κλειδιού είναι πραγματικός και είναι το μέρος που έχει σημασία.
Βήμα 3: ένα pull token, για την έκδοση Enterprise
Οι εικόνες Enterprise προστατεύονται από ένα διακριτικό λήψης (pull token). Μπορείτε να δημιουργήσετε ένα στον λογαριασμό σας, στη σελίδα Διακριτικά λήψης και εντολές εγκατάστασης (Pull tokens and install commands):
- Πατήστε Add a token.
- Δηλώστε για ποια συστοιχία προορίζεται, τι επιτρέπεται να λαμβάνει και πότε λήγει.
- Πατήστε Copy the token και επικολλήστε το απευθείας εκεί όπου φυλάσσετε τα διαπιστευτήρια, επειδή η σελίδα το εμφανίζει μόνο αυτή τη φορά.
Κάθε διακριτικό περιορίζεται σε αυτά που επιτρέπεται να λαμβάνει και έχει ημερομηνία λήξης. Η ανάκληση ενός διακριτικού σταματά αμέσως τις νέες λήψεις· οι εικόνες που έχει ήδη λάβει μια συστοιχία συνεχίζουν να εκτελούνται. Στη Harrow δημιουργήσαμε ένα διακριτικό ανά συστοιχία, επομένως η ανάκληση του διακριτικού της δοκιμαστικής συστοιχίας δεν επηρεάζει ποτέ την παραγωγή. Μια εγκατάσταση Community δεν χρειάζεται καθόλου διακριτικό· δημιουργείτε ένα μόνο όταν μεταβαίνετε σε Enterprise, και μπορείτε να το δημιουργήσετε την ίδια ημέρα.
Το chart δεν έχει τιμή pull-secret. Οι κόμβοι (nodes) σας λαμβάνουν τις εικόνες, επομένως το διακριτικό ανήκει στο περιβάλλον εκτέλεσης κοντέινερ (container runtime) των κόμβων. Στο k3s, προσθέστε το μητρώο (registry) στο /etc/rancher/k3s/registries.yaml σε κάθε κόμβο και επανεκκινήστε το k3s εκεί:
# /etc/rancher/k3s/registries.yaml (on every node)
configs:
"registry.adverant.ai":
auth: {username: "<registry-user>", password: "<pull-token>"}Το <registry-user> είναι το όνομα χρήστη του μητρώου στην πρόσκλησή σας από την Adverant, και το <pull-token> είναι το διακριτικό που αντιγράψατε. Το αρχείο περιέχει ένα διαπιστευτήριο, επομένως διατηρήστε το αναγνώσιμο μόνο από τον χρήστη root.
Σε μια διαχειριζόμενη συστοιχία της οποίας οι κόμβοι δεν διαβάζουν αυτό το αρχείο, αντιγράψτε τις εικόνες σε ένα μητρώο που οι κόμβοι σας εμπιστεύονται ήδη και ορίστε το global.imageRegistry σε αυτό· κάθε κόμβος πρέπει να εμπιστεύεται το πιστοποιητικό Transport Layer Security (TLS) αυτού του μητρώου. Το Κεφάλαιο 2.11, Παραλλαγές: εξωτερικοί χώροι αποθήκευσης, TLS και ingress, καλύπτει αυτό το θέμα, και το κεφάλαιο 2.10, Εγκατάσταση σε απομονωμένο δίκτυο (Air-gapped), καλύπτει την ίδια αντιγραφή για μια τοποθεσία χωρίς εξωτερική δρομολόγηση.
Βήμα 4: διαβάστε το κλείδωμα των images
Ένα chart του Nexus δεν ονομάζει ποτέ μια εικόνα με ετικέτα (tag). Ονομάζει καθεμία με το digest του ευρετηρίου πολλαπλών πλατφορμών της, το οποίο λαμβάνεται από το κλείδωμα εικόνων (images lock), ένα αρχείο που φέρει το chart ως files/images.lock.json. Το πακέτο εκτός σύνδεσης φέρει το ίδιο κλείδωμα ως release/images.lock.json.
Λάβετε το chart και αποσυμπιέστε το για να διαβάσετε το κλείδωμα:
helm pull oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1
tar -xzf nexus-1.0.0-alpha.1.tgz
jq -r '.version, .edition' nexus/files/images.lock.json1.0.0-alpha.1
community
Το ανώτατο επίπεδο του κλειδώματος αναφέρει σε ποια έκδοση (release) και σε ποια έκδοση προϊόντος (edition) ανήκει. Κάθε εγγραφή κάτω από το images περιγράφει μία εικόνα:
| Πεδίο | Τι περιέχει |
|---|---|
svc |
Την υπηρεσία, όπως nexus-auth ή nexus-postgres |
index |
Το digest sha256: του ευρετηρίου της εικόνας, το οποίο καλύπτει τόσο το linux/amd64 όσο και το linux/arm64 |
edition |
community, enterprise ή all για το επίπεδο δεδομένων |
kind |
service, migrations ή data-tier για τους πέντε χώρους αποθήκευσης δεδομένων και το OpenBao |
verified |
Πότε η κατασκευή της έκδοσης επαλήθευσε την υπογραφή και τις βεβαιώσεις (attestations) της |
Το chart αποδίδει κάθε εικόνα ως <global.imageRegistry>/nexus/<svc>@<index>. Έτσι, με το global.imageRegistry: registry.adverant.ai, η υπηρεσία σύνδεσης είναι registry.adverant.ai/nexus/nexus-auth@sha256: ακολουθούμενο από 64 δεκαεξαδικούς χαρακτήρες, και τίποτα στη συστοιχία δεν μπορεί να την αντικαταστήσει με κάτι άλλο με το ίδιο όνομα.
Το κλείδωμα είναι ανά έκδοση προϊόντος (edition). Ένα κλείδωμα Community αναφέρει μόνο εικόνες των οποίων η έκδοση είναι community ή all. Ένα κλείδωμα Enterprise αναφέρει αυτές συν τις κατασκευές Enterprise. Το chart το ελέγχει αυτό κάθε φορά που αποδίδει, και αρνείται αντί να υποθέσει:
| Τι αναφέρει το chart | Γιατί |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Οι δύο τιμές έκδοσης (edition) στο αρχείο τιμών (values file) σας διαφωνούν |
files/images.lock.json is the community lock; this install is edition enterprise |
Εγκαθιστάτε την έκδοση Enterprise από το chart Community, ή το αντίστροφο |
image nexus-auth is not in files/images.lock.json |
Το chart και το κλείδωμά του δεν ταιριάζουν μεταξύ τους· λάβετε ξανά το chart |
image ... is in the lock but was never verified by build-all |
Η εγγραφή κλειδώματος δεν έχει χρόνο επαλήθευσης· μην εγκαταστήσετε από αυτό |
NEXUS_EDITION_INVALID |
Το edition είναι κενό ή δεν είναι ένα από τα community και enterprise |
RELEASE_VERSION_MISSING |
Το κλείδωμα δεν αναφέρει καμία έκδοση |
Εμφανίστε σε λίστα κάθε εικόνα και digest με μία κίνηση:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.jsonΒήμα 5: επαληθεύστε την υπογραφή κάθε image
Κάθε ευρετήριο εικόνας είναι υπογεγραμμένο, όπως και κάθε δηλωτικό (manifest) πλατφόρμας μέσα σε αυτό. Επαληθεύστε με βάση το digest, απευθείας από το κλείδωμα, ώστε να ελέγξετε ακριβώς αυτό που θα εκτελέσει το chart:
jq -r '.images[] | "\(.svc)@\(.index)"' nexus/files/images.lock.json |
while read -r ref; do
cosign verify --key release.pub --insecure-ignore-tlog=true \
"registry.adverant.ai/nexus/$ref" > /dev/null && echo "OK $ref" || echo "FAILED $ref"
doneΚάθε γραμμή πρέπει να ξεκινά με OK. Στη δική μας σύνδεση, ο βρόχος διήρκεσε λίγα λεπτά, με το μεγαλύτερο μέρος του χρόνου να δαπανάται στην αναμονή από το μητρώο. Διαβάζει μόνο τις υπογραφές και δεν λαμβάνει επίπεδα εικόνας (image layers), γεγονός που καθιστά γρήγορη την επανάληψή του μετά από κάθε αναβάθμιση. Μια γραμμή FAILED σημαίνει ότι πρέπει να σταματήσετε: η επόμενη ενότητα εξηγεί τι σημαίνει κάθε μήνυμα.
Για μία μεμονωμένη εικόνα, παραλείψτε την ανακατεύθυνση και διαβάστε τι έλεγξε το cosign:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/nexus-auth@sha256:<digest>The following checks were performed on each of these signatures:
- Existence of the claims in the transparency log was verified offline
- The signatures were verified against the specified public key
Το <digest> είναι οι 64 δεκαεξαδικοί χαρακτήρες από το index του κλειδώματος για αυτήν την εικόνα. Οι εικόνες Enterprise χρειάζονται το διακριτικό λήψης σας για αυτόν τον έλεγχο, όπως και για κάθε λήψη από το μητρώο.
Και οι δύο πλατφόρμες, και τι πρέπει να κρατήσετε
Κάθε ευρετήριο εικόνας περιέχει δύο δηλωτικά πλατφόρμας, linux/amd64 και linux/arm64, και καθένα από αυτά είναι επίσης υπογεγραμμένο. Το cosign verify επιτυγχάνει στο digest του ευρετηρίου και στο digest οποιασδήποτε πλατφόρμας, επομένως μια συστοιχία μικτών κόμβων καλύπτεται από τον ίδιο έλεγχο. Για να δείτε τις δύο πλατφόρμες πίσω από ένα ευρετήριο, ζητήστε από το μητρώο το ακατέργαστο ευρετήριο:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawΗ λίστα manifests του αναφέρει μία εγγραφή amd64 και μία εγγραφή arm64.
Κρατήστε το αποτέλεσμα του παραπάνω βρόχου μαζί με το αρχείο αλλαγών σας, δίπλα στο αποτύπωμα που ελέγξατε. Όταν κάποιος ρωτήσει, μήνες αργότερα, πώς γνωρίζετε ότι η συστοιχία εκτελεί αυτό που απέστειλε η Adverant, αυτό το αρχείο και τα digests του κλειδώματος δίνουν την απάντηση. Ο ελεγκτής μας στη Harrow έκανε ακριβώς αυτή την ερώτηση, και η απάντηση πήρε ένα λεπτό.
Βήμα 6: διαβάστε τις βεβαιώσεις (attestations)
Κάθε εικόνα φέρει επίσης δύο υπογεγραμμένες βεβαιώσεις (attestations), οι οποίες δημιουργήθηκαν από την εικόνα κατά τον χρόνο κατασκευής: έναν κατάλογο υλικών λογισμικού (SBOM - software bill of materials) και μια δήλωση προέλευσης (provenance statement).
Το SBOM είναι σε μορφή Software Package Data Exchange (SPDX), ένα ανά πλατφόρμα, επομένως ένα ευρετήριο φέρει δύο. Αναφέρει κάθε πακέτο στην εικόνα μαζί με την άδεια χρήσης του. Πριν από την κυκλοφορία, αυτές οι άδειες χρήσης ελέγχονται έναντι μιας λίστας απαγόρευσης· καμία εικόνα Community δεν φέρει κώδικα GNU Affero General Public License (AGPL), Server Side Public License (SSPL), Redis Source Available License (RSAL) ή Business Source License (BUSL). Η δήλωση προέλευσης είναι Supply-chain Levels for Software Artifacts (SLSA) v1. Αναφέρει την υποβολή πηγαίου κώδικα (source commit) από την οποία κατασκευάστηκε η εικόνα, τα digests των βασικών εικόνων, καθώς και τα εργαλεία κατασκευής και τις εκδόσεις τους, ώστε μια εικόνα να ανιχνεύεται πίσω στον ελεγμένο πηγαίο κώδικα χωρίς να χρειάζεται να ρωτήσετε την Adverant.
Και τα δύο ελέγχονται έναντι του κλειδιού έκδοσης που έχετε ήδη στην κατοχή σας:
cosign verify-attestation --key release.pub --insecure-ignore-tlog=true \
--type spdxjson registry.adverant.ai/nexus/nexus-auth@sha256:<digest>
cosign verify-attestation --key release.pub --insecure-ignore-tlog=true \
--type slsaprovenance1 registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Ο έλεγχος spdxjson εμφανίζει δύο αποτελέσματα, ένα για το SBOM κάθε πλατφόρμας. Για να δείτε όλα όσα είναι συνημμένα σε μια εικόνα χωρίς να τα επαληθεύσετε, χρησιμοποιήστε το cosign tree:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Εμφανίζει σε λίστα ένα πακέτο υπογραφής, δύο βεβαιώσεις spdx.dev/Document και μία βεβαίωση slsa.dev/provenance/v1. Εάν ζητήσετε έναν τύπο που δεν φέρει η εικόνα, όπως το --type cyclonedx, αποτυγχάνει με none of the attestations matched the predicate type: cyclonedx. Αυτή η αποτυχία είναι σωστή· η έκδοση επισυνάπτει SPDX, όχι CycloneDX.
Βήμα 7: επαληθεύστε το chart και τα αρχεία λήψης
Το chart στο μητρώο είναι υπογεγραμμένο στο OCI digest του (το OCI είναι το Open Container Initiative, η μορφή εικόνας και τεχνουργημάτων που χρησιμοποιούν τα μητρώα). Το helm pull εμφανίζει το digest που έλαβε· ελέγξτε αυτό το digest με τον ίδιο τρόπο όπως μια εικόνα:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Για ένα αρχείο chart που κατεβάσατε, ή για το πακέτο εκτός σύνδεσης, το nexusctl verify ελέγχει το αρχείο έναντι του κλειδιού έκδοσης της Adverant:
nexusctl verify nexus-1.0.0-alpha.1.tgzΈνα επιτυχές αποτέλεσμα καταλήγει αναφέροντας το κλειδί έκδοσης της Adverant και την αρχή του αποτυπώματός του. Συγκρίνετε αυτές τις ομάδες χαρακτήρων με το αποτύπωμα που ελέγξατε στο βήμα 1.
Το πακέτο εκτός σύνδεσης είναι ένα ασυμπίεστο αρχείο tar ανά έκδοση προϊόντος, nexus-alpha-1.0.0-alpha.1-community.tar ή nexus-alpha-1.0.0-alpha.1-enterprise.tar, με ένα αρχείο .sha256 δίπλα του. Στο εσωτερικό του περιέχει:
| Διαδρομή | Τι είναι |
|---|---|
release/images.lock.json |
Το κλείδωμα εικόνων για αυτήν την έκδοση προϊόντος |
release/facts.json |
Τα στοιχεία της έκδοσης: έκδοση, έκδοση προϊόντος (edition), αρχιτεκτονικές και το αποτύπωμα του κλειδιού έκδοσης |
images/<service>/ |
Κάθε εικόνα και με τις δύο πλατφόρμες, την υπογραφή της και τις βεβαιώσεις της |
charts/nexus-1.0.0-alpha.1.tgz |
Το chart |
sbom/ |
Το SPDX SBOM κάθε εικόνας, ανά πλατφόρμα |
docs/ |
Τις σημειώσεις έκδοσης, τον οδηγό εγκατάστασης σε απομονωμένο δίκτυο (air-gap) και παραδείγματα τιμών |
SHA256SUMS και SHA256SUMS.sigstore.json |
Το άθροισμα ελέγχου (checksum) κάθε αρχείου και την υπογραφή του |
Το δημόσιο κλειδί έκδοσης δεν βρίσκεται ποτέ μέσα στο πακέτο· ένα κλειδί που αποστέλλεται μαζί με το αντικείμενο που υπογράφει δεν αποδεικνύει τίποτα. Ελέγξτε ολόκληρο το πακέτο με δύο εντολές, μέσα από τον φάκελό του:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSΚάθε γραμμή της πρώτης εντολής πρέπει να τελειώνει με OK, και η δεύτερη πρέπει να εμφανίζει Verified OK. Το Κεφάλαιο 2.10, Εγκατάσταση σε απομονωμένο δίκτυο (Air-gapped), αναλαμβάνει το πακέτο από εκείνο το σημείο: φόρτωση των εικόνων στο δικό σας μητρώο, εκ νέου επαλήθευση καθεμιάς εκεί, και τον ολοκληρωμένο (end-to-end) έλεγχο του ίδιου του πακέτου.
Όταν μια υπογραφή δεν επαληθεύεται
Σταματήστε. Μην προχωρήσετε σε εγκατάσταση και μην αλλάξετε την εντολή μέχρι να περάσει τον έλεγχο. Ένας αποτυχημένος έλεγχος υπογραφής σημαίνει ότι το σύστημα λειτουργεί: σημαίνει ότι το αρχείο που έχετε δεν είναι το αρχείο που υπέγραψε η Adverant, ή ότι το κλειδί που έχετε στην κατοχή σας δεν είναι της Adverant.
| Τι βλέπετε | Τι σημαίνει | Τι πρέπει να κάνετε |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (exit 1) |
Η εικόνα είναι υπογεγραμμένη, αλλά όχι από το κλειδί που δώσατε | Ελέγξτε ότι χρησιμοποιήσατε το κλειδί έκδοσης του οποίου το αποτύπωμα ελέγξατε στο βήμα 1 |
no signatures found (exit 10) |
Τίποτα σε αυτό το digest δεν είναι υπογεγραμμένο | Ελέγξτε ότι το digest προήλθε από το κλείδωμα· μην επαληθεύετε ποτέ μια ετικέτα (tag) |
not enough verified log entries from transparency log: 0 < 1 |
Λείπει το --insecure-ignore-tlog=true |
Προσθέστε τη σημαία· δεν υπάρχει κανένα πρόβλημα με την εικόνα |
none of the attestations matched the predicate type |
Ζητήσατε έναν τύπο βεβαίωσης που δεν φέρει η εικόνα | Χρησιμοποιήστε το spdxjson ή το slsaprovenance1 |
Error: invalid signature when validating ASN.1 encoded signature |
Ένα ληφθέν αρχείο τροποποιήθηκε αφού υπογράφηκε | Κατεβάστε το ξανά |
FAILED από sha256sum -c |
Ένα αρχείο δεν είναι το αρχείο για το οποίο υπολογίστηκε το άθροισμα ελέγχου | Κατεβάστε το ξανά |
Εάν μια λήψη αποτύχει δύο φορές, ανοίξτε ένα αίτημα υποστήριξης από τον λογαριασμό σας και παραθέστε το όνομα του αρχείου και το μήνυμα. Κρατήστε το αρχείο που απέτυχε· η ομάδα ασφαλείας σας μπορεί να το χρειαστεί.
Σε μια εγκατάσταση που φορτώνει εκδόσεις από τον δίσκο, η κονσόλα εκτελεί τους ίδιους ελέγχους και απορρίπτει μια έκδοση της οποίας η υπογραφή δεν ταιριάζει με το εγκατεστημένο κλειδί, με MEDIA_SIGNATURE_INVALID. Αναφέρει τι έλεγξε, με ποια σειρά, πού σταμάτησε και ότι δεν άλλαξε τίποτα: δεν φορτώθηκε καμία εικόνα, η τρέχουσα έκδοση παρέμεινε ανέπαφη.
Μόλις το κλειδί, οι εικόνες και το chart περάσουν όλα τους ελέγχους, το επόμενο βήμα είναι ο προέλεγχος (preflight) στη συστοιχία σας, στο κεφάλαιο 2.5, Προέλεγχος με το nexusctl.



