Versija 1.0.0-alpha.1naujausia
2.10 skyrius
Diegimas izoliuotoje aplinkoje
Nuneškite pasirašytą neprisijungus naudojamą paketą į vietą be interneto, patikrinkite jį su atskirai atsineštu raktu, įkelkite į savo registrą ir įdiekite. Licencijos, atnaujinimai ir atšauktų licencijų sąrašai šią atskirtį taip pat kerta rankiniu būdu.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Harrow Port Authority operacijų tinklas pagal įstatymus ir pagal savo struktūrą neturi jokio maršruto į internetą. Jame veikia laivų eismas, krantinių planai ir muitinės sulaikymai, ir jokia jame esanti sistema negali kreiptis į išorę. Kai Tomás Reilly ten diegė Nexus, kiekvienas baitas atkeliavo diske, kurį kurjeris pristatė į apsaugos postą, ir kiekvienas baitas buvo patikrintas objekto viduje dar prieš kam nors jį panaudojant.
Šis skyrius yra apie tą diegimą. Jūs gaunate pasirašytą neprisijungusio režimo paketą, patikrinate jį raktu, kuris jus pasiekė kitu maršrutu, nukopijuojate jo atvaizdus į savo registrą, ten juos dar kartą patikrinate ir įdiegiate schemą (chart), reikšmėse nurodydami savo registro pavadinimą. Tuomet seka dalykai, kuriuos izoliuotas objektas atlieka rankiniu būdu, o prijungtas prie tinklo gauna automatiškai: k3s ir cert-manager be atsisiuntimo, atnaujinimai laikmenose, licencijos per apykaitą neprisijungus ir atšaukimų sąrašai, kuriuos importuojate patys.
Kas yra neprisijungus naudojamame pakete
Paketas yra vienas vienos laidos leidimas, pateikiamas kaip nesuglaudintas tar archyvas su šalia esančiu kontrolinės sumos failu: nexus-alpha-1.0.0-alpha.1-enterprise.tar ir nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community paketai yra vieši adresu downloads.adverant.ai. Enterprise paketai gaunami iš jūsų Adverant paskyros adresu https://account.adverant.ai, šalia jūsų licencijos, ir niekada nebūna anoniminiai.
Išpakuotas jis atrodo taip:
nexus-alpha-1.0.0-alpha.1-enterprise/
release/facts.json the release facts: version, edition, architectures, key fingerprint
release/facts-gaps.json the release facts the build couldn't record, each with its reason
release/images.lock.json every image by digest: index, per platform, its SBOMs
release/source-offer.json the sources of every copyleft data-tier image
release/source-offer.sha256 a checksum for each of those source files
images/<svc>/ one cosign save layout per image
charts/nexus-1.0.0-alpha.1.tgz the Helm chart
sbom/<edition>/<svc>-<arch>.spdx.json
source-offer/ the source files themselves
docs/INSTALL-AIRGAP.md
docs/example-values.yaml
docs/RELEASE-NOTES.md
SHA256SUMS a checksum for every file above
SHA256SUMS.sigstore.json the signature over SHA256SUMS, made with the release key
Kiekvienas images/<svc>/ katalogas yra tai, ką įrašo cosign save. Jame yra atvaizdų indeksas ir abiejų platformų atvaizdai – linux/amd64 bei linux/arm64 – su cosign parašu, SPDX SBOM (programinės įrangos komponentų sąrašo) patvirtinimu kiekvienai platformai ir kilmės patvirtinimu, kurie visi sukurti naudojant Adverant laidos raktą. Tie patys SBOM guli sbom/ kaip paprasti failai, todėl saugumo komanda gali juos perskaityti be cosign.
Duomenų sluoksnyje yra „copyleft“ programinės įrangos: PostgreSQL su PostGIS, Neo4j Community Edition ir kt. Pakete yra kiekvieno pristatomo duomenų sluoksnio atvaizdo pirminis kodas, ir release/source-offer.json tai nurodo kiekvienam atvaizdui. Paketas, kuriame „copyleft“ dvejetainis failas būtų pristatomas be pirminio kodo, nėra kuriamas.
release/facts.json nurodo laidą, leidimą, architektūras ir laidos rakto, kuriuo buvo pasirašytas paketas, kontrolinį kodą kaip sha256:<hex>.
Viešasis raktas keliauja atskirai
Pakete niekada nebūna rakto, kuriuo jis tikrinamas. Paketą, kuriame būtų jo paties raktas, bet kas galėtų pakeisti kartu su raktu, ir visos patikros vis tiek būtų sėkmingos. Tikrinimo scenarijus atmeta raktą, esantį paketo kataloge.
Vieną kartą gaukite laidos viešąjį raktą prie interneto prijungtame kompiuteryje iš https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Išsaugokite jį kaip release.pub. Jo kontrolinis kodas yra failo SHA-256:
sha256sum release.pubPalyginkite jį su kontroliniu kodu, kurį skelbia Adverant, ir su tuo, kuris nurodytas laidos pastabose, kurias gavote atskiru kanalu. Išsami informacija pateikta 2.4 skyriuje „Laidos gavimas ir tikrinimas“. Tada įneškite release.pub į objektą, jei galite – kitu maršrutu nei paketą, ir laikykite jį ten. Tomáso komanda jį laiko operacijų tinklo bendrinamoje failų saugykloje su pastaba apie gavimo datą. Kiekviena vėlesnė laida tikrinama naudojant tą įdiegtą raktą, ir niekada – naudojant tai, kas atkeliauja diske.
Patikrinkite paketą
verify-bundle.sh yra paketą tikrinantis scenarijus, skelbiamas su kiekviena laida. Diegimo disko atvaizdas paleidžia tą patį scenarijų pirmojo paleidimo metu. Jam reikia cosign v3, helm v4 ir sha256sum arba shasum. Jis nieko neskaito iš jokio tinklo ir jam nereikia Python, todėl jis veikia tiek baziniame diegimo mazge, tiek darbo stotyje.
- Patikrinkite tar failą pagal jo kontrolinę sumą, tada jį išpakuokite:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar- Paleiskite tikrinimą su raktu, kurį įnešėte:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pubTrečiasis argumentas nurodo reikšmių failą schemos (chart) patikroms. Be jo scenarijus naudoja paketo docs/example-values.yaml.
- Perskaitykite paskutinę eilutę – prieš tęsiant toliau, joje turi būti
VERIFY-BUNDLE PASS.
1 SHA256SUMS OK files=<n>
2 SHA256SUMS signature OK
3 images signed + SBOM-attested: <n>
4 helm lint --strict OK nexus-1.0.0-alpha.1.tgz
5 coverage OK rendered=<n> lock=<n>
6 source offer OK images=5 files=<n>
VERIFY-BUNDLE PASS files=<n> images=<n>
Scenarijus sustoja ties pirmąja nepavykusia patikra. Štai ką daro kiekviena iš jų.
| Žingsnis | Ką tikrina |
|---|---|
| 1 | Kiekvienas SHA256SUMS išvardytas failas atitinka savo kontrolinę sumą, ir nėra jokio failo, kurio nebūtų sąraše. Pridėtas papildomas failas sukelia klaidą taip pat užtikrintai, kaip ir pakeistas. |
| 2 | SHA256SUMS.sigstore.json yra galiojantis SHA256SUMS parašas, sukurtas jūsų pateiktu raktu. Sujungus 1 ir 2 žingsnius, kiekvienas paketo baitas yra tas baitas, kurį pasirašė Adverant. |
| 3 | Kiekvienam atvaizdo katalogui: atvaizdo indekso santrauka (digest) yra release/images.lock.json; yra cosign parašas, kurio subjektas yra būtent ta santrauka, ir jis patvirtinamas jūsų raktu; tiek cosign verify, tiek cosign verify-attestation --type spdxjson sėkmingai patikrina išsaugotą išdėstymą. |
| 4 | helm lint --strict sėkmingai patikrina schemą su pavyzdinėmis arba jūsų reikšmėmis. |
| 5 | Kiekvienas užrakto (lock) failo atvaizdas yra išsaugotas images/, o kiekvienas atvaizdas, kurį sugeneruoja schema, yra santrauka užrakto faile. Niekas, ką įdiegia schema, nėra gaunama iš kitur. |
| 6 | Kai užrakto faile yra duomenų sluoksnio atvaizdų, release/source-offer.json yra išsamus, įvardija kiekvieną iš jų, ir kiekvienas jame išvardytas pirminio kodo failas yra pateiktas su teisinga kontroline suma. |
3 žingsnis patikrina patį parašą pagal santrauką, taip pat paleidžia cosign verify. Priežastis yra paties cosign veikimo principas: cosign verify išsaugotame išdėstyme taip pat grąžina 0, kai išdėstyme yra tik raktu pasirašytas patvirtinimas be parašo. Scenarijus to nepriima.
Jei tai nepavyksta
Nesėkmė baigiasi VERIFY-BUNDLE FAIL step=<k> <why>.
| Paskutinė eilutė | Ką tai reiškia | Ką daryti |
|---|---|---|
step=0 the public key must come from outside the bundle |
Jūsų nurodytas raktas yra paketo katalogo viduje. | Naudokite raktą, kurį įnešėte atskirai. |
step=1 checksum mismatch |
Failas pasikeitė po to, kai buvo sudarytas sąrašas, arba buvo sugadintas gabenant. | Dar kartą nukopijuokite paketą iš pradinės laikmenos ir patikrinkite iš naujo. |
step=1 files not covered by SHA256SUMS |
Į paketą buvo pridėtas failas. | Laikykite laikmeną nepatikima. Nediekite iš jos. |
step=2 SHA256SUMS signature does not verify |
Kontrolinių sumų sąrašas nėra pasirašytas jūsų turimu laidos raktu. | Sustokite. Praneškite apie tai savo saugumo komandai ir paprašykite Adverant naujos laikmenos. |
step=3 image <svc>: ... |
Trūksta atvaizdo parašo ar SBOM patvirtinimo arba nepavyksta jų patvirtinti. | Sustokite, kaip ir 2 žingsnyje. |
step=4, step=5 |
Schema arba jos atvaizdų sąrašas yra nesuderinti. | Paprašykite Adverant naujo paketo. |
step=6 ... |
Pirminio kodo pasiūlymas yra neišsamus. | Paprašykite Adverant naujo paketo. |
2 ir 3 žingsnių nesėkmė yra būtent tas atvejis, dėl kurio egzistuoja visa ši sistema. Tai reiškia, kad failai nėra tie, kuriuos pasirašė Adverant. Išsaugokite laikmeną savo saugumo komandai.
Įkelkite atvaizdus į savo registrą
Jūsų mazgai atsisiunčia atvaizdus iš objekto viduje esančio registro. Harrow registras yra registry.harrow.example. Kiekvienas Nexus atvaizdas tame registre patenka į kelią nexus/, nes schema į kiekvieną atvaizdą kreipiasi kaip į <global.imageRegistry>/nexus/<svc>@<digest>.
- Prisijunkite prie savo registro įrankiu, kurį įprastai naudojate, kad
cosigngalėtų į jį įkelti duomenis. - Būdami paketo kataloge, įkelkite kiekvieną atvaizdą ir dar kartą patikrinkite jį naujoje vietoje:
REG=registry.harrow.example
jq -r '.images[] | "\(.svc) \(.index)"' release/images.lock.json | while read -r svc digest; do
cosign load --dir "images/$svc" "$REG/nexus/$svc"
cosign verify --key release.pub --insecure-ignore-tlog=true "$REG/nexus/$svc@$digest" > /dev/null \
&& cosign verify-attestation --key release.pub --insecure-ignore-tlog=true --type spdxjson "$REG/nexus/$svc@$digest" > /dev/null \
&& echo "verified $svc"
donecosign load kartu su atvaizdu perkelia parašą ir kiekvieną patvirtinimą, todėl registro kopija patikrinama tuo pačiu raktu. Šis patikrinimas yra tas, kuris svarbus jūsų klasteriui: jis įrodo, kad tai, ką atsisiųs jūsų mazgai, yra tai, ką pasirašė Adverant.
verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...
Kiekvienas užrakto faile esantis atvaizdas turėtų išvesti vieną verified eilutę. Trūkstama eilutė reiškia, kad to atvaizdo įkėlimas arba patikra nepavyko, o klaida išvedama tiesiai viršuje.
Nexus laidoms nėra skaidrumo žurnalo, todėl kiekvienos patikros metu reikalingas --insecure-ignore-tlog=true. Laidos raktas yra visas pasitikėjimo šaltinis. Be šio parametro cosign atsisako vykdyti užklausą su not enough verified log entries from transparency log: 0 < 1.
Įdiekite iš savo registro
Izoliuoto diegimo reikšmių failas nuo prijungto prie interneto skiriasi viena eilute: global.imageRegistry nurodo jūsų registrą.
# harrow-prod-values.yaml (Helm values)
global:
imageRegistry: registry.harrow.example
domain: harrow.example
hosts:
console: console.harrow.example
api: api.harrow.example
auth: auth.harrow.example
edition: enterprise
enterprise:
enabled: true
tls:
mode: existing
existingSecret: harrow-public-tls
storage:
className: harrow-ssd
keys:
installationName: harrow-port
custody:
recipients:
- "<custodian-one-age-recipient>"
- "<custodian-two-age-recipient>"<custodian-...-age-recipient> įrašai yra žmonių, turinčių raktų saugyklos atkūrimo raktus, viešosios age1... eilutės. 2.8 skyriuje „Diegimas viename kompiuteryje“ paaiškinama, kaip kiekvienas iš jų tokį sukuria. harrow-ssd yra paties Harrow saugyklos klasė: įrašykite savąją arba praleiskite storage.className, kad naudotumėte numatytąją klasterio klasę.
- Atlikite išankstinę klasterio patikrą su šiuo failu, kaip aprašyta 2.5 skyriuje „Išankstinė patikra su nexusctl“.
- Įdiekite iš paketo schemos ir praleiskite
--wait.
helm install nexus charts/nexus-1.0.0-alpha.1.tgz -n nexus --create-namespace \
-f harrow-prod-values.yaml --timeout 45m
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900shelm install --wait sukelia aklavietę su šia schema: podiegiminis saitas (post-install hook) suteikia kiekvienai paslaugai jos duomenų bazės slaptažodį, o --wait sulaiko saitus, kol paslaugos pradės veikti. 2.8 skyriuje „Diegimas viename kompiuteryje“ pateiktas ciklas, kuris taip pat laukia StatefulSets.
Naudojant nexusctl, tas pats diegimas yra nexusctl install --context <kube-context> --values harrow-prod-values.yaml.
Niekas schemoje nesikreipia už vardų srities (namespace) ribų, išskyrus DNS (domenų vardų sistemą), Kubernetes API (aplikacijų programavimo sąsają) prieigos raktų peržiūroms ir bet kokį adresą, kurį įtraukiate į networkPolicy.externalEgressCIDRs (pagal numatytuosius nustatymus jis yra tuščias). Jokia telemetrija neiškeliauja iš diegimo, o telemetry.enabled negali būti nustatytas į nieką kitą, tik į false. Norėdama naudoti DI (dirbtinį intelektą) objekte be interneto, organizacija objekto viduje prijungia savo su OpenAI suderinamą modelių serverį, nurodytą ai.localProvider.baseUrl; tai aptariama 2.14 skyriuje „DI teikėjai ir modeliai“.
Licencija nėra schemos reikšmė. Ją importuojate po įdiegimo, kaip aprašyta toliau.
k3s ir cert-manager be atsisiuntimo
Jei Nexus diegiamas į jūsų pačių kuriamą k3s klasterį, k3s taip pat turi būti įdiegtas be tinklo. Diegimo disko atvaizdas tai padaro už jus (2.9 skyrius „Diegimo disko atvaizdas“). Rankiniu būdu kiekviename mazge:
- Perkelkite savo architektūrai skirtus k3s v1.33.6+k3s1 laidos failus:
k3sdvejetainį failą (k3s-arm64arm64 architektūroje),install.sh,k3s-airgap-images-<arch>.tar.zstirsha256sum-<arch>.txt. k3s šiems failams skelbia kontrolines sumas, bet ne parašą. Patikrinkite kiekvieną failą pagalsha256sum-<arch>.txtir aiškiai informuokite savo saugumo komandą, kad tai yra kontrolinė suma iš to paties šaltinio, o ne parašas. - Padėkite dvejetainį failą ir sistemos atvaizdus ten, kur k3s jų ieško, ir įdiekite išjungę atsisiuntimus:
sudo install -m 0755 k3s /usr/local/bin/k3s
sudo mkdir -p /var/lib/rancher/k3s/agent/images
sudo cp k3s-airgap-images-amd64.tar.zst /var/lib/rancher/k3s/agent/images/
sudo INSTALL_K3S_SKIP_DOWNLOAD=true INSTALL_K3S_EXEC="--write-kubeconfig-mode=0600" sh install.sh
sudo k3s kubectl wait --for=condition=Ready node --all --timeout=600scert-manager v1.21.3 yra būtina sąlyga: pačios schemos CA (sertifikatų centras) yra cert-manager išdavėjas. Perkelkite cert-manager schemą, cert-manager-v1.21.3.tgz ir jos atvaizdus. Prie interneto prijungtoje pusėje prieš perkeldami patikrinkite atvaizdus paties cert-manager projekto raktu:
cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
--key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>Objekto viduje importuokite atvaizdus į kiekvieno mazgo konteinerių saugyklą tais pavadinimais, kurių prašo cert-manager schema, quay.io/jetstack/cert-manager-<name>:v1.21.3, tada patikrinkite juos ir įdiekite:
sudo k3s ctr -n k8s.io images import --all-platforms cert-manager-images.tar
sudo k3s ctr -n k8s.io images ls -q | grep cert-manager
helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
--create-namespace --set crds.enabled=true --wait --timeout 10m--wait tinka cert-manager įrankiui. Tik Nexus negali jo turėti.
Atnaujinimai ir naujos dalys pristatomi pasirašytose laikmenose
Izoliuotas objektas atnaujinamas taip pat iš disko. Konsolės puslapiuose „This installation“ (Šis diegimas) esanti parinktis Import from media (Importuoti iš laikmenos) įkelia laidą iš į objektą atnešto disko. Ji patikrina kiekvieno failo kontrolinę sumą, tada parašą pagal objekte jau įdiegtą laidos raktą (niekada ne pagal raktą iš disko), ir galiausiai – ar laida yra naujesnė už dabar veikiančią. Importavimas tik nukopijuoja ir patikrina. Žmonės toliau dirba su veikiančia laida, ir niekas nesikeičia, kol nepasirenkate atnaujinti.
Iš komandinės eilutės ta pati laida įkeliama naudojant nexusctl:
nexusctl upgrade plan --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tar
nexusctl upgrade apply --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tarplan parodo, kas pasikeis, ir nieko nekeičia. apply pirmiausia sukuria atsarginę kopiją, o tada atnaujina. 2.15 skyriuje „Antroji diena: Nexus eksploatavimas“ išsamiai aptariami atnaujinimai.
Kai disko parašas nesutampa, importavimas atmetamas su MEDIA_SIGNATURE_INVALID. Niekas nėra įkeliama ar nukopijuojama, o veikianti laida veikia toliau. Puslapyje nurodoma, kurios patikros pavyko, kur buvo sustota, ir koks raktas buvo tikėtinas šalia rastojo rakto. Išsaugokite diską savo saugumo komandai ir paprašykite Adverant naujo.
Enterprise dalys, kurias įjungia licencija, izoliuotame objekte atkeliauja tuo pačiu būdu: laidos diske, per „Import from media“, dar prieš jums jas įjungiant. Kiekviena dalis prieš įjungiant yra patikrinama pagal Adverant laidos raktą, todėl jūs niekada nekopijuojate dvejetainio failo į klasterį rankiniu būdu.
Licencijos be interneto
Prie interneto prijungtas diegimas licenciją gauna pats. Izoliuotas diegimas keičiasi failais su Adverant rankiniu būdu, per apykaitą neprisijungus.
- Konsolės licencijos puslapiai sukuria nedidelį licencijos užklausos failą. Diegimas pasirašo jį savo raktu, kad Adverant galėtų nustatyti, kuris diegimas pateikė užklausą.
- Kas nors išneša failą USB atmintuke į kompiuterį, prijungtą prie interneto, prisijungia prie Adverant paskyros adresu
https://account.adverant.aiir įkelia jį puslapyje Offline exchange (Apykaita neprisijungus). - Licencijos failas parnešamas atgal tuo pačiu būdu.
- Importuokite jį. Konsolėje atidarykite Licence and what it unlocks (Licencija ir ką ji atrakina) ir paspauskite Import a new licence (Importuoti naują licenciją). Iš komandinės eilutės:
nexusctl licence import harrow-port-licence.jsonLicencija tikrinama neprisijungus, objekto viduje, pagal Adverant raktus. Adverant pasirašo kiekvieną licenciją dviem nepriklausomais raktais, ir abu parašai turi būti patvirtinti.
Per tą pačią apykaitą išsiunčiama ir metinė naudojimo ataskaita. Joje yra tik skaitikliai (darbo vietos, įrenginiai, funkcijų grupės), ir administratorius prieš išsiunčiant perskaito ją eilutė po eilutės puslapyje Usage statement for Adverant (Naudojimo ataskaita, skirta Adverant).
| Kodas | Būsena | Ką tai reiškia |
|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Failas nėra licencija, kurią pasirašė Adverant, arba po pasirašymo pasikeitė bent vienas baitas. Niekas nesikeičia. |
LICENCE_OTHER_INSTALLATION |
409 | Licencija yra tikra, bet buvo išduota kitam diegimui. Paprašykite licencijos, išduotos šio diegimo identifikatoriui. |
LICENCE_CLOCK_BEHIND_FLOOR |
409 | Laikrodis rodo ankstesnį laiką nei vėliausias laikas, kurį šis diegimas yra fiksavęs. Laikrodžio atsukimas atgal neatgaivina pasibaigusio galiojimo licencijos. |
LICENCE_REVOKED |
403 | Adverant atšaukė licenciją pasirašytu atšaukimu. Enterprise dalys nebesiūlomos; Community ir eksportavimas lieka. |
2.13 skyriuje „Licencijos“ aptariamos būsenos, lengvatinis laikotarpis ir atnaujinimas.
Atšaukimų sąrašai importuojami rankiniu būdu
Kai Adverant atšaukia licenciją, ji paskelbia pasirašytą atšaukimų sąrašą. Sąrašas yra kaupiamasis: kiekviename iš jų yra visos iki tol atšauktos licencijos. Prie interneto prijungtas diegimas apie tai sužino. Izoliuotas diegimas sužino tik tada, kai kas nors importuoja sąrašą, todėl atneškite naujausią sąrašą su kiekvienu laidos disku ir importuokite jį per diegimo atšaukimų importavimo funkciją licencijos puslapiuose arba adresu /api/v1/installation/licence/revocations prisijungimo serveryje.
Tai veikia abipusiai. Izoliuotas diegimas, kuris niekada neimportuoja sąrašo, niekada nesužino, kad licencija buvo atšaukta, įskaitant licenciją, pasirašytą raktu, kuris vėliau buvo pripažintas sukompromituotu. Sąrašo importavimas yra vienintelis būdas šiai žiniai įveikti atskirtį.
Suverenus užplombuotas paketas: nexus-airgap
Kai kurie suverenūs objektai pageidauja laidos kaip vieno užplombuoto, pasirašyto failo, kurio paties manifestas draudžia prieigą prie tinklo. Jiems skirtas antrasis formatas – užplombuotas paketas – ir jo įrankis nexus-airgap iš paketo @adverant/nexus-sovereign. Įdiekite įrankį iš Adverant paketų registro, atskirai nuo bet kurio paketo, kurį jis tikrins. Paketas negali laiduoti pats už save.
Užplombuotas paketas yra vienas pasirašytas tar archyvas. Jo manifestas yra pasirašytas Ed25519 ir jame nurodoma kiekvieno failo SHA-256 suma. Įrankis turi keturias komandas.
| Komanda | Ką daro |
|---|---|
nexus-airgap bundle |
Sukuria užplombuotą paketą iš paruošto katalogo ir pasirašo jo manifestą. |
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> |
Patikrina parašą pagal patikimą raktą, iš naujo apskaičiuoja kiekvieno failo maišą, atmeta bet kurį failą, kurio nėra manifeste, ir atmeta paketą, kurio tinklo taisyklė nėra tuščias leidžiamų adresų sąrašas su tik vietiniu agento srautu. Nieko nekeičia. |
nexus-airgap install |
Patikrina, o tada eilės tvarka įvykdo diegimo planą: įkelia atvaizdus, pritaiko manifestus, paleidžia migracijas, įrašo įgūdžius, parūpina raktus. |
nexus-airgap open |
Atidaro pasirenkamą užšifruotą paketo eksportą naudojant paties objekto raktų saugotoją, kuris izoliuotame objekte yra kompiuterio TPM (Trusted Platform Module) lustas. |
Prieš darydami bet ką kita, atlikite patikrinimą:
nexus-airgap verify --bundle nexus-alpha-1.0.0-alpha.1.tar.gz \
--trusted-key release.pub --profile airgap --keep-staging > verify.json
jq '{ok, bundleId, profile, artifactsVerified}' verify.json--keep-staging išsaugo patikrintą, išpakuotą kopiją ir išvestyje įvardija ją kaip stagingDir, todėl dirbate su tuo, kas buvo patikrinta.
Jei patikrinimas nepavyksta su BUNDLE_INTEGRITY_VIOLATION, paketo viduje esantis failas pasikeitė po to, kai buvo pasirašytas. Sustokite. Įrankis turi --no-strict parametrą, kuris praleidžia neįtrauktų į sąrašą failų patikrą. Nenaudokite jo laidai.
Diena, kai atkeliauja kitas diskas
Tomásas apsaugos posto spintelės viduje laiko priklijuotą trumpą kontrolinį sąrašą, kurį verta nusikopijuoti. Patikrinkite tar failo .sha256. Paleiskite verify-bundle.sh su įdiegtu raktu ir perskaitykite paskutinę eilutę. Importuokite naujausią atšaukimų sąrašą. Tada, ir tik tada, importuokite laidą iš laikmenos ir suplanuokite atnaujinimą. Diskas, kuris nepraeina bet kurio iš šių žingsnių, grąžinamas atgal į voką, pažymimas ir perduodamas saugumo komandai, o tinkle niekas nepasikeičia.


