Índice de referência de Provider
Cada um dos fornecedores da biblioteca padrão de Aggrega aceita um subconjunto diferente dos três tipos de entrada da Recipe (com fonte, sintetizado, artefactos). A matriz de capacidades canónica encontra-se em ../../architecture/16-recipe-input-composition.md, em «Matriz de capacidades de Provider». Consulte essa secção para a grelha de referência, e o texto por fornecedor que se lhe segue para saber que combinações de tipos de entrada cada fornecedor aceita — uma grelha indica cada tipo isoladamente e não consegue dizer que dois deles podem ser declarados em conjunto.
Esta página é uma placa de sinalização. Indica o que cada fornecedor da biblioteca padrão produz e encaminha para a página que o trata; que tipos de entrada um fornecedor aceita, e em que combinações, é respondido pelas secções ligadas acima.
Os fornecedores da biblioteca padrão
helm— produz manifestos planos do Kubernetes. Consulte helm.md.helm-chart— empacota os componentes de uma fronteira num único chart guarda-chuva do Helm. Consulte helm-chart.md.compose— produz serviços do Docker Compose, combinados num único ficheiro compose por fronteira. Consulte compose.md.terraform— produz configuração do Terraform. Emite configuração e nunca executa o Terraform. Consulte terraform.md.cloudformation— produz templates de stack do CloudFormation, um por fronteira. Emite configuração e nunca executa o CloudFormation. Consulte cloudformation.md.
O que o syncWave de uma fronteira faz em cada fornecedor
O valor syncWave: da fronteira de uma Release é lido por todos os fornecedores da biblioteca padrão, e o que ordena — e em que termos — difere consoante o fornecedor; no helm-chart ordena apenas os recursos que contêm a sua anotação:
| Provider | O que a wave faz |
|---|---|
helm | Ordena os recursos que um controlador de GitOps ou o Helm aplica. Quando a wave não é 0, cada recurso renderizado contém argocd.argoproj.io/sync-wave, e um recurso de hook gerado por um template do chart contém ainda helm.sh/hook-weight. |
helm-chart | Ordena os recursos que contêm a anotação. Os templates de um chart de origem são copiados tal como o seu autor os escreveu, pelo que só contêm argocd.argoproj.io/sync-wave onde o chart o escreve; um artefacto carregado através de $import: que o fornecedor acrescenta contém-no, e nenhum helm.sh/hook-weight — consulte helm-chart.md. |
compose | Ordena os serviços dentro do ficheiro compose em que a fronteira é renderizada, através de depends_on entre eles, e regista ainda o valor em cada serviço emitido como a etiqueta aggrega.ai/sync-wave. A ordenação entre dois ficheiros compose não é exprimível — consulte compose.md. |
terraform | Ordena os blocos module da configuração raiz em que a fronteira é montada, através de depends_on entre eles. É a ordem pela qual 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 não é prometida nenhuma ordem de desmantelamento. A ordenação entre duas configurações raiz não é exprimível, e o valor é também registado com a proveniência de compilação do nó — consulte terraform.md. |
cloudformation | Ordena o aprovisionamento da stack em que a fronteira é montada, através de DependsOn entre recursos. É a ordem de criação, e em sentido inverso a de eliminaçã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 é exprimível — consulte cloudformation.md. |
A escrita de um syncWave: por fronteira é tratada na página da entidade Release; as etiquetas e anotações exatas que cada fornecedor emite estão em well-known-annotations.md.
Onde procurar o quê
| Para saber… | Consultar |
|---|---|
| Que fornecedor suporta que tipo de entrada | ../../architecture/16-recipe-input-composition.md secção Matriz de capacidades de Provider |
| Que combinações de tipos de entrada um fornecedor aceita, e o que uma recusa imprime | ../../architecture/16-recipe-input-composition.md «O que cada provider aceita, na íntegra» |
| Como o socket de plugin de um fornecedor recebe a entrada e devolve a saída | architecture.md |
| Forma de autoria por fornecedor (estrutura do chart, chaves de nível superior do compose, corpos do Terraform, fragmentos do CloudFormation) | A página por fornecedor correspondente (helm.md, helm-chart.md, compose.md, terraform.md, cloudformation.md) |
| Que anotações de fronteira cada fornecedor consome e as respetivas predefinições | well-known-annotations.md |
O que o syncWave de uma fronteira faz em cada fornecedor | A tabela acima |
| Se um fornecedor comunica o nome que dá aos recursos que renderiza, e o que ler quando não o faz | ../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, em termos conceptuais | ../../architecture/16-recipe-input-composition.md |