Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.4
Preuzimanje i provjera izdanja
Gdje se nalazi svaki dio izdanja Nexusa, kako se slike izdanja Enterprise dohvaćaju pomoću tokena za povlačenje te kako izvanmrežno dokazati da su svaka slika, chart i preuzeta datoteka stigli iz Adveranta neizmijenjeni, prije nego što išta instalirate.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Svaka slika u izdanju sustava Nexus potpisana je Adverantovim ključem izdanja, a svaka je slika imenovana svojim sažetkom (digestom), nikada oznakom (tagom). Chart će ispisati samo slike navedene prema sažetku u vlastitom zaključavanju slika (images lock). Sve zajedno, to znači da na vlastitoj radnoj stanici i bez povezivanja s bilo kime možete dokazati da je ono što ćete upravo pokrenuti točno ono što je Adverant izgradio.
U organizaciji Harrow Port Authority provjerili smo sve prije prve instalacije. Trajalo je oko dvadeset minuta, a većina toga bila je petlja kroz slike. Ovo poglavlje prolazi istim putem: gdje se nalazi svaki dio izdanja, token za povlačenje (pull token) za Enterprise slike, zaključavanje slika, provjere alatom cosign s njihovim točnim naredbama te što učiniti kada provjera ne uspije.
Gdje se izdanje nalazi
| Adresa | Što tamo dohvaćate |
|---|---|
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 (fingerprint), izvršne datoteke nexusctl te paketi za izvanmrežni rad (offline bundles) |
https://account.adverant.ai |
Vaš Adverant račun: Preuzimanja (Downloads), Tokeni za povlačenje i naredbe za instalaciju (Pull tokens and install commands), Implementacije (Deployments) i stranice s licencama |
Community slike i Community chart su javni; možete ih povući bez prijave. Enterprise slike povlače se pomoću tokena za povlačenje iz vašeg računa, a Enterprise chart i paket nalaze se na stranici Preuzimanja na računu, koja prati vašu licencu.
Prije svega pročitajte bilješke o izdanju
Bilješke o izdanju isporučuju se unutar svakog paketa kao docs/RELEASE-NOTES.md, navedene u njegovoj datoteci SHA256SUMS, a iste se bilješke nalaze na stranici izdanja u vašem računu. Pročitajte ih prije instalacije ili nadogradnje. Za 1.0.0-alpha.1 su kratke. To je prvo izdanje, pa svježa instalacija nema nijednu od točaka nadogradnje koje one opisuju, a popis poznatih problema navodi da ništa s tog popisa ne utječe na svježu instalaciju koja prati dokumentirane korake. Kasnija izdanja navode svaki poznati problem uz verziju koja ga ispravlja.
Stranica izdanja također u tri retka navodi što alfa izdanje obećava: značajke se mogu promijeniti prije prve stabilne verzije, nadogradnja čuva vaše podatke i prvo izrađuje sigurnosnu kopiju, a sigurnosni ispravci stižu u roku od 7 dana. Ispisali smo tu stranicu i uvrstili je u zapis o promjenama u organizaciji Harrow, jer je to najbliže izjavi o podršci koju bi odbor za promjene tražio.
1. korak: preuzmite ključ izdanja i provjerite ga drugim putem
Sve u nastavku počiva na jednoj datoteci: Adverantovom javnom ključu izdanja. Ključ koji je stigao s istog mjesta kao i stvar za koju jamči dokazuje vrlo malo, stoga provjerite njegov otisak u odnosu na kopiju koja je do vas stigla nekim drugim putem.
Preuzmite ključ iz mape 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 sustavu macOS,
shasum -a 256 release.pubdaje isti odgovor.Usporedite ga, znak po znak, s otiskom ispisanim u vašem ugovoru s tvrtkom Adverant i u bilješkama o izdanju. Stranica Preuzimanja također objavljuje otisak, ali ta je kopija stigla istim putem kao i ključ, pa to nije provjera.
Ako se bilo koji znak razlikuje, stanite. Nemojte instalirati i nemojte tražiti drugu kopiju ključa na internetu. Otvorite zahtjev za podršku sa svog računa i navedite što ste vidjeli.
2. korak: preuzmite nexusctl
nexusctl je sučelje naredbenog retka (CLI) operatera sustava Nexus. Pokreće se na vašoj radnoj stanici i čita vaš klaster putem vaše kubeconfig datoteke. Stranica Preuzimanja nudi četiri izvedbe:
| Datoteka | Platforma |
|---|---|
nexusctl-linux-amd64 |
Linux na procesorima Intel ili AMD |
nexusctl-darwin-arm64 |
macOS na čipovima Apple silicon |
nexusctl-darwin-amd64 |
macOS na procesorima Intel |
nexusctl-windows-amd64.exe |
Windows |
Uz svaku datoteku nalazi se njezin paket potpisa, istog naziva s .sigstore.json na kraju. Provjerite izvršnu datoteku prije 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 postavite u svoj PATH i zatražite njezinu verziju:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionOd ovog trenutka nadalje, nexusctl verify može obavljati provjere datoteka umjesto vas. Poglavlje 2.5, Predprovjera alatom nexusctl, obrađuje njegov glavni zadatak, predprovjeru (preflight).
Zašto zastavica kaže „insecure”
Svaka naredba cosign u ovom poglavlju nosi --insecure-ignore-tlog=true. Izdanja sustava Nexus potpisana su Adverantovim ključem i nisu zabilježena ni u jednom javnom dnevniku transparentnosti, tako da za provjeru izdanja nikada nije potrebna veza ni s kim, uključujući Sigstore. Prema zadanim postavkama cosign inzistira na zapisu u dnevniku; zastavica mu govori da se osloni isključivo na ključ. Bez nje, provjera ne uspijeva na sljedeći način:
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 fiksna formulacija u alatu cosign; iza nje ne stoji nikakav zapis u dnevniku. Provjera potpisa u odnosu na ključ je stvarna i to je dio koji je bitan.
3. korak: token za povlačenje, za izdanje Enterprise
Enterprise slike nalaze se iza tokena za povlačenje. Izrađujete ga u svom računu, na stranici Tokeni za povlačenje i naredbe za instalaciju:
- Pritisnite Dodaj token (Add a token).
- Navedite za koji je klaster namijenjen, što smije dohvaćati i kada istječe.
- Pritisnite Kopiraj token (Copy the token) i zalijepite ga izravno na mjesto gdje čuvate vjerodajnice, jer ga stranica prikazuje samo ovaj put.
Svaki je token ograničen na ono što smije dohvaćati i ima datum isteka. Povlačenje tokena odmah zaustavlja nova povlačenja; slike koje je klaster već povukao nastavljaju s radom. U organizaciji Harrow izradili smo jedan token po klasteru, tako da povlačenje tokena testnog klastera nikada ne utječe na produkciju. Community instalacija uopće ne treba token; izrađujete ga tek kada prijeđete na Enterprise, a možete ga izraditi istog dana.
Chart nema vrijednost za pull-secret. Vaši čvorovi povlače slike, pa token pripada izvršnom okruženju kontejnera (container runtime) na čvorovima. Na sustavu k3s dodajte registar u /etc/rancher/k3s/registries.yaml na svakom čvoru i tamo ponovno 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 registra u vašoj Adverant pozivnici, a <pull-token> je token koji ste kopirali. Datoteka sadrži vjerodajnicu, stoga neka bude čitljiva samo korisniku root.
Na upravljanom klasteru čiji čvorovi ne čitaju tu datoteku, kopirajte slike u registar kojem vaši čvorovi već vjeruju i postavite global.imageRegistry na njega; svaki čvor mora vjerovati TLS (Transport Layer Security) certifikatu tog registra. Poglavlje 2.11, Varijacije: vanjska spremišta, TLS i ingress, obrađuje tu temu, a poglavlje 2.10, Instalacija u izoliranom okruženju (Air-gapped installation), obrađuje isto kopiranje za lokaciju bez izlaza na internet.
4. korak: pročitajte datoteku zaključavanja slika
Nexus chart nikada ne imenuje sliku prema oznaci. Svaku imenuje prema sažetku njezinog višeplatformskog indeksa, preuzetom iz zaključavanja slika, datoteke koju chart nosi kao files/images.lock.json. Paket za izvanmrežni rad nosi isto zaključavanje kao release/images.lock.json.
Povucite chart i raspakirajte ga kako biste pročitali 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ša razina zaključavanja govori kojem izdanju i kojoj ediciji pripada. Svaki unos pod images opisuje jednu sliku:
| Polje | Što sadrži |
|---|---|
svc |
Uslugu, kao što je nexus-auth ili nexus-postgres |
index |
sha256: sažetak indeksa slike, koji pokriva i linux/amd64 i linux/arm64 |
edition |
community, enterprise ili all za podatkovni sloj |
kind |
service, migrations ili data-tier za pet spremišta podataka i OpenBao |
verified |
Kada je izgradnja izdanja potvrdila njezin potpis i atestacije |
Chart ispisuje svaku sliku kao <global.imageRegistry>/nexus/<svc>@<index>. Dakle, uz global.imageRegistry: registry.adverant.ai, usluga prijave je registry.adverant.ai/nexus/nexus-auth@sha256: iza čega slijedi 64 heksadecimalna znaka, i ništa u klasteru ne može je zamijeniti nečim drugim istog naziva.
Zaključavanje je specifično za ediciju. Community zaključavanje navodi samo slike čija je edicija community ili all. Enterprise zaključavanje navodi njih plus Enterprise izvedbe. Chart to provjerava svaki put kada se ispisuje i odbija rad umjesto da nagađa:
| Što chart kaže | Zašto |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Dvije vrijednosti edicije u vašoj datoteci vrijednosti se ne podudaraju |
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 njegovo zaključavanje ne pripadaju zajedno; ponovno dohvatite chart |
image ... is in the lock but was never verified by build-all |
Unos u zaključavanju nema vrijeme provjere; nemojte instalirati iz njega |
NEXUS_EDITION_INVALID |
edition je prazan ili nije jedan od community i enterprise |
RELEASE_VERSION_MISSING |
Zaključavanje ne navodi verziju |
Ispišite svaku sliku i sažetak odjednom:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.json5. korak: provjerite potpis svake slike
Svaki indeks slike je potpisan, kao i svaki manifest platforme unutar njega. Provjerite prema sažetku, izravno iz zaključavanja, tako da provjerite toč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 redak treba počinjati s OK. Na našoj vezi petlja je trajala nekoliko minuta, a većina tog vremena potrošena je na čekanje registra. Ona čita samo potpise i ne dohvaća slojeve slika, što je čini jednostavnom za ponavljanje nakon svake nadogradnje. Redak FAILED znači da trebate stati: sljedeći odjeljak objašnjava što svaka poruka znači.
Za jednu pojedinačnu sliku, izbacite preusmjeravanje i pročitajte što je cosign provjerio:
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 polja index u zaključavanju za tu sliku. Enterprise slike trebaju vaš token za povlačenje za ovu provjeru, kao i za svako povlačenje iz registra.
Obje platforme i što zadržati
Svaki indeks slike sadrži dva manifesta platforme, linux/amd64 i linux/arm64, a svaki od njih je također potpisan. cosign verify uspijeva na sažetku indeksa i na sažetku bilo koje platforme, tako da je klaster mješovitih čvorova pokriven istom provjerom. Kako biste vidjeli dvije platforme iza indeksa, zatražite od registra sirovi indeks:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawNjegov popis manifests navodi jedan unos amd64 i jedan unos arm64.
Zadržite izlaz gornje petlje u svom zapisu o promjenama, pokraj otiska koji ste provjerili. Kada netko mjesecima kasnije pita kako znate da klaster pokreće ono što je Adverant isporučio, ta datoteka i sažetci iz zaključavanja daju odgovor. Naš revizor u organizaciji Harrow postavio je upravo to pitanje, a odgovor je trajao minutu.
6. korak: pročitajte atestacije
Svaka slika također nosi dvije potpisane atestacije, izrađene iz slike u vrijeme izgradnje: popis softverskih komponenti (SBOM, software bill of materials) i izjavu o podrijetlu (provenance statement).
SBOM je u obliku Software Package Data Exchange (SPDX), po jedan za svaku platformu, pa indeks nosi dva. On navodi svaki paket u slici s njegovom licencom. Prije izdavanja, te se licence provjeravaju u odnosu na popis zabranjenih licenci; nijedna Community slika ne nosi 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 podrijetlu je Supply-chain Levels for Software Artifacts (SLSA) v1. Ona navodi izvorni commit iz kojeg je slika izgrađena, sažetke osnovnih slika te alate za izgradnju i njihove verzije, tako da se slika može pratiti unatrag do pregledanog izvornog koda bez upita prema tvrtki Adverant.
Oboje se provjerava 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>Provjera spdxjson ispisuje dva rezultata, po jedan za SBOM svake platforme. Kako biste vidjeli sve što je priloženo uz sliku bez provjere, upotrijebite cosign tree:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Ona navodi jedan paket potpisa, dvije atestacije spdx.dev/Document i jednu atestaciju slsa.dev/provenance/v1. Traženje vrste koju slika ne nosi, kao što je --type cyclonedx, ne uspijeva uz none of the attestations matched the predicate type: cyclonedx. Taj je neuspjeh ispravan; izdanje prilaže SPDX, a ne CycloneDX.
7. korak: provjerite chart i preuzete datoteke
Chart u registru potpisan je na svom OCI sažetku (OCI je Open Container Initiative, format slika i artefakata koji registri koriste). helm pull ispisuje sažetak koji je povukao; provjerite taj sažetak na isti način kao i sliku:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Za datoteku charta koju ste preuzeli ili za paket za izvanmrežni rad, nexusctl verify provjerava datoteku u odnosu na Adverantov ključ izdanja:
nexusctl verify nexus-1.0.0-alpha.1.tgzDobar rezultat završava navođenjem Adverantovog ključa izdanja i početka njegovog otiska. Usporedite te grupe s otiskom koji ste provjerili u 1. koraku.
Paket za izvanmrežni rad jedna je nekomprimirana tar datoteka po ediciji, nexus-alpha-1.0.0-alpha.1-community.tar ili nexus-alpha-1.0.0-alpha.1-enterprise.tar, s datotekom .sha256 pokraj nje. Unutra sadrži:
| Putanja | Što je to |
|---|---|
release/images.lock.json |
Zaključavanje slika za tu ediciju |
release/facts.json |
Činjenice o izdanju: verziju, ediciju, arhitekture i otisak ključa izdanja |
images/<service>/ |
Svaku sliku s obje platforme, njezinim potpisom i njezinim atestacijama |
charts/nexus-1.0.0-alpha.1.tgz |
Chart |
sbom/ |
SPDX SBOM svake slike, po platformi |
docs/ |
Bilješke o izdanju, vodič za instalaciju u izoliranom okruženju i primjere vrijednosti |
SHA256SUMS i SHA256SUMS.sigstore.json |
Kontrolni zbroj svake datoteke i njezin potpis |
Javni ključ izdanja nikada se ne nalazi unutar paketa; ključ koji se isporučuje sa stvari koju potpisuje ne dokazuje ništa. Provjerite cijeli paket u dvije naredbe, iz njegove mape:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSSvaki redak prve naredbe treba završavati s OK, a druga treba ispisati Verified OK. Poglavlje 2.10, Instalacija u izoliranom okruženju, preuzima paket od te točke: učitavanje slika u vaš vlastiti registar, ponovna provjera svake od njih tamo te vlastita sveobuhvatna (end-to-end) provjera paketa.
Kada provjera potpisa ne uspije
Stanite. Nemojte instalirati i nemojte mijenjati naredbu dok ne prođe. Neuspjela provjera potpisa znači da sustav radi: to znači da datoteka koju imate nije datoteka koju je Adverant potpisao ili da ključ koji imate nije Adverantov.
| Što vidite | Što to znači | Što učiniti |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (izlaz 1) |
Slika je potpisana, ali ne ključem koji ste naveli | Provjerite jeste li upotrijebili ključ izdanja čiji ste otisak provjerili u 1. koraku |
no signatures found (izlaz 10) |
Ništa na tom sažetku nije potpisano | Provjerite je li sažetak preuzet iz zaključavanja; nikada ne provjeravajte oznaku |
not enough verified log entries from transparency log: 0 < 1 |
Nedostaje --insecure-ignore-tlog=true |
Dodajte zastavicu; sa slikom je sve u redu |
none of the attestations matched the predicate type |
Zatražili ste vrstu atestacije koju slika ne nosi | Upotrijebite spdxjson ili slsaprovenance1 |
Error: invalid signature when validating ASN.1 encoded signature |
Preuzeta datoteka promijenjena je nakon što je potpisana | Preuzmite je ponovno |
FAILED iz sha256sum -c |
Datoteka nije ona datoteka za koju je izračunat kontrolni zbroj | Preuzmite je ponovno |
Ako preuzimanje ne uspije dvaput, otvorite zahtjev za podršku sa svog računa i navedite naziv datoteke i poruku. Zadržite neispravnu datoteku; vaš sigurnosni tim bi je mogao zatražiti.
Na instalaciji koja učitava izdanja s diska, konzola pokreće iste provjere i odbija izdanje čiji se potpis ne podudara s instaliranim ključem, uz MEDIA_SIGNATURE_INVALID. Navodi što je provjerila, kojim redoslijedom, gdje je stala te da ništa nije promijenjeno: nijedna slika nije učitana, a verzija koja se izvodi ostala je netaknuta.
Nakon što ključ, slike i chart prođu provjeru, sljedeći je korak predprovjera na vašem klasteru, u poglavlju 2.5, Predprovjera alatom nexusctl.



