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

Entidades por papel

Cada tipo de entidade tem um papel que normalmente o escreve. Esta página é o mapa completo — recorra a ela quando souber qual é sua preocupação, mas ainda não souber a qual arquivo ela pertence. A atribuição de papéis é uma orientação, não uma imposição do compilador (veja Personas); ela nomeia quem normalmente é dono de um tipo em uma configuração bem fatorada.

O mapa em resumo

PapelTipos de entidadePreocupação
DesenvolvedorAggregateIntenção da aplicação: o que o app é e do que precisa
Arquiteto de plataformaComponent, FeatureO contrato de catálogo reutilizável e versionado
Operações de plataformaRecipe, FeatureRecipe, Plugin de renderização de providersTradução específica do Provider para infraestrutura renderizada
Operador de plataformaManifest, ReleaseRoteamento e conexão da implantação
Suporte transversalSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, WorkloadFormas compartilhadas, código de extensão e o tipo do compilador pertencente à plataforma

Desenvolvedor

Aggregate — a única superfície de escrita do desenvolvedor e a única fonte de verdade da topologia da aplicação. Ele declara os componentes de que a aplicação é feita, os values que cada um recebe, as Features cujo comportamento é intenção da aplicação (com seus values), os parameters expostos para variação por ambiente e as arestas uses que conectam os componentes entre si. Ele permanece deliberadamente agnóstico em relação à infraestrutura física: nada no Aggregate nomeia uma nuvem, um cluster ou um provider. É esse agnosticismo em relação às capacidades que permite que um Aggregate seja implantado em qualquer lugar.

Arquiteto de plataforma

Component — um contrato reutilizável e versionado para um tipo de bloco de construção. Ele declara, por meio de um JSON Schema, os values que um desenvolvedor pode fornecer; as saídas provides que encaminha aos consumidores; e os sockets usesSchema que expõe para a conexão. Os Components carregam os rótulos semânticos que orientam políticas e renderização. O arquiteto mantém estável o contrato do Component para que os desenvolvedores possam depender dele.

Feature — uma capacidade anexável que um desenvolvedor ou operador pode adicionar a um componente: um exportador de métricas, o mascaramento de texto sensível em um gateway de IA, uma vinculação de credenciais. Uma Feature declara do que precisa e com o que é incompatível; como ela é realizada — os recursos que gera, ou as configurações que grava no que seu componente já renderiza — fica na sua FeatureRecipe.

Operações de plataforma

Recipe — a realização específica de provider de um Component. Ela mapeia os valores declarados do Component para a saída de um provider concreto — uma release do Helm, um serviço do Compose, um módulo do Terraform — por meio de templates, e encaminha valores provides aos consumidores. Uma Recipe nunca altera os valores voltados ao desenvolvedor que um Component declara; ela só decide como eles são renderizados.

FeatureRecipe — a realização específica de provider de uma Feature, aplicada no momento da vinculação. Ela gera os recursos que o anexo de uma Feature implica para um determinado provider, ou grava as configurações que ele implica no que o componente anexado já renderiza.

Plugin de renderização de Provider — um provider é o convidado Wasm que transforma a entrada de uma Recipe em manifestos nativos do provider. Ele é entregue como um Plugin com pluginType: provider que declara o nome ou os nomes de provider que renderiza e seu contrato de socket de provider. Operações (ou um autor de plugins) fornecem providers para que as Recipes tenham um provider contra o qual renderizar. Veja a Visão geral dos Providers para os providers incluídos e seus contratos.

Ler uma credencial com segurança em uma Recipe

Uma credencial chega a uma Recipe pelo pipe de injeção, .context.inject.env, como qualquer texto que o seu autor tenha escolhido, então ela pode conter caracteres que um template não consegue escrever em YAML como estão. Dentro de um escalar entre aspas duplas, uma aspa dupla encerra o valor antes da hora e uma barra invertida inicia um escape: o build é interrompido, ou a barra invertida é perdida silenciosamente. Escape os dois onde o valor é escrito:

variables:
{{- $env := optional (default dict .context.inject) "env" dict }}
DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"

