Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.8

Suiteálacha aon mheaisín amháin

Suiteáil Nexus ar fhreastalaí Linux amháin le nexusctl, nó déan meastóireacht air ar ríomhaire glúine le k3d, agus bain an consól amach thar HTTPS ionas go n-oibreoidh síniú isteach agus eochracha pas.

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

18 nóiméad le léamh

Sular chuir Harrow Port Authority Nexus ar a bhraisle táirgeachta, bhí dhá shuiteáil ní ba lú uaidh ag Tomás Reilly. Suiteáil phíolótach ar fhreastalaí Linux spártha i bhfoirgneamh na n-oibríochtaí ab ea ceann acu, don dáréag a bhainfeadh triail as ar dtús. Rith an ceann eile ar a ríomhaire glúine féin, ionas go bhféadfadh sé rudaí a bhriseadh gan aon duine á thabhairt faoi deara. Clúdaíonn an chaibidil seo an dá cheann. Úsáideann siad an chairt chéanna, na híomhánna céanna agus an chéad rith céanna le suiteáil iomlán Kubernetes, mar sin aistríonn an méid a fhoghlaimíonn tú ar mheaisín amháin go dtí ceann eile.

Aon ordú amháin atá i gcosán an fhreastalaí: tógann nexusctl install --single-node braisle k3s ar an meaisín, suiteálann sé cert-manager agus ansin suiteálann sé Nexus. Tá cosán an ríomhaire ghlúine níos praiticiúla. Tógann tú braisle k3d tú féin, suiteálann tú cert-manager agus an chairt le Helm, agus ansin déanann tú post breise amháin a chuireann as do bheagnach gach duine: cuireann tú an consól taobh thiar de HTTPS ar do mheaisín féin, toisc nach féidir le port-forward simplí aon duine a shíniú isteach riamh.

Cé chomh mór agus a chaithfidh an meaisín a bheith

Iarrann Nexus thart ar 2.05 croíleacán CPU (láraonad próiseála) agus 6.7 GiB de chuimhne in iarratais le réamhshocruithe na cairte, agus is ionann a imleabhair agus 142 GiB san iomlán. Is é an t-iomlán sin ná PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, an stór réad 50, an dá stór OpenBao 1 agus 5, agus imleabhar na n-admhálacha 1. Is éard atá in iarratais ná an méid a chuireann an sceidealóir in áirithe, agus bíonn an fhíor-úsáid níos airde nuair a bhíonn daoine ag obair.

Meaisín CPU Cuimhne (RAM, cuimhne randamrochtana) Diosca
Nód aonair molta 8 vCPU 32 GiB 250 GB SSD (tiomántán soladstaide)
Íosmhéid le haghaidh meastóireachta 4 vCPU 16 GiB 200 GB

Rithfidh ríomhaire glúine a chomhlíonann íosmhéid na meastóireachta Nexus, ach is í teorainn chuimhne Docker féin a chomhaireann, ní ceann an ríomhaire ghlúine. Tabhair 16 GiB ar a laghad do Docker sula dtosaíonn tú.

Teastaíonn Kubernetes 1.33 nó níos déanaí ón dá chosán. Tugann cosán an nóid aonair a cheann féin leis: k3s v1.33.6+k3s1, an dáileadh a ndéantar gach eisiúint a thástáil air.

Cuid a haon: freastalaí Linux amháin le nexusctl

Is meaisín 8-chroíleacán é freastalaí píolótach Thomáis le 32 GiB de chuimhne agus 500 GB SSD, a ritheann Linux reatha gan aon rud eile air. Teastaíonn root ón tsuiteáil, toisc go suiteálann sé k3s mar sheirbhís chórais.

Faigh nexusctl agus seiceáil é

  1. Íoslódáil nexusctl do d'ailtireacht ó https://downloads.adverant.ai/nexus/1.0.0-alpha.1/, in éineacht le heochair phoiblí na heisiúna. Sábháil an eochair mar release.pub. Míníonn Caibidil 2.4, Eisiúint a fháil agus a fhíorú, conas méarlorg na heochrach a sheiceáil i gcoinne an chinn a fhoilsíonn Adverant.
  2. Seiceáil an comhad dénártha agus an eisiúint leis an eochair:
