Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler 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 — útil quando se conhece a preocupação mas ainda não o ficheiro a que pertence. A atribuição de papéis é uma orientação, não uma imposição do compilador (ver Personas); indica quem habitualmente detém um tipo numa configuração bem estruturada.

O mapa num relance

PapelTipos de entidadePreocupação
ProgramadorAggregateIntenção da aplicação: o que a aplicação é e de que precisa
Arquiteto de plataformaComponent, FeatureO contrato de catálogo reutilizável e versionado
Operações de plataformaRecipe, FeatureRecipe, Plugin de renderização de providerTradução específica do Provider para infraestrutura renderizada
Operador de plataformaManifest, ReleaseEncaminhamento e ligação da implementação
Suporte transversalSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, WorkloadFormas partilhadas, código de extensão e o tipo de compilador detido pela plataforma

Programador

Aggregate — a única superfície de autoria do programador e a única fonte de verdade para a topologia da aplicação. Declara os componentes a partir dos quais a aplicação é construída, os values que cada um recebe, as Features cujo comportamento é intenção da aplicação (com os seus values), os parameters expostos para variação por ambiente e as arestas uses que ligam os componentes entre si. Mantém-se deliberadamente agnóstico em relação à infraestrutura física: nada no Aggregate nomeia uma cloud, um cluster ou um provider. É esse agnosticismo em relação às capacidades que permite a um Aggregate ser implementado em qualquer lado.

Arquiteto de plataforma

Component — um contrato reutilizável e versionado para um tipo de bloco de construção. Declara, através de um JSON Schema, os values que um programador pode fornecer; os outputs provides que encaminha para os consumidores; e os sockets usesSchema que expõe para ligação. Os Components transportam as etiquetas semânticas que orientam a política e a renderização. O arquiteto mantém estável o contrato do Component para que os programadores possam depender dele.

Feature — uma capacidade associável que um programador ou operador pode acrescentar a um componente: um exportador de métricas, a ocultação de texto sensível num gateway de IA, uma associação de credenciais. Uma Feature declara aquilo de que precisa e aquilo com que é incompatível; a forma como é realizada — os recursos que gera, ou as definições que escreve naquilo que o seu componente já renderiza — vive na sua FeatureRecipe.

Operações de plataforma

Recipe — a realização específica do provider de um Component. Mapeia os valores declarados do Component para a saída de um provider concreto — uma release Helm, um serviço Compose, um módulo Terraform — através de templates, e encaminha valores provides para os consumidores. Uma Recipe nunca altera os valores voltados para o programador que um Component declara; apenas decide como são renderizados.

FeatureRecipe — a realização específica do provider de uma Feature, aplicada no momento da associação. Gera os recursos que a associação de uma Feature implica para um dado provider, ou escreve as definições que implica naquilo que o componente associado já renderiza.

Plugin de renderização de Provider — um provider é o guest Wasm que converte a entrada de uma Recipe em manifestos nativos do provider. É entregue como um Plugin com pluginType: provider que declara o(s) nome(s) de provider que renderiza e o seu contrato de socket de provider. As operações (ou um autor de plugins) fornecem providers para que as Recipes tenham um provider com que renderizar. Ver a Visão geral dos Providers para os providers disponibilizados e os seus contratos.

Ler uma credencial com segurança numa Recipe

Uma credencial chega a uma Recipe pelo canal de injeção, .context.inject.env, como qualquer texto que o seu autor tenha escolhido, pelo que pode conter caracteres que um modelo não consegue escrever em YAML tal como estão. Dentro de um escalar entre aspas duplas, uma aspa dupla termina o valor antes do tempo e uma barra invertida inicia um escape: a compilação é interrompida, ou a barra invertida perde-se silenciosamente. Faça o escape de ambos 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 canal com um valor de recurso vazio, pelo que uma palavra-passe que nada entregou é renderizada como texto vazio. As duas chamadas replace fazem o escape primeiro da barra invertida e depois da aspa, por essa ordem para que o escape da própria aspa não volte a ser escapado, e deixam todos os outros caracteres como estavam. Um valor lido através de index, que interrompe quando a chave está ausente, recebe as mesmas duas chamadas replace tal como estão.

Um carácter que esta forma não transporta é a quebra de linha. O YAML converte uma quebra de linha dentro de um escalar entre aspas duplas num espaço, pelo que uma credencial que contenha uma é entregue com um espaço onde estava a quebra. Uma FeatureRecipe que escreve uma credencial no seu injectMapping escreve-a, em vez disso, através 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, pelo que um mapeamento que escrevesse sob all: não entregaria nada; em vez disso, a compilação é interrompida nele, nomeando o anexo, a chave e a FeatureRecipe.

Operador de plataforma

Manifest — a camada de encaminhamento. Indica ao compilador que Recipe realiza cada Component para um dado destino, para que o mesmo Aggregate possa ser apontado para implementações diferentes em ambientes diferentes — uma Recipe de cloud para produção, uma Recipe Compose para testes locais — sem qualquer alteração ao ficheiro do programador.

Release — a única entrada de compilação, que regista o que um ambiente constrói. Aponta para o Aggregate e o Manifest, satisfaz os parameters que o programador expôs, associa as Features cujas entradas são operacionais, dimensiona com infra as que o programador associou e liga arestas próprias dentro dos sockets que o arquiteto declarou. Uma Release satisfaz pontos de variação expostos; não pode introduzir novos values da aplicação nem nova computação — estes vêm apenas do Aggregate.

Tipos de suporte transversais

Estes tipos servem autores de vários papéis em vez de pertencerem a um só.

SchemaLibrary — uma biblioteca partilhada 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 extrai-a para uma entrada de SchemaLibrary, para que seja definida e atualizada uma única vez.

MappingLibrary — uma biblioteca partilhada de lógica de mapeamento reutilizável a que as Recipes e FeatureRecipes recorrem, para que os padrões de tradução comuns tenham uma única fonte em vez de serem copiados.

WorkloadLibrary — uma biblioteca partilhada de conteúdo de Workload reutilizável, para que uma forma de implementação que se repete em muitas Recipes seja declarada uma única vez e importada para cada bloco workload:.

ArtifactLibrary — uma biblioteca partilhada de pacotes de artefactos reutilizáveis: conjuntos nomeados de ficheiros de saída auxiliares que pertencem uns aos outros, como um CRD com o seu RBAC. Uma Recipe ou FeatureRecipe importa um pacote numa entrada de artifacts: e emite todos os ficheiros que ele contém.

Plugin — o tipo de extensão. Para 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 autoria de Plugin é uma responsabilidade da equipa de plataforma que apoia todos os outros papéis.

Workload — um tipo de compilador detido pela plataforma, não um ficheiro que um programador ou operador escreve à mão como entidade de nível superior. É consumido dentro do bloco workload: de uma Recipe, onde o provider com que a Recipe renderiza traduz a forma de carga de trabalho normalizada na sua forma nativa. Os autores de Recipes interagem com ele através desse bloco; a referência do Workload documenta a forma.

A seguir