Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.10

Suiteáil le bearna aeir

Iompair beart as líne sínithe isteach i suíomh gan aon idirlíon, fíoraigh é i gcoinne eochrach a thug tú isteach ar leithligh, lódáil isteach i do chlárlann féin é agus suiteáil é. Trasnaíonn ceadúnais, nuashonruithe agus liostaí cúlghairme an bhearna de láimh freisin.

d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

19 nóiméad le léamh

Níl aon bhealach chuig an idirlíon ag líonra oibríochtaí Harrow Port Authority, de réir dlí agus de réir dearaidh. Tá trácht árthaí, pleananna calaíochta agus coinneálacha custaim ar fad air, agus ní ceadaítear d'aon rud air glaoch amach. Nuair a shuiteáil Tomás Reilly Nexus ann, tháinig gach beart ar dhiosca a thug cúiréir go dtí teach an gheata, agus seiceáladh gach beart laistigh den láithreán sular bhain aon rud úsáid as.

Is í an tsuiteáil sin an chaibidil seo. Faigheann tú beart as líne sínithe, seiceálann tú é le heochair a shroich thú ar bhealach eile, cóipeálann tú a chuid íomhánna isteach i do chlárlann féin, seiceálann tú arís ann iad, agus suiteálann tú an chairt le hainm do chlárlainne sna luachanna. Ansin tagann na rudaí a dhéanann láithreán aerbhearnaithe de láimh a fhaigheann láithreán ceangailte saor in aisce: k3s agus cert-manager gan íoslódáil, nuashonruithe ar mheáin, ceadúnais trí mhalartú as líne, agus liostaí cúlghairme a iompórtálann tú féin.

Ar chlé, coinníonn bosca "an taobh ceangailte" "downloads.adverant.ai" agus "do chuntas Adverant". Trasnaíonn dhá shaighead ar leith líne ingearach thiubh dar lipéad "an bhearna". Iompraíonn an tsaighead uachtarach, dar lipéad "uair amháin, ar bhealach ar leith; méarlorg seiceáilte lasmuigh den bhanda", "release.pub". Iompraíonn an tsaighead íochtarach, dar lipéad "gach eisiúint, ar dhiosca", "nexus-alpha-1.0.0-alpha.1-enterprise.tar". Ar dheis, laistigh de "líonra oibríochtaí Harrow", sroicheann an dá cheann bosca "verify-bundle.sh: VERIFY-BUNDLE PASS", a théann chuig "registry.harrow.example (cosign load, cosign verify)" agus ansin chuig "an braisle (helm install)".
Conas a thrasnaíonn eisiúint agus a muinín an bhearna ar dhá bhealach ar leith.

Cad atá sa bheart as líne

Is eagrán amháin d'eisiúint amháin é beart, mar tar neamhchomhbhrúite le comhad suime seiceála lena thaobh: nexus-alpha-1.0.0-alpha.1-enterprise.tar agus nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Tá bearta Community poiblí ar downloads.adverant.ai. Tagann bearta Enterprise ó do chuntas Adverant ag https://account.adverant.ai, taobh le do cheadúnas, agus ní thagann siad go anaithnid riamh.

Nuair atá sé díphacáilte, is mar seo a bhreathnaíonn sé:

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

Is é gach comhadlann images/<svc>/ an rud a scríobhann cosign save. Coinníonn sé innéacs na híomhá agus an dá íomhá ardáin, linux/amd64 agus linux/arm64, leis an síniú cosign, fianaise SPDX SBOM (liosta ábhar bogearraí) do gach ardán agus fianaise foinse, iad uile déanta le heochair eisiúna Adverant. Luíonn na SBOManna céanna in sbom/ mar ghnáthchomhaid, ionas gur féidir le foireann slándála iad a léamh gan cosign.

Cuimsíonn an tsraith sonraí bogearraí cóipchlé: PostgreSQL le PostGIS, agus Neo4j Community Edition i measc nithe eile. Iompraíonn an beart foinse gach íomhá de chuid na sraithe sonraí a sheolann sé, agus deir release/source-offer.json é sin do gach íomhá. Ní thógtar beart a sheolfadh dénártha cóipchlé gan a fhoinse.

Ainmníonn release/facts.json an eisiúint, an t-eagrán, na hailtireachtaí agus méarlorg na heochrach eisiúna ar síníodh an beart léi, mar sha256:<hex>.

Taistealaíonn an eochair phoiblí ar leithligh

