Warnungen und Linter-Ausgabe
Nicht fatale Warnungen, die der Compiler während der Kompilierung ausgibt. Warnungen brechen den Build nicht ab — sie machen Auffälligkeiten beim Authoring sichtbar, deterministische Gleichstandsregeln, die der Compiler angewendet hat, und Ressourcen, die die Templates des Entwicklers nie konsumiert haben. Jeder Befund erreicht stderr hinter einem Präfix, das seine Art nennt — warning:, lint: oder notice:, je nachdem, welcher Durchlauf ihn ausgelöst hat —, sodass CI-Pipelines sie erfassen und erneut anzeigen können; gerenderte Artefakte werden trotzdem erzeugt.
Zu fatalen Abbrüchen der Kompilierung (den Diagnosen, die einen Build anhalten) siehe fatal-halts.md.
Jeder Hinweis, nach Kurzcode
Manches von dem, was der Compiler meldet, ohne abzubrechen, ist eine eigene Bedingung: Sie trägt einen Kurzcode, denselben vierstelligen Bezeichner, den eine abbrechende Diagnose ausgibt, und einen festen Satz, mit dem ihre Meldung beginnt. Die folgende Tabelle führt die Zuordnung vom einen zum anderen durch, sodass ein Code, den Sie in der Hand haben, zu dem aufgelöst wird, worum es im Befund geht, auch wenn die Zeile, die Sie lesen, eine Warnung und kein Abbruch ist.
Was hier einen Platz bekommt, ist eine Deklaration, keine Beschreibung. Jede Regel, die der Compiler auswertet, legt fest, was ein Verstoß bewirkt — den Build abbrechen oder den Befund melden und den Build zu Ende laufen lassen —, und die folgenden Zeilen sind von der zweiten Art. So erscheint ein dem Compiler hinzugefügter Hinweis hier, ohne dass eine Zeile von Hand geschrieben wird, und einer, der zu einer abbrechenden Bedingung wird, verschwindet von hier.
Zwei Grenzen dessen, was die Tabelle abdeckt, und beide sind wissenswert, bevor Sie schließen, dass ein Code fehlt:
- Nicht alles auf dieser Seite gehört dazu. Mehrere der unten erklärten Befunde werden von einem eigenen Durchlauf ausgelöst statt von einer deklarierten Regel, und manche tragen überhaupt keine Bedingung — die Zeilen, die sie ausgeben, sind trotzdem genau so, wie in ihren Abschnitten beschrieben, aber es gibt keinen Code aufzulösen und daher keine Zeile. Der Klassencode
unsupported-fieldist die Form, die dort zu erwarten ist: Er nennt eine Klasse von Befunden statt einer Bedingung. - Eine Zeile hier verspricht keinen Abschnitt weiter unten. Ein Hinweis, der spät im Rendering ausgelöst wird, wird katalogisiert statt erklärt, sodass ein Code hier zu einem Satz aufgelöst werden und seine ausführlichere Behandlung in fatal-halts.md unter „Bedingungen, die einen Build nicht abbrechen“ haben kann, wo jede Bedingung katalogisiert ist, die einen Code trägt, ohne einen Build anzuhalten.
sentinels.md löst jeden Kurzcode auf, den ein Build ausgibt, ob Hinweis oder Abbruch, und ist der Ausgangspunkt, wenn Sie noch nicht wissen, welche Art Sie vor sich haben.
| Kurzcode | Beginnt mit |
|---|---|
E0004 | annotation contribution overridden by an explicit value |
E0037 | cross-boundary link between endpoints rendered by different providers is not supported |
E0149 | attachment name is a near miss for a declared slot |
E0167 | Recipe publishes a provides key its Component does not declare |
E0173 | declared parameter is read by no reference in the Aggregate |
E0174 | uses socket name is a near miss for a declared socket |
E0256 | annotation binding declares one path in both pillar lists |
E0297 | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
Schema-pillar-overlap lint (Lint für Überschneidungen der Schema-Säulen)
Wird ausgelöst, wenn eine Component oder ein Feature denselben Eigenschaftsnamen sowohl in der Säule values: als auch in der Säule infra: ihres bzw. seines Blocks spec.schema: auf derselben Verschachtelungstiefe deklariert. Schema-Autoren, die denselben Feldnamen in beide Säulen setzen, wollen ihn in der Regel in die eine oder die andere setzen; der Lint markiert die Dopplung, damit der Autor klären kann, welcher Säule das Feld gehört.
Position in der Pipeline. Der Lint läuft im Validierungsdurchlauf nach der Schema-Vereinheitlichung, vor dem Aufbau der Topologie. Er durchläuft das Schema nach der Expansion der Kurzform, ohne einem $ref: zu folgen (siehe die Disziplin des stillen Überspringens unten), und meldet jede überschneidende Eigenschaft als eigene Warnung.
Ausgabeform:
notice: LINT: Component "core/compute/web-server:1.0.0" at ./catalog/component/core/compute/web-server/1.0.0/component.yaml declares property "storage_size" in both values: and infra: pillars (path: storage_size)Bei verschachtelten Eigenschaften ist der Pfad der Punktpfad zur Eigenschaft ab der Wurzel der Säule:
notice: LINT: Feature "core/db-pool:1.0.0" at ./catalog/feature/core/db-pool/1.0.0/feature.yaml declares property "timeout" in both values: and infra: pillars (path: connection.timeout)Ein Laden des ganzen Katalogs — aggrega validate ohne Argument — nennt jede Entität mit ihrem Namen und ihrer Version und mit der Datei, aus der sie gelesen wurde, wie oben. Ein Build oder die Validierung eines einzelnen Release liest nur die Entitäten, die dieses Release erreicht, und nennt jede mit Namen und Version — at core/db-pool:1.0.0 — einmal pro Entität, wie viele Referenzen im Release sie auch erreichen: Ein Aggregate, das ein Feature mit seinem bloßen Namen nennt, und ein Manifest, das es mit Namen und Version zuordnet, erreichen ein einziges Feature, das einmal gemeldet wird.
Sichtbarkeit im Editor. Der Befund erreicht die Editor-Diagnosen über den Language Server, mit dem Schweregrad Warnung, am Anfang der Datei statt an einem Schlüssel — er nennt eine Katalogentität statt einer Position im Dokument, das Sie bearbeiten, sodass es keinen Authoring-Schlüssel gibt, an dem eine Markierung sitzen könnte. Er wird vor der Phase des Artefakt-Renderings ausgelöst und braucht daher keine Stellschraube: Eine Editor-Sitzung zeigt ihn an, ob serve.build_on_inspect aktiviert ist oder nicht.
Disziplin des stillen Überspringens. Der Durchlauf endet ohne Warnung, wenn ein Schema-Zweig einen der Auswege von JSON Schema 2020-12 trägt, die statisch ableitbare Eigenschaftsmengen verhindern: $ref (dokumentübergreifende oder dokumentinterne Referenzen), patternProperties (Eigenschaftsdeklarationen anhand der Form des Schlüssels), additionalProperties, gesetzt auf true oder auf ein Schema (Eigenschaften, die der Zweig zulässt, ohne sie zu nennen), und die Kompositionsoperatoren oneOf / anyOf / allOf (Disjunktionen und Konjunktionen, deren Zweige abweichende Eigenschaftsmengen deklarieren können). Diese Zweige zu durchlaufen würde entweder erfordern, das referenzierte oder zusammengesetzte Schema zur Lint-Zeit auszuwerten (eine Art von Arbeit, die der Lint nicht leistet), oder Fehlalarme erzeugen, wenn der Name einer Eigenschaft unter values: in einem Zweig zufällig mit dem Namen einer Eigenschaft unter infra: in einem anderen Zweig kollidiert. Der Lint gibt für die betroffene Verschachtelungstiefe keine Warnung aus; tiefere Ebenen desselben Schemas werden weiterhin durchlaufen und sind lintbar.
Anmerkung für Autoren. Der Compiler weist Überschneidungen von Namen zwischen Säulen nicht zurück — der Lint ist ein Hinweis. Eine Component mit storage_size in beiden Säulen wird kompiliert; das entwicklerseitige values.storage_size und das operatorseitige infra.storage_size werden unabhängig voneinander von den Schemas ihrer Säulen validiert, und das Template valuesMapping: des Recipe wählt, aus welcher Säule der Wert in die gerenderte Ausgabe fließt. Der Lint existiert, weil dieses Authoring-Muster fast immer ein Fehler ist; bewusste säulenübergreifende Dopplung ist selten genug, dass Autoren, die sie wirklich wollen, die Warnung ignorieren können. Zur säulenübergreifenden Mechanik im Allgemeinen — einschließlich der seltenen Fälle, in denen ein bewusstes säulenübergreifendes Durchreichen gerechtfertigt ist — siehe vocabulary/data-pillars.md „Säulenübergreifende Mechanik“.
Binding-map-overlap lint (Lint für Überschneidungen der Bindungs-Maps)
Wird ausgelöst, wenn eine Annotationsbindung eines Manifest denselben Punktpfad sowohl in ihrer Liste maps.infra als auch in ihrer Liste maps.values deklariert. Der Pfad würde über beide Säulen geroutet; die deterministische Gleichstandsregel des Compilers schickt ihn über infra:, wodurch die Seite values: vom Aggregate aus unerreichbar wird. Der Lint macht dies sichtbar, damit der Autor die Bindung entweder auf eine einzige Säule einschränken oder das Routing allein über die infra-Seite bewusst akzeptieren kann.
Position in der Pipeline. Der Lint läuft, nachdem das Manifest aufgelöst ist und bevor irgendeine Annotationsexpansion ausgelöst wird, sodass ein Build eine überschneidende Bindung meldet, ob eine Annotation eines Aggregate diese Bindung je erreicht oder nicht. Er durchläuft die Bindungen unter mappings.features.annotations in der Reihenfolge, in der sie geschrieben wurden, bildet die Schnittmenge der Listen maps.infra und maps.values jeder Bindung und meldet einen Befund pro überschneidendem Pfad. Innerhalb einer Bindung werden die überschneidenden Pfade in der Reihenfolge gemeldet, in der die Liste maps.values dieser Bindung sie deklariert — der Reihenfolge, in der Sie sie geschrieben haben —, sodass wiederholte Läufe über identische Eingaben eine identische Abfolge melden.
Ausgabeform:
lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations, "compliance.aggrega.ai/data-class", on Feature "core/pii-redaction", at path "classifier_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values") lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations.audit-scope, "audit-scope", on Feature "core/pii-redaction", at path "retention_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values")Diese beiden Zeilen stammen aus einem einzigen Build über ein einziges Manifest, und was sich zwischen ihren Lokatoren unterscheidet, ist die Form des Annotationsschlüssels. Ein Lokator adressiert ein Dokument per Punktpfad, sodass er am ersten Segment anhält, das selbst einen Punkt enthält: audit-scope enthält keinen, und der Lokator erreicht die Bindung, während compliance.aggrega.ai/data-class einen enthält und der Lokator stattdessen den Block annotations nennt, der ihn enthält. Deshalb ist der beanstandete Schlüssel auch der erste zitierte Wert jedes Befunds — er ist der eine Teil, den der Lokator nicht immer tragen kann.
Sichtbarkeit im Editor. Der Befund erreicht auch die Editor-Diagnosen über den Language Server, mit dem Schweregrad Warnung, positioniert dort, wohin sein Lokator reicht — an der Bindung selbst bei einem einfachen Schlüssel und am umschließenden Block annotations bei einem Schlüssel, der einen Punkt enthält. Ein Autor, der nie die Terminalausgabe liest, sieht ihn trotzdem. Er wird vor der Phase des Artefakt-Renderings ausgelöst und braucht daher keine Stellschraube: Eine Editor-Sitzung zeigt ihn an, ob serve.build_on_inspect aktiviert ist oder nicht.
Programmatisch abgleichen. Der Befund trägt ErrAnnotationBindingPillarOverlap aus pkg/resolver, sodass ein Konsument die Klasse mit errors.Is erkennt statt durch Abgleich des Meldungstexts. Wie alle Hinweis-Sentinels erreicht er nie das Urteil eines Builds — siehe sentinels.md für die Zugriffsfunktion und die Codes der Bedingung.
Deterministische Gleichstandsregel. Die Laufzeit löst die Kollision, indem sie den Pfad ausschließlich über die Säule infra: routet. Die Wahl ist über Builds hinweg konsistent; der Autor kann sich darauf verlassen. Die Seite values: wird aus dem effektiven Routing der Bindung entfernt — Annotationen auf der Aggregate-Seite, die den Pfad zu erreichen versuchen, erhalten kein Routing-Ziel, und der Build bricht auf der Aggregate-Seite zur Expansionszeit ab, mit dem Abbruch, der in fatal-halts.md „An annotation routes through a pillar its authoring side may not use (Eine Annotation wird über eine Säule geroutet, die ihre Autorenseite nicht verwenden darf)“ beschrieben ist. Der Lint ist die frühe Warnoberfläche; jener Abbruch ist die durchsetzende Oberfläche.
Anmerkung für Autoren. Wie der Lint für Überschneidungen der Schema-Säulen ist dieser Lint ein Hinweis — die Bindung wird kompiliert, und die Gleichstandsregel zur Laufzeit erzeugt eine deterministische Ausgabe. Der Lint wird ausgelöst, weil dieses Authoring-Muster fast immer unbeabsichtigt ist; ein Autor einer Bindung, der wirklich wollte, dass beide Säulen denselben Pfad routen, würde zwei getrennte Bindungen mit unterschiedlichen Annotationsschlüsseln schreiben.
Attachment-slot near-miss lint (Lint für beinahe passende Anbindungs-Slots)
Wird ausgelöst, wenn eine Komponenteninstanz ein Feature unter einem Namen anbindet, der keiner der in featuresSchema deklarierten Slots ihres Component-Typs ist, aber nur eine Bearbeitung von einem davon entfernt liegt — ein einzelnes eingefügtes, gelöschtes oder ersetztes Zeichen oder zwei vertauschte benachbarte Zeichen —, dessen selector das angebundene Feature nicht erfüllt. Das ist die Form, die ein Tippfehler in einem Slot-Namen annimmt, und der Lint nennt beide Schreibweisen, damit der Autor das Paar sehen kann.
Warum es ihn gibt. Einen Slot zu deklarieren schließt die Anbindungsoberfläche nicht: Eine Anbindung unter einem Namen, den kein Slot deklariert, ist zulässig, weil gerade diese Offenheit es einer einzigen Katalogentität erlaubt, sowohl eine Anbindung zu bedienen, die einen Slot füllt, als auch Zugangsdaten, die in einem breiteren Geltungsbereich geteilt werden. Der Preis ist, dass ein falsch geschriebener Slot-Name stillschweigend eine freie Anbindung ist statt der Füllung des Slots, den der Autor gemeint hat — der Build gelingt, und der Slot bleibt einfach leer. Der Lint ist die offen benannte Abmilderung genau für diesen Fall.
Position in der Pipeline. Der Lint läuft bei der Auflösung, im selben Durchlauf wie die katalogbewussten semantischen Schutzvorrichtungen, über das aufgelöste Aggregate. Er gleicht die Anbindungsnamen jeder Komponenteninstanz mit den deklarierten Slot-Namen des Component-Typs dieser Instanz ab und gibt pro Beinahe-Treffer-Paar eine Warnung aus.
Ausgabeform:
lint: attachment name is a near miss for a declared slot (Aggregate nearmiss, at .spec.components.db.features.app_user_passwrod, "app_user_passwrod", on component type "core/datastore/postgres", near the declared slot "app_user_password")Der erste zitierte Wert ist der Name, unter dem die Anbindung geschrieben wurde, und um ihn geht es im einleitenden Satz der Warnung. Die beiden folgenden werden von den Wörtern eingeleitet, die sagen, was sie sind: der Component-Typ, an dem die Anbindung sitzt, und der deklarierte Slot, von dem sie eine Bearbeitung entfernt liegt.
Sichtbarkeit im Editor. Die Warnung erreicht auch die Editor-Diagnosen über den Language Server, mit dem Schweregrad Warnung, positioniert am beanstandeten Anbindungsschlüssel. Ein Autor, der nie die Terminalausgabe liest, sieht das Paar trotzdem. Sie wird vor der Phase des Artefakt-Renderings ausgelöst und braucht daher keine Stellschraube: Eine Editor-Sitzung zeigt sie an, ob serve.build_on_inspect aktiviert ist oder nicht.
Schwelle und ihr Zielkonflikt. Der Lint paart Namen nur im Abstand von einer Bearbeitung und nur, wenn beide Namen mindestens vier Zeichen lang sind. Unterhalb dieser Länge liegt fast jeder kurze Name eine Bearbeitung von jedem anderen entfernt, sodass ihre Paarung Rauschen statt Signal erzeugen würde; jenseits einer Bearbeitung ähneln die Paare keinen Tippfehlern mehr. Eine Vertauschung zählt als eine Bearbeitung statt als zwei, weil ein vertauschtes Zeichenpaar der häufigste Ausrutscher ist und eine strengere Zählung ihn übersehen würde.
Anmerkung für Autoren. Der Lint ist ein Hinweis und ändert nie das Urteil des Builds — der Compiler überwacht nicht, wie ein Autor eine Anbindung benennt. Ein Autor, der ein Feature bewusst unter einem Namen anbindet, der einem Slot ähnelt, kann die Warnung ignorieren; die Anbindung verhält sich genau so, wie sie geschrieben wurde.
Nicht, wo das Feature zum Slot passt. Ein Name, der eine Bearbeitung von einem Slot entfernt liegt, dessen selector das angebundene Feature erfüllt, löst keine Warnung aus. Diese Paarung ist keine vertippte freie Anbindung, sondern eine unter einem anderen Namen geschriebene Füllung, und ob das von Bedeutung ist, hängt davon ab, ob der Slot am Ende leer bleibt, was erst feststeht, wenn alle Geltungsbereiche zusammengeführt sind. Wo der Slot leer bleibt, bricht der Build ab und nennt die Anbindung und den Slot — siehe „An attachment written under another name fits a slot its component leaves empty (Eine unter einem anderen Namen geschriebene Anbindung passt zu einem Slot, den ihre Komponente leer lässt)“ in fatal-halts.md —, sodass der Abbruch der einzige gemeldete Befund ist, nie eine Warnung daneben. Wo etwas anderes den Slot bindet, ist die Anbindung eine gewöhnliche zusätzliche, und nichts wird gemeldet. Zu einem Slot, der keinen selector deklariert, passt kein Feature, sodass ein Name nahe einem solchen Slot immer die Warnung auslöst.
Nicht an einer Verbindung. Der Lint liest den eigenen Block features: einer Komponente, der offen ist. Die Anbindungen, die eine Verbindung trägt, sind nach den Slots geschlüsselt, die ihr Socket deklariert, und nach nichts anderem, sodass ein Name eine Bearbeitung von einem dieser Slots entfernt dort nicht zulässig ist: Stattdessen bricht der Build ab, und der Abbruch nennt im selben Satz den Slot, in dessen Nähe der Name liegt. Daneben wird keine Warnung ausgelöst. Siehe „A connection carries an attachment under a name its socket declares no slot for (Eine Verbindung trägt eine Anbindung unter einem Namen, für den ihr Socket keinen Slot deklariert)“ in fatal-halts.md.
Uses-socket near-miss lint (Lint für beinahe passende uses-Sockets)
Wird ausgelöst, wenn der eigene Block uses: einer Komponente einen Socket nennt, der keiner der in usesSchema deklarierten Sockets ihres Component-Typs ist, aber nur eine Bearbeitung von einem davon entfernt liegt — ein einzelnes eingefügtes, gelöschtes oder ersetztes Zeichen oder zwei vertauschte benachbarte Zeichen. Das ist die Form, die ein Tippfehler in einem Socket-Namen annimmt, und der Lint nennt beide Schreibweisen, damit der Autor das Paar sehen kann.
Warum es ihn gibt. Einen Socket zu deklarieren schließt die Oberfläche uses: an der eigenen Komponente eines Entwicklers nicht: Ein Socket-Name, den kein Eintrag in usesSchema deklariert, ist zulässig, weil das Schweigen des Katalogs zu einem Socket bedeutet, dass die Verbindung nicht vorgesehen, nicht aber verboten war, und der Entwickler die Topologie des Aggregate besitzt. Der Preis ist, dass ein falsch geschriebener Socket-Name zu einer eigenen Ad-hoc-Verbindung wird, statt den Socket zu verdrahten, den der Autor gemeint hat — der Build gelingt, der beabsichtigte Socket bleibt einfach unverdrahtet, und die Ad-hoc-Kante trägt keinen Selektor und keinen kantenbezogenen Vertrag. Der Lint ist die offen benannte Abmilderung genau für diesen Fall. Was ein Ad-hoc-Socket aufgibt und was er behält, steht in entities/component.md „Topologie-Sockets: usesSchema“.
Welche Oberfläche er abdeckt. Nur den eigenen Block uses: der Komponente — die eine Oberfläche, auf der ein nicht deklarierter Socket-Name akzeptiert wird. Das uses: einer Feature-Anbindung darf nur einen Socket nennen, den das angebundene Feature deklariert, und das kantenbezogene uses: eines Release darf nur einen Socket nennen, den die konsumierende Component deklariert; ein falscher Name auf einer dieser beiden bricht den Build bereits ab, sodass eine Warnung nichts hinzuzufügen hätte.
Position in der Pipeline. Der Lint läuft bei der Auflösung, im selben Durchlauf wie die katalogbewussten semantischen Schutzvorrichtungen, über das aufgelöste Aggregate. Er gleicht die eigenen Socket-Namen jeder Komponenteninstanz mit den deklarierten Socket-Namen des Component-Typs dieser Instanz ab und gibt pro Beinahe-Treffer-Paar eine Warnung aus. Eine Komponente, die aus einem Sub-Aggregat stammt, ist nicht abgedeckt: Ihre inneren Komponenten werden in den Graphen eingefügt, nachdem dieser Durchlauf gelaufen ist.
Ausgabeform:
lint: uses socket name is a near miss for a declared socket (Aggregate aggregate, at .spec.components.web, "databses", on component type "core/devtool/adminer", near the declared socket "databases")Der erste zitierte Wert ist der Socket-Name, den der Autor geschrieben hat, und um ihn geht es im einleitenden Satz der Warnung. Die beiden folgenden werden von den Wörtern eingeleitet, die sagen, was sie sind: der Component-Typ, an dem der Socket genannt wurde, und der deklarierte Socket, von dem er eine Bearbeitung entfernt liegt. Die Folge, die die Warnung nicht ausbuchstabiert, ist die oben beschriebene: Der falsch geschriebene Name ist eine Ad-hoc-Verbindung, trägt also keinen Selektor und keinen kantenbezogenen Vertrag, und der Socket, den der Autor gemeint hat, bleibt unverdrahtet.
Sichtbarkeit im Editor. Die Warnung erreicht auch die Editor-Diagnosen über den Language Server, mit dem Schweregrad Warnung, positioniert an der Komponente, deren Block uses: den beanstandeten Namen enthält. Ein Autor, der nie die Terminalausgabe liest, sieht das Paar trotzdem. Sie wird vor der Phase des Artefakt-Renderings ausgelöst und braucht daher keine Stellschraube: Eine Editor-Sitzung zeigt sie an, ob serve.build_on_inspect aktiviert ist oder nicht.
Schwelle und ihr Zielkonflikt. Der Lint paart Namen nur im Abstand von einer Bearbeitung und nur, wenn beide Namen mindestens vier Zeichen lang sind — dieselbe Grenze, die der Lint für beinahe passende Anbindungs-Slots verwendet, aus demselben Grund. Unterhalb dieser Länge liegt fast jeder kurze Name eine Bearbeitung von jedem anderen entfernt, sodass ihre Paarung Rauschen statt Signal erzeugen würde; jenseits einer Bearbeitung ähneln die Paare keinen Tippfehlern mehr. Eine Vertauschung zählt als eine Bearbeitung statt als zwei, weil ein vertauschtes Zeichenpaar der häufigste Ausrutscher ist und eine strengere Zählung ihn übersehen würde.
Anmerkung für Autoren. Der Lint ist ein Hinweis und ändert nie das Urteil des Builds — der Compiler überwacht nicht, wie ein Autor einen Socket benennt. Ein Autor, der bewusst eine Ad-hoc-Verbindung unter einem Namen zieht, der einem deklarierten Socket ähnelt (eine Verbindung cache neben einem deklarierten Socket caches, die für etwas anderes gedacht ist), kann die Warnung ignorieren; die Kante verhält sich genau so, wie sie geschrieben wurde. Es gibt kein Flag, um sie zu unterdrücken, und es ist keines nötig: Sie hat kein Gewicht für das Urteil.
Undeclared-provides-key lint (Lint für nicht deklarierte provides-Schlüssel)
Wird ausgelöst, wenn das an eine Komponenteninstanz gebundene Recipe unter seinem provides: einen Schlüssel veröffentlicht, den der Component-Typ der Instanz in seinem Vertrag spec.schema.provides: nicht deklariert.
Warum es ihn gibt. Mehr zu veröffentlichen, als die Component deklariert, ist zulässig und bleibt zulässig: Der Vertrag provides verlangt die Teilmenge und erlaubt die Obermenge, sodass ein Recipe, das den Vertrag seiner Component abdeckt und darüber hinaus zusätzliche Schlüssel ausgibt, ein Recipe ist, das ihn erfüllt. Was der Lint nennt, ist eine Folge, die sonst von keiner der beiden Seiten aus sichtbar ist. Ein Konsument, der über eine Kante uses: liest, sieht den deklarierten Vertrag des Ziels statt dessen, was das Recipe des Ziels gerade ausgibt — das hält Recipes austauschbar, denn zwei Recipes, die eine Component realisieren, bieten einem Konsumenten dann dieselbe Oberfläche, und sie auszutauschen kann nicht stillschweigend einen Schlüssel entziehen, auf den sich ein Konsument inzwischen verlässt. Ein nicht deklarierter Schlüssel wird daher nicht über die Kante geliefert, und ein konsumierendes Template, das ihn liest, rendert einen leeren Wert, statt fehlzuschlagen.
Der Befund wird an seiner Ursache angegeben — am Recipe, das den Schlüssel veröffentlicht hat —, weil er dort benannt werden kann. Beim Konsumenten ist der Schlüssel ein Template-Verweis, den der Compiler keinem bestimmten Ziel zuordnen kann, und eine Diagnose, die rät, wäre schlechter als gar keine. Die beiden stehen daher bewusst nicht am selben Ort: Der leere Wert erscheint beim Konsumenten, die Erklärung hier, und beide erscheinen in derselben Build-Ausgabe.
Welche Paarung verglichen wird. Die im gebundenen Recipe geschriebenen Schlüssel unter provides: gegen die deklarierten Schlüssel unter spec.schema.provides: des Component-Typs. Diese deklarierte Menge ist dieselbe, gegen die ein Schlüssel from: innerhalb eines Blocks inject: geprüft wird, sodass beide darin übereinstimmen, was eine Component deklariert. Der Vergleich ist exakt und kein Ähnlichkeitstest, sodass er anders als die beiden Beinahe-Treffer-Lints oben keine Schwelle hat und keine Namen paart.
Verglichen wird das Recipe, an das die Instanz tatsächlich gebunden ist, ermittelt über denselben Instanznamen und denselben Katalogtyp, über die auch das Rendering bindet, sodass eine Recipe-Überschreibung pro Instanz im Manifest berücksichtigt wird, statt in einem Durchschnitt unterzugehen. Eine Komponenteninstanz, deren Typ sich zu keiner Component des Katalogs auflöst, wird übersprungen: Es wurde keine Deklaration gelesen, und das ist nicht dasselbe wie eine Deklaration von nichts.
Position in der Pipeline. Der Lint läuft bei der Auflösung, im selben Durchlauf wie die katalogbewussten semantischen Schutzvorrichtungen, über das aufgelöste Aggregate — vor dem Rendering, sodass er bei aggrega validate --release ebenso sichtbar wird wie bei aggrega build. Components, die an der Wurzel des Aggregate deklariert sind, und in Subsystemen verschachtelte Komponenten sind beide abgedeckt. Eine Komponente, die aus einem Sub-Aggregat stammt, ist nicht abgedeckt: Ihre inneren Komponenten werden in den Graphen eingefügt, nachdem dieser Durchlauf gelaufen ist, sodass der nicht deklarierte Schlüssel einer solchen Komponente den Konsumenten zwar weiterhin vorenthalten wird, aber kein Hinweis ihn nennt.
Ausgabeform. Eine Zeile pro Komponenteninstanz und Schlüssel, die das Recipe nennt, das den Schlüssel veröffentlicht hat, und die Component, die ihn nicht deklariert:
lint: Recipe publishes a provides key its Component does not declare (Recipe broker-with-region, at .spec.provides.region, "region", on component type "core/ai-model/openai-compatible", bound to component instance "gateway")Der Befund gehört zu der Instanz, die ihn trägt, sodass zehn Instanzen eines Component-Typs, die denselben nicht deklarierten Schlüssel veröffentlichen, zehn Zeilen statt einer auslösen, jede mit ihrer eigenen Instanz. Jede Zeile wird dem Recipe zugeordnet, das den Schlüssel veröffentlicht hat, weil das das Dokument ist, das Sie bearbeiten, um ihn zu beheben. Der Durchlauf ist deterministisch, sodass dieselbe Eingabe bei jedem Lauf dieselbe Folge von Hinweisen erzeugt.
Sichtbarkeit im Editor. Der Hinweis erreicht auch die Editor-Diagnosen über den Language Server, mit dem Schweregrad Warnung, positioniert an der Komponenteninstanz, deren type: das Recipe bindet. Ein Autor, der nie die Terminalausgabe liest, sieht ihn trotzdem. Er wird vor der Phase des Artefakt-Renderings ausgelöst und braucht daher keine Stellschraube: Eine Editor-Sitzung zeigt ihn an, ob serve.build_on_inspect aktiviert ist oder nicht.
Anmerkung für Autoren. Der Lint ist ein Hinweis und ändert nie das Urteil des Builds — mit einem Recipe, das mehr veröffentlicht, als seine Component deklariert, gelingt der Build trotzdem. Die Korrektur ist eine von zwei, und welche die richtige ist, entscheidet der Autor: den Schlüssel an der Component deklarieren, wenn Konsumenten ihn lesen sollen, oder ihn nicht deklariert lassen, wenn er der eigene Arbeitszustand des Recipe ist; in diesem Fall gehört ein solcher Zustand in locals:. Der umgekehrte Fall ist kein Hinweis: Eine Component, die einen Schlüssel deklariert, den ihr Recipe nicht veröffentlicht, lässt den Vertrag unerfüllt und bricht den Build ab.
Ghost Infrastructure Tracker warnings (Warnungen des Ghost-Infrastructure-Trackers)
Wird ausgelöst, wenn ein von einem Autor deklarierter Schlüssel einen Knoten erreicht und kein Template, das das gebundene Recipe deklariert, ihn je referenziert. Die ungelesenen Schlüssel werden zu stiller Infrastruktur: Konfiguration, die der Entwickler oder der Operator angefordert hat und die das Recipe nie in die gerenderte Ausgabe verdrahtet. Der Tracker macht sie sichtbar, sodass die Diskrepanz zwischen dem, was geschrieben wurde, und dem, was die Ausgabe enthält, sichtbar statt still ist.
Welche geschriebenen Schlüssel verglichen werden. Drei Gruppen, pro Knoten:
.values— die eigene entwicklerseitige Säule des Knotens..infra— die eigene operatorseitige Säule des Knotens..context.uses.<alias>.values— die verbindungsbezogenen Werte, die jede Kanteuses:trägt, über die der Knoten konsumiert. Diese Gruppe ist ohne Weiteres konsumentenbezogen: Die Mapuseseines Knotens enthält nur die Kanten, deren Quelle er ist, sodass ein ungelesener verbindungsbezogener Wert immer dem Knoten zugeordnet wird, der ihn geschrieben hat, und nie dem Ziel der Kante.
Welche Referenzen gesammelt werden. Jedes Template, das das gebundene Recipe deklariert. Die Warnung besagt, dass ein Schlüssel von nichts gelesen wird, was eine Aussage über das ganze Recipe ist, sodass alles, was enger ist als das ganze Recipe, sie falsch statt nur ungenau machen würde — ein Schlüssel, den eine Koordinate source: konsumiert, würde genau von dem Lauf als ungelesen gemeldet, der die von ihr genannte Version abgerufen hat. Gelesen werden die folgenden Blöcke:
valuesMapping:, das values-Overlay, das dem Provider übergeben wird.source:— das ganze Feld, wo es als einzelner String geschrieben ist, und jedes seiner Felder mit String-Wert, wo es als Objekt geschrieben ist. Eine Quellkoordinate ist ein Template, das pro konsumierender Instanz ausgewertet wird, sodass eine Version, ein Chart-Name, eine Git-Referenz oder ein Modul-Unterverzeichnis, die aus.valuesoder.infragewählt werden, diese Schlüssel lesen.locals:undprovides:, jeder Eintrag.assertions:, jeder Eintrag.workload:, der synthetisierte Workload-Körper.artifacts:, der Inhalt jedes Eintrags.pipeline:, die Eingabewith:jedes Schritts und sein Gatewhen:.
Daraus folgen drei Grenzen, und alle drei sind Grenzen dessen, was sich ehrlich behaupten lässt, keine Entscheidungen. Jede von ihnen bringt das Lesen zum Schweigen, statt es auszuweiten, was die Richtung ist, die am wenigsten kostet: Ein nicht gemeldeter Schlüssel kostet einen Leser einen Hinweis, den er immer noch finden kann, indem er das Recipe liest, während ein fälschlich gemeldeter ihm sagt, eine funktionierende Einstellung sei ignoriert worden.
- Ein Recipe ohne inline geschriebenes
valuesMapping:wird überhaupt nicht gelesen. Seine Schlüssel werden übersprungen statt gemeldet, was auch immer seine anderen Templates tun. - Ein Block, den das Recipe aus einer Datei oder über eine Bibliotheksreferenz importiert, liegt an diesem Punkt nicht vor, sodass seine Referenzen nicht gesammelt werden können. Die Schlüssel des Knotens werden vollständig übersprungen statt gemeldet — das gilt gleichermaßen für ein importiertes
valuesMapping:, ein importiertesworkload:und einen importierten Eintragartifacts:. - Ein Template, das sich nicht parsen lässt, liefert überhaupt keine Referenzmenge. Jeden Schlüssel als ungelesen zu melden, würde die Parse-Diagnose verschütten, die die Auswertung zum selben Template auslöst, daher wird stattdessen nichts gemeldet. Ein Eintrag
artifacts:wird mit den Standardbegrenzern{{ }}gelesen, die nicht das Paar sind, das jeder Provider für dieses Feld deklariert; mit dem falschen Paar gelesen, liefert ein solcher Körper Referenzen, die sein Autor nie geschrieben hat, oder lässt sich nicht parsen, und beide Ergebnisse können immer nur eine Warnung zum Schweigen bringen.
Das valueSchema eines Sockets wird nie markiert. usesSchema.<socket>.valueSchema deklariert den Vertrag, den ein verbindungsbezogener Wert erfüllen muss. Es ist ein Schema, keine geschriebene Instanz, und es gehört nicht zu den verglichenen Eingaben — daher kann es nie gemeldet werden. Was der deklarierte Standardwert eines Sockets erzeugt, ist eine Instanz wie jede andere, gelesen oder ungelesen nach ihren eigenen Gegebenheiten.
Eine Referenz, die eine ganze Säule nennt, zählt jeden Schlüssel darunter als gelesen. {{ .infra.port }} markiert port als gelesen und lässt die anderen Schlüssel der Säule für eine Warnung in Frage kommen. {{ optional .infra `port` 8080 }} übergibt die ganze Map .infra an eine Funktion, sodass die gesammelte Referenz die Säule nennt statt eines Schlüssels darunter, jeder Schlüssel in dieser Säule als gelesen zählt und die Säule nichts auslöst. Dasselbe gilt für das Iterieren über eine Säule mit range und für das Erreichen eines Eintrags von uses über index. Ein Recipe-Autor, der Abdeckung pro Schlüssel will, schreibt Referenzen pro Schlüssel.
Das betrifft jeden der oben genannten Blöcke, und es ist wissenswert, bevor eine stille Säule als verpasste Warnung gelesen wird: Ein Recipe, dessen Version in source: als {{ optional .infra `source_version` "1.2.3" }} geschrieben ist, hat die ganze Map .infra an eine Funktion übergeben, sodass dieses Recipe nichts über irgendeinen Schlüssel von .infra auf irgendeinem Knoten meldet, den es rendert. Die Säule .values ist nicht betroffen — die beiden werden getrennt gezählt.
Position in der Pipeline. Der Tracker läuft beim Basis-Rendering, neben der Template-Auswertung. Jedes Template des Recipe wird geparst und durchlaufen, um die punktqualifizierten Feldpfade zu sammeln, die es referenziert (.values.port, .infra.replicas, .context.uses.<alias>.values.retry_budget); die aufgelöste Schlüsselmenge jeder Gruppe wird mit der Vereinigung dieser Referenzen verglichen, und die Differenz ist die ungelesene Menge. Durchlaufen wird das Recipe so, wie es geschrieben ist: Eine Koordinate source: wird als ihr Template-Text gelesen, nicht als der Wert, den dieses Template für diese Instanz erzeugt hat.
Ausgabeform. Eine Zeile pro ungelesenem Schlüssel, die den Knoten, den Pfad der Gruppe, den Schlüssel und das Recipe nennt, von dessen Templates keines ihn liest:
warning: node "data.main-db": .values key "database_name" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "data.main-db": .infra key "storage_class" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "frontend": .context.uses.my-api.values key "retry_budget" is read by no template in recipe "helm-web-ui-sourced-with-artifacts" — correct the spelling, or remove the keyDie Zeile nennt kein Feld des Recipe, und das ist beabsichtigt: Wer den Schlüssel geschrieben hat, ist der Entwickler, der Operator oder der Autor der Kante uses:, auf der er mitfährt, und keiner von ihnen bearbeitet das Recipe. Den Block zu nennen, in dem nach der Referenz gesucht wurde, würde diesem Leser eine Koordinate in einem Dokument geben, das er nicht öffnet. Die beiden Abhilfen, die die Zeile anbietet, sind die beiden, auf die er reagieren kann — ein falsch geschriebener Schlüssel ist die häufige Ursache, und ein Schlüssel, der nie gelesen werden sollte, ist es wert, gelöscht zu werden.
Die Reihenfolge ist fest: zuerst .values des Knotens, dann sein .infra, dann jeder Alias von uses in der Reihenfolge, in der die Kanten ausgegeben wurden, mit sortierten Schlüsseln innerhalb jeder Gruppe. Dieselbe Eingabe erzeugt daher bei jedem Lauf dieselbe Abfolge von Warnungen.
Sichtbarkeit im Editor. Die Warnung erreicht die Editor-Diagnosen nur dort, wo der Language Server beim Inspizieren eines IR-Graphen die Phase des Artefakt-Renderings ausführt — aggrega serve --build-on-inspect oder der Konfigurationsschlüssel serve.build_on_inspect, den das Flag überschreibt und der standardmäßig deaktiviert ist. Diese Stellschraube fügt die Hinweise hinzu, die ein Build beim Rendern auslöst, und keine der Prüfungen, bei denen ein Build abbricht. Der Eintrag nennt einen Knoten statt eines Authoring-Schlüssels und wird daher am Schlüssel kind: des Aggregate angezeigt.
Warum eine Warnung und kein fataler Abbruch. Entwickler dürfen in bedingter Template-Logik berechtigterweise unterschiedliche Teilmengen von .values konsumieren — ein Recipe, dessen Template nach .values.mode verzweigt, liest mode, liest .values.replication_password aber bedingt, nur wenn mode == "replication". Der statische Durchlauf kann nicht erkennen, ob ein nicht referenzierter Schlüssel belanglos oder ein Fehler ist. Der Zweck des Trackers ist es, die Diskrepanz sichtbar zu machen, statt sie zu überwachen; stilles Auslassen ist der Fehlermodus, den der Tracker verhindert.
Reaktion des Recipe-Autors. Wenn ein Recipe-Autor eine Ghost-Infrastructure-Warnung für einen Schlüssel sieht, von dem er erwartet hat, dass das Recipe ihn konsumiert, besteht die Korrektur darin, den Schlüssel in das Template zu verdrahten. Wenn der ungelesene Schlüssel eine bewusste Auslassung ist (eine Funktion, die das Chart nicht unterstützt, eine Authoring-Möglichkeit, die das Recipe bewusst ignoriert), kann der Autor die Auslassung im Kopfkommentar des Recipe dokumentieren, damit künftige Leser wissen, dass die Diskrepanz beabsichtigt ist.
Unread declared-parameter warnings (Warnungen zu nicht gelesenen deklarierten Parametern)
Wird ausgelöst, wenn ein Aggregate einen Eintrag unter spec.parameters: deklariert und keine Referenz {{ .parameters.<key> }} im eigenen Text dieses Aggregate ihn liest.
Ein deklarierter Parameter ist die Authoring-Oberfläche, um einen Wert pro Release zu variieren: Das Release erfüllt die Deklaration, und eine Referenz trägt den erfüllten Wert in die Komponentenwerte, zu denen er gehört. Eine Deklaration, die nichts liest, lässt dieser Variation keinen Ort, an dem sie ankommen könnte — was auch immer ein Release dafür liefert, die gerenderte Ausgabe ist dieselbe. Es ist die parameterbezogene Form derselben Auffälligkeit, die ein geschriebener values-Schlüssel trägt, den nichts konsumiert.
Ein Standardwert ist keine Ausnahme. Ein Standardwert, den keine Referenz liest, erreicht die Ausgabe ebenso wenig wie ein von einem Release gelieferter Wert, sodass eine Deklaration mit Standardwert genau so gemeldet wird wie eine ohne.
Welche Referenzen gesammelt werden. Der eigene Text des Aggregate und nichts anderes. Daraus folgen drei Konsequenzen:
- Ein Parameter, den nur das Prädikat
validate:des Schemas einer Component erreicht, ist hier nicht sichtbar. Ein solches Prädikat nennt den Parameter über die aufgelöste Parameter-Map statt über eine Punktreferenz im Aggregate, sodass die Deklaration als ungelesen gemeldet wird, obwohl das Prädikat sie liest. - Text, der sich nicht als Template parsen lässt, liefert keine Referenzmenge. Jede Deklaration als ungelesen zu melden, würde die Diagnose verschütten, die die Interpolation zum selben Text auslöst, daher wird stattdessen nichts gemeldet.
- Eine Referenz, die die ganze Map
parametersnennt — beim Iterieren über sie oder beim Erreichen eines Eintrags über index —, zählt jede Deklaration als gelesen, weil die gesammelte Referenz dann die Map statt eines Schlüssels darunter nennt und keine Aussage pro Schlüssel möglich ist.
Position in der Pipeline. Das Lesen läuft bei der Auflösung, über den Rohtext des Aggregate und seinen deklarierten Parametervertrag — vor dem Rendering. Daher erscheint der Befund bei aggrega validate ebenso wie bei aggrega build.
Ausgabeform. Eine Zeile pro ungelesener Deklaration, die das Aggregate und den Lokator der Deklaration nennt:
lint: declared parameter is read by no reference in the Aggregate (Aggregate fullstack-app, at .spec.parameters.unread_probe, "unread_probe")Befunde kommen in der Reihenfolge an, in der das Aggregate seine Parameter deklariert, sodass dasselbe Aggregate bei jedem Lauf dieselbe Abfolge erzeugt. Jeder trägt den Lokator der Deklaration, der den beanstandeten Schlüssel nennt. Die Meldung nennt den Schlüssel ebenfalls, weshalb er auf einer Terminalzeile, die auch den Lokator ausgibt, zweimal erscheint: Ein Editor zeigt die Meldung an der Position, an der er sie platziert hat, und nie den Lokatortext, sodass eine Meldung, die den Schlüssel wegließe, für jede ungelesene Deklaration gleich lauten würde.
Sichtbarkeit im Editor. Der Hinweis erreicht auch die Editor-Diagnosen über den Language Server, mit dem Schweregrad Warnung, positioniert an der Deklaration, die sein Lokator nennt, statt am Aggregate als Ganzem. Er wird vor der Phase des Artefakt-Renderings ausgelöst und braucht daher keine Stellschraube: Eine Editor-Sitzung zeigt ihn an, ob serve.build_on_inspect aktiviert ist oder nicht.
Warum eine Warnung und kein fataler Abbruch. Ein Parameter darf vor der Referenz deklariert werden, die ihn lesen wird, und ein statischer Durchlauf kann das nicht von einem Fehler unterscheiden — derselbe Grund, aus dem das Lesen der geschriebenen Schlüssel immer nur Hinweise gibt. Der Compiler überwacht nicht, welche Stellschrauben ein Autor freilegt.
Provider-binding unserved-capability warning (Warnung zu einer nicht bedienten Fähigkeit einer Provider-Bindung)
Wird ausgelöst, wenn ein Eintrag unter plugins.providers in der Workspace-Konfiguration eine capability und keine uri nennt und keines der Provider-Plugins, die der Build liest, diese Fähigkeit bedient. Die Plugins, die ein Build liest, sind die in seinen Katalogverzeichnissen, die Provider im Compiler und die Plugins, die sein Lockfile festhält.
Warum es sie gibt. Eine Bindung wird nur gelesen, wenn das capability: eines Recipe ihre Fähigkeit anfordert, und ein Eintrag, der kein Plugin nennt, wählt nichts aus, was die Auflösung der Fähigkeit nicht auch ohne ihn auswählen würde. Ein Eintrag, dessen Fähigkeit falsch geschrieben ist — hlem statt helm —, wird also von nichts konsultiert und ändert nichts, und ohne diese Warnung würde nichts darauf hinweisen.
Warum eine Warnung und kein fataler Abbruch. Bindungen werden einmal für den ganzen Workspace geschrieben, während ein Build ein einzelnes Release betrifft. Das Plugin, das die Fähigkeit bedient, kann eines sein, das nur ein anderes Release im Workspace liest, und dieser Build kann es nicht sehen, sodass ein Abbruch hier einen zulässigen Workspace aufgrund einer Vermutung zurückweisen würde. Ein Eintrag, der auch ein Plugin nennt, ist ein anderer Fall: Ein Pull löst jeden solchen Eintrag auf, ob ein Recipe ihn verwendet oder nicht, sodass der Build das Plugin vorliegen hat und weiß, was es bedient, und eine Fähigkeit, die dieses Plugin nicht bedient, führt zum Abbruch — siehe fatal-halts.md „A plugins.providers binding names a plugin that does not serve the capability (Eine Bindung benennt ein Plugin, das die Fähigkeit nicht bedient)“. Ein Eintrag für eine Fähigkeit, die irgendein vom Build gelesenes Plugin tatsächlich bedient, löst keinerlei Meldung aus, ob ein Recipe in diesem Release sie verwendet oder nicht.
Position in der Pipeline. Jeder Build und jede Validierung eines Release liest jeden Eintrag in der zusammengesetzten Workspace-Konfiguration — die Schichten samt ihren Ergänzungen providers_append —, bevor der Graph des Release analysiert wird, sodass die Warnung bei aggrega validate --release ebenso erscheint wie bei aggrega build und bei aggrega pull, das das Release einmal rendert, über das Lockfile, das es gleich schreiben wird, um die externen Eingaben zu ermitteln, die ein Build davon abruft. Die Beurteilung ändert nichts daran, welches Plugin ein Recipe rendert; das wird aus dem Lockfile gelesen.
Ausgabeform. Eine Zeile pro Eintrag, in der Reihenfolge, in der die zusammengesetzte Liste sie führt, die die Fähigkeit nennt und, wo es eine gibt, eine bediente Fähigkeit, die eine Bearbeitung entfernt ist:
warning: plugins.providers entry names a capability no provider-rendering plugin the build reads serves: capability "hlem", which is one edit from "helm"; the entry names no plugin, so it selects nothing a Recipe would not resolve without it, and none of the plugins this build reads — in the catalog directories, inside the compiler, or among those the lockfile records — serves the capability: correct its spelling, or keep it where the plugin serving it is one only another Release readsSchwelle. Eine Schreibweise wird nur im Abstand von einer Bearbeitung angeboten und nur, wenn beide Namen mindestens vier Zeichen lang sind — dieselbe Grenze, die die Beinahe-Treffer-Lints oben verwenden, und aus demselben Grund.
Sichtbarkeit im Editor. Die Warnung erreicht die Editor-Diagnosen über den Language Server mit dem Schweregrad Warnung. Der Eintrag steht in der Konfigurationsdatei statt im bearbeiteten Dokument, daher wird sie am Anfang dieses Dokuments platziert statt an einem Schlüssel.
Metadatenabdeckung pro Entität
Welche Entitätshüllen metadata.labels und metadata.annotations tragen, hängt vom Typ ab. Component, Feature und die Bibliothekstypen tragen beide; Aggregate trägt nur Labels; Recipe, FeatureRecipe, Manifest, Release und Plugin akzeptieren keinen der beiden Schlüssel auf Ebene der Hülle. Status der Sprache führt den Stand pro Entität und ist die Stelle, die man konsultiert.
Sichtbarkeit im Editor. Kein Hinweis deckt dies ab, bei keiner Einstellung: Es gibt nichts zu melden, weil eine Entität diese Schlüssel entweder trägt oder sie nicht akzeptiert, und ein Schlüssel, den ein Typ nicht akzeptiert, ist eine Frage, die sein Schema beim Laden des Dokuments beantwortet, und nichts, was die Rendering-Phase hinterher meldet. Ein Autor sieht auf der Statusseite nach, statt auf eine Warnung zu warten.
Unsupported-field warnings (Warnungen zu nicht unterstützten Feldern)
Eine einzige Klasse deckt alles ab, was Sie geschrieben haben und was das Ziel nicht umsetzen kann. Sie hat zwei Mitglieder — ein Workload-Feld, das das Ziel nicht ausdrücken kann, und eine Annotation aggrega.ai/, nach der das Ziel nicht handelt —, und sie teilen sich einen Klassencode und ein Unterdrückungs-Flag, weil ein Autor, der „die Dinge, die dieses Ziel ignoriert“ zum Schweigen bringen will, sie zusammen zum Schweigen bringen will statt mit einem Schalter nach dem anderen.
A Workload field the target cannot express (Ein Workload-Feld, das das Ziel nicht ausdrücken kann)
Ziele unterscheiden sich in ihrer Treue. Ein Workload-Feld, das ein Ziel nativ ausdrückt, hat auf einem anderen vielleicht keine Entsprechung — Docker Compose kennt zum Beispiel weder eine Scheduling-Einschränkung noch einen Service-Account noch eine Prioritätsklasse. Wenn eine Workload ein solches Feld deklariert und das Ziel es nicht ausdrücken kann, wird das Feld mit einer Warnung ausgelassen, eine Warnung pro geschriebenem Feld. Es wird weder stillschweigend verworfen noch als fataler Fehler behandelt.
Der Unterschied zu einem fatalen Abbruch ist die Granularität. Eine nicht unterstützte Form bricht den Build lautstark ab — das Ziel kann diese Form von Arbeitslast überhaupt nicht erzeugen. Eine unterstützte Form, die ein nicht ausdrückbares Feld trägt, wird gerendert, ohne dieses Feld, und sagt das.
Beim Compose-Ziel deckt die Klasse derzeit scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, das runAsNonRoot eines Containers und jeden Schlüssel einer erweiterten Ressource außer nvidia.com/gpu ab — zum Beispiel amd.com/gpu —, da jener für NVIDIA-GPUs reserviert ist. Die folgenden Fälle geben eine Teilvariante derselben Klasse aus, bei der das Feld reduziert statt entfernt wird:
persistentTemplate— Volume-Templating pro Replik ist nicht verfügbar, daher fällt das Volume zu einem einzigen gemeinsam genutzten persistenten Volume zusammen, statt zu verschwinden.- Ein Eintrag
attachmentseines Containers mitas: env— Compose kann eine Umgebungsvariable nicht aus einer Anbindung beziehen, daher wird die Variable mit einem leeren Wert ausgegeben. Die Warnung nennt den Eintrag an seiner geschriebenen Koordinate (containers.<name>.attachments.<KEY>oderinitContainers[<i>].attachments.<KEY>für einen positionalen Init-Eintrag), sodass klar ist, welche Variable leer ankommt und zu welchem Container sie gehört. Ein Eintrag mitas: filewird normal per Bind-Mount eingebunden und löst nichts aus. - Ein Eintrag
volumes, den kein Container einhängt — die Warnung nennt das Volume an seiner geschriebenen Koordinate (volumes.<name>). Was die Ausgabe erreicht, hängt von der Variante ab: Ein VolumepersistentoderpersistentTemplatewird trotzdem als benanntes Volume deklariert, das dann angelegt und ungenutzt gelassen wird, während ein Volumeconfigmap,secretoderephemeraldie Ausgabe nur über den Einhängepunkt eines Containers erreicht, sodass die Deklaration, wenn nichts es einhängt, überhaupt keine Ausgabe erzeugt. So oder so bewirkt das Volume, das Sie geschrieben haben, nichts: Hängen Sie es in einem Container ein, oder entfernen Sie es. Jeder Container der Arbeitslast zählt als einhängend, Init-Container eingeschlossen, sodass ein Volume, das nur ein Init-Container einhängt, nichts auslöst. - Ein Block
health, der mehr als einen Probe-Slot deklariert — ein Compose-Dienst trägt ein einzigeshealthcheck, daher behält die Prioritätsreihenfolgelive > ready > startupeinen Slot, und jeder andere deklarierte Slot erreicht keinen Teil der Ausgabe. Die Warnung nennt den Block an seiner geschriebenen Koordinate (containers.<name>.healthoderinitContainers[<i>].healthfür einen positionalen Init-Eintrag) und nennt sowohl den übersetzten Slot als auch die verworfenen Slots, sodass klar ist, welche Probe in der Ausgabe aktiv ist und welche geschriebene Absicht wirkungslos ist. Ein Block, der einen einzigen Slot deklariert, wird verlustfrei übersetzt und löst nichts aus. hostNetworkauf einer Arbeitslast, die auchinitContainersdeklariert — der eigene Dienst der Arbeitslast läuft im Netzwerk des Knotens, aber jeder Init-Container wird zu einem eigenen Dienst, der dem Boundary-Netzwerk aus eigenem Recht beitritt, weil das Teilen des Namespace des Hauptdienstes das Warten des Hauptdienstes auf ihn zirkulär machen würde. Das ist enger als die modellierte Pod-Form, in der jeder Container einen einzigen Namespace teilt, daher wird der Unterschied benannt, statt ihn zur Laufzeit entdecken zu lassen. Eine Arbeitslast, diehostNetworkohne Init-Container deklariert, wird verlustfrei übersetzt und löst nichts aus.
An annotation the target does not act on (Eine Annotation, nach der das Ziel nicht handelt)
Die Annotationen aggrega.ai/ sind Plattformdirektiven, die ein Provider liest und auf das anwendet, was er rendert — einen Namespace, ein Registry-Präfix, einen Service-Account. Welche davon ein Provider liest, ist die eigene Deklaration dieses Providers, getroffen pro Eingabeart, weil ein Provider, dem jedes Feld einer selbst synthetisierten Bereitstellungseinheit gehört, oft keinen Ort hat, an dem er denselben Wert unterbringen kann, wenn er ein gevendortes Artefakt rendert. Bekannte Annotationen ist die Matrix.
Das eigene Recipe eines Knotens und jedes an diesen Knoten angebundene Feature werden getrennt gerendert, jeweils über das Ziel, das ihr eigenes capability: nennt, und in den Eingabearten, die ihre eigenen source:, workload: und artifacts: deklarieren. Wenn eine solche Annotation eines dieser Renderings erreicht und die Deklaration des aufgelösten Ziels den Schlüssel bei keiner der Eingabearten abdeckt, die dieses Rendering deklariert, wendet das Ziel für diesen Schlüssel nichts an, und der Build meldet das mit einer Warnung, die den Schlüssel, das Ziel und jede Eingabeart nennt, die dieses Rendering deklariert:
warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored itDiese Konsequenzen ergeben sich daraus, wie Annotationen ein Rendering erreichen, und jede davon ist beabsichtigt:
- Eine geschriebene Zeile kann mehrere Warnungen erzeugen. Eine Boundary-Annotation kaskadiert auf jede Komponente darunter, und diese Komponenten können über verschiedene Ziele und verschiedene Eingabearten gerendert werden. Jede Warnung ist eine wahre Aussage über ein einzelnes Rendering, daher erhalten Sie eine pro Rendering, das nicht nach dem Schlüssel handeln kann — und genau das sagt Ihnen auch, welche Teile Ihrer Ausgabe betroffen sind.
- Ein an einen Knoten angebundenes Feature wird nach seinem eigenen FeatureRecipe beurteilt, nicht nach dem Recipe des Knotens. Eine Anbindung, die eigene Ressourcen erzeugt, rendert sie über das Ziel, das ihr FeatureRecipe nennt, in den Eingabearten, die dieses FeatureRecipe deklariert — daher erreicht eine Annotation, die das eigene Ziel des Knotens anwendet, in den Dateien der Anbindung möglicherweise nichts, und umgekehrt gilt das ebenso. Sie werden über jede unabhängig informiert, weil es verschiedene Dateien sind. Dasselbe gilt für ein Feature, das an eine Boundary statt an eine benannte Komponente angebunden ist. Eine Anbindung, deren FeatureRecipe keines von
source:,workload:undartifacts:deklariert, rendert keine eigenen Dateien — sie trägt bei, indem sie Werte injiziert, über die Kanteuses, die ihr Feature trägt, oder über eine Pipeline über Dokumente, die etwas anderes ausgegeben hat —, daher gibt es keine eigene Ausgabe, in der eine Annotation fehlen könnte, und für sie wird nichts gewarnt. - Ein Rendering, das mehr als eine Eingabeart deklariert, wird nach allen beurteilt. Seine deklarierten Arten setzen sich durch Addition zusammen, und ihre Ausgaben werden zusammengefügt, sodass ein Ziel, das den Schlüssel bei irgendeiner davon liest, ihn anwendet und der Wert in der gerenderten Ausgabe erscheint. In diesem Fall wird nichts gewarnt, weil es nichts zu melden gibt. Eine Warnung erscheint nur, wenn jede deklarierte Art den Schlüssel verfehlt, und sie nennt sie alle —
on sourced or synthesized input. - Nur die reinen Schlüssel
aggrega.ai/werden geprüft. Ein Schlüssel mit Unterpräfix —compliance.aggrega.ai/data-classoder Ihr eigenesacme.aggrega.ai/team— ist Ihr Vokabular, das der Compiler durchreicht, ohne es zu interpretieren. Nichts warnt jemals vor einem solchen Schlüssel. - Ein Ziel, das überhaupt keinen Unterstützungsanspruch deklariert, löst nichts aus. Die Warnung vergleicht, was Sie geschrieben haben, mit dem, was der Provider zu lesen angegeben hat; ein Provider, der nichts angegeben hat, gibt ihr nichts zum Vergleichen, und aus Schweigen eine Ablehnung abzuleiten, würde eine Aussage melden, die der Autor des Providers nie gemacht hat. Ein Provider, der keinen der Schlüssel liest, sagt das mit
readsNoWellKnownAnnotations: true, wie esterraformtut, und jeder reine Schlüssel, der eines seiner Renderings erreicht, führt dann zu einer Warnung.
Warum eine Warnung und kein Abbruch. Eine Boundary, die berechtigterweise Komponenten auf heterogenen Zielen umfasst, wird immer einen Knoten haben, der nach einem bestimmten Schlüssel nicht handeln kann — das ist die normale Form eines Release, das mehrere Ziele umfasst, kein Fehler —, daher würde eine Ablehnung des Builds korrekte Releases zurückweisen. Der Wert wird unverändert durchgereicht, und die Warnung sagt es Ihnen.
Der Klassencode und die Out-of-Band-Garantie
Jede Warnung trägt den stabilen, maschinell abgleichbaren Klassencode unsupported-field, sodass Werkzeuge die Klasse abgleichen können, statt den Meldungstext zu parsen. Jedes Mitglied der Klasse — das vollständig ausgelassene Feld, das Feld in reduzierter Form und die Annotation, nach der nicht gehandelt wird — trägt diesen einen Code, und das erlaubt es einem einzigen Filter, die ganze Klasse zu unterdrücken. Die Warnungen werden Out-of-Band, getrennt von den gerenderten Artefakten, übermittelt, was bedeutet, dass gerenderte Bytes byte-identisch sind, ob die Warnungen erscheinen oder nicht — sie zu unterdrücken kann Ihre Ausgabe nicht verändern.
Sichtbarkeit im Editor. Jedes Mitglied der Klasse erreicht die Editor-Diagnosen nur dort, wo der Language Server beim Inspizieren eines IR-Graphen die Phase des Artefakt-Renderings ausführt — aggrega serve --build-on-inspect oder der Konfigurationsschlüssel serve.build_on_inspect, den das Flag überschreibt und der standardmäßig deaktiviert ist. Diese Stellschraube fügt die Hinweise hinzu, die ein Build beim Rendern auslöst, und keine der Prüfungen, bei denen ein Build abbricht. Der obige Klassencode wird mit der veröffentlichten Diagnose ebenso übermittelt wie mit der Terminalzeile, sodass ein Editor-Client dieselbe Klasse abgleicht, die ein Autor liest. Jeder Eintrag nennt einen Knoten und ein Ziel statt eines Authoring-Schlüssels und wird daher am Schlüssel kind: des Aggregate angezeigt.
Unterdrücken der Klasse
Beide Befehle, die rendern, akzeptieren --no-unsupported-field-warnings, das nur diese Klasse stummschaltet, während jede andere Render-Warnung weiterhin erscheint:
aggrega build --release release.yaml --no-unsupported-field-warningsaggrega validate ./catalog/recipe/compose/mariadb/1.0.0/recipe.yaml --no-unsupported-field-warningsDas Flag betrifft nur die Anzeige und verändert die gerenderte Ausgabe nicht. aggrega lint hat kein entsprechendes Flag, weil es keinen Render-Durchlauf ausführt — es prüft nur Veröffentlichungskonventionen, sodass dort keine Render-Warnung entstehen kann.
Greifen Sie zu dem Flag, wenn Sie die reduzierte Treue bewusst akzeptiert haben — ein Compose-Ziel für die lokale Entwicklung, bei dem erwartet wird, dass die Scheduling- und Service-Account-Felder der Produktions-Workload wirkungslos sind. Lassen Sie es andernfalls aus: Die Warnung ist der Weg, auf dem Sie erfahren, dass ein Feld, das Sie geschrieben haben, das Ziel nicht erreicht.
A declared-sensitive value travels as a literal (Ein als sensibel deklarierter Wert wird als Literal übertragen)
Wird ausgelöst, wenn eine Anbindung einen Slot füllt, indem sie ein Datum, das ihr Schema als sensibel deklariert, als Literalwert in einen Zustellschlüssel liefert statt als Referenz, die das Ziel beim Bereitstellen auflöst.
Ausgabeform. Eine Zeile pro Zustellschlüssel, die die Anbindungsinstanz, den Zustellmechanismus, in dem der Schlüssel landet, und den Schlüssel selbst nennt, zugeordnet dem Knoten und dem Ziel, die ihn gerendert haben:
warning: node "db" (provider "compose"): attachment "user_password" delivers a value declared sensitive to env delivery key "MARIADB_PASSWORD" as a literal; where the target supports it, fill the slot with an attachment that delivers a reference insteadDer Klassencode. Der Hinweis trägt den stabilen, maschinell abgleichbaren Klassencode sensitive-by-value, sodass Werkzeuge die Klasse abgleichen, statt den Meldungstext zu parsen. Der Code wird auf der Terminalzeile und in der strukturierten Diagnose übermittelt, die der Language Server veröffentlicht, sodass ein Autor und ein Editor-Client dieselbe Klasse lesen — unter der unten beschriebenen Bedingung für die Sichtbarkeit im Editor, die bestimmt, ob der Language Server diesen Hinweis überhaupt veröffentlicht.
Sichtbarkeit im Editor. Der Hinweis erreicht die Editor-Diagnosen nur dort, wo der Language Server beim Inspizieren eines IR-Graphen die Phase des Artefakt-Renderings ausführt — aggrega serve --build-on-inspect oder der Konfigurationsschlüssel serve.build_on_inspect, den das Flag überschreibt und der standardmäßig deaktiviert ist. Diese Stellschraube fügt die Hinweise hinzu, die ein Build beim Rendern auslöst, und keine der Prüfungen, bei denen ein Build abbricht. Der Eintrag nennt einen Knoten und ein Ziel statt eines Authoring-Schlüssels und wird daher am Schlüssel kind: des Aggregate angezeigt.
Es ist eine eigene Klasse, und --no-unsupported-field-warnings deckt sie nicht ab. Dieses Flag schaltet die oben beschriebene Klasse der nicht unterstützten Felder stumm; dieser Hinweis erscheint daneben weiterhin. Es gibt kein Flag, das diesen stummschaltet.
Der Build gelingt, und die gerenderten Bytes bleiben unverändert. Der Hinweis wird Out-of-Band, getrennt von den gerenderten Artefakten, übermittelt, wie die Klasse der nicht unterstützten Felder, sodass das, was Ihre Ausgabe erreicht, dasselbe ist, ob die Zeile erscheint oder nicht.
A declared-sensitive value reaches the target through a values mapping (Ein als sensibel deklarierter Wert erreicht das Ziel über ein values-Mapping)
Wird ausgelöst, wenn ein Rendering aus einer source: seinem Ziel die Ausgabe eines valuesMapping: übergibt, während die Entität, deren values dieses Mapping liest, ein Blatt in values als sensibel deklariert: das Mapping eines Recipe über ein Blatt, das seine Component deklariert, oder das Mapping des FeatureRecipe eines an eine Komponente angebundenen Feature über ein Blatt, das dieses Feature deklariert. Ein Mapping ist ein einzelnes Template, dessen Ausgabeschlüssel seine eigene Erfindung sind, daher nennt keine Deklaration einen davon, und das Ziel erhält für das Blatt keine schlüsselbezogene Sensibilitätsmarkierung. Es ist die eine Renderform, in der eine Deklaration keinen gerenderten Schlüssel erreicht, während der Autor noch einen Hebel darüber hat.
Ausgabeform. Eine Zeile pro deklariertem Blatt, die das Blatt an seiner geschriebenen Koordinate und das Recipe oder FeatureRecipe nennt, dessen Mapping die Verknüpfung steuert, zugeordnet dem Knoten und dem Ziel, die es gerendert haben. Die Zeile für ein angebundenes Feature beginnt mit dem Namen, unter dem es angebunden ist, weil eine Komponente mehrere Anbindungen eines Feature tragen kann und ihre Zeilen sonst identisch wären — die zweite Zeile unten ist ein Feature, das an die Komponente api als token angebunden ist:
warning: node "api" (provider "terraform"): "values.token" is declared sensitive, but recipe "terraform/api" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a recipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with them warning: node "api" (provider "terraform"): attachment "token": "values.token" is declared sensitive, but FeatureRecipe "terraform/api-token" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a FeatureRecipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with themWorin der Hebel besteht. Ohne Mapping sind die Werte, die ein Source-Rendering erhält, nach den deklarierten Blattpfaden selbst geschlüsselt, sodass die Deklaration genau mit ihrem gerenderten Schlüssel verknüpft wird und die Markierung mit ihm übermittelt wird — beim Terraform-Ziel ist das die generierte Override-Datei, die unter Als sensibel deklarierte Moduleingaben beschrieben ist. Mit einem Mapping deckt die Markierung, die ankommt, die Ausgabe des Mappings als Ganzes ab, und nur dort, wo das Mapping den deklarierten Wert liest: Sie steuert den Text, den ein Plugin verfasst, wenn es ablehnt oder warnt, und ändert kein gerendertes Byte.
Drei Formen bleiben still, und zwar bewusst. Ein reines Artefakt-Rendering und ein reines Arbeitslast-Rendering übergeben ihrem Ziel überhaupt keine Werte-Map, daher hat ein Blatt in values dort keinen gerenderten Schlüssel, der markiert werden könnte, wie auch immer es geschrieben ist. Auch ein an eine Boundary angebundenes Feature löst keine Warnung aus, was auch immer sein FeatureRecipe abbildet: Eine Boundary trägt keinen Block values:, daher wird eine solche Anbindung gegen eine leere Säule values gerendert, keines der Blätter, die ihr Feature in values deklariert, kann dort ein Datum tragen, und das Entfernen des Mappings würde nichts markieren. Jede davon ist eine dauerhafte Eigenschaft der Form statt etwas, das ein Autor ändern kann, daher würde eine Warnung darüber bei jedem Build ausgelöst und nichts zu tun nennen; die Obergrenze wird stattdessen unter Ein Blatt als sensibel deklarieren erklärt. Ein Rendering aus einer source: ohne valuesMapping: ist ebenfalls still, weil dort die Markierung ankommt.
Der Klassencode. Der Hinweis trägt den stabilen, maschinell abgleichbaren Klassencode sensitivity-not-conveyed, sodass Werkzeuge die Klasse abgleichen, statt den Meldungstext zu parsen: Das Werkzeug build des Assistenten führt jeden Befund damit unter advisories auf. Er benennt eine Klasse von Befunden statt einer registrierten Bedingung und hat daher keine Zeile in der Tabelle oben auf dieser Seite.
Sichtbarkeit im Editor. Der Hinweis erreicht die Editor-Diagnosen, mit dem Schweregrad Warnung und mit derselben Zeile, die ein Build im Terminal ausgibt, immer dann, wenn der Language Server das Release rendert — ein Build oder eine Build-Vorschau, um die er gebeten wird, oder eine IR-Graph-Inspektion mit aggrega serve --build-on-inspect oder dem Konfigurationsschlüssel serve.build_on_inspect, den das Flag überschreibt und der standardmäßig deaktiviert ist. Der Eintrag nennt einen Knoten und ein Ziel statt eines Authoring-Schlüssels und wird daher am Schlüssel kind: des Aggregate angezeigt.
Es ist eine eigene Klasse, und --no-unsupported-field-warnings deckt sie nicht ab. Dieses Flag schaltet die Treuehinweise eines Ziels stumm, ein anderes Urteil, das aus anderen Gründen getroffen wird; dieser Hinweis erscheint daneben weiterhin. Es gibt kein Flag, das diesen stummschaltet.
Der Build gelingt, und die gerenderten Bytes bleiben unverändert. Der Hinweis meldet ein Fehlen — kein gerenderter Schlüssel trägt die Markierung —, und ein Mapping ist eine gewöhnliche, unterstützte Form, daher gibt es nichts, weswegen abzubrechen wäre, und nichts in Ihrer Ausgabe bewegt sich, ob die Zeile erscheint oder nicht.
A Terraform module call the engine fetches when it initialises (Ein Terraform-Modulaufruf, den die Engine beim Initialisieren abruft)
Wird ausgelöst, wenn ein Terraform-Modul, das der Build vendort, oder der geschriebene Terraform-Körper eines Recipe einen Block module deklariert, dessen source Terraform beim Initialisieren der Konfiguration herunterlädt, statt sie aus den Dateien zu lesen, die der Build abgelegt hat: eine Registry-Adresse, eine Git-, Mercurial- oder HTTP-Archiv-URL, ein S3- oder GCS-Bucket oder ein absoluter Pfad — oder ein lokaler Pfad, der aus dem gevendorten Modul herausführt und damit Dateien nennt, die der Build nicht gevendort hat. Der Lock fixiert den Commit und den Archiv-Digest des gevendorten Moduls, und Terraforms eigene Abhängigkeits-Lockdatei hält nur Provider fest, daher wird das Modul, das ein solcher Aufruf nennt, in der Version abgerufen, die die Engine dann wählt, und nichts, was dieser Build festhält, deckt es ab.
Was gelesen wird. Die Konfigurationsdateien, die die Engine lädt, wenn das Modul aufgerufen wird — die direkt im eigenen Verzeichnis des Moduls und in jedem Verzeichnis, das eine lokale source von dort erreicht — und nichts in einem Verzeichnis, das nichts aufruft, daher wird ein Aufruf, der im Verzeichnis examples/ oder tests/ eines Moduls geschrieben ist, nicht gemeldet. Gelesen wird, was eine source angibt, und nie das Modul, das diese Quelle nennt. Eine Datei unter spec.boundary.artifacts eines Recipe wird vom Compiler selbst ausgewertet und geschrieben und keinem Provider übergeben, daher wird ein darin geschriebener Block module nicht gelesen und löst keine Warnung aus. Strukturelle Eingabevalidierung auf der Provider-Seite gibt die Regel vollständig an.
Ausgabeform. Eine Zeile pro Aufruf, die den Knoten und den Provider nennt, dann den Block, die Datei und die Zeile, an der er steht, und die Quelle, wie sie geschrieben ist; eine Quelle, die aus dem Modul herausführt, sagt das, statt einen Download zu nennen:
warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that module warning: node "app" (provider "terraform"): module "shared" (main.tf, line 2) has the local source "../shared", which resolves outside the module this build placed, so Terraform reads whatever sits at that path when the configuration is initialised rather than files this build vendoredDie Aufrufe kommen in der Reihenfolge an, in der die Engine sie erreicht — zuerst das eigene Verzeichnis des Moduls, dann jedes Verzeichnis in der Reihenfolge, in der eine lokale Quelle es zuerst erreicht, und innerhalb einer Datei in der Reihenfolge, in der ihre Blöcke geschrieben sind —, sodass dieselbe Eingabe bei jedem Lauf dieselbe Abfolge erzeugt. Jeder Lauf, der rendert, löst sie aus: aggrega build; aggrega pull, das das Release einmal rendert, um zu ermitteln, was ein Build davon abruft; und aggrega validate über ein Recipe, dessen Modul der Workspace enthält, das dieses Recipe für sich allein rendert.
Der Klassencode. Jede Warnung trägt den stabilen, maschinell abgleichbaren Klassencode module-fetched-at-init, sodass Werkzeuge die Klasse abgleichen, statt den Meldungstext zu parsen. Der Code wird in der strukturierten Diagnose übermittelt: Das Werkzeug build des Assistenten führt jeden Befund damit unter advisories auf, und der Language Server veröffentlicht ihn an jedem Eintrag. Er benennt eine Klasse von Befunden statt einer registrierten Bedingung und hat daher keine Zeile in der Tabelle oben auf dieser Seite.
Sichtbarkeit im Editor. Die Warnung erreicht die Editor-Diagnosen auf der Ebene aggrega-build, mit dem Schweregrad Warnung, immer dann, wenn der Language Server das Release rendert — ein Build oder eine Build-Vorschau, um die er gebeten wird, oder eine IR-Graph-Inspektion mit aggrega serve --build-on-inspect oder dem Konfigurationsschlüssel serve.build_on_inspect, den das Flag überschreibt und der standardmäßig deaktiviert ist. Der Eintrag nennt einen Knoten statt eines Authoring-Schlüssels und wird daher am Schlüssel kind: des Aggregate angezeigt.
Es ist eine eigene Klasse, und kein Flag schaltet sie stumm. --no-unsupported-field-warnings schaltet die Klasse der nicht unterstützten Felder stumm und deckt diese nicht ab.
Der Build gelingt, und die gerenderten Bytes bleiben unverändert. Die Warnung wird Out-of-Band, getrennt von den gerenderten Artefakten, übermittelt, sodass das gevendorte Modul, der geschriebene Körper und die Root-Konfiguration byte-identisch sind, ob sie erscheint oder nicht.
Warum eine Warnung und kein Abbruch. Ein Modul, das ein anderes Modul aufruft, ist eine legitime Eingabe: Terraform ruft das aufgerufene Modul ab, und die Konfiguration funktioniert. Was der Autor aufgibt, ist die Fixierung dieses Moduls durch den Build, und das ist eine zu meldende Tatsache und kein zurückzuweisender Fehler; ob der Abruf akzeptabel ist, entscheidet der Autor.
A plugin ran with no recorded digest to check it against (Ein Plugin lief ohne festgehaltenen Digest, gegen den es geprüft werden konnte)
Wird ausgelöst, wenn der Compiler gerade ein Plugin ausführen will, ein festgehaltener Digest die Bytes dieses Plugins absichern soll und der Workspace keinen dafür festhält. Das Plugin läuft; die Warnung ist der Weg, auf dem Sie erfahren, dass nichts die ausgeführten Bytes mit den Bytes verglichen hat, die jemand geprüft hat.
aggrega pull schreibt den Digest jedes Plugins, das es beschafft, in das Lockfile des Release, und jede spätere Auflösung vergleicht die Bytes, die sie findet, mit diesem Digest. Ein Workspace, für den noch kein Pull ausgeführt wurde, oder einer, dessen Lockfile älter ist als ein Plugin, das die Konfiguration inzwischen angebunden hat, hat keinen Digest für dieses Plugin — der Vergleich hat also nichts, womit er vergleichen könnte, und ohne diese Zeile würde er stillschweigend bestehen.
Ein Pipeline-Schritt, ein Provider oder ein in einer Verdikt-Rolle angebundenes Plugin, dessen Entität Plugin in einem Ihrer Katalogverzeichnisse geschrieben ist, hat ebenfalls keinen Digest, und ein Pull gibt ihm keinen: Der Pull pinnt eine solche Entität nie, und ein Build liest ihr .wasm jedes Mal neu — im gewöhnlichen Fall von neben der Entität — statt es gegen irgendetwas zu prüfen, das ein Pull festgehalten hat. Ein Plugin, das in einer Transformationsrolle angebunden und dort geschrieben ist, ist die Ausnahme: Seine Bytes formen die gerenderte Ausgabe, daher hält ein Pull den Digest des .wasm fest, das er dafür findet, und sobald er das getan hat, prüft ein Build dieses Plugin gegen den Digest, und diese Zeile wird dafür nicht ausgelöst.
warning: plugin "governance/label-injector:1.0.0" resolved from cache with no recorded digest to check it against, so it runs unverified; run `aggrega pull --release <release>` to record it warning: plugin "pipeline-step/patch" resolved from local with no recorded digest to check it against, so it runs unverified; it is read from beside its Plugin entity in a catalog directory on every build, and a pull records its digest only for a plugin attached at a transform role; otherwise publish the plugin and reference the published entity to have its digest recordedDas ist die Zeile, die ein Build, ein Pull oder eine Validierung unter den übrigen Warnungen anzeigt. Ein Befehl, der ein Plugin außerhalb eines solchen Laufs auflöst — beim Installieren, Auflisten oder Ausführen der eigenen Kommandozeilen-Plugins des Workspace oder aggrega lint beim Auflösen der Plugins, mit denen es lintet —, gibt denselben Satz auf einer eigenen Zeile aus, ohne Einrückung.
Die Zeile nennt die Quelle, aus der die Bytes stammen — dasselbe Wort, das aggrega pull und aggrega plugin list dafür verwenden —, und endet mit dem, was für diese Quelle gilt. Für Bytes aus dem Content-Cache besteht die Korrektur darin, das Release zu pullen, was den Digest festhält und jeden späteren Lauf dieses Plugins zu einem geprüften macht. Für Bytes, die neben einer Entität Plugin in einem Katalogverzeichnis gelesen werden, hält ein Pull den Digest nur für ein Plugin fest, das in einer Transformationsrolle angebunden ist, und die Zeile sagt das: Für jedes andere dort geschriebene Plugin ändert kein Pull etwas daran, und der Weg, es unter einen festgehaltenen Digest zu bringen, besteht darin, es zu veröffentlichen und auf die veröffentlichte Entität zu verweisen.
Sie wird pro Befehl einmal je Plugin angezeigt, wie oft der Befehl dieses Plugin auch auflöst. Ein Rendering löst seinen Provider einmal pro Knoten auf, und ein Build, der sein eigenes Lockfile füllt, kann das Release mehr als einmal rendern; die Zeile jedes Mal zu wiederholen, würde sie verschütten. Der Editor-Dienst zeigt sie auf seinem eigenen Fehlerstrom einmal an, solange er läuft, während jede Anfrage, die er beantwortet, sie dem Editor neu meldet — sodass jede Antwort, aus der der Editor schöpft, Sie über die Plugins informiert, die dieser Lauf ungeprüft verwendet hat.
Sichtbarkeit im Editor. Die Warnung erreicht die Editor-Diagnosen zusammen mit den übrigen Hinweisen des Laufs, mit dem Schweregrad Warnung: Eine Validierung eines Release veröffentlicht sie am Aggregate des Release, und ein Build oder eine Build-Vorschau, die der Editor anfordert, veröffentlicht sie auf der Ebene aggrega-build. Sie nennt ein Plugin statt eines Schlüssels, den Sie geschrieben haben, und wird daher am Anfang der Datei platziert. Da jeder Lauf meldet, was er aufgelöst hat, bleibt der Eintrag bestehen, solange ein Lauf das Plugin ungeprüft auflöst, und verschwindet mit dem ersten Lauf, der das nicht tut. Sie ändert kein Verdikt und lässt keine Auflösung fehlschlagen, sodass das, was eine Sitzung beantwortet, dasselbe ist, ob sie angezeigt wird oder nicht.
Zwei Auflösungen lösen nichts aus, und keine davon ist ein Versehen:
- Ein Plugin, das der Compiler in sich selbst mitführt.
aggrega pullhält fest, was es abgerufen hat, und für Bytes, die im Binary ausgeliefert werden, gibt es nichts abzurufen — daher wird für ein solches Plugin nie ein Digest festgehalten, und es gäbe nichts, was Sie ausführen könnten, um das zu ändern. Das Binary ist die Identität dieser Bytes. Die eigenen Plugins des Compilers und ihre Versionen werden vonaggrega plugin listaufgelistet und in den Abschnitttoolchaindes Lockfiles eingetragen. - Eine Auflösung, für die nie ein Digest gelten sollte.
aggrega validate --plugin ./some.wasmzeigt auf eine Datei, die Sie auf der Kommandozeile genannt haben, undaggrega lintuntersucht genau das Artefakt, das es prüft; in beiden Fällen ist das Plugin der Gegenstand statt eines Werkzeugs, dem vertraut wird, sodass es keinen Eintrag gibt, an dem es gemessen werden könnte.
Warum eine Warnung und kein Abbruch. Ein Dokument zu lesen lohnt sich auch in einem Workspace, den noch niemand vorbereitet hat — sich zu weigern, zu validieren oder zu linten, bis jemand aggrega pull ausführt, würde die meldenden Befehle genau in dem Moment unbrauchbar machen, in dem sie am nützlichsten sind. aggrega build erzeugt ohne Lockfile überhaupt keine Artefakte, daher begegnet der Build dieser Warnung nur bei einem Plugin, für das sein Lockfile keinen Digest festhält — im gewöhnlichen Fall eines, das neben seiner Entität in einem Katalogverzeichnis gelesen wird.
Wo ein fehlendes Lockfile stattdessen zur Ablehnung führt. Wenn ein Editor den Compiler-Dienst nach dem Graphen eines Release fragt und der Workspace überhaupt kein Lockfile hat, hält der Dienst an und verlangt eines, statt einen Graphen zu zeichnen. Ein Lockfile, das existiert und lediglich keinen Digest für ein Plugin festhält, ist stattdessen der obige Fall: Das Plugin läuft, und diese Warnung ist der Weg, auf dem Sie es erfahren. Ein gezeichneter Graph ist das, worüber ein Leser anschließend nachdenkt, und einer, der aus ungeprüften Bytes erstellt wurde, sähe genauso aus wie ein geprüfter. Siehe aggrega serve.
A published archive carries an entry Windows cannot use (Ein veröffentlichtes Archiv enthält einen Eintrag, den Windows nicht verwenden kann)
Wird ausgelöst, wenn aggrega push — oder sein --dry-run — ein Archiv veröffentlicht, von dessen Einträgen einer einen Teil enthält, den Windows so, wie er geschrieben ist, nicht aufnehmen kann: einen Namen, den Windows für ein Gerät reserviert, etwa CON, PRN, AUX, NUL, COM1 oder LPT1, in beliebiger Groß- und Kleinschreibung und mit welcher Erweiterung auch immer, oder einen Teil, der auf einen Punkt oder ein Leerzeichen endet. aux/x.yaml enthält einen solchen in seinem Verzeichnis; report. und COM1.yaml enthalten einen in ihrem Dateinamen. Unter Windows weigert sich aggrega, einen solchen Eintrag zu entpacken, sodass ein Windows-Workspace die Version überhaupt nicht verwenden kann. Die Warnung wird auf jeder Plattform ausgelöst, weil eine Veröffentlichung für jeden ist, der sie pullt, und sie ist der Weg, auf dem ihr Autor davon erfährt, bevor es jemand unter Windows tut.
Was sie liest. Die Namen, die das Archiv enthalten wird: den eigenen Dateinamen des Entitätsdokuments, dann jede Datei, die die Entität daneben nennt — die Dateien, die Bündelung aufführt. Ein Dokument namens con.yaml, das eine Schemadatei importiert, löst die Warnung also für seinen eigenen Namen aus. Eine Entität, die nichts nennt, wird allein als ihr Dokument veröffentlicht, das ein Konsument unter einem Namen ablegt, den das Produkt wählt, statt unter dem, den Sie geschrieben haben, daher wird für sie nie gewarnt, wie auch immer ihre Datei heißt. Ein Plugin veröffentlicht kein Archiv, und auch dafür wird nie gewarnt.
Ausgabeform. Eine Zeile pro Eintrag, auf der Standardfehlerausgabe, in der Reihenfolge, in der die Namen zusammengesetzt werden — zuerst das Dokument, dann die Dateien, die es mitführt, in lexikalischer Reihenfolge —, vor dem eigenen Bericht des Probelaufs oder der Veröffentlichung auf der Standardausgabe:
warning: an entry this publication carries cannot be used on Windows (the entry "aux/x.yaml", its segment "aux"). Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written, so a workspace on Windows refuses to unpack the entry. This warning does not stop the publication; rename that segment to publish a version Windows can useDer erste in Anführungszeichen gesetzte Wert ist der Eintrag, wie das Archiv ihn benennt. Der zweite ist das erste seiner Segmente — der Teile, die seine Schrägstriche trennen —, das Windows nicht aufnehmen kann, und damit der Teil, der umzubenennen ist. Die Zeile beginnt mit dem festen Satz der Bedingung. Sie wird von der Veröffentlichung ausgelöst statt von einer Regel, die ein Build auswertet, und hat daher keine Zeile in der Tabelle oben auf dieser Seite; die Tabelle aller Bedingungen führt sie unter E0344.
Sie weist nichts zurück. Der Push oder sein Probelauf wird genau so fortgesetzt oder abgelehnt, wie es ohne die Warnung geschähe, und endet so, wie er es getan hätte.
Wohin sie sonst gelangt. Das Werkzeug publish-entity des Assistenten antwortet mit denselben Einträgen als windows_unusable_entries, und aggrega serve beantwortet aggrega/publishEntity mit ihnen als windowsUnusableEntries; beide fehlen, wo es keinen gibt. Siehe aggrega mcp und aggrega serve. Der Dienst gibt die Warnzeile selbst außerdem an eine Anfrage weiter, die darum gebeten hat, Meldungen zu erhalten, zusammen mit dem übrigen Bericht der Veröffentlichung.
Sichtbarkeit im Editor. Keine als Diagnose: Veröffentlichen ist kein Build, daher gelangt hier nichts in eine Problemliste. Ein Editor, der über den Dienst veröffentlicht, liest windowsUnusableEntries in der Antwort.
Warum eine Warnung und kein Abbruch. Ein solcher Name ist zulässig, und Linux und macOS verwenden die Datei so, wie sie benannt ist, sodass eine Ablehnung der Veröffentlichung eine funktionierende Entität aufgrund einer Vermutung darüber ablehnen würde, wer sie pullen wird. Ob umbenannt wird, entscheidet der Autor.