Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Gateway Contour — um controlador de ingress nativo do Kubernetes

Este exemplo compila uma stack pequena e real — um gateway de ingress Contour — a partir de um único Aggregate escrito pelo programador, para o Kubernetes. O programador declara o que é o gateway; uma única Recipe de Ops mapeia essa intenção para o chart oficial do Helm project-contour (servido a partir do repositório de charts HTTPS do projeto) e renderiza os objetos do Kubernetes.

O Contour é um controlador de ingress nativo do Kubernetes. O seu plano de controlo observa os recursos Ingress e HTTPProxy do cluster e programa um plano de dados Envoy, que termina o tráfego HTTP e HTTPS dos clientes e o distribui pelos serviços de back-end que esses recursos nomeiam. A sua entrada de encaminhamento são os próprios objetos Ingress do cluster — não um upstream ligado —, pelo que o gateway não recebe nenhuma aresta uses. As aplicações alcançam-no declarando recursos Ingress para a sua classe de ingress. Pelo mesmo motivo, não tem uma forma autónoma em contentor local, pelo que esta família inclui apenas uma Recipe do Helm; não há destino do Compose.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente gateway (core/gateway/contour) que nomeia a classe de ingress que reconcilia.
manifest.yamlMapeia o tipo de gateway para a Recipe do Helm project-contour (contour).
release.yamlDocumento do operador para o destino Kubernetes: a porta do serviço do Envoy e o dimensionamento do plano de controlo e do plano de dados.

O que demonstra

  • Uma única superfície de autoria, realizada por uma Recipe de Ops. O Aggregate é a fonte de verdade sobre o que é o gateway. O Manifest diz como realizá-lo, mapeando o tipo de gateway para uma Recipe pelo nome; a Release fornece o dimensionamento operacional. A intenção do programador e o mapeamento de Ops mantêm-se separados.
  • Plano de controlo e plano de dados a partir de um único componente. A Recipe renderiza as duas metades do controlador de ingress: um Deployment para o plano de controlo do Contour e um DaemonSet para o plano de dados do Envoy, ligados entre si pelo chart.
  • Propriedade da classe de ingress. O valor ingress_class_name do programador flui para o chart, que cria uma IngressClass com esse nome. As aplicações encaminham para o gateway referenciando essa classe nos seus recursos Ingress.
  • Gestão de CRDs. O Contour instala e gere as suas próprias CustomResourceDefinitions (a sua família HTTPProxy). A Recipe deixa a gestão de CRDs ativada por predefinição; desative-se através de infra.overrides.manage_crds quando as CRDs estiverem pré-instaladas.
  • Ponto de entrada do plano de dados. O Service do Envoy é exposto como LoadBalancer por predefinição; o operador define a porta do serviço HTTP através de infra.port e pode mudar o tipo de serviço através de infra.overrides.service_type.
  • Imagens reproduzíveis. A Recipe volta a fixar as imagens do Contour e do Envoy em tags de release explícitas, para que as cargas de trabalho renderizadas referenciem versões fixadas.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example contour-gateway

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd contour-gateway

Compilação

Este espaço de trabalho não inclui nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Os artefactos renderizados ficam em dist/. A compilação resolve o chart upstream no aggrega pull e fixa-o num lockfile.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por si. Se a pasta da área de trabalho ainda não contiver uma pasta `contour-gateway`, chame uma vez a ferramenta `scaffold` com `example` definido como `contour-gateway` e sem `dir`: esta escreve o exemplo numa nova pasta `contour-gateway`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `contour-gateway`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros o build escreveu; encontram-se em `contour-gateway/dist/`.

O que é renderizado

A compilação emite a stack completa do controlador de ingress:

  • um Deployment que executa o plano de controlo do Contour,
  • um DaemonSet que executa o plano de dados do Envoy,
  • as CustomResourceDefinitions do Contour,
  • uma IngressClass chamada contour,
  • um Service LoadBalancer à frente do Envoy na porta HTTP 80 e na porta HTTPS 443,

juntamente com a ConfigMap de suporte, o Job de geração de certificados, o Service do plano de controlo, a NetworkPolicy, o RBAC e a ServiceAccount. As imagens do Contour e do Envoy estão fixadas nas suas tags de release, pelo que todas as cargas de trabalho referenciam uma tag de imagem fixada.