Iniciar sessãoAgendar apresentação

Capítulo 2.11

Variações: repositórios externos, TLS e ingress

Os valores que adaptam o Nexus a um cluster que não está em branco, incluindo TLS (Transport Layer Security), juntamente com bases de dados que já executa, os seus próprios certificados, outro controlador de ingress, classes de armazenamento, correio eletrónico, proxies, réplicas e Kubernetes gerido.

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

17 minutos de leitura

O cluster de produção da Harrow Port Authority não é um cluster em branco, e apenas a sua configuração de TLS (Transport Layer Security) divide-se em três partes. A equipa de bases de dados executa o PostgreSQL nas suas próprias máquinas e pretende manter todas as bases de dados nesse local, com cópias de segurança feitas à sua maneira. Os certificados provêm da CA (autoridade de certificação) interna da Harrow através do cert-manager. O controlador de ingress não é o Traefik e reside no seu próprio namespace. Nada disto requer uma bifurcação (fork) do chart. Cada diferença é um valor, e este capítulo aborda-os pela ordem em que Tomás Reilly os encontrou.

Cada bloco de valores neste capítulo é um fragmento. Integre os que necessita no seu próprio ficheiro de valores, juntamente com global, hosts, edition e keys do capítulo 2.6, Instalar a edição Community no Kubernetes. O esquema do chart recusa qualquer chave que desconheça, pelo que uma chave com erros ortográficos faz falhar o helm lint --strict e a instalação, em vez de ser ignorada. Isto é intencional: um erro de digitação em dataTier que deixasse silenciosamente um armazenamento no cluster seria pior do que um erro.

Repositórios de dados externos

O Nexus guarda os seus dados em cinco armazenamentos. Por predefinição, cada um é executado dentro do cluster a partir da própria imagem assinada da versão de lançamento, com o seu próprio volume.

Armazenamento Chave de valores Predefinição no cluster Volume predefinido
PostgreSQL 16 com PostGIS 3 e pgvector 0.8 dataTier.postgres a imagem de lançamento 50Gi
Valkey 8.1 dataTier.valkey a imagem de lançamento 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j a imagem de lançamento 20Gi
Qdrant 1.15 dataTier.qdrant a imagem de lançamento 10Gi
SeaweedFS 4.48, o armazenamento de objetos compatível com o Amazon S3 (Simple Storage Service) dataTier.objectStore a imagem de lançamento 50Gi

Qualquer um deles pode ser substituído por um que seja executado por si. Defina o respetivo mode como external, indique o seu anfitrião e especifique o nome de um Secret que contenha as suas credenciais. Adicione também o endereço do armazenamento a networkPolicy.externalEgressCIDRs (consulte a secção sobre políticas de rede abaixo), uma vez que o namespace bloqueia todo o restante tráfego de saída (egress). Para um armazenamento externo, o chart não gera nenhum recurso desse armazenamento: nem StatefulSet, nem Service, nem volume. Os serviços ligam-se ao anfitrião que indicou.

# harrow-external-postgres.yaml (Helm values)
dataTier:
  postgres:
    mode: external
    port: 5432
    sslmode: verify-full
    external:
      host: pg-nexus.db.harrow.example
      existingSecret: harrow-postgres

O Secret é criado por si, antes da instalação, no namespace onde o Nexus será instalado. O chart guarda apenas o respetivo nome: os pods que necessitam de uma credencial leem-na a partir do seu Secret quando iniciam, e nada é copiado para os próprios Secrets do chart. Se alterar uma credencial, basta reiniciar os pods que a utilizam; não há nada para gerar novamente.

Cada armazenamento procura nomes de chaves fixos no respetivo Secret:

Armazenamento Chaves no respetivo Secret
PostgreSQL username e password para um superutilizador nesse servidor, e ca.crt, a autoridade de certificação (CA) que assinou o certificado do servidor
Valkey password
Neo4j username e password
Qdrant api-key
Armazenamento de objetos access-key e secret-key

Carregue cada valor a partir de um ficheiro, para que fique fora do histórico da sua shell e fora do seu ficheiro de valores:

kubectl create namespace nexus
kubectl -n nexus create secret generic harrow-postgres \
  --from-file=username=./pg-username --from-file=password=./pg-password --from-file=ca.crt=./harrow-db-ca.crt

Um armazenamento externo sem um Secret indicado interrompe a geração (render), tal como acontece quando não tem um anfitrião definido.

PostgreSQL

