Versija 1.0.0-alpha.1jaunākā
2.10. nodaļa
Instalēšana izolētā vidē
Nogādājiet parakstītu bezsaistes pakotni objektā bez interneta, pārbaudiet to ar atsevišķi piegādātu atslēgu, ielādējiet to savā reģistrā un instalējiet. Arī licences, atjauninājumi un atsaukumu saraksti šo robežu šķērso manuāli.
Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

Harrow Port Authority operāciju tīklam gan pēc likuma, gan pēc uzbūves nav maršruta uz internetu. Tajā atrodas kuģu satiksmes dati, piestātņu plāni un muitas aizturējumi, un nekas šajā tīklā nedrīkst veikt izejošus savienojumus. Kad Tomás Reilly tur uzstādīja Nexus, katrs baits tika piegādāts diskā, ko kurjers atnesa līdz sargmājai, un katrs baits tika pārbaudīts objekta iekšienē, pirms jebkas to izmantoja.
Šī nodaļa ir par šo uzstādīšanu. Jūs saņemat parakstītu bezsaistes pakotni, pārbaudāt to ar atslēgu, kas pie jums nonākusi pa citu ceļu, iekopējat tās attēlus savā reģistrā, pārbaudāt tos tur vēlreiz un uzstādāt diagrammu, vērtībās norādot sava reģistra nosaukumu. Pēc tam seko darbības, kuras no tīkla izolētā objektā veic manuāli, bet savienotā objektā tās notiek automātiski: k3s un cert-manager bez lejupielādes, atjauninājumi datu nesējos, licences caur bezsaistes apmaiņu un atsaukumu saraksti, kurus importējat paši.
Ko satur bezsaistes pakotne
Pakotne ir viena laidiena viens izdevums nesaspiesta tar arhīva veidā, kam blakus ir kontrolsummas fails: nexus-alpha-1.0.0-alpha.1-enterprise.tar un nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community pakotnes ir publiski pieejamas vietnē downloads.adverant.ai. Enterprise pakotnes ir pieejamas jūsu Adverant kontā vietnē https://account.adverant.ai, blakus jūsu licencei, un nekad nav pieejamas anonīmi.
Atpakotā veidā tas izskatās šādi:
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
Katra images/<svc>/ direktorija ir tas, ko ieraksta cosign save. Tajā glabājas attēlu indekss un abu platformu attēli — linux/amd64 un linux/arm64 — kopā ar cosign parakstu, SPDX SBOM (programmatūras materiālu saraksta) apliecinājumu katrai platformai un izcelsmes apliecinājumu, kas visi izveidoti ar Adverant laidiena atslēgu. Tie paši SBOM atrodas sbom/ kā vienkārši faili, lai drošības komanda varētu tos izlasīt bez cosign.
Datu līmenis ietver copyleft programmatūru: tostarp PostgreSQL ar PostGIS un Neo4j Community Edition. Pakotne satur katra tajā iekļautā datu līmeņa attēla pirmkodu, un release/source-offer.json to norāda katram attēlam. Pakotne, kas piegādātu copyleft bināro failu bez tā pirmkoda, netiek veidota.
release/facts.json norāda laidienu, izdevumu, arhitektūras un tās laidiena atslēgas nospiedumu, ar kuru pakotne tika parakstīta, kā sha256:<hex>.
Publiskā atslēga tiek piegādāta atsevišķi
Pakotne nekad nesatur atslēgu, ar kuru to pārbauda. Pakotni, kurā būtu iekļauta tās pašas atslēga, jebkurš varētu aizstāt ar visu atslēgu, un visas pārbaudes joprojām būtu sekmīgas. Verifikācijas skripts noraida atslēgu, kas atrodas pakotnes direktorijā.
Vienreiz iegūstiet laidiena publisko atslēgu savienotā datorā no https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Saglabājiet to kā release.pub. Tās nospiedums ir faila SHA-256:
sha256sum release.pubSalīdziniet to ar Adverant publicēto nospiedumu un ar to, kas norādīts laidiena piezīmēs, kuras saņēmāt pa atsevišķu kanālu. Sīkāka informācija ir atrodama 2.4. nodaļā „Laidiena iegūšana un verificēšana”. Pēc tam nogādājiet release.pub objektā, ja iespējams, pa citu ceļu nekā pakotni, un glabājiet to tur. Tomás komanda to glabā operāciju tīkla koplietojamajā failu krātuvē ar atzīmi par saņemšanas datumu. Katrs turpmākais laidiens tiek pārbaudīts pret šo uzstādīto atslēgu, un nekad pret kaut ko tādu, kas atrodams atnestajā diskā.
Pakotnes pārbaude
verify-bundle.sh ir skripts, kas pārbauda pakotni un tiek publicēts ar katru laidienu. Instalētāja diska attēls palaiž to pašu skriptu pirmās sāknēšanas reizē. Tam ir nepieciešams cosign v3, helm v4 un sha256sum vai shasum. Tas neko nelasa no tīkla un tam nav nepieciešams Python, tāpēc tas darbojas gan uz tīra instalētāja mezgla, gan darbstacijā.
- Pārbaudiet tar failu pret tā kontrolsummu, pēc tam atpakojiet to:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar- Palaidiet verifikāciju ar atslēgu, kuru ienesāt:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pubTrešais arguments norāda vērtību failu diagrammas pārbaudēm. Bez tā skripts izmanto pakotnes docs/example-values.yaml.
- Izlasiet pēdējo rindiņu — pirms turpināt, tai ir jābūt
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>
Skripts apstājas pie pirmās nesekmīgās pārbaudes. Lūk, ko dara katra no tām.
| Solis | Ko tas pārbauda |
|---|---|
| 1 | Katrs SHA256SUMS uzskaitītais fails atbilst tā kontrolsummai, un nav neviena tāda faila, kurš nebūtu iekļauts sarakstā. Ievietots papildu fails izraisa nesekmīgu pārbaudi tikpat droši kā izmainīts fails. |
| 2 | SHA256SUMS.sigstore.json ir derīgs SHA256SUMS paraksts, kas izveidots ar jūsu norādīto atslēgu. Izpildoties 1. un 2. solim kopā, katrs baits pakotnē ir baits, ko parakstījis Adverant. |
| 3 | Katrai attēla direktorijai: attēla indeksa kontrolsumma (digest) atrodas release/images.lock.json; pastāv cosign paraksts, kura subjekts ir tieši šī kontrolsumma, un tas tiek verificēts ar jūsu atslēgu; gan cosign verify, gan cosign verify-attestation --type spdxjson saglabātajam izkārtojumam ir sekmīgi. |
| 4 | helm lint --strict ir sekmīgs diagrammai ar piemēra vērtībām vai ar jūsu vērtībām. |
| 5 | Katrs fiksācijas failā (lock) esošais attēls ir saglabāts images/, un katrs attēls, ko atveido diagramma, ir kontrolsumma fiksācijas failā. Nekas no tā, ko uzstāda diagramma, nenāk no citienes. |
| 6 | Ja fiksācijas failā ir datu līmeņa attēli, release/source-offer.json ir pilnīgs, tajā ir nosaukts katrs no tiem, un katrs tajā uzskaitītais pirmkoda fails ir klāt ar pareizo kontrolsummu. |
3. solis pārbauda pašu parakstu pēc kontrolsummas, kā arī palaiž cosign verify. Iemesls ir paša cosign darbības loģika: cosign verify saglabātam izkārtojumam atgriež 0 arī tad, ja izkārtojumā ir tikai ar atslēgu veikts apliecinājums, bet nav paraksta. Skripts to nepieņem.
Ja tas neizdodas
Kļūme beidzas ar VERIFY-BUNDLE FAIL step=<k> <why>.
| Pēdējā rindiņa | Ko tas nozīmē | Kā rīkoties |
|---|---|---|
step=0 the public key must come from outside the bundle |
Jūsu norādītā atslēga atrodas pakotnes direktorijā. | Izmantojiet atslēgu, ko ienesāt atsevišķi. |
step=1 checksum mismatch |
Fails ir mainījies pēc saraksta izveides vai ticis bojāts pārsūtīšanas laikā. | Nokopējiet pakotni vēlreiz no oriģinālā datu nesēja un pārbaudiet no jauna. |
step=1 files not covered by SHA256SUMS |
Pakotnei ir pievienots fails. | Uzskatiet datu nesēju par neuzticamu. Neveiciet uzstādīšanu no tā. |
step=2 SHA256SUMS signature does not verify |
Kontrolsummu saraksts nav parakstīts ar jūsu rīcībā esošo laidiena atslēgu. | Apstājieties. Ziņojiet par to savai drošības komandai un pieprasiet Adverant jaunu datu nesēju. |
step=3 image <svc>: ... |
Trūkst attēla paraksta vai SBOM apliecinājuma, vai arī to neizdodas verificēt. | Apstājieties, tāpat kā 2. solī. |
step=4, step=5 |
Diagramma vai tās attēlu saraksts nesaskan. | Pieprasiet Adverant jaunu pakotni. |
step=6 ... |
Pirmkoda piedāvājums ir nepilnīgs. | Pieprasiet Adverant jaunu pakotni. |
2. un 3. soļa nesekmīga izpilde ir gadījums, kura dēļ visa šī sistēma pastāv. Tas nozīmē, ka šie faili nav tie, kurus parakstījis Adverant. Saglabājiet datu nesēju savai drošības komandai.
Attēlu ielāde savā reģistrā
Jūsu mezgli izgūst attēlus no reģistra, kas atrodas objekta iekšienē. Harrow reģistrs ir registry.harrow.example. Katrs Nexus attēls šajā reģistrā tiek ievietots ceļā nexus/, jo diagramma uz katru attēlu atsaucas kā <global.imageRegistry>/nexus/<svc>@<digest>.
- Pierakstieties savā reģistrā ar rīku, ko parasti izmantojat, lai
cosignvarētu tajā augšupielādēt datus. - No pakotnes direktorijas iekšienes ielādējiet katru attēlu un verificējiet to vēlreiz tā jaunajā atrašanās vietā:
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 kopā ar attēlu pārnes arī parakstu un katru apliecinājumu, tādējādi reģistra kopija tiek verificēta ar to pašu atslēgu. Šī verifikācija ir izšķirošā jūsu klasterim: tā pierāda, ka tas, ko jūsu mezgli izgūs, ir tas, ko parakstījis Adverant.
verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...
Katram fiksācijas failā esošajam attēlam vajadzētu izvadīt vienu verified rindiņu. Trūkstoša rindiņa nozīmē, ka attiecīgā attēla ielāde vai pārbaude neizdevās, un tā kļūda ir izdrukāta tieši virs tās.
Nexus laidieniem nav caurredzamības žurnāla (transparency log), tāpēc katrā pārbaudē ir nepieciešams --insecure-ignore-tlog=true. Laidiena atslēga ir visa uzticamības sakne. Bez šī karodziņa cosign atsaka darbību ar not enough verified log entries from transparency log: 0 < 1.
Instalēšana no sava reģistra
Vērtību fails uzstādīšanai izolētā vidē atšķiras no savienotas vides faila vienā rindiņā: global.imageRegistry norāda jūsu reģistru.
# 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> ieraksti ir to personu publiskās age1... rindiņas, kurām ir atslēgu krātuves atkopšanas atslēgas. 2.8. nodaļā „Uzstādīšana vienā mašīnā” ir paskaidrots, kā katrs to izveido. harrow-ssd ir paša Harrow krātuves klase: ievadiet savējo vai izlaidiet storage.className, lai izmantotu klastera noklusējumu.
- Palaidiet klastera pirmspārbaudi (preflight) ar šo failu, kā aprakstīts 2.5. nodaļā „Pirmspārbaude ar nexusctl”.
- Uzstādiet no pakotnes diagrammas un izlaidiet
--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 ar šo diagrammu nonāk strupceļā (deadlock): pēcuzstādīšanas āķis (post-install hook) piešķir katram pakalpojumam tā datubāzes paroli, savukārt --wait aiztur āķus, līdz pakalpojumi darbojas. 2.8. nodaļā „Uzstādīšana vienā mašīnā” ir parādīts cikls, kas gaida arī StatefulSets gatavību.
Ar nexusctl tā pati uzstādīšana ir nexusctl install --context <kube-context> --values harrow-prod-values.yaml.
Nekas diagrammā nesniedzas ārpus nosaukumvietas, izņemot DNS (domēna vārdu sistēmu), Kubernetes API (lietojumprogrammu saskarni) pilnvaru pārbaudēm un jebkuru adresi, ko norādāt networkPolicy.externalEgressCIDRs, kas pēc noklusējuma ir tukšs. No instalācijas netiek sūtīta nekāda telemetrija, un telemetry.enabled nevar iestatīt ne uz ko citu kā tikai false. Lai nodrošinātu MI (mākslīgo intelektu) objektā bez interneta, organizācija objekta iekšienē pieslēdz savu ar OpenAI saderīgu modeļu serveri, kas norādīts ai.localProvider.baseUrl; tas ir apskatīts 2.14. nodaļā „MI nodrošinātāji un modeļi”.
Licence nav diagrammas vērtība. To importē pēc uzstādīšanas, kā aprakstīts tālāk.
k3s un cert-manager bez lejupielādes
Ja Nexus tiks izvietots k3s klasterī, kuru veidojat pats, arī k3s ir jāuzstāda bez tīkla. Instalētāja diska attēls to izdara jūsu vietā (2.9. nodaļa „Instalētāja diska attēls”). Manuāli katrā mezglā:
- Pārnesiet savai arhitektūrai atbilstošos k3s v1.33.6+k3s1 laidiena failus:
k3sbināro failu (k3s-arm64uz arm64),install.sh,k3s-airgap-images-<arch>.tar.zstunsha256sum-<arch>.txt. k3s šiem failiem publicē kontrolsummas, bet ne parakstu. Pārbaudiet katru failu pretsha256sum-<arch>.txtun skaidri informējiet savu drošības komandu, ka tā ir kontrolsumma no tā paša avota, nevis paraksts. - Novietojiet bināro failu un sistēmas attēlus tur, kur k3s tos meklē, un uzstādiet ar izslēgtām lejupielādēm:
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 ir priekšnosacījums: pašas diagrammas CA (sertifikātu iestāde) ir cert-manager izdevējs. Pārnesiet cert-manager diagrammu, cert-manager-v1.21.3.tgz, un tā attēlus. Savienotajā pusē pirms pārnešanas pārbaudiet attēlus ar paša cert-manager projekta atslēgu:
cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
--key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>Objekta iekšienē importējiet attēlus katra mezgla konteineru krātuvē ar nosaukumiem, kādus pieprasa cert-manager diagramma, quay.io/jetstack/cert-manager-<name>:v1.21.3, pēc tam pārbaudiet tos un uzstādiet:
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 ir pareizs priekš cert-manager. Tikai Nexus to nedrīkst izmantot.
Atjauninājumi un jaunas komponentes parakstītos datu nesējos
Arī no tīkla izolētā objektā jaunināšana notiek no diska. Konsoles lapās „Šī instalācija” opcija Importēt no datu nesēja ielādē laidienu no objektā ienesta diska. Tā pārbauda katra faila kontrolsummu, pēc tam parakstu pret objektā jau uzstādīto laidiena atslēgu (nekad pret atslēgu no diska) un visbeidzot to, vai laidiens ir jaunāks par pašlaik darbojošos. Importēšana tikai nokopē un pārbauda. Lietotāji turpina strādāt ar darbojošos laidienu, un nekas nemainās, kamēr neizvēlaties veikt jaunināšanu.
No komandrindas to pašu laidienu ielādē ar 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 parāda, kas mainīsies, un neko nemaina. apply vispirms izveido dublējumu un pēc tam veic jaunināšanu. 2.15. nodaļā „Otrā diena: Nexus ekspluatācija” jaunināšana ir aprakstīta pilnībā.
Ja diska paraksts nesakrīt, importēšana tiek noraidīta ar MEDIA_SIGNATURE_INVALID. Nekas netiek ielādēts vai iekopēts, un darbojošais laidiens turpina darbu. Lapā ir norādīts, kuras pārbaudes bija sekmīgas, kur process apstājās, kā arī gaidītā atslēga blakus atrastajai atslēgai. Saglabājiet disku savai drošības komandai un pieprasiet Adverant jaunu.
Enterprise komponentes, kuras ieslēdz licence, izolētā objektā tiek piegādātas tādā pašā veidā: laidiena diskā, izmantojot „Importēt no datu nesēja”, pirms jūs tās ieslēdzat. Katra komponente pirms ieslēgšanas tiek pārbaudīta pret Adverant laidiena atslēgu, tāpēc jūs nekad manuāli nekopējat bināro failu klasterī.
Licences bez interneta
Savienota instalācija savu licenci saņem automātiski. Izolēta instalācija apmainās ar failiem ar Adverant manuāli, izmantojot bezsaistes apmaiņu.
- Konsoles licenču lapās tiek izveidots neliels licences pieprasījuma fails. Instalācija to paraksta ar savu atslēgu, lai Adverant varētu noteikt, kura instalācija to pieprasīja.
- Kāds iznes šo failu USB zibatmiņā uz datoru, kas ir tiešsaistē, pierakstās Adverant kontā vietnē
https://account.adverant.aiun augšupielādē to lapā Bezsaistes apmaiņa. - Licences failu atnes atpakaļ tādā pašā veidā.
- Importējiet to. Konsolē atveriet Licence un ko tā atbloķē un nospiediet Importēt jaunu licenci. No komandrindas:
nexusctl licence import harrow-port-licence.jsonLicence tiek pārbaudīta bezsaistē, objekta iekšienē, pret Adverant atslēgām. Adverant paraksta katru licenci ar divām neatkarīgām atslēgām, un abiem parakstiem ir jāiziet verifikācija.
Izmantojot to pašu apmaiņu, tiek iznests ikgadējais lietojuma pārskats. Tajā ir tikai skaitītāji (vietas, ierīces, funkciju grupas), un administrators pirms iznešanas to izskata rindiņu pa rindiņai sadaļā Lietojuma pārskats priekš Adverant.
| Kods | Statuss | Ko tas nozīmē |
|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Fails nav Adverant parakstīta licence, vai arī pēc parakstīšanas ir mainījies kāds baits. Nekas nemainās. |
LICENCE_OTHER_INSTALLATION |
409 | Licence ir īsta, bet izsniegta citai instalācijai. Pieprasiet licenci, kas izsniegta šīs instalācijas ID. |
LICENCE_CLOCK_BEHIND_FLOOR |
409 | Pulkstenis rāda agrāku laiku nekā pēdējais laiks, ko šī instalācija ir fiksējusi. Pulksteņa pagriešana atpakaļ neatjauno licenci, kurai beidzies derīguma termiņš. |
LICENCE_REVOKED |
403 | Adverant atsauca licenci ar parakstītu atsaukumu. Enterprise komponentes vairs netiek piedāvātas; Community un eksports paliek. |
2.13. nodaļā „Licences” ir apskatīti stāvokļi, labvēlības periodi un atjaunošana.
Atsaukumu saraksti tiek importēti manuāli
Kad Adverant atsauc licenci, tas publicē parakstītu atsaukumu sarakstu. Saraksts ir kumulatīvs: katrā nākamajā ir iekļautas visas iepriekš atsauktās licences. Savienota instalācija par to uzzina pati. Izolēta instalācija to uzzina tikai tad, kad kāds šo sarakstu importē, tāpēc ienesiet jaunāko sarakstu ar katru laidiena disku un importējiet to, izmantojot instalācijas atsaukumu importu licenču lapās vai /api/v1/installation/licence/revocations adresi pierakstīšanās resursdatorā.
Tam ir divējādas sekas. Izolēta instalācija, kurā nekad netiek importēts saraksts, nekad neuzzina, ka licence ir atsaukta, ieskaitot licenci, kas parakstīta ar atslēgu, kura vēlāk atzīta par kompromitētu. Saraksta importēšana ir vienīgais veids, kā šī ziņa šķērso izolācijas robežu.
Suverēnā aizzīmogotā pakotne: nexus-airgap
Dažos suverēnos objektos laidiens ir nepieciešams kā viens aizzīmogots, parakstīts fails, kura paša manifests aizliedz piekļuvi tīklam. Tiem ir paredzēts otrs formāts — aizzīmogotā pakotne — un tās rīks nexus-airgap no pakotnes @adverant/nexus-sovereign. Uzstādiet šo rīku no Adverant pakotņu reģistra atsevišķi no jebkuras pakotnes, ko tas pārbaudīs. Pakotne nevar galvot pati par sevi.
Aizzīmogotā pakotne ir viens parakstīts tar arhīvs. Tās manifests ir parakstīts ar Ed25519, un tajā ir norādīts SHA-256 katram failam. Rīkam ir četras komandas (verbs).
| Komanda | Ko tas dara |
|---|---|
nexus-airgap bundle |
Izveido aizzīmogotu pakotni no sagatavotas direktorijas un paraksta tās manifestu. |
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> |
Pārbauda parakstu pret uzticamo atslēgu, pārrēķina katra faila jaucējvērtību, noraida jebkuru failu, kas nav uzskaitīts manifestā, un noraida pakotni, kuras tīkla kārtula nav tukšs atļauto adrešu saraksts ar tikai lokālu aģentu datplūsmu. Neko nemaina. |
nexus-airgap install |
Verificē, pēc tam secīgi izpilda uzstādīšanas plānu: ielādē attēlus, piemēro manifestus, palaiž migrācijas, ievieto sākotnējās prasmes (skills), nodrošina atslēgas. |
nexus-airgap open |
Atver pakotnes neobligāto šifrēto eksportu ar paša objekta atslēgu glabātāju, kas izolētā objektā ir mašīnas TPM (Trusted Platform Module) mikroshēma. |
Pirms jebkādām citām darbībām veiciet verifikāciju:
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 saglabā verificēto, atpakoto kopiju un izvadē to norāda kā stagingDir, lai jūs strādātu ar to, kas tika pārbaudīts.
Ja verifikācija neizdodas ar BUNDLE_INTEGRITY_VIOLATION, kāds fails pakotnes iekšienē ir mainījies pēc tās parakstīšanas. Šajā vietā apstājieties. Rīkam ir slēdzis --no-strict, kas izlaiž sarakstā neiekļauto failu pārbaudi. Neizmantojiet to laidienam.
Diena, kad tiek piegādāts nākamais disks
Tomás sargmājas skapīša iekšpusē tur pielīmētu īsu kontrolsarakstu, kuru ir vērts pārņemt. Pārbaudiet tar faila .sha256. Palaidiet verify-bundle.sh ar uzstādīto atslēgu un izlasiet pēdējo rindiņu. Importējiet jaunāko atsaukumu sarakstu. Tad, un tikai tad, importējiet laidienu no datu nesēja un plānojiet jaunināšanu. Disks, kuram kāds no šiem soļiem ir nesekmīgs, tiek ielikts atpakaļ aploksnē, nomarķēts un nodots drošības komandai, un tīklā nekas nav mainījies.