optional lê a chave do mapa do pipe com um fallback vazio, então uma senha que nada entregou é renderizada como texto vazio. As duas chamadas replace escapam primeiro a barra invertida e depois a aspa, nessa ordem para que o escape da própria aspa não seja escapado de novo, e deixam todos os outros caracteres como estavam. Um valor lido por meio de index, que interrompe quando a chave está ausente, recebe as mesmas duas chamadas replace tal como estão.

Um caractere que esta forma não transporta é a quebra de linha. O YAML converte uma quebra de linha dentro de um escalar entre aspas duplas em um espaço, então uma credencial que contenha uma é entregue com um espaço onde estava a quebra. Uma FeatureRecipe que escreve uma credencial no seu injectMapping a escreve, em vez disso, por meio de toJson, que transporta igualmente uma aspa, uma barra invertida e uma quebra de linha, como mostra a referência da FeatureRecipe.

Essa FeatureRecipe escreve a credencial sob o mecanismo a partir do qual a Recipe a lê — env: para .context.inject.env, file:, arg: ou um mecanismo próprio do componente sob o seu próprio nome. .context.inject.all é construído a partir desses mecanismos e nunca da saída de um mapeamento, então um mapeamento que escrevesse sob all: não entregaria nada; em vez disso, o build é interrompido nele, nomeando a vinculação, a chave e a FeatureRecipe.

Operador de plataforma

Manifest — a camada de roteamento. Ele instrui o compilador sobre qual Recipe realiza cada Component para um determinado destino, de modo que o mesmo Aggregate pode ser apontado para implementações diferentes em ambientes diferentes — uma Recipe de nuvem para produção, uma Recipe do Compose para testes locais — sem nenhuma alteração no arquivo do desenvolvedor.

Release — a única entrada de compilação, que registra o que um ambiente constrói. Ela aponta para o Aggregate e o Manifest, atende aos parameters que o desenvolvedor expôs, anexa as Features cujas entradas são operacionais, dimensiona com infra as que o desenvolvedor anexou e conecta arestas próprias dentro dos sockets que o arquiteto declarou. Uma Release atende aos pontos de variação expostos; ela não pode introduzir novos values da aplicação nem nova capacidade de computação — eles vêm apenas do Aggregate.

Tipos de suporte transversais

Esses tipos atendem autores de vários papéis em vez de pertencer a um só.

SchemaLibrary — uma biblioteca compartilhada de formas de esquema que se repetem em muitos Components e Features. Quando a mesma estrutura (por exemplo, um bloco de recursos de pod) aparece em muitas entidades, um arquiteto a fatora em uma entrada de SchemaLibrary para que seja definida e atualizada uma única vez.

MappingLibrary — uma biblioteca compartilhada de lógica de mapeamento reutilizável da qual Recipes e FeatureRecipes se valem, de modo que padrões de tradução comuns têm uma única fonte em vez de serem copiados.

WorkloadLibrary — uma biblioteca compartilhada de conteúdo Workload reutilizável, de modo que uma forma de implantação que se repete em muitas Recipes é declarada uma vez e importada em cada bloco workload:.

ArtifactLibrary — uma biblioteca compartilhada de bundles de artefatos reutilizáveis: conjuntos nomeados de arquivos de saída auxiliares que andam juntos, como uma CRD com seu RBAC. Uma Recipe ou FeatureRecipe importa um bundle em uma entrada de artifacts: e emite cada arquivo que ele contém.

Plugin — o tipo de extensão. Além da renderização de providers, os Plugins empacotam o código WebAssembly que fornece inteligência específica do domínio — validação de políticas, mutação, linting e outros sockets. A escrita de um Plugin é uma atribuição da equipe de plataforma que apoia todos os outros papéis.

Workload — um tipo do compilador pertencente à plataforma, e não um arquivo que um desenvolvedor ou operador escreve à mão como entidade de nível superior. Ele é consumido dentro do bloco workload: de uma Recipe, onde o provider com que a Recipe renderiza traduz a forma de workload normalizada para sua forma nativa. Os autores de Recipe interagem com ele por meio desse bloco; a referência do Workload documenta a forma.

Próximos passos