O servidor externo tem de oferecer o mesmo que a imagem de lançamento oferece: PostgreSQL 16 com PostGIS 3 e pgvector. O tráfego para o mesmo é sempre encriptado e validado em função do ca.crt presente no seu Secret. Defina sslmode como verify-full, o que também verifica se o certificado do servidor inclui o nome do anfitrião que indicou, ou como verify-ca. Com um servidor externo, a geração recusa disable e require. O Postgres no cluster funciona de forma oposta: o seu tráfego nunca sai do namespace, a política de rede mantém-no lá e aceita apenas disable. Qualquer que seja o modo escolhido, o certificado tem de incluir o nome do anfitrião indicado em external.host, uma vez que alguns dos serviços verificam o nome em cada ligação.

Na instalação, um Job de arranque (bootstrap) liga-se ao servidor com a conta presente no seu Secret e cria as funções (roles) com as quais o Nexus é executado. Cria uma função de migração que detém o esquema, uma função de execução (runtime) e uma função de início de sessão para cada serviço. O Nexus gera as respetivas palavras-passe e guarda-as. Nenhuma delas é um superutilizador e nenhuma pode contornar a segurança ao nível da linha (row-level security), pelo que todas as políticas de isolamento na base de dados se aplicam a todos os serviços. O próprio processo de arranque necessita, de facto, de um superutilizador: um dos seus passos bloqueia uma função integrada do PostgreSQL, e apenas um superutilizador o pode fazer. Apenas o arranque e o passo de aprovisionamento da própria consola utilizam esta conta. Por esse motivo, um serviço de base de dados gerido cuja função de administrador não seja um verdadeiro superutilizador não pode alojar a base de dados do Nexus.

O Job verifica o seu servidor antes de efetuar qualquer alteração. Caso a conta no seu Secret não seja um superutilizador, o processo para sem alterar nada. Se já existir uma função chamada nexus com SUPERUSER ou BYPASSRLS, o Job para com o erro nexus-db-bootstrap: role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done. Remova esses atributos dessa função, ou utilize um servidor onde o nome esteja disponível, e volte a instalar.

Valkey, Neo4j, Qdrant e o armazenamento de objetos

Os outros quatro aceitam as mesmas três definições: mode, external.host e external.existingSecret. Eis os quatro alterados para os serviços próprios da Harrow:

# harrow-external-stores.yaml (Helm values)
dataTier:
  valkey:
    mode: external
    external: { host: valkey.db.harrow.example, existingSecret: harrow-valkey }
  neo4j:
    mode: external
    external: { host: neo4j.db.harrow.example, existingSecret: harrow-neo4j }
  qdrant:
    mode: external
    external: { host: qdrant.db.harrow.example, existingSecret: harrow-qdrant }
  objectStore:
    mode: external
    external: { host: objects.db.harrow.example, existingSecret: harrow-objects }

Execute as versões incluídas nas imagens de lançamento, listadas na tabela acima, nas portas que os serviços utilizam. O Valkey escuta na 6379 e o Neo4j na 7687; o Qdrant utiliza a 6333 e o armazenamento de objetos a 8333. O armazenamento de objetos tem de ser compatível com S3. A palavra-passe do Valkey é incluída num endereço de ligação dentro de cada pod, pelo que deve conter apenas letras e dígitos (os caracteres -._~ também são permitidos).

Se mode for external e external.host estiver vazio, a geração para com o erro dataTier.<store>.external.host is required when mode is external. Mover um armazenamento do interior do cluster para o exterior depois de os utilizadores já terem utilizado o Nexus implica uma migração de dados que terá de realizar por conta própria, uma vez que o chart não copiará nada por si. Tome esta decisão antes da primeira instalação.

O armazenamento de chaves, OpenBao, não consta desta lista e não pode ser externo. Faz parte da identidade da instalação e é executado no cluster em todas as instalações.

TLS na periferia pública

tls.mode decide apenas como os três anfitriões públicos obtêm os seus certificados, e nada mais. O tráfego entre serviços utiliza sempre TLS mútuo com certificados da própria CA local do chart, emitidos pelo cert-manager, independentemente do modo. Não existe uma malha de serviços (service mesh), e istio.enabled permanece como false.

tls.mode Quem cria o certificado O que deve definir
existing (a predefinição) O utilizador. Um Secret contém um certificado para os três anfitriões. tls.existingSecret
cert-manager Um ClusterIssuer que já tenha em execução. O chart solicita-lhe um certificado por anfitrião. tls.clusterIssuer
none Ninguém no cluster. O TLS termina antes de chegar ao mesmo, no seu balanceador de carga ou proxy. Nada, mas leia o aviso abaixo

