Versioon 1.0.0-alpha.1uusim
Peatükk 2.4
Väljalaske hankimine ja kontrollimine
Kus Nexuse väljalaske iga osa asub, kuidas Enterprise'i tõmmised tõmbeloa abil alla laaditakse ning kuidas enne millegi installimist võrguühenduseta tõestada, et iga tõmmis, chart ja allalaadimine pärineb Adverantilt muutmata kujul.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Iga Nexuse väljalaske tõmmis on allkirjastatud Adveranti väljalaskevõtmega ning iga tõmmis on nimetatud selle räsiväärtuse (digest), mitte kunagi sildi (tag) järgi. Chart renderdab ainult tõmmiseid, mis on räsiväärtuse järgi loetletud selle enda tõmmiste lukustusfailis. Kokkuvõttes tähendab see, et saate omaenda tööjaamas ja ilma igasuguse välise ühenduseta tõestada, et see, mida kavatsete käivitada, on täpselt see, mille Adverant ehitas.
Harrow Port Authoritys kontrollisime enne esimest paigaldust kõike. See võttis umbes kakskümmend minutit ja enamik sellest kulus tõmmiste tsüklilisele kontrollimisele. See peatükk käib läbi sama teekonna: kus asub väljalaske iga osa, tõmbeluba (pull token) Enterprise'i tõmmiste jaoks, tõmmiste lukustusfail, cosign kontrollid koos täpsete käskudega ja mida teha, kui kontroll ebaõnnestub.
Kus väljalase asub
| Aadress | Mida te sealt hangite |
|---|---|
registry.adverant.ai |
Platvormi tõmmised aadressil registry.adverant.ai/nexus/<service>@sha256:<digest> ja Helmi chart aadressil oci://registry.adverant.ai/nexus/charts/nexus |
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ |
Väljalaske avalik võti ja selle sõrmejälg, nexusctl binaarfailid ning võrguühenduseta paketid |
https://account.adverant.ai |
Teie Adveranti konto: Allalaadimised, Tõmbeload ja paigalduskäsud, Juurutused ning litsentsilehed |
Community tõmmised ja Community chart on avalikud; saate need alla tõmmata ilma sisse logimata. Enterprise'i tõmmised tõmmatakse teie kontolt saadud tõmbeloaga ning Enterprise'i chart ja pakett asuvad konto lehel Allalaadimised, mis järgib teie litsentsi.
Lugege väljalaskemärkmeid enne kõike muud
Väljalaskemärkmed on iga paketiga kaasas failina docs/RELEASE-NOTES.md, mis on loetletud selle failis SHA256SUMS, ning samad märkmed on väljalaskelehel teie kontol. Lugege need läbi enne paigaldamist või uuendamist. Versiooni 1.0.0-alpha.1 puhul on need lühikesed. See on esimene väljalase, seega puuduvad puhtal paigaldusel seal kirjeldatud uuenduspunktid, ning teadaolevate probleemide loend ütleb, et miski selles ei mõjuta puhast paigaldust, mis järgib dokumenteeritud samme. Hilisemad väljalasked loetlevad iga teadaoleva probleemi koos versiooniga, mis selle parandab.
Väljalaskeleht ütleb samuti kolme reaga, mida alfaväljalase lubab: funktsioonid võivad enne esimest stabiilset versiooni muutuda, uuendamine säilitab teie andmed ja teeb esmalt varukoopia ning turvaparandused saabuvad 7 päeva jooksul. Printisime selle lehe välja ja panime Harrow's muudatuste registrisse, sest see on kõige lähedasem asi tugiavaldusele, mida muudatuste komisjon küsiks.
1. samm: hankige väljalaskevõti ja kontrollige seda teise kanali kaudu
Kõik alljärgnev toetub ühele failile: Adveranti väljalaske avalikule võtmele. Võti, mis pärineb samast kohast kui asi, mille eest see vastutab, tõestab väga vähe, seega kontrollige selle sõrmejälge koopia vastu, mis jõudis teieni mõnel muul viisil.
Laadige võti alla väljalaske kaustast lehel Allalaadimised.
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pubLeidke selle sõrmejälg. Sõrmejälg on võtmefaili enda SHA-256 (Secure Hash Algorithm 256).
sha256sum release.pubmacOS-is annab
shasum -a 256 release.pubsama vastuse.Võrrelge seda märk-märgilt sõrmejäljega, mis on trükitud teie Adverantiga sõlmitud lepingusse ja väljalaskemärkmetesse. Allalaadimiste leht avaldab samuti sõrmejälje, kuid see koopia tuli sama teed pidi nagu võtigi, seega ei sobi see kontrolliks.
Kui mõni märk erineb, peatuge. Ärge paigaldage ja ärge minge internetist teist võtmekoopiat otsima. Avage oma kontolt tugipäring ja tsiteerige seda, mida nägite.
2. samm: hankige nexusctl
nexusctl on Nexuse operaatori käsurealiides (CLI). See töötab teie tööjaamas ja loeb teie klastrit läbi teie kubeconfig-i. Allalaadimiste leht pakub nelja kompileeritud versiooni:
| Fail | Platvorm |
|---|---|
nexusctl-linux-amd64 |
Linux Intelil või AMD-l |
nexusctl-darwin-arm64 |
macOS Apple'i kiibil |
nexusctl-darwin-amd64 |
macOS Intelil |
nexusctl-windows-amd64.exe |
Windows |
Iga faili kõrval on selle allkirjapakett, sama nimega, kuid .sigstore.json lõpus. Kontrollige binaarfaili enne selle käivitamist:
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
Seejärel lisage see oma otsinguteele (PATH) ja küsige selle versiooni:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionSiit edasi saab nexusctl verify failikontrolle teie eest teha. Peatükk 2.5, Eellend (preflight) tööriistaga nexusctl, käsitleb selle põhitööd, eellendu.
Miks lipp ütleb "insecure"
Iga cosign käsk selles peatükis sisaldab lippu --insecure-ignore-tlog=true. Nexuse väljalasked on allkirjastatud Adveranti võtmega ja neid ei salvestata ühtegi avalikku läbipaistvuslogisse, et väljalaske kontrollimine ei vajaks kunagi ühendust kellegagi, sealhulgas Sigstore'iga. Vaikimisi nõuab cosign logikirjet; lipp ütleb sellele, et toetuda tuleb ainult võtmele. Ilma selleta ebaõnnestub kontroll järgmiselt:
Error: not enough verified log entries from transparency log: 0 < 1
Kui lipp on seatud, prindib cosign ikkagi lause "Existence of the claims in the transparency log was verified offline". See on fikseeritud sõnastus tööriistas cosign; selle taga ei ole ühtegi logikirjet. Allkirja kontroll võtme vastu on reaalne ja see on osa, mis loeb.
3. samm: tõmbeluba Enterprise'i jaoks
Enterprise'i tõmmised asuvad tõmbeloa taga. Te loote selle oma kontol, lehel Tõmbeload ja paigalduskäsud:
- Vajutage Lisa luba.
- Määrake, millise klastri jaoks see on, mida see võib hankida ja millal see aegub.
- Vajutage Kopeeri luba ja kleepige see otse sinna, kus hoiate mandaate, sest leht näitab seda ainult sel ühel korral.
Iga luba on piiratud sellega, mida see võib hankida, ja sellel on lõppkuupäev. Loa tühistamine peatab uued tõmbamised koheselt; tõmmised, mille klaster on juba alla tõmmanud, töötavad edasi. Tegime Harrow's ühe loa klastri kohta, nii et testklastri loa tühistamine ei puuduta kunagi toodangut. Community paigaldus ei vaja üldse luba; te loote selle alles siis, kui liigute üle Enterprise'ile, ja võite selle luua samal päeval.
Chartil puudub pull-secret väärtus. Teie sõlmed (nodes) tõmbavad tõmmiseid, seega kuulub luba sõlmede konteinerite käituskeskkonnale (container runtime). k3s-is lisage register igas sõlmes faili /etc/rancher/k3s/registries.yaml ja taaskäivitage seal k3s:
# /etc/rancher/k3s/registries.yaml (on every node)
configs:
"registry.adverant.ai":
auth: {username: "<registry-user>", password: "<pull-token>"}<registry-user> on registri kasutajanimi teie Adveranti kutses ja <pull-token> on luba, mille kopeerisite. Fail sisaldab mandaati, seega hoidke see loetavana ainult juurkasutajale (root).
Hallatud klastris, mille sõlmed seda faili ei loe, kopeerige tõmmised registrisse, mida teie sõlmed juba usaldavad, ja seadke global.imageRegistry sellele; iga sõlm peab usaldama selle registri transpordikihi turbeprotokolli (TLS) sertifikaati. Peatükk 2.11, Variatsioonid: välised andmehoidlad, TLS ja ingress, käsitleb seda, ning peatükk 2.10, Võrguühenduseta (air-gapped) paigaldus, käsitleb sama kopeerimist asukoha jaoks, millel puudub väljuv ühendus.
4. samm: lugege tõmmiste lukustusfaili
Nexuse chart ei nimeta tõmmist kunagi sildi järgi. See nimetab igaüht selle mitmeplatvormilise indeksi räsiväärtuse järgi, mis on võetud tõmmiste lukustusfailist – failist, mida chart kannab kaasas nimega files/images.lock.json. Võrguühenduseta pakett kannab sama lukustusfaili nimega release/images.lock.json.
Tõmmake chart alla ja pakkige see lukustusfaili lugemiseks lahti:
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
Lukustusfaili ülemine tase ütleb, millisele väljalaskele ja millisele väljaandele (edition) see kuulub. Iga kirje images all kirjeldab ühte tõmmist:
| Väli | Mida see sisaldab |
|---|---|
svc |
Teenus, näiteks nexus-auth või nexus-postgres |
index |
Tõmmise indeksi sha256: räsiväärtus, mis katab nii linux/amd64 kui ka linux/arm64 |
edition |
community, enterprise või all andmekihi jaoks |
kind |
service, migrations või data-tier viie andmehoidla ja OpenBao jaoks |
verified |
Millal väljalaske ehitusprotsess (build) kontrollis selle allkirja ja kinnitusi (attestations) |
Chart renderdab iga tõmmise kujul <global.imageRegistry>/nexus/<svc>@<index>. Seega väärtusega global.imageRegistry: registry.adverant.ai on sisselogimisteenus registry.adverant.ai/nexus/nexus-auth@sha256:, millele järgneb 64 kuueteistkümnendsüsteemi märki, ja miski klastris ei saa seda vahetada millegi muu samanimelise vastu.
Lukustusfail on väljaandepõhine. Community lukustusfail loetleb ainult tõmmiseid, mille väljaanne on community või all. Enterprise'i lukustusfail loetleb need pluss Enterprise'i kompileeritud versioonid. Chart kontrollib seda iga kord, kui see renderdab, ja keeldub oletamise asemel:
| Mida chart ütleb | Miks |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Kaks väljaande väärtust teie values-failis on vastuolus |
files/images.lock.json is the community lock; this install is edition enterprise |
Paigaldate Enterprise'i Community chartist või vastupidi |
image nexus-auth is not in files/images.lock.json |
Chart ja selle lukustusfail ei kuulu kokku; hankige chart uuesti |
image ... is in the lock but was never verified by build-all |
Lukustusfaili kirjel puudub kontrollimise aeg; ärge sellest paigaldage |
NEXUS_EDITION_INVALID |
edition on tühi või ei ole üks väärtustest community ja enterprise |
RELEASE_VERSION_MISSING |
Lukustusfail ei nimeta ühtegi versiooni |
Loetlege kõik tõmmised ja räsiväärtused ühe korraga:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.json5. samm: kontrollige iga tõmmise allkirja
Iga tõmmise indeks on allkirjastatud ja samuti iga platvormi manifest selle sees. Kontrollige räsiväärtuse järgi otse lukustusfailist, et kontrolliksite täpselt seda, mida chart käivitab:
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"
doneIga rida peaks algama väärtusega OK. Meie ühendusega võttis tsükkel paar minutit, enamik sellest kulus registri järel ootamisele. See loeb ainult allkirju ega hangi ühtegi tõmmise kihti, mis teeb selle kordamise pärast iga uuendust soodsaks. Rida FAILED tähendab peatumist: järgmine jaotis ütleb, mida iga teade tähendab.
Ühe tõmmise puhul eraldi jätke ümbersuunamine ära ja lugege, mida cosign kontrollis:
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> on 64 kuueteistkümnendsüsteemi märki lukustusfaili väljalt index selle tõmmise jaoks. Enterprise'i tõmmised vajavad selle kontrolli jaoks teie tõmbeluba, nagu iga registrist tõmbamise puhul.
Mõlemad platvormid ja mida alles hoida
Iga tõmmise indeks sisaldab kahte platvormi manifesti, linux/amd64 ja linux/arm64, ning kumbki neist on samuti allkirjastatud. cosign verify õnnestub indeksi räsiväärtuse ja mõlema platvormi räsiväärtuse puhul, nii et segasõlmedega klaster on kaetud sama kontrolliga. Et näha kahte platvormi indeksi taga, küsige registrilt töötlemata indeksit:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawSelle manifests loend nimetab ühe amd64 kirje ja ühe arm64 kirje.
Hoidke ülaltoodud tsükli väljundit oma muudatuste registris, kontrollitud sõrmejälje kõrval. Kui keegi küsib kuid hiljem, kuidas te teate, et klaster käitab seda, mille Adverant tarnis, vastavad sellele see fail ja lukustusfaili räsiväärtused. Meie audiitor Harrow's küsis täpselt selle küsimuse ja vastamine võttis minuti.
6. samm: lugege atesteeringuid
Iga tõmmis kannab ka kahte allkirjastatud kinnitust (attestation), mis on loodud tõmmisest ehitamise ajal: tarkvara koostisosade loend (SBOM) ja päritoluavaldus (provenance statement).
SBOM on Software Package Data Exchange (SPDX) vormingus, üks platvormi kohta, seega kannab indeks kahte. See loetleb iga tõmmises oleva paketi koos selle litsentsiga. Enne väljalaset kontrollitakse neid litsentse keeluloendi vastu; ükski Community tõmmis ei sisalda GNU Affero General Public License (AGPL), Server Side Public License (SSPL), Redis Source Available License (RSAL) ega Business Source License (BUSL) koodi. Päritoluavaldus on Supply-chain Levels for Software Artifacts (SLSA) v1. See nimetab lähtekoodi commiti, millest tõmmis ehitati, baastõmmiste räsiväärtused ning ehitustööriistad ja nende versioonid, nii et tõmmis on jälgitav tagasi ülevaadatud lähtekoodini ilma Adverantilt küsimata.
Mõlemat kontrollitakse väljalaskevõtme vastu, mis teil juba on:
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 kontroll prindib kaks tulemust, ühe iga platvormi SBOM-i kohta. Et näha kõike, mis on tõmmisele lisatud, ilma seda kontrollimata, kasutage käsku cosign tree:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>See loetleb ühe allkirjapaketi, kaks spdx.dev/Document kinnitust ja ühe slsa.dev/provenance/v1 kinnituse. Sellise tüübi küsimine, mida tõmmis ei kanna, näiteks --type cyclonedx, ebaõnnestub veaga none of the attestations matched the predicate type: cyclonedx. See ebaõnnestumine on õige; väljalase lisab SPDX-i, mitte CycloneDX-i.
7. samm: kontrollige charti ja allalaadimisi
Registris olev chart on allkirjastatud selle OCI räsiväärtusel (OCI on Open Container Initiative, tõmmiste ja artefaktide vorming, mida registrid kasutavad). helm pull prindib räsiväärtuse, mille see tõmbas; kontrollige seda räsiväärtust samamoodi nagu tõmmist:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Allalaaditud chart-faili või võrguühenduseta paketi puhul kontrollib nexusctl verify faili Adveranti väljalaskevõtme vastu:
nexusctl verify nexus-1.0.0-alpha.1.tgzHea tulemus lõpeb Adveranti väljalaskevõtme ja selle sõrmejälje alguse nimetamisega. Võrrelge neid rühmi sõrmejäljega, mida kontrollisite 1. sammus.
Võrguühenduseta pakett on üks tihendamata tar-fail väljaande kohta, nexus-alpha-1.0.0-alpha.1-community.tar või nexus-alpha-1.0.0-alpha.1-enterprise.tar, mille kõrval on .sha256 fail. Selle sees on:
| Asukoht | Mis see on |
|---|---|
release/images.lock.json |
Tõmmiste lukustusfail selle väljaande jaoks |
release/facts.json |
Väljalaske faktid: versioon, väljaanne, arhitektuurid ja väljalaskevõtme sõrmejälg |
images/<service>/ |
Iga tõmmis mõlema platvormiga, selle allkiri ja selle kinnitused |
charts/nexus-1.0.0-alpha.1.tgz |
Chart |
sbom/ |
Iga tõmmise SPDX SBOM, platvormi kohta |
docs/ |
Väljalaskemärkmed, võrguühenduseta paigalduse juhend ja näidisväärtused |
SHA256SUMS ja SHA256SUMS.sigstore.json |
Iga faili kontrollsumma ja selle allkiri |
Väljalaske avalik võti ei ole kunagi paketi sees; võti, mis tarnitakse koos asjaga, mille see allkirjastab, ei tõesta midagi. Kontrollige kogu paketti kahe käsuga selle kausta seest:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSEsimese käsu iga rida peaks lõppema väärtusega OK ja teine peaks printima Verified OK. Peatükk 2.10, Võrguühenduseta paigaldus, võtab paketi sealt edasi: tõmmiste laadimine teie enda registrisse, igaühe uuesti kontrollimine seal ja paketi enda täielik (end-to-end) kontroll.
Kui allkiri ei valideeru
Peatuge. Ärge paigaldage ja ärge muutke käsku, kuni see läbi läheb. Ebaõnnestunud allkirjakontroll tähendab, et süsteem töötab: see tähendab, et fail, mis teil on, ei ole fail, mille Adverant allkirjastas, või võti, mida hoiate, ei ole Adveranti oma.
| Mida te näete | Mida see tähendab | Mida teha |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (exit 1) |
Tõmmis on allkirjastatud, kuid mitte teie antud võtmega | Kontrollige, kas kasutasite väljalaskevõtit, mille sõrmejälge kontrollisite 1. sammus |
no signatures found (exit 10) |
Sellel räsiväärtusel pole midagi allkirjastatud | Kontrollige, kas räsiväärtus pärineb lukustusfailist; ärge kunagi kontrollige silti |
not enough verified log entries from transparency log: 0 < 1 |
--insecure-ignore-tlog=true on puudu |
Lisage lipp; tõmmisel pole midagi viga |
none of the attestations matched the predicate type |
Küsisite kinnituse tüüpi, mida tõmmis ei kanna | Kasutage väärtust spdxjson või slsaprovenance1 |
Error: invalid signature when validating ASN.1 encoded signature |
Allalaaditud faili muudeti pärast selle allkirjastamist | Laadige see uuesti alla |
FAILED käsust sha256sum -c |
Fail ei ole see fail, mille kontrollsumma arvutati | Laadige see uuesti alla |
Kui allalaadimine ebaõnnestub kaks korda, avage oma kontolt tugipäring ning tsiteerige faili nime ja teadet. Hoidke ebaõnnestunud fail alles; teie turvameeskond võib seda soovida.
Paigaldusel, mis laadib väljalaskeid kettalt, käivitab konsool samad kontrollid ja keeldub väljalaskest, mille allkiri ei vasta paigaldatud võtmele, veaga MEDIA_SIGNATURE_INVALID. See ütleb, mida see kontrollis, millises järjekorras, kus see peatus ja et midagi ei muudetud: ühtegi tõmmist ei laaditud, töötav versioon jäi puutumata.
Kui võti, tõmmised ja chart on kõik kontrolli läbinud, on järgmine samm eellend (preflight) teie klastri vastu peatükis 2.5, Eellend tööriistaga nexusctl.



