Versio 1.0.0-alpha.1uusin
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

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:
- Lue koodi ennen viestiä. Jokainen hylkäys Nexusissa päättyy konekoodiin, ja tämä luku on hakemistoitu kyseisten koodien mukaan.
- Suorita
nexusctl preflightuudelleen 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. - Käytä valitsinta
--explainminkä tahansanexusctl-verbin kanssa, josta olet epävarma. Se tulostaakubectl- jahelm-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.
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.iodescribe 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
--waitvuoksi, 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.imageRegistryja Enterprise-versiossa noutopoletti tilisi Pull tokens and install commands -sivulta. - Tilassa
Pendingolevien taltioiden kohdalla asetastorage.classNametallennusluokaksi, 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-schemaLoki 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 ingressEnsimmä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.exampleSe tulostaa uuden koodin ja asennuksen sormenjäljen. Syötä koodi haltuunottosivulle 30 minuutin kuluessa ja vertaa sormenjälkeä uudelleen.
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.exampleOsoitteen tulisi olla ingress-ohjaimesi osoite, ja varmenteen tulisi olla se, jonka asensit kohteelle hosts.console.
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.jsonHylkä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-gatewayMitä 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 wideEtsi 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.yamlEsitarkistus (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.
| 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.