existing

# harrow-tls-existing.yaml (Helm values)
tls:
  mode: existing
  existingSecret: harrow-public-tls

Cada Ingress serve o Secret harrow-public-tls, pelo que o respetivo certificado tem de incluir os nomes console.harrow.example, api.harrow.example e auth.harrow.example. Crie-o no namespace antes de instalar:

kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

A verificação prévia (preflight) lê o certificado, avisa quando este expira num prazo de 30 dias e indica o nome do Secret caso esteja em falta. Quando o modo é existing e o nome está vazio, a geração para com o erro tls.existingSecret is required when tls.mode is existing.

cert-manager

# harrow-tls-cert-manager.yaml (Helm values)
tls:
  mode: cert-manager
  clusterIssuer: harrow-internal-ca

O chart adiciona a anotação cert-manager.io/cluster-issuer a cada um dos três Ingresses, e o cert-manager cria os Secrets nexus-console-tls, nexus-api-tls e nexus-auth-tls. Sem tls.clusterIssuer, a geração para com o erro tls.clusterIssuer is required when tls.mode is cert-manager.

Se o seu emissor utilizar ACME (Automatic Certificate Management Environment) com o desafio HTTP-01, não é necessário mais nada. O chart não adiciona nenhum redirecionamento próprio, pelo que um pedido para /.well-known/acme-challenge/ chega inalterado ao resolvedor (solver) do seu emissor. Num local sem acesso à Internet, o resolvedor também é uma imagem: coloque a imagem cert-manager-acmesolver do cert-manager no seu registo, caso contrário, todos os pods de desafio ficarão a aguardar em ErrImagePull.

nenhum

# harrow-tls-none.yaml (Helm values)
tls:
  mode: none
proxy:
  trustedCIDRs: "10.30.0.0/16"

Com none, os Ingresses não incluem nenhuma secção TLS. Utilize esta opção quando um balanceador de carga ou proxy inverso à frente do cluster terminar o TLS para os três anfitriões.

proxy.trustedCIDRs indica os saltos de proxy em cujo cabeçalho X-Forwarded-For o nexus-auth confia. A predefinição, 10.42.0.0/16, corresponde à rede de pods do k3s, onde o respetivo controlador de ingress é executado. Em qualquer outro cluster, defina este valor para a rede que os pods do seu controlador de ingress utilizam, para que os limites de taxa de início de sessão e os registos de auditoria vejam o endereço do utilizador e não o do proxy.

Endereço, certificado, proxy e correio
Endereço, certificado, proxy e correio
Após a instalação, o endereço, o certificado, o proxy e o correio têm, cada um, o seu próprio teste numa única página, e o resultado é apresentado por extenso.

Controladores de ingress

O chart cria três Ingresses padrão do Kubernetes, um por cada anfitrião público. Cada um encaminha o caminho / para um Service.

Ingress Anfitrião Service e porta
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Três valores dão-lhes forma, e um valor na política de rede tem de coincidir.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className indica o nome da IngressClass. Se for deixado em branco, o chart omite a classe e a classe predefinida do cluster assume os três Ingresses. A verificação prévia (preflight) confirma se a classe existe ou, quando não é indicado nenhum nome, se existe exatamente uma classe marcada como predefinida.
  • ingress.annotations é adicionado aos três Ingresses. Os valores são cadeias de texto (strings), pelo que deve colocar números e booleanos entre aspas. Utilize-o para as definições específicas do seu controlador.
  • ingress.enabled: false não gera nenhum Ingress, destinando-se a locais que encaminham o tráfego para os três Services de outra forma.
  • networkPolicy.ingressNamespace é o namespace no qual o seu controlador de ingress é executado.

Este último costuma induzir as pessoas em erro. Por predefinição, a política de rede do chart bloqueia todo o tráfego de entrada no namespace e, em seguida, permite o acesso do controlador de ingress aos três Services públicos apenas a partir do namespace que indicar. A predefinição, kube-system, está correta para o k3s, que executa o Traefik nesse local. Com qualquer outro controlador, se deixar este valor inalterado, o controlador não conseguirá alcançar o Nexus: os Ingresses existem, o controlador regista tempos limite de ligação excedidos (connection timeouts) e o navegador recebe um erro de gateway. A verificação "Ingress ports" da verificação prévia (preflight) procura um Service nesse namespace aberto nas portas 80 e 443, como LoadBalancer ou NodePort, e a respetiva linha fix indica o nome deste valor.