nexusctl version --json
nexusctl verify

Seiceálann nexusctl verify an t-íoslódáil i gcoinne eochair eisiúna Adverant agus diúltaíonn sé d'aon rud nach féidir leis a fhíorú. Má theipeann air, stop agus íoslódáil arís é. Ná rith suiteáil riamh ó chomhad nár fíoraíodh.

Cruthaigh eochair an choimeádaí

Séalaíonn stór eochracha na suiteála a eochracha athshlánaithe do choimeádaí amháin nó níos mó. Is éard atá i gcoimeádaí ná duine a choinníonn comhad aitheantais age as líne, agus diúltaíonn an chairt suiteáil gan ceann amháin ar a laghad. Ar mheaisín an choimeádaí féin:

age-keygen -o custodian.key

Tosaíonn an comhad le líne # public key: age1.... Is é an leath phoiblí sin a théann isteach sa chomhad luachanna. Ní fhágann an comhad aitheantais féin meaisín an choimeádaí riamh. Ar Mac le Secure Enclave, cruthaíonn age-plugin-se keygen --access-control=any-biometry -o custodian.key eochair a dteastaíonn Touch ID uaithi lena húsáid, agus tosaíonn a leath phoiblí le age1se1.

Scríobh an comhad luachanna

# harrow-pilot-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
enterprise:
  enabled: false
tls:
  mode: existing
  existingSecret: harrow-public-tls
keys:
  installationName: harrow-pilot
  custody:
    recipients:
      - "<custodian-age-recipient>"

Is é <custodian-age-recipient> an líne age1... ó custodian.key. Cuir iontráil liosta amháin leis in aghaidh an choimeádaí.

Is buan é keys.installationName. Cruthaíonn an chéad tosú den stór eochracha aitheantas na suiteála faoin ainm sin, agus ní athainmníonn aon rud é ina dhiaidh sin. Caithfidh sé a bheith ag teacht le ^[a-z][a-z0-9-]{0,62}$: cás íochtair, ag tosú le litir, 63 carachtar ar a mhéad. Ná cóipeáil nexus-example ná an faighteoir samplach ó chomhaid shamplacha na cairte féin. Diúltaíonn an chairt don dá cheann de réir ainm, agus tuairiscíonn an réamhsheiceáil na cóid chéanna ar dtús.

Is iad na trí óstach aitheantas na suiteála. Diúltaíonn gach seirbhís tosú gan iad, agus tá gach síniú isteach, fianán agus pas-eochair ceangailte le hosts.console. Roghnaigh ainmneacha a bheidh uait fós i gceann cúig bliana.

Dírigh na trí ainm ar an bhfreastalaí

Sroicheann daoine an consól, an API (comhéadan feidhmchlár ríomhchlárúcháin) agus an tseirbhís sínithe isteach trí rialaitheoir iontrála ionsuite k3s, Traefik, ar phoirt 80 agus 443 den fhreastalaí. Cuir trí thaifead DNS (Córas Ainmneacha Fearainn) leis le haghaidh console.harrow.example, api.harrow.example agus auth.harrow.example, agus gach ceann acu ag díriú ar sheoladh an fhreastalaí. Seiceálann an réamhsheiceáil gach ainm agus insíonn sí duit cé acu ceann nach bhfuil taifead aige.

Ní ligeann polasaí líonra na cairte ach d'ainmspás amháin na trí sheirbhís phoiblí a bhaint amach. Is é a réamhshocrú, kube-system, an áit a ritheann k3s Traefik, mar sin ar nód aonair fágann tú networkPolicy.ingressNamespace mar atá sé.

