Versio 1.0.0-alpha.1uusin
Luku 2.4
Julkaisun noutaminen ja varmentaminen
Missä kukin Nexus-julkaisun osa sijaitsee, miten Enterprise-levykuvat noudetaan noutotunnisteella (pull token) ja miten todistetaan offline-tilassa ennen minkään asentamista, että jokainen levykuva, kaavio ja lataus on tullut Adverantilta muuttumattomana.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Jokainen Nexus-julkaisun levykuva on allekirjoitettu Adverantin julkaisuavaimella, ja jokainen levykuva nimetään sen tiivisteen (digest) mukaan, ei koskaan tunnisteen (tag) mukaan. Chart renderöi vain ne levykuvat, jotka on lueteltu tiivisteen mukaan sen omassa levykuvalukossa (images lock). Yhdessä tämä tarkoittaa, että voit todistaa omalla työasemallasi ja ilman yhteyttä mihinkään, että se, mitä olet suorittamassa, on täsmälleen sitä, mitä Adverant rakensi.
Harrow Port Authorityssa tarkistimme kaiken ennen ensimmäistä asennusta. Se kesti noin kaksikymmentä minuuttia, ja suurin osa ajasta kului levykuvien läpikäyntiin silmukassa. Tässä luvussa kuljetaan sama polku: missä julkaisun kukin osa sijaitsee, Enterprise-levykuvien latausvaltuus (pull token), levykuvalukko, cosign-tarkistukset tarkkoine komentoineen sekä mitä tehdä, kun tarkistus epäonnistuu.
Missä julkaisu sijaitsee
| Osoite | Mitä sieltä noudetaan |
|---|---|
registry.adverant.ai |
Alustan levykuvat osoitteessa registry.adverant.ai/nexus/<service>@sha256:<digest> ja Helm-chart osoitteessa oci://registry.adverant.ai/nexus/charts/nexus |
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ |
Julkaisun julkinen avain ja sen sormenjälki, nexusctl-binäärit sekä offline-paketit |
https://account.adverant.ai |
Adverant-tilisi: Lataukset, Latausvaltuudet ja asennuskomennot, Käyttöönotot sekä lisenssisivut |
Community-levykuvat ja Community-chart ovat julkisia; voit ladata ne kirjautumatta sisään. Enterprise-levykuvat ladataan tilisi latausvaltuudella, ja Enterprise-chart sekä -paketti ovat tilin Lataukset-sivulla, joka noudattaa lisenssiäsi.
Lukekaa julkaisutiedot ennen mitään muuta
Julkaisutiedot toimitetaan jokaisen paketin sisällä tiedostona docs/RELEASE-NOTES.md, joka on lueteltu sen SHA256SUMS-tiedostossa, ja samat tiedot ovat tilisi julkaisusivulla. Lue ne ennen asennusta tai päivitystä. Versiolle 1.0.0-alpha.1 ne ovat lyhyet. Kyseessä on ensimmäinen julkaisu, joten uuteen asennukseen ei liity mitään niissä kuvatuista päivityskohdista, ja tunnettujen ongelmien luettelossa todetaan, että mikään siinä ei vaikuta uuteen asennukseen, joka noudattaa dokumentoituja vaiheita. Myöhemmissä julkaisuissa luetellaan jokainen tunnettu ongelma sekä versio, joka korjaa sen.
Julkaisusivulla kerrotaan myös kolmella rivillä, mitä alfa-julkaisu lupaa: ominaisuudet voivat muuttua ennen ensimmäistä vakaata versiota, päivitys säilyttää tietosi ja ottaa ensin varmuuskopion, ja tietoturvakorjaukset saapuvat 7 päivän kuluessa. Tulostimme kyseisen sivun ja laitoimme sen muutostietoihin Harrow'ssa, koska se on lähimpänä tukilausuntoa, jota muutoslautakunta pyytäisi.
Vaihe 1: noutakaa julkaisuavain ja tarkistakaa se toista reittiä pitkin
Kaikki alla oleva perustuu yhteen tiedostoon: Adverantin julkaisun julkiseen avaimeen. Avain, joka on peräisin samasta paikasta kuin asia, jonka puolesta se todistaa, todistaa hyvin vähän, joten tarkista sen sormenjälki sellaista kopiota vasten, joka on saapunut sinulle jotakin muuta kautta.
Lataa avain julkaisun kansiosta Lataukset-sivulta.
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pubSelvitä sen sormenjälki. Sormenjälki on itse avaintiedoston SHA-256 (Secure Hash Algorithm 256).
sha256sum release.pubmacOS:ssä
shasum -a 256 release.pubantaa saman vastauksen.Vertaa sitä merkki merkiltä sormenjälkeen, joka on painettu Adverantin kanssa tekemääsi sopimukseen ja julkaisutietoihin. Myös Lataukset-sivu julkaisee sormenjäljen, mutta se kopio tuli samaa reittiä kuin avain, joten se ei kelpaa tarkistukseksi.
Jos yksikin merkki poikkeaa, lopeta. Älä asenna äläkä lähde etsimään toista kopiota avaimesta internetistä. Avaa tukipyyntö tililtäsi ja kerro tarkasti, mitä näit.
Vaihe 2: noutakaa nexusctl
nexusctl on Nexus-operaattorin komentorivikäyttöliittymä (CLI). Se toimii työasemallasi ja lukee klusteriasi kubeconfig-tiedostosi kautta. Lataukset-sivu tarjoaa neljä käännöstä:
| Tiedosto | Alusta |
|---|---|
nexusctl-linux-amd64 |
Linux Intel- tai AMD-suorittimella |
nexusctl-darwin-arm64 |
macOS Apple silicon -suorittimella |
nexusctl-darwin-amd64 |
macOS Intel-suorittimella |
nexusctl-windows-amd64.exe |
Windows |
Jokaisen tiedoston vieressä on sen allekirjoituspaketti, jolla on sama nimi ja lopussa .sigstore.json. Tarkista binääri ennen kuin suoritat sen:
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
Aseta se sitten hakupolullesi (PATH) ja kysy sen versio:
install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl versionTästä eteenpäin nexusctl verify voi tehdä tiedostotarkistukset puolestasi. Luku 2.5, Esitarkistus nexusctl-työkalulla, käsittelee sen päätehtävää, esitarkistusta (preflight).
Miksi valitsimessa lukee "insecure"
Jokainen tämän luvun cosign-komento sisältää valitsimen --insecure-ignore-tlog=true. Nexus-julkaisut allekirjoitetaan Adverantin avaimella eikä niitä kirjata mihinkään julkiseen läpinäkyvyyslokiin, jotta julkaisun tarkistaminen ei koskaan vaadi yhteyttä mihinkään, Sigstore mukaan lukien. Oletusarvoisesti cosign vaatii lokimerkinnän; valitsin käskee sitä luottamaan pelkkään avaimeen. Ilman sitä tarkistus epäonnistuu näin:
Error: not enough verified log entries from transparency log: 0 < 1
Kun valitsin on asetettu, cosign tulostaa silti lauseen "Existence of the claims in the transparency log was verified offline". Se on kiinteä sanamuoto työkalussa cosign; sen takana ei ole lokimerkintää. Allekirjoituksen tarkistus avainta vasten on todellinen, ja se on se osa, jolla on merkitystä.
Vaihe 3: noutotunniste Enterprise-versiota varten
Enterprise-levykuvat ovat latausvaltuuden (pull token) takana. Voit luoda sellaisen tililläsi kohdassa Latausvaltuudet ja asennuskomennot:
- Paina Add a token.
- Määritä, mille klusterille se on tarkoitettu, mitä se saa noutaa ja milloin se vanhenee.
- Paina Copy the token ja liitä se suoraan paikkaan, jossa säilytät tunnistetietoja, sillä sivu näyttää sen vain tämän yhden kerran.
Jokainen valtuus on rajoitettu siihen, mitä se saa noutaa, ja sillä on päättymispäivä. Valtuuden peruuttaminen pysäyttää uudet lataukset välittömästi; levykuvat, jotka klusteri on jo ladannut, jatkavat toimintaansa. Teimme Harrow'ssa yhden valtuuden klusteria kohden, joten testiklusterin valtuuden peruuttaminen ei koskaan vaikuta tuotantoon. Community-asennus ei tarvitse valtuutta lainkaan; luot sellaisen vasta siirtyessäsi Enterprise-versioon, ja voit luoda sen samana päivänä.
Chartissa ei ole pull-secret-arvoa. Solmusi (nodes) lataavat levykuvat, joten valtuus kuuluu solmujen konttien ajonaikaiselle ympäristölle (container runtime). Lisää k3s-ympäristössä rekisteri tiedostoon /etc/rancher/k3s/registries.yaml jokaisessa solmussa ja käynnistä k3s siellä uudelleen:
# /etc/rancher/k3s/registries.yaml (on every node)
configs:
"registry.adverant.ai":
auth: {username: "<registry-user>", password: "<pull-token>"}<registry-user> on Adverant-kutsussasi oleva rekisterin käyttäjänimi ja <pull-token> on kopioimasi valtuus. Tiedosto sisältää tunnistetiedon, joten pidä se vain root-käyttäjän luettavissa.
Hallinnoidussa klusterissa, jonka solmut eivät lue kyseistä tiedostoa, kopioi levykuvat rekisteriin, johon solmusi jo luottavat, ja aseta global.imageRegistry osoittamaan siihen; jokaisen solmun on luotettava kyseisen rekisterin TLS-varmenteeseen (Transport Layer Security). Luku 2.11, Muunnelmat: ulkoiset tietovarastot, TLS ja ingress, käsittelee tätä, ja luku 2.10, Ilmarakoasennus, käsittelee samaa kopiointia toimipaikalle, josta ei ole reittiä ulos.
Vaihe 4: lukekaa levykuvien lukitustiedosto
Nexus-chart ei koskaan nimeä levykuvaa tunnisteen (tag) mukaan. Se nimeää jokaisen levykuvan sen monialustaisen indeksin tiivisteen (digest) mukaan, joka otetaan levykuvalukosta (images lock), eli tiedostosta, joka kulkee chartin mukana nimellä files/images.lock.json. Offline-paketti sisältää saman lukon nimellä release/images.lock.json.
Lataa chart ja pura se lukeaksesi lukon:
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
Lukon ylätaso kertoo, mihin julkaisuun ja mihin laitokseen (edition) se kuuluu. Jokainen merkintä kohdan images alla kuvaa yhden levykuvan:
| Kenttä | Mitä se sisältää |
|---|---|
svc |
Palvelu, kuten nexus-auth tai nexus-postgres |
index |
Levykuvan indeksin sha256:-tiiviste, joka kattaa sekä linux/amd64- että linux/arm64-alustat |
edition |
community, enterprise tai all tietokerrokselle |
kind |
service, migrations tai data-tier viidelle tietovarastolle ja OpenBaolle |
verified |
Milloin julkaisukäännös vahvisti sen allekirjoituksen ja vakuutukset (attestations) |
Chart renderöi jokaisen levykuvan muodossa <global.imageRegistry>/nexus/<svc>@<index>. Joten kun käytössä on global.imageRegistry: registry.adverant.ai, sisäänkirjautumispalvelu on registry.adverant.ai/nexus/nexus-auth@sha256:, jota seuraa 64 heksadesimaalimerkkiä, eikä mikään klusterissa voi vaihtaa sitä johonkin muuhun samannimiseen.
Lukko on laitoskohtainen. Community-lukko luettelee vain levykuvat, joiden laitos on community tai all. Enterprise-lukko luettelee nämä sekä Enterprise-käännökset. Chart tarkistaa tämän joka kerta renderöidessään ja kieltäytyy arvaamisen sijaan:
| Mitä chart sanoo | Miksi |
|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Values-tiedostosi kaksi edition-arvoa ovat ristiriidassa |
files/images.lock.json is the community lock; this install is edition enterprise |
Olet asentamassa Enterprise-laitosta Community-chartista, tai päinvastoin |
image nexus-auth is not in files/images.lock.json |
Chart ja sen lukko eivät kuulu yhteen; nouda chart uudelleen |
image ... is in the lock but was never verified by build-all |
Lukon merkinnällä ei ole vahvistusaikaa; älä asenna siitä |
NEXUS_EDITION_INVALID |
edition on tyhjä tai ei ole jompikumpi arvoista community ja enterprise |
RELEASE_VERSION_MISSING |
Lukko ei nimeä versiota |
Listaa jokainen levykuva ja tiiviste yhdellä kertaa:
jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.jsonVaihe 5: varmentakaa jokaisen levykuvan allekirjoitus
Jokainen levykuvaindeksi on allekirjoitettu, samoin kuin jokainen sen sisällä oleva alustamanifesti. Vahvista tiivisteen perusteella suoraan lukosta, jotta tarkistat täsmälleen sen, mitä chart tulee suorittamaan:
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"
doneJokaisen rivin tulisi alkaa merkkijonolla OK. Meidän yhteydellämme silmukka kesti muutaman minuutin, josta suurin osa kului rekisterin odottamiseen. Se lukee vain allekirjoitukset eikä nouda levykuvakerroksia, minkä ansiosta se on kevyt toistaa jokaisen päivityksen jälkeen. FAILED-rivi tarkoittaa, että on pysähdyttävä: seuraavassa osiossa kerrotaan, mitä kukin viesti tarkoittaa.
Jos haluat tarkistaa yhden levykuvan erikseen, jätä uudelleenohjaus pois ja lue, mitä cosign tarkisti:
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 heksadesimaalimerkkiä kyseisen levykuvan lukon kohdasta index. Enterprise-levykuvat tarvitsevat latausvaltuutesi tähän tarkistukseen, aivan kuten mihin tahansa lataukseen rekisteristä.
Molemmat alustat ja mitä tulee säilyttää
Jokainen levykuvaindeksi sisältää kaksi alustamanifestia, linux/amd64 ja linux/arm64, ja kumpikin niistä on myös allekirjoitettu. cosign verify onnistuu indeksin tiivisteellä ja kummalla tahansa alustatiivisteellä, joten sekasolmuista koostuva klusteri tulee katetuksi samalla tarkistuksella. Jos haluat nähdä indeksin takana olevat kaksi alustaa, pyydä rekisteristä raakaindeksi:
docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --rawSen manifests-luettelo nimeää yhden amd64-merkinnän ja yhden arm64-merkinnän.
Säilytä yllä olevan silmukan tuloste muutostiedoissasi tarkistamasi sormenjäljen vieressä. Kun joku kuukausia myöhemmin kysyy, mistä tiedät klusterin suorittavan sitä, mitä Adverant toimitti, kyseinen tiedosto ja lukon tiivisteet vastaavat siihen. Tilintarkastajamme Harrow'ssa esitti täsmälleen tuon kysymyksen, ja vastaukseen meni minuutti.
Vaihe 6: lukekaa varmennukset (attestations)
Jokainen levykuva sisältää myös kaksi allekirjoitettua vakuutusta (attestations), jotka on luotu levykuvasta käännösaikana: ohjelmistokomponenttien luettelon (SBOM, software bill of materials) ja alkuperälausunnon (provenance statement).
SBOM on SPDX-muodossa (Software Package Data Exchange), yksi alustaa kohden, joten indeksissä niitä on kaksi. Se luettelee jokaisen levykuvassa olevan paketin ja sen lisenssin. Ennen julkaisua nämä lisenssit tarkistetaan estolistalta; yksikään Community-levykuva ei sisällä GNU Affero General Public License (AGPL)-, Server Side Public License (SSPL)-, Redis Source Available License (RSAL)- tai Business Source License (BUSL) -koodia. Alkuperälausunto on SLSA v1 -muotoinen (Supply-chain Levels for Software Artifacts). Se nimeää lähdekoodin commitin, josta levykuva on käännetty, pohjalevykuvien tiivisteet sekä käännöstyökalut ja niiden versiot, joten levykuva voidaan jäljittää tarkistettuun lähdekoodiin kysymättä Adverantilta.
Molemmat tarkistetaan sinulla jo olevaa julkaisuavainta vasten:
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-tarkistus tulostaa kaksi tulosta, yhden kummankin alustan SBOM:lle. Jos haluat nähdä kaiken levykuvaan liitetyn vahvistamatta sitä, käytä komentoa cosign tree:
cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>Se luettelee yhden allekirjoituspaketin, kaksi spdx.dev/Document-vakuutusta ja yhden slsa.dev/provenance/v1-vakuutuksen. Sellaisen tyypin pyytäminen, jota levykuva ei sisällä, kuten --type cyclonedx, epäonnistuu virheellä none of the attestations matched the predicate type: cyclonedx. Tämä epäonnistuminen kuuluu asiaan; julkaisu liittää mukaan SPDX:n, ei CycloneDX:ää.
Vaihe 7: varmentakaa kaavio ja lataukset
Rekisterissä oleva chart on allekirjoitettu sen OCI-tiivisteellä (OCI on Open Container Initiative, rekisterien käyttämä levykuva- ja artefaktimuoto). helm pull tulostaa lataamansa tiivisteen; tarkista kyseinen tiiviste samalla tavalla kuin levykuva:
cosign verify --key release.pub --insecure-ignore-tlog=true \
registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>Lataamasi chart-tiedoston tai offline-paketin tapauksessa nexusctl verify tarkistaa tiedoston Adverantin julkaisuavainta vasten:
nexusctl verify nexus-1.0.0-alpha.1.tgzHyvä tulos päättyy nimeämällä Adverantin julkaisuavaimen ja sen sormenjäljen alun. Vertaa näitä ryhmiä sormenjälkeen, jonka tarkistit vaiheessa 1.
Offline-paketti on yksi pakkaamaton tar-tiedosto laitosta kohden, nexus-alpha-1.0.0-alpha.1-community.tar tai nexus-alpha-1.0.0-alpha.1-enterprise.tar, ja sen vieressä on .sha256-tiedosto. Sisällään se pitää:
| Polku | Mikä se on |
|---|---|
release/images.lock.json |
Kyseisen laitoksen levykuvalukko |
release/facts.json |
Julkaisun tiedot: versio, laitos, arkkitehtuurit ja julkaisuavaimen sormenjälki |
images/<service>/ |
Jokainen levykuva molemmilla alustoilla, sen allekirjoitus ja sen vakuutukset |
charts/nexus-1.0.0-alpha.1.tgz |
Chart |
sbom/ |
Jokaisen levykuvan SPDX SBOM, alustakohtaisesti |
docs/ |
Julkaisutiedot, ilmarakoasennusopas ja esimerkkiarvot |
SHA256SUMS ja SHA256SUMS.sigstore.json |
Jokaisen tiedoston tarkistussumma ja sen allekirjoitus |
Julkaisun julkinen avain ei ole koskaan paketin sisällä; avain, joka toimitetaan sen asian mukana, jonka se allekirjoittaa, ei todista mitään. Tarkista koko paketti kahdella komennolla sen kansion sisältä:
sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSEnsimmäisen komennon jokaisen rivin tulisi päättyä OK, ja toisen tulisi tulostaa Verified OK. Luku 2.10, Ilmarakoasennus, jatkaa paketin käsittelyä tästä: levykuvien lataaminen omaan rekisteriisi, jokaisen vahvistaminen siellä uudelleen sekä paketin oma päästä päähän -tarkistus.
Kun allekirjoitus ei varmennu
Lopeta. Älä asenna äläkä muuta komentoa, jotta se menisi läpi. Epäonnistunut allekirjoitustarkistus tarkoittaa, että järjestelmä toimii: se merkitsee, että sinulla oleva tiedosto ei ole se tiedosto, jonka Adverant allekirjoitti, tai että hallussasi oleva avain ei ole Adverantin.
| Mitä näette | Mitä se tarkoittaa | Mitä tehdä |
|---|---|---|
accepted signatures do not match threshold, Found: 0, Expected 1 (exit 1) |
Levykuva on allekirjoitettu, mutta ei antamallasi avaimella | Tarkista, että käytit julkaisuavainta, jonka sormenjäljen tarkistit vaiheessa 1 |
no signatures found (exit 10) |
Mitään kyseisessä tiivisteessä ei ole allekirjoitettu | Tarkista, että tiiviste on peräisin lukosta; älä koskaan vahvista tunnistetta (tag) |
not enough verified log entries from transparency log: 0 < 1 |
--insecure-ignore-tlog=true puuttuu |
Lisää valitsin; levykuvassa ei ole mitään vikaa |
none of the attestations matched the predicate type |
Pyysit vakuutustyyppiä, jota levykuva ei sisällä | Käytä arvoa spdxjson tai slsaprovenance1 |
Error: invalid signature when validating ASN.1 encoded signature |
Ladattua tiedostoa on muutettu sen allekirjoittamisen jälkeen | Lataa se uudelleen |
FAILED komennosta sha256sum -c |
Tiedosto ei ole se tiedosto, josta tarkistussumma laskettiin | Lataa se uudelleen |
Jos lataus epäonnistuu kahdesti, avaa tukipyyntö tililtäsi ja mainitse tiedoston nimi ja virheviesti. Säilytä epäonnistunut tiedosto; tietoturvatiimisi saattaa haluta sen.
Asennuksessa, joka lataa julkaisut levyltä, konsoli suorittaa samat tarkistukset ja hylkää julkaisun, jonka allekirjoitus ei täsmää asennetun avaimen kanssa, virheellä MEDIA_SIGNATURE_INVALID. Se kertoo, mitä se tarkisti, missä järjestyksessä, mihin se pysähtyi ja että mitään ei muutettu: yhtäkään levykuvaa ei ladattu, ja käynnissä oleva versio säilyi koskemattomana.
Kun avain, levykuvat ja chart ovat kaikki läpäisseet tarkistuksen, seuraava vaihe on klusterin esitarkistus (preflight) luvussa 2.5, Esitarkistus nexusctl-työkalulla.



