Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Entités par rôle

Chaque type d’entité a un rôle qui le rédige généralement. Cette page en est la carte complète — consultez-la lorsque vous connaissez votre préoccupation mais pas encore le fichier auquel elle appartient. L’attribution des rôles est une orientation, pas une contrainte imposée par le compilateur (voir Personas) ; elle nomme qui possède habituellement un type dans une configuration bien factorisée.

La carte en un coup d’œil

RôleTypes d’entitésPréoccupation
DéveloppeurAggregateIntention applicative : ce qu’est l’application et ce dont elle a besoin
Architecte de plateformeComponent, FeatureLe contrat de catalogue réutilisable et versionné
Opérations de plateformeRecipe, FeatureRecipe, Plugin de rendu de providerTraduction propre au Provider vers une infrastructure rendue
Opérateur de plateformeManifest, ReleaseRoutage et câblage du déploiement
Support transversalSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, WorkloadFormes partagées, code d’extension et le type de compilateur propre à la plateforme

Développeur

Aggregate — l’unique surface de rédaction du développeur et l’unique source de vérité pour la topologie de l’application. Il déclare les composants dont l’application est constituée, les values que chacun accepte, les Features dont le comportement relève de l’intention applicative (avec leurs values), les parameters exposés pour la variation par environnement, et les arêtes uses qui relient les composants entre eux. Il reste délibérément agnostique vis-à-vis de l’infrastructure physique : rien dans l’Aggregate ne nomme un cloud, un cluster ou un provider. C’est cet agnosticisme vis-à-vis des capacités qui permet à un Aggregate de se déployer n’importe où.

Architecte de plateforme

Component — un contrat réutilisable et versionné pour un type de brique. Il déclare, via un JSON Schema, les values qu’un développeur peut fournir ; les sorties provides qu’il transmet aux consommateurs ; et les sockets usesSchema qu’il expose pour le câblage. Les Components portent les labels sémantiques qui pilotent les politiques et le rendu. L’architecte maintient stable le contrat du Component afin que les développeurs puissent s’appuyer dessus.

Feature — une capacité attachable qu’un développeur ou un opérateur peut ajouter à un composant : un exporteur de métriques, le masquage de texte sensible sur une passerelle IA, une liaison d’identifiants. Une Feature déclare ce dont elle a besoin et ce avec quoi elle est incompatible ; la façon dont elle est réalisée — les ressources qu’elle génère, ou les paramètres qu’elle écrit dans ce que son composant rend déjà — réside dans sa FeatureRecipe.

Opérations de plateforme

Recipe — la réalisation propre à un provider d’un Component. Elle associe les valeurs déclarées par le Component à la sortie d’un provider concret — une release Helm, un service Compose, un module Terraform — au moyen de templates, et transmet les valeurs provides aux consommateurs. Une Recipe ne modifie jamais les valeurs exposées au développeur qu’un Component déclare ; elle décide seulement comment elles sont rendues.

FeatureRecipe — la réalisation propre à un provider d’une Feature, appliquée au moment de la liaison. Elle génère les ressources qu’implique l’attachement d’une Feature pour un provider donné, ou écrit les paramètres qu’il implique dans ce que le composant attaché rend déjà.

Plugin de rendu Provider — un provider est l’invité Wasm qui transforme l’entrée d’une Recipe en manifestes natifs du provider. Il est livré sous la forme d’un Plugin avec pluginType: provider qui déclare le ou les noms de provider qu’il rend et son contrat de socket de provider. Les opérations (ou un auteur de plugin) fournissent les providers afin que les Recipes disposent d’un provider pour le rendu. Voir la Vue d’ensemble des Providers pour les providers livrés et leurs contrats.

Lire un identifiant en toute sécurité dans une Recipe

Un identifiant parvient à une Recipe par le canal d’injection, .context.inject.env, sous la forme de n’importe quel texte choisi par son auteur ; il peut donc contenir des caractères qu’un modèle ne peut pas écrire tels quels dans du YAML. Dans un scalaire entre guillemets doubles, un guillemet double termine la valeur prématurément et une barre oblique inverse ouvre un échappement : le build s’arrête, ou la barre oblique inverse est perdue silencieusement. Échappez les deux là où la valeur est écrite :

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