Ní bhíonn an eochair a sheiceálann é sa bheart riamh. D'fhéadfadh aon duine beart a d'iompraigh a eochair féin a athsholáthar, an eochair agus gach rud eile, agus d'éireodh le gach seiceáil fós. Diúltaíonn an script fíoraithe d'eochair atá laistigh de chomhadlann an bhirt.

Faigh eochair phoiblí na heisiúna uair amháin, ar mheaisín ceangailte, ó https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Sábháil í mar release.pub. Is é a méarlorg ná SHA-256 an chomhaid:

sha256sum release.pub

Cuir é sin i gcomparáid leis an méarlorg a fhoilsíonn Adverant, agus leis an gceann sna nótaí eisiúna a fuair tú trí chainéal ar leith. Tá na sonraí i gCaibidil 2.4, Eisiúint a fháil agus a fhíorú. Ansin tabhair release.pub isteach sa láithreán, ar bhealach difriúil ón mbeart más féidir leat, agus coinnigh ann í. Coinníonn foireann Thomáis í ar chomhroinn comhad an líonra oibríochtaí le nóta faoin dáta a tháinig sí isteach. Seiceáiltear gach eisiúint níos déanaí in aghaidh na heochrach suiteáilte sin, agus ní sheiceáiltear riamh í in aghaidh aon rud a thugann diosca leis.

Fíoraigh an beart

Is é verify-bundle.sh an script a sheiceálann beart, a fhoilsítear le gach eisiúint.Ritheann íomhá diosca an tsuiteálaí an script chéanna ar an gcéad tosú. Teastaíonn cosign v3, helm v4, agus sha256sum nó shasum uaidh. Ní léann sé aon rud ó aon líonra agus ní theastaíonn Python uaidh, mar sin ritheann sé ar nód suiteálaí lom chomh maith le stáisiún oibre.

  1. Seiceáil an tar in aghaidh a shuime seiceála, ansin díphacáil é:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar
  1. Rith an fíorú leis an eochair a thug tú isteach:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pub

Ainmníonn tríú argóint comhad luachanna le haghaidh seiceálacha na cairte. Gan é, úsáideann an script docs/example-values.yaml an bhirt.

  1. Léigh an líne dheireanach, nach mór a bheith ina VERIFY-BUNDLE PASS sula dtéann tú níos faide.
  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>

Stopann an script ag an gcéad seiceáil a theipeann. Seo a dhéanann gach ceann acu.

Céim An rud a sheiceálann sé
1 Meaitseálann gach comhad atá liostaithe in SHA256SUMS a shuim sheiceála, agus níl aon chomhad i láthair a fhágann an liosta ar lár. Teipeann ar chomhad breise curtha isteach chomh cinnte is a theipeann ar cheann athraithe.
2 Is síniú bailí é SHA256SUMS.sigstore.json thar SHA256SUMS ag an eochair a thug tú. Le céimeanna 1 agus 2 le chéile, is é gach beart sa bheart an beart a shínigh Adverant.
3 Do gach comhadlann íomhá: tá díolaim innéacs na híomhá in release/images.lock.json; tá síniú cosign ann arb é an díolaim chruinn sin a ábhar, agus fíoraíonn sé in aghaidh d'eochrach; éiríonn le cosign verify agus cosign verify-attestation --type spdxjson araon ar an leagan amach sábháilte.
4 Éiríonn le helm lint --strict ar an gcairt leis na luachanna samplacha, nó le do chuid luachanna féin.
5 Sábháiltear gach íomhá sa ghlas in images/, agus is díolaim sa ghlas í gach íomhá a rindreálann an chairt. Ní thagann aon rud a shuiteálann an chairt ó aon áit eile.
6 Nuair a choinníonn an glas íomhánna sraithe sonraí, bíonn release/source-offer.json iomlán, ainmníonn sé gach ceann acu, agus bíonn gach comhad foinse a liostaíonn sé i láthair leis an tsuim sheiceála cheart.

Seiceálann Céim 3 an síniú féin, de réir díolama, chomh maith le cosign verify a rith. Is é an chúis atá leis ná iompar cosign féin: scoireann cosign verify ar leagan amach sábháilte le 0 freisin nuair nach gcoinníonn an leagan amach ach fianaise ón eochair agus gan aon síniú ann. Ní ghlacann an script leis sin.

Má theipeann air seo

Críochnaíonn teip le VERIFY-BUNDLE FAIL step=<k> <why>.

