Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.4
Að sækja og sannreyna útgáfu
Hvar hver hluti Nexus-útgáfu er geymdur, hvernig Enterprise-gámaímyndir eru sóttar með niðurhalslykli (pull token) og hvernig hægt er að sanna án nettengingar að hver gámaímynd, kort og niðurhal hafi komið óbreytt frá Adverant, áður en þú setur nokkuð upp.
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Sérhver mynd í útgáfu af Nexus er undirrituð með útgáfulykli Adverant og sérhver mynd er auðkennd með hakgildi (digest) sínu, aldrei með merki (tag). Helm-kortið framkallar aðeins myndir sem eru skráðar með hakgildi í sinni eigin myndalásskrá (images lock). Samanlagt þýðir þetta að þú getur sannað á þinni eigin vinnustöð, og án tengingar við nokkurn annan, að það sem þú ert í þann mund að keyra sé nákvæmlega það sem Adverant smíðaði.
Hjá Harrow Port Authority yfirfórum við allt fyrir fyrstu uppsetningu. Það tók um tuttugu mínútur og mestur tíminn fór í lykkjuna yfir myndirnar. Þessi kafli fylgir sömu slóð: hvar hver hluti útgáfunnar er geymdur, sóknartókanið (pull token) fyrir Enterprise-myndir, myndalásskráin, cosign-athuganirnar með nákvæmum skipunum og hvað skal gera þegar athugun mistekst.
Hvar útgáfan er geymd
| Vistfang | Hvað þú sækir þaðan |
|---|---|
registry.adverant.ai |
Kerfismyndirnar á registry.adverant.ai/nexus/<service>@sha256:<digest> og Helm-kortið á oci://registry.adverant.ai/nexus/charts/nexus |
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ |
Opinbera útgáfulykilinn og fingrafar hans, nexusctl-keyrsluskrárnar og pakkana fyrir ótengda uppsetningu |
https://account.adverant.ai |
Adverant-reikningurinn þinn: Niðurhal, Sóknartókan og uppsetningarskipanir, Uppsetningar og leyfissíðurnar |
Community-myndir og Community-kortið eru opinber; þú getur sótt þau án þess að skrá þig inn. Enterprise-myndir eru sóttar með sóknartókani af reikningnum þínum og Enterprise-kortið og pakkinn eru á síðunni Niðurhal á reikningnum, sem fylgir leyfinu þínu.
Lestu útgáfulýsinguna áður en lengra er haldið
Útgáfulýsingin fylgir með í hverjum pakka sem docs/RELEASE-NOTES.md, skráð í SHA256SUMS hans, og sömu lýsingu er að finna á útgáfusíðunni á reikningnum þínum. Lestu hana áður en þú setur upp eða uppfærir. Fyrir 1.0.0-alpha.1 er hún stutt. Þetta er fyrsta útgáfan, þannig að ný uppsetning felur ekki í sér nein af þeim uppfærsluatriðum sem þar er lýst, og listinn yfir þekkt vandamál segir að ekkert á honum hafi áhrif á nýja uppsetningu sem fylgir skráðum skrefum. Síðari útgáfur telja upp hvert þekkt vandamál ásamt útgáfunni sem lagar það.
Útgáfusíðan segir einnig í þremur línum hverju alfa-útgáfa lofar: eiginleikar geta breyst fyrir fyrstu stöðugu útgáfuna, uppfærsla heldur gögnunum þínum og tekur fyrst afrit, og öryggisviðbætur berast innan 7 daga. Við prentuðum þá síðu út og settum í breytingaskrána hjá Harrow, því það er það sem kemst næst stuðningsyfirlýsingu sem breytingaráðið myndi biðja um.
Skref 1: sæktu útgáfulykilinn og sannreyndu hann eftir annarri leið
Allt hér að neðan hvílir á einni skrá: opinbera útgáfulykli Adverant. Lykill sem kemur frá sama stað og hluturinn sem hann ábyrgist sannar mjög lítið, svo þú skalt bera fingrafar hans saman við eintak sem barst þér eftir annarri leið.
Sæktu lykilinn úr möppu útgáfunnar á síðunni Niðurhal.
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pubReiknaðu út fingrafar hans. Fingrafarið er SHA-256 (Secure Hash Algorithm 256) hakgildi lykilskrárinnar sjálfrar.
sha256sum release.pubÁ macOS gefur
shasum -a 256 release.pubsömu niðurstöðu.Berðu það saman, staf fyrir staf, við fingrafarið sem er prentað í samningnum þínum við Adverant og í útgáfulýsingunni. Síðan Niðurhal birtir fingrafarið líka, en það eintak barst sömu leið og lykillinn, þannig að það gildir ekki sem sannprófun.
Ef einhver stafur er frábrugðinn skaltu hætta. Ekki setja upp og ekki fara að leita að öðru eintaki af lyklinum á netinu. Opnaðu stuðningsbeiðni af reikningnum þínum og tilgreindu hvað þú sást.
Skref 2: sæktu nexusctl
nexusctl er skipanalínuviðmót (CLI) Nexus-rekstraraðilans. Það keyrir á vinnustöðinni þinni og les klasann þinn í gegnum kubeconfig-skrána þína. Niðurhal býður upp á fjórar útgáfur:
| Skrá | Umhverfi |
|---|---|
nexusctl-linux-amd64 |
Linux á Intel eða AMD |
nexusctl-darwin-arm64 |
macOS á Apple silicon |
nexusctl-darwin-amd64 |
macOS á Intel |
nexusctl-windows-amd64.exe |
Windows |
Við hlið hverrar skrár er undirskriftarpakki hennar, með sama nafni og .sigstore.json aftast. Athugaðu keyrsluskrána áður en þú keyrir hana:
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
Settu hana svo í keyrsluslóðina þína (PATH) og biddu um útgáfunúmer hennar:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionHéðan í frá getur nexusctl verify séð um skráaathuganirnar fyrir þig. Kafli 2.5, Forathugun með nexusctl, fjallar um aðalhlutverk þess, forathugun.
Hvers vegna flaggið segir „insecure“
Sérhver cosign-skipun í þessum kafla inniheldur --insecure-ignore-tlog=true. Útgáfur af Nexus eru undirritaðar með lykli Adverant og eru ekki skráðar í neina opinbera gagnsæisskrá (transparency log), þannig að athugun á útgáfu krefst aldrei tengingar við neinn, þar á meðal Sigstore. Sjálfgefið krefst cosign færslu í slíkri skrá; flaggið segir því að treysta eingöngu á lykilinn. Án þess mistekst athugunin á þennan hátt:
Error: not enough verified log entries from transparency log: 0 < 1
Þegar flaggið er stillt prentar cosign samt setninguna „Existence of the claims in the transparency log was verified offline“. Þetta er fast orðalag í cosign; það er engin skráarfærsla á bak við það. Undirskriftarathugunin gagnvart lyklinum er raunveruleg og það er sá hluti sem skiptir máli.
Skref 3: niðurhalslykill, fyrir Enterprise
Enterprise-myndir eru varðar með sóknartókani. Þú býrð það til á reikningnum þínum, undir Sóknartókan og uppsetningarskipanir:
- Ýttu á Bæta við tókani.
- Tilgreindu fyrir hvaða klasa það er, hvað það má sækja og hvenær það rennur út.
- Ýttu á Afrita tókanið og límdu það beint inn þar sem þú geymir auðkenni, því síðan sýnir það aðeins í þetta eina skipti.
Hvert tókan er takmarkað við það sem það má sækja og hefur gildistíma. Ef tókan er afturkallað stöðvast nýjar sóknir samstundis; myndir sem klasi hefur þegar sótt halda áfram að keyra. Við bjuggum til eitt tókan fyrir hvern klasa hjá Harrow, þannig að afturköllun á tókani prófunarklasans snertir aldrei raunrekstur. Community-uppsetning þarf ekkert tókan; þú býrð það aðeins til þegar þú færir þig yfir í Enterprise, og þú getur búið það til sama dag.
Helm-kortið er ekki með neitt pull-secret gildi. Hnútarnir þínir sækja myndirnar, þannig að tókanið tilheyrir gámakeyrsluumhverfi (container runtime) hnútanna. Á k3s skaltu bæta myndaskránni (registry) við /etc/rancher/k3s/registries.yaml á hverjum hnúti og endurræsa k3s þar:
# /etc/rancher/k3s/registries.yaml (on every node)
configs:
"registry.adverant.ai":
auth: {username: "<registry-user>", password: "<pull-token>"}<registry-user> er notandanafn myndaskrárinnar í Adverant-boðinu þínu og <pull-token> er tókanið sem þú afritaðir. Skráin geymir auðkenni, svo þú skalt tryggja að aðeins root geti lesið hana.
Á stýrðum klasa þar sem hnútarnir lesa ekki þá skrá skaltu afrita myndirnar yfir í myndaskrá sem hnútarnir þínir treysta þegar og stilla global.imageRegistry á hana; hver hnútur verður að treysta TLS-skilríki (Transport Layer Security) þeirrar myndaskrár. Kafli 2.11, Tilbrigði: ytri gagnageymslur, TLS og inngátt (ingress), fjallar um það, og kafli 2.10, Ótengd uppsetning (air-gapped), fjallar um sömu afritun fyrir starfsstöð án útleiðar.
Skref 4: lestu læsingarskrá gámaímynda
Nexus-kort tilgreinir aldrei mynd með merki (tag). Það tilgreinir hverja mynd með hakgildi (digest) fjölumhverfisyfirlits hennar (multi-platform index), sem tekið er úr myndalásskránni, skrá sem fylgir kortinu sem files/images.lock.json. Ótengdi pakkinn inniheldur sömu lásskrá sem release/images.lock.json.
Sæktu kortið og afpakkaðu því til að lesa lásskrána:
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
Efsta stig lásskrárinnar segir til um hvaða útgáfu og hvaða útgáfugerð (edition) hún tilheyrir. Hver færsla undir images lýsir einni mynd:
| Reitur | Hvað það geymir |
|---|---|
svc |
Þjónustuna, svo sem nexus-auth eða nexus-postgres |
index |
sha256:-hakgildi yfirlits myndarinnar, sem nær yfir bæði linux/amd64 og linux/arm64 |
edition |
community, enterprise eða all fyrir gagnalagið |
kind |
service, migrations eða data-tier fyrir gagnageymslurnar fimm og OpenBao |
verified |
Hvenær útgáfusmíðin sannprófaði undirskrift hennar og staðfestingar (attestations) |
Kortið framkallar hverja mynd sem <global.imageRegistry>/nexus/<svc>@<index>. Þannig að með global.imageRegistry: registry.adverant.ai er innskráningarþjónustan registry.adverant.ai/nexus/nexus-auth@sha256: og þar á eftir 64 sextándakerfisstafir, og ekkert í klasanum getur skipt henni út fyrir eitthvað annað með sama nafni.
Lásskráin er bundin við útgáfugerð. Community-lásskrá telur aðeins upp myndir þar sem útgáfugerðin er community eða all. Enterprise-lásskrá telur þær upp ásamt Enterprise-smíðunum. Kortið athugar þetta í hvert skipti sem það er framkallað og hafnar keyrslu frekar en að giska:
| Hvað kortið segir | Ástæða |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Gildin tvö fyrir útgáfugerð í values-skránni þinni stangast á |
files/images.lock.json is the community lock; this install is edition enterprise |
Þú ert að setja upp Enterprise úr Community-kortinu, eða öfugt |
image nexus-auth is not in files/images.lock.json |
Kortið og lásskrá þess eiga ekki saman; sæktu kortið aftur |
image ... is in the lock but was never verified by build-all |
Færslan í lásskránni hefur engan sannprófunartíma; ekki setja upp úr henni |
NEXUS_EDITION_INVALID |
edition er tómt eða ekki annað hvort community eða enterprise |
RELEASE_VERSION_MISSING |
Lásskráin tilgreinir ekkert útgáfunúmer |
Birtu lista yfir allar myndir og hakgildi í einu lagi:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.jsonSkref 5: sannreyndu undirskrift hverrar gámaímyndar
Sérhvert myndaYfirlit (image index) er undirritað og það sama gildir um hverja umhverfislýsingu (platform manifest) inni í því. Sannprófaðu eftir hakgildi, beint úr lásskránni, svo þú athugir nákvæmlega það sem kortið mun keyra:
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"
doneHver lína ætti að byrja á OK. Á tengingunni okkar tók lykkjan nokkrar mínútur og mestur tíminn fór í að bíða eftir myndaskránni. Hún les aðeins undirskriftirnar og sækir engin myndalög, sem gerir það fljótlegt að endurtaka þetta eftir hverja uppfærslu. Lína með FAILED þýðir að þú skalt stöðva: næsti kafli útskýrir hvað hver skilaboð þýða.
Fyrir eina staka mynd geturðu sleppt tilvísuninni (redirect) og lesið hvað cosign athugaði:
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> eru 64 sextándakerfisstafirnir úr index lásskrárinnar fyrir þá mynd. Enterprise-myndir þurfa sóknartókanið þitt fyrir þessa athugun, rétt eins og fyrir allar aðrar sóknir úr myndaskránni.
Bæði umhverfin og hverju skal halda til haga
Sérhvert myndayfirlit geymir tvær umhverfislýsingar, linux/amd64 og linux/arm64, og hvor um sig er einnig undirrituð. cosign verify gengur upp á hakgildi yfirlitsins og á hakgildi hvors umhverfis fyrir sig, þannig að klasi með blönduðum hnútum er tryggður með sömu athugun. Til að sjá umhverfin tvö á bak við yfirlit skaltu biðja myndaskrána um hráa yfirlitið:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawmanifests-listinn í því nefnir eina amd64-færslu og eina arm64-færslu.
Geymdu úttakið úr lykkjunni hér að ofan í breytingaskránni þinni, við hliðina á fingrafarinu sem þú fórst yfir. Þegar einhver spyr, mánuðum síðar, hvernig þú vitir að klasinn keyri það sem Adverant sendi frá sér, svara þessi skrá og hakgildi lásskrárinnar því. Endurskoðandinn okkar hjá Harrow spurði nákvæmlega þeirrar spurningar og svarið tók eina mínútu.
Skref 6: lestu vottanirnar
Hverri mynd fylgja einnig tvær undirritaðar staðfestingar (attestations), búnar til úr myndinni við smíði: efnisskrá hugbúnaðar (SBOM) og upprunayfirlýsing (provenance statement).
Efnisskráin (SBOM) er á SPDX-formi (Software Package Data Exchange), ein fyrir hvert umhverfi, þannig að yfirlit geymir tvær. Hún telur upp hvern pakka í myndinni ásamt leyfi hans. Fyrir útgáfu eru þessi leyfi borin saman við bannlista; engin Community-mynd inniheldur kóða undir GNU Affero General Public License (AGPL), Server Side Public License (SSPL), Redis Source Available License (RSAL) eða Business Source License (BUSL). Upprunayfirlýsingin er samkvæmt Supply-chain Levels for Software Artifacts (SLSA) v1. Hún tilgreinir frumkóðafærsluna (source commit) sem myndin var smíðuð úr, hakgildi grunnmyndanna og smíðatólin og útgáfur þeirra, þannig að hægt er að rekja mynd aftur til yfirfarins frumkóða án þess að spyrja Adverant.
Báðar eru sannprófaðar gagnvart útgáfulyklinum sem þú ert þegar með:
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-athugunin prentar tvær niðurstöður, eina fyrir SBOM hvors umhverfis. Til að sjá allt sem er tengt við mynd án þess að sannprófa það skaltu nota cosign tree:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Það telur upp einn undirskriftarpakka, tvær spdx.dev/Document-staðfestingar og eina slsa.dev/provenance/v1-staðfestingu. Ef beðið er um tegund sem fylgir ekki myndinni, svo sem --type cyclonedx, mistekst það með none of the attestations matched the predicate type: cyclonedx. Sú villumelding er eðlileg; útgáfan hengir við SPDX, ekki CycloneDX.
Skref 7: sannreyndu kortið og niðurhölin
Kortið í myndaskránni er undirritað á OCI-hakgildi sínu (OCI stendur fyrir Open Container Initiative, sniðið sem myndaskrár nota fyrir myndir og smíðaeiningar). helm pull prentar hakgildið sem það sótti; athugaðu það hakgildi á sama hátt og mynd:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Fyrir kortaskrá sem þú sóttir, eða fyrir ótengda pakkann, athugar nexusctl verify skrána gagnvart útgáfulykli Adverant:
nexusctl verify nexus-1.0.0-alpha.1.tgzGóð niðurstaða endar á því að nefna útgáfulykil Adverant og upphaf fingrafars hans. Berðu þá stafahópa saman við fingrafarið sem þú athugaðir í skrefi 1.
Ótengdi pakkinn er ein óþjöppuð tar-skrá fyrir hverja útgáfugerð, nexus-alpha-1.0.0-alpha.1-community.tar eða nexus-alpha-1.0.0-alpha.1-enterprise.tar, með .sha256-skrá við hliðina. Inni í honum er að finna:
| Slóð | Hvað það er |
|---|---|
release/images.lock.json |
Myndalásskrána fyrir þá útgáfugerð |
release/facts.json |
Upplýsingar um útgáfuna: útgáfunúmer, útgáfugerð, örgjörvaarkitektúr og fingrafar útgáfulykilsins |
images/<service>/ |
Hverja mynd með báðum umhverfum, undirskrift hennar og staðfestingum |
charts/nexus-1.0.0-alpha.1.tgz |
Helm-kortið |
sbom/ |
SPDX-efnisskrána (SBOM) fyrir hverja mynd, eftir umhverfi |
docs/ |
Útgáfulýsinguna, leiðbeiningar um ótengda uppsetningu og dæmi um stillingagildi |
SHA256SUMS og SHA256SUMS.sigstore.json |
Prófsummu hverrar skrár og undirskrift hennar |
Opinberi útgáfulykillinn er aldrei inni í pakkanum; lykill sem fylgir hlutnum sem hann undirritar sannar ekkert. Athugaðu allan pakkann með tveimur skipunum, innan úr möppu hans:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSHver lína úr þeirri fyrri ætti að enda á OK og sú síðari ætti að prenta Verified OK. Kafli 2.10, Ótengd uppsetning, tekur svo við pakkanum þaðan: hleður myndunum inn í þína eigin myndaskrá, sannprófar hverja og eina aftur þar og keyrir heildarathugun pakkans sjálfs.
Þegar undirskrift stenst ekki sannprófun
Stöðvaðu. Ekki setja upp og ekki breyta skipuninni þar til hún gengur í gegn. Þegar undirskriftarathugun mistekst er kerfið að virka eins og það á að gera: það þýðir að skráin sem þú ert með er ekki skráin sem Adverant undirritaði, eða að lykillinn sem þú ert með er ekki frá Adverant.
| Hvað þér sjáið | Hvað það þýðir | Hvað skal gera |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (exit 1) |
Myndin er undirrituð, en ekki með lyklinum sem þú gafst upp | Gakktu úr skugga um að þú hafir notað útgáfulykilinn sem þú athugaðir fingrafarið á í skrefi 1 |
no signatures found (exit 10) |
Ekkert á þessu hakgildi er undirritað | Gakktu úr skugga um að hakgildið hafi komið úr lásskránni; sannprófaðu aldrei merki (tag) |
not enough verified log entries from transparency log: 0 < 1 |
--insecure-ignore-tlog=true vantar |
Bættu flagginu við; það er ekkert að myndinni |
none of the attestations matched the predicate type |
Þú baðst um tegund staðfestingar sem fylgir ekki myndinni | Notaðu spdxjson eða slsaprovenance1 |
Error: invalid signature when validating ASN.1 encoded signature |
Skrá sem var sótt breyttist eftir að hún var undirrituð | Sæktu hana aftur |
FAILED frá sha256sum -c |
Skrá er ekki sú skrá sem prófsumman var reiknuð fyrir | Sæktu hana aftur |
Ef niðurhal mistekst tvisvar skaltu opna stuðningsbeiðni af reikningnum þínum og tilgreina skráarnafnið og skilaboðin. Geymdu skrána sem mistókst; öryggisteymið þitt gæti viljað fá hana.
Í uppsetningu sem hleður útgáfum af diski keyrir stjórnborðið sömu athuganir og hafnar útgáfu ef undirskrift hennar passar ekki við uppsetta lykilinn, með MEDIA_SIGNATURE_INVALID. Það segir hvað það athugaði, í hvaða röð, hvar það stöðvaðist og að engu hafi verið breytt: engri mynd hlaðið inn og útgáfan sem er í keyrslu ósnert.
Þegar lykillinn, myndirnar og kortið hafa öll staðist athugun er næsta skref forathugun á klasanum þínum í kafla 2.5, Forathugun með nexusctl.



