Stack FerretDB — uma base de dados de documentos composta como módulo
Este exemplo compila uma stack pequena e real — uma base de dados de documentos que expõe o protocolo de rede do MongoDB — em manifestos do Kubernetes sintetizados a partir de um único Aggregate escrito pelo programador.
A base de dados de documentos não é um único componente. É um módulo: um subagregado reutilizável que compõe dois componentes de carga de trabalho única —
- um proxy que fala o protocolo de rede do MongoDB e não guarda estado local, e
- um backend, PostgreSQL 17 com a extensão DocumentDB, que persiste os dados num volume.
O módulo liga a sua própria aresta interna do proxy ao backend e exporta o proxy como o seu endpoint público mongo. O Aggregate de nível superior importa o módulo pelo nome e renderiza a stack composta; o operador dimensiona os componentes internos do módulo na Release.
Ficheiros
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: importa o módulo de base de dados de documentos (core/ferretdb). |
manifest-helm-synth.yaml | Mapeia os tipos proxy e backend para as suas Recipes helm synth. |
release-helm-synth.yaml | Documento do operador para o destino Kubernetes. Dimensiona os componentes internos do módulo pelos seus IDs com âmbito de módulo; tudo o que fica com as predefinições do esquema é renderizado de forma autónoma. |
O que demonstra
- Composição como módulo. Uma capacidade com várias cargas de trabalho — uma base de dados de documentos que na realidade é um proxy mais um backend de armazenamento — é empacotada como um subagregado que compõe dois componentes de carga de trabalho única, e não como um único componente monolítico. O módulo é importado pelo nome e reutilizado onde quer que seja necessária uma base de dados de documentos.
- Uma aresta interna dentro do módulo. O proxy declara um uso do backend; o host, a porta, o utilizador e a base de dados dos
providesda Recipe do backend são encaminhados para o proxy e compostos na sua ligação ao PostgreSQL. O compilador encaminha as strings sem as interpretar. - Um endpoint público. O módulo exporta o seu proxy como
mongo, o nome público estável ao qual um consumidor da base de dados de documentos se liga — desacoplado dos nomes dos componentes internos do módulo. - Dimensionamento dos componentes internos pelo operador. A Release endereça os componentes internos do módulo pelos seus IDs com âmbito de módulo (
database.backend,database.proxy) para definir os recursos de computação, sem que o Aggregate do programador repita o dimensionamento físico. - Uma credencial partilhada. O proxy delega a autenticação no seu backend PostgreSQL, pelo que os dois partilham uma única palavra-passe. Este exemplo usa um valor predefinido de desenvolvimento partilhado e escrito inline, pelo que a stack é executada de forma autónoma, sem nenhum segredo externo.
- Uma string de ligação sem palavra-passe. O URL de ligação PostgreSQL do proxy é renderizado sem a palavra-passe incorporada; a palavra-passe é fornecida separadamente na variável de ambiente standard da libpq
PGPASSWORD, que o controlador incorpora na ligação. Isto mantém a credencial fora da string de ligação no manifesto renderizado. - Imagens reproduzíveis. Tanto o proxy como o backend fixam tags de imagem explícitas, pelo que os manifestos renderizados referenciam imagens estáveis.
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:
aggrega scaffold --example ferretdb-stackDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd ferretdb-stackCompilação
Este workspace não contém 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; --auto-pull escreve durante a compilação o lockfile que falta a um clone acabado de criar:
aggrega build --release release-helm-synth.yaml --auto-pullOs artefactos renderizados ficam em dist/. O destino Kubernetes renderiza manifestos simples offline — não é necessário nenhum pull de chart.
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 `ferretdb-stack`, chame uma vez a ferramenta `scaffold` com `example` definido como `ferretdb-stack` e sem `dir`: esta escreve o exemplo numa nova pasta `ferretdb-stack`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `ferretdb-stack`, `release` definido como `release-helm-synth.yaml`, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros o build escreveu; encontram-se em `ferretdb-stack/dist/`.Como é a stack composta
O proxy é renderizado como um Deployment sem estado mais um Service ClusterIP na porta do protocolo de rede. O ambiente do seu contentor contém a ligação composta a partir da aresta para o backend — o nome do Service interno ao cluster do backend, o utilizador e a base de dados, sem palavra-passe no URL — e mantém o listener de depuração do FerretDB no endereço de loopback do pod, onde nenhum outro pod o alcança:
env: - name: FERRETDB_LISTEN_ADDR value: :27017 - name: FERRETDB_DEBUG_ADDR value: 127.0.0.1:8088 - name: FERRETDB_POSTGRESQL_URL value: postgres://postgres@database-zdbackend-default:5432/postgres - name: PGPASSWORD value: apppassNenhuma das duas probes precisa desse listener. A readiness probe executa ferretdb ping dentro do contentor, que faz ping à porta do protocolo de rede e assim também comprova a ligação ao backend; a liveness probe verifica apenas se a porta do protocolo de rede aceita ligações, pelo que uma falha do backend retira o proxy do seu Service sem o reiniciar:
livenessProbe: tcpSocket: port: 27017readinessProbe: exec: command: - /ferretdb - pingO backend é renderizado como um StatefulSet com um volume persistente montado em /var/lib/postgresql/data, mais um Service ClusterIP e um Service headless.