An líne dheireanach Cad is brí leis Cad ba cheart a dhéanamh
step=0 the public key must come from outside the bundle Tá an eochair a d'ainmnigh tú laistigh de chomhadlann an bhirt. Úsáid an eochair a thug tú isteach ar leithligh.
step=1 checksum mismatch Athraíodh comhad tar éis an liosta a dhéanamh, nó rinneadh damáiste dó faoi bhealach. Cóipeáil an beart arís ón meán bunaidh agus seiceáil arís é.
step=1 files not covered by SHA256SUMS Cuireadh comhad leis an mbeart. déileáil leis an meán mar rud neamhiontaofa. Ná suiteáil uaidh.
step=2 SHA256SUMS signature does not verify Níl liosta na suimeanna seiceála sínithe ag an eochair eisiúna atá agat. Stop. Tuairiscigh do d'fhoireann slándála é agus iarr meáin nua ar Adverant.
step=3 image <svc>: ... Tá síniú íomhá nó fianaise SBOM ar iarraidh nó ní fhíoraíonn sé. Stop, mar an gcéanna le céim 2.
step=4, step=5 Ní thagann an chairt nó a liosta íomhánna le chéile. Iarr beart nua ar Adverant.
step=6 ... Tá an tairiscint foinse neamhiomlán. Iarr beart nua ar Adverant.

Is é teip ar chéimeanna 2 agus 3 an cás ar a bhfuil an dearadh ar fad bunaithe. Ciallaíonn sé nach iad na comhaid na cinn a shínigh Adverant. Coinnigh an meán do d'fhoireann slándála.

Lódáil na híomhánna isteach i do chlárlann féin

Tarraingíonn do nóid íomhánna ó chlárlann laistigh den láithreán. Is é registry.harrow.example ceann Harrow. Téann gach íomhá Nexus faoin gcosán nexus/ sa chlárlann sin, toisc go dtagraíonn an chairt do gach íomhá mar <global.imageRegistry>/nexus/<svc>@<digest>.

  1. Logáil isteach i do chlárlann leis an uirlis a úsáideann tú de ghnáth, ionas gur féidir le cosign brú chuici.
  2. Ó thaobh istigh de chomhadlann an bhirt, lódáil gach íomhá agus fíoraigh arís í ina baile nua:
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"
done

Iompraíonn cosign load an síniú agus gach fianaise mar aon leis an íomhá, ionas go bhfíoraíonn cóip na clárlainne in aghaidh na heochrach céanna. Is é an fíorú anseo an ceann is tábhachtaí do do bhraisle: cruthaíonn sé gurb é an rud a tharraingeoidh do nóid ná an rud a shínigh Adverant.

verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...

Ba cheart go bpriontálfadh gach íomhá sa ghlas líne verified amháin. Ciallaíonn líne ar iarraidh gur theip ar lódáil nó ar sheiceáil na híomhá sin, agus priontáiltear a hearráid díreach os a chionn.

Níl aon loga trédhearcachta ann d'eisiúintí Nexus, mar sin tá --insecure-ignore-tlog=true ag teastáil ar gach seiceáil. Is í an eochair eisiúna an fhréamh iontaoibhe ar fad. Gan an bhratach, diúltaíonn cosign le not enough verified log entries from transparency log: 0 < 1.

Suiteáil ó do chlárlann

Tá difríocht idir an comhad luachanna le haghaidh suiteála aerbhearnaithe agus ceann ceangailte in aon líne amháin: ainmníonn global.imageRegistry do chlárlann.

# 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>"

Is iad na hiontrálacha <custodian-...-age-recipient> na línte poiblí age1... de chuid na ndaoine a choinníonn eochracha athshlánaithe an stóir eochracha. Míníonn Caibidil 2.8, Suiteálacha aon-mheaisín, conas a dhéanann gach duine ceann. Is é harrow-ssd aicme stórála Harrow féin: cuir isteach do cheann féin, nó fág storage.className ar lár chun réamhshocrú an bhraisle a úsáid.

  1. Rith réamhsheiceáil in aghaidh an bhraisle leis an gcomhad seo, mar a thuairiscíonn caibidil 2.5, Réamhsheiceáil le nexusctl.
  2. Suiteáil ó chairt an bhirt, agus fág --wait ar lár.
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=900s

Téann helm install --wait i bhfostú leis an gcairt seo: tugann crúca iar-shuiteála a phasfhocal bunachair sonraí do gach seirbhís, agus coinníonn --wait na crúcaí siar go dtí go mbíonn na seirbhísí ag obair. Tá an lúb a fhanann leis na StatefulSets freisin i gCaibidil 2.8, Suiteálacha aon-mheaisín.