optional lit la clé dans la table du canal avec une valeur de repli vide, si bien qu’un mot de passe que rien n’a livré est rendu comme un texte vide. Les deux appels replace échappent d’abord la barre oblique inverse puis le guillemet, dans cet ordre pour que l’échappement du guillemet lui-même ne soit pas échappé à nouveau, et laissent tout autre caractère tel quel. Une valeur lue via index, qui s’arrête lorsque la clé est absente, reçoit les deux mêmes appels replace tels quels.

Un caractère que cette forme ne transporte pas est le saut de ligne. YAML replie un saut de ligne situé dans un scalaire entre guillemets doubles en une espace, si bien qu’un identifiant qui en contient un est livré avec une espace à la place du saut. Une FeatureRecipe qui écrit un identifiant dans son injectMapping l’écrit plutôt via toJson, qui transporte aussi bien un guillemet, une barre oblique inverse qu’un saut de ligne, comme le montre la référence de la FeatureRecipe.

Cette FeatureRecipe écrit l’identifiant sous le mécanisme à partir duquel la Recipe le lit — env: pour .context.inject.env, file:, arg:, ou un mécanisme propre au composant sous son propre nom. .context.inject.all est construit à partir de ces mécanismes et jamais à partir de la sortie d’un mappage ; un mappage qui écrirait sous all: ne livrerait donc rien, et le build s’arrête plutôt sur lui, en nommant le rattachement, la clé et la FeatureRecipe.

Opérateur de plateforme

Manifest — la couche de routage. Il indique au compilateur quelle Recipe réalise chaque Component pour une cible donnée, de sorte que le même Aggregate peut être orienté vers des implémentations différentes selon les environnements — une Recipe cloud pour la production, une Recipe Compose pour les tests locaux — sans aucune modification du fichier du développeur.

Release — l’unique entrée de compilation, qui consigne ce qu’un environnement construit. Elle pointe vers l’Aggregate et le Manifest, satisfait les parameters exposés par le développeur, attache les Features dont les entrées sont opérationnelles, dimensionne avec infra celles que le développeur a attachées, et câble ses propres arêtes à l’intérieur des sockets déclarés par l’architecte. Une Release satisfait les points de variation exposés ; elle ne peut pas introduire de nouvelles values applicatives ni de nouvelles ressources de calcul — celles-ci proviennent uniquement de l’Aggregate.

Types de support transversaux

Ces types servent les auteurs de tous les rôles plutôt que d’appartenir à un seul.

SchemaLibrary — une bibliothèque partagée de formes de schéma récurrentes dans de nombreux Components et Features. Lorsque la même structure (par exemple un bloc de ressources de pod) apparaît dans de nombreuses entités, un architecte la factorise dans une entrée de SchemaLibrary afin qu’elle soit définie et mise à jour une seule fois.

MappingLibrary — une bibliothèque partagée de logique de mappage réutilisable dans laquelle puisent les Recipes et les FeatureRecipes, de sorte que les motifs de traduction courants ont une source unique au lieu d’être copiés.

WorkloadLibrary — une bibliothèque partagée de contenu Workload réutilisable, de sorte qu’une forme de déploiement récurrente dans de nombreuses Recipes est déclarée une fois et importée dans chaque bloc workload:.

ArtifactLibrary — une bibliothèque partagée de bundles d’artefacts réutilisables : des ensembles nommés de fichiers de sortie auxiliaires qui vont ensemble, comme une CRD avec son RBAC. Une Recipe ou une FeatureRecipe importe un bundle à une entrée artifacts: et émet chaque fichier qu’il contient.

Plugin — le type d’extension. Au-delà du rendu de provider, les Plugins empaquettent le code WebAssembly qui apporte une intelligence propre au domaine — validation de politiques, mutation, linting et autres sockets. La rédaction d’un Plugin relève de l’équipe plateforme et soutient tous les autres rôles.

Workload — un type de compilateur propre à la plateforme, et non un fichier qu’un développeur ou un opérateur écrit à la main comme entité de premier niveau. Il est consommé dans le bloc workload: d’une Recipe, où le provider avec lequel la Recipe effectue le rendu traduit la forme de workload normalisée dans sa forme native. Les auteurs de Recipe interagissent avec lui via ce bloc ; la référence du Workload documente sa forme.

Suite