Rith an réamhsheiceáil, ansin suiteáil

  1. Rith an réamhsheiceáil le bratach an nóid aonair. Léann sí an meaisín agus do chomhad luachanna agus ní athraíonn sí dada.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Léigh an líne achomair ag an deireadh. Ní chuireann rabhadh bac ar an tsuiteáil riamh, ach cuireann teip bac uirthi, agus bíonn líne fix ag gach ró a theipeann.
 ────────────────────────────────────────────────────────────
 9 passed · 1 warning · 0 failed   You can install. Warnings do not block; fix them when you can.
 Report saved to preflight-2026-11-12-0902.txt · nothing was changed
  1. Suiteáil. Caithfidh an bhratach --edition teacht le edition sa chomhad luachanna.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Féach air ag rith. Ritheann sé an réamhsheiceáil arís, suiteálann sé k3s v1.33.6+k3s1, suiteálann sé cert-manager v1.21.3, suiteálann sé Nexus, agus fanann sé go bhfreagróidh gach seirbhís a seiceáil sláinte. Ar fhreastalaí Thomáis thóg sé beagán faoi bhun deich nóiméad.
 done   Preflight again        9 passed · 1 warning
 done   k3s v1.33.6+k3s1       node Ready
 done   cert-manager v1.21.3   ready
 done   Database and search    ready
 done   Engines                started
 done   Console                https://console.harrow.example
 Installed. Nobody can sign in yet.
 Open https://console.harrow.example/claim
 Code <code>  works once, for 30 minutes
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Coinnigh an méarlorg sin ar an scáileán. Déanfaidh tú comparáid idir é sa bhrabhsálaí nuair a éilíonn tú an tsuiteáil leis an gcód. Má ritheann an cód amach sula n-úsáideann tú é, déanann nexusctl claim-code --administrator <email> ceann nua. Tógann Caibidil 2.12, An chéad rith, an scéal as sin.

Suiteáil an t-eagrán Community
Suiteáil an t-eagrán Community
Is éard atá i suiteáil Community ar fhreastalaí amháin ná íoslódáil, seiceáil, réamhsheiceáil agus suiteáil, agus ansin an chéad riarthóir. Níl aon chéim cheadúnais ann.

Cuir an teastas i bhfeidhm

Le tls.mode: existing, freastalaíonn na trí bhealach iontrála an teastas sa Secret atá ainmnithe ag tls.existingSecret. Caithfidh sé na trí óstach go léir a chlúdach. Léann an réamhsheiceáil an Secret sin nuair a bhíonn sé ann agus tugann sí rabhadh nuair a chríochnaíonn an teastas laistigh de 30 lá. Nuair nach bhfuil an Secret ann fós, insíonn an ró duit é a chruthú, agus is rabhadh é, ní teip.

Ar nód aonair ní bhíonn an bhraisle ann go dtí go mbíonn sí cruthaithe ag an tsuiteáil, mar sin cruthaigh an Secret díreach i ndiaidh na suiteála. Scríobh amach kubeconfig na braisle ar dtús (míníonn an chuid dheireanach den chaibidil seo é), ansin cruthaigh an Secret leis:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

Coinníonn harrow-public.crt an teastas agus aon teastais idirmheánacha ina dhiaidh, agus coinníonn harrow-public.key a eochair phríobháideach. Má thagann do theastais ó CA (údarás teastais) príobháideach, glacann nexusctl preflight agus nexusctl install le --ca-bundle <file> ionas gur féidir leo an slabhra a sheiceáil. Tá na bealaí eile chun TLS (Slándáil Sraithe Iompair) a láimhseáil i gcaibidil 2.11, Athruithe: stóir sheachtracha, TLS agus iontráil.

Má theipeann air seo

An méid a fheiceann tú Cad is brí leis Cad ba cheart a dhéanamh
PREFLIGHT_FAILED (409) Fuair an réamhsheiceáil teip, mar sin níor thosaigh an tsuiteáil. Níor suiteáladh dada. Ceartaigh gach ró ar theip air, ag úsáid a líne fix, agus rith an tsuiteáil arís.
INSTALLATION_NAME_MISSING Tá keys.installationName folamh. Socraigh ainm buan na suiteála féin.
INSTALLATION_NAME_EXAMPLE Is é an t-ainm an ceann ó luachanna samplacha na cairte. Roghnaigh d'ainm féin.
KEYS_CUSTODIAN_MISSING Tá keys.custody.recipients folamh. Cuir faighteoir poiblí age1... gach coimeádaí leis.
KEYS_CUSTODIAN_EXAMPLE Is éard atá i bhfaighteoir ná coimeádaí samplach na cairte, nach bhfuil a aitheantas ag aon duine. Cuir faighteoirí do choimeádaithe féin ina áit.