Le nexusctl, is é nexusctl install --context <kube-context> --values harrow-prod-values.yaml an tsuiteáil chéanna.

Ní shroicheann aon rud sa chairt lasmuigh den spás ainmneacha ach amháin DNS (Domain Name System), an Kubernetes API (comhéadan clárúcháin feidhmchlár) le haghaidh athbhreithnithe ar chomharthaí, agus aon seoladh a liostaíonn tú in networkPolicy.externalEgressCIDRs, atá folamh de réir réamhshocraithe. Ní fhágann aon teiliméadracht an tsuiteáil, agus ní féidir telemetry.enabled a shocrú go haon rud ach false. Maidir le AI (intleacht shaorga) ar láithreán gan idirlíon, ceanglaíonn an eagraíocht a freastalaí samhla féin atá comhoiriúnach le OpenAI laistigh den láithreán, atá ainmnithe in ai.localProvider.baseUrl; clúdaíonn caibidil 2.14, Soláthraithe agus samhlacha AI, é.

Ní luach cairte é an ceadúnas. Iompórtálann tú é tar éis na suiteála, mar a thuairiscítear thíos.

k3s agus cert-manager gan íoslódáil

Má tá Nexus ag dul ar bhraisle k3s a thógann tú féin, caithfidh k3s suiteáil gan líonra freisin. Déanann íomhá diosca an tsuiteálaí é seo duit (caibidil 2.9, Íomhá diosca an tsuiteálaí). De láimh, ar gach nód:

  1. Tabhair anonn comhaid eisiúna k3s v1.33.6+k3s1 do d'ailtireacht: an dénártha k3s (k3s-arm64 ar arm64), install.sh, k3s-airgap-images-<arch>.tar.zst agus sha256sum-<arch>.txt. Foilsíonn k3s suimeanna seiceála do na comhaid seo agus ní fhoilsíonn sé aon síniú. Seiceáil gach comhad in aghaidh sha256sum-<arch>.txt, agus bí soiléir le d'fhoireann slándála gur suim sheiceála ón bhfoinse chéanna é seo, ní síniú.
  2. Cuir an dénártha agus íomhánna an chórais san áit a lorgaíonn k3s iad, agus suiteáil agus íoslódálacha múchta:
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=600s

Is réamhriachtanas é cert-manager v1.21.3: is eisitheoir cert-manager é CA (údarás deimhniúcháin) na cairte féin. Tabhair anonn cairt cert-manager, cert-manager-v1.21.3.tgz, agus a cuid íomhánna. Ar an taobh ceangailte, seiceáil na híomhánna le heochair thionscadal cert-manager féin sula dtrasnaíonn siad:

cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
  --key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>

Laistigh den láithreán, iompórtáil na híomhánna isteach i stór coimeádán gach nóid faoi na hainmneacha a iarrann cairt cert-manager, quay.io/jetstack/cert-manager-<name>:v1.21.3, ansin seiceáil iad agus suiteáil:

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

Tá --wait ceart do cert-manager. Is é Nexus amháin nach ceadmhach dó é a bheith aige.

Tagann nuashonruithe agus codanna nua ar mheáin shínithe

Uasghrádaíonn láithreán aerbhearnaithe ó dhiosca freisin. Sa chonsól, lódálann Iompórtáil ó mheáin ar leathanaigh An tsuiteáil seo eisiúint ó dhiosca a tugadh isteach sa láithreán. Seiceálann sé suim sheiceála gach comhaid, ansin an síniú in aghaidh na heochrach eisiúna atá suiteáilte ar an láithreán cheana féin, ní eochair a thugann an diosca riamh, agus ansin go bhfuil an eisiúint níos nuaí ná an ceann atá ag rith. Ní dhéanann iompórtáil ach cóipeáil agus seiceáil amháin. Leanann daoine orthu ag obair ar an eisiúint atá ag rith, agus ní athraíonn aon rud go dtí go roghnaíonn tú uasghrádú.

Iompórtáil ó mheáin (gan idirlíon)
Iompórtáil ó mheáin (gan idirlíon)
Eisiúint ar dhiosca á hiompórtáil ag Harrow. Seiceáiltear an síniú in aghaidh na heochrach atá suiteáilte ar an láithreán, agus fanann an leagan atá ag rith gan teagmháil go dtí go n-uasghrádaíonn duine éigin.

Ó líne na n-orduithe, téann an eisiúint chéanna isteach le 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.tar

Taispeánann plan cad a athróidh agus ní athraíonn sé aon rud. Glacann apply cúltaca ar dtús agus ansin uasghrádaíonn sé. Clúdaíonn Caibidil 2.15, Lá a dó: Nexus a oibriú, uasghráduithe go hiomlán.

Nuair nach meaitseálann síniú diosca, diúltaítear don iompórtáil le MEDIA_SIGNATURE_INVALID. Ní lódáiltear ná ní chóipeáiltear aon rud isteach, agus coinníonn an eisiúint atá ag rith uirthi ag rith. Deir an leathanach cé na seiceálacha ar éirigh leo, cá háit ar stop sé, agus an eochair a raibh sé ag súil léi taobh leis an eochair a fuair sé. Coinnigh an diosca do d'fhoireann slándála agus iarr ceann nua ar Adverant.

Theip ar iompórtáil ó mheáin
Theip ar iompórtáil ó mheáin
Iompórtáil diúltaithe. Mheaitseáil gach suim sheiceála, ach rinne eochair anaithnid an síniú, mar sin níor lódáladh aon rud agus fágadh an eisiúint a bhí ag rith mar a bhí.

Tagann na codanna Enterprise a chuireann ceadúnas ar siúl ar an mbealach céanna ar láithreán aerbhearnaithe: ar an diosca eisiúna, trí Iompórtáil ó mheáin, sula gcuireann tú ar siúl iad. Seiceáiltear gach cuid in aghaidh eochair eisiúna Adverant sula gcuirtear ar siúl í, ionas nach gcóipeálann tú dénártha isteach sa bhraisle de láimh riamh.

Ceadúnais gan idirlíon

Faigheann suiteáil cheangailte a ceadúnas as a stuaim féin. Malartaíonn ceann aerbhearnaithe comhaid le Adverant de láimh, tríd an malartú as líne.

  1. Déanann leathanaigh cheadúnais an chonsóil comhad beag iarratais ar cheadúnas. Síníonn an tsuiteáil é lena heochair féin, ionas gur féidir le Adverant a rá cén tsuiteáil a d'iarr.
  2. Tugann duine éigin an comhad amach ar bhata USB chuig ríomhaire atá ar líne, síníonn sé isteach sa chuntas Adverant ag https://account.adverant.ai, agus uaslódálann sé é ar an leathanach Malartú as líne.
  3. Tugann siad comhad an cheadúnais ar ais ar an mbealach céanna.
  4. Iompórtáil é. Sa chonsól, oscail Ceadúnas agus an rud a dhíghlasálann sé agus brúigh Iompórtáil ceadúnas nua. Ó líne na n-orduithe:
nexusctl licence import harrow-port-licence.json

Seiceáiltear an ceadúnas as líne, laistigh den láithreán, in aghaidh eochracha Adverant. Síníonn Adverant gach ceadúnas le dhá eochair neamhspleácha, agus caithfidh an dá shíniú fíorú.

Malartú as líne
Malartú as líne
An leathanach Malartú as líne sa chuntas Adverant, áit a dtéann comhad iarratais sínithe suas agus a dtagann comhad ceadúnais ar ais.

Tugann an malartú céanna an ráiteas úsáide bliantúil amach. Ní choinníonn sé ach áireamháin (suíocháin, gléasanna, grúpaí gnéithe), agus léann an riarthóir é líne ar líne ar Ráiteas úsáide do Adverant sula bhfágann sé.

Cód Stádas Cad is brí leis
LICENCE_SIGNATURE_INVALID 422 Ní ceadúnas é an comhad a shínigh Adverant, nó athraíodh beart tar éis a shínithe. Ní athraíonn aon rud.
LICENCE_OTHER_INSTALLATION 409 Tá an ceadúnas fíor ach eisíodh é do shuiteáil eile. Iarr ceann a eisíodh le haghaidh id na suiteála seo.
LICENCE_CLOCK_BEHIND_FLOOR 409 Léann an clog níos luaithe ná an t-am is déanaí a chonaic an tsuiteáil seo. Ní athbheochan ceadúnas atá imithe in éag an clog a chur siar.
LICENCE_REVOKED 403 Tharraing Adverant an ceadúnas siar le cúlghairm shínithe. Stopann codanna Enterprise de bheith á dtairiscint; fanann Community agus easpórtáil.