À esquerda, uma caixa "ingress controller" encontra-se dentro de um limite tracejado com a etiqueta "namespace: networkPolicy.ingressNamespace (kube-system on k3s)". Três setas saem da mesma, com as etiquetas console.harrow.example, api.harrow.example e auth.harrow.example. Estas atravessam uma linha contínua com a etiqueta "nexus namespace: default deny" e chegam a três caixas: "nexus-alpha :3000", "nexus-gateway :9092" e "nexus-auth :9101". Uma quarta seta, a cinzento, proveniente de uma caixa "any other namespace" para na linha contínua com uma pequena cruz.
Os três anfitriões públicos, o namespace do controlador de ingress e a política de rede que permite apenas esse namespace.

O resto da política de rede

networkPolicy.enabled é true por predefinição e deve permanecer assim. Com esta definição, nada no namespace comunica com o exterior, exceto o DNS (Domain Name System), a API (interface de programação de aplicações) do Kubernetes para os revisores de tokens e os endereços que listar.

# harrow-network.yaml (Helm values)
networkPolicy:
  apiServerCIDRs: ["10.30.0.1/32"]
  externalEgressCIDRs: ["10.30.40.25/32"]

apiServerCIDRs é o endereço do servidor da API no formato de CIDRs (Classless Inter-Domain Routing) /32. Se estiver vazio, o chart lê-o a partir do cluster durante a instalação. O comando helm template não tem um cluster a partir do qual ler, pelo que deve indicá-lo aí. externalEgressCIDRs corresponde a tudo o resto a que uma carga de trabalho (workload) pode aceder, estando vazio por predefinição. A Harrow lista aqui o seu retransmissor de correio (mail relay). Todos os armazenamentos de dados externos fora do namespace também têm de ser listados aqui, caso contrário, a política de bloqueio por predefinição impede que os serviços os alcancem.

Apenas três cargas de trabalho comunicam com o servidor da API: o serviço de evidências nexus-probitas, o orquestrador e o Job de custódia do armazenamento de chaves. Estes verificam os tokens de conta de serviço que outras cargas de trabalho apresentam. A política faculta o endereço do servidor da API, nas portas 6443 e 443, apenas a esses três e a mais nenhum. Se os três não o conseguirem alcançar, não poderão verificar os tokens apresentados por outras cargas de trabalho, pelo que deve indicar todos os endereços que este possa ter.

Escolher um modo TLS

A Harrow escolheu cert-manager com a sua CA interna como ClusterIssuer, e o motivo foi a renovação. Com existing, uma pessoa tem de renovar o certificado no Secret antes que este expire, sendo o aviso de 30 dias da verificação prévia (preflight) o único lembrete. Com cert-manager, a renovação ocorre de forma automática e ninguém tem de se lembrar de o fazer. none é adequado para um local onde todos os endereços públicos já se encontram atrás de um balanceador de carga que termina o TLS para vários sistemas, e onde essa equipa é responsável pelos certificados. Qualquer que seja a sua escolha, o certificado que um navegador vê tem de ser um no qual o navegador confie. Um certificado autoassinado cujo aviso os utilizadores ignorem inutiliza as chaves de acesso (passkeys), uma vez que o Chrome não cria nem utiliza uma chave de acesso perante um aviso de certificado.

Armazenamento, correio eletrónico, réplicas e recursos

Classe de armazenamento

# harrow-storage.yaml (Helm values)
storage:
  className: harrow-ssd
dataTier:
  postgres:
    size: 200Gi
  objectStore:
    size: 500Gi

storage.className aplica-se a todos os PVCs (persistent volume claims) da camada de dados e aos volumes do armazenamento de chaves. Se estiver vazio, assume a classe predefinida do cluster, e a verificação prévia (preflight) falha quando nenhuma classe está marcada como predefinida e não foi indicado nenhum nome. Cada armazenamento no cluster tem o seu próprio size. Os do armazenamento de chaves são keys.openbao.storage.unsealer e keys.openbao.storage.keystore, com keys.receiptsStorage para recibos. Escolha tamanhos adequados para um ano de crescimento.

Correio

# harrow-mail.yaml (Helm values)
smtp:
  existingSecret: harrow-smtp

