Verzió 1.0.0-alpha.1legújabb
2.4. fejezet
Kiadás beszerzése és ellenőrzése
Hol található a Nexus-kiadás egyes részeinek helye, hogyan tölthetők le az Enterprise képfájlok egy pull token segítségével, és hogyan bizonyítható offline, még bárminek a telepítése előtt, hogy minden képfájl, chart és letöltés változatlan formában az Adveranttól származik.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

A Nexus kiadásokban szereplő minden képfájlt az Adverant kiadási kulcsával írnak alá, és minden képfájlt a lenyomata (digest) alapján neveznek meg, soha nem címke (tag) alapján. A chart kizárólag a saját képfájl-zárolásában (images lock) lenyomat szerint felsorolt képfájlokat állítja elő. Ez együttesen azt jelenti, hogy Ön a saját munkaállomásán, bárminemű külső kapcsolat nélkül bizonyítani tudja, hogy amit futtatni készül, az pontosan megegyezik azzal, amit az Adverant felépített.
A Harrow Port Authoritynál az első telepítés előtt mindent ellenőriztünk. Körülbelül húsz percet vett igénybe, és ennek nagy részét a képfájlokon végighaladó ciklus tette ki. Ez a fejezet ugyanezt az utat járja végig: hol található a kiadás egyes részei, a lehívási token (pull token) az Enterprise képfájlokhoz, a képfájl-zárolás, a cosign ellenőrzések a pontos parancsokkal, valamint a teendők, ha egy ellenőrzés sikertelen.
Hol található a kiadás
| Cím | Amit onnan letölt |
|---|---|
registry.adverant.ai |
A platform képfájljai a registry.adverant.ai/nexus/<service>@sha256:<digest> címen, és a Helm chart a oci://registry.adverant.ai/nexus/charts/nexus címen |
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ |
A kiadási nyilvános kulcs és annak ujjlenyomata, a nexusctl binárisok, valamint az offline csomagok |
https://account.adverant.ai |
Az Ön Adverant-fiókja: Letöltések (Downloads), Lehívási tokenek és telepítési parancsok (Pull tokens and install commands), Telepítések (Deployments), valamint a licencoldalak |
A Community képfájlok és a Community chart nyilvánosak; bejelentkezés nélkül lehívhatja őket. Az Enterprise képfájlok a fiókjából származó lehívási tokennel hívhatók le, az Enterprise chart és csomag pedig a fiók Letöltések (Downloads) oldalán található, amely az Ön licencét követi.
Mindenekelőtt olvassa el a kiadási megjegyzéseket
A kiadási megjegyzések minden csomagban docs/RELEASE-NOTES.md néven találhatók meg, a csomag SHA256SUMS fájljában felsorolva, és ugyanezek a megjegyzések olvashatók a fiókja kiadási oldalán is. Telepítés vagy frissítés előtt olvassa el őket. A 1.0.0-alpha.1 esetében ezek rövidek. Ez az első kiadás, így egy tiszta telepítésnél egyik általuk leírt frissítési szempont sem merül fel, az ismert hibák listája szerint pedig semmi sem érint egy olyan tiszta telepítést, amely követi a dokumentált lépéseket. A későbbi kiadások minden ismert hibát felsorolnak az azt javító verzióval együtt.
A kiadási oldal három sorban azt is összefoglalja, mit ígér egy alfa kiadás: a funkciók az első stabil verzióig változhatnak, a frissítés megőrzi az adatokat és előtte biztonsági mentést készít, a biztonsági javítások pedig 7 napon belül megérkeznek. Harrow-ban kinyomtattuk ezt az oldalt, és betettük a változásnaplóba, mert ez áll a legközelebb ahhoz a támogatási nyilatkozathoz, amelyet a változáskezelési bizottság kérne.
1. lépés: szerezze be a kiadási kulcsot, és ellenőrizze egy második útvonalon
Az alábbiakban minden egyetlen fájlon nyugszik: az Adverant kiadási nyilvános kulcsán. Egy olyan kulcs, amely ugyanarról a helyről származik, mint az a dolog, amelyért kezeskedik, vajmi keveset bizonyít, ezért ellenőrizze az ujjlenyomatát egy olyan példány alapján, amely más úton jutott el Önhöz.
Töltse le a kulcsot a kiadás mappájából a Letöltések (Downloads) oldalon.
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pubSzámítsa ki az ujjlenyomatát. Az ujjlenyomat magának a kulcsfájlnak az SHA-256 (Secure Hash Algorithm 256) értéke.
sha256sum release.pubmacOS rendszeren a
shasum -a 256 release.pubugyanezt az eredményt adja.Hasonlítsa össze karakterről karakterre az Adveranttal kötött szerződésében és a kiadási megjegyzésekben nyomtatott ujjlenyomattal. A Letöltések (Downloads) oldal is közzéteszi az ujjlenyomatot, de az a példány ugyanazon az úton érkezett, mint a kulcs, így az nem minősül ellenőrzésnek.
Ha bármelyik karakter eltér, álljon meg. Ne telepítsen, és ne kezdjen el másik példányt keresni a kulcsból az interneten. Nyisson egy támogatási jegyet a fiókjából, és idézze, amit látott.
2. lépés: szerezze be a nexusctl eszközt
A nexusctl a Nexus üzemeltetőjének parancssori felülete (CLI). Az Ön munkaállomásán fut, és a kubeconfig fájlon keresztül olvassa a fürtjét. A Letöltések (Downloads) oldal négy változatot kínál:
| Fájl | Platform |
|---|---|
nexusctl-linux-amd64 |
Linux Intel vagy AMD alapokon |
nexusctl-darwin-arm64 |
macOS Apple silicon alapokon |
nexusctl-darwin-amd64 |
macOS Intel alapokon |
nexusctl-windows-amd64.exe |
Windows |
Minden fájl mellett ott található az aláíráscsomagja, ugyanazzal a névvel, a végén .sigstore.json kiterjesztéssel. Futtatás előtt ellenőrizze a binárist:
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
Ezután tegye az elérési útvonalba (PATH), és kérdezze le a verzióját:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionInnentől kezdve a nexusctl verify el tudja végezni Ön helyett a fájlellenőrzéseket. A 2.5. fejezet, Előzetes ellenőrzés a nexusctl segítségével, bemutatja a fő feladatát, az előzetes ellenőrzést (preflight).
Miért szerepel a kapcsolóban az „insecure” (nem biztonságos) szó
Ebben a fejezetben minden cosign parancs tartalmazza a --insecure-ignore-tlog=true kapcsolót. A Nexus kiadásokat az Adverant kulcsával írják alá, és nem rögzítik őket nyilvános átláthatósági naplóban (transparency log), így a kiadás ellenőrzéséhez soha nincs szükség külső kapcsolatra, beleértve a Sigstore-t is. Alapértelmezés szerint a cosign ragaszkodik a naplóbejegyzéshez; a kapcsoló utasítja, hogy kizárólag a kulcsra hagyatkozzon. Enélkül az ellenőrzés a következőképpen hiúsul meg:
Error: not enough verified log entries from transparency log: 0 < 1
Amikor a kapcsoló be van állítva, a cosign továbbra is kiírja az „Existence of the claims in the transparency log was verified offline” mondatot. Ez egy rögzített szövegezés a cosign eszközben; nincs mögötte naplóbejegyzés. A kulcs alapján végzett aláírás-ellenőrzés azonban valódi, és ez az a rész, ami számít.
3. lépés: pull token az Enterprise kiadáshoz
Az Enterprise képfájlokat lehívási token védi. Ilyet a fiókjában, a Lehívási tokenek és telepítési parancsok (Pull tokens and install commands) oldalon hozhat létre:
- Nyomja meg a Token hozzáadása (Add a token) gombot.
- Adja meg, melyik fürthöz készül, mit tölthet le, és mikor jár le.
- Nyomja meg a Token másolása (Copy the token) gombot, és illessze be egyenesen oda, ahol a hitelesítő adatait tárolja, mert az oldal csak ez az egyetlen alkalommal jeleníti meg.
Minden token korlátozva van arra, hogy mit tölthet le, és rendelkezik lejárati dátummal. Egy token visszavonása azonnal leállítja az új lehívásokat; a fürt által már lehívott képfájlok tovább futnak. Harrow-ban fürtönként egy tokent hoztunk létre, így a tesztfürt tokenjének visszavonása soha nem érinti az éles rendszert. A Community telepítéshez egyáltalán nincs szükség tokenre; csak akkor kell létrehoznia egyet, amikor Enterprise-ra vált, és azt még aznap létrehozhatja.
A chart nem rendelkezik pull-secret értékkel. A képfájlokat a csomópontok (node-ok) hívják le, így a token a csomópontok konténer-futtatókörnyezetéhez tartozik. k3s rendszeren adja hozzá a regisztrációs adatbázist (registry) a /etc/rancher/k3s/registries.yaml fájlhoz minden csomóponton, és indítsa újra ott a k3s-t:
# /etc/rancher/k3s/registries.yaml (on every node)
configs:
"registry.adverant.ai":
auth: {username: "<registry-user>", password: "<pull-token>"}A <registry-user> az Ön Adverant-meghívójában szereplő registry-felhasználónév, a <pull-token> pedig a kimásolt token. A fájl hitelesítő adatot tartalmaz, ezért állítsa be úgy, hogy csak a root olvashassa.
Olyan menedzselt fürtön, amelynek csomópontjai nem olvassák ezt a fájlt, másolja a képfájlokat egy olyan regisztrációs adatbázisba, amelyben a csomópontjai már megbíznak, és állítsa be arra a global.imageRegistry értéket; minden csomópontnak meg kell bíznia az adott regisztrációs adatbázis Transport Layer Security (TLS) tanúsítványában. Ezt a 2.11. fejezet, Variációk: külső adattárak, TLS és ingress tárgyalja, a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés pedig ugyanezt a másolási folyamatot mutatja be egy kifelé vezető útvonallal nem rendelkező telephely esetében.
4. lépés: olvassa be a képfájlok zárolási fájlját (images lock)
A Nexus chart soha nem nevez meg képfájlt címke (tag) alapján. Mindegyiket a többplatformos indexének lenyomata (digest) alapján nevezi meg, amelyet a képfájl-zárolásból (images lock) vesz – ez egy olyan fájl, amelyet a chart files/images.lock.json néven tartalmaz. Az offline csomag ugyanezt a zárolást release/images.lock.json néven tartalmazza.
Hívja le a chartot, és csomagolja ki a zárolás elolvasásához:
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
A zárolás legfelső szintje megadja, hogy melyik kiadáshoz és melyik kiadási változathoz (edition) tartozik. Az images alatti minden egyes bejegyzés egy-egy képfájlt ír le:
| Mező | Mit tartalmaz |
|---|---|
svc |
A szolgáltatást, például nexus-auth vagy nexus-postgres |
index |
A képfájl indexének sha256: lenyomatát, amely lefedi mind a linux/amd64, mind a linux/arm64 architektúrát |
edition |
community, enterprise vagy all az adatréteghez |
kind |
service, migrations vagy data-tier az öt adattárhoz és az OpenBao-hoz |
verified |
Mikor ellenőrizte a kiadási build az aláírását és a tanúsításait (attestations) |
A chart minden képfájlt <global.imageRegistry>/nexus/<svc>@<index> formában állít elő. Így a global.imageRegistry: registry.adverant.ai használatával a bejelentkezési szolgáltatás registry.adverant.ai/nexus/nexus-auth@sha256:, amelyet 64 hexadecimális karakter követ, és a fürtben semmi sem cserélheti ki egy másik, azonos nevű elemre.
A zárolás kiadási változatonként (edition) értendő. A Community zárolás csak azokat a képfájlokat sorolja fel, amelyek kiadási változata community vagy all. Az Enterprise zárolás ezeket, valamint az Enterprise buildeket sorolja fel. A chart ezt minden előállításkor ellenőrzi, és találgatás helyett elutasítja a műveletet:
| Mit mond a chart | Miért |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
A values fájlban szereplő két kiadási változat (edition) értéke eltér egymástól |
files/images.lock.json is the community lock; this install is edition enterprise |
Enterprise-t telepít a Community chartból, vagy fordítva |
image nexus-auth is not in files/images.lock.json |
A chart és a zárolása nem tartozik össze; töltse le újra a chartot |
image ... is in the lock but was never verified by build-all |
A zárolási bejegyzésnek nincs ellenőrzési ideje; ne telepítsen belőle |
NEXUS_EDITION_INVALID |
A edition üres, vagy nem a community és enterprise egyike |
RELEASE_VERSION_MISSING |
A zárolás nem nevez meg verziót |
Listázzon ki minden képfájlt és lenyomatot egyetlen lépésben:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.json5. lépés: ellenőrizze minden képfájl aláírását
Minden képfájl-index alá van írva, és a benne lévő összes platform-manifesztum is. Ellenőrizze lenyomat alapján, közvetlenül a zárolásból, így pontosan azt ellenőrzi, amit a chart futtatni fog:
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"
doneMinden sornak OK értékkel kell kezdődnie. A mi kapcsolatunkon a ciklus néhány percet vett igénybe, aminek nagy részét a regisztrációs adatbázisra való várakozás tette ki. Csak az aláírásokat olvassa be, és nem tölt le képfájl-rétegeket, így minden frissítés után gyorsan és kis erőforrás-igénnyel megismételhető. A FAILED sor megállást jelent: a következő szakasz ismerteti, mit jelentenek az egyes üzenetek.
Egyetlen önálló képfájl esetében hagyja el az átirányítást, és olvassa el, mit ellenőrzött a 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
A <digest> az adott képfájlhoz tartozó 64 hexadecimális karakter a zárolás index mezőjéből. Az Enterprise képfájlokhoz ehhez az ellenőrzéshez is szükség van a lehívási tokenre, akárcsak a regisztrációs adatbázisból történő bármely más lehíváshoz.
Mindkét platform, és amit érdemes megőrizni
Minden képfájl-index két platform-manifesztumot tartalmaz, linux/amd64 és linux/arm64, és ezek mindegyike külön is alá van írva. A cosign verify sikeresen lefut az index lenyomatán és bármelyik platform lenyomatán is, így a vegyes csomópontokból álló fürtöket is lefedi ugyanaz az ellenőrzés. Az index mögött lévő két platform megtekintéséhez kérje le a nyers indexet a regisztrációs adatbázistól:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawA manifests listája egy amd64 bejegyzést és egy arm64 bejegyzést nevez meg.
Őrizze meg a fenti ciklus kimenetét a változásnaplóban, az Ön által ellenőrzött ujjlenyomat mellett. Ha hónapokkal később valaki megkérdezi, honnan tudja, hogy a fürt azt futtatja, amit az Adverant szállított, ez a fájl és a zárolás lenyomatai megadják a választ. A harrow-i auditorunk pontosan ezt a kérdést tette fel, és a válasz egy percet vett igénybe.
6. lépés: olvassa be a tanúsításokat (attestations)
Minden képfájl két aláírt tanúsítást (attestation) is hordoz, amelyek a képfájlból készültek a buildelés során: egy szoftverösszetevő-listát (SBOM) és egy származási nyilatkozatot (provenance statement).
Az SBOM Software Package Data Exchange (SPDX) formátumú, platformonként egy-egy, így egy index kettőt tartalmaz. Felsorolja a képfájlban található összes csomagot a licencével együtt. Kiadás előtt ezeket a licenceket összevetik egy tiltólistával; egyetlen Community képfájl sem tartalmaz GNU Affero General Public License (AGPL), Server Side Public License (SSPL), Redis Source Available License (RSAL) vagy Business Source License (BUSL) licencű kódot. A származási nyilatkozat Supply-chain Levels for Software Artifacts (SLSA) v1 szabványú. Megnevezi a forrás-commitot, amelyből a képfájl készült, az alapképfájlok lenyomatait, valamint a buildelő eszközöket és azok verzióit, így a képfájl az Adverant megkérdezése nélkül is visszavezethető az ellenőrzött forráskódra.
Mindkettő ellenőrzése a már Ön által birtokolt kiadási kulcs alapján történik:
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>Az spdxjson ellenőrzés két eredményt ír ki, egyet-egyet mindkét platform SBOM-jához. Ha ellenőrzés nélkül szeretne látni mindent, ami egy képfájlhoz van csatolva, használja a cosign tree parancsot:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Ez felsorol egy aláíráscsomagot, két spdx.dev/Document tanúsítást és egy slsa.dev/provenance/v1 tanúsítást. Ha olyan típust kér le, amelyet a képfájl nem hordoz, például --type cyclonedx, a művelet none of the attestations matched the predicate type: cyclonedx hibával meghiúsul. Ez a hiba a várt működés; a kiadás SPDX-et csatol, nem CycloneDX-et.
7. lépés: ellenőrizze a chartot és a letöltéseket
A regisztrációs adatbázisban lévő chart az OCI-lenyomatán van aláírva (az OCI az Open Container Initiative, a regisztrációs adatbázisok által használt képfájl- és műtermékformátum). A helm pull kiírja a lehívott lenyomatot; ellenőrizze ezt a lenyomatot ugyanúgy, mint egy képfájlt:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Egy letöltött chartfájl vagy az offline csomag esetében a nexusctl verify ellenőrzi a fájlt az Adverant kiadási kulcsa alapján:
nexusctl verify nexus-1.0.0-alpha.1.tgzA sikeres eredmény a végén megnevezi az Adverant kiadási kulcsát és az ujjlenyomata elejét. Hasonlítsa össze ezeket a csoportokat az 1. lépésben ellenőrzött ujjlenyomattal.
Az offline csomag kiadási változatonként egyetlen tömörítetlen tar fájl, nexus-alpha-1.0.0-alpha.1-community.tar vagy nexus-alpha-1.0.0-alpha.1-enterprise.tar, mellette egy .sha256 fájllal. Belül a következőket tartalmazza:
| Elérési út | Mi ez |
|---|---|
release/images.lock.json |
Az adott kiadási változathoz tartozó képfájl-zárolás |
release/facts.json |
A kiadási adatok: verzió, kiadási változat, architektúrák és a kiadási kulcs ujjlenyomata |
images/<service>/ |
Minden képfájl mindkét platformmal, az aláírásával és a tanúsításaival |
charts/nexus-1.0.0-alpha.1.tgz |
A chart |
sbom/ |
Minden képfájl SPDX SBOM-ja, platformonként |
docs/ |
A kiadási megjegyzések, a zárt hálózati (air-gap) telepítési útmutató és példaértékek |
SHA256SUMS és SHA256SUMS.sigstore.json |
Minden fájl ellenőrzőösszege és annak aláírása |
A kiadási nyilvános kulcs soha nincs benne a csomagban; egy olyan kulcs, amely azzal a dologgal együtt érkezik, amelyet aláír, semmit sem bizonyít. Ellenőrizze a teljes csomagot két paranccsal, a mappáján belülről:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSAz első parancs minden sorának OK értékkel kell végződnie, a másodiknak pedig Verified OK értéket kell kiírnia. A 2.10. fejezet, Zárt hálózati (air-gapped) telepítés innen viszi tovább a csomagot: a képfájlok betöltése a saját regisztrációs adatbázisába, mindegyik újbóli ellenőrzése ott, valamint a csomag saját, végponttól végpontig terjedő ellenőrzése.
Amikor egy aláírás ellenőrzése sikertelen
Álljon meg. Ne telepítsen, és ne módosítsa a parancsot addig, amíg át nem megy. A sikertelen aláírás-ellenőrzés azt jelenti, hogy a rendszer teszi a dolgát: a birtokában lévő fájl nem az a fájl, amelyet az Adverant aláírt, vagy a birtokában lévő kulcs nem az Adveranté.
| Amit lát | Mit jelent | Teendők |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (exit 1) |
A képfájl alá van írva, de nem az Ön által megadott kulccsal | Ellenőrizze, hogy azt a kiadási kulcsot használta-e, amelynek az ujjlenyomatát az 1. lépésben ellenőrizte |
no signatures found (exit 10) |
Az adott lenyomatnál semmi sincs aláírva | Ellenőrizze, hogy a lenyomat a zárolásból származik-e; soha ne ellenőrizzen címkét (tag) |
not enough verified log entries from transparency log: 0 < 1 |
A --insecure-ignore-tlog=true hiányzik |
Adja hozzá a kapcsolót; a képfájllal nincs semmi baj |
none of the attestations matched the predicate type |
Olyan tanúsítástípust kért, amelyet a képfájl nem hordoz | Használja a spdxjson vagy slsaprovenance1 értéket |
Error: invalid signature when validating ASN.1 encoded signature |
Egy letöltött fájl az aláírása után megváltozott | Töltse le újra |
FAILED a sha256sum -c parancsból |
Egy fájl nem azonos azzal a fájllal, amelyre az ellenőrzőösszeget számították | Töltse le újra |
Ha egy letöltés kétszer is meghiúsul, nyisson egy támogatási jegyet a fiókjából, és idézze a fájlnevet, valamint az üzenetet. Őrizze meg a hibás fájlt; a biztonsági csapatának szüksége lehet rá.
Egy olyan telepítésen, amely lemezről tölti be a kiadásokat, a konzol ugyanezeket az ellenőrzéseket futtatja le, és MEDIA_SIGNATURE_INVALID üzenettel elutasítja azt a kiadást, amelynek az aláírása nem egyezik a telepített kulccsal. Megmondja, hogy mit ellenőrzött, milyen sorrendben, hol állt meg, és hogy semmi sem változott: nem töltődött be képfájl, a futó verzió érintetlen maradt.
Miután a kulcs, a képfájlok és a chart is sikeresen átment az ellenőrzésen, a következő lépés a fürt előzetes ellenőrzése (preflight), a 2.5. fejezetben, Előzetes ellenőrzés a nexusctl segítségével.