Scoireann nexusctl le 0 nuair is féidir leis dul ar aghaidh, le 1 nuair a chuir seiceáil bac air, agus le 2 nuair nach bhféadfadh sé rith ar chor ar bith (comhad luachanna do-léite, bratach mhícheart). Is féidir le script gabhlú ar na trí cinn sin.

Cuid a dó: meastóireacht ar ríomhaire glúine le k3d

Ritheann k3d k3s taobh istigh de choimeádáin Docker, mar sin maireann braisle iomlán ar ríomhaire glúine agus imíonn sí le hordú amháin. Tógann na huirlisí eisiúna a thástálann gach eisiúint Nexus a mbraislí ar an mbealach seo go díreach, agus sábhálann cóipeáil a gcuid socruithe thú ó na fadhbanna ar bhuail siad leo cheana féin a aimsiú arís.

Teastaíonn Docker, k3d 5.8.3, kubectl, Helm v4 agus Chrome uait. D'úsáid Tomás a Mac.

Cruthaigh an bhraisle

k3d cluster create harrow-eval --agents 0 --wait --timeout 300s \
  --image rancher/k3s:v1.33.6-k3s1 \
  --k3s-arg "--disable=traefik@server:0"
k3d kubeconfig get harrow-eval > harrow-eval.kubeconfig
chmod 600 harrow-eval.kubeconfig
export KUBECONFIG=$PWD/harrow-eval.kubeconfig

Tá cúis le gach bratach.

  • Tugann --agents 0 nód freastalaí amháin agus gan aon oibrithe. Ritheann Nexus go sona sásta ar nód amháin, agus ní dhéanann an dara ceann ach cuimhne a ídiú.
  • socraíonn --image rancher/k3s:v1.33.6-k3s1 an leagan k3s a ndéantar gach eisiúint a thástáil air. Gan é gheobhaidh tú cibé rud a bhfuil k3d réamhshocraithe dó.
  • Fágann --disable=traefik@server:0 Traefik ar lár. Níl aon seoladh poiblí ag ríomhaire glúine le freastal air, agus sroicheann tú an consól trí d'aghaidh HTTPS féin ina ionad sin (thíos).
  • Ní fhilleann --wait --timeout 300s ach amháin nuair a fhreagraíonn an bhraisle, nó teipeann air tar éis cúig nóiméad.

Má dhéanann tú scáthánú ar an gclárlann eisiúna ar do ríomhaire glúine, cuir --registry-config <registries.yaml> leis chun tarraingtí íomhá a sheoladh chuig an scáthán, agus --k3s-arg "--disable-default-registry-endpoint@server:0" ionas nach dtiteann aon rud siar ar chlárlann in aghaidh srutha. Ritheann na huirlisí eisiúna ar an mbealach seo, agus gach íomhá ag teacht tríd an scáthán amháin.

Suiteáil cert-manager

Cruthaíonn an chairt a CA áitiúil féin, nexus-local-ca, mar eisitheoir cert-manager, agus faigheann gach seirbhís a teastas uaidh. Gan acmhainní cert-manager sa bhraisle, diúltaíonn helm install don chairt laistigh de shoicindí. Suiteáil cert-manager v1.21.3 ar dtús, ón gcairt a fhoilsíonn tionscadal cert-manager:

helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
  --create-namespace --set crds.enabled=true --wait --timeout 10m

Ní theastaíonn aon rud eile ó cert-manager ag Nexus, agus go háirithe níl aon trust-manager ag teastáil.

Suiteáil Nexus

  1. Scríobh comhad luachanna don ríomhaire glúine. Críochnaíonn TLS ag d'aghaidh féin, mar sin is é none atá i tls.mode.