Clúdaíonn Caibidil 2.13, Ceadúnais, stáit, tréimhse chairde agus athnuachan.

Iompórtáiltear liostaí cúlghairme de láimh

Nuair a tharraingíonn Adverant ceadúnas siar, foilsíonn sé liosta cúlghairme sínithe. Tá an liosta carnach: iompraíonn gach ceann gach ceadúnas a tarraingíodh siar roimhe. Foghlaimíonn suiteáil cheangailte faoi. Ní fhoghlaimíonn ceann aerbhearnaithe ach amháin nuair a iompórtálann duine éigin an liosta, mar sin tabhair an liosta is déanaí isteach le gach diosca eisiúna agus iompórtáil é trí iompórtáil chúlghairmeacha na suiteála ar leathanaigh an cheadúnais, nó an seoladh /api/v1/installation/licence/revocations ar an óstach sínithe isteach.

Oibríonn sé seo ar an dá bhealach. Ní fhoghlaimíonn suiteáil aerbhearnaithe nach n-iompórtálann liosta riamh gur cúlghairmeadh ceadúnas, lena n-áirítear ceadúnas arna shíniú ag eochair a fuarthas amach níos déanaí go raibh sí i gcontúirt. Is é iompórtáil an liosta an t-aon bhealach a thrasnaíonn an nuacht sin an bhearna.

An beart séalaithe ceannasach: nexus-airgap

Teastaíonn eisiúint ó roinnt láithreán ceannasach mar aon chomhad amháin séalaithe, sínithe adtoirmisceann a léiriú féin rochtain líonra. Dóibh siúd tá an dara formáid ann, an beart séalaithe, agus a uirlis, nexus-airgap, ón bpacáiste @adverant/nexus-sovereign. Suiteáil an uirlis ó chlárlann pacáistí Adverant, ar leithligh ó aon bheart a sheiceálfaidh sí. Ní féidir le beart seasamh dó féin.

Is tarball aonair sínithe é an beart séalaithe. Sínítear a léiriú le Ed25519 agus liostaíonn sé SHA-256 do gach comhad. Tá ceithre bhriathar ag an uirlis.

Briathar An méid a dhéanann sé
nexus-airgap bundle Tógann sé beart séalaithe ó chomhadlann ullmhaithe agus síníonn sé a léiriú.
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> Seiceálann sé an síniú in aghaidh na heochrach iontaofa, déanann sé ath-hais ar gach comhad, diúltaíonn sé d'aon chomhad nach liostaíonn an léiriú, agus diúltaíonn sé do bheart nach é a riail líonra an liosta ceadaithe folamh le trácht gníomhaire logánta amháin. Ní athraíonn sé aon rud.
nexus-airgap install Fíoraíonn sé, ansin cuireann sé an plean suiteála i gcrích in ord: lódáil na híomhánna, cuir na léirithe i bhfeidhm, rith na haistrithe, síol na scileanna, soláthair na heochracha.
nexus-airgap open Osclaíonn sé easpórtáil chriptithe roghnach an bhirt le coimeádaí eochrach an láithreáin féin, arb é slis TPM (Trusted Platform Module) an mheaisín é ar láithreán aerbhearnaithe.

Fíoraigh roimh aon rud eile:

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

Coinníonn --keep-staging an chóip fhíoraithe, dhíphacáilte agus ainmníonn sé mar stagingDir í san aschur, ionas go n-oibríonn tú ón rud a seiceáladh.

Má theipeann ar fhíorú le BUNDLE_INTEGRITY_VIOLATION, athraíodh comhad laistigh den bheart tar éis a shínithe. Stop ansin. Tá lasc --no-strict ag an uirlis a scipeálann an tseiceáil le haghaidh comhad neamhliostaithe. Ná húsáid ar eisiúint é.

An lá a thagann an chéad diosca eile

Coinníonn Tomás seicliosta gairid greamaithe le téip taobh istigh de chaibinéad theach an gheata, agus is fiú cóip a dhéanamh de. Seiceáil .sha256 an tar. Rith verify-bundle.sh leis an eochair shuiteáilte agus léigh an líne dheireanach. Iompórtáil an liosta cúlghairme is nuaí. Ansin, agus ansin amháin, iompórtáil an eisiúint ó mheáin agus pleanáil an t-uasghrádú. Téann diosca a theipeann ar aon cheann de na céimeanna seo ar ais ina chlúdach, lipéadaithe, don fhoireann slándála, agus níor athraigh aon rud ar an líonra.