Provider-Referenzindex
Die Provider der Standardbibliothek von Aggrega akzeptieren jeweils eine andere Teilmenge der drei Eingabearten des Recipe (mit Quelle, synthetisiert, Artefakte). Die kanonische Fähigkeitsmatrix steht in ../../architecture/16-recipe-input-composition.md unter „Provider-Fähigkeitsmatrix“. Lesen Sie diesen Abschnitt für das maßgebliche Raster und den Text pro Provider darunter dafür, welche Kombinationen von Eingabearten jeder Provider akzeptiert — ein Raster nennt jede Art für sich und kann nicht ausdrücken, dass zwei davon zusammen deklariert werden dürfen.
Diese Seite ist ein Wegweiser. Sie nennt, was jeder Provider der Standardbibliothek erzeugt, und verweist Sie auf die Seite, die ihn behandelt; welche Eingabearten ein Provider akzeptiert und in welchen Kombinationen, beantworten die oben verlinkten Abschnitte.
Die Provider der Standardbibliothek
helm— erzeugt flache Kubernetes-Manifeste. Siehe helm.md.helm-chart— verpackt die Komponenten einer Boundary in ein einziges Helm-Umbrella-Chart. Siehe helm-chart.md.compose— erzeugt Docker-Compose-Services, zusammengeführt in eine Compose-Datei pro Boundary. Siehe compose.md.terraform— erzeugt Terraform-Konfiguration. Er gibt Konfiguration aus und führt Terraform nie aus. Siehe terraform.md.cloudformation— erzeugt CloudFormation-Stack-Templates, eines pro Boundary. Er gibt Konfiguration aus und führt CloudFormation nie aus. Siehe cloudformation.md.
Was der syncWave einer Boundary bei jedem Provider bewirkt
Der Wert syncWave: der Boundary eines Release wird von jedem Provider der Standardbibliothek gelesen, und was er ordnet — und in welchen Begriffen — unterscheidet sich je nach Provider; bei helm-chart ordnet er nur die Ressourcen, die seine Annotation tragen:
| Provider | Was die Welle bewirkt |
|---|---|
helm | Ordnet die Ressourcen, die ein GitOps-Controller oder Helm anwendet. Wo die Welle nicht 0 ist, trägt jede gerenderte Ressource argocd.argoproj.io/sync-wave, und eine per Chart-Template erzeugte Hook-Ressource trägt zusätzlich helm.sh/hook-weight. |
helm-chart | Ordnet die Ressourcen, die die Annotation tragen. Die Templates eines Quell-Charts werden so kopiert, wie ihr Autor sie geschrieben hat, sodass sie argocd.argoproj.io/sync-wave nur dort tragen, wo das Chart es schreibt; ein per $import: geladenes Artefakt, das der Provider hinzufügt, trägt es, und kein helm.sh/hook-weight — siehe helm-chart.md. |
compose | Ordnet die Services innerhalb der Compose-Datei, in die die Boundary gerendert wird, über depends_on zwischen ihnen und hält den Wert zusätzlich an jedem ausgegebenen Service als Label aggrega.ai/sync-wave fest. Eine Ordnung über zwei Compose-Dateien hinweg ist nicht ausdrückbar — siehe compose.md. |
terraform | Ordnet die Blöcke module der Root-Konfiguration, zu der die Boundary zusammengesetzt wird, über depends_on zwischen ihnen. Es ist die Reihenfolge, in der Terraform seine Aktionen ausführt, nicht die Bereitschaft — eine Konfiguration kennt keinen Begriff davon, dass eine Ressource einsatzbereit ist —, und es wird keine Abbaureihenfolge zugesagt. Eine Ordnung über zwei Root-Konfigurationen hinweg ist nicht ausdrückbar, und der Wert wird außerdem mit der Build-Provenienz des Knotens festgehalten — siehe terraform.md. |
cloudformation | Ordnet die Provisionierung des Stacks, zu dem die Boundary zusammengesetzt wird, über DependsOn zwischen Ressourcen. Es ist die Erstellungsreihenfolge und umgekehrt die Löschreihenfolge, nicht die Bereitschaft — ein Stack-Template kennt keinen Begriff davon, dass eine Ressource einsatzbereit ist. Eine Ordnung über zwei Stacks hinweg ist nicht ausdrückbar — siehe cloudformation.md. |
Das Verfassen eines syncWave: pro Boundary wird auf der Seite zur Release-Entität behandelt; die genauen Labels und Annotationen, die jeder Provider ausgibt, stehen in well-known-annotations.md.
Wo man was findet
| Wenn Sie wissen möchten… | Siehe |
|---|---|
| Welcher Provider welche Eingabeart unterstützt | ../../architecture/16-recipe-input-composition.md Abschnitt Provider-Fähigkeitsmatrix |
| Welche Kombinationen von Eingabearten ein Provider akzeptiert und was eine Ablehnung ausgibt | ../../architecture/16-recipe-input-composition.md „Was jeder Provider akzeptiert, vollständig“ |
| Wie der Plugin-Socket eines Providers Eingaben empfängt und Ausgaben zurückgibt | architecture.md |
| Authoring-Form pro Provider (Chart-Struktur, Compose-Schlüssel auf oberster Ebene, Terraform-Körper, CloudFormation-Fragmente) | Die zugehörige Seite pro Provider (helm.md, helm-chart.md, compose.md, terraform.md, cloudformation.md) |
| Welche Boundary-Annotationen jeder Provider verarbeitet und ihre Standardwerte | well-known-annotations.md |
Was der syncWave einer Boundary bei jedem Provider bewirkt | Die Tabelle oben |
| Ob ein Provider den Namen meldet, den er den von ihm gerenderten Ressourcen gibt, und was zu lesen ist, wo er es nicht tut | ../templates/rendered-resource-names.md |
| Die Authoring-Oberfläche der Art Workload | ../entities/workload.md |
| Das Kompositionsmodell der drei Eingabearten, konzeptionell | ../../architecture/16-recipe-input-composition.md |