Índice de referência de Provider
Cada um dos provedores da biblioteca padrão de Aggrega aceita um subconjunto diferente dos três tipos de entrada da Recipe (com fonte, sintetizado, artefatos). A matriz de capacidades canônica fica em ../../architecture/16-recipe-input-composition.md sob “Matriz de capacidades por Provider”. Leia essa seção para a grade de referência, e o texto por provedor que vem depois dela para saber quais combinações de tipos de entrada cada provedor aceita — uma grade informa cada tipo isoladamente e não consegue dizer que dois deles podem ser declarados juntos.
Esta página é uma placa de sinalização. Ela informa o que cada provedor da biblioteca padrão produz e direciona você para a página que trata dele; quais tipos de entrada um provedor aceita, e em quais combinações, é respondido pelas seções vinculadas acima.
Os provedores da biblioteca padrão
helm— produz manifestos planos do Kubernetes. Veja helm.md.helm-chart— empacota os componentes de uma fronteira em um único chart guarda-chuva do Helm. Veja helm-chart.md.compose— produz serviços do Docker Compose, mesclados em um único arquivo compose por fronteira. Veja compose.md.terraform— produz configuração do Terraform. Ele emite configuração e nunca executa o Terraform. Veja terraform.md.cloudformation— produz templates de stack do CloudFormation, um por fronteira. Ele emite configuração e nunca executa o CloudFormation. Veja cloudformation.md.
O que o syncWave de uma fronteira faz em cada provedor
O valor syncWave: da fronteira de uma Release é lido por todo provedor da biblioteca padrão, e o que ele ordena — e em que termos — difere conforme o provedor; no helm-chart ele ordena apenas os recursos que carregam a sua anotação:
| Provider | O que a onda faz |
|---|---|
helm | Ordena os recursos que um controlador de GitOps ou o Helm aplica. Onde a onda não é 0, todo recurso renderizado carrega argocd.argoproj.io/sync-wave, e um recurso de hook gerado por template do chart carrega também helm.sh/hook-weight. |
helm-chart | Ordena os recursos que carregam a anotação. Os templates de um chart de origem são copiados como o seu autor os escreveu, então eles carregam argocd.argoproj.io/sync-wave apenas onde o chart o escreve; um artefato carregado por $import: que o provedor adiciona o carrega, e nenhum helm.sh/hook-weight — veja helm-chart.md. |
compose | Ordena os serviços dentro do arquivo compose em que a fronteira é renderizada, por meio de depends_on entre eles, e também registra o valor em cada serviço emitido como o rótulo aggrega.ai/sync-wave. A ordenação entre dois arquivos compose não é expressável — veja compose.md. |
terraform | Ordena os blocos module da configuração raiz em que a fronteira é montada, por meio de depends_on entre eles. É a ordem em que o Terraform executa as suas ações, e não a prontidão — uma configuração não tem noção de um recurso estar operacional — e nenhuma ordem de desmontagem é prometida. A ordenação entre duas configurações raiz não é expressável, e o valor também é registrado com a proveniência de build do nó — veja terraform.md. |
cloudformation | Ordena o provisionamento da stack em que a fronteira é montada, por meio de DependsOn entre recursos. É a ordem de criação, e no sentido inverso a de exclusão, e não a prontidão — um template de stack não tem noção de um recurso estar operacional. A ordenação entre duas stacks não é expressável — veja cloudformation.md. |
A escrita de um syncWave: por fronteira é tratada na página da entidade Release; os rótulos e anotações exatos que cada provedor emite estão em well-known-annotations.md.
Onde procurar o quê
| Se você quer saber… | Consulte |
|---|---|
| Qual provedor oferece suporte a qual tipo de entrada | ../../architecture/16-recipe-input-composition.md seção Matriz de capacidades por Provider |
| Quais combinações de tipos de entrada um provedor aceita, e o que uma recusa imprime | ../../architecture/16-recipe-input-composition.md “O que cada provider aceita, por completo” |
| Como o socket de plugin de um provedor recebe a entrada e retorna a saída | architecture.md |
| Forma de autoria por provedor (estrutura do chart, chaves de nível superior do compose, corpos do Terraform, fragmentos do CloudFormation) | A página por provedor correspondente (helm.md, helm-chart.md, compose.md, terraform.md, cloudformation.md) |
| Quais anotações de fronteira cada provedor consome e os seus padrões | well-known-annotations.md |
O que o syncWave de uma fronteira faz em cada provedor | A tabela acima |
| Se um provedor informa o nome que dá aos recursos que renderiza, e o que ler onde ele não informa | ../templates/rendered-resource-names.md |
| A superfície de autoria do tipo Workload | ../entities/workload.md |
| O modelo de composição de três tipos de entrada, conceitualmente | ../../architecture/16-recipe-input-composition.md |