Sürüm 1.0.0-alpha.1en son
Bölüm 2.10
Hava boşluklu (air-gapped) kurulum
İmzalı bir çevrimdışı paketi internet olmayan bir sahaya taşıyın, ayrı olarak getirdiğiniz bir anahtarla doğrulayın, kendi kayıt defterinize (registry) yükleyin ve kurun. Lisanslar, güncellemeler ve iptal listeleri de bu boşluğu elden aşar.
Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

Harrow Port Authority'nin operasyon ağının, yasalar gereği ve tasarım itibarıyla internete hiçbir çıkışı yoktur. Gemi trafiği, yanaşma planları ve gümrük bekletmeleri tamamen bu ağda yer alır ve üzerindeki hiçbir şey dışarıya çağrı yapamaz. Tomás Reilly oraya Nexus'u kurduğunda, her bir bayt bir kuryenin nizamiyeye getirdiği bir disk üzerinde ulaştı ve herhangi bir şey onu kullanmadan önce her bir bayt tesis içinde kontrol edildi.
Bu bölüm o kurulumu anlatır. İmzalı bir çevrimdışı paket alır, size farklı bir yoldan ulaşan bir anahtarla onu kontrol eder, imajlarını kendi kayıt defterinize (registry) kopyalar, orada tekrar kontrol eder ve değerlerde kayıt defterinizin adını belirterek chart'ı kurarsınız. Ardından, bağlantılı bir tesisin zahmetsizce elde ettiği ancak dış ağa kapalı (air-gapped) bir tesisin elle yaptığı işler gelir: indirme olmadan k3s ve cert-manager, medya üzerinden güncellemeler, çevrimdışı değişim yoluyla lisanslar ve kendi içe aktardığınız iptal listeleri.
Çevrimdışı paketin içeriği
Bir paket, yanında bir sağlama toplamı (checksum) dosyası bulunan sıkıştırılmamış bir tar olarak bir sürümün tek bir edisyonudur: nexus-alpha-1.0.0-alpha.1-enterprise.tar ve nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community paketleri downloads.adverant.ai üzerinde herkese açıktır. Enterprise paketleri ise https://account.adverant.ai adresindeki Adverant hesabınızdan, lisansınızın yanından gelir ve asla anonim olarak sunulmaz.
Paketten çıkarıldığında şöyle görünür:
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
Her bir images/<svc>/ dizini, cosign save aracının yazdığı çıktıdır. Tamamı Adverant sürüm anahtarıyla oluşturulmuş olan cosign imzası, her platform için bir SPDX SBOM (yazılım malzeme listesi) doğrulaması (attestation) ve bir köken doğrulaması ile birlikte imaj dizinini ve her iki platform imajını (linux/amd64 ve linux/arm64) barındırır. Aynı SBOM'lar bir güvenlik ekibinin cosign olmadan okuyabilmesi için sbom/ içinde düz dosyalar olarak bulunur.
Veri katmanı copyleft yazılımlar içerir: bunların arasında PostGIS ile PostgreSQL ve Neo4j Community Edition bulunur. Paket, gönderdiği her veri katmanı imajının kaynak kodunu taşır ve release/source-offer.json her imaj için bunu belirtir. Bir copyleft ikili dosyasını kaynak kodu olmadan gönderecek bir paket oluşturulmaz.
release/facts.json, sürümü, edisyonu, mimarileri ve paketin imzalandığı sürüm anahtarının parmak izini sha256:<hex> olarak adlandırır.
Açık anahtar ayrı taşınır
Paket, kendisini kontrol eden anahtarı asla içermez. Kendi anahtarını taşıyan bir paket, anahtarı ve diğer her şeyiyle birlikte herhangi biri tarafından değiştirilebilir ve yine de tüm kontrollerden geçerdi. Doğrulama betiği, paket dizininin içinde bulunan bir anahtarı reddeder.
Sürüm açık anahtarını bağlantılı bir makinede https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ adresinden bir kez alın. release.pub olarak kaydedin. Parmak izi, dosyanın SHA-256 değeridir:
sha256sum release.pubBunu Adverant'ın yayımladığı parmak iziyle ve ayrı bir kanaldan aldığınız sürüm notlarındaki parmak iziyle karşılaştırın. Ayrıntılar Bölüm 2.4, Bir sürümü alma ve doğrulama içinde yer almaktadır. Ardından release.pub dosyasını, mümkünse paketten farklı bir yoldan tesise taşıyın ve orada saklayın. Tomás'ın ekibi bunu, geldiği tarihin bir notuyla birlikte operasyon ağının dosya paylaşımında tutar. Sonraki her sürüm, bir diskin beraberinde getirdiği herhangi bir şeye göre değil, bu kurulu anahtara göre kontrol edilir.
Paketi doğrulayın
verify-bundle.sh, her sürümle birlikte yayımlanan ve bir paketi kontrol eden betiktir. Yükleyici disk imajı ilk önyüklemede aynı betiği çalıştırır. cosign v3, helm v4 ve sha256sum veya shasum gerektirir. Hiçbir ağdan hiçbir şey okumaz ve Python gerektirmez; bu sayede bir iş istasyonunun yanı sıra yalın bir yükleyici düğümünde (node) de çalışır.
- Tar dosyasını sağlama toplamına göre kontrol edin, ardından paketten çıkarın:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar- İçeri getirdiğiniz anahtarla doğrulamayı çalıştırın:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pubÜçüncü bir argüman, chart kontrolleri için bir değerler (values) dosyası belirtir. Bu argüman olmadan betik, paketin docs/example-values.yaml dosyasını kullanır.
- Daha ileri gitmeden önce
VERIFY-BUNDLE PASSolması gereken son satırı okuyun.
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>
Betik, başarısız olan ilk kontrolde durur. Her birinin ne yaptığı aşağıda açıklanmıştır.
| Adım | Neyi kontrol eder |
|---|---|
| 1 | SHA256SUMS içinde listelenen her dosya kendi sağlama toplamıyla eşleşir ve listenin dışarıda bıraktığı hiçbir dosya mevcut değildir. Sonradan yerleştirilmiş fazladan bir dosya da, değiştirilmiş bir dosya kadar kesin bir şekilde başarısız olur. |
| 2 | SHA256SUMS.sigstore.json, verdiğiniz anahtar tarafından SHA256SUMS üzerinde oluşturulmuş geçerli bir imzadır. 1. ve 2. adımlar birlikte ele alındığında, paketteki her bir bayt Adverant'ın imzaladığı bayttır. |
| 3 | Her imaj dizini için: imajın dizin özeti (index digest) release/images.lock.json içindedir; konusu tam olarak o özet olan bir cosign imzası vardır ve anahtarınıza göre doğrulanır; kaydedilen düzen üzerinde cosign verify ve cosign verify-attestation --type spdxjson kontrollerinin her ikisi de başarılı olur. |
| 4 | helm lint --strict, örnek değerlerle veya sizin değerlerinizle chart üzerinde başarılı olur. |
| 5 | Kilit dosyasındaki her imaj images/ içine kaydedilmiştir ve chart'ın işlediği (render ettiği) her imaj kilit dosyasında bir özettir. Chart'ın kurduğu hiçbir şey başka bir yerden gelmez. |
| 6 | Kilit dosyası veri katmanı imajları barındırdığında, release/source-offer.json eksiksizdir, her birini adlandırır ve listelediği her kaynak dosyası doğru sağlama toplamıyla mevcuttur. |
3. adım, cosign verify komutunu çalıştırmanın yanı sıra imzanın kendisini de özete göre kontrol eder. Bunun nedeni cosign'ın kendi davranışıdır: kaydedilen bir düzen üzerinde cosign verify, düzen yalnızca anahtar tarafından yapılan bir doğrulamayı barındırdığında ve imza olmadığında da 0 koduyla çıkar. Betik bunu kabul etmez.
Bu başarısız olursa
Bir hata VERIFY-BUNDLE FAIL step=<k> <why> ile sona erer.
| Son satır | Anlamı | Ne yapılmalı |
|---|---|---|
step=0 the public key must come from outside the bundle |
Belirttiğiniz anahtar paket dizininin içindedir. | Ayrı olarak içeri getirdiğiniz anahtarı kullanın. |
step=1 checksum mismatch |
Bir dosya, liste oluşturulduktan sonra değişmiş veya aktarım sırasında hasar görmüştür. | Paketi orijinal medyadan tekrar kopyalayın ve yeniden kontrol edin. |
step=1 files not covered by SHA256SUMS |
Pakete bir dosya eklenmiştir. | Medyayı güvenilmez olarak kabul edin. Ondan kurulum yapmayın. |
step=2 SHA256SUMS signature does not verify |
Sağlama toplamı listesi, elinizdeki sürüm anahtarıyla imzalanmamıştır. | Durun. Bunu güvenlik ekibinize bildirin ve Adverant'tan yeni medya isteyin. |
step=3 image <svc>: ... |
Bir imajın imzası veya SBOM doğrulaması eksiktir ya da doğrulanamamaktadır. | 2. adımda olduğu gibi durun. |
step=4, step=5 |
Chart veya onun imaj listesi birbiriyle tutarlı değildir. | Adverant'tan yeni bir paket isteyin. |
step=6 ... |
Kaynak kodu teklifi eksiktir. | Adverant'tan yeni bir paket isteyin. |
2. ve 3. adımların başarısız olması, tüm tasarımın var olma nedenidir. Bu, dosyaların Adverant'ın imzaladığı dosyalar olmadığı anlamına gelir. Medyayı güvenlik ekibiniz için saklayın.
İmajları kendi kayıt defterinize yükleyin
Düğümleriniz imajları tesis içindeki bir kayıt defterinden çeker. Harrow'unki registry.harrow.example adresidir. Her Nexus imajı o kayıt defterinde nexus/ yolunun altına gider, çünkü chart her imaja <global.imageRegistry>/nexus/<svc>@<digest> olarak başvurur.
cosignaracının oraya gönderim (push) yapabilmesi için normalde kullandığınız araçla kayıt defterinize giriş yapın.- Paket dizininin içinden her imajı yükleyin ve yeni yerinde tekrar doğrulayın:
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, imajla birlikte imzayı ve her doğrulamayı taşır; böylece kayıt defteri kopyası aynı anahtara göre doğrulanır. Kümeniz için önemli olan buradaki doğrulamadır: düğümlerinizin çekeceği şeyin Adverant'ın imzaladığı şey olduğunu kanıtlar.
verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...
Kilit dosyasındaki her imaj bir verified satırı yazdırmalıdır. Eksik bir satır, o imajın yüklemesinin veya kontrolünün başarısız olduğu anlamına gelir ve hatası hemen üstte yazdırılır.
Nexus sürümleri için şeffaflık günlüğü (transparency log) yoktur, bu nedenle her kontrolde --insecure-ignore-tlog=true gereklidir. Sürüm anahtarı tüm güven köküdür. Bu bayrak olmadan cosign, not enough verified log entries from transparency log: 0 < 1 ile reddeder.
Kayıt defterinizden kurun
Dış ağa kapalı bir kurulumun değerler dosyası, bağlantılı bir kurulumunkinden tek bir satırda ayrılır: global.imageRegistry kayıt defterinizi belirtir.
# 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> girdileri, anahtar deposunun kurtarma anahtarlarını elinde tutan kişilerin açık age1... satırlarıdır. Bölüm 2.8, Tek makineli kurulumlar, her birinin bunu nasıl oluşturduğunu açıklar. harrow-ssd, Harrow'un kendi depolama sınıfıdır: kendinizinkini yazın veya kümenin varsayılanını kullanmak için storage.className değerini dışarıda bırakın.
- Bölüm 2.5, nexusctl ile ön kontrol içinde açıklandığı gibi, bu dosyayla kümeye karşı ön kontrolü (preflight) çalıştırın.
- Paketin chart'ından kurulum yapın ve
--waitseçeneğini dışarıda bırakın.
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 bu chart ile kilitlenmeye (deadlock) yol açar: bir kurulum sonrası kancası (post-install hook) her servise veritabanı parolasını verir ve --wait servisler ayağa kalkana kadar kancaları bekletir. Bölüm 2.8, Tek makineli kurulumlar, StatefulSet'leri de bekleyen döngüyü içerir.
nexusctl ile aynı kurulum nexusctl install --context <kube-context> --values harrow-prod-values.yaml şeklindedir.
Chart içindeki hiçbir şey, DNS (Alan Adı Sistemi), belirteç incelemeleri için Kubernetes API'si (uygulama programlama arayüzü) ve varsayılan olarak boş olan networkPolicy.externalEgressCIDRs içinde listelediğiniz herhangi bir adres dışında ad alanının (namespace) dışına çıkmaz. Kurulumdan hiçbir telemetri çıkmaz ve telemetry.enabled, false dışında bir değere ayarlanamaz. İnterneti olmayan bir tesiste YZ (yapay zeka) için kuruluş, ai.localProvider.baseUrl içinde adlandırılan kendi OpenAI uyumlu model sunucusunu tesis içinde bağlar; bölüm 2.14, YZ sağlayıcıları ve modelleri, bu konuyu ele alır.
Lisans bir chart değeri değildir. Aşağıda açıklandığı gibi kurulumdan sonra içe aktarırsınız.
İndirme olmadan k3s ve cert-manager
Nexus kendi oluşturduğunuz bir k3s kümesine kurulacaksa, k3s'in de ağ olmadan kurulması gerekir. Yükleyici disk imajı bunu sizin için yapar (bölüm 2.9, Yükleyici disk imajı). Elle, her düğümde:
- Mimariniz için k3s v1.33.6+k3s1 sürüm dosyalarını karşıya geçirin:
k3sikili dosyası (arm64 üzerindek3s-arm64),install.sh,k3s-airgap-images-<arch>.tar.zstvesha256sum-<arch>.txt. k3s bu dosyalar için sağlama toplamları yayımlar ancak imza yayımlamaz. Her dosyayısha256sum-<arch>.txtdosyasına göre kontrol edin ve güvenlik ekibinize bunun bir imza değil, aynı kaynaktan gelen bir sağlama toplamı olduğunu açıkça belirtin. - İkili dosyayı ve sistem imajlarını k3s'in aradığı yere koyun ve indirmeler kapalı olarak kurun:
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 bir ön koşuldur: chart'ın kendi CA'sı (sertifika yetkilisi) bir cert-manager yayıncısıdır (issuer). cert-manager'ın chart'ını, cert-manager-v1.21.3.tgz dosyasını ve imajlarını karşıya geçirin. Bağlantılı tarafta, imajlar karşıya geçmeden önce bunları cert-manager projesinin kendi anahtarıyla kontrol edin:
cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
--key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>Tesis içinde, imajları cert-manager chart'ının istediği adlar (quay.io/jetstack/cert-manager-<name>:v1.21.3) altında her düğümün kapsayıcı deposuna içe aktarın, ardından kontrol edip kurun:
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 cert-manager için doğrudur. Buna sahip olmaması gereken yalnızca Nexus'tur.
Güncellemeler ve yeni parçalar imzalı medyada gelir
Dış ağa kapalı bir tesis, yükseltmeyi de bir diskten yapar. Konsolda, Bu kurulum sayfalarındaki Medyadan içe aktar, tesise taşınan bir diskten bir sürümü yükler. Her dosyanın sağlama toplamını, ardından imzayı diskin getirdiği bir anahtara göre değil tesiste zaten kurulu olan sürüm anahtarına göre ve sonrasında sürümün çalışan sürümden daha yeni olup olmadığını kontrol eder. İçe aktarma işlemi yalnızca kopyalar ve kontrol eder. İnsanlar çalışan sürüm üzerinde çalışmaya devam eder ve siz yükseltmeyi seçene kadar hiçbir şey değişmez.
Komut satırından aynı sürüm nexusctl ile içeri alınır:
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 nelerin değişeceğini gösterir ve hiçbir şeyi değiştirmez. apply önce bir yedek alır ve ardından yükseltir. Bölüm 2.15, İkinci gün: Nexus'u işletmek, yükseltmeleri tüm ayrıntılarıyla ele alır.
Bir diskin imzası eşleşmediğinde, içe aktarma işlemi MEDIA_SIGNATURE_INVALID ile reddedilir. Hiçbir şey yüklenmez veya içeri kopyalanmaz ve çalışan sürüm çalışmaya devam eder. Sayfa, hangi kontrollerin geçtiğini, nerede durduğunu ve bulduğu anahtarın yanında beklediği anahtarı belirtir. Diski güvenlik ekibiniz için saklayın ve Adverant'tan yeni bir tane isteyin.
Bir lisansın etkinleştirdiği Enterprise parçaları da dış ağa kapalı bir tesiste aynı yoldan gelir: siz onları etkinleştirmeden önce, sürüm diskinde, Medyadan içe aktar aracılığıyla. Her parça etkinleştirilmeden önce Adverant sürüm anahtarına göre kontrol edilir, böylece kümeye asla elle bir ikili dosya kopyalamazsınız.
İnternet olmadan lisanslar
Bağlantılı bir kurulum lisansını kendi kendine alır. Dış ağa kapalı bir kurulum ise çevrimdışı değişim aracılığıyla Adverant ile elle dosya alışverişi yapar.
- Konsolun lisans sayfaları küçük bir lisans istek dosyası oluşturur. Adverant'ın hangi kurulumun istekte bulunduğunu anlayabilmesi için kurulum bunu kendi anahtarıyla imzalar.
- Birisi dosyayı bir USB bellekle çevrimiçi olan bir bilgisayara taşır,
https://account.adverant.aiadresindeki Adverant hesabına giriş yapar ve Çevrimdışı değişim sayfasına yükler. - Lisans dosyasını aynı yolla geri getirirler.
- İçe aktarın. Konsolda, Lisans ve açtığı özellikler sayfasını açın ve Yeni bir lisans içe aktar düğmesine basın. Komut satırından:
nexusctl licence import harrow-port-licence.jsonLisans, tesis içinde çevrimdışı olarak Adverant'ın anahtarlarına göre kontrol edilir. Adverant her lisansı iki bağımsız anahtarla imzalar ve her iki imzanın da doğrulanması gerekir.
Aynı değişim, yıllık kullanım bildirimini dışarı taşır. Yalnızca sayaçları (koltuklar, cihazlar, özellik grupları) barındırır ve yönetici, dışarı çıkmadan önce Adverant için kullanım bildirimi üzerinde bunu satır satır okur.
| Kod | Durum | Anlamı |
|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Dosya Adverant'ın imzaladığı bir lisans değildir veya imzalandıktan sonra bir bayt değişmiştir. Hiçbir şey değişmez. |
LICENCE_OTHER_INSTALLATION |
409 | Lisans gerçektir ancak başka bir kurulum için düzenlenmiştir. Bu kurulumun kimliği (id) için düzenlenmiş bir lisans isteyin. |
LICENCE_CLOCK_BEHIND_FLOOR |
409 | Saat, bu kurulumun gördüğü en son zamandan daha eski bir zamanı göstermektedir. Saati geri almak süresi dolmuş bir lisansı yeniden canlandırmaz. |
LICENCE_REVOKED |
403 | Adverant, imzalı bir iptal işlemiyle lisansı geri çekmiştir. Enterprise parçalarının sunulması durdurulur; Community ve dışa aktarma kalır. |
Bölüm 2.13, Lisanslar, durumları, ek süreyi ve yenilemeyi ele alır.
İptal listeleri elle içe aktarılır
Adverant bir lisansı geri çektiğinde, imzalı bir iptal listesi yayımlar. Liste kümülatiftir: her biri kendisinden önce geri çekilen tüm lisansları taşır. Bağlantılı bir kurulum bunu öğrenir. Dış ağa kapalı bir kurulum ise yalnızca birisi listeyi içe aktardığında öğrenir; bu nedenle en son listeyi her sürüm diskiyle birlikte içeri taşıyın ve lisans sayfalarındaki kurulumun iptalleri içe aktarma özelliği veya oturum açma ana bilgisayarındaki /api/v1/installation/licence/revocations adresi aracılığıyla içe aktarın.
Bu durum iki yönlü işler. Hiçbir zaman bir liste içe aktarmayan dış ağa kapalı bir kurulum, daha sonra ele geçirildiği anlaşılan bir anahtarla imzalanmış bir lisans da dahil olmak üzere, bir lisansın iptal edildiğini asla öğrenemez. Listeyi içe aktarmak, bu haberin boşluğu aşmasının tek yoludur.
Egemen mühürlü paket: nexus-airgap
Bazı egemen (sovereign) tesisler, bir sürümü kendi manifest'i ağ erişimini yasaklayan tek bir mühürlü, imzalı dosya olarak ister. Onlar için ikinci bir biçim olan mühürlü paket ve bunun @adverant/nexus-sovereign paketinden gelen nexus-airgap aracı vardır. Aracı, kontrol edeceği herhangi bir paketten ayrı olarak Adverant'ın paket kayıt defterinden kurun. Bir paket kendi kendine kefil olamaz.
Mühürlü paket, imzalı tek bir tarball dosyasıdır. Manifest'i Ed25519 ile imzalanmıştır ve her dosya için bir SHA-256 listeler. Aracın dört eylemi (verb) vardır.
| Eylem | Yaptığı iş |
|---|---|
nexus-airgap bundle |
Hazırlanmış bir dizinden mühürlü bir paket oluşturur ve manifest'ini imzalar. |
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> |
İmzayı güvenilen anahtara göre kontrol eder, her dosyanın özetini (hash) yeniden hesaplar, manifest'in listelemediği tüm dosyaları reddeder ve ağ kuralı yalnızca yerel aracı (agent) trafiğine sahip boş izin listesi olmayan bir paketi reddeder. Hiçbir şeyi değiştirmez. |
nexus-airgap install |
Doğrular, ardından kurulum planını sırasıyla gerçekleştirir: imajları yükle, manifest'leri uygula, geçişleri (migration) çalıştır, becerileri (skills) ekle, anahtarları sağla. |
nexus-airgap open |
Paketin isteğe bağlı şifreli dışa aktarımını tesisin kendi anahtar sorumlusuyla açar; bu, dış ağa kapalı bir tesiste makinenin TPM (Güvenilir Platform Modülü) yongasıdır. |
Her şeyden önce doğrulayın:
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, doğrulanmış, paketten çıkarılmış kopyayı tutar ve çıktıda stagingDir olarak adlandırır; böylece kontrol edilen şey üzerinden çalışırsınız.
Doğrulama BUNDLE_INTEGRITY_VIOLATION ile başarısız olursa, paketin içindeki bir dosya imzalandıktan sonra değişmiştir. Orada durun. Aracın, listelenmeyen dosyalar için kontrolü atlayan bir --no-strict anahtarı vardır. Bunu bir sürüm üzerinde kullanmayın.
Bir sonraki diskin geldiği gün
Tomás nizamiye dolabının içine bantlanmış kısa bir kontrol listesi tutar ve bunu kopyalamaya değer. Tar dosyasının .sha256 değerini kontrol edin. Kurulu anahtarla verify-bundle.sh betiğini çalıştırın ve son satırı okuyun. En yeni iptal listesini içe aktarın. Ondan sonra ve yalnızca ondan sonra, sürümü medyadan içe aktarın ve yükseltmeyi planlayın. Bu adımlardan herhangi birinde başarısız olan bir disk, güvenlik ekibi için etiketlenmiş olarak zarfına geri döner ve ağda hiçbir şey değişmemiş olur.


