Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.4
Preuzimanje i provera izdanja
Gde se nalazi svaki deo Nexus izdanja, kako se Enterprise slike preuzimaju pomoću tokena za preuzimanje i kako da van mreže, pre nego što bilo šta instalirate, dokažete da svaka slika, chart i preuzeta datoteka potiču od kompanije Adverant i da nisu izmenjeni.
Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

Svaka slika u izdanju Nexus potpisana je Adverantovim ključem za izdanja, a svaka slika je imenovana svojim digestom, nikada oznakom. Chart će prikazati samo slike navedene po digestu u sopstvenoj datoteci za zaključavanje slika. Sve zajedno, to znači da možete dokazati, na sopstvenoj radnoj stanici i bez veze sa bilo kim, da je ono što nameravate da pokrenete tačno ono što je Adverant izgradio.
U Harrow Port Authority smo sve proverili pre prve instalacije. Trajalo je dvadesetak minuta, a najveći deo toga otišao je na petlju kroz slike. Ovo poglavlje prolazi istim putem: gde se nalazi svaki deo izdanja, token za preuzimanje Enterprise slika, datoteka za zaključavanje slika, cosign provere sa tačnim komandama i šta učiniti kada provera ne uspe.
Gde se nalazi izdanje
| Adresa | Šta tamo preuzimate |
|---|---|
registry.adverant.ai |
Slike platforme, na registry.adverant.ai/nexus/<service>@sha256:<digest>, i Helm chart, na oci://registry.adverant.ai/nexus/charts/nexus |
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ |
Javni ključ izdanja i njegov otisak, nexusctl binarne datoteke i oflajn paketi |
https://account.adverant.ai |
Vaš Adverant nalog: Preuzimanja, Tokeni za preuzimanje i komande za instalaciju, Implementacije i stranice licence |
Community slike i Community chart su javni; možete ih preuzeti bez prijavljivanja. Enterprise slike se preuzimaju pomoću tokena za preuzimanje iz vašeg naloga, a Enterprise chart i paket nalaze se na stranici Preuzimanja u nalogu, koja prati vašu licencu.
Pročitajte napomene o izdanju pre svega ostalog
Napomene o izdanju isporučuju se u svakom paketu kao docs/RELEASE-NOTES.md, navedene u njegovom SHA256SUMS, a iste napomene nalaze se i na stranici izdanja u vašem nalogu. Pročitajte ih pre instalacije ili nadogradnje. Za 1.0.0-alpha.1 su kratke. To je prvo izdanje, pa nova instalacija nema nijednu od tačaka nadogradnje koje opisuju, a lista poznatih problema navodi da ništa u njoj ne utiče na novu instalaciju koja prati dokumentovane korake. Kasnija izdanja navode svaki poznati problem sa verzijom koja ga ispravlja.
Stranica izdanja takođe u tri reda navodi šta alfa izdanje obećava: funkcije se mogu promeniti pre prve stabilne verzije, nadogradnja čuva vaše podatke i prethodno pravi rezervnu kopiju, a bezbednosne ispravke stižu u roku od 7 dana. Odštampali smo tu stranicu i stavili je u zapis o promeni u Harrow, jer je to najbliže izjavi o podršci koju bi odbor za promene tražio.
Korak 1: preuzmite ključ izdanja i proverite ga drugim putem
Sve navedeno u nastavku počiva na jednoj datoteci: Adverantovom javnom ključu za izdanja. Ključ koji je stigao sa istog mesta kao i ono za šta jemči dokazuje vrlo malo, zato proverite njegov otisak u odnosu na kopiju koja je do vas stigla nekim drugim putem.
Preuzmite ključ iz fascikle izdanja na stranici Preuzimanja.
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pubIzračunajte njegov otisak. Otisak je SHA-256 (Secure Hash Algorithm 256) same datoteke ključa.
sha256sum release.pubNa macOS-u,
shasum -a 256 release.pubdaje isti rezultat.Uporedite ga, znak po znak, sa otiskom odštampanim u vašem ugovoru sa kompanijom Adverant i u napomenama o izdanju. Stranica Preuzimanja takođe objavljuje otisak, ali ta kopija je stigla istim putem kao i ključ, pa ona nije provera.
Ako se bilo koji znak razlikuje, stanite. Ne instalirajte i ne tražite drugu kopiju ključa na internetu. Otvorite zahtev za podršku iz svog naloga i navedite šta ste videli.
Korak 2: preuzmite nexusctl
nexusctl je interfejs komandne linije (CLI) za operatora sistema Nexus. Radi na vašoj radnoj stanici i čita vaš klaster preko vašeg kubeconfig-a. Stranica Preuzimanja nudi četiri verzije:
| Datoteka | Platforma |
|---|---|
nexusctl-linux-amd64 |
Linux na Intel ili AMD procesoru |
nexusctl-darwin-arm64 |
macOS na Apple silicon procesoru |
nexusctl-darwin-amd64 |
macOS na Intel procesoru |
nexusctl-windows-amd64.exe |
Windows |
Uz svaku datoteku nalazi se njen paket potpisa, istog imena sa .sigstore.json na kraju. Proverite binarnu datoteku pre nego što je pokrenete:
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
Zatim je dodajte u svoju putanju i proverite njenu verziju:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionOd ovog trenutka, nexusctl verify može umesto vas da obavlja provere datoteka. Poglavlje 2.5, Preliminarna provera pomoću nexusctl, pokriva njegov glavni zadatak, preliminarnu proveru.
Zašto zastavica kaže „insecure“
Svaka cosign komanda u ovom poglavlju sadrži --insecure-ignore-tlog=true. Nexus izdanja potpisuju se Adverantovim ključem i ne beleže se ni u jednom javnom dnevniku transparentnosti, tako da provera izdanja nikada ne zahteva vezu sa bilo kim, uključujući Sigstore. Podrazumevano cosign zahteva unos u dnevniku; zastavica mu nalaže da se osloni samo na ključ. Bez nje, provera ne uspeva ovako:
Error: not enough verified log entries from transparency log: 0 < 1
Kada je zastavica postavljena, cosign i dalje ispisuje rečenicu „Existence of the claims in the transparency log was verified offline“. To je fiksni tekst u cosign; iza njega ne stoji nikakav unos u dnevniku. Provera potpisa u odnosu na ključ je stvarna, i to je deo koji je bitan.
Korak 3: token za preuzimanje, za Enterprise
Enterprise slike zaštićene su tokenom za preuzimanje. Kreirate ga u svom nalogu, na stranici Tokeni za preuzimanje i komande za instalaciju:
- Pritisnite Dodaj token.
- Navedite za koji je klaster, šta sme da preuzima i kada ističe.
- Pritisnite Kopiraj token i odmah ga nalepite tamo gde čuvate akreditive, jer ga stranica prikazuje samo ovaj put.
Svaki token je ograničen na ono što sme da preuzima i ima datum isteka. Povlačenje tokena odmah zaustavlja nova preuzimanja; slike koje je klaster već preuzeo nastavljaju da rade. U Harrow smo napravili po jedan token za svaki klaster, tako da povlačenje tokena testnog klastera nikada ne utiče na produkciju. Community instalaciji token uopšte nije potreban; kreirate ga tek kada pređete na Enterprise, i to možete učiniti istog dana.
Chart nema vrednost za pull secret. Slike preuzimaju vaši čvorovi, pa token pripada izvršnom okruženju kontejnera na čvorovima. Na k3s, dodajte registar u /etc/rancher/k3s/registries.yaml na svakom čvoru i tamo ponovo pokrenite k3s:
# /etc/rancher/k3s/registries.yaml (on every node)
configs:
"registry.adverant.ai":
auth: {username: "<registry-user>", password: "<pull-token>"}<registry-user> je korisničko ime za registar iz vaše Adverant pozivnice, a <pull-token> je token koji ste kopirali. Datoteka sadrži akreditiv, zato neka je čitljiva samo za root korisnika.
Na upravljanom klasteru čiji čvorovi ne čitaju tu datoteku, kopirajte slike u registar kojem vaši čvorovi već veruju i podesite global.imageRegistry na njega; svaki čvor mora da veruje Transport Layer Security (TLS) sertifikatu tog registra. Poglavlje 2.11, Varijacije: spoljna skladišta, TLS i ingress, pokriva to, a poglavlje 2.10, Instalacija bez mrežne veze, pokriva isto kopiranje za lokaciju bez izlazne veze.
Korak 4: pročitajte datoteku zaključavanja slika (images lock)
Nexus chart nikada ne imenuje sliku oznakom. Svaku imenuje digestom njenog višeplatformskog indeksa, preuzetim iz datoteke za zaključavanje slika, koju chart nosi kao files/images.lock.json. Oflajn paket nosi istu datoteku za zaključavanje kao release/images.lock.json.
Preuzmite chart i raspakujte ga da biste pročitali datoteku za zaključavanje:
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
Najviši nivo datoteke za zaključavanje navodi kojem izdanju i kojoj ediciji pripada. Svaki unos pod images opisuje jednu sliku:
| Polje | Šta sadrži |
|---|---|
svc |
Servis, kao što je nexus-auth ili nexus-postgres |
index |
sha256: digest indeksa slike, koji pokriva i linux/amd64 i linux/arm64 |
edition |
community, enterprise ili all za sloj podataka |
kind |
service, migrations ili data-tier za pet skladišta podataka i OpenBao |
verified |
Kada je proces izgradnje izdanja verifikovao njen potpis i atestacije |
Chart prikazuje svaku sliku kao <global.imageRegistry>/nexus/<svc>@<index>. Dakle, sa global.imageRegistry: registry.adverant.ai, servis za prijavljivanje je registry.adverant.ai/nexus/nexus-auth@sha256: praćen sa 64 heksadecimalna znaka, i ništa u klasteru ne može da ga zameni nečim drugim sa istim imenom.
Datoteka za zaključavanje je posebna za svaku ediciju. Community datoteka navodi samo slike čija je edicija community ili all. Enterprise datoteka navodi te slike i Enterprise verzije. Chart to proverava pri svakom prikazivanju i odbija da nastavi umesto da nagađa:
| Šta chart kaže | Zašto |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Dve vrednosti edicije u vašoj datoteci vrednosti se ne slažu |
files/images.lock.json is the community lock; this install is edition enterprise |
Instalirate Enterprise iz Community charta, ili obrnuto |
image nexus-auth is not in files/images.lock.json |
Chart i njegova datoteka za zaključavanje ne pripadaju jedno drugom; ponovo preuzmite chart |
image ... is in the lock but was never verified by build-all |
Unos u datoteci za zaključavanje nema vreme verifikacije; ne instalirajte iz njega |
NEXUS_EDITION_INVALID |
edition je prazno ili nije jedno od community i enterprise |
RELEASE_VERSION_MISSING |
Datoteka za zaključavanje ne navodi verziju |
Navedite sve slike i digeste odjednom:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.jsonKorak 5: proverite potpis svake slike
Svaki indeks slike je potpisan, kao i svaki manifest platforme u njemu. Verifikujte po digestu, direktno iz datoteke za zaključavanje, kako biste proverili tačno ono što će chart pokrenuti:
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"
doneSvaki red treba da počinje sa OK. Na našoj vezi petlja je trajala nekoliko minuta, većinom u čekanju na registar. Čita samo potpise i ne preuzima slojeve slika, pa je jeftino ponavljati je posle svake nadogradnje. Red sa FAILED znači da treba stati: sledeći odeljak objašnjava šta svaka poruka znači.
Za pojedinačnu sliku, uklonite preusmeravanje i pročitajte šta je cosign proverio:
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> je 64 heksadecimalna znaka iz index u datoteci za zaključavanje za tu sliku. Enterprise slikama je za ovu proveru potreban vaš token za preuzimanje, kao i za svako preuzimanje iz registra.
Obe platforme i šta treba sačuvati
Svaki indeks slike sadrži dva manifesta platforme, linux/amd64 i linux/arm64, i svaki od njih je takođe potpisan. cosign verify uspeva na digestu indeksa i na digestu bilo koje platforme, pa je klaster sa mešovitim čvorovima pokriven istom proverom. Da biste videli dve platforme iza indeksa, zatražite od registra sirovi indeks:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawNjegova lista manifests navodi jedan unos amd64 i jedan unos arm64.
Sačuvajte izlaz gornje petlje uz zapis o promeni, pored otiska koji ste proverili. Kada vas neko, mesecima kasnije, pita kako znate da klaster pokreće ono što je Adverant isporučio, ta datoteka i digesti iz datoteke za zaključavanje daju odgovor. Naš revizor u Harrow postavio je upravo to pitanje, a odgovor je trajao minut.
Korak 6: pročitajte atestacije
Svaka slika nosi i dve potpisane atestacije, napravljene iz slike u vreme izgradnje: softversku listu materijala (SBOM) i izjavu o poreklu.
SBOM je u formatu Software Package Data Exchange (SPDX), po jedan za svaku platformu, pa indeks nosi dva. Navodi svaki paket u slici sa njegovom licencom. Pre izdanja, te licence se proveravaju u odnosu na listu zabranjenih; nijedna Community slika ne sadrži kod pod licencama GNU Affero General Public License (AGPL), Server Side Public License (SSPL), Redis Source Available License (RSAL) ili Business Source License (BUSL). Izjava o poreklu je Supply-chain Levels for Software Artifacts (SLSA) v1. Navodi izvorni commit iz kojeg je slika izgrađena, digeste osnovnih slika i alate za izgradnju sa njihovim verzijama, tako da se slika može pratiti do pregledanog izvornog koda bez obraćanja kompaniji Adverant.
Obe se proveravaju u odnosu na ključ izdanja koji već imate:
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>Provera spdxjson ispisuje dva rezultata, po jedan za SBOM svake platforme. Da biste videli sve što je priloženo uz sliku bez verifikacije, koristite cosign tree:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Navodi jedan paket potpisa, dve spdx.dev/Document atestacije i jednu slsa.dev/provenance/v1 atestaciju. Zahtev za tip koji slika ne nosi, kao što je --type cyclonedx, ne uspeva sa none of the attestations matched the predicate type: cyclonedx. Taj neuspeh je ispravan; izdanje prilaže SPDX, a ne CycloneDX.
Korak 7: proverite chart i preuzete datoteke
Chart u registru potpisan je na svom OCI digestu (OCI je Open Container Initiative, format slika i artefakata koji registri koriste). helm pull ispisuje digest koji je preuzeo; proverite taj digest na isti način kao sliku:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Za chart datoteku koju ste preuzeli, ili za oflajn paket, nexusctl verify proverava datoteku u odnosu na Adverantov ključ izdanja:
nexusctl verify nexus-1.0.0-alpha.1.tgzUspešan rezultat se završava navođenjem Adverantovog ključa izdanja i početka njegovog otiska. Uporedite te grupe sa otiskom koji ste proverili u koraku 1.
Oflajn paket je jedna nekomprimovana tar datoteka po ediciji, nexus-alpha-1.0.0-alpha.1-community.tar ili nexus-alpha-1.0.0-alpha.1-enterprise.tar, sa datotekom .sha256 pored nje. Unutra sadrži:
| Putanja | Šta je to |
|---|---|
release/images.lock.json |
Datoteka za zaključavanje slika za tu ediciju |
release/facts.json |
Podaci o izdanju: verzija, edicija, arhitekture i otisak ključa izdanja |
images/<service>/ |
Svaka slika sa obe platforme, njen potpis i njene atestacije |
charts/nexus-1.0.0-alpha.1.tgz |
Chart |
sbom/ |
SPDX SBOM svake slike, po platformi |
docs/ |
Napomene o izdanju, vodič za instalaciju bez mrežne veze i primeri vrednosti |
SHA256SUMS i SHA256SUMS.sigstore.json |
Kontrolni zbir svake datoteke i njegov potpis |
Javni ključ izdanja nikada se ne nalazi u paketu; ključ koji se isporučuje uz ono što potpisuje ne dokazuje ništa. Proverite ceo paket pomoću dve komande, iz njegove fascikle:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSSvaki red prvog treba da se završava sa OK, a drugi treba da ispiše Verified OK. Poglavlje 2.10, Instalacija bez mrežne veze, preuzima paket od tog trenutka: učitavanje slika u Vaš sopstveni registar, ponovnu proveru svake od njih tamo i sopstvenu proveru paketa od početka do kraja.
Kada provera potpisa ne uspe
Stanite. Nemojte instalirati i nemojte menjati komandu dok provera ne prođe. Neuspela provera potpisa znači da sistem radi: to znači da datoteka koju imate nije datoteka koju je Adverant potpisao, ili da ključ koji posedujete nije Adverant-ov.
| Šta vidite | Šta znači | Šta učiniti |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (izlazni kod 1) |
Slika je potpisana, ali ne ključem koji ste naveli | Proverite da ste koristili ključ izdanja čiji ste otisak proverili u koraku 1 |
no signatures found (izlazni kod 10) |
Ništa na tom digestu nije potpisano | Proverite da li digest potiče iz lock datoteke; nikada ne proveravajte tag |
not enough verified log entries from transparency log: 0 < 1 |
--insecure-ignore-tlog=true nedostaje |
Dodajte opciju; sa slikom nije ništa pogrešno |
none of the attestations matched the predicate type |
Zatražili ste tip atestacije koji slika ne sadrži | Koristite spdxjson ili slsaprovenance1 |
Error: invalid signature when validating ASN.1 encoded signature |
Preuzeta datoteka je izmenjena nakon što je potpisana | Preuzmite je ponovo |
FAILED iz sha256sum -c |
Datoteka nije ona za koju je izračunata kontrolna suma | Preuzmite je ponovo |
Ako preuzimanje ne uspe dva puta, otvorite zahtev za podršku iz svog naloga i navedite naziv datoteke i poruku. Sačuvajte neispravnu datoteku; Vaš bezbednosni tim će je možda zatražiti.
Na instalaciji koja učitava izdanja sa diska, konzola izvršava iste provere i odbija izdanje čiji potpis ne odgovara instaliranom ključu, uz MEDIA_SIGNATURE_INVALID. Navodi šta je provereno, kojim redosledom, gde se zaustavila i da ništa nije izmenjeno: nijedna slika nije učitana, a pokrenuta verzija je netaknuta.
Kada ključ, slike i chart prođu sve provere, sledeći korak je preflight provera Vašeg klastera, u poglavlju 2.5, Preflight sa nexusctl.



