Kirjaudu sisäänVaraa esittely

Luku 2.17

Vianmääritys

Ongelmat, joita ylläpitäjät kohtaavat useimmin, järjestettyinä oireiden mukaan. Jokaisesta kerrotaan syy, sen vahvistava komento ja korjaus, ja luku päättyy tukipaketin lähettämiseen.

Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

22 minuutin lukuaika

Suurin osa Nexus-asennuksen ongelmista ilmenee tusinalla samalla tavalla, ja lähes kaikki niistä ilmoittavat itsestään koodilla. Tämä luku on järjestetty sen mukaan, mitä näet, suurin piirtein siinä järjestyksessä kuin kohtaisit kunkin ongelman: asennus, haltuunotto, lisensointi ja lopuksi käyttö. Jokaisesta ongelmasta esitetään syy, sen vahvistava komento ja korjaus.

Esimerkeissä käytetään Harrow Port Authorityn asennusta: nimiavaruus nexus, julkaisu nexus, isäntänimet console.harrow.example, api.harrow.example ja auth.harrow.example. Korvaa ne omillasi. Kolme tapaa säästää aikaa jokaisen tässä käsitellyn ongelman kohdalla:

  1. Lue koodi ennen viestiä. Jokainen hylkäys Nexusissa päättyy konekoodiin, ja tämä luku on hakemistoitu kyseisten koodien mukaan.
  2. Suorita nexusctl preflight uudelleen jokaisen klusteriin tai values-tiedostoon tehdyn muutoksen jälkeen. Se lukee klusterin muuttamatta sitä ja ilmoittaa useimmista kaavion hylkäyksistä nimellä ennen kuin Helm tekee sen.
  3. Käytä valitsinta --explain minkä tahansa nexusctl-verbin kanssa, josta olet epävarma. Se tulostaa kubectl- ja helm-toiminnot suorittamatta niitä.

Asennus jumiutuu

Käynnistit asennuksen, eikä se ole valmistunut. helm ei ole palannut viidentoista minuutin kuluttua, tai se palasi ja podit ovat yhä tilassa Init tai Pending, tai konsolin osoite ei vastaa.

Yleisin syy on helm install --wait. Nexus luo tietokantansa, roolinsa ja jokaisen palvelun skeeman asennuksen jälkeisissä hookeissa (post-install hooks), ja bootstrap-hook on se, joka antaa kullekin palvelulle sen tietokantasalasanan. Valitsimella --wait Helm odottaa Deployment-resurssien valmistumista ennen kuin se suorittaa kyseiset hookit, kun taas Deployment-resurssit odottavat hookeja. Kumpikaan ei etene. Älä koskaan asenna valitsimella --wait; asenna ilman sitä ja odota sen jälkeen.

Pystysuora sarja laatikoita, joita yhdistävät alaspäin osoittavat nuolet: "Release resources created (Deployments start, each held by its wait-for-schema init container)", sitten "Database bootstrap hook: database, roles, release ledger", sitten "Migration hooks, one per service, in a fixed order", sitten "Each hook writes its row in the release ledger". Viimeisestä laatikosta nuolet haarautuvat sivuille kolmeen pieneen laatikkoon: "nexus-auth starts", "nexus-gateway starts", "other services start". Ylimmän laatikon vieressä on sivuhuomautus ja yliviivattu nuoli alas asti: "helm install --wait waits here for Deployments that are waiting for the hooks".
Mitä suoritetaan, ja missä järjestyksessä, kun kaavio asennetaan tai päivitetään.

Muut syyt ovat tavallisia Kubernetes-ongelmia. Levykuvia ei voida noutaa, koska global.imageRegistry nimeää väärän rekisterin, tai Enterprise-asennuksesta puuttuu noutopoletti (pull token). Taltio pysyy tilassa Pending, koska tallennusluokkaa (storage class) ei ole olemassa. cert-manager puuttuu, jolloin asennus ei jää lainkaan jumiin: se epäonnistuu sekunneissa, koska kaavion varmenteiden myöntäjät tarvitsevat cert-managerin resursseja.

Aloita podeista ja hookien Job-resursseista:

kubectl -n nexus get pods,jobs
kubectl -n nexus describe pod <pod-name>
kubectl -n nexus logs job/<job-name>
kubectl get crd certificates.cert-manager.io

