Iniciar sessãoAgendar apresentação

Capítulo 2.17

Resolução de problemas

Os problemas que os operadores encontram com mais frequência, organizados pelo que se observa. Cada um indica a causa, o comando que a confirma e a correção, e o capítulo termina com o envio de um pacote de suporte.

Esta página foi traduzida por IA a partir do original em inglês. Em caso de dúvida, a página em inglês serve de referência. Ler esta página em inglês

22 minutos de leitura

A maioria do que corre mal numa instalação do Nexus acontece da mesma dúzia de formas, e quase todas elas se anunciam com um código. Este capítulo está organizado pelo que vê, aproximadamente pela ordem em que encontraria cada problema: instalar, reclamar, licenciar e, depois, executar. Para cada um, obtém a causa, um comando que a confirma e a correção.

Os exemplos utilizam a instalação da Harrow Port Authority: namespace nexus, release nexus, anfitriões console.harrow.example, api.harrow.example e auth.harrow.example. Substitua-os pelos seus. Três hábitos poupam tempo em todos os problemas aqui descritos:

  1. Leia o código antes da mensagem. Cada recusa no Nexus termina com um código de máquina, e este capítulo está indexado por esse código.
  2. Execute nexusctl preflight novamente após qualquer alteração ao cluster ou ao ficheiro de valores. Ele lê o cluster sem o alterar e comunica a maioria das recusas do chart pelo nome antes de o Helm o fazer.
  3. Utilize --explain em qualquer verbo nexusctl sobre o qual tenha dúvidas. Ele imprime as operações kubectl e helm sem as executar.

A instalação bloqueia

Executou a instalação e esta não terminou. O helm não regressou após quinze minutos, ou regressou e os pods continuam em Init ou Pending, ou o endereço da consola não responde.

A causa mais comum é helm install --wait. O Nexus cria a sua base de dados, as suas funções e o esquema de cada serviço em hooks de pós-instalação, e é o hook de bootstrap que entrega a cada serviço a palavra-passe da base de dados. Com --wait, o Helm aguarda que os Deployments estejam prontos antes de executar esses hooks, enquanto os Deployments aguardam pelos hooks. Nenhum avança. Nunca instale com --wait; instale sem ele e aguarde depois.

Uma sequência vertical de caixas unidas por setas para baixo: "Recursos da release criados (os Deployments iniciam, cada um retido pelo seu init container wait-for-schema)", depois "Hook de bootstrap da base de dados: base de dados, funções, livro de registo de releases", depois "Hooks de migração, um por serviço, numa ordem fixa", depois "Cada hook escreve a sua linha no livro de registo de releases". A partir da última caixa, as setas abrem-se lateralmente para três pequenas caixas "nexus-auth inicia", "nexus-gateway inicia", "outros serviços iniciam". Uma nota lateral junto à caixa superior, com uma seta riscada até ao fundo: "helm install --wait aguarda aqui pelos Deployments que estão a aguardar pelos hooks".
O que é executado, por ordem, quando o chart é instalado ou atualizado.

As outras causas são causas comuns do Kubernetes. Não é possível transferir as imagens porque global.imageRegistry indica o registo errado, ou uma instalação Enterprise não tem token de pull. Um volume permanece Pending porque a classe de armazenamento não existe. O cert-manager está em falta, caso em que a instalação nem sequer bloqueia: falha em poucos segundos, porque os emissores de certificados do chart necessitam dos recursos do cert-manager.

Comece pelos pods e pelos Jobs de hook:

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

O describe mostra erros de pull de imagem e volumes não associados nos seus eventos. Um Job de hook que mostre 0/1 conclusões com um pod falhado parou a instalação, porque os Jobs de hook têm um limite de backoff de 0 e nunca são repetidos silenciosamente. O respetivo registo indica o motivo.

Eis como corrigir cada causa:

  • Se o Helm estiver a aguardar com --wait, pare-o, desinstale e instale novamente sem a flag. Depois, aguarde pelos serviços:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Para erros de pull, verifique global.imageRegistry e, para Enterprise, o token de pull na página Pull tokens and install commands da sua conta.
  • Para volumes Pending, defina storage.className para uma classe de armazenamento que o cluster tenha, ou torne uma predefinida.
  • Se faltar o cert-manager, instale o cert-manager v1.21.3 e execute a instalação novamente.
  • Para um hook falhado, corrija o que o respetivo registo indica e execute a instalação novamente.

Um pod aguarda pelo seu esquema

O pod de um serviço permanece em Init:0/1 durante minutos. Cada serviço que utiliza a base de dados tem um init container, wait-for-schema, que retém o pod até que o livro de registo de releases mostre as suas migrações aplicadas para a imagem desta release. Isso é normal nos primeiros minutos de uma instalação ou atualização, enquanto os hooks de migração são executados. É um problema quando não termina.

Leia o registo do init container:

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

O registo indica o componente, as cadeias de migração pelas quais aguarda e o seu limite de tempo, e depois imprime uma linha sempre que o seu estado muda:

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
A linha de progresso diz O que significa
Quais as cadeias que ainda faltam aplicar para esta release Os hooks de migração indicados não terminaram. Verifique esses Jobs.
Que o livro de registo de releases não pode ser lido, com o erro da base de dados O Postgres não está a responder, ou o livro de registo não existe porque o bootstrap da base de dados não foi executado.
FAILED (<component>): after <n>s, … Desistiu após schemaWait.timeoutSeconds (1800 por predefinição). O init container reinicia; o serviço em si nunca chegou a iniciar.

Uma cadeia que nunca é aplicada significa quase sempre que o seu Job de migração falhou. Encontre-o com kubectl -n nexus get jobs e leia o respetivo registo. Corrija o que ele indica (um disco cheio, uma base de dados externa que o migrador não consegue alcançar, um conflito de funções) e execute helm upgrade com os mesmos valores: os hooks são executados novamente, e é seguro voltar a executar cada um deles.

Aumente schemaWait.timeoutSeconds apenas quando uma migração for lenta e saudável, como pode acontecer numa primeira migração de grandes dimensões num armazenamento lento. Aumentá-lo para ocultar um Job falhado apenas faz com que o pod aguarde mais tempo por algo que nunca chegará.

O cofre de chaves está selado

Após um corte de energia, um reinício de nó ou um reinício do runtime de contentores, os pods voltam e a consola carrega, mas tudo o que necessita de uma chave falha ou aguarda. O unsealer inicia selado após cada reinício do seu nó, e o arquivo de chaves não consegue desselar-se a si próprio até que o unsealer esteja aberto.

Pergunte ao OpenBao em cada pod:

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 $?"

A saída 0 significa desselado, 2 significa selado, e 1 significa que não conseguiu responder (pergunte novamente dentro de um minuto). Execute o mesmo contra openbao-0 com -tls-server-name=openbao para o arquivo de chaves. Se o unsealer estiver desselado e o arquivo de chaves não estiver, o arquivo de chaves está a desselar-se a si próprio; dê-lhe um minuto.

Para corrigir um unsealer selado, um custodiante executa o unseal.sh do chart com a sua própria identidade age. O Capítulo 2.15, Dia dois: operar o Nexus, tem o comando completo. A saída do script indica o que aconteceu:

Saída Significado O que fazer
0 Desselado Verifique kubectl -n nexus get deploy,statefulset dentro de um minuto.
1 Ainda selado, ou uma chamada de desselagem falhou Leia as linhas de partes (shares) que imprimiu; execute-o novamente.
2 Falta um pré-requisito A mensagem indica-o: AGE_IDENTITY, um binário como age ou jq, ou uma definição de modo direto.
3 Esta identidade não consegue desencriptar as partes Não é um custodiante desta instalação. Nada foi submetido. Encontre um custodiante que o seja.

Não é possível iniciar sessão por HTTP

A consola carrega num endereço http://, ou através de um kubectl port-forward para 127.0.0.1, e o início de sessão falha. O pedido de passkey nunca aparece, ou o início de sessão volta em ciclo para o princípio.

O início de sessão necessita da própria origem HTTPS da consola. A consola aceita um início de sessão apenas a partir de https://<hosts.console>, mantém a sessão num cookie __Host- marcado como Secure (que um navegador apenas armazena através de HTTPS), e a passkey do primeiro administrador necessita de uma página com um certificado válido. Os navegadores recusam passkeys por trás de um erro de certificado. Um port-forward para http://127.0.0.1 nunca permite iniciar sessão.

Verifique o que o navegador realmente alcançou:

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

O primeiro deve responder através de HTTPS com um certificado em que a sua máquina confie. O segundo deve mostrar os três anfitriões com os nomes que definiu em hosts.*.

Para o corrigir, aceda à consola em https://console.harrow.example, o nome exato em hosts.console, com um certificado em que o navegador confie. Com tls.mode: existing, verifique se tls.existingSecret contém um certificado para os três anfitriões. Com tls.mode: cert-manager, verifique se o ClusterIssuer o emitiu. Com tls.mode: none, o Transport Layer Security (TLS) termina no seu próprio balanceador de carga, e é aí que o certificado tem de estar correto. Para uma autoridade de certificação privada, instale o respetivo certificado nas máquinas a partir das quais os seus administradores iniciam sessão.

O código de reivindicação expirou

Em Reclamar esta instalação, a página recusa o código com CLAIM_CODE_EXPIRED (410). Um código de reclamação é composto por três grupos de quatro caracteres. Funciona uma vez, durante 30 minutos, com 5 tentativas. Após isso, ou após a quinta tentativa errada, fica inválido, e nada foi reclamado ou alterado.

Crie um novo código a partir do terminal que tem acesso ao cluster:

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

Ele imprime um código novo e a impressão digital da instalação. Introduza o código na página de reclamação dentro de 30 minutos e compare novamente a impressão digital.

Reclamar esta instalação
Reclamar esta instalação
Reclamar esta instalação. O código do terminal entra em três grupos, e a página mostra a impressão digital completa em grupos de quatro para comparar; um código expirado é recusado com CLAIM_CODE_EXPIRED e nada é reclamado.

Duas respostas relacionadas:

  • RATE_LIMITED (429) na página de reclamação significa que a página teve várias tentativas no último minuto. Aguarde o número de segundos indicado. Se não fez essas tentativas, outra pessoa na sua rede está a tentar aceder à página; descubra quem é antes de reclamar.
  • TRANSITION_NOT_PERMITTED (409) significa que a instalação já foi reclamada e a sua página de reclamação foi desativada em definitivo. Inicie sessão em vez disso. Se não foi você a reclamá-la, trate isso como um incidente de segurança.

A impressão digital não corresponde

A página de reclamação mostra CLAIM_FINGERPRINT_MISMATCH (403), ou pode ver por si mesmo que os oito grupos de quatro na página diferem daqueles que o seu terminal imprimiu. Mesmo um único grupo diferente significa que o navegador está a comunicar com uma instalação diferente.

Pare. Não digite o código nessa página. Algo que não a sua instalação pode estar a responder nesse endereço, possivelmente uma máquina configurada para intercetar o primeiro administrador. Se a reclamasse, essa máquina ficaria com a sua organização. A sua própria instalação permanece inalterada e ainda por reclamar.

Verifique para onde aponta o nome e qual o certificado que respondeu:

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

O endereço deve ser o do seu controlador de ingress, e o certificado deve ser o que instalou para hosts.console.

A impressão digital não coincide
A impressão digital não coincide
As impressões digitais diferem em três dos oito grupos. A página diz para parar, explica quem poderá estar a responder e lista o que verificar antes de tentar novamente.

Para o corrigir, entregue à sua equipa de segurança o endereço que respondeu e guarde o registo de instalação, que regista a impressão digital impressa pela instalação. Corrija o registo de Domain Name System (DNS) ou o proxy que o enviou para outro local. Depois, crie um novo código de reclamação com nexusctl claim-code --administrator <email> e reclame a partir de um navegador numa rede em que confie, comparando novamente todos os oito grupos.

A licença é recusada

A importação em Importar a licença, Importar uma nova licença ou nexusctl licence import responde com uma recusa. Uma importação recusada não altera nada: a licença em vigor permanece em vigor e o limite mínimo do relógio não se move.

Leia o código e o passo:

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

O corpo da recusa contém code, message, refused_at (o passo que falhou) e troubleshooting. Para ver o estado da licença em vigor, leia GET https://auth.harrow.example/api/v1/installation/licence/state com o mesmo token.

Código HTTP Causa habitual Correção
LICENCE_SIGNATURE_INVALID 422 O ficheiro foi editado, reformatado ou guardado novamente, ou falta uma assinatura Transfira-o novamente a partir da sua conta e importe-o intacto
LICENCE_FORMAT_INVALID 422 Não é uma licença: ficheiro errado, truncado ou envolvido noutro objeto Envie o ficheiro exatamente como a Adverant o forneceu
LICENCE_ROOT_UNKNOWN 422 Assinada com uma chave que esta release não inclui Atualize, ou peça uma licença assinada para a sua release
LICENCE_MATRIX_MISMATCH 422 Escrita para uma matriz de edição mais recente, ou concede um grupo que esta compilação desconhece Atualize, ou peça uma licença escrita para a sua release
LICENCE_OTHER_INSTALLATION 409 Emitida para outra instalação, frequentemente a licença do cluster de teste em produção Peça uma licença para a identidade desta instalação
LICENCE_REVOKED 403 A Adverant retirou-a Peça uma nova licença à Adverant
LICENCE_LOCKED 403 O seu starts_on é posterior à data atual Importe-a no seu primeiro dia ou após essa data
TRANSITION_NOT_PERMITTED 409 Este ID de licença já foi importado Nada a fazer se estiver em vigor; peça à Adverant se os termos tiverem de mudar
RECORD_NOT_FOUND 404 A instalação não foi declarada, pelo que ainda não tem identidade Conclua o passo do primeiro administrador e, depois, importe
TENANT_NOT_A_PARAMETER 403 O corpo indica uma organização no seu nível superior Envie apenas o ficheiro da licença como corpo

Duas coisas parecem problemas de licença, mas não são. Uma leitura de estado que contenha LICENCE_CLOCK_BEHIND_FLOOR significa que o relógio do nó indica uma hora anterior à última hora que a instalação viu; corrija a hora do nó e, se o relógio se tiver adiantado e levado consigo o limite mínimo, peça à Adverant um token de reposição de hora. E uma licença que é importada mas continua a mostrar um grupo como demonstração (teaser) geralmente não concede esse grupo: leia as concessões na página da licença antes de mais nada.

Sem respostas de IA

O assistente de inteligência artificial (IA) mostra MODEL_NOT_CONNECTED (503), um passo do fluxo de trabalho falha com NO_PROVIDER_FOR_ROLE (422), ou as respostas simplesmente param.

O conjunto (pool) da organização não tem nenhuma chave que possa responder, ou o router não consegue alcançar o fornecedor. Cada organização traz a sua própria chave de modelo. Sem nenhuma chave em utilização, não há IA, por conceção, e nenhuma chave partilhada a substitui.

Verifique o conjunto e a escolha do router, cada um com o próprio token de acesso da pessoa:

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

O primeiro lista cada fornecedor, se pode responder e porque não pode ("No key in use: 1 withdrawn, 1 lapsed"), e o estado de cada chave. O segundo responde com o modelo que o router utilizaria para a organização, ou a sua recusa por extenso. Depois, verifique o caminho de saída do cluster com estes dois comandos:

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

O que significa cada resultado:

Encontra Correção
Nenhuma chave no conjunto Um proprietário ou administrador adiciona uma chave de organização no painel de controlo de IA ou em Definições, Modelos de IA
Chaves invalid, expired ou exhausted Adicione uma chave nova; a antiga permanece listada como histórico
Chaves resting Aguarde: uma chave que falha descansa durante 60 segundos e, após 5 falhas seguidas, é desligada (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE com chaves em utilização A função não tem atribuição e nada corresponde; defina a função na política de encaminhamento
MODEL_CAPABILITY_UNAVAILABLE (422) O pedido necessita de uma capacidade, ou de uma residência, que nenhum fornecedor no conjunto oferece; ative um que a ofereça
Nenhuma política nexus-operator-egress, ou os intervalos do fornecedor estão em falta na mesma Adicione os intervalos, escritos na notação Classless Inter-Domain Routing (CIDR), a networkPolicy.externalEgressCIDRs e atualize
Um servidor de modelos local que não responde Verifique ai.localProvider.baseUrl, liste o servidor em ai.installationHosts e permita o respetivo intervalo em networkPolicy.externalEgressCIDRs

Uma chave de fornecedor alojado que funciona a partir de um computador portátil e falha na instalação deve-se quase sempre à política de rede. O namespace nega o tráfego de saída (egress) por predefinição.

Respostas 429

Um cliente recebe a resposta 429 Too Many Requests. O Nexus tem quatro locais que o podem indicar, e o corpo diz-lhe qual deles foi.

Onde Código e detalhe O que alterar
nexus-auth, por pessoa com sessão iniciada RATE_LIMITED com limit, windowSeconds e retryAfterSeconds auth.rateLimitPerMinute (predefinição 5000), para automatização intensiva
Um limite de chave de script, aplicação ou unidade (Enterprise) RATE_LIMITED indicando a chave e o seu limite O limite em Definições, Limites de taxa, com um motivo
A página de reclamação da primeira execução RATE_LIMITED com retry_after_seconds Nada: aguarde e descubra quem mais está a tentar aceder à página
Um fornecedor de modelos O router trata-o como uma falha passageira e passa para o fornecedor seguinte Adicione outra chave ou fornecedor se acontecer com frequência

Cada um deles inclui um cabeçalho Retry-After. Um cliente bem comportado aguarda esse tempo e não tenta novamente mais cedo.

Se parecer que todos os utilizadores em simultâneo partilham um único limite, verifique proxy.trustedCIDRs. Quando não abrange a rede de pods do seu controlador de ingress, o nexus-auth não pode confiar no cabeçalho X-Forwarded-For e vê todos os pedidos como provenientes do controlador. A predefinição, 10.42.0.0/16, adequa-se apenas ao k3s.

kubectl get pods -A -o wide

Encontre o endereço do pod do controlador de ingress na saída e certifique-se de que proxy.trustedCIDRs o abrange.

Erros de atualização

A atualização foi revertida. A página Atualização mostra UPGRADE_ROLLED_BACK: um passo falhou, todos os motores voltaram à release anterior e os dados não foram alterados. A página indica o passo. Um caso comum é um volume demasiado pequeno para a nova disposição de um arquivo. Corrija o que é indicado, execute nexusctl upgrade plan --bundle <file> novamente e, depois, aplique. A cópia de segurança é efetuada novamente primeiro.

O chart recusa renderizar com EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. O Secret nexus-generated contém EXTERNAL_KEY_ENCRYPTION_KEY num formato que o chart não consegue utilizar. Tem de ser base64 de 32 bytes, ou a chave bruta de 32 bytes de uma instalação mais antiga. Alguém editou ou substituiu o Secret. Reponha a chave sob a qual os dados desta instalação estão selados, como base64 dos seus 32 bytes (printf %s "$OLD" | base64), e atualize novamente. Não deixe o chart criar uma nova: os dados selados sob a chave antiga ficariam ilegíveis.

Os scripts são recusados com TOKEN_ORG_MISSING após a atualização. Qualquer serviço que verifique chaves de interface de programação de aplicações (API) através do nexus-auth recusa agora uma chave sem organização, com 403 TOKEN_ORG_MISSING. Atribua uma organização a cada uma dessas chaves, ou emita uma nova chave.

As chaves comunicam a aplicação errada durante uma hora. Limpe as entradas de chaves em cache na cache do nexus-auth, o arquivo Valkey da instalação. O Capítulo 2.15, Dia dois: operar o Nexus, tem o comando, para o arquivo no cluster e para um externo.

Um hook de migração falhou. O helm upgrade comunica a falha de um hook de pré-atualização. O esquema avança antes de os novos pods serem implementados, pelo que a release em execução continua a servir pedidos. Leia o registo do Job com kubectl -n nexus logs job/<job-name>, corrija o que ele indica e execute a atualização novamente.

Os serviços não conseguiram utilizar as suas tabelas durante alguns segundos. Na primeira atualização de uma instalação feita a partir de um chart anterior, cada serviço perde os seus antigos direitos de tabela predefinidos e recupera os seus próprios a partir da sua própria migração. O intervalo é de segundos. Atualize num período calmo, ou escale os serviços para zero primeiro.

A release em disco foi recusada. A importação a partir de suporte mostra MEDIA_SIGNATURE_INVALID (422): os ficheiros não estão assinados pela chave de release instalada nesta instalação. Nada foi carregado e a release em execução continua a ser executada. Guarde o suporte para a sua equipa de segurança e peça um novo suporte à Adverant através da troca offline.

Uma recusa de renderização do chart

helm install, helm upgrade ou helm template para antes de algo ser aplicado, com uma mensagem que começa por um código ou indica um valor. O chart recusa valores que não consegue executar em segurança. Nada mudou no cluster.

Renderize o chart isoladamente para ver todas as recusas sem tocar no cluster. Utilize o chart Enterprise que transferiu em vez do endereço oci:// no Enterprise, e defina networkPolicy.apiServerCIDRs nos valores, porque uma renderização offline não o consegue ler a partir do cluster:

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

O preflight verifica os mesmos valores de identidade na sua secção "time and keys" e comunica os mesmos códigos. A sua saída é 0 quando a instalação pode avançar (os avisos não bloqueiam), 1 quando pelo menos uma verificação falhou, e 2 quando não pôde ser executado.

A verificação prévia não pode continuar
A verificação prévia não pode continuar
O preflight não pode continuar. As verificações que falharam surgem primeiro, cada uma com a respetiva correção, e a instalação permanece bloqueada com PREFLIGHT_FAILED até que passem.
Recusa Causa Correção
INSTALLATION_NAME_MISSING keys.installationName está vazio Defina-o com o próprio nome desta instalação, correspondendo a ^[a-z][a-z0-9-]{0,62}$. É permanente assim que o arquivo de chaves inicia pela primeira vez
INSTALLATION_NAME_EXAMPLE O nome é o que consta nos ficheiros de valores de exemplo do chart Defina o seu próprio nome
keys.installationName "…" does not match … Maiúsculas, underscores ou um dígito inicial Utilize letras minúsculas, dígitos e hífenes, começando por uma letra
KEYS_CUSTODIAN_MISSING keys.custody.recipients está vazio Liste os destinatários age dos seus custodiantes, as metades públicas
KEYS_CUSTODIAN_EXAMPLE Um destinatário é o custodiante de exemplo dos ficheiros de valores do chart, cuja identidade ninguém detém Substitua-o pelos destinatários dos seus próprios custodiantes
keys.custody.recipients: … Um destinatário num formato para o qual o Job de custódia não consegue encriptar Utilize age1…, age1tag1…, age1tagpq1…, age1pq1… ou age1se1…, em minúsculas
NEXUS_EDITION_INVALID edition não é community nem enterprise Defina um dos dois
edition=… but enterprise.enabled=… Os dois estão em desacordo Defina enterprise.enabled: true exatamente quando edition for enterprise
global.imageRegistry is required Nenhum registo indicado Defina o registo a partir do qual os seus nós transferem as imagens
hosts.<name> is required Falta um anfitrião público Defina hosts.console, hosts.api e hosts.auth
tls.existingSecret is required when tls.mode is existing Nenhum Secret de certificado indicado Indique o Secret, ou escolha outro tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Nenhum emissor indicado Indique o seu ClusterIssuer
dataTier.<store>.external.host is required when mode is external Um arquivo externo sem endereço Indique o respetivo anfitrião e o seu Secret em existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template não tem nenhum cluster onde os procurar Indique os endereços do servidor da API como intervalos /32
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID A chave gerada em nexus-generated tem o formato errado Consulte "Erros de atualização" acima

Um ficheiro de valores que utilize uma chave que o chart não tem, ou um valor do tipo errado, é recusado pelo esquema do chart antes de qualquer um destes. telemetry.enabled: true é um exemplo: o esquema aceita apenas false.

Enviar um pacote de suporte

Quando nada disto resolver o problema, envie à Adverant um pacote de suporte (support bundle) com o seu pedido de suporte.

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

<request-number> é o número do pedido que abriu na página Suporte e pacotes de suporte da sua conta. Pode criar o mesmo pacote a partir da página Pacote de suporte da consola, em Esta instalação.

O pacote contém registos dos motores das últimas 24 horas, detalhes de estado de funcionamento e de versão, definições sem os respetivos segredos e os relatórios de preflight e de instalação. Antes de ser escrito, a ocultação (redaction) substitui nomes, segredos e endereços, e pode ler uma pré-visualização daquilo que é exatamente enviado. As mensagens, os ficheiros e a memória das pessoas nunca são recolhidos.

Carregue-o no pedido na sua conta, ou guarde-o num suporte de dados e transporte-o para o exterior se a instalação não tiver ligação externa. Apenas os engenheiros de suporte indicados no pedido o podem abrir, e é apagado após 30 dias. Indique no pedido qual dos problemas acima estava a analisar e o que mostraram as verificações deste capítulo: isso poupa uma troca de mensagens.