# harrow-eval-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
tls:
  mode: none
keys:
  installationName: harrow-eval
  custody:
    recipients:
      - "<custodian-age-recipient>"
  1. Suiteáil an chairt ón gclárlann, agus fág --wait ar lár (deir an rabhadh thíos cén fáth).
helm install nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  -n nexus --create-namespace -f harrow-eval-values.yaml --timeout 45m
  1. Ansin fan leis na hualaí oibre tú féin:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
for s in $(kubectl -n nexus get sts -o name); do
  want=$(kubectl -n nexus get "$s" -o jsonpath='{.spec.replicas}')
  kubectl -n nexus wait "$s" --for=jsonpath='{.status.readyReplicas}'="$want" --timeout=900s
done

Tá lúb an StatefulSet ann toisc go ndéanann cuid acu pod amháin ag an am a nuashonrú ach é a iarraidh, agus diúltaíonn kubectl rollout status dóibh siúd. Oibríonn fanacht ar readyReplicas do gach straitéis nuashonraithe.

Nuair a fhilleann an dá ordú, bíonn gach Deployment ar fáil (Available) agus bíonn a phodanna réidh ag gach StatefulSet. Ní féidir le haon duine síniú isteach fós. Tá sin ceart: níl an tsuiteáil éilithe.

Cén fáth nach féidir le seoladh ar aghaidh poirt tú a shíniú isteach riamh

Is é an chéad bheart eile atá soiléir ná kubectl port-forward svc/nexus-alpha 3000:3000 agus brabhsálaí ar http://127.0.0.1:3000. Lódálann leathanaigh an chonsóil, mar sin tá an chuma air go n-oibríonn sé. Ní oibríonn, agus ní chuirfidh aon socrú ag obair é. Tá trí rud sa bhealach, gach ceann acu d'aon ghnó.

Cad a stopann é Cén fáth
An bunús Diúltaíonn síniú isteach an chonsóil d'iarratas nach é https://<hosts.console> a bhunús, https://console.harrow.example anseo. Tá an bunús mícheart ag leathanach a fhreastalaítear ó http://127.0.0.1:3000, mar sin ní thosaíonn an síniú isteach riamh.
An fianán Is fianán __Host- é an seisiún atá marcáilte le Secure. Ní stórálann brabhsálaithe fianán den sórt sin ach thar HTTPS, gan aon tréith fearainn, don óstach díreach a shocraigh é. Thar HTTP simplí caitheann an brabhsálaí uaidh é.
An phas-eochair Síníonn an chéad riarthóir isteach le pas-eochair, agus teastaíonn comhthéacs slán le teastas bailí ó phas-eochair. Diúltaíonn Chrome pas-eochair a chruthú taobh thiar de rabhadh teastais, fiú ceann ar chliceáil tú tríd.

Mar sin caithfidh an brabhsálaí labhairt le https://console.harrow.example, le teastas a bhfuil muinín aige as, agus caithfidh an t-ainm sin dul chuig do ríomhaire glúine.

An consól a bhaint amach thar HTTPS ar do ríomhaire glúine

Úsáideann an modh thíos CA na cairte féin chun an teastas a eisiúint, port-forward chun an consól a bhaint amach, agus próifíl Chrome ar leith a bhfuil muinín aici as an CA amháin sin agus a mhapálann ainm an chonsóil chuig do ríomhaire glúine. Fanann stór muiníne do chórais agus /etc/hosts mar atá siad.

Taispeánann an léaráid Chrome ar chlé, lipéadaithe "separate profile: trusts nexus-local-ca only; console.harrow.example:443 mapped to 127.0.0.1:28443". Téann saighead lipéadaithe "HTTPS" chuig bosca "HTTPS front on 127.0.0.1:28443 (certificate from nexus-local-ca)". Téann saighead lipéadaithe "HTTP, Host kept, X-Forwarded-Proto https" chuig "kubectl port-forward 127.0.0.1:3000", agus téann saighead dheireanach isteach i mbosca na braisle k3d chuig "Service nexus-alpha, port http (3000)". Tá líne bhriste ó cert-manager taobh istigh den bhraisle chuig an mbosca tosaigh lipéadaithe "issues the certificate".
Conas a shroicheann brabhsálaí ar an ríomhaire glúine an consól sa bhraisle k3d thar HTTPS.

Eisigh teastas d'ainm an chonsóil

  1. Iarr teastas ar cert-manager d'óstach an chonsóil, sínithe ag eisitheoir na cairte:
# console-front-certificate.yaml (a cert-manager Certificate)
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: nexus-console-front
  namespace: nexus
spec:
  secretName: nexus-console-front-tls
  dnsNames: [console.harrow.example]
  duration: 24h
  usages: [server auth, digital signature, key encipherment]
  privateKey: { algorithm: ECDSA, size: 256, rotationPolicy: Always }
  issuerRef: { name: nexus-local-ca, kind: Issuer, group: cert-manager.io }
kubectl apply -f console-front-certificate.yaml
kubectl -n nexus wait --for=condition=Ready certificate/nexus-console-front --timeout=120s

Síníonn cert-manager é taobh istigh den bhraisle. Ní léann tú eochair phríobháideach an CA riamh.

  1. Cóipeáil an teastas, a eochair agus teastas an CA amach as an Secret:
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.crt}' | base64 -d > tls.crt
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.key}' | base64 -d > tls.key
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.ca\.crt}' | base64 -d > ca.crt
chmod 600 tls.key
  1. Oibrigh amach biorán an CA. Aithníonn Chrome eochair iontaofa de réir SHA-256 base64 a heochrach poiblí:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Bioránaigh eochair an CA, ní ceann an teastais. Maireann an teastas lá agus faigheann sé eochair úr gach uair a athnuann cert-manager é, fad a fhanann an CA mar an gcéanna.

Cuir aghaidh HTTPS os comhair port-forward

  1. Cuir Service an chonsóil ar aghaidh. Is é a phort an ceann ar adtugtar http, arb é 3000 é san eisiúint seo:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Rith éisteoir HTTPS ar 127.0.0.1:28443 a chuireann ar aghaidh chuig 127.0.0.1:3000. Déanfaidh aon seachfhreastalaí droim ar ais a bhfuil muinín agat as cheana féin cúis, fad is a dhéanann sé ceithre rud:
    • go bhfreastalaíonn sé tls.crt agus ca.crt ina dhiaidh mar an slabhra, le tls.key;
    • go gcoinníonn sé an ceanntásc Host mar console.harrow.example;
    • go socraíonn sé X-Forwarded-Proto: https;
    • go ligeann sé uasghráduithe WebSocket tríd, toisc go n-úsáideann an consól iad.

Ceanglaíonn port-forward chuig Service an pod amháin a roghnaigh sé nuair a thosaigh sé. Tar éis d'uasghrádú nó d'atosú pod an chonsóil a athsholáthar, fanann an cur ar aghaidh suas agus ní chuireann sé ar aghaidh chuig aon rud, agus taispeánann an brabhsálaí droch-gheata (bad gateway). Atosaigh an port-forward aon uair a athraíonn pod an chonsóil.

Oscail Chrome leis an mbiorán agus le mapáil na n-ainmneacha

Ar Mac:

open -na "Google Chrome" --args --user-data-dir="$HOME/.nexus-eval-chrome" \
  "--host-resolver-rules=MAP console.harrow.example:443 127.0.0.1:28443" \
  "--ignore-certificate-errors-spki-list=<ca-pin>" \
  https://console.harrow.example/install

Is é <ca-pin> aschur na líne openssl. Ar Linux, tosaigh Chrome leis na trí bhratach chéanna.

Oibríonn na trí bhratach le chéile. Seolann --host-resolver-rules console.harrow.example ar phort 443 chuig d'aghaidh, taobh istigh den phróifíl seo amháin. Tá muinín ag --ignore-certificate-errors-spki-list as teastais a d'eisigh an eochair CA amháin sin, agus ní thugann Chrome aird air ach amháin le --user-data-dir. Coinníonn an phróifíl ar leith an eisceacht amach ó do bhrabhsáil laethúil. Ní lasc ghinearálta "déan neamhaird d'earráidí teastais" é: teipeann fós ar aon rud nach bhfuil sínithe ag CA na braisle.

Agus an phróifíl sin oscailte, téann https://console.harrow.example/install chuig leathanach an éilimh, agus is féidir pas-eochair a dhéanamh. Tógann Caibidil 2.12, An chéad rith, an scéal as seo.

Nuair a atosaíonn an ríomhaire glúine

Tá dhá chuid ag an stór eochracha: an stór eochracha féin agus díshéalaitheoir beag a choinníonn a eochair dhíghlasála. Tar éis aon atosaithe ar an nód (atosú Docker, atosú ríomhaire ghlúine, k3d cluster stop agus start) tosaíonn an díshéalaitheoir séalaithe. Díshéalaíonn an stór eochracha é féin tríd, mar sin go dtí go ndíshéalaíonn coimeádaí an díshéalaitheoir lena aitheantas age féin, ní oibríonn aon rud a dteastaíonn eochair uaidh. Is airí den dearadh é sin, agus tá sé mar an gcéanna ar bhraisle táirgeachta. Taispeánann Caibidil 2.15, An dara lá: Nexus a oibriú, an díshéalú.

Nuair a bheidh tú críochnaithe leis an meastóireacht:

k3d cluster delete harrow-eval

Scriosann scriosadh na braisle an tsuiteáil agus gach rud atá inti.

nexusctl kubeconfig

Is le nexusctl braisle a thóg nexusctl install --single-node. Chun í a bhaint amach le kubectl, helm nó aon uirlis eile, iarr a kubeconfig:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus get deploy,statefulset

Tugann an comhad rochtain riaracháin iomlán ar an mbraisle. Coinnigh ag mód 600 é, ar mheaisíní na ndaoine a ritheann an tsuiteáil, agus in aon áit eile seachas sin. Oibríonn gach ordú níos déanaí i gCuid 2 a ghlacann le --context nó a léann KUBECONFIG i gcoinne nóid aonair tríd an gcomhad seo. Baineann an rud céanna le huasghrádú: uasghrádaíonn nexusctl upgrade plan --bundle <file> agus nexusctl upgrade apply --bundle <file> ar nód aonair an bhraisle k3s ar le nexusctl í freisin.

Is cruach de cheithre shraith í an léaráid ar bhosca lipéadaithe "one Linux server". Ón mbun: "k3s v1.33.6+k3s1 (Traefik in kube-system, ports 80 and 443)", ansin "cert-manager v1.21.3 and the chart's local CA nexus-local-ca", ansin "Nexus data tier: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao", ansin "Nexus services: console, sign-in, gateway, and the rest". Ar dheis, fágann trí shaighead ón tsraith uachtarach an bosca lipéadaithe console.harrow.example, api.harrow.example agus auth.harrow.example. Ar chlé, díríonn deilbhín teirminéil lipéadaithe "nexusctl kubeconfig" isteach sa tsraith k3s.
An méid a chuireann nexusctl install --single-node ar fhreastalaí Linux amháin.

Cad a aistrítear chuig braisle

Tá a mhacasamhail ar bhraisle ag gach rud a rinne tú ar mheaisín amháin. Is é an comhad luachanna an comhad céanna le clárlann, mód TLS nó aicme stórála éagsúil, mar a thaispeánann caibidil 2.11, Athruithe: stóir sheachtracha, TLS agus iontráil. Tá an chéad rith go díreach mar an gcéanna. Is é an rud nach n-aistríonn ná an tsuiteáil féin: tá ainm na suiteála socraithe go deo, agus ní féidir suiteáil a thógáil ó ríomhaire glúine go dtí freastalaí. Nuair a bhog Tomás óna ríomhaire glúine go dtí an freastalaí píolótach thosaigh sé arís le hainm nua, harrow-pilot, agus choinnigh sé harrow-eval le haghaidh turgnamh.