describe näyttää tapahtumissaan levykuvien noutovirheet ja sitomattomat taltiot. Hookin Job, joka näyttää 0/1 valmistumista ja epäonnistuneen podin, on pysäyttänyt asennuksen, koska hookien Job-resurssien uudelleenyritysraja (backoff limit) on 0 eikä niitä koskaan yritetä uudelleen hiljaisesti. Sen loki kertoo syyn.

Näin korjaat kunkin syyn:

  • Jos Helm odottaa valitsimen --wait vuoksi, pysäytä se, poista asennus ja asenna uudelleen ilman valitsinta. Odota sen jälkeen palveluita:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Noutovirheiden kohdalla tarkista global.imageRegistry ja Enterprise-versiossa noutopoletti tilisi Pull tokens and install commands -sivulta.
  • Tilassa Pending olevien taltioiden kohdalla aseta storage.className tallennusluokaksi, joka klusterista löytyy, tai tee yhdestä oletusluokka.
  • Jos cert-manager puuttuu, asenna cert-manager v1.21.3 ja suorita asennus uudelleen.
  • Epäonnistuneen hookin kohdalla korjaa sen lokissa nimetty ongelma ja suorita asennus uudelleen.

Pod odottaa skeemaansa

Palvelun podi pysyy tilassa Init:0/1 minuuttien ajan. Jokaisella tietokantaa käyttävällä palvelulla on alustuskontti (init container), wait-for-schema, joka pidättelee podia, kunnes julkaisukirjanpito (release ledger) osoittaa sen migraatioiden olevan vietyinä tämän julkaisun levykuvalle. Tämä on normaalitilanne asennuksen tai päivityksen ensimmäisten minuuttien aikana, kun migraatio-hookeja suoritetaan. Se on ongelma silloin, kun tila ei pääty.

Lue alustuskontin loki:

kubectl -n nexus logs <pod-name> -c wait-for-schema

Loki nimeää komponentin, migraatioketjut, joita se odottaa, ja sen aikarajan, ja tulostaa sitten rivin aina, kun sen tila muuttuu:

wait-for-schema: nexus-auth waits for nexus_release.schema_applied (read as nexus_ledger_reader) to show: nexus-auth-migrations=sha256:…; gives up after 1800s
Edistymisrivillä lukee Mitä se tarkoittaa
Mitkä ketjut on vielä vietävä tälle julkaisulle Nimetyt migraatio-hookit eivät ole valmistuneet. Tarkastele kyseisiä Job-resursseja.
Että julkaisukirjanpitoa ei voida lukea, sekä tietokannan virhe Postgres ei vastaa, tai kirjanpitoa ei ole olemassa, koska tietokannan alustusta (bootstrap) ei ole suoritettu.
FAILED (<component>): after <n>s, … Se luovutti arvon schemaWait.timeoutSeconds jälkeen (oletuksena 1 800). Alustuskontti käynnistyy uudelleen; itse palvelu ei koskaan käynnistynyt.

Ketju, joka ei koskaan toteudu, tarkoittaa lähes aina, että sen migraatio-Job epäonnistui. Etsi se komennolla kubectl -n nexus get jobs ja lue sen loki. Korjaa sen nimeämä syy (täysi levy, ulkoinen tietokanta, johon migraattori ei saa yhteyttä, rooliristiriita) ja suorita helm upgrade samoilla arvoilla: hookit suoritetaan uudelleen, ja jokainen niistä on turvallista suorittaa uudelleen.

Nosta arvoa schemaWait.timeoutSeconds vain silloin, kun migraatio on hidas mutta toimii oikein, kuten suuri ensimmäinen migraatio hitaalla tallennusjärjestelmällä voi olla. Sen nostaminen epäonnistuneen Jobin piilottamiseksi saa podin vain odottamaan pidempään jotakin, mitä ei koskaan tapahdu.

Avainsäilö on sinetöity

Sähkökatkon, solmun uudelleenkäynnistyksen tai konttiajoympäristön uudelleenkäynnistyksen jälkeen podit palaavat ja konsoli latautuu, mutta kaikki avainta tarvitseva epäonnistuu tai odottaa. Lukituksen avaaja (unsealer) käynnistyy sinetöitynä (sealed) jokaisen solmunsa uudelleenkäynnistyksen jälkeen, eikä avainsäilö (key store) voi avata omaa sinetöintiään ennen kuin lukituksen avaaja on auki.

Kysy OpenBaolta kussakin podissa:

kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
  bao status -format=json -address=https://127.0.0.1:8200 \
  -ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"

Paluukoodi 0 tarkoittaa avattua (unsealed), 2 sinetöityä (sealed), ja 1 tarkoittaa, ettei se pystynyt vastaamaan (kysy uudelleen minuutin kuluttua). Suorita sama kohteelle openbao-0 valitsimella -tls-server-name=openbao avainsäilöä varten. Jos lukituksen avaajan sinetöinti on avattu ja avainsäilön ei, avainsäilö on avaamassa omaa sinetöintiään; odota minuutti.

Sinetöidyn lukituksen avaajan korjaamiseksi yksi avaintenhaltija (custodian) suorittaa kaavion skriptin unseal.sh omalla age-identiteetillään. Luvussa 2.15, Toinen päivä: Nexusin käyttö, on täydellinen komento. Skriptin paluukoodi kertoo, mitä tapahtui:

Paluukoodi Merkitys Mitä tehdä
0 Sinetöinti avattu Tarkista kubectl -n nexus get deploy,statefulset minuutin kuluessa.
1 Edelleen sinetöity tai avauskutsu epäonnistui Lue sen tulostamat avainosien (share) rivit; suorita se uudelleen.
2 Esivaatimus puuttuu Viesti nimeää sen: AGE_IDENTITY, binääri kuten age tai jq, tai suoratilan (direct-mode) asetus.
3 Tämä identiteetti ei pysty purkamaan avainosien salausta Et ole tämän asennuksen avaintenhaltija. Mitään ei lähetetty. Etsi avaintenhaltija, joka on.

Kirjautuminen ei onnistu HTTP-yhteydellä

Konsoli latautuu http://-osoitteessa tai kubectl port-forward-yhteyden kautta kohteeseen 127.0.0.1, ja sisäänkirjautuminen epäonnistuu. Avainkoodin (passkey) kehote ei koskaan tule näkyviin, tai sisäänkirjautuminen palaa silmukassa takaisin alkuun.

Sisäänkirjautuminen vaatii konsolin oman HTTPS-alkuperän (origin). Konsoli hyväksyy sisäänkirjautumisen vain osoitteesta https://<hosts.console>, säilyttää istunnon Secure-merkityssä __Host--evästeessä (jonka selain tallentaa vain HTTPS-yhteydellä), ja ensimmäisen pääkäyttäjän avainkoodi vaatii sivun, jolla on kelvollinen varmenne. Selaimet hylkäävät avainkoodit varmennevirheen takana. Portinohjaus (port-forward) kohteeseen http://127.0.0.1 ei voi koskaan kirjautua sisään.

Tarkista, mihin selain todellisuudessa yhdisti:

curl -sI https://console.harrow.example
kubectl -n nexus get ingress

Ensimmäisen tulisi vastata HTTPS-yhteydellä varmenteella, johon koneesi luottaa. Toisen tulisi näyttää kolme isäntänimeä niillä nimillä, jotka asetit kohdassa hosts.*.

Korjaa ongelma avaamalla konsoli osoitteessa https://console.harrow.example, joka on tarkka nimi kohdassa hosts.console, varmenteella, johon selain luottaa. Jos käytössä on tls.mode: existing, tarkista, että tls.existingSecret sisältää varmenteen kaikille kolmelle isäntänimelle. Jos käytössä on tls.mode: cert-manager, tarkista, että ClusterIssuer myönsi sen. Jos käytössä on tls.mode: none, Transport Layer Security (TLS) päättyy omaan kuormantasaimellesi, ja varmenteen on oltava oikein siellä. Yksityisen varmentajan (CA) tapauksessa asenna sen varmenne niille koneille, joilta pääkäyttäjäsi kirjautuvat sisään.

Lunastuskoodi on vanhentunut

Claim this installation -sivulla sivu hylkää koodin virheellä CLAIM_CODE_EXPIRED (410). Haltuunottokoodi koostuu kolmesta neljän merkin ryhmästä. Se toimii kerran, 30 minuutin ajan, 5 yrityksellä. Sen jälkeen tai viidennen väärän yrityksen jälkeen se on mitätöity, eikä mitään otettu haltuun tai muutettu.

Luo uusi koodi päätteestä, jolla on pääsy klusteriin:

nexusctl claim-code --administrator aoife.brennan@harrow.example

Se tulostaa uuden koodin ja asennuksen sormenjäljen. Syötä koodi haltuunottosivulle 30 minuutin kuluessa ja vertaa sormenjälkeä uudelleen.

Lunasta tämä asennus
Lunasta tämä asennus
Ota tämä asennus haltuun. Päätteestä saatu koodi syötetään kolmessa ryhmässä, ja sivu näyttää koko sormenjäljen neljän ryhmissä vertailua varten; vanhentunut koodi hylätään virheellä CLAIM_CODE_EXPIRED eikä mitään oteta haltuun.

Kaksi tähän liittyvää vastausta:

  • RATE_LIMITED (429) haltuunottosivulla tarkoittaa, että sivulla on tehty useita yrityksiä viimeisen minuutin aikana. Odota sen ilmoittama sekuntimäärä. Jos et tehnyt kyseisiä yrityksiä itse, joku muu verkossasi yrittää käyttää sivua; selvitä kuka, ennen kuin otat asennuksen haltuun.
  • TRANSITION_NOT_PERMITTED (409) tarkoittaa, että asennus on jo otettu haltuun ja sen haltuunottosivu on pysyvästi poissa käytöstä. Kirjaudu sen sijaan sisään. Jos et itse ottanut sitä haltuun, käsittele asiaa tietoturvapoikkeamana.

Sormenjälki ei täsmää

Haltuunottosivu näyttää virheen CLAIM_FINGERPRINT_MISMATCH (403), tai näet itse, että sivulla olevat kahdeksan neljän merkin ryhmää poikkeavat päätteen tulostamista ryhmistä. Jopa yhden ryhmän ero tarkoittaa, että selain keskustelee eri asennuksen kanssa.

Pysähdy. Älä kirjoita koodia kyseiselle sivulle. Jokin muu kuin oma asennuksesi saattaa vastata kyseisessä osoitteessa, mahdollisesti kone, joka on pystytetty sieppaamaan ensimmäinen pääkäyttäjä. Jos ottaisit sen haltuun, kyseinen kone saisi haltuunsa organisaatiosi. Oma asennuksesi on muuttumaton ja edelleen vailla haltijaa.

Tarkista, mihin nimi osoittaa ja mikä varmenne vastasi:

nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.example

Osoitteen tulisi olla ingress-ohjaimesi osoite, ja varmenteen tulisi olla se, jonka asensit kohteelle hosts.console.

Sormenjälki ei täsmää
Sormenjälki ei täsmää
Sormenjäljet poikkeavat kolmessa ryhmässä kahdeksasta. Sivu kehottaa pysähtymään, selittää kuka saattaa olla vastaamassa ja luettelee, mitä tulee tarkistaa ennen uutta yritystä.

Korjaa tilanne antamalla tietoturvatiimillesi vastannut osoite ja säilytä asennusloki, johon on tallennettu asennuksen tulostama sormenjälki. Korjaa Domain Name System (DNS) -tietue tai välityspalvelin, joka ohjasi sinut muualle. Luo sitten uusi haltuunottokoodi komennolla nexusctl claim-code --administrator <email> ja tee haltuunotto selaimella luottamassasi verkossa verraten jälleen kaikkia kahdeksaa ryhmää.

Lisenssi hylätään

Tuonti kohdassa Import the licence, Import a new licence tai nexusctl licence import vastaa hylkäyksellä. Hylätty tuonti ei muuta mitään: voimassa oleva lisenssi pysyy voimassa, eikä kellon alaraja (clock floor) siirry.

Lue koodi ja vaihe:

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @harrow-2027.licence.json

Hylkäysvastauksen runko sisältää kentät code, message, refused_at (epäonnistunut vaihe) ja troubleshooting. Nähdäksesi voimassa olevan lisenssin tilan lue GET https://auth.harrow.example/api/v1/installation/licence/state samalla poletilla.

Koodi HTTP Yleisin syy Korjaus
LICENCE_SIGNATURE_INVALID 422 Tiedostoa on muokattu, muotoiltu uudelleen tai tallennettu uudelleen, tai yksi allekirjoitus puuttuu Lataa se uudelleen tililtäsi ja tuo se sellaisenaan
LICENCE_FORMAT_INVALID 422 Ei lisenssi: väärä tiedosto, katkennut tai kääritty toisen objektin sisään Lähetä tiedosto täsmälleen sellaisena kuin Adverant sen antoi
LICENCE_ROOT_UNKNOWN 422 Allekirjoitettu avaimella, jota tämä julkaisu ei sisällä Päivitä, tai pyydä julkaisullesi allekirjoitettu lisenssi
LICENCE_MATRIX_MISMATCH 422 Kirjoitettu uudemmalle versio-ominaisuusmatriisille (edition matrix), tai myöntää ryhmän, jota tämä käännös ei tunne Päivitä, tai pyydä julkaisullesi kirjoitettu lisenssi
LICENCE_OTHER_INSTALLATION 409 Myönnetty toiselle asennukselle, usein testiklusterin lisenssi tuotannossa Pyydä lisenssi tämän asennuksen identiteetille
LICENCE_REVOKED 403 Adverant peruutti sen Pyydä Adverantilta uusi lisenssi
LICENCE_LOCKED 403 Sen starts_on on nykyisen päivämäärän jälkeen Tuo se sen ensimmäisenä voimassaolopäivänä tai sen jälkeen
TRANSITION_NOT_PERMITTED 409 Tämä lisenssitunnus on jo tuotu Ei vaadi toimenpiteitä, jos se on voimassa; ota yhteyttä Adverantiin, jos ehtojen on muututtava
RECORD_NOT_FOUND 404 Asennusta ei ole julistettu, joten sillä ei ole vielä identiteettiä Suorita ensimmäisen pääkäyttäjän vaihe loppuun ja tuo sitten
TENANT_NOT_A_PARAMETER 403 Runko nimeää organisaation ylimmällä tasollaan Lähetä pelkkä lisenssitiedosto runkona

Kaksi asiaa näyttää lisenssiongelmilta, mutta eivät ole sitä. Tilan luku, joka sisältää arvon LICENCE_CLOCK_BEHIND_FLOOR, tarkoittaa, että solmun kello näyttää aikaisempaa aikaa kuin viimeisin aika, jonka asennus on nähnyt; korjaa solmun aika, ja jos kello oli edellä ja siirsi alarajaa mukanaan, pyydä Adverantilta ajan nollauspoletti (time-reset token). Lisäksi lisenssi, jonka tuonti onnistuu mutta joka silti näyttää ryhmän esittelytilassa (teaser), ei yleensä myönnä kyseistä ryhmää: lue lisenssisivun myönnetyt oikeudet (grants) ennen mitään muuta.

Ei tekoälyvastauksia

Tekoälyavustaja (artificial intelligence, AI) näyttää virheen MODEL_NOT_CONNECTED (503), työnkulun vaihe epäonnistuu virheellä NO_PROVIDER_FOR_ROLE (422) tai vastaukset yksinkertaisesti loppuvat.

Organisaation varannossa (pool) ei ole avainta, joka voisi vastata, tai reititin ei saa yhteyttä palveluntarjoajaan. Jokainen organisaatio tuo oman malliavaimensa. Jos käytössä ei ole avainta, tekoälyä ei suunnitellusti ole käytettävissä, eikä mikään jaettu avain korvaa sitä.

Tarkista varanto ja reitittimen valinta, kumpikin henkilön omalla pääsypoletilla:

GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective

Ensimmäinen luettelee kunkin palveluntarjoajan, voiko se vastata ja miksi ei ("No key in use: 1 withdrawn, 1 lapsed"), sekä jokaisen avaimen tilan. Toinen vastaa mallin, jota reititin käyttäisi organisaatiolle, tai sen sanallisen hylkäyksen. Tarkista sen jälkeen reitti ulos klusterista näillä kahdella komennolla:

kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gateway

Mitä kukin havainto tarkoittaa:

Havainto Korjaus
Varannossa ei ole avainta Omistaja tai pääkäyttäjä lisää organisaatioavaimen AI switchboard -sivulla tai kohdassa Settings, AI models
Avaimet tilassa invalid, expired tai exhausted Lisää uusi avain; vanha jää luetteloon historiatiedoksi
Avaimet tilassa resting Odota: epäonnistunut avain lepää 60 sekuntia, ja 5 peräkkäisen epäonnistumisen jälkeen se kytketään pois päältä (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE, kun avaimia on käytössä Roolilla ei ole määritystä eikä mikään täsmää; aseta rooli reitityskäytännössä
MODEL_CAPABILITY_UNAVAILABLE (422) Pyyntö vaatii kyvykkyyden tai sijaintipaikan (residency), jota yksikään varannon palveluntarjoaja ei tarjoa; ota käyttöön sellainen, joka tarjoaa
Ei nexus-operator-egress-käytäntöä, tai palveluntarjoajan osoitealueet puuttuvat siitä Lisää osoitealueet Classless Inter-Domain Routing (CIDR) -merkintätavalla kohtaan networkPolicy.externalEgressCIDRs ja päivitä
Paikallinen mallipalvelin, joka ei vastaa Tarkista ai.localProvider.baseUrl, lisää palvelin kohtaan ai.installationHosts ja salli sen osoitealue kohdassa networkPolicy.externalEgressCIDRs

Ulkoisen palveluntarjoajan avain, joka toimii kannettavalta tietokoneelta mutta epäonnistuu asennuksessa, johtuu lähes aina verkkokäytännöstä (network policy). Nimiavaruus estää lähtevän liikenteen (egress) oletuksena.

429-vastaukset

Asiakasohjelmalle vastataan 429 Too Many Requests. Nexusissa on neljä paikkaa, jotka voivat antaa tämän vastauksen, ja vastauksen runko kertoo, mikä niistä on kyseessä.

Missä Koodi ja lisätiedot Mitä muutetaan
nexus-auth, sisäänkirjautunutta henkilöä kohden RATE_LIMITED kentillä limit, windowSeconds ja retryAfterSeconds auth.rateLimitPerMinute (oletus 5000), raskaalle automaatiolle
Skriptiavaimen, sovelluksen tai yksikön raja (Enterprise) RATE_LIMITED, joka nimeää avaimen ja sen rajan Raja kohdassa Settings, Rate limits, perustelun kera
Ensimmäisen suorituskerran haltuunottosivu RATE_LIMITED kentällä retry_after_seconds Ei mitään: odota ja selvitä, kuka muu yrittää käyttää sivua
Mallin palveluntarjoaja Reititin käsittelee sitä ohimenevänä virheenä ja siirtyy seuraavaan palveluntarjoajaan Lisää toinen avain tai palveluntarjoaja, jos tätä tapahtuu usein

Jokainen näistä sisältää Retry-After-otsakkeen. Hyvin käyttäytyvä asiakasohjelma odottaa kyseisen ajan eikä yritä uudelleen aiemmin.

Jos kaikki käyttäjät näyttävät jakavan yhden ja saman rajan samanaikaisesti, tarkista proxy.trustedCIDRs. Kun se ei kata ingress-ohjaimesi pod-verkkoa, nexus-auth ei voi luottaa X-Forwarded-For-otsakkeeseen ja näkee jokaisen pyynnön tulevan ohjaimelta. Oletusarvo, 10.42.0.0/16, sopii vain k3s-ympäristöön.

kubectl get pods -A -o wide

Etsi tulosteesta ingress-ohjaimen pod-osoite ja varmista, että proxy.trustedCIDRs kattaa sen.

Päivitysvirheet

Päivitys palautettiin edelliseen tilaan. Upgrade-sivu näyttää tilan UPGRADE_ROLLED_BACK: vaihe epäonnistui, jokainen moottori on palannut edelliseen julkaisuun, eikä tietoja muutettu. Sivu nimeää kyseisen vaiheen. Yleinen syy on taltio, joka on liian pieni säilön uudelle rakenteelle. Korjaa nimetty ongelma, suorita nexusctl upgrade plan --bundle <file> uudelleen ja ota sitten käyttöön. Varmuuskopio otetaan ensin uudelleen.

Kaavio kieltäytyy renderöinnistä virheellä EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Secret-resurssi nexus-generated sisältää arvon EXTERNAL_KEY_ENCRYPTION_KEY muodossa, jota kaavio ei voi käyttää. Sen on oltava 32 tavua base64-muodossa tai vanhemman asennuksen raaka 32-tavuinen avain. Joku on muokannut Secret-resurssia tai korvannut sen. Palauta avain, jolla tämän asennuksen tiedot on sinetöity, sen 32 tavun base64-muodossa (printf %s "$OLD" | base64), ja päivitä uudelleen. Älä anna kaavion luoda uutta avainta: vanhalla avaimella sinetöidyt tiedot jäisivät lukukelvottomiksi.

Skriptit hylätään virheellä TOKEN_ORG_MISSING päivityksen jälkeen. Jokainen palvelu, joka tarkistaa ohjelmointirajapinnan (application programming interface, API) avaimet nexus-authin kautta, hylkää nyt ilman organisaatiota olevan avaimen virheellä 403 TOKEN_ORG_MISSING. Anna jokaiselle tällaiselle avaimelle organisaatio tai myönnä uusi avain.

Avaimet ilmoittavat väärän sovelluksen tunnin ajan. Tyhjennä välimuistissa olevat avaintietueet nexus-authin välimuistista, joka on asennuksen Valkey-säilö. Luvussa 2.15, Toinen päivä: Nexusin käyttö, on komento sekä klusterin sisäiselle että ulkoiselle säilölle.

Migraatio-hook epäonnistui. helm upgrade ilmoittaa epäonnistuneesta päivitystä edeltävästä hookista (pre-upgrade hook). Skeema siirtyy ennen kuin uudet podit otetaan käyttöön, joten ajossa oleva julkaisu palvelee edelleen. Lue Job-resurssin loki komennolla kubectl -n nexus logs job/<job-name>, korjaa sen nimeämä ongelma ja suorita päivitys uudelleen.

Palvelut eivät voineet käyttää taulujaan muutaman sekunnin ajan. Kun aiemmasta kaaviosta tehty asennus päivitetään ensimmäisen kerran, kukin palvelu menettää vanhat oletusarvoiset tauluoikeutensa ja saa omat oikeutensa takaisin omasta migraatiostaan. Katkos kestää muutamia sekunteja. Tee päivitys hiljaisena aikana tai skaalaa palvelut ensin nollaan.

Levyllä oleva julkaisu hylättiin. Tuonti tietovälineeltä näyttää virheen MEDIA_SIGNATURE_INVALID (422): tiedostoja ei ole allekirjoitettu tähän asennukseen asennetulla julkaisuavaimella. Mitään ei ladattu, ja ajossa oleva julkaisu jatkaa toimintaansa. Säilytä tietoväline tietoturvatiimillesi ja pyydä Adverantilta uusi tietoväline offline-vaihdon kautta.

Chart-mallin renderöinnin hylkäys

helm install, helm upgrade tai helm template pysähtyy ennen kuin mitään otetaan käyttöön, antaen viestin, joka alkaa koodilla tai nimeää arvon. Kaavio hylkää arvot, joita se ei voi suorittaa turvallisesti. Mikään klusterissa ei muuttunut.

Renderöi kaavio sellaisenaan nähdäksesi jokaisen hylkäyksen koskematta klusteriin. Käytä lataamaasi Enterprise-kaaviota oci://-osoitteen sijaan Enterprise-ympäristössä ja aseta networkPolicy.apiServerCIDRs arvoihin, koska offline-renderöinti ei voi lukea sitä klusterista:

helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version <version> \
  -n nexus -f harrow-values.yaml > /dev/null
nexusctl preflight --context harrow-prod --values harrow-values.yaml

Esitarkistus (preflight) tarkistaa samat identiteettiarvot "time and keys" -osiossaan ja ilmoittaa samat koodit. Sen paluukoodi on 0, kun asennus voi jatkua (varoitukset eivät estä), 1, kun vähintään yksi tarkistus epäonnistui, ja 2, kun sitä ei voitu suorittaa.

Esitarkistus ei voi jatkua
Esitarkistus ei voi jatkua
Esitarkistus ei voi jatkua. Epäonnistuneet tarkistukset näytetään ensin, kukin korjausohjeineen, ja asennus pysyy estettynä tilassa PREFLIGHT_FAILED, kunnes ne menevät läpi.
Hylkäys Syy Korjaus
INSTALLATION_NAME_MISSING keys.installationName on tyhjä Aseta arvoksi tämän asennuksen oma nimi, joka täsmää arvon ^[a-z][a-z0-9-]{0,62}$ kanssa. Se on pysyvä siitä lähtien, kun avainsäilö käynnistyy ensimmäisen kerran
INSTALLATION_NAME_EXAMPLE Nimi on kaavion esimerkkien values-tiedostoissa oleva nimi Aseta oma nimesi
keys.installationName "…" does not match … Isoja kirjaimia, alaviivoja tai numero alussa Käytä pieniä kirjaimia, numeroita ja yhdysmerkkejä, aloittaen kirjaimella
KEYS_CUSTODIAN_MISSING keys.custody.recipients on tyhjä Luettele avaintenhaltijoidesi age-vastaanottajat (recipients), eli julkiset puoliskot
KEYS_CUSTODIAN_EXAMPLE Vastaanottaja on kaavion values-tiedostojen esimerkkiavaintenhaltija, jonka identiteettiä ei ole kenelläkään Korvaa se omien avaintenhaltijoidesi vastaanottajilla
keys.custody.recipients: … Vastaanottaja on muodossa, jolle avaintenhallinnan Job ei pysty salaamaan Käytä arvoa age1…, age1tag1…, age1tagpq1…, age1pq1… tai age1se1…, pienillä kirjaimilla
NEXUS_EDITION_INVALID edition ei ole community eikä enterprise Aseta jompikumpi
edition=… but enterprise.enabled=… Nämä kaksi ovat ristiriidassa Aseta enterprise.enabled: true täsmälleen silloin, kun edition on enterprise
global.imageRegistry is required Rekisteriä ei ole nimetty Aseta rekisteri, josta solmusi noutavat levykuvat
hosts.<name> is required Julkinen isäntänimi puuttuu Aseta hosts.console, hosts.api ja hosts.auth
tls.existingSecret is required when tls.mode is existing Varmenteen Secret-resurssia ei ole nimetty Nimeä Secret, tai valitse toinen tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Myöntäjää (issuer) ei ole nimetty Nimeä oma ClusterIssuer-resurssisi
dataTier.<store>.external.host is required when mode is external Ulkoinen säilö ilman osoitetta Anna sen isäntänimi ja sen Secret kohdassa existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read Kohteella helm template ei ole klusteria, josta se voisi hakea ne Anna API-palvelimen osoitteet /32-osoitealueina
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Luotu avain kohdassa nexus-generated on väärän muotoinen Katso "Päivitysvirheet" yllä

Kaavion skeema hylkää values-tiedoston, joka käyttää avainta, jota kaaviossa ei ole, tai vääräntyyppistä arvoa, ennen mitään näistä. telemetry.enabled: true on yksi esimerkki: skeema hyväksyy vain arvon false.

Tukipaketin lähettäminen

Kun mikään näistä ei korjaa ongelmaa, lähetä Adverantille tukipaketti (support bundle) tukipyyntösi mukana.

nexusctl support-bundle --out harrow-support-<request-number>.tar.gz

<request-number> on sen pyynnön numero, jonka avasit tilisi Support and support bundles -sivulla. Voit luoda saman paketin konsolin Support bundle -sivulla kohdassa This installation.

Paketti sisältää moottoreiden lokit viimeiseltä 24 tunnilta, tila- ja versiotiedot, asetukset ilman salaisuuksia sekä esitarkistus- ja asennusraportit. Ennen kuin paketti kirjoitetaan, tietojen poisto (redaction) korvaa nimet, salaisuudet ja osoitteet, ja näet esikatselun tarkalleen siitä, mitä lähetetään. Ihmisten viestejä, tiedostoja ja muistia ei koskaan kerätä.

Lataa se tililläsi olevaan pyyntöön, tai tallenna se tietovälineelle ja siirrä se ulos, jos asennuksella ei ole ulkoista yhteyttä. Vain pyynnössä nimetyt tuki-insinöörit voivat avata sen, ja se poistetaan 30 päivän kuluttua. Kerro pyynnössä, mitä yllä olevista ongelmista tutkit ja mitä tämän luvun tarkistukset näyttivät: se säästää yhden viestinvaihtokierroksen.