O Nexus envia convites e avisos através do seu servidor de correio. smtp.existingSecret indica o nome de um Secret que cria, no namespace, com os detalhes do servidor de correio. Tal como acontece com todas as integrações, o chart recebe o nome de um Secret e nunca uma credencial. Lembre-se da política de rede: adicione o endereço do retransmissor (relay) a networkPolicy.externalEgressCIDRs, caso contrário, o correio é retido no limite do namespace. Enquanto o correio não funcionar, os convites não poderão ser enviados, e a lista de verificação do primeiro administrador indica isso mesmo.

Réplicas e recursos

Cada componente principal tem uma contagem de réplicas e recursos do Kubernetes em components, e cada armazenamento no cluster tem recursos em dataTier.

# harrow-sizing.yaml (Helm values)
components:
  console:  { replicas: 2, resources: { requests: { cpu: 200m, memory: 512Mi }, limits: { memory: 1Gi } } }
  auth:     { replicas: 2 }
  gateway:  { replicas: 2, resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 2Gi } } }
  graphrag: { resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 3Gi } } }
dataTier:
  postgres:
    resources: { requests: { cpu: "1", memory: 4Gi }, limits: { memory: 8Gi } }
  neo4j:
    heap: 2G
    pagecache: 1G
    resources: { requests: { cpu: 500m, memory: 4Gi }, limits: { memory: 4Gi } }

O pod predefinido do Neo4j solicita 2 GiB e pode utilizar até 4 GiB. Com 3 GB de heap e cache de página, aumente também o respetivo pedido (request), para que o pod seja colocado num nó que disponha dessa memória.

Os componentes com replicas e resources são console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas e skillsEngine. O serviço de chaves, keys, aceita apenas resources. Estes componentes principais são obrigatórios e não podem ser desativados; o chart executa-os independentemente do que indique o respetivo seletor enabled. Os armazenamentos da camada de dados executam uma réplica cada.

Em armazenamento lento, mais dois valores dão tempo aos serviços para iniciarem: probes.startupFailureThreshold (60 por predefinição) e schemaWait.timeoutSeconds (1800), que definem durante quanto tempo um serviço aguarda pelas migrações da sua base de dados antes de o seu contentor de arranque falhar pelo nome.

Sessões de início de sessão, limites de taxa e anfitriões de modelos privados

Vale a pena conhecer três grupos mais pequenos de valores antes da instalação, pois os utilizadores reparam neles logo no primeiro dia.

# harrow-auth.yaml (Helm values)
auth:
  accessTokenTTL: 15m
  refreshTokenTTL: 12h
  rateLimitPerMinute: 5000
ai:
  installationHosts: [models.harrow.internal, .gpu.harrow.internal]

auth.accessTokenTTL e auth.refreshTokenTTL definem a duração dos dois tokens de uma sessão. As predefinições, 15 minutos e 12 horas, significam que uma pessoa que feche o portátil à noite terá de iniciar sessão novamente de manhã. Reduza a duração do token de atualização (refresh token) se a sua política o exigir, e conte com inícios de sessão mais frequentes.

auth.rateLimitPerMinute é o número máximo de pedidos que um utilizador com sessão iniciada pode fazer ao serviço de início de sessão num minuto antes de este responder com o código 429. A predefinição, 5000, corresponde a cerca de 83 por segundo a partir de uma conta, o que é mais do que suficiente para a consola e para scripts. Uma instalação não tem planos de subscrição, pelo que todos os utilizadores têm o mesmo limite. Reduza-o para reforçar a proteção contra abusos, ou aumente-o para casos de automatização intensiva. A proteção contra ataques de força bruta no início de sessão, como o bloqueio de conta e os limites de tentativas de segundo fator de verificação, é independente e não é definida aqui.

ai.installationHosts lista nomes de anfitrião adicionais dentro da instalação, destinados aos servidores de modelos de IA (inteligência artificial) da própria organização em nomes privados. Cada entrada é um nome de anfitrião, um .suffix que corresponde a todos os nomes abaixo dele, um endereço IP ou um bloco CIDR (Classless Inter-Domain Routing) IPv4. O router trata-os como parte da instalação, a par dos próprios anfitriões da versão de lançamento. O servidor de modelos propriamente dito é indicado em ai.localProvider.baseUrl; o capítulo 2.14, Fornecedores e modelos de IA, aborda ambos.

O que nunca é um valor

Alguns elementos que as pessoas procuram num ficheiro de valores não se encontram lá, de forma intencional.

Ausente do ficheiro de valores Porquê, e onde se encontra em alternativa
A licença É importada após a instalação, na consola ou com nexusctl licence import <file>. Uma licença nunca é um valor do chart nem um ficheiro montado. O Capítulo 2.13, Licenças, contém os detalhes.
Chaves de modelos Cada organização guarda as suas próprias chaves no seu próprio conjunto (pool), introduzidas na consola. Nenhuma credencial de fornecedor de IA é alguma vez um valor do chart.
Reforço da segurança no registo Tanto o CAPTCHA da Internet como a filtragem de rede no registo estão desativados numa instalação, e não existe nenhum valor para ativar qualquer um deles. O CAPTCHA necessitaria de acesso à Internet em cada registo. A filtragem de rede necessitaria de uma base de dados de geolocalização licenciada que o chart não inclui. Em vez disso, o registo de um utilizador desconhecido fica retido a aguardar a aprovação de um administrador, tal como explica o capítulo 2.12, A primeira execução.
Telemetria O esquema aceita uma definição para telemetry.enabled, que é false. Nada sai de uma instalação, e os relatórios próprios da camada de dados (o relatório de utilização do Neo4j, a telemetria do Qdrant) também estão desativados.

Verificar todo o ficheiro antes de instalar

Com os fragmentos integrados num único ficheiro, execute duas verificações no mesmo a partir da sua estação de trabalho. O comando helm lint --strict valida cada chave em função do esquema do chart, e helm template gera toda a versão de lançamento para que a possa ler antes de qualquer recurso ser criado. Os comandos utilizam o endereço do chart da edição Community; para a edição Enterprise, indique antes o caminho do chart Enterprise que transferiu (capítulo 2.7, Instalar a edição Enterprise e aplicar uma licença). Uma geração na sua estação de trabalho não consegue ler o endereço do servidor da API a partir de um cluster, pelo que deve definir primeiro networkPolicy.apiServerCIDRs no ficheiro.

As duas verificações:

helm lint --strict oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 -f harrow-prod-values.yaml
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  -n nexus -f harrow-prod-values.yaml > harrow-render.yaml

Uma chave com erros ortográficos faz falhar a verificação (lint) com a mensagem "additional properties" e indica o nome da chave. Um valor obrigatório em falta, como um anfitrião quando um armazenamento é externo, faz falhar a geração (render) com a frase citada neste capítulo. O comando helm template não tem um cluster a partir do qual ler, pelo que deve indicar networkPolicy.apiServerCIDRs quando efetuar a geração offline, caso contrário, o processo para e solicita esses valores.

Em seguida, execute a verificação prévia (preflight) com o mesmo ficheiro. A verificação prévia é a única validação que lê o cluster e os valores em conjunto: é aí que um namespace de ingress incorreto, uma classe de armazenamento em falta ou um certificado que expira na semana seguinte são detetados antes que alguém dependa da instalação.

Kubernetes gerido

O Nexus é executado em qualquer Kubernetes 1.33 ou posterior compatível, incluindo o serviço gerido de um fornecedor de cloud. Nada no chart é específico de um único fornecedor. O que muda em relação ao k3s é um pequeno conjunto de valores, cada um deles abordado acima:

  • O cert-manager v1.21.3 é instalado primeiro, tal como em qualquer cluster. | Num cluster gerido | O que definir ou verificar | |---|---| | Armazenamento | Indique o nome da classe do fornecedor em storage.className, ou marque uma como predefinida. | | Ingress | Instale o controlador de ingress que utiliza, exponha-o nas portas 80 e 443, defina ingress.className caso não seja o predefinido e defina networkPolicy.ingressNamespace para o respetivo namespace. | | Os saltos de proxy | Defina proxy.trustedCIDRs para a rede de pods desse controlador. | | O servidor da API | Se a instalação não conseguir ler o endereço do servidor da API a partir do cluster, indique-o em networkPolicy.apiServerCIDRs. | | Aplicação de políticas de rede | As políticas do chart apenas produzem efeito onde o plugin de rede do cluster aplica o recurso NetworkPolicy. Escolha uma configuração de cluster que o faça. | | Imagens | Os nós necessitam de alcançar registry.adverant.ai, ou o seu próprio registo indicado em global.imageRegistry. |

Execute a verificação prévia (preflight) antes de mais nada. Esta lê o cluster e o ficheiro de valores em conjunto e imprime cada um destes pontos como uma linha, com a respetiva correção ao lado de cada um que falhe. O Capítulo 2.5, Verificação prévia com o nexusctl, mostra o relatório.

Antes de instalar
Antes de instalar
Uma verificação prévia (preflight) bem-sucedida num cluster de produção. Cada linha corresponde a um requisito, e cada aviso apresenta a respetiva correção na linha abaixo.