Ein fataler Abbruch ist ein Fehler zur Kompilierzeit, der den Build anhält, bevor eine Ausgabe erzeugt wird. Jeder Abbruch nennt die Datei, die Entität und das fehlerhafte Feld, erklärt, was der Compiler nicht auflösen konnte, und verweist auf die konkrete Authoring-Änderung, die ihn behebt. Der Compiler repariert oder überschreibt Ihre Eingabe niemals stillschweigend — wenn etwas nicht stimmt, hält der Build an und sagt Ihnen, wo.
Dieser Katalog ist nach der Kompilierungsphase geordnet, in der der jeweilige Abbruch ausgelöst wird.
Jeder Eintrag unten zitiert die Meldung, die ein Build für die dokumentierte Bedingung ausgibt: den festen Satz, der die Bedingung benennt, und danach das, was das jeweilige Auftreten beigesteuert hat. In einem Terminal erscheint diese Meldung in einem Rahmen — einer Kopfzeile in eckigen Klammern mit der Kategorie und dem Kurzcode der Bedingung, einem Verweis auf die fehlerhafte Datei und den fehlerhaften Schlüssel, gefolgt von der Instanz, die der Fehler betrifft, als (instance <name>) — oder nur dieser Instanz, als instance <name>, wo keine Datei zutrifft — und der Meldung in der Zeile darunter —, sodass eine ganze aus einem Build kopierte Zeile keinem Eintrag hier entspricht, die Meldung darin aber schon; error-translation.md beschreibt den Rahmen vollständig.
Wenn Sie mit einem Kurzcode aus einem Build kommen — dem Buchstaben E und vier Ziffern in der Kopfzeile der Diagnose in eckigen Klammern —, beginnen Sie bei Einen Abbruch anhand des vom Build ausgegebenen Kurzcodes finden am Ende dieser Seite, wo jede hier katalogisierte Bedingung neben dem Kurzcode steht, den ein Build für sie ausgibt.
Beim Laden Ihrer Dateien
Der Compiler liest jedes Aggregate, Manifest, jede Component, jedes Feature, Recipe, FeatureRecipe, Plugin und Release, auf die Ihr Build verweist, validiert jedes davon gegen sein Schema und interpoliert typisierte Parameter aus dem Release in das Aggregate.
YAML anchor aliased inside its own content (YAML-Anker, der innerhalb seines eigenen Inhalts per Alias referenziert wird)
Ein Dokument setzt mit &name einen Anker auf einen Knoten und referenziert ihn dann mit *name als Alias irgendwo innerhalb des Inhalts, den dieser Anker umfasst. Das Expandieren des Alias reproduziert den Anker, dessen Inhalt wiederum den Alias enthält, sodass das Dokument eine Struktur ohne Ende beschreibt. Es gibt nichts Endliches zu lesen, geschweige denn zu validieren, und der Build hält an, statt einen Durchlauf zu beginnen, der nicht enden kann.
Das Einlesen von YAML in einen Baum expandiert keine Aliase, daher wird ein Dokument dieser Form ohne Beanstandung gelesen und schlägt erst fehl, wenn etwas es durchläuft. Die Zurückweisung liegt daher zwischen dem Lesen und dem Durchlauf — und ein Build liest verfasstes YAML an mehr als einer Stelle, sodass dieselbe Bedingung an mehr als einer Stelle auftreten kann. Vier Stellen melden sie, und jede rahmt dieselbe Erklärung mit dem ein, was das Dokument auf dieser Oberfläche verortet:
Eine Entitätsdatei, während sie gelesen wird. Der Build hält an, bevor diese Entität gegen ihr Schema geprüft wird, daher nennt dieser Abbruch einen Anker statt eines Feldes und trägt keine Zeile und Spalte: Zu diesem Zeitpunkt hat das Dokument keine Position, auf die eine Diagnose sinnvoll zeigen könnte.
Ein Schema-Rumpf, während er kompiliert wird. Eine Säule spec.schema: wird aus der Kompaktform in ein JSON Schema-Dokument kompiliert, nachdem ihre Datei gelesen wurde, daher wird dieser Abbruch während dieser Kompilierung ausgelöst statt davor, und er trägt durchaus eine Zeile. Die Form, die ein früheres Lesen nicht erkennen kann, ist ein Escape-Rumpf $jsonschema:: Ein Escape-Rumpf ist ein Block-Skalar — einfacher Text ohne Anker —, während die umgebende Datei gelesen wird, und seine Anker werden erst zu Ankern, wenn dieser Text selbst geparst wird, eine Ebene tiefer. Wo der Zyklus in einem solchen Block lag, nennt der Abbruch zusätzlich $jsonschema als das Schlüsselwort, dessen Rumpf ihn enthielt.
Das Arbeitslast-Schema in einem Provider-Plugin, während das Plugin geladen wird.spec.provider.workloadSchema wird als Block-Skalar geschrieben: einfacher Text, solange die Plugin-Datei selbst gelesen wird, zu diesem Zeitpunkt ohne Anker, und seine Anker werden erst zu Ankern, wenn dieser Text als eigenständiges Dokument geparst wird, eine Ebene tiefer. Dieses Parsen und die anschließende Kompilierung finden beide statt, während das Plugin geladen wird, daher wird dieser Abbruch dort ausgelöst statt beim Lesen der Datei, und er trägt eine Zeile. Wo der Zyklus in einem Escape $jsonschema: innerhalb des Schema-Rumpfs lag, nennt der Abbruch zusätzlich $jsonschema als das Schlüsselwort, dessen Rumpf ihn enthielt. Siehe ../entities/plugin.md für die Authoring-Oberfläche des Feldes.
Ein gerendertes CloudFormation-Fragment, während der Provider es liest. Ein cloudformation-Recipe verfasst ein Fragment, und ein Rumpf artifacts: ist eine Vorlage — was der Provider liest, ist also der Text, zu dem diese Vorlage gerendert wurde, Inhalt, der noch nicht existierte, während Ihre Dateien gelesen wurden. Dieser Abbruch wird daher beim Rendern der Ausgabe ausgelöst, nachdem jede Schemaprüfung bereits bestanden ist. Siehe ../providers/cloudformation.md für die Authoring-Oberfläche der Fragmente.
Die Zurückweisung gilt der Rekursion, niemals der Wiederverwendung oder der Tiefe. Gemeinsame Inhalte mit einem Anker zu versehen und von vielen Stellen aus zu referenzieren ist ein unterstütztes Authoring-Muster — siehe ../entities/aggregate.md „YAML-Anker-Muster (Block defs:)“ und ../entities/manifest.md „YAML-Anker für DRY-Manifeste“ — und ein Verweis, der expandiert und endet, wird normal geladen, egal wie oft er vorkommt und wie tief das Dokument verschachtelt ist; Tiefe allein ist nie ein Grund für diesen Abbruch. Was zum Abbruch führt, ist ein Anker, der erreicht wird, während der Build sich noch in ihm befindet, auch wenn er indirekt erreicht wird, über einen zweiten, darunter deklarierten Anker. Die Meldung nennt den Anker, auf den sich die Schleife zurückschließt, und das ist nicht unbedingt der äußerste Anker im Dokument.
Ausgegebene Meldungen. Alle vier tragen dieselbe Erklärung, und das ist beabsichtigt: Es ist eine Bedingung, die an vier Stellen auftritt, und wer sie einmal zu lesen gelernt hat, sollte sie nicht erneut lernen müssen. Nur der Rahmen, der das Dokument verortet, unterscheidet sich.
anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full (Anker wird innerhalb seines eigenen Inhalts per Alias referenziert, sodass sich das Dokument endlos expandiert; richten Sie diesen Alias auf Inhalt, der außerhalb des Ankers deklariert ist, oder schreiben Sie den Inhalt vollständig aus)
Eine Entitätsdatei wird von der Hüllenprüfung, die sie las, und dem Pfad, aus dem sie gelesen wurde, eingerahmt:
Ein Schema-Rumpf wird von seiner Position innerhalb des Schemas eingerahmt und, wenn der Zyklus in einem Block $jsonschema: lag, vom Escape-Schlüsselwort. Der Build meldet ihn unter einem Tag CATALOG_ERROR, der außerdem die Datei, die Entität und die Säule nennt, deren Rumpf nicht kompiliert werden konnte:
compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above> (compactform an der Stelle, Schlüsselwort)
Das Arbeitslast-Schema in einem Provider-Plugin trägt denselben Kompaktform-Rahmen; anders ist der Tag CATALOG_ERROR darum, der statt der Entität und ihrer Säule das Plugin und spec.provider.workloadSchema nennt.
Ein gerendertes Fragment wird von dem Provider eingerahmt, der es gelesen hat:
cloudformation-provider: parse fragment: <the explanation above> (cloudformation-provider: Fragment parsen)
Behebung: Richten Sie den Alias auf Inhalt, der außerhalb des Ankers deklariert ist, in dem er sich derzeit befindet, oder schreiben Sie den wiederholten Inhalt an der Verwendungsstelle vollständig aus. In einem Aggregate oder einem Manifest ist der Block defs: auf oberster Ebene der natürliche Ort für gemeinsame Anker — er liegt außerhalb jedes Blocks, der auf ihn verweist, sodass ein dort deklarierter Anker nicht aus sich selbst heraus erreicht werden kann. Bei den anderen Entitätsarten, die keinen Block defs: haben, setzen Sie den Anker für den gemeinsamen Inhalt an eine Stelle, deren Nachfahre der verweisende Block nicht ist. Ein Anker darf von beliebig vielen Stellen und aus beliebiger Tiefe referenziert werden; die einzige Form, die er nicht annehmen kann, ist ein Verweis, der wieder innerhalb des Inhalts landet, den der Anker umfasst.
Dasselbe Mittel gilt überall, wo der Abbruch aufgetreten ist, und der Rahmen sagt Ihnen, welches Dokument Sie öffnen müssen: die Entitätsdatei selbst, den Block $jsonschema: in einer Schema-Säule, den Rumpf workloadSchema in einem Provider-Plugin oder den Rumpf artifacts:, dessen gerenderte Ausgabe der Provider gelesen hat. Im letzten Fall liegt der Anker in der Vorlage, die Sie verfasst haben, nicht im gerenderten Text — das Rendern hat ihn getreu wiedergegeben.
Parameter type mismatch / contract violation (Parametertyp stimmt nicht überein / Vertragsverletzung)
Das Release hat einen Wert geliefert, dessen Typ oder Form nicht dem entspricht, was das Aggregate für diesen Parameter deklariert hat. Der Validator für Parameterverträge erkennt Typabweichungen, Enum-Verletzungen, Bereichsverletzungen, Pattern-Verletzungen, Zeichenketten, die keine gültigen Instanzen ihres deklarierten format sind, nicht erfüllte validate:-Prädikate und fehlende Pflichtparameter, bevor eine Template-Interpolation ausgeführt wird. Die Namen, die ein format annehmen kann, und was jeder davon prüft, sind unter Benannte Formate aufgeführt.
Ausgegebene Meldung — der Satz, der die Bedingung nennt, dann die fehlerhafte Entität, der Feldpfad und das Detail der Einschränkung:
parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (Parametervertrag verletzt: Der Parameter erwartete den deklarierten Typ und erhielt einen anderen)
Für einen Parameter, der mit required: true ohne default: und ohne vom Release gelieferten Wert deklariert ist, enthält der Bericht eine andere Bedingung und einen anderen Kurzcode:
required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (erforderlicher Parameter nicht geliefert: Der Parameter ist erforderlich, wird aber vom Release nicht geliefert)
Nur das Detail nach dem Feldpfad ändert sich mit der nicht erfüllten Einschränkung. Der Satz und der eingeklammerte Rahmen darum sind jedes Mal gleich, sodass der Satz der Teil ist, gegen den abgeglichen wird, und das Detail der Teil, den man liest. Die Details, die ein Build ausgibt, eines pro Art von Einschränkung:
parameter "<parameter>" value <value> not in enum [<members>] (Parameterwert nicht im Enum enthalten) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (Parameterwert entspricht nicht dem Pattern) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (Parameterwert ist für das Format nicht gültig) parameter "<parameter>" value <value> above max <max> (Parameterwert über dem Maximum) parameter "<parameter>" failed validate predicate (validate-Prädikat des Parameters nicht erfüllt) parameter "<parameter>" validate predicate error: <detail> (Fehler im validate-Prädikat des Parameters)
Der <reason> eines Formatfehlers sagt in den eigenen Begriffen dieses Formats, was mit dem Wert nicht stimmt. Ein Wert innerhalb eines verschachtelten Vertrags wird über seinen Pfad benannt, sodass ein format, das ein items:-Vertrag deklariert, an jedem Element geprüft wird und der Bericht dasjenige nennt, das fehlgeschlagen ist: Das zweite Element eines hosts-Parameters wird unter .spec.parameters.hosts.1 gemeldet, und sein Detail nennt "hosts.1".
Ein Parameter, der eine validateMessage: deklariert, ersetzt dieses gesamte Detail durch seinen eigenen Text, sodass der Bericht parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) lautet — der Rahmen bleibt unverändert, und Ihr Satz steht dort, wo das Detail der Einschränkung stünde.
Dieselbe Bedingung erfasst einen Vertrag, der so, wie er geschrieben ist, nichts einschränken kann. Ein pattern:, das kein gültiger regulärer Ausdruck ist, wird abgelehnt, wenn der Parametervertrag des Aggregate gelesen wird, bevor irgendein Release-Wert geprüft wird, sodass es den Build anhält, unabhängig davon, ob ein Release den Parameter liefert. Der Bericht verweist auf den Schlüssel — .spec.parameters.<parameter>.pattern oder den Pfad durch einen verschachtelten Vertrag wie .spec.parameters.<parameter>.items.pattern — und sein Detail nennt die Deklaration, das Pattern und den Grund:
parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (Pattern des Parameters lässt sich nicht kompilieren)
Ein format:, das ein Format außerhalb der unterstützten Menge nennt, kann ebenfalls nichts einschränken, und es wird an derselben Stelle abgelehnt, bevor irgendein Release-Wert geprüft wird, sodass auch es den Build anhält, unabhängig davon, ob ein Release den Parameter liefert. Innerhalb eines verschachtelten Vertrags — unter items:, properties: oder valuesType: — ist es diese Bedingung, die es ablehnt: Der Bericht verweist auf den Schlüssel, etwa .spec.parameters.<parameter>.items.format, und sein Detail nennt die Deklaration, das Format, wie es geschrieben ist, und jeden unterstützten Namen:
parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (Format des Parameters wird nicht unterstützt; die unterstützten Formate sind email, uri, hostname, ipv4, ipv6, uuid, date-time, date)
An der eigenen Deklaration eines Parameters wird derselbe Name einen Schritt früher abgelehnt, durch das Schema des Aggregate, dessen format nur die unterstützten Namen zulässt. Diese Ablehnung ist das Dokument, das am Schema seiner Art scheitert — eine andere Bedingung mit eigenem Kurzcode, E0215 —, und aggrega pull und aggrega validate --release führen sie auf, nachdem sie die aggregate:-Referenz des Release als nicht auflösbar gemeldet haben (E0170), da das Aggregate, das den Namen enthält, nicht geladen wurde:
document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema (Validierung der Dokumenthülle fehlgeschlagen: Das Format ist keiner der zulässigen Werte; korrigieren Sie das Dokument, damit es dem Schema seiner Art entspricht)
Das Detail zum Prädikatfehler deckt beide Wege ab, auf denen ein validate:-Prädikat kein Urteil liefern kann: eine Funktion, die die Oberfläche nicht registriert, und eine Referenz auf etwas anderes als .value. Jeder wird gegen das Prädikat statt gegen den Wert gemeldet, und jeder nennt, was er nicht auflösen konnte.
Ein validate:-Prädikat liest den zu validierenden Wert als .value, und das ist der einzige Name, den es definiert. Ein Prädikat, das etwas anderes nennt, wird vor seiner Ausführung abgelehnt, sodass eine vertippte Referenz als der Benennungsfehler gemeldet wird, der sie ist, statt zu nichts aufgelöst zu werden und als Wert aufzutauchen, der die Validierung nicht bestanden hat.
So beheben Sie es: Ändern Sie den Release-Wert so, dass er den deklarierten Einschränkungen type / enum / min / max / pattern / format des Parameters entspricht, liefern Sie einen fehlenden Pflichtparameter, korrigieren Sie ein pattern:, das sich nicht kompilieren lässt, ersetzen Sie ein format:, das ein nicht unterstütztes Format nennt, durch eines der benannten Formate oder entfernen Sie es, korrigieren Sie ein validate:-Prädikat, das etwas anderes als .value nennt oder etwas anderes als true oder false ergibt, oder erweitern Sie die Deklaration des Aggregate, damit sie die Form akzeptiert, die Sie tatsächlich benötigen.
Regeln für die Recipe-Form
Ein Recipe setzt seine Ausgabe aus drei Eingabearten zusammen — bezogen, synthetisiert und Artefakte —, die in ../../architecture/16-recipe-input-composition.md beschrieben sind. Die Form eines gültigen Recipe wird durch die folgenden Kompositionsregeln eingeschränkt. Sie unterscheiden sich darin, wann sie geprüft werden — wenn das Recipe geladen wird, wenn ein Knoten gerendert wird oder wenn Ausgabe erzeugt wird —, lesen Sie daher bei jedem Eintrag, an welcher Stelle seine eigene Bedingung geprüft wird.
Jede Regel ist nach dem benannt, was sie einschränkt. Es gibt keine Nummerierung, und keine Nummer ist reserviert: Ein Name sagt, welchen Teil des Recipe Sie öffnen müssen, und er sagt es weiterhin, wie auch immer die folgende Liste wächst oder umgeordnet wird. Wenn Sie eine Bedingung dauerhaft festhalten müssen — in einem CI-Gate, einem Issue, einem Runbook —, verwenden Sie ihren Code, den Bezeichner, den sentinels.md für die Bedingung aufführt und der unverändert bleibt, während sich die Pakete um ihn herum weiterentwickeln.
Ein Abbruch wegen der Recipe-Form ist auf dieselbe Weise aufgebaut. Er beginnt mit dem Satz, der die Regel nennt, nennt dann, was dieses konkrete Recipe geliefert hat, und danach das Detail, das für dieses Recipe spezifisch ist:
<the rule's sentence> (Recipe <name>:<version>, rule <rule-name>, at <position>). <rule-specific detail> (der Satz der Regel, dann das Recipe mit Name und Version, der Name der Regel und die Position; danach das regelspezifische Detail)
Der einleitende Satz ist je Regel fest — derselbe Text bei jedem Abbruch durch diese Regel, gleich welche Phase ihn erkannt hat —, daher ist er der Teil der Ausgabe, gegen den abgeglichen wird, und er ist der Text, den sentinels.md für die Bedingung der Regel aufführt. Alles danach variiert mit dem fehlerhaften Recipe: Die eingeklammerten Werte sagen, welches Dokument, welche Regel nach Namen und wo, und der abschließende Satz ist der Rat für dieses Vorkommen. Die Position ist die Datei, aus der das Recipe geladen wurde, wenn die Regel das Dokument als Ganzes betrifft, und ein gepunkteter Pfad zu dem Schlüssel, den Sie geschrieben haben — .spec.outputComponentLabels.hosting —, wenn die Regel eine einzelne Sache darin betrifft; ein Schlüssel, der selbst Punkte enthält, kann nicht als ein weiteres Segment geschrieben werden, ohne sich ebenso als zwei zu lesen, daher endet der Pfad bei dem Block, der ihn enthält, und der Rat zitiert stattdessen den Schlüssel.
Der Build gibt die ganze Zeile unter einem CATALOG_ERROR-Tag aus, das signalisiert, dass der Fehler der Katalog-Entität zuzuordnen ist (dem Recipe oder dem Provider, an den es gebunden ist), nicht dem Aggregate oder dem Release. Die Datei, aus der das Recipe geladen wurde, wird neben dem Tag ausgegeben, sodass eine an einem Schlüssel positionierte Regel Ihnen trotzdem sagt, welche Datei Sie öffnen müssen.
valuesMapping requires source (Werte-Mapping erfordert eine Quelle)
Ein Recipe deklariert valuesMapping, aber nicht source. Ohne eine Quelle, die überlagert werden kann, gibt es nichts, das die gemappten Werte empfängt. Diese Regel wird geprüft, wenn das Recipe geladen wird.
Ausgegebene Meldung:
Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (Recipe: valuesMapping erfordert source; deklarieren Sie einen source:-Zeiger neben valuesMapping, oder entfernen Sie valuesMapping, wenn kein Overlay beabsichtigt ist)
So beheben Sie es: Fügen Sie einen source:-Zeiger (eine Referenz auf ein Chart, ein Modul oder eine Compose-Datei) neben dem valuesMapping hinzu, oder entfernen Sie das valuesMapping und verwenden Sie eine andere Eingabeart (workload: für synthetisierte Ausgabe, artifacts: für die direkte Ausgabe von Manifesten).
workload: requires a provider that can synthesize (erfordert einen Provider, der synthetisieren kann)
Ein Recipe deklariert workload: (synthetisierter Modus) für einen Provider, der keine Workload-Synthese implementiert. Die Unterstützung des synthetisierten Modus ist eine Eigenschaft des Providers — der Katalog der Standardbibliothek deklariert workloadSchema per Konvention auf synthesefähigen Providern, aber die Prüfung richtet sich nach der Fähigkeit des Providers, nicht nach dem Vorhandensein dieses Felds.
Zwei Oberflächen melden es, und nur eine von ihnen entscheidet über den Build. Der Abbruch wird zur Renderzeit ausgelöst, nachdem der Provider des Knotens gebunden ist und sobald die Eingabearten gelesen wurden, die sein Recipe deklariert, daher nennt dieser Bericht den Knoten. aggrega validate meldet denselben Befund früher, bevor irgendein Knoten gebunden ist, und liest das Recipe für sich allein — daher nennt dieser Bericht stattdessen das Recipe und seine Version. Die beiden lesen nicht dieselbe Menge von Recipes: Der frühe Bericht wird für jedes Recipe ausgelöst, das überhaupt workload: deklariert, während der Abbruch für jede vom Knoten deklarierte Eingabeart ausgelöst wird, die sein Provider nicht bedienen kann. Ein Recipe, das ein workload: mit einem source: kombiniert, hält also trotzdem an, und zwar wegen der Arbeitslast — eine Eingabeart zu deklarieren, die der Provider rendern kann, bringt eine nicht unterstützte nicht am Gate vorbei.
Die eine Grenze dabei: artifacts: wird nur dann gegen die Unterstützung eigenständiger Artefakte geprüft, wenn es die einzige deklarierte Art des Knotens ist. Neben einem source: oder einem workload: laufen seine Dateien als zusammengesetzte Ausgabe mit, die diese Fähigkeit nicht regelt.
Ausgegebene Meldung zur Renderzeit. Die Kategorie, der der Fehler zugeordnet wird, erreicht Sie in der Kopfzeile der Diagnose in eckigen Klammern statt innerhalb der Meldung. Die Meldung beginnt mit dem festen Satz, der die Bedingung nennt, und nennt dann den Knoten, den Provider, die deklarierte Art, die abgelehnt wurde, und die Arten, die dieser Provider unterstützt. Wenn ein Knoten zwei Arten deklariert, die sein Provider nicht bedienen kann, wird die erste in der Reihenfolge source → workload → artifacts gemeldet, sodass sich der Befund auf eine einzige Zeile Ihres Recipe bezieht:
provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode> (Provider unterstützt die Eingabeart des Knotens nicht; deklarieren Sie eine der unterstützten Eingabearten, oder wählen Sie einen Provider als Ziel, der den Modus unterstützt)
Die Kopfzeile enthält die Kategorie und den Kurzcode dieser Bedingung, E0265, den Bezeichner, den Sie festhalten, wenn Sie diesen Abbruch dauerhaft benennen müssen — in einem Gate der kontinuierlichen Integration, einem Issue oder einem Runbook. Eine Nummer wird einmal vergeben und bleibt dann fest, sodass sie gleich bleibt, wie auch immer sich der Wortlaut um sie herum verbessert; die Tabelle aller Bedingungen löst sie auf, und der einleitende Satz oben ist das, wogegen Sie abgleichen, wenn Sie von Text statt von einem Bezeichner ausgehen.
aggrega validate meldet dieselbe Klausel unter dem Recipe, das den Block enthält, mit der Oberfläche, die sie gelesen hat, als Präfix und mit dem Kurzcode dieser Bedingung als Kopfzeile, weil der frühe Bericht dieselbe Bedingung ist:
input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized (Provider unterstützt den synthetisierten Modus nicht; deklarieren Sie eine der unterstützten Eingabearten, oder wählen Sie einen Provider als Ziel, der den synthetisierten Modus unterstützt)
Über den gesamten Katalog ist das eine Zeile; mit --release steht die Kopfzeile in einer eigenen Zeile über der Klausel. Die Diagnose des Editors für denselben Befund trägt E0265 als Code.
So beheben Sie es: Binden Sie das Recipe entweder an einen Provider, der synthetisiert (meist helm oder compose), oder migrieren Sie das Recipe auf eine andere Eingabeart (artifacts: für die direkte Ausgabe von Manifesten oder source: + valuesMapping:, wenn ein Chart/Modul existiert).
Workload-Inhaltsvalidierung pro Provider. Derzeit dient das workloadSchema des Providers nur der Dokumentation und validiert den Rumpf der Workload nicht; Rümpfe werden gegen das plattformeigene eingebettete Workload-Schema validiert. Sobald der Wasm-basierte Workload-Synthesizer erscheint, wird workloadSchema zum Vertrag pro Provider, gegen den der Synthesizer den Rumpf der Workload validiert (ein eigener Abbruch auf Inhaltsebene).
The provider does not support omits (Der Provider unterstützt omits nicht)
Ein Recipe oder ein FeatureRecipe deklariert omits:, und der Provider, der es rendert, deklariert nicht, dass er gerenderte Dokumente auslässt. Ein Dokument aus dem auszulassen, was eine Quelle rendert, kann nur der Provider — nur der Provider weiß, welche Dokumente die Quelle rendert und wie jedes heißt —, sodass ein Provider, der es nicht tut, jedes Dokument rendern würde, das die Einträge nennen, und Erfolg melden würde. Der Build verweigert stattdessen, bevor irgendetwas gerendert wird, sodass der Schlüssel nie stillschweigend wirkungslos bleibt.
Ob ein Provider Dokumente auslässt, wird aus der eigenen Deklaration des Providers gelesen, was er unterstützt, nicht aus einer Liste von Providern, die der Compiler führt. Jeder Eintrag zählt, was auch immer sein when: rendert, denn ob der Provider den Schlüssel berücksichtigen kann, hängt nicht davon ab, welche Einträge ein Build behält. Die Provider helm, compose und cloudformation berücksichtigen den Schlüssel. helm-chart und terraform reichen ihre Quelle weiter, damit sie beim Bereitstellen gerendert wird, sodass zur Build-Zeit kein gerendertes Dokument existiert, das ausgelassen werden könnte, und beide werden zurückgewiesen.
Die Zurückweisung wird entschieden, sobald das Recipe jeder Komponente und das FeatureRecipe jeder Anbindung gebunden sind und jeder Provider sich selbst beschrieben hat — bevor die erste Komponente gerendert und bevor irgendein Eintrag ausgewertet wird, sodass ein hier zurückgewiesener Build nichts rendert. Geprüft wird jedes Dokument, das eine Quelle rendert: das Recipe einer Komponente; das FeatureRecipe, das eine Anbindung an einer Komponente bindet, einmal für jede Komponente, die die Anbindung trägt; und ein FeatureRecipe, das einmal für eine Boundary generiert, einmal, an der Boundary, die es deklariert. Jedes fehlerhafte Dokument wird in einem Build gemeldet; wo es mehr als eines gibt, werden die Befunde unter documents declaring omits whose provider does not honour them gruppiert. Ein Dokument, das an einen Provider gebunden ist, den der Build nicht auflösen kann, wird hier nicht gemeldet: Dieser Build bricht dort ab, wo der Provider ausgewählt wird, und nennt die Bindung.
Ausgegebene Meldung, positioniert am eigenen Schlüssel der Komponente unter components: für die Einträge eines Recipe (eine innerhalb eines Subsystems geschriebene Komponente wird zuerst unter dem Schlüssel dieses Subsystems positioniert), am Schlüssel der Anbindung im Block features:, der sie geschrieben hat, für die eines FeatureRecipe an einer Komponente, und an .spec.boundaries.<boundary>.features.<attachment> im Release für ein FeatureRecipe, das einmal für seine Boundary generiert. Die Kategorie erreicht Sie in der Kopfzeile in eckigen Klammern; die Meldung nennt zuerst den Provider, dann die Komponente, für die das Dokument rendert:
provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it (Provider unterstützt omits nicht: Der Vertrag dieses Providers deklariert nicht, dass er gerenderte Dokumente auslässt; entfernen Sie den Schlüssel omits, oder rendern Sie die Quelle über einen Provider, dessen Vertrag es deklariert)
Der Befund eines FeatureRecipe nennt die Anbindung nach der Komponente — node "<node-id>", attachment "<attachment>" —, und der eines FeatureRecipe, das einmal für seine Boundary generiert, nennt statt einer Komponente die Boundary und die Anbindung: boundary "<boundary>", attachment "<attachment>".
Die Kopfzeile trägt den Kurzcode dieser Bedingung, E0335.
Behebung: Entfernen Sie den Schlüssel omits:, oder rendern Sie die Quelle über einen Provider, der ihn berücksichtigt. Wo ein Recipe für helm-chart oder terraform ein lokales Chart oder Modul als Quelle bezieht, lässt stattdessen eine Zeile in der .aggregaignore neben dem Recipe eine Datei dieser Quelle aus, ab dem nächsten Mal, wenn das Recipe gepinnt wird — siehe aggrega pin.
The provider does not support boundary artifacts (Der Provider unterstützt keine Boundary-Artefakte)
Ein Recipe deklariert spec.boundary.artifacts — Dateien für die gemeinsame Ausgabe der Boundary, in der es rendert —, und der Provider, der es rendert, deklariert nicht, dass er solche Dateien akzeptiert. Der Compiler schreibt diese Dateien selbst, neben das, was der Provider für die Boundary zusammenstellt, und übergibt dem Provider keine davon, sodass es eine Eigenschaft des Ziels des Providers ist, ob eine dort abgelegte Datei etwas bedeutet. Ein Ziel, das sie nicht liest, würde sie ausliefern und ignorieren, und die Konfiguration, die sie trägt, würde nie wirksam; der Build verweigert stattdessen, bevor irgendetwas gerendert wird.
Ob ein Provider die Dateien akzeptiert, wird aus der eigenen Deklaration des Providers gelesen, was er unterstützt, nicht aus einer Liste von Providern, die der Compiler führt. Jeder Eintrag zählt, was auch immer er rendern würde. Der Provider terraform akzeptiert sie und schreibt jede neben die Root-Konfiguration der Boundary; helm, compose, helm-chart und cloudformation tun es nicht und werden zurückgewiesen.
Die Zurückweisung wird entschieden, sobald das Recipe jeder Komponente gebunden ist und jeder Provider sich selbst beschrieben hat — bevor die erste Komponente gerendert und bevor irgendein Eintrag ausgewertet wird, sodass ein hier zurückgewiesener Build nichts rendert. Jedes fehlerhafte Recipe wird in einem Build gemeldet, einmal für jede Komponente, die es rendert; wo es mehr als einen Befund gibt, werden sie unter Recipes declaring boundary artifacts whose provider does not accept them gruppiert. Ein Recipe, das an einen Provider gebunden ist, den der Build nicht auflösen kann, wird hier nicht gemeldet: Dieser Build bricht dort ab, wo der Provider ausgewählt wird, und nennt die Bindung.
Ausgegebene Meldung, positioniert an .spec.boundary im Recipe, wo die Änderung vorzunehmen ist. Die Kategorie erreicht Sie in der Kopfzeile in eckigen Klammern; die Meldung nennt zuerst den Provider, dann die Komponente, für die das Recipe rendert:
provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it (Provider unterstützt keine Boundary-Artefakte: Der Vertrag dieses Providers deklariert nicht, dass er Dateien akzeptiert, die in die gemeinsame Ausgabe einer Boundary geschrieben werden; entfernen Sie den Block boundary, oder rendern Sie das Recipe über einen Provider, dessen Vertrag es deklariert)
Die Kopfzeile trägt den Kurzcode dieser Bedingung, E0351.
Behebung: Entfernen Sie den Block boundary:, oder rendern Sie das Recipe über einen Provider, der ihn akzeptiert. Eine Datei, die zur Komponente statt zur Boundary gehört, ist stattdessen ein Eintrag unter artifacts:.
At least one input kind must be present (Mindestens ein Eingabetyp muss vorhanden sein)
Ein Recipe deklariert keinen Eingabetyp: keine source gepaart mit valuesMapping, kein workload:, kein artifacts:. Ein solches Recipe erzeugt keine Ausgabe und hat keine Rendering-Oberfläche. Diese Regel wird geprüft, wenn das Recipe geladen wird.
Eine Recipe-Datei dieser Form trifft zuerst auf das Recipe-Schema: Das Schema verlangt bei jedem Provider eines von source, valuesMapping, workload oder artifacts, sodass die Prüfung der Dokumenthülle die Datei unter E0215 zurückweist, bevor diese Regel läuft, mit einem Zweig für jeden Schlüssel:
document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema (Validierung der Dokumenthülle fehlgeschlagen (Recipe): spec: kein anyOf-Zweig passte: Zweig[0]: Validierung: erforderlich: fehlende Eigenschaften: [“source”]; Zweig[1]: Validierung: erforderlich: fehlende Eigenschaften: [“valuesMapping”]; Zweig[2]: Validierung: erforderlich: fehlende Eigenschaften: [“workload”]; Zweig[3]: Validierung: erforderlich: fehlende Eigenschaften: [“artifacts”]. Korrigieren Sie das Dokument so, dass es dem Schema seines Typs entspricht)
Ausgegebene Meldung:
Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts (Recipe: mindestens ein Eingabetyp erforderlich (Recipe, Regel input-kinds). Deklarieren Sie eines von: source (mit valuesMapping), workload, artifacts)
Behebung: Fügen Sie den Eingabetyp hinzu, der der Absicht entspricht, mit der das Recipe verfasst wurde. Ein Recipe für einen Dienst, den der Build nicht bereitstellt — eine Datenbank oder eine API, die bereits anderswo läuft —, deklariert einen workload: mit form: reference samt seinem endpoint (und optional port) und veröffentlicht seine Verbindungswerte unter provides:, wie es jedes Recipe tut: helm rendert es als ExternalName Service, compose rendert nichts dafür, und bei beiden lesen seine Konsumenten die veröffentlichten Werte.
artifacts: entry keys must be unique (Die Schlüssel der Artefakt-Einträge müssen eindeutig sein)
Ein Recipe deklariert zwei oder mehr Einträge unter artifacts: mit demselben Schlüssel. Der Schlüssel bestimmt den ausgegebenen Dateinamen (ob der Rumpf des Eintrags inline verfasst oder über ein $import: pro Eintrag geladen wird); doppelte Schlüssel würden eine Datei mit demselben Namen in dasselbe Boundary-Verzeichnis ausgeben.
Der Build weist das Recipe beim Dekodieren des Dokuments in seine typisierte Form zurück und nennt den wiederholten Schlüssel und die Zeile, in der er erneut auftritt. Dieser Schritt läuft nach der Schemaprüfung der Dokumenthülle und vor den Formregeln, sodass ein Recipe mit einem doppelten Schlüssel unter artifacts: ein gültiges Schema und dann diesen Abbruch meldet, und die übrigen Formregeln melden dazu nichts.
Behebung: Benennen Sie einen der kollidierenden Eintragsschlüssel um, sodass jeder Eintrag unter artifacts: einen eindeutigen Dateinamen hat.
Emission-time filename collision across input kinds (Dateinamenskollision zur Ausgabezeit zwischen Eingabetypen)
Ein Recipe und ein FeatureRecipe deklarieren jeweils Eingabetypen, die Dateien erzeugen: eine source:, die der Provider rendert, einen workload:, den der Provider synthetisiert, Einträge unter artifacts: und eine pipeline:, deren Schritte ausgeben können. Jeder davon wählt seine Ausgabenamen unabhängig von den anderen, und nichts deklariert diese Namen als verschieden — so können zwei davon eine Datei unter einem einzigen Namen erzeugen, und nur eine der beiden würde überleben. Der Build bricht ab und nennt den Ausgabenamen zusammen mit jedem Block, der ihn erzeugt hat.
Die Prüfung läuft einmal pro ausgebendem Dokument, sobald die eigene Ausgabe dieses Dokuments abgeschlossen ist und bevor seine Ausgabe in irgendeine Zusammenstellung eingeht. Drei Dokumente geben aus, und jedes wird für sich geprüft: das eigene Recipe einer Komponente, das FeatureRecipe, das eine Anbindung an einer Komponente bindet, und das FeatureRecipe, das eine Anbindung mit Boundary-Geltungsbereich bindet. Dass sie getrennt bleiben, sorgt dafür, dass die Diagnose das richtige Dokument nennt — die Dateien einer Anbindung werden unter der Identität ihrer Host-Komponente gerendert, sodass eine Kollision im FeatureRecipe der Anbindung gegen dieses FeatureRecipe gemeldet wird statt gegen den Host.
Jeder kollidierende Name wird separat gemeldet, sodass ein Dokument, dessen Blöcke auf zwei Namen aufeinandertrafen, beide meldet. Ein Befund wird an dem Dokument positioniert, das Sie zur Behebung bearbeiten: die Komponenteninstanz bei einem Recipe und das FeatureRecipe selbst bei einer Anbindung, deren Befund auch die Anbindung nennt — eine Komponente oder eine Boundary kann mehrere binden.
Ein Block, der mehrere Dateien unter einem Namen ausgibt, ist nicht dieser Abbruch. Das ist ein einzelner Beitragender statt zweier aufeinandertreffender Blöcke, und doppelte Schlüssel unter artifacts: innerhalb eines Blocks werden beim Dekodieren des Dokuments zurückgewiesen.
Ausgegebene Meldung:
filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (Dateinamenskollision zwischen Eingabetypen: Zwei Blöcke von Eingabetypen haben eine Datei unter einem einzigen Ausgabenamen erzeugt)
Eine Kollision in einem FeatureRecipe nennt zusätzlich die Anbindung:
filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (Dateinamenskollision zwischen Eingabetypen: Zwei Blöcke von Eingabetypen haben eine Datei unter einem einzigen Ausgabenamen erzeugt)
Behebung: Benennen Sie die kollidierende Datei in demjenigen Eingabetyp um, den Sie kontrollieren. Betrifft die Kollision einen Workload-übersetzten Dateinamen und einen Eintrag unter artifacts:, folgen die Workload-übersetzten Namen den Übersetzungskonventionen des Providers (z. B. <release-name>-deployment.yaml für helm, wobei der Release-Name {{ .context.rendered_name }} ist) — passen Sie den Dateinamen unter artifacts: an einen Namen an, den der Provider nicht synthetisiert.
An output-label key uses a reserved namespace (Ein Ausgabe-Label-Schlüssel verwendet einen reservierten Namespace)
Ein Recipe nennt einen Label-Schlüssel unter aggrega.ai/ oder app.kubernetes.io/ — in outputLabels:, dem Block, der literale Labels auf die gerenderte Ausgabe stempelt, oder in outputComponentLabels:, dem Block, der Label-Schlüssel der Komponente nennt, deren Werte darauf übertragen werden. Beide Präfixe gehören zum eigenen Herkunfts-Schlüsselraum der Plattform: Es sind die Schlüssel, die der Build selbst stempelt, sodass ein Recipe, das einen davon stempelte, in den Raum schreiben würde, der angibt, woher eine Ressource stammt. Ihre Reservierung hält zudem die Label-Menge eines Recipe von der Herkunftsmenge getrennt, sodass die beiden beim Zusammenführen nie abgeglichen werden müssen. Diese Regel wird geprüft, wenn das Recipe geladen wird.
Die Reservierung gilt nur für die nackte Wurzel. Ein Schlüssel, der lediglich eine reservierte Wurzel tiefer innerhalb eines eigenen Namespace trägt — etwa component.aggrega.ai/hosting —, ist ein anderer Schlüsselraum, der nicht der Plattform gehört, und bleibt verfassbar.
Ausgegebene Meldung. Eine einzige Bedingung deckt beide Blöcke ab, sodass ihr Satz nicht sagen kann, welcher der beiden verfasst wurde; der Hinweis danach nennt den Block, indem er den Schlüssel zitiert, den Sie eingegeben haben, und den Block, in den Sie ihn eingegeben haben:
recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Rezept-Einschränkung output-labels: Schlüssel verwendet einen reservierten Namespace (Recipe, Regel output-labels). Der Schlüssel in outputLabels verwendet einen reservierten Namespace (die beiden Präfixe sind für die Herkunftsangaben der Plattform reserviert))
Ein im Block für übertragene Labels geschriebener Schlüssel wird unter dem Regelnamen dieses Blocks gemeldet, und der Hinweis nennt den Block:
recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Rezept-Einschränkung output-labels: Schlüssel verwendet einen reservierten Namespace (Recipe, Regel output-component-labels). Der Schlüssel in outputComponentLabels verwendet einen reservierten Namespace (die beiden Präfixe sind für die Herkunftsangaben der Plattform reserviert))
Die Schlüssel des literalen Blocks werden in sortierter Reihenfolge geprüft und die des Blocks für übertragene Labels in der Reihenfolge, in der Sie sie geschrieben haben, sodass ein Recipe, das die Regel an mehreren Stellen verletzt, immer zuerst dieselbe Stelle meldet.
Behebung: Verschieben Sie den Schlüssel in einen Namespace, der Ihnen gehört — Ihre eigene Domain oder einen mit Unterpräfix wie component.aggrega.ai/… —, oder entfernen Sie ihn, wenn der gewünschte Wert einer ist, den der Build bereits stempelt. Die Herkunftsschlüssel, die eine gerenderte Ressource trägt, sind in ../providers/well-known-annotations.md aufgeführt; um einen davon zurückzulesen, ist keine Deklaration im Recipe nötig.
A promoted component label is also declared literally (Ein übertragenes Label der Komponente ist auch literal deklariert)
Ein Recipe nennt einen Schlüssel sowohl in outputComponentLabels: als auch in outputLabels:. Die beiden Blöcke stempeln aus verschiedenen Quellen auf dieselbe Label-Oberfläche — der erste überträgt den Wert, den die Komponente trägt, der zweite schreibt den Wert, den der Autor des Recipe eingegeben hat —, sodass ein in beiden genannter Schlüssel mit zwei Kandidatenwerten ankäme und nichts sagen würde, welcher gewinnt. Diese Regel wird geprüft, wenn das Recipe geladen wird, nach der obigen Regel zum reservierten Namespace, sodass ein Recipe, das beide verletzt, zuerst den reservierten Namespace meldet: Die Behebung dieses Fehlers hängt nicht davon ab, was der andere Block enthält.
Ausgegebene Meldung:
recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (Rezept-Einschränkung output-component-labels: Schlüssel ist auch in outputLabels deklariert (Recipe, Regel output-component-labels). Der Schlüssel wird über outputComponentLabels übertragen und ist auch literal in outputLabels deklariert; behalten Sie die Quelle, aus der das Label stammen soll, und entfernen Sie die andere)
Behebung: Entscheiden Sie, woher der Wert des Labels stammt, und löschen Sie die andere Deklaration. Behalten Sie den Eintrag unter outputComponentLabels:, wenn der Wert dem folgen soll, was die Komponente trägt, sodass zwei an ein Recipe gebundene Komponenten ihre eigenen Werte stempeln; behalten Sie den Eintrag unter outputLabels:, wenn der Wert dem Recipe selbst gehört und überall gleich ist, wo das Recipe gebunden ist.
FeatureRecipe-Formregeln
Ein FeatureRecipe setzt seine Ausgabe aus denselben Eingabetypen zusammen wie ein Recipe, und die folgende Kompositionsregel schränkt es so ein, wie sie ein Recipe einschränkt. Sie wird geprüft, wenn das FeatureRecipe geladen wird, und meldet in der Form, die ein Recipe-Formabbruch annimmt — der Satz der Regel, dann das fehlerhafte Dokument, der Name der Regel und der Hinweis für dieses Vorkommen — unter einem Tag CATALOG_ERROR.
Hier gibt es bewusst keine Mindestens-ein-Eingabetyp-Regel, und das ist der Unterschied zu einem Recipe. Ein FeatureRecipe, das nur einen Provider und das, was es implementiert, deklariert, ist eine legitime reine Verdrahtungs-Anbindung: Es rendert nichts, und seine Wirkung ist die Verbindung, die das Feature trägt, das es implementiert. Ein FeatureRecipe, das nur injectMapping: deklariert, ist auf dieselbe Weise legitim.
A FeatureRecipe’s valuesMapping requires source (Die Werte-Zuordnung eines FeatureRecipe erfordert eine Quelle)
Ein FeatureRecipe deklariert valuesMapping, aber nicht source. Eine Werte-Zuordnung ist eine Überlagerung; ohne Chart, Modul oder Datei, über die sie gelegt wird, gibt es also nichts, was die zugeordneten Werte erreichen könnten.
Ausgegebene Meldung:
FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping erfordert source (FeatureRecipe, Regel values-mapping). deklarieren Sie einen source:-Zeiger neben valuesMapping (oder entfernen Sie valuesMapping, wenn keine Überlagerung beabsichtigt ist))
So beheben Sie den Fehler: Fügen Sie den source:-Zeiger hinzu, für den die Überlagerung geschrieben wurde, oder entfernen Sie valuesMapping und lassen Sie die Anbindung ihre Arbeit auf andere Weise verrichten — artifacts:, um eigene Dateien auszugeben, injectMapping:, um umzuformen, was sie liefert, oder keines von beiden, für eine reine Verdrahtungs-Anbindung.
A pipeline declares one step id twice (Eine Pipeline deklariert eine Schritt-ID zweimal)
Ein Recipe oder FeatureRecipe deklariert dieselbe id für zwei Schritte seiner spec.pipeline. Ein Schritt veröffentlicht die Ausgaben, die er zurückgibt, unter seiner ID, und ein späterer Schritt derselben Pipeline liest sie als .steps.<id>.outputs; zwei Schritte mit derselben ID würden diesen späteren Schritt also die Ausgaben desjenigen der beiden lesen lassen, der zuletzt veröffentlicht hat, statt die des gemeinten.
Die Regel betrifft die eigene Pipeline eines einzelnen Dokuments. Das Recipe einer Komponente und die daran angebundenen FeatureRecipes führen ihre Pipeline jeweils getrennt aus, und jede Pipeline beginnt ohne Schrittausgaben, sodass ein Schritt eines Recipe und ein Schritt eines angebundenen FeatureRecipe dieselbe ID tragen dürfen.
Kein Schema kann diese Regel ausdrücken — JSON Schema hat kein Schlüsselwort für eine Liste, deren Einträge über eines ihrer Felder eindeutig sind —, daher akzeptiert ein schemafähiger Editor ein solches Dokument, und die Prüfung läuft beim Lesen des Dokuments, direkt nach der Schemaprüfung. Jede Oberfläche, die ein Recipe oder FeatureRecipe liest, meldet sie: aggrega validate für die Datei oder über den ganzen Katalog, ein Build, der den Katalog lädt, ein Pull, der eine abgerufene Entität aufnimmt, die Diagnosen des Editors und eine Dokumentbearbeitung, die abgelehnt statt geschrieben wird. Ein Dokument, das zusätzlich sein Schema verletzt, meldet zuerst die Befunde des Schemas und diese Zurückweisung, sobald jene behoben sind.
Jede Wiederholung ist ein eigener Befund, positioniert an der wiederholten id und mit Nennung des Schritts, der die ID zuerst deklariert hat, samt Zeile und Spalte. Kommt eine ID dreimal vor, nennen beide späteren Schritte den ersten.
Ausgegebene Meldung für ein FeatureRecipe, dessen zweiter Schritt die ID des ersten wiederholt. Die Kategorie und der Kurzcode dieser Bedingung, E0370, erreichen Sie in der Kopfzeile in eckigen Klammern:
a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (eine Pipeline deklariert eine Schritt-ID zweimal (FeatureRecipe); spec.pipeline[1].id: die Schritt-ID ist bereits bei spec.pipeline[0].id deklariert. geben Sie jedem Schritt der Pipeline eine eigene ID, und richten Sie jeden Verweis, den ein späterer Schritt macht, auf den gemeinten Schritt)
So beheben Sie den Fehler: Benennen Sie einen der beiden Schritte um, sodass jede ID nur einmal deklariert ist. Durchsuchen Sie dann die with:- und when:-Templates jedes späteren Schritts nach .steps.<id>-Verweisen auf die beibehaltene ID, und richten Sie jeden auf den Schritt, dessen Ausgaben er meint — erst die Umbenennung macht die Ausgaben der beiden Schritte getrennt erreichbar.
A document declares an API version this compiler no longer reads (Ein Dokument deklariert eine API-Version, die dieser Compiler nicht mehr liest)
Die apiVersion-Zeile eines Dokuments deklariert aggrega.ai/v1alpha1. Jede Dokumentart, die eine apiVersion-Zeile enthält, deklariert aggrega.ai/v1beta1, die einzige Version, die dieser Compiler liest, und es findet keine Konvertierung von der früheren Version statt: Das Dokument wird beim Lesen abgelehnt, bevor irgendetwas anderes geprüft wird, denn jeder andere Befund beträfe eine Version des Dokuments, die der Compiler nicht liest.
Jede Oberfläche, die ein Dokument liest, meldet dies: aggrega validate, ein Build, ein Pull, der eine abgerufene Entität aufnimmt, die Diagnosen des Editors und eine Dokumentbearbeitung. Ein Dokument, das eine Version deklariert, die der Compiler nie gelesen hat, wird stattdessen vom Schema seiner Art abgelehnt, unter E0215.
Ausgegebene Meldung für eine Component. Die Kategorie und der Kurzcode dieser Bedingung, E0373, werden Ihnen im Kopf in eckigen Klammern angezeigt:
a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1 (ein Dokument deklariert eine API-Version, die dieser Compiler nicht mehr liest (Component); 1:1: apiVersion: das Dokument deklariert aggrega.ai/v1alpha1, und dieser Compiler liest aggrega.ai/v1beta1. setzen Sie die apiVersion-Zeile auf aggrega.ai/v1beta1)
So beheben Sie das Problem: Ändern Sie die apiVersion-Zeile des Dokuments in apiVersion: aggrega.ai/v1beta1. Die Felder jeder Art sind zwischen den beiden Versionen unverändert, daher ist diese Zeile die gesamte Änderung.
A plugin declares a plugin ABI version this compiler no longer speaks (Ein Plugin deklariert eine Plugin-ABI-Version, die dieser Compiler nicht mehr unterstützt)
Ein Plugin deklariert die Plugin-ABI v1alpha1. Dieser Compiler unterstützt die Plugin-ABI v1beta1 und keine andere, daher wird ein gegen die frühere ABI gebautes Plugin abgelehnt statt ausgeführt. Ein Plugin gibt seine ABI an zwei Stellen an, und jede wird unter dieser einen Bedingung abgelehnt: der describe()-Bericht, den sein Guest beim Laden zurückgibt, und das Feld spec.abiVersion seiner Plugin-Entität, das beim Lesen der Entität abgelehnt wird, bevor irgendetwas anderes geprüft wird. Ein Plugin, das eine ABI-Version deklariert, die dieser Compiler nie unterstützt hat, wird ebenfalls abgelehnt, durch die Deskriptorprüfung (E0085) oder durch das Plugin-Schema (E0215).
Ausgegebene Meldung für einen Guest beim Laden. Die Kategorie und der Kurzcode dieser Bedingung, E0374, werden Ihnen im Kopf in eckigen Klammern angezeigt:
plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks (das Plugin deklariert abi_version “v1alpha1”, und dieser Compiler unterstützt “v1beta1”; bauen Sie das Plugin gegen das aktuelle Plugin-Kit neu und veröffentlichen Sie es erneut: ein Plugin deklariert eine Plugin-ABI-Version, die dieser Compiler nicht mehr unterstützt)
Ausgegebene Meldung für eine Plugin-Entität:
a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1 (ein Plugin deklariert eine Plugin-ABI-Version, die dieser Compiler nicht mehr unterstützt (Plugin); spec.abiVersion: das Plugin deklariert abiVersion v1alpha1, und dieser Compiler unterstützt v1beta1. bauen Sie das Plugin gegen das aktuelle Plugin-Kit neu und veröffentlichen Sie es erneut; seine Plugin-Entität deklariert dann abiVersion v1beta1)
So beheben Sie das Problem: Bauen Sie das Plugin gegen die aktuelle Version seines Plugin-Kits neu, die v1beta1 in den describe()-Bericht des Guests schreibt, und veröffentlichen Sie es erneut, sodass auch die daneben generierte Entität abiVersion: v1beta1 deklariert. Nur die Zeile der Entität zu bearbeiten, reicht nicht aus: Der Guest selbst meldet weiterhin die frühere ABI und wird beim Laden abgelehnt.
An artifact carries a media type this compiler no longer reads (Ein Artefakt trägt einen Medientyp, den dieser Compiler nicht mehr liest)
Ein aus einer Registry abgerufenes Artefakt trägt einen Medientyp, unter dem eine frühere Version veröffentlicht hat — application/vnd.aggrega.<kind>.v1alpha1 mit seinem Suffix, im Artefakttyp des Manifests, in seiner Konfiguration oder in einem seiner Layer. Dieser Compiler veröffentlicht und liest die v1beta1-Medientypen, daher wird das Artefakt beim Lesen seines Manifests namentlich abgelehnt, bevor irgendetwas von seinem Inhalt übernommen wird: eine Katalogentität, ein Plugin und seine ausführbare Datei oder ein Dokumentationspaket gleichermaßen. Eine Indexierung einer Registry überspringt ein solches Artefakt und nennt den Grund. Ein Medientyp außerhalb des eigenen Namespace application/vnd.aggrega. von Aggrega fällt nie unter diese Bedingung.
Ausgegebene Meldung für eine Component, die von einer früheren Version veröffentlicht wurde. Die Kategorie und der Kurzcode dieser Bedingung, E0375, werden Ihnen im Kopf in eckigen Klammern angezeigt:
"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads (trägt den Medientyp “application/vnd.aggrega.component.v1alpha1+yaml”, und dieser Compiler liest “application/vnd.aggrega.component.v1beta1+yaml”; veröffentlichen Sie das Artefakt erneut mit der aktuellen Version: oci: Artefakt trägt einen Medientyp, den dieser Compiler nicht mehr liest)
So beheben Sie das Problem: Veröffentlichen Sie das Artefakt erneut mit der aktuellen Version von aggrega, die die v1beta1-Medientypen schreibt. Ein Artefakt, das jemand anderes veröffentlicht, muss diese Person selbst erneut veröffentlichen; bis dahin kann es nicht gelesen werden.
A file cannot be read, or its bytes do not parse (Eine Datei kann nicht gelesen werden, oder ihre Bytes lassen sich nicht parsen)
Eine Datei, die ein Build lesen musste, oder ein Aggrega-Dokument, das eine Prüfung des ganzen Katalogs unter den Katalogverzeichnissen gelesen hat, lieferte nichts, was die Oberfläche, die sie nannte oder las, verwenden konnte. Entweder konnte sie nicht von der Festplatte gelesen werden, oder ihre Bytes wurden geparst und ließen sich nicht sauber parsen. Nichts Nachgelagertes läuft darauf, denn es gibt keinen Inhalt, der gegen ein Schema geprüft werden könnte, keine Komponenten zu platzieren und kein Template zu rendern.
Die Bedingung nennt kein Format, und das ist Absicht. Die meisten Dateien, die sie abdeckt, werden als YAML gelesen; die Workload-, Values-Mapping- und Artefakt-Körper eines Recipe werden als Go-Template-Quelltext gelesen und überhaupt nie geparst. Ein Satz, der YAML verspräche, würde eine Diagnose zu einer Template-Datei mit einer Behauptung über das Format dieser Datei einleiten. Welcher der beiden Fehler aufgetreten ist und für welche Art von Datei, sagt der Satzteil nach dem Satz.
Die Dokumente, von denen ein Build ausgeht — das Aggregate, das Release und das Manifest —, sind die häufigsten Gegenstände, und der Abbruch wird an jeder Stelle ausgelöst, an der eines der drei gelesen wird. Die Diagnose nennt, welches Dokument gelesen wurde und von welchem Pfad. Der Pfad unterscheidet eine fehlende Datei von einer fehlerhaften: Ein Lesefehler zitiert den eigenen Grund des Betriebssystems, ein Parse-Fehler den des YAML-Parsers, der die Zeile enthält, an der der Parser aufgegeben hat.
Ausgegebene Meldung, wenn die Datei nicht gelesen werden konnte:
file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Aggregate, Lesen der Datei fehlgeschlagen))
und wenn sich ihr Text nicht parsen ließ:
file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Aggregate, Unmarshalling des YAML fehlgeschlagen))
Release und Manifest erscheinen anstelle von Aggregate, wenn eines davon das gelesene Dokument ist. Dieselbe Bedingung deckt auch den Parametervertrag ab, der aus dem deklarierten parameters:-Block eines Aggregate gelesen wird; er wird aus dem eigenen Text des Aggregate gelesen, bevor irgendetwas hineininterpoliert wird.
Auch ein parameters: { $import: … } eines Release, das eine Datei nennt, an die der Build nicht herankommt, wird hier gemeldet, und zwar in beiden Fällen: Der Pfad nennt keine Datei, die der Build lesen kann, oder die Datei wird gelesen und ihre Bytes lassen sich nicht parsen. Gegenstand ist das Release, und der Satzteil nennt den Schlüssel, der auf die Datei verwies:
file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>) (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Release, Lesen der Datei fehlgeschlagen)) file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>) (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Release, Unmarshalling des YAML fehlgeschlagen))
Ein relativer Pfad wird von dem Verzeichnis aus aufgelöst, das das Release enthält, das ihn schreibt — das Release, das ein Befehl nennt, oder ein Glied seiner extends:-Kette —, unabhängig davon, von wo aus der Befehl ausgeführt wird, sodass Befehlszeile und Editor dieselbe Datei lesen; ein absoluter Pfad nennt seinen eigenen Ort. Vergewissern Sie sich, dass der Checkout, gegen den der Build läuft, die Datei an dieser Stelle enthält: Eine Parameterdatei, die auf Ihrem Rechner vorhanden und von der Versionskontrolle ausgeschlossen ist, fehlt bei einem Lauf der kontinuierlichen Integration, und auf diesem Weg trifft man üblicherweise auf diesen Fehler. Ein Pfad, der aus dem Workspace hinausführt — oder, bei einem außerhalb des Workspace genannten Release, aus dem eigenen Verzeichnis dieses Release —, wird gar nicht gelesen und unter „A reference to another file leads out of the directory it must stay inside“ (Ein Verweis auf eine andere Datei führt aus dem Verzeichnis hinaus, in dem er bleiben muss) weiter unten gemeldet.
Auch ein Schema-$import:, das eine Datei nennt, an die der Build nicht herankommt, wird hier gemeldet, weil der Fehler derselbe ist: Die Direktive ist wohlgeformt, und die Datei, die sie nennt, lieferte kein Dokument. Gegenstand ist dann eine Katalogentität statt eines der drei Dokumente, daher nennt der Satzteil die Schemaoberfläche, für die aufgelöst wurde — spec.schema, eine ihrer Säulen wie spec.schema.values oder das valueSchema eines usesSchema-Sockets —, und der Quellverweis ist die Zeile, in der die Direktive geschrieben wurde:
file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason> (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen. Lesen des importierten Schemas)
mit resolve imported schema path anstelle von read für den selteneren Fall, dass sich das eigene Verzeichnis der Entität gar nicht ermitteln ließ, und parse imported schema, wenn die Datei gelesen wurde und ihr Text kein wohlgeformtes YAML ist. Ein Fehler in der Direktive, die Sie geschrieben haben — ein Geschwisterschlüssel daneben, ein Wert, der kein Pfad ist, oder importierter Inhalt, der sich parsen ließ und keine Map ist —, ist eine andere Bedingung und wird unter „A schema $import: cannot be applied“ (Ein Schema-Import kann nicht angewendet werden) weiter unten gemeldet.
Auch ein valuesMapping:-, workload:- oder artifacts.<name>:-Import eines Recipe oder FeatureRecipe wird hier gemeldet, aus demselben Grund und mit derselben Abhilfe: Die Direktive ist wohlgeformt, und die Datei, die sie nennt, lieferte keinen Inhalt. Diese drei Körper sind Go-Template-Quelltext statt Dokumente, daher kann nur das Lesen fehlschlagen — an dieser Stelle parst sie nichts. Die Entität und der Schlüssel, der den Pfad nannte, werden im Satzteil mitgeführt, und der Quellverweis ist der eigene Pfad der importierten Datei:
file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Recipe, Dateiimport für valuesMapping). wenn Sie einen Bibliothekseintrag statt einer Datei gemeint haben, braucht der Verweis sein Fragment — ein $import: ohne Fragment wird als Dateipfad gelesen, und ein Wert ohne Anführungszeichen endet dort, wo ein Leerzeichen vor # einen Kommentar beginnt; setzen Sie daher den ganzen Verweis in Anführungszeichen) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Recipe, Dateiimport für workload). wenn Sie einen Bibliothekseintrag statt einer Datei gemeint haben, braucht der Verweis sein Fragment — ein $import: ohne Fragment wird als Dateipfad gelesen, und ein Wert ohne Anführungszeichen endet dort, wo ein Leerzeichen vor # einen Kommentar beginnt; setzen Sie daher den ganzen Verweis in Anführungszeichen) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Recipe, Dateiimport für ein Artefakt). wenn Sie einen Bibliothekseintrag statt einer Datei gemeint haben, braucht der Verweis sein Fragment — ein $import: ohne Fragment wird als Dateipfad gelesen, und ein Wert ohne Anführungszeichen endet dort, wo ein Leerzeichen vor # einen Kommentar beginnt; setzen Sie daher den ganzen Verweis in Anführungszeichen)
Das Fragment unterscheidet einen Bibliotheksverweis von einem Pfad: <Library>#/mappings/<entry> wird gegen die Bibliotheken aufgelöst, und derselbe Text ohne Fragment ist ein gewöhnlicher relativer Pfad. Es geht leicht unbemerkt verloren, weil ein einfacher YAML-Wert dort endet, wo ein Leerzeichen vor # einen Kommentar öffnet — so erreicht $import: LibBeta:1.0.0 #/workloads/Web den Build als LibBeta:1.0.0, und der Build sucht dann neben dem Recipe nach einer Datei dieses Namens. Setzen Sie den ganzen Verweis in Anführungszeichen, um das Fragment zu erhalten.
Dieselben drei Schlüssel in einem FeatureRecipe melden dieselbe Bedingung und lesen sich genauso. Ein Artifacts-Import wird im Leben eines Release zweimal gelesen — einmal, wenn aggrega pull seinen Inhalts-Pin einfriert, und erneut, wenn der Eintrag gerendert wird —, daher meldet dieselbe fehlende Datei diese Bedingung bei demjenigen der beiden Schritte, den Sie zuerst erreichen. Ein Formfehler in der Direktive selbst, etwa ein Geschwisterschlüssel neben $import: oder ein Verweis oci:// mit Host, ist eine andere Bedingung und wird unter einem eigenen Eintrag gemeldet.
Auch aggrega lint und aggrega validate über den ganzen Katalog melden hier, und zwar für ein Dokument unter den Katalogverzeichnissen, das eine Aggrega-apiVersion deklariert — eine Zeile, die ohne Einrückung mit apiVersion: und einem Wert beginnt, der mit aggrega.ai/ anfängt — und das nicht gelesen werden kann, sich nicht parsen lässt oder sich nicht in den Umschlag dekodieren lässt, den die Prüfung liest, etwa ein als Liste geschriebenes metadata. Kein Autor hat einen Pfad dorthin geschrieben: Die Prüfung hat es gelesen, weil es in einem Katalogverzeichnis liegt. Jede Prüfung liest jede Datei, bevor sie anhält, sodass ein einziger Lauf jedes solche Dokument nennt; sie prüft sonst nichts und gibt keine Zusammenfassung aus. YAML, das keine Aggrega-apiVersion deklariert — darunter die Templates eines Helm-Charts —, wird übergangen. Die Kopfzeile zählt die Dokumente und nennt ihre Dateien, und jedes wird darunter mit dem Grund aufgeführt, den das Lesen oder der Parser angegeben hat:
<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (Dokumente unter den Katalogverzeichnissen deklarieren eine Aggrega-apiVersion und konnten nicht geladen werden, daher wurde nichts geprüft) file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>) (Laden der Datei fehlgeschlagen: Die Datei konnte nicht gelesen werden, oder ihre Bytes ließen sich nicht parsen (Katalogdokument, Unmarshalling des YAML fehlgeschlagen))
mit failed to decode the envelope: und der Zeile und dem, was der Decoder dort gefunden hat — line 4 (metadata): a list is written where a map is expected für ein als Liste geschriebenes metadata — für ein Dokument, das sich parsen, aber nicht dekodieren lässt, und failed to read file: und dem Grund des Betriebssystems für eine Datei, die nicht gelesen werden konnte. Ein Dokument, das geladen wird und einen Typ deklariert, den kein Katalog enthält, wird von demselben Abbruch genannt, in derselben Kopfzeile gezählt und unter seiner eigenen Bedingung aufgeführt — siehe „A catalog document declares a kind a catalog does not hold“ (Ein Katalogdokument deklariert einen Typ, den ein Katalog nicht enthält) weiter unten.
So beheben Sie den Fehler: Lesen Sie den Pfad in der Meldung statt des Namens des Dokuments — die beiden unterscheiden sich immer dann, wenn ein Verweis an einer unerwarteten Stelle aufgelöst wurde. Prüfen Sie bei einem Lesefehler, ob die Datei unter diesem Pfad existiert, ob der Pfad so geschrieben ist, wie das verweisende Dokument ihn schreibt, und ob der Build die Berechtigung hat, sie zu lesen; eine lokal vorhandene Datei, die im Checkout eines Build-Agenten fehlt, ist der übliche Fall. Öffnen Sie bei einem Parse-Fehler die Datei an der Zeile, die der Parser genannt hat — ein Wert ohne Anführungszeichen, der einen Doppelpunkt enthält, ein zur Einrückung verwendeter Tabulator und ein Listeneintrag, der unter dem falschen Schlüssel eingerückt ist, sind die drei Ursachen, auf die die meisten zurückgehen.
A catalog document declares a kind a catalog does not hold (Ein Katalogdokument deklariert einen Typ, den ein Katalog nicht enthält)
Ein Dokument unter den Katalogverzeichnissen deklariert eine Aggrega-apiVersion — eine Zeile, die ohne Einrückung mit apiVersion: und einem Wert beginnt, der mit aggrega.ai/ anfängt — und ein kind, das kein Katalog enthält: einen Tippfehler wie Componnent, einen Typ mit falscher Groß-/Kleinschreibung wie component oder gar kein kind. Ein Katalog legt jedes Dokument unter dem Typ ab, den es deklariert, daher gelangt ein solches Dokument in keinen Katalog: Ein Build, inspect und jeder andere Befehl, der den Katalog lädt, übergehen es, und ein Verweis auf die Entität, die es deklarieren sollte, wird zu nichts aufgelöst.
Ein Katalog enthält Component-, Feature-, Recipe-, FeatureRecipe-, SchemaLibrary-, MappingLibrary-, WorkloadLibrary-, ArtifactLibrary-, Aggregate- und Plugin-Dokumente. Drei weitere Typen liegen berechtigterweise in seinen Verzeichnissen und werden hier nie gemeldet: ein Manifest und ein Release, die neben den Entitäten abgelegt sind, und eine Workload im Verzeichnis des Recipe oder FeatureRecipe, das sie importiert.
Das melden aggrega validate und aggrega lint über den ganzen Katalog sowie der auf ein Release beschränkte Lint, der dieselben Verzeichnisse durchläuft. Jeder liest jede Datei, bevor er anhält, sodass ein einziger Lauf jedes solche Dokument zusammen mit jedem Dokument nennt, das überhaupt nicht geladen werden kann, unter einer Kopfzeile, die sie zählt und ihre Dateien nennt; es wird nichts geprüft und keine Zusammenfassung ausgegeben. Jedes Dokument wird mit dem Typ aufgeführt, den es deklariert, und die Zeile schließt mit den Typen, die ein Katalog enthält:
<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (Dokumente unter den Katalogverzeichnissen deklarieren eine Aggrega-apiVersion und konnten nicht geladen werden, daher wurde nichts geprüft) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (ein Katalogdokument deklariert einen Typ, den ein Katalog nicht enthält (kind “Componnent”). ein Katalog enthält Component-, Feature-, Recipe-, FeatureRecipe-, SchemaLibrary-, MappingLibrary-, WorkloadLibrary-, ArtifactLibrary-, Aggregate- und Plugin-Dokumente und übergeht eine Workload, ein Manifest oder ein Release; korrigieren Sie den Typ, oder verschieben Sie die Datei aus den Katalogverzeichnissen)
mit no kind anstelle von kind "<kind>" für ein Dokument, das keinen Typ deklariert.
Ein Build hält bei einem solchen Dokument nicht an: Er übergeht es, wie jedes Laden es tut, und ein Dokument, das kein Release erreicht, lässt nie einen Build fehlschlagen. Wo ein Release die Entität erreicht, hält der Build beim Verweis an, unter „A reference names no entity the catalog holds“ (Ein Verweis nennt keine Entität, die der Katalog enthält) weiter unten, und der Hinweis unter diesem Fehler nennt die Datei, wenn sie den Namen deklariert, nach dem der Verweis fragt — siehe diesen Eintrag.
So beheben Sie den Fehler: Öffnen Sie die Datei, die die Meldung nennt, und korrigieren Sie ihr kind auf den Typ, der das Dokument ist — sowohl die Schreibweise als auch die Groß-/Kleinschreibung sind von Bedeutung. Eine Datei, die gar keine Katalogentität ist, gehört nicht unter die Katalogverzeichnisse; verschieben Sie sie dort hinaus, oder geben Sie ihr eine apiVersion, die nicht die von Aggrega ist, wenn sie das Dokument eines anderen Werkzeugs ist.
A path names content outside the entity’s own directory (Ein Pfad benennt Inhalte außerhalb des eigenen Verzeichnisses der Entität)
Der Inhalt einer Entität liegt im eigenen Verzeichnis der Entität, weil jede Datei, die eine Veröffentlichung der Entität mitführt, von dort genommen wird. Ein Pfad, der es verlässt, verweist auf eine Datei, die nicht mit der Entität mitreisen würde; die Datei ist also für niemanden vorhanden, der die Entität erhält, und ein darüber aufgezeichneter Pin bürgt für Bytes, die diese Empfänger nicht beschaffen können.
Daher wird jeder Pfad, den eine Entität für mitgeführte Inhalte schreibt, relativ zu dem Verzeichnis gelesen, das die Datei der Entität enthält, und muss innerhalb davon bleiben. Das betrifft die source: eines Recipe und eines FeatureRecipe — einen einfachen Pfad oder die url: der strukturierten Form —, die Datei, die jeder Eintrag von valuesMapping:, workload: und artifacts: mit $import: importiert, und jedes Schema, das eine Component oder ein Feature importiert, vollständig, pro Säule oder, für einen Socket usesSchema, dessen valueSchema und infraSchema. Drei Formen verlassen das Verzeichnis: ein Pfad, der darüber hinaus aufsteigt, ein absoluter Pfad, der einen Ort auf der Maschine benennt, auf der er geschrieben wurde, und ein innerhalb des Verzeichnisses geschriebener Pfad, den ein symbolischer Link auf dem Weg hinausführt — ein Verzeichnis entlang des Pfads ebenso wie die Datei an seinem Ende, das ein Link ist, der aus dem Verzeichnis der Entität hinausführt. Ein Pfad, der aufsteigt und wieder hineinführt — ./charts/../values.tmpl —, ist ein gewöhnlicher Pfad innerhalb des Verzeichnisses, ebenso wie einer über einen Link, der woandershin innerhalb davon führt. Ein Aufstieg, der über den eigenen Namen wieder in das Verzeichnis eintritt — ../1.0.0/values.tmpl, geschrieben in einem Verzeichnis namens 1.0.0 —, wird zurückgewiesen, weil der Name des Verzeichnisses nicht zu dem gehört, was mitreist: Eine veröffentlichte Entität wird aus einem Verzeichnis gelesen, das der Cache des Empfängers benennt, wo dieser Name nichts findet. Ein Pfad über einen hinausführenden Link wird zurückgewiesen, weil eine Veröffentlichung sonst die Bytes, auf die der Link verweist, von wo auch immer er hinzeigt, unter einem Namen innerhalb der Entität mitführen würde.
Er wird überall zurückgewiesen, wo die Entität gelesen wird. Ein aggrega validate über den gesamten Katalog, aggrega validate auf die eigene Datei der Entität, aggrega pull und aggrega build weisen ihn zurück, während die Datei der Entität gelesen wird, ebenso aggrega pin eines Recipe oder eines FeatureRecipe und aggrega push eines beliebigen der vier Typen, bevor irgendetwas abgerufen, geschrieben oder veröffentlicht wird. Eine als Template geschriebene source: benennt nichts, bis der Build sie auswertet; ein Template, das einen Pfad außerhalb des Verzeichnisses erzeugt, wird daher vom Build zurückgewiesen, in dem Moment, in dem der Wert existiert.
Ein Release ist anders, und ebenso ein Entitätsverweis. Ein Release verweist auf andere Entitäten — sein Aggregate, sein Manifest, das Release, das es erweitert — und wird nie veröffentlicht, sodass nichts, was es liest, irgendwohin mitreist: Diese Pfade und die Datei, die die parameters: eines Release importieren, werden so gelesen, wie sie geschrieben sind. Der type eines Aggregate benennt eine andere Entität über ihre Identität statt über Inhalte, die das Aggregate mitführt, und wird ebenfalls nach eigenen Regeln aufgelöst: über die Katalogverzeichnisse, den Cache und die Registry, nie als Dateipfad.
Ausgegebene Meldung, die den Pfad so benennt, wie er geschrieben ist:
a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity (ein Pfad benennt Inhalte außerhalb des eigenen Verzeichnisses der Entität. Abhilfe: Verschieben Sie die Datei in das Verzeichnis, das die Entität enthält, oder in ein Verzeichnis darunter, und benennen Sie sie mit einem Pfad relativ zu diesem Verzeichnis. Der Inhalt einer Entität liegt im eigenen Verzeichnis der Entität, weil jede Datei, die eine Veröffentlichung davon mitführt, von dort genommen wird; ein Pfad, der es verlässt, verweist auf eine Datei, die nicht mit der Entität mitreisen würde)
und, für einen Pfad, den ein Link aus dem Verzeichnis hinausführt, mit Angabe des Links und seines Ziels:
a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity (ein Pfad benennt Inhalte außerhalb des eigenen Verzeichnisses der Entität. Abhilfe: Ersetzen Sie den Link durch eine Kopie dessen, worauf er führt, abgelegt im Verzeichnis, das die Entität enthält. Der Inhalt einer Entität liegt im eigenen Verzeichnis der Entität, weil jede Datei, die eine Veröffentlichung davon mitführt, von dort genommen wird; ein hinausführender Link würde die Bytes, auf die er verweist, unter einem Namen innerhalb der Entität mitführen)
Das Feld, aus dem er gelesen wurde, wird in der Zeile über der Meldung genannt: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema … oder, für eine per Template erzeugte Quelle, node "<name>" source.
So beheben Sie es: Verschieben Sie die Datei in das Verzeichnis der Entität oder in ein Verzeichnis darunter, und schreiben Sie ihren Pfad relativ zu diesem Verzeichnis. Wo ein Link den Pfad hinausführt, ersetzen Sie den Link durch eine Kopie dessen, worauf er führt, innerhalb des Verzeichnisses der Entität. Ein Chart, das mehrere Recipes teilen, wird in das Verzeichnis jedes Recipe kopiert, da jedes eigenständig veröffentlicht wird; ein Schema, das mehrere Components teilen, gehört in eine SchemaLibrary, auf die jede Component dann über ihre Identität verweist, und ein Mapping-, Arbeitslast- oder Artefakt-Body, den mehrere Recipes teilen, gehört in den passenden Bibliothekstyp.
A Recipe’s source: names a kind nothing knows how to acquire (Die Quelle eines Recipe benennt einen Typ, den nichts zu beschaffen weiß)
Die source: eines Recipe gibt an, auf welchen Typ von Ding sie verweist — ein Chart, ein Modul, ein Compose-Projekt —, und jeder Typ wird von dem Quelladapter beschafft, der diesen Typ bedient. Diese Bedingung meldet einen Typ, den kein Quelladapter bedient, sodass nichts, was dieses Programm mitbringt, die Quelle abrufen kann. Für die source: eines FeatureRecipe gilt dieselbe Regel.
Es wird zurückgewiesen, während das Dokument gelesen wird, bevor irgendetwas abgerufen wird: Die Prüfung des Recipe für sich allein weist es zurück, ebenso jedes Release, das es erreicht. Nichts wurde versucht, weil nichts es versuchen konnte — und das unterscheidet es von einer Beschaffung, die lief und fehlschlug.
Ausgegebene Meldung, die das Dokument, den Typ wie geschrieben und die bedienten Typen benennt:
no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind (kein Quelladapter bedient den Quelltyp (Recipe, Regel source-kind). die Quelle benennt einen Typ; benennen Sie einen Typ, den ein Quelladapter bedient, oder schreiben Sie die Quelle als einen einzigen URI, dessen Form seinen Typ benennt)
So beheben Sie es: Korrigieren Sie den Typ in der source: auf einen, den die Toolchain bedient — ein Tippfehler und ein Typ, der tatsächlich keinen Adapter hat, erzeugen dieselbe Meldung, und die Meldung zitiert den Typ so, wie Sie ihn geschrieben haben, neben den bedienten Typen; prüfen Sie daher zuerst die Schreibweise anhand dieser Liste, die auch die Recipe-Seite beschreibt. Ist der Typ so geschrieben, wie Sie es beabsichtigt haben, kann dieser Build diesen Typ nicht beschaffen, und keine Änderung am Recipe wird das ändern; lassen Sie die source: stattdessen auf eine bediente Form verweisen, oder schreiben Sie sie als einen einzigen URI, dessen Form seinen Typ benennt.
No source adapter is registered in this program for a source kind (In diesem Programm ist für einen Quelltyp kein Quelladapter registriert)
Eine Quelle wird von dem Adapter abgerufen, der für ihren Typ registriert ist. Diese Bedingung meldet einen Abruf, der für einen Typ ausgelöst wurde, für den kein Adapter registriert ist. Ein vom Autor geschriebener Typ, den kein Adapter bedient, wird zurückgewiesen, während sein Recipe gelesen wird (unter „A Recipe’s source: names a kind nothing knows how to acquire (Die Quelle eines Recipe benennt einen Typ, den nichts zu beschaffen weiß)“ oben), sodass nichts, was ein Autor schreibt, hierher gelangt: Sie meldet ein Programm, das ohne den Adapter für einen von ihm bedienten Typ zusammengestellt wurde, oder ein auf den Go-Paketen von Aggrega aufgebautes Programm, das einen Abruf für einen selbst zusammengestellten Typ auslöst.
Ausgegebene Meldung, die den Typ benennt:
kind "<kind>": no source adapter is registered in this program for the source kind (Typ: in diesem Programm ist für den Quelltyp kein Quelladapter registriert)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies. Melden Sie es demjenigen, der die Binärdatei erstellt hat, die Sie ausführen.
A source URL carries a credential (Eine Quell-URL enthält Zugangsdaten)
Die url einer Quelle wird so aufgezeichnet, wie Sie sie geschrieben haben — in der Lockfile des Release, in der entity.lock neben dem Recipe und im Quell-Cache —, und das Recipe selbst ist eine Datei, die Sie committen und veröffentlichen können. Zugangsdaten, die in die URL geschrieben werden, würden also überallhin mitreisen, wohin die URL gelangt. Diese Bedingung meldet eine source: eines Recipe, deren url einen Benutzer vor ihren Host schreibt: https://user:token@host/…, oder ein allein geschriebenes Token wie https://token@host/…, da ein über HTTP erreichter Dienst häufig ein Token an der Stelle des Benutzers annimmt. Über http und https zählt jeder dort geschriebene Benutzer; über ein anderes Schema nur ein Passwort, weil ein dort allein geschriebener Benutzer ein Konto benennt — ssh://git@github.com/… wird akzeptiert, und der SSH-Agent liefert seinen Schlüssel. Für die source: eines FeatureRecipe gilt dieselbe Regel.
Es wird zurückgewiesen, während das Dokument gelesen wird, bevor irgendetwas abgerufen wird: Die Prüfung des Recipe für sich allein weist es zurück, ebenso jedes Release, das es erreicht, bei einer Validierung, einem Pull, einem Pin oder einem Build. Die Meldung nennt den Host und nie die Zugangsdaten. Die Prüfung liest den Teil der URL, der vor dem Host steht, und nichts anderes; ein Token in einem Query-String oder einem Pfad wird daher nicht erkannt — und wie der Rest der URL so aufgezeichnet, wie es geschrieben ist.
Ausgegebene Meldung über http oder https, die das Dokument, den Schlüssel und den Host benennt und dann angibt, wohin die Zugangsdaten gehören:
the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows) (die Quell-URL enthält Zugangsdaten (Recipe, Regel source-url). spec.source.url nennt einen Benutzer oder ein Passwort für den Host; entfernen Sie sie aus der URL und schreiben Sie die Zugangsdaten stattdessen in die netrc-Datei, als Eintrag „machine … login … password …“ (die Datei, die NETRC benennt, sonst .netrc in Ihrem Home-Verzeichnis oder _netrc in %USERPROFILE% unter Windows))
und über ein anderes Schema, wo die Abhilfe darin besteht, das Passwort zu entfernen:
the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored (die Quell-URL enthält Zugangsdaten (Recipe, Regel source-url). spec.source.url nennt ein Passwort für den Host; entfernen Sie es aus der URL, die so, wie sie verfasst wurde, in die Lockfile und den Cache geschrieben wird)
So beheben Sie es: Entfernen Sie Benutzer und Passwort aus der url, sodass die URL bleibt, die den Host benennt. Für eine über http oder https abgerufene Quelle legen Sie die Zugangsdaten in einem machine-Eintrag für diesen Host in Ihrer netrc-Datei ab, die jeder Abruf eines klassischen Helm-Chart-Repositorys, eines Compose-Fragments oder eines Git-Repositorys über HTTP oder HTTPS liest — Authentifizierung beschreibt, welche Datei und welcher Eintrag. Für ein Git-Repository über SSH liefert der SSH-Agent den Schlüssel, und der Benutzer darf bleiben. Wurde das Recipe bereits mit den Zugangsdaten committet oder veröffentlicht, befinden sich die Zugangsdaten in dieser Historie: Ändern Sie sie auch auf dem Server.
A {{ .parameters.* }} reference cannot be interpolated (Ein Parameterverweis kann nicht interpoliert werden)
Der Text des Aggregate wird als Template ausgewertet, bevor er als Dokument gelesen wird, sodass ein Verweis {{ .parameters.<key> }} durch den Wert ersetzt wird, den das Release dafür geliefert hat. Dieser Abbruch tritt ein, wenn diese Auswertung nicht abgeschlossen werden kann: Der Text lässt sich nicht als Template parsen, oder er lässt sich parsen und schlägt während der Ausführung fehl.
Die Interpolation erfolgt, bevor das Aggregate als YAML geparst wird; deshalb wird ein Fehler hier für das Aggregate als Ganzes gemeldet statt an einem Schlüssel darin — zu diesem Zeitpunkt hat das Dokument noch keine Schlüssel. Deshalb darf der Verweis auch ohne Anführungszeichen bleiben: Die Ersetzung geschieht in den rohen Bytes, und die Quoting-Regel von YAML selbst entscheidet dann über den Typ des Werts, sodass ein Verweis ohne Anführungszeichen den natürlichen Typ des Werts ergibt und ein Verweis in Anführungszeichen einen String.
Ein Verweis, der einen Schlüssel benennt, den das Release nicht geliefert hat, ist nicht dieser Abbruch. Ein fehlender Schlüssel wird hier zu einem leeren Wert aufgelöst und mit seinem Typ und seinem Vertrag von den Parameterprüfungen abgefangen, die unter „Parameter type mismatch / contract violation (Parametertyp stimmt nicht überein / Vertragsverletzung)“ oben beschrieben sind. Was dieser Abbruch meldet, ist Text, den die Template-Engine überhaupt nicht verarbeiten konnte — ein nicht geschlossenes {{, ein falsch geschriebener Funktionsname, eine Pipeline, deren Stufen nicht zueinander passen. Einen Parameter über index zu lesen — {{ index .parameters "db_size" }} —, wenn das Release keinen solchen Parameter geliefert hat, ist ein Fehlschlag während der Ausführung, und dieser Abbruch transportiert ihn und benennt den Schlüssel: index bricht auf jeder Template-Oberfläche bei einem Map-Schlüssel ab, den die Map nicht enthält, wie „A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)“ unten beschreibt.
Text, der sich überhaupt nicht parsen lässt, wird unter Nennung des eigenen Pfads des Aggregate zurückgewiesen, weil diese Datei vorliegt, bevor irgendetwas sie liest. Ein Modul, das die Komposition importiert, wird eine Ebene tiefer auf dieselbe Weise ausgewertet, wobei sein Text aus dem Katalog gelesen wird, statt dem Build übergeben zu werden. Der Abbruch ist in beiden Fällen dieselbe Bedingung und trägt diesen Code; bei einem Modul nennt er außerdem den Import, dem er folgte, und die Datei, aus der der Text des Moduls gelesen wurde, und die mitgeführte Meldung nennt nur den Typ — die Position, die diese Meldung angibt, ist also eine Position im eigenen Text des Moduls, nicht im Aggregate, von dem Sie ausgegangen sind.
Ausgegebene Meldungen, für ein Template, das sich nicht parsen lässt, für denselben Fehler in einem Modul, das die Komposition importiert, und für ein Template, das während der Ausführung fehlschlägt:
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) (ungültiger Parameterverweis: Prüfen Sie, ob der Ausdruck {{ .parameters.* }} einen deklarierten Parameter benennt und sich als Go-Template parsen lässt (Aggregate, „Template-Parse-Fehler“)) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (ungültiger Parameterverweis: Prüfen Sie, ob der Ausdruck {{ .parameters.* }} einen deklarierten Parameter benennt und sich als Go-Template parsen lässt (Aggregate, Template-Parse-Fehler)) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (ungültiger Parameterverweis: Prüfen Sie, ob der Ausdruck {{ .parameters.* }} einen deklarierten Parameter benennt und sich als Go-Template parsen lässt (Aggregate, Template-Ausführungsfehler))
Der Text eines Aggregate hat eine einzige Wurzel, .parameters; ein Verweis über eine andere — {{ .values.app_token }} oder {{ $.values.app_token }} — liest daher nichts und schlägt während der Ausführung fehl. Der Grund beginnt dann mit der Nennung des gelesenen Verweises:
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>) (ungültiger Parameterverweis: Prüfen Sie, ob der Ausdruck {{ .parameters.* }} einen deklarierten Parameter benennt und sich als Go-Template parsen lässt (Aggregate, das Template liest einen Verweis, und der Text eines Aggregate definiert keine Wurzel außer .parameters; Template-Ausführungsfehler))
So beheben Sie es: Öffnen Sie das Aggregate und lesen Sie den zugrunde liegenden Grund, der die Position im Text und das fehlgeschlagene Konstrukt benennt. Prüfen Sie, dass jedes {{ sein }} hat, dass eine aufgerufene Funktion zu denen gehört, die die Oberfläche anbietet — die Parameterinterpolation bietet die Funktionen von Sprig und nichts anderes, daher ist der Helfer optional hier nicht verfügbar —, und dass die Stufen einer Pipeline akzeptieren, was die vorangehende Stufe erzeugt. Nennt der Grund einen Schlüssel, den index nicht gefunden hat, lesen Sie einen möglicherweise nicht gesetzten Parameter mit einem Punkt ({{ .parameters.db_size }}) oder über get oder hasKey von Sprig. Nennt er einen Verweis über eine andere Wurzel, deklarieren Sie den Wert als Parameter des Aggregate und lesen Sie ihn als {{ .parameters.<key> }}. Nennt er etwas, das Sie nie als Template gemeint haben — undefined variable "$json" aus einem n8n-Ausdruck oder eine Funktion, die nach einem Flowise-Knoten benannt ist —, enthält der Text eigene doppelte geschweifte Klammern, auch die eines Kommentars: Schreiben Sie jedes {{ darin als {{"{{"}}, wie Text mit eigenen doppelten geschweiften Klammern beschreibt.
The Release directory declares one Aggregate or Manifest twice (Das Release-Verzeichnis deklariert ein Aggregate oder ein Manifest zweimal)
Ein Release, dessen Referenz aggregate: oder manifest: eine reine Identität ist, wird aufgelöst, indem zuerst das eigene Verzeichnis des Release durchsucht wird, und diese Suche hat zwei Aggregates — oder zwei Manifests — mit demselben metadata.name gefunden. Eine Referenz per reiner Identität benennt eine Entität über diesen Namen, daher ist ein zweimal beanspruchter Name einer, für den das Verzeichnis keine Antwort geben kann.
Die Suche weist das Verzeichnis als Ganzes zurück, nicht nur den Namen, nach dem eine Referenz gefragt hat. Sie liest jedes Aggregate und jedes Manifest, das neben dem Release liegt, sodass auch ein kollidierendes Paar, das keine der beiden Referenzen benennt, den Build anhält: Das Verzeichnis ist mehrdeutig, unabhängig davon, ob dieses Release dasjenige war, das diese Entität gerade lesen wollte. Eine als Pfad geschriebene Referenz (./aggregate.yaml, ../shared/manifest.yaml) adressiert eine Datei statt einer Entität und wird ohne die Suche aufgelöst, sodass ein Release, dessen aggregate: und manifest: beide Pfade sind, sie nie ausführt.
Dies ist das Gegenstück im selben Verzeichnis zur Zurückweisung doppelter Identitäten im Katalog, und beide werden getrennt gemeldet, damit die Meldung das Verzeichnis nennt, in dem Sie sich befinden, und nicht eine Katalogebene, an die Sie womöglich nicht gedacht haben.
Ausgegebene Meldung:
duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (doppelte Aggregate/Manifest-Identität (metadata.name) im Release-Verzeichnis: Aggregate mehr als einmal deklariert)
mit Manifest anstelle von Aggregate, wenn zwei Manifests kollidieren.
So beheben Sie es: Geben Sie einer der beiden Entitäten einen anderen metadata.name, oder verschieben Sie sie aus dem Verzeichnis des Release. Zwei Releases, die tatsächlich verschiedene Aggregates mit demselben Namen bereitstellen, gehören in eigene Verzeichnisse; ein Release in eine benachbarte Datei zu kopieren, ohne umzubenennen, was es enthält, ist der übliche Weg, auf dem dies entsteht.
A Release’s aggregate: or manifest: reference resolves to nothing (Die Referenz eines Release lässt sich zu nichts auflösen)
Ein Release benennt ein Aggregate oder ein Manifest per reiner Identität, und auf keiner der Oberflächen, auf denen eine reine Identität nachgeschlagen wird, wurde eine Entität dieses Namens gefunden: im eigenen Verzeichnis des Release, im Katalog und in der Registry.
Ausgegebene Meldung, wenn nirgends etwas übereinstimmte:
aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (Aggregate/Manifest-Referenz nicht auflösbar: kein Aggregate dieses Namens im Release-Verzeichnis, im Katalog oder in der Registry)
Eine Datei im Verzeichnis des Release, die nicht indiziert werden konnte, ändert die Meldung, weil sie ändert, was sich ehrlich behaupten lässt. Eine solche Datei könnte die Entität gewesen sein, daher sagt die Meldung dies, statt eine Abwesenheit zu behaupten, die sie nicht feststellen kann, und enthält den Parse-Fehler, der ihr Lesen verhindert hat:
aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (Aggregate/Manifest-Referenz nicht auflösbar: Aggregate nicht gefunden; eine nicht parsbare Datei konnte nicht indiziert werden und ist es möglicherweise)
und wenn eine nicht parsbare Datei genau die ist, die die Referenz ausdrücklich benennt:
aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (Aggregate/Manifest-Referenz nicht auflösbar: Das benötigte Aggregate ist die nicht parsbare Datei)
So beheben Sie es: Wenn die Referenz tatsächlich fehlt, korrigieren Sie ihre Schreibweise — die Identität ist der metadata.name der Entität, nicht ihr Dateiname — oder fügen Sie die Entität dem Verzeichnis des Release oder dem Katalog hinzu, den der Build liest. Wenn die Meldung eine nicht parsbare Datei nennt, beheben Sie zuerst diese Datei: Ihr Parse-Fehler wird in der Meldung zitiert, und ihre Reparatur löst die Referenz oft in derselben Bearbeitung auf. Eine Referenz ./ oder ../ ist ein Pfad statt einer Identität und wird als solcher aufgelöst, sodass ein führender Punkt ändert, welchen der beiden Fehler Sie suchen.
A component is placed in more than one boundary (Eine Komponente ist in mehr als einer Boundary platziert)
Der Boundary-Baum eines Release platziert eine Komponente in zwei verschiedenen Boundaries. Die beiden Platzierungen werden weder zusammengeführt noch gewichtet, und das ist auch nicht möglich: Die Boundary einer Komponente entscheidet, wohin ihre Ausgabe geschrieben wird, in welchem Unterverzeichnis sie landet, welcher sync wave sie beitritt und welche Boundary-Annotationen und welche Boundary-Infra sie erbt — während ihre kantenbezogene Oberfläche uses: von einem separaten Durchlauf gelesen wird. Eine zweimal benannte Komponente würde ihren Ausgabeort aus der einen Platzierung und ihre kantenbezogene Konfiguration aus der anderen beziehen.
Eine Boundary platziert Komponenten auf drei Arten, und alle drei zählen. Eine Komponente direkt unter components: zu benennen, mit der ID, die sie nach abgeschlossener Komposition trägt, platziert sie. Sie innerhalb des eigenen components: eines Routing-Eintrags zu benennen, mit dem lokalen Namen, den sie innerhalb dieses Untermoduls trägt, platziert sie ebenfalls. Und ein ganzes Untermodul unter aggregates: hineinzurouten, platziert jede Komponente, die dieses Modul enthält. Daher deckt dieser Abbruch auch ein in zwei Boundaries geroutetes Untermodul ab, ein in eine Boundary geroutetes Modul, dessen darin verschachteltes Modul in eine andere geroutet ist, sowie eine Komponente, die in einer Boundary benannt wird, während das sie enthaltende Modul in eine andere geroutet ist.
Ein Modul in eine Boundary zu routen und zugleich eine seiner Komponenten unter derselben Boundary zu benennen, ist kein Konflikt — beide Platzierungen stimmen darin überein, wohin die Komponente gehört — und der Build gelingt. Eine ID, die unter einer Boundary zweimal geschrieben ist, ist selbst dort ein Konflikt: Ein Eintrag im components: der Boundary und ein Eintrag für dieselbe Komponente innerhalb des Routing-Eintrags der Boundary sind zwei Einträge, die Konfiguration für eine Komponente tragen, ohne dass zwischen ihnen gewählt werden könnte.
Jede fehlerhafte Platzierung wird gemeldet. Ein Release, das mehrere Komponenten doppelt platziert, bricht in einem einzigen Build mit einer solchen Meldung pro fehlerhaftem Eintrag ab, jede am Schlüssel des Eintrags, den sie beanstandet — mehrere davon zusammen sind also ein Build, der alles nennt, was er gefunden hat, und nicht ein Fehler, der mehrfach ausgegeben wird.
Die Platzierung, die eine Meldung als bereits wirksam nennt, ist nicht immer die zuerst in der Datei geschriebene. Die eigenen Einträge unter components: einer Boundary werden vor den Komponenten gelesen, die ihre Routing-Einträge benennen, und vor den Untermodulen, die sie routet, und eine Boundary wird vor den in ihr verschachtelten Boundaries gelesen; nebeneinander geschriebene Boundaries werden in der Reihenfolge gelesen, in der sie erscheinen. Stehen mehrere frühere Platzierungen im Konflikt, wird die zuerst gelesene genannt. Beide Stellen werden genannt, in welcher Reihenfolge sie auch auftreten, und keine wird über die andere gestellt.
Ausgegebene Meldung. Der Satz nennt die Regel; was folgt, nennt den fehlerhaften Eintrag, die Boundary, in der jede der beiden Platzierungen liegt, den Block, in dem jede geschrieben wurde, und die Datei, die beide enthält. Wenn ein Eintrag unter components: einer Boundary auf einen früheren Eintrag unter dem einer anderen Boundary trifft:
component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>") (Komponente in mehr als einer Boundary deklariert: Deklarieren Sie jede Komponente in genau einer Boundary (Release; im components-Block einer Boundary benannt, während sie bereits im components-Block einer anderen Boundary benannt ist; beide in derselben Datei deklariert))
Die beiden Satzteile, die die Boundaries nennen, sind nach dem Block formuliert, in dem jeder Eintrag geschrieben wurde. Der fehlerhafte Eintrag erhält einen der folgenden:
named in the components block of boundary "<boundary>" — die eigene Map components: der Boundary;
named inside a routing entry in boundary "<boundary>" — die Map components: eines Routing-Eintrags unter aggregates: dieser Boundary;
routed as a sub-module into boundary "<boundary>" — der Routing-Eintrag selbst.
Die frühere Platzierung erhält, im selben Satz fortgesetzt, einen der folgenden:
while it is already named in the components block of boundary "<boundary>";
while it is already named inside a routing entry in boundary "<boundary>";
while it is already placed by a sub-module routed into boundary "<boundary>".
Die beiden Satzteile werden unabhängig voneinander gewählt, sodass jede Kombination auftreten kann, und that earlier entry naming trägt, was diese frühere Platzierung adressiert hat: die ID der Komponente oder das Präfix des Untermoduls, wenn ein geroutetes Untermodul sie platziert hat.
Wenn der fehlerhafte Eintrag selbst ein Routing-Eintrag ist, adressiert er ein Untermodul statt einer einzelnen Komponente, und die Meldung sagt dies, statt ein Modulpräfix als Komponentennamen darzustellen — hier beim Zusammentreffen mit einem früheren, in eine andere Boundary gerouteten Untermodul:
component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>") (Komponente in mehr als einer Boundary deklariert: Deklarieren Sie jede Komponente in genau einer Boundary (Release; Untermodul, als Untermodul in eine Boundary geroutet, während sie bereits durch ein in eine andere Boundary geroutetes Untermodul platziert ist; beide in derselben Datei deklariert))
So beheben Sie es: Löschen Sie diejenige der beiden Platzierungen, die Sie nicht beabsichtigt haben. Die Meldung nennt beide, daher liegt die Wahl bei Ihnen und nicht beim Compiler. Wenn eine direkte Deklaration und ein geroutetes Modul nicht übereinstimmen, entscheiden Sie, ob die Komponente zu ihrem Modul gehört oder für sich steht: Das Routen des Moduls platziert sie zusammen mit allem anderen, was das Modul enthält, und das direkte Benennen trennt sie davon. Wenn zwei Routing-Einträge ein Modul beanspruchen, entfernen Sie das nicht beabsichtigte Routing — das Routen eines Moduls in eine Boundary platziert jede darin enthaltene Komponente dort, sodass zwei solche Einträge dieselbe Menge von Komponenten beanspruchen.
A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Eine Annotationsbindung eines Manifest beansprucht das reservierte Präfix)
Ein Manifest deklariert eine Annotationsbindung unter einem Schlüssel, der mit dem bloßen Präfix aggrega.ai/ beginnt. Unter diesem Präfix stempelt der Build die Schlüssel, die er selbst ausgibt, daher würde eine Bindung, die einen Schlüssel darin beansprucht, Ihr Routing und die eigene Ausgabe der Plattform in einen gemeinsamen Schlüsselraum legen, in dem sie um dieselben Namen konkurrieren.
Der Build bricht ab, und es könnte kein Hinweis sein. Die Reservierung ist alles, was diesen Schlüsselraum zu dem der Plattform macht; die Bindung zuzulassen und sie danach zu erwähnen, würde die Kollision im Build belassen.
Die Regel betrifft den Schlüsselraum, den eine verfasste Bindung beansprucht, daher wird ein Schlüssel, für den das vorgelegte Manifest keine Bindung deklariert, übergangen statt gemeldet — es gibt keine Bindung, die gegen sie verstoßen könnte.
Ausgegebene Meldung. Der fehlerhafte Schlüssel steht vorn, weil es in dem Satz um ihn geht, und die Werte danach werden jeweils durch das eingeleitet, was sie sind:
manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/") (Annotationsbindung des Manifest verwendet ein reserviertes Präfix (Manifest; reserviertes Präfix; Routing zu einem Feature; verfassen Sie die Bindung unter einer eigenen Domain))
So beheben Sie es: Benennen Sie den Bindungsschlüssel in einen Namespace um, den Sie kontrollieren. Ein Schlüssel mit Unterpräfix ist die unterstützte Form und ist nicht reserviert: feature.aggrega.ai/… für eine Abkürzung der Standardbibliothek oder Ihre eigene Domain — acme.aggrega.ai/…, compliance.example.com/… — für eine unternehmenseigene. Das Umbenennen des Schlüssels ändert, was ein Autor auf eine Komponente schreibt, um die Bindung auszulösen, aktualisieren Sie daher die Annotationen, die ihn verwenden, in derselben Bearbeitung. Die eigenen Schlüssel der Plattform unter dem bloßen Präfix sind in ../providers/well-known-annotations.md aufgeführt.
Two Manifest annotation bindings compete for one routing slot (Zwei Annotationsbindungen eines Manifest konkurrieren um einen Routing-Slot)
Zwei Annotationsbindungen in einem Manifest routen zum selben Feature, über dieselbe Säule, an denselben Pfad. Die Aufgabe einer Bindung ist es anzugeben, wo der Wert einer Annotation landet, und zwei Bindungen, die ein Ziel nennen, lassen dem Wert zwei Routen und nichts, um bei der Expansion zwischen ihnen zu wählen.
Nur eine Bindung darf ein bestimmtes Paar aus Pfad und Säule pro Ziel-Feature deklarieren. Zwei Bindungen, die dasselbe Feature an verschiedenen Pfaden ansteuern, sind gewöhnliches Authoring, und der Build gelingt; ebenso zwei Bindungen, die denselben Pfad zu zwei verschiedenen Features routen.
Die Bindungen werden in der Reihenfolge durchlaufen, in der das Manifest sie deklariert, daher ist die Bindung, die eine Meldung zuerst nennt, immer die frühere in Ihrem Dokument.
Ausgegebene Meldung:
manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature) (Annotationsbindungen des Manifest kollidieren auf demselben Feature-Pfad+Säule (Manifest; die Annotationsbindungen zielen beide auf das Feature mit einem Pfad, der zur Säule routet; nur eine Bindung darf ein bestimmtes Paar (Pfad, Säule) pro Feature deklarieren))
So beheben Sie es: Entscheiden Sie, welche Bindung das Ziel besitzt, und entfernen Sie den Pfad aus der Liste maps.infra oder maps.values der anderen, oder verwerfen Sie die zweite Bindung ganz. Wenn die beiden Bindungen existieren, weil Sie zwei Annotationsschlüssel ein Feature-Feld erreichen lassen wollten, behalten Sie eine Bindung und lassen Sie beide Annotationsschlüssel über sie routen; wenn sie existieren, weil zwei verschiedene Werte an zwei Stellen landen sollten, korrigieren Sie den versehentlich geschriebenen Pfad.
A Release reached resolution without passing through the load path (Ein Release hat die Auflösung erreicht, ohne den Ladepfad zu durchlaufen)
Ein Release kam bei der Auflösung sowohl mit einer nicht leeren Oberfläche components: auf oberster Ebene als auch mit einer synthetisierten Boundary default an. Diese Kombination kann nicht von einem normal geladenen Release erzeugt werden: Der Ladepfad überführt einen Block components: der obersten Ebene in die Standard-Boundary und leert ihn, und ein Dokument, das beides ausdrücklich verfasst hat, wird von seinem Schema zurückgewiesen, bevor es so weit kommt.
Dieser Abbruch meldet also nichts, was Sie geschrieben haben. Er meldet, dass etwas die Auflösung am Ladepfad vorbei erreicht hat — meist ein Release, das von einem einbettenden Programm im Speicher erstellt statt aus einer Datei gelesen wurde — und hält dort an, statt einen Build auf einem Dokument fortfahren zu lassen, dessen zwei Komponentenoberflächen nicht übereinstimmen. Sie in der einen oder anderen Reihenfolge zu lesen, würde eine Ausgabe erzeugen, die Komponenten stillschweigend auslässt oder dupliziert, und der Boundary-Durchlauf und der kantenbezogene Durchlauf wären sich nicht einmal untereinander einig, welche.
Ausgegebene Meldung:
release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal (Release hat die Auflösung unnormalisiert erreicht (nicht leere Wurzelkomponenten neben einer synthetisierten Standard-Boundary): Erstellen Sie Releases über den Normalisierungskern (types.NormalizeRelease über den Ladepfad), nicht als von Hand gebautes Literal)
So beheben Sie es: Nichts, wenn Sie YAML verfassen — erreicht man diesen Abbruch aus aggrega build, aggrega validate oder dem Editor, hat der Compiler einen meldenswerten Defekt, und das Release, das Sie gebaut haben, ist nicht schuld. Wenn Sie den Compiler einbetten und in Ihrem eigenen Code einen Release-Wert erstellen, erstellen Sie ihn über den Ladepfad, statt die Struct direkt zusammenzusetzen, damit die Normalisierung läuft, die die Wurzelkomponenten in die Standard-Boundary überführt.
A library reference expands into itself (Eine Bibliotheksreferenz expandiert in sich selbst)
Eine dokumentübergreifende Referenzkette kehrt zu einem Dokument zurück, das sie bereits erreicht hat, sodass ihre Expansion nie enden würde. Zwei Authoring-Oberflächen erreichen dieselbe Bedingung, und beide sind Ketten zwischen Bibliotheksentitäten statt etwas innerhalb einer Datei: ein $ref: aus einer Schema-Säule in einen SchemaLibrary-Eintrag, der über Referenzen zurückführt, und ein $import: in einen MappingLibrary- oder WorkloadLibrary-Eintrag, der dasselbe tut.
Die Kette wird anhand eines kanonischen Schlüssels verglichen — der Identität der Bibliothek und dem Namen des Eintrags, ohne Registry-Host und Versionsschreibweise —, sodass ein Zyklus der Prüfung nicht entgehen kann, indem er denselben Eintrag entlang seines Weges auf zwei verschiedene Arten benennt. Eine Referenz, die expandiert und endet, ist in Ordnung, wie oft sie auch vorkommt und wie tief die Kette auch reicht; Tiefe allein verursacht diesen Abbruch nie, und die Wiederverwendung eines Bibliothekseintrags an vielen Stellen ist das Muster, für das Bibliotheken existieren.
Ausgegebene Meldung für eine Kette $import:, die die gesamte Schleife in der Reihenfolge nennt, in der sie durchlaufen wurde, damit Sie sehen, welcher Schritt sie schließt:
Eine Kette $ref: wird stattdessen vom Compiler der kompakten Form gemeldet, der sie mit dem Dokument und dem Schlüsselwort einrahmt, das er gerade las:
So beheben Sie es: Lesen Sie die Kette in der Meldung und unterbrechen Sie sie an dem Schritt, der nicht beabsichtigt war. Ein Zyklus bedeutet meist, dass zwei Bibliothekseinträge jeweils so geschrieben wurden, dass sie den anderen erweitern; fassen Sie den gemeinsamen Teil in einem dritten Eintrag zusammen, auf den beide verweisen, oder fügen Sie ihn in einen der beiden ein. Der zuletzt gezeigte Schritt ist der, der die Schleife geschlossen hat, aber nicht unbedingt der falsche — die gesamte Kette wird genau deshalb ausgegeben, weil die Entscheidung, welches Glied zu kappen ist, bei Ihnen liegt.
Dieselbe Bedingung steht auch hinter der Zurückweisung von Anker-Rekursion, die oben unter „YAML anchor aliased inside its own content (YAML-Anker, der innerhalb seines eigenen Inhalts per Alias referenziert wird)“ dokumentiert ist. Jene ist eine Schleife innerhalb des eigenen Textes eines einzelnen Dokuments; diese ist eine Schleife zwischen Dokumenten. Die Kette in der Meldung unterscheidet beide auf einen Blick: Eine Schleife zwischen Dokumenten nennt Bibliothekseinträge, und eine Schleife innerhalb eines Dokuments nennt einen Anker.
A declared schema cannot be resolved (Ein deklariertes Schema kann nicht aufgelöst werden)
Ein Schema erreichte den Punkt, an dem es zur Validierung von etwas verwendet werden sollte, und konnte überhaupt nicht zu einem Schema zusammengesetzt werden. Die häufigste Ursache ist ein $ref:, das nichts Auflösbares benennt; ein Schema, das das Meta-Schema von JSON Schema nicht erfüllt, führt zum selben Abbruch, ebenso ein Zweig then: oder else: unter einem bedingten Schlüsselwort, der für sich allein nicht aufgelöst werden kann.
Die Zurückweisung erfolgt, bevor irgendetwas gegen das Schema validiert wird, und genau auf diese Reihenfolge kommt es an. Ein unlesbares Schema zu übergehen, würde alles, was es abdeckt, unvalidiert lassen, während der Build Erfolg meldet — eine Prüfung, die aufgehört hat zu laufen, ohne dass etwas sagt, dass sie aufgehört hat.
Ausgegebene Meldung, die die Position innerhalb des Schemas, das nicht auflösbare Schlüsselwort und das von der Auflösung Gemeldete nennt:
Liegt der Fehler an der Wurzel des Schemas statt an einem Schlüsselwort darin, werden Position und Schlüsselwort weggelassen, und der Satz enthält nur den gemeldeten Grund.
So beheben Sie es: Öffnen Sie das Schema an der Position, die die Meldung nennt. Ein $ref: ist der übliche Verursacher: Prüfen Sie, dass das Ziel existiert, dass eine dokumentinterne Referenz ihren Pfad #/$defs/… exakt schreibt und dass eine dokumentübergreifende Referenz einen SchemaLibrary-Eintrag nennt, den die Abhängigkeitshülle des Builds tatsächlich enthält. Nennt die Meldung einen Zweig then: oder else:, ist dieser Zweig ein eigenständiges Schema und muss für sich allein auflösbar sein.
An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Ein Prädikat kann nicht ausgewertet werden)
Ein Schema deklariert eines der beiden Erweiterungs-Schlüsselwörter mit Template-Wert, und das Template konnte nicht verwendet werden: Es ist kein String, es lässt sich nicht als Template parsen, es ist bei der Ausführung fehlgeschlagen, oder es hat etwas anderes als true oder false gerendert.
x-aggrega-when: entscheidet, ob ein bedingter Zweig eines Schemas gilt; x-aggrega-validate: entscheidet, ob ein Wert eine Regel erfüllt, die die eigenen Schlüsselwörter des Schemas nicht ausdrücken können. Beide werden als Urteile gelesen, weshalb ein Ergebnis, das keines ist, zurückgewiesen statt interpretiert wird: Ein Prädikat, das einen leeren String rendert, würde als falsch gelesen und die Regel, deren Durchsetzung es dienen sollte, stillschweigend außer Kraft setzen.
mit "x-aggrega-when" anstelle des Schlüsselworts, wenn das Prädikat der Bedingung fehlerhaft ist, und mit einem gemeldeten Grund, der den Template-Fehler benennt — eine Parse-Position, eine fehlende Funktion oder den Nicht-Boolean-Wert, den das Template erzeugt hat.
So beheben Sie es: Öffnen Sie das Schema an der Position, die die Meldung nennt, und lesen Sie den gemeldeten Grund. Prüfen Sie, dass der Wert des Schlüsselworts ein String ist, dass sich das Template parsen lässt und dass jeder Pfad, den es durchläuft, im zu validierenden Wert tatsächlich vorhanden ist — ein Prädikat liest den Wert als .value, und auf etwas anderes zuzugreifen ist der häufigste Fehler. Nennt der Grund einen Schlüssel, den index nicht gefunden hat, prüfen Sie den Schlüssel stattdessen mit hasKey oder lesen Sie ihn mit get: index bricht bei einem Map-Schlüssel ab, den die Map nicht enthält, wie unten unter „A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)“ beschrieben. Stellen Sie sicher, dass das Template mit der Ausgabe von true oder false endet: Ein Vergleich tut das, ein Template, das lediglich den Wert rendert, nicht.
A Workload does not satisfy the Workload schema (Eine Workload erfüllt das Workload-Schema nicht)
Der workload:-Block einer Recipe oder eines FeatureRecipe wurde gelesen und gegen das Workload-Schema geprüft, und ein oder mehrere Felder erfüllen es nicht — ein falsch geschriebener Schlüssel, ein Wert des falschen Typs, ein ausgelassenes Pflichtfeld, ein Wert außerhalb eines deklarierten Bereichs oder einer deklarierten Aufzählung.
Die Meldung ist gruppiert: Ein Abbruch enthält jedes fehlerhafte Feld, sodass eine Workload mit vier Fehlern Ihnen alle vier in einem Build meldet statt einen pro Build. Die Kopfzeile nennt die Workload, die Recipe, die sie deklariert, und die Datei; jeder Befund darunter nennt den Feldpfad innerhalb der Workload, was das Schema dort verlangt hat, und die Korrektur, sofern sich eine angeben lässt.
Ausgegebene Meldung:
workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated>.initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated> (Validierung der Arbeitslast fehlgeschlagen (Workload in Recipe, Schema-Phase))
Ein Fehler ohne Detail pro Feld — der Block konnte gar nicht gelesen werden, statt gelesen und für unzureichend befunden zu werden — enthält stattdessen den gesamten Grund als einzigen Befund.
Wenn das workload:-Template einen als sensibel deklarierten Wert liest, zitiert kein Befund einen Wert. Welches Feld des gerenderten Dokuments aus diesem Wert stammt, lässt sich nicht feststellen, daher gibt jeder Befund, dessen Text einen Wert enthalten könnte, die Einschränkung des Schemas mit <redacted> an der Stelle des Werts an, abgeschlossen durch einen Hinweis, der den Grund nennt, und enthält keine aus dem Wert abgeleitete Korrektur:
.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)
Ein Befund, der keinen Wert zitiert — ein fehlender Schlüssel, ein Schlüssel, den die Workload nicht zulässt —, liest sich wie bei jedem anderen Template. Siehe vocabulary/compact-form-authoring.md „Was eine Zurückweisung über einen deklarierten Wert aussagt“.
Der Build meldet den Abbruch unter einem CATALOG_ERROR-Tag, weil ein workload:-Block vom Autor der Recipe geschrieben wird und nicht vom Aggregate oder vom Release.
So beheben Sie es: Öffnen Sie die Recipe an den aufgeführten Feldpfaden und korrigieren Sie jeden einzelnen. Die Pfade sind ab der eigenen Wurzel der Workload angegeben, sodass .containers.main.health.ready der ready-Block unter dem health-Schlüssel des Containers main ist. Ein benannter Container wird über seinen Schlüssel angesprochen und ein Init-Container über seine Position, weshalb sich die beiden unterschiedlich lesen. Was jedes Feld akzeptiert, steht in der Workload-Authoring-Referenz.
Ein Feld, das das Schema als Text erwartet und das zurückgewiesen wird, weil der Wert eine Zahl oder ein Boolean ist, bedeutet fast immer einen Template-Ausdruck ohne Anführungszeichen. Ein workload:-Block wird gerendert, bevor er geprüft wird, sodass ein ohne Anführungszeichen geschriebener Ausdruck zu nacktem Text expandiert und YAML diesen Text dann als das liest, wonach er aussieht. Eine Größenangabe in ganzen Cores, eine nur aus Ziffern bestehende Version, ein Port und die Wörter yes, no, on und off werden alle als etwas anderes als Text gelesen. Der Befund nennt, welchen Typ YAML gelesen hat, und die Abhilfe besteht darin, den Ausdruck in der Recipe in Anführungszeichen zu setzen — cpu: "{{ .infra.compute.cpu }}" statt cpu: {{ .infra.compute.cpu }} —, damit der Wert Text bleibt, was auch immer der Operator liefert. Beachten Sie, dass der Wert des Operators hier nicht fehlerhaft ist und es nichts ändert, ihn im Release in Anführungszeichen zu setzen: Die Anführungszeichen müssen in der Recipe stehen, um den Ausdruck herum.
A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Eine Workload-Anbindung nennt einen Slot, den die Entität nicht deklariert, oder eine Bereitstellung, die der Slot verbietet)
Ein attachments:-Eintrag eines Containers innerhalb eines workload:-Blocks verweist auf einen Anbindungs-Slot, und der Verweis stimmt nicht mit den Slots überein, die die Component oder das Feature im jeweiligen featuresSchema deklariert — oder, bei einem Eintrag, der mit connection: eine Verbindung nennt, mit den Slots, die der Socket dieser Verbindung deklariert. Ein envFrom-Eintrag, der eine Verbindung nennt, unterliegt denselben Verbindungsregeln. Der Befund nennt, welche dieser Formen vorliegt.
Der Slot ist nicht deklariert. Das from: des Eintrags nennt einen Slot, den das featuresSchema der Entität nicht enthält — ein Tippfehler oder ein Slot, der nur auf einer Seite umbenannt wurde.
Der Slot ist eine Blackbox. Der Slot deklariert eine leere inject:-Allowlist, die die Bereitstellung der internen Mechanik der Recipe selbst vorbehält. Ein solcher Slot wird intern befüllt und verbraucht, sodass eine Workload nicht auf ihn zugreifen kann.
Die Bereitstellung liegt außerhalb der Allowlist des Slots. Das as: des Eintrags nennt einen Mechanismus, den die inject:-Liste des Slots nicht erlaubt.
Die Verbindung ist keine, die die Komponente zieht. Das connection: des Eintrags nennt einen Alias, unter dem keine Verbindung der Komponente geschrieben ist.
Der Socket der Verbindung deklariert den Slot nicht. Das from: des Eintrags (oder, bei envFrom, secret:) nennt einen Slot, den der Socket, über den diese Verbindung verdrahtet ist, nicht deklariert.
Der Slot ist mit seinem zusammengesetzten Namen geschrieben. Das from: (oder secret:) des Eintrags ist der Name, den die Anbindung einer Verbindung an der Komponente annimmt — der Alias, ein Punkt und der Slot —, geschrieben ohne connection:. Der Slot einer Verbindung wird nur erreicht, indem die Verbindung genannt wird.
Jeder fehlerhafte Eintrag über alle Container hinweg wird gemeinsam gemeldet, sodass ein Build sie alle nennt. Die Befunde sind unter einer Kopfzeile gruppiert, die die Workload, ihre Recipe und die Datei nennt.
Ausgegebene Meldung:
workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage): .containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot .containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended .containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema .containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments .containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema .containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot> (featuresSchema-Abgleich der Arbeitslast fehlgeschlagen (Workload in Recipe, featuresSchema-Phase): verweist auf einen Slot, der im featuresSchema der Component nicht deklariert ist — deklarieren Sie den Slot im featuresSchema von Component (oder Feature), oder benennen Sie den Verweis in einen vorhandenen Slot um; der Slot ist eine Blackbox (keine Allowlist) und kann nicht aus einem attachments-Eintrag einer Workload referenziert werden — Blackbox-Slots werden durch Recipe-interne Mechanik bereitgestellt; entfernen Sie den Verweis auf Workload-Seite, oder erweitern Sie die inject-Allowlist des Slots, wenn eine Bereitstellung auf Workload-Seite beabsichtigt ist; der Bereitstellungsmechanismus ist für den Slot nicht zulässig (inject-Allowlist) — verwenden Sie einen der zugelassenen Bereitstellungsmechanismen, oder erweitern Sie die inject-Allowlist des Slots im featuresSchema von Component/Feature; nennt eine Verbindung für den Slot, aber die Komponente zieht unter diesem Alias keine Verbindung — nennen Sie eine Verbindung, die die Komponente zieht, oder entfernen Sie connection, um einen Slot zu lesen, den die Component für ihre eigenen Anbindungen deklariert; nennt einen Slot der Verbindung, den der Socket nicht deklariert — nennen Sie einen Slot, den der Socket deklariert, oder deklarieren Sie den Slot im featuresSchema dieses Sockets; nennt den Namen, den der Compiler für einen Slot einer Verbindung zusammensetzt; ein Slot, den der Socket einer Verbindung deklariert, wird benannt, indem die Verbindung genannt wird — schreiben Sie connection: neben from:)
Bei einem envFrom-Eintrag stehen dieselben Befunde unter .containers.<name>.envFrom[<i>].connection und .containers.<name>.envFrom[<i>].secret.
So beheben Sie es: Jeder Befund nennt beide Seiten, die Wahl besteht also darin, welche Seite zu ändern ist. Bei einem nicht deklarierten Slot korrigieren Sie die Schreibweise von from: oder deklarieren den Slot im featuresSchema der Entität — das Suffix .from des Feldpfads zeigt auf den Verweis. Bei einem Blackbox-Slot entfernen Sie den Verweis auf Workload-Seite und lassen die Recipe das Material bereitstellen, es sei denn, eine Bereitstellung auf Workload-Seite ist wirklich gewünscht; in diesem Fall geben Sie dem Slot eine inject:-Allowlist. Bei einem zurückgewiesenen Mechanismus stellen Sie as: auf einen um, den die Allowlist nennt, oder fügen Ihren hinzu. Bei einer Verbindung, die die Komponente nicht zieht, korrigieren Sie den Alias auf einen, den der Befund aufführt, oder ziehen die Verbindung im Aggregate oder im Release. Bei einem Slot, den der Socket nicht deklariert, nennen Sie einen der Slots, die der Befund aufführt, oder deklarieren den Slot im featuresSchema des Sockets an der Component. Bei einem zusammengesetzten Namen schreiben Sie die Verbindung und den Slot getrennt, wie der Befund zeigt.
A Workload references a slot whose fill publishes no locator (Eine Workload verweist auf einen Slot, dessen Befüllung keinen Lokator veröffentlicht)
Ein attachments:-Eintrag eines Containers nennt einen Slot per Verweis, und die Anbindung, die diesen Slot befüllt, veröffentlicht nicht die provides-Schlüssel, die ein solcher Verweis liest. Auf einen Slot per Namen zu verweisen bedeutet, zu verlangen, dass die Ressource, für die er steht, in der gerenderten Ausgabe adressiert wird — über den Namen der Ressource und über das Feld darin. Eine Befüllung, die keines von beiden veröffentlicht, hat keinen Lokator, auf den gezeigt werden kann, sodass der Verweis in nichts umgesetzt werden kann.
Welche Schlüssel erforderlich sind, hängt vom Eintrag ab, und der Befund nennt, welche er erwartet hat. Ein Eintrag, der seinen eigenen key: nennt, liefert das Feld selbst, sodass nur der name der Ressource veröffentlicht sein muss — und genau das erlaubt ihm, auf eine Ressource mit mehreren Schlüsseln zu verweisen. Ein Eintrag, der keinen key: nennt, liest das einzige veröffentlichte Feld des Slots, sodass sowohl name als auch key vorhanden sein müssen.
Die Prüfung liest nur, ob die Schlüssel vorhanden sind; ihre Werte untersucht sie nie. Jeder fehlerhafte Eintrag wird gemeinsam gemeldet, unter einer einzigen Kopfzeile.
Ausgegebene Meldung:
workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage): .containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference (Anbindungs-Slot der Arbeitslast ist nicht referenzierbar (Workload in Recipe, slotReferenceability-Phase): Der Slot ist nicht referenzierbar: Seine aufgelösten provides stellen den Schlüssel nicht bereit (ein Anbindungsverweis einer Arbeitslast liest die provides-Schlüssel name und key) — verweisen Sie auf einen Slot, der von einer Anbindung befüllt wird, deren schema.provides die Schlüssel deklariert, die dieser Verweis liest, oder stellen Sie ihn über den inject-Kanal des Slots statt über einen Arbeitslast-Verweis bereit)
So beheben Sie es: Zwei Richtungen, und welche richtig ist, hängt davon ab, was Sie gemeint haben. Ist der Verweis korrekt, muss die Anbindung geändert werden, die den Slot befüllt: Binden Sie ein Feature an, dessen schema.providesname deklariert — und key, sofern der Eintrag keinen eigenen nennt —, damit es einen Lokator gibt, auf den gezeigt werden kann. Sollte das Material nie per Namen in der Ausgabe adressiert werden, entfernen Sie den Verweis und stellen Sie es stattdessen über den inject:-Kanal des Slots bereit, der den Wert selbst transportiert statt eines Zeigers darauf, wo er liegt.
A container gives one environment variable two values (Ein Container gibt einer Umgebungsvariable zwei Werte)
Ein Container eines workload:-Blocks nennt dieselbe Umgebungsvariable zweimal: einmal als Schlüssel seiner variables und einmal als Schlüssel eines attachments-Eintrags, der as: env zugestellt wird. Geprüft werden sowohl ein Hauptcontainer als auch ein Init-Container, und zwar gleichermaßen in der Workload, die das Recipe einer Komponente rendert, wie in der Workload, die ein FeatureRecipe rendert — in einem an eine Komponente angebundenen ebenso wie in einem an einer Boundary deklarierten —, und die Prüfung liest die Workload so, wie ihr Template sie gerendert hat.
Warum der Build abbricht, statt einen der beiden zu wählen. Die Umgebung eines Containers wird aus diesen beiden Sammlungen in einer festen Reihenfolge geschrieben — die Provider helm und compose schreiben zuerst jeden aus einer Anbindung gelesenen Eintrag und danach die einfachen variables. Ein auf beide Arten geschriebener Name würde den Prozess daher mit dem Wert erreichen, den diese Reihenfolge gewinnen lässt, was eine Folge davon ist, wo die beiden Typen landen, und nicht von etwas, das Sie geschrieben haben; deshalb weist der Build das Paar zurück, statt es zu rendern. Die Prüfung läuft einmal, gleich welcher Provider die Workload rendert, nach den übrigen Prüfungen der Workload und bevor die artifacts:-Einträge ausgewertet werden oder irgendein Provider die Workload erhält, sodass ein zurückgewiesenes Paar nie gerendert wird. Ein attachments-Eintrag, der as: file zugestellt wird, wird als Datei eingehängt, statt in der Umgebung gesetzt zu werden, und bildet daher nie ein Paar.
Die Prüfung vergleicht nur Namen; sie liest nie einen Wert, daher zitiert kein Befund einen. Zwei Typen von Umgebungseinträgen liegen außerhalb dessen, was sie vergleicht: Ein envFrom-Eintrag setzt die Schlüssel der ConfigMap oder des Secret, die er nennt, und diese sind beim Lauf des Builds nicht bekannt; und ein Eintrag, den ein Pipeline-Schritt in ein gerendertes Dokument schreibt, ist nicht Teil der Workload, die die Prüfung liest.
Jedes Paar ist ein eigener Befund, positioniert am workload:-Schlüssel des Recipe oder FeatureRecipe, das die Workload deklariert, und nennt die Variable und den Container — einen Hauptcontainer über seinen Schlüssel, einen Init-Container über seine Stelle in der initContainers-Liste. Die Befunde kommen zuerst für die Hauptcontainer in der Reihenfolge, in der sie geschrieben sind, dann für die Init-Container nach Position, und innerhalb eines Containers in der Reihenfolge, in der seine attachments-Einträge geschrieben sind.
Ausgegebene Meldung für ein Paar in einem Hauptcontainer der Workload eines Recipe. Die Kategorie und der Kurzcode dieser Bedingung, E0345, erreichen Sie in der Kopfzeile in eckigen Klammern, und die Position lautet <path> at .spec.workload:
a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders (ein Container deklariert eine Umgebungsvariable zweimal. Benennen Sie eine der beiden um, oder schreiben Sie sie unter komplementäre Template-Bedingungen, sodass nur eine von ihnen gerendert wird)
Ein Paar in einem Init-Container nennt stattdessen seine Stelle in der Liste — init container "initContainers[<i>]" —, und der Befund eines FeatureRecipe nennt nach dem Container die Anbindung, die es bindet, attachment "<attachment>", weil eine Komponente mehrere Anbindungen tragen kann, deren FeatureRecipes getrennte Dokumente sind.
Trägt eine Workload mehrere Paare, werden die Befunde unter einer Zeile gruppiert, die das Dokument nennt: containers of the Workload this Recipe renders name one environment variable twice oder, für ein FeatureRecipe, containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice.
Der Build meldet den Abbruch unter einem CATALOG_ERROR-Tag, weil ein workload:-Block vom Autor des Recipe oder FeatureRecipe geschrieben wird und nicht vom Aggregate oder vom Release.
So beheben Sie es: Entscheiden Sie, welche der beiden der Container erhalten soll. Wenn beide gewünscht sind, benennen Sie eine von ihnen um, sodass der Prozess zwei Variablen sieht. Wenn sie Alternativen sind — etwa ein einfacher Rückfallwert für den Fall, dass keine Zugangsdaten angebunden sind —, schützen Sie sie mit komplementären Bedingungen, sodass genau eine gerendert wird: Schreiben Sie die Variable unter {{ if not (hasKey (default dict .features) "<slot>") }} und den attachments-Eintrag unter {{ if hasKey (default dict .features) "<slot>" }}, oder unter die beiden Zweige eines einzigen {{ if }}/{{ else }}. Ein so geschütztes Paar erreicht die Prüfung nie, weil nur eines der beiden in der gerenderten Workload steht.
A Release’s parameters: block is written in neither of its two shapes (Der Parameter-Block eines Release ist in keiner seiner beiden Formen geschrieben)
Ein Release erfüllt die Parameter, die ein Aggregate deklariert hat, auf eine von zwei Arten, und der Block wird anhand seiner Form gelesen. Entweder ist er ein Mapping von Parameternamen auf direkt geschriebene Werte, oder er ist ein Mapping mit genau einem Schlüssel, $import:, dessen Wert der Pfad einer YAML-Datei ist, die diese Werte enthält. Ein Block, der keines von beidem ist, wird beim Lesen zurückgewiesen, bevor irgendetwas die Werte mit den Deklarationen des Aggregate abgleicht.
Drei Formen werden zurückgewiesen. Ein parameters:-Wert, der überhaupt kein Mapping ist — ein Skalar oder eine Liste. Ein Mapping, das $import: neben anderen Schlüsseln trägt, was die importierten und die geschriebenen Werte zugleich verlangt und keine Regel angibt, wie sie zu kombinieren sind. Und ein $import:, dessen Wert keine einfache Zeichenkette ist und damit keine Datei nennt.
Das Release-Schema deklariert dieselben beiden Formen, sodass eine Release-Datei mit einer dieser drei zuerst auf die Prüfung der Dokumenthülle trifft, unter E0215, die beide Formen ausprobiert und angibt, warum jede gescheitert ist — hier für eine Liste:
document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema (Validierung der Dokumenthülle fehlgeschlagen (Release); spec.parameters: kein oneOf-Zweig passt (2 Zweige versucht): branch[0]: type: object erwartet, array erhalten; branch[1]: type: object erwartet, array erhalten. Korrigieren Sie das Dokument so, dass es dem Schema seines Typs entspricht)
Für $import: neben einem anderen Schlüssel endet der zweite Zweig mit additionalProperties: unexpected property: "<key>", und für ein $import:, das als Liste statt als Zeichenkette geschrieben ist, endet er mit validation: type: array has type "array", want "string".
Ausgegebene Meldung, wenn der Wert kein Mapping ist, mit der Angabe, was dort geschrieben wurde — zum Beispiel a list:
parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: die Form muss ein Inline-Objekt oder {$import: lokaler Pfad} sein: in der genannten Zeile steht ein Wert, wo ein Mapping erwartet wird)
und wenn $import: das Mapping mit etwas anderem teilt oder etwas nennt, das kein Pfad ist:
parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> (parameters: die Form muss ein Inline-Objekt oder {$import: lokaler Pfad} sein: $import muss der einzige Schlüssel sein, in der genannten Zeile stehen mehrere Schlüssel) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (parameters: die Form muss ein Inline-Objekt oder {$import: lokaler Pfad} sein: der Wert von $import muss in der genannten Zeile ein Zeichenketten-Skalar sein)
So beheben Sie es: Öffnen Sie das Release in der Zeile, die die Meldung nennt. Schreiben Sie die Werte direkt unter parameters:, oder ersetzen Sie den ganzen Block durch einen einzigen $import:-Eintrag, dessen Wert ein Pfad in Anführungszeichen ist. Wenn Sie geschriebene Werte und eine importierte Datei mit gemeinsamen Standardwerten wollten, verschieben Sie die geschriebenen in ein Release, das per extends: auf dem Release mit dem Import aufbaut — mehrere Parameterquellen zu schichten ist der Zweck einer extends:-Kette, und dieser eine Schlüssel wird bewusst aus einer einzigen Quelle gelesen.
An inline-or-import field is written in neither shape (Ein Inline-oder-Import-Feld ist in keiner der beiden Formen geschrieben)
Drei Felder, die ein Recipe oder FeatureRecipe schreibt — ein artifacts.<name>:-Eintrag, ein valuesMapping: und ein workload: —, akzeptieren dieselben beiden Formen. Entweder wird der Inhalt direkt geschrieben, als Zeichenketten-Skalar (ein |-Block ist die übliche Schreibweise für alles Mehrzeilige), oder der Wert ist ein Mapping mit genau einem Schlüssel, $import:, der stattdessen nennt, wo der Inhalt liegt. Was ein $import: nennen darf, hängt vom Feld ab: Ein artifacts-Eintrag importiert einen lokalen Pfad oder ein Bundle aus einer ArtifactLibrary, während valuesMapping: und workload: einen lokalen Pfad oder einen Eintrag aus einer Bibliothek über deren Identität importieren.
Ein einziger Leser prüft alle drei, daher sind die Zurückweisungen dieselben drei, gleich welches Feld fehlerhaft ist: ein Mapping mit mehr als einem Schlüssel, ein Mapping, dessen einziger Schlüssel nicht $import ist, und ein $import:, dessen Wert keine einfache Zeichenkette ist. Ein Wert, der weder ein Skalar noch ein Mapping ist — meistens eine Liste —, wird allein aufgrund seiner Form zurückgewiesen.
Die Schemas von Recipe und FeatureRecipe deklarieren für jedes der drei Felder dieselben beiden Formen, sodass eine Datei mit einem dieser Fälle zuerst auf die Prüfung der Dokumenthülle trifft, unter E0215, die das Feld nennt und angibt, warum jede Form gescheitert ist — der erste Zweig ist die direkt geschriebene Form, der zweite die mit $import::
document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema (Validierung der Dokumenthülle fehlgeschlagen (Recipe); spec.artifacts: kein oneOf-Zweig passt (2 Zweige versucht): branch[0]: Validierung: type: object hat den Typ „object“, erwartet „string“; branch[1]: additionalProperties: unerwartete Eigenschaft. Korrigieren Sie das Dokument so, dass es dem Schema seines Typs entspricht)
Das ist ein Mapping, das neben $import: einen Schlüssel trägt. Ein einzelner Schlüssel, der nicht $import ist, endet mit required: missing required property: $import, additionalProperties: unexpected property: "<key>", eine Liste endet mit type: expected object, got array, und ein $import:, das keine Zeichenkette ist, nennt den Typ, der dort gefunden wurde, wo eine Zeichenkette erwartet wurde, wie in type: array has type "array", want "string".
Ausgegebene Meldungen. Jede beginnt mit dem Satz für das fehlerhafte Feld und gibt dann an, was der Leser gefunden hat und wo:
artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> (artifacts-Eintrag: die Form muss ein Zeichenketten-Skalar oder {$import: lokaler Pfad} sein: in der genannten Zeile stehen mehrere Schlüssel) valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: die Form muss ein Zeichenketten-Skalar oder {$import: Pfad oder Bibliotheksidentität} sein: in der genannten Zeile steht ein anderer Schlüssel) workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: die Form muss ein Zeichenketten-Skalar oder {$import: Pfad oder Bibliotheksidentität} sein: der Wert von $import muss in der genannten Zeile ein Zeichenketten-Skalar sein)
Jedes der drei Felder kann jedes dieser Enden melden; ein Wert, der keine der beiden Formen hat, endet mit line <line>: <shape> is written where text or a map is expected und nennt, was geschrieben wurde — meistens a list.
So beheben Sie es: Öffnen Sie die Entität in der Zeile, die die Meldung nennt. Schreiben Sie den Inhalt direkt als Block-Skalar, oder ersetzen Sie den ganzen Wert durch einen einzigen $import:-Eintrag. Ein Mapping, das $import: und irgendetwas anderes trägt, ist keine der beiden Formen — verschieben Sie die zusätzlichen Schlüssel in die importierte Datei, oder schreiben Sie den Inhalt direkt. Ein falsch geschriebenes $import — meistens fehlt das $ — wird als gewöhnlicher Schlüssel gelesen und als der einzelne Schlüssel gemeldet, der nicht $import ist.
A reference to a library entry carries whitespace (Ein Verweis auf einen Bibliothekseintrag enthält Leerraum)
Ein Verweis, der einen Eintrag in einer Bibliothek nennt, wird als ein einziges ununterbrochenes Token geschrieben: die Bibliothek, eine optionale Mindestversion :<version>, dann # und der Pfad des Eintrags — BaseWorkloads:1.0.0#/workloads/StatelessService. Kein Teil davon lässt Leerraum zu. Bibliotheksnamen und Eintragsnamen sind durch die Bibliotheksschemas beide auf Bezeichner-Schreibweisen beschränkt, und eine Version ist eine Version, daher gehört ein Leerzeichen, ein Tabulator oder ein Zeilenumbruch an beliebiger Stelle eines Verweises zu keinem der drei Teile.
Die Zurückweisung gilt für jede Oberfläche, die einen Bibliothekseintrag über seine Identität adressiert: ein valuesMapping:, ein workload: und ein artifacts.<name>:-Eintrag, jeweils als $import: geschrieben, sowie ein Schema-$ref:. Ein als $import: geschriebener lokaler Pfad enthält kein # und ist kein Verweis auf einen Bibliothekseintrag, daher bleibt ein Pfad mit einem Leerzeichen darin unberührt.
Was eine Zurückweisung statt einer Bereinigung rechtfertigt, ist, dass der vordere Teil eines solchen Werts meist schon für sich ein Verweis ist. Ein Abschneiden am Leerraum würde diesen Verweis auflösen und den Rest dessen, was der Autor geschrieben hat, stillschweigend verwerfen — und die beiden Hälften eines Builds müssen nicht gleich viel verwerfen, sodass eine eine Abhängigkeit festhalten könnte, die die andere nie gesehen hat. Die Zurückweisung sorgt dafür, dass der Wert genau eine Sache bedeutet.
Die Zurückweisung wird in der Zeile des Dokuments gemeldet, aus dem der Verweis gelesen wurde:
library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (Bibliotheksverweis: ein Verweis auf einen Bibliothekseintrag enthält weder Leerraum noch Zeilenumbruch: $import-Ziel in der genannten Zeile)
Ein Verweis erreicht einen Build noch von einer weiteren Stelle: aus dem Inhalt eines Bibliothekseintrags, den ein Build bereits aufgelöst hat, wenn dort ein $import: an der Wurzel des Felds in der ersten Zeile auf den Eintrag einer anderen Bibliothek zeigt. Dieser Verweis wurde nie aus einem Dokument gelesen, das der Build geöffnet hat, daher wird er ohne Zeile gemeldet:
library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (Bibliotheksverweis: ein Verweis auf einen Bibliothekseintrag enthält weder Leerraum noch Zeilenumbruch)
So beheben Sie es: Öffnen Sie die Entität in der Zeile, die die Meldung nennt, und schließen Sie den Verweis zusammen, sodass er ein einziges Token ist. Ein Zeilenumbruch vor dem # ist die übliche Ursache — ein Verweis, der auf zwei Zeilen umbrochen wurde, um in eine Spalte zu passen, ist für YAML ein einziger Wert und hier ein fehlerhafter Verweis; schreiben Sie ihn daher auf eine Zeile, wie lang sie auch wird. Die andere ist ein nachgestelltes Leerzeichen vor dem schließenden Anführungszeichen: Es landet in der Mindestversion, wo es eine Version nennt, die kein veröffentlichtes Artefakt trägt. Bei der zweiten Form steht der Verweis in der Bibliothek, die in der Meldung direkt davor genannt wird; korrigieren Sie ihn dort, wo diese Bibliothek den Eintrag deklariert.
A library entry’s body is not the shape that library holds (Der Inhalt eines Bibliothekseintrags hat nicht die Form, die diese Bibliothek enthält)
Eine Bibliothek veröffentlicht benannte Inhalte, die andere Entitäten importieren können, und jeder Bibliothekstyp enthält eine Form. Ein Eintrag einer MappingLibrary und ein Eintrag einer WorkloadLibrary enthalten jeweils einen Template-Inhalt, daher ist der Wert des Eintrags ein Skalar — in der Praxis ein |-Block. Ein Eintrag einer ArtifactLibrary enthält ein Bundle: die Dateien, die unter einem Namen zusammengehören, daher ist der Eintrag ein Mapping vom Ausgabedateinamen auf den Inhalt dieser Datei, und jeder Inhalt darunter ist ein Skalar.
Inhalte werden genau so erfasst, wie sie geschrieben sind, und beim Laden der Bibliothek nicht geparst. Das Template in einem Inhalt wird dort geparst, wo es importiert wird; deshalb wird hier nur die Form geprüft — ein Inhalt, der überhaupt kein Template ist, lädt ohne Beanstandung und scheitert an der Stelle, an der etwas ihn rendert.
Ausgegebene Meldungen, die jeweils die Zeile nennen und was dort geschrieben wurde — zum Beispiel a list:
mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: der Inhalt des Eintrags muss ein Zeichenketten-Skalar sein: in der genannten Zeile steht ein Wert, wo Text erwartet wird) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: der Inhalt des Eintrags muss ein Zeichenketten-Skalar sein: in der genannten Zeile steht ein Wert, wo Text erwartet wird) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: der Eintrag muss ein Mapping vom Dateinamen auf einen Zeichenketten-Inhalt sein: in der genannten Zeile steht ein Wert, wo ein Mapping erwartet wird)
und, für ein Bundle, dessen Eintrag ein Mapping ist, von dem aber eine der Dateien kein Skalar ist, mit Angabe der Datei:
artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: der Eintrag muss ein Mapping vom Dateinamen auf einen Zeichenketten-Inhalt sein: in der genannten Datei und Zeile steht ein Wert, wo Text erwartet wird)
Der Build meldet diese unter einem CATALOG_ERROR-Tag, der die Datei nennt, die er gerade las, mit dem obigen Satz darunter.
So beheben Sie es: Schreiben Sie den Inhalt als Block-Skalar unter seinen Schlüssel. Ein Inhalt, dessen erste Zeile wie ein YAML-Schlüssel aussieht — was bei einem Template, das YAML erzeugt, meist der Fall ist —, wird als verschachteltes Mapping gelesen, sofern der Block-Skalar fehlt, und das ist die häufige Ursache. Schreiben Sie für eine ArtifactLibrary einen Schlüssel pro Ausgabedateiname, mit jedem Inhalt als eigenem Block-Skalar; ein als einziger Inhalt geschriebenes Bundle ist der andere häufige Formfehler.
A $instantiate: reference cannot be resolved (Eine Referenz kann nicht aufgelöst werden)
Eine SchemaLibrary kann unter spec.templates wiederverwendbare Strukturen deklarieren, jede mit eigenen $params, und ein Schema-Eintrag instanziiert dann eine davon, indem er sie unter $instantiate: benennt und ihre Parameter unter $args: angibt. Die Ersetzung ist wörtlich: Ein $<name>-Skalar im Inhalt des Templates wird durch den Wert des Arguments ersetzt. Es gibt keine Auswertung von Ausdrücken, keine Bedingungen und keine Schleifen, und ein ersetzter Wert wird so eingefügt, wie er ist, statt nach weiteren Markern durchsucht zu werden.
Drei Fehler führen zur Zurückweisung der Instanziierung. Der Name unter $instantiate: ist keiner, den die Bibliothek deklariert. Ein Parameter, den das Template ohne default: deklariert, hat keinen Eintrag unter $args:. Oder der Wert eines Arguments hat nicht den Typ, den sein Parameter deklariert — und ein $args:-Schlüssel, der keinen deklarierten Parameter benennt, wird auf dieselbe Weise gemeldet, statt ignoriert zu werden, sodass ein falsch geschriebener Argumentname eine Zurückweisung ist statt eines Parameters, der stillschweigend seinen Standardwert annimmt.
Ausgegebene Meldungen:
schemalibrary: template not found: "<template-name>" not declared in spec.templates (schemalibrary: Template nicht gefunden: nicht in spec.templates deklariert) schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") (schemalibrary: Template-Parameter fehlt) schemalibrary: template parameter type mismatch: <what the type check found> (schemalibrary: Typkonflikt bei einem Template-Parameter) schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params (schemalibrary: Typkonflikt bei einem Template-Parameter: Das Argument ist nicht in den $params des Templates deklariert)
So beheben Sie es: Korrigieren Sie bei einem nicht gefundenen Template den Namen in einen, den die Bibliothek unter spec.templates deklariert — und prüfen Sie, ob Sie die gemeinte Bibliothek importieren. Fügen Sie einen fehlenden Parameter zu $args: hinzu, oder geben Sie dem Parameter im Template einen default:, damit Aufrufer ihn weglassen können. Ändern Sie bei einem Typkonflikt das Argument in den deklarierten Typ, oder erweitern Sie den type: des Parameters; wo die Meldung ein nicht deklariertes Argument nennt, korrigieren Sie dessen Schreibweise oder entfernen Sie es.
A schema uses a JSON Schema keyword the library does not admit (Ein Schema verwendet ein Schlüsselwort von JSON Schema, das die Bibliothek nicht zulässt)
$dynamicAnchor und $dynamicRef sind in SchemaLibrary-Inhalten nicht zugelassen. Sie verschieben die Entscheidung, zu welchem Schema eine Referenz aufgelöst wird, bis zu dem Zeitpunkt, an dem der Wert validiert wird, wodurch die Bedeutung eines Bibliothekseintrags davon abhängt, von wo er importiert wurde, statt davon, was er aussagt — und der Compiler löst die Strukturen einer Bibliothek vor jeder Validierung auf, sodass es nichts gibt, wogegen eine verzögerte Referenz aufgelöst werden könnte.
Die Zurückweisung wird an drei Stellen angewendet, die zusammen beide Wege schließen, auf denen das Schlüsselwort ankommen könnte. Ein Schema-Eintrag wird beim Laden der Bibliothek geprüft. Der Inhalt eines Templates wird beim Laden der Bibliothek geprüft, sodass ein Template, das das Schlüsselwort wörtlich enthält, an dieser Stelle fehlschlägt statt bei dem Build, der es zuerst instanziiert. Und der ersetzte Inhalt wird nach einer Instanziierung erneut geprüft, sodass das Schlüsselwort, als Argumentwert übergeben, nicht an den ersten beiden Prüfungen vorbeikommt.
Ausgegebene Meldung:
schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line> (schemalibrary: verbotenes Schlüsselwort von JSON Schema, in der angegebenen Zeile)
So beheben Sie es: Ersetzen Sie die verzögerte Referenz durch eine $ref, die direkt einen $defs-Eintrag benennt. Wo die Struktur tatsächlich je nach Verwendung variiert, drücken Sie die Variation als Template mit $params aus und instanziieren Sie es je Verwendung — das ist die Ersetzung, die diese Oberfläche bietet, und sie wird aufgelöst, bevor irgendetwas gegen das Ergebnis validiert wird.
A document nests deeper than the reader will descend (Ein Dokument ist tiefer verschachtelt, als der Leser absteigt)
Jedes verfasste Mapping wird in eine Struktur eingelesen, die die Reihenfolge bewahrt, in der seine Schlüssel geschrieben wurden, weil diese Reihenfolge die gerenderte Ausgabe erreicht und Teil dessen ist, was einen Build über Läufe hinweg byte-identisch macht. Dieser Leser steigt eine begrenzte Anzahl von Ebenen ab — hundert — und weigert sich, tiefer zu gehen, sodass eine Eingabe, die sonst den eigenen Stack des Lesers erschöpfen würde, als die Zurückweisung gemeldet wird, die sie ist.
Ausgegebene Meldung:
a document nests too many levels deep: it is read at most 100 levels deep (ein Dokument ist zu viele Ebenen tief verschachtelt: Es wird höchstens 100 Ebenen tief gelesen)
So beheben Sie es: Tatsächlich verfasste Dokumente sind nur wenige Ebenen tief verschachtelt, daher ist ein Dokument, das hundert erreicht, generiert, maschinell übersetzt oder versehentlich selbstreferenziell. Suchen Sie nach einem Wert, der sich in sich selbst expandiert hat — ein YAML-Anker, der auf Inhalt verweist, in dem er selbst steht, wird durch seinen eigenen Abbruch weiter oben zurückgewiesen, ein Generator, der wiederholt dieselbe Struktur ausgibt, jedoch nicht. Wo die Tiefe echt ist, lagern Sie den tiefen Zweig in eine eigene Entität aus und referenzieren Sie sie über ihren Namen.
A provider declares a well-known annotation at a scope it does not render (Ein Provider deklariert eine Well-known-Annotation in einem Geltungsbereich, den er nicht rendert)
Ein Plugin, das einen Provider bedient, sagt zwei Dinge über sich selbst, die übereinstimmen müssen. Unter spec.provider.wellKnownAnnotations listet es die Annotationen auf, auf die es reagiert, jeweils mit den Geltungsbereichen, in denen es sie liest. Unter contract.inputKinds gibt es an, welche Eingabetypen es überhaupt rendert. Ein Schlüssel, der in einem Geltungsbereich deklariert ist, dessen Eingabetyp dieselbe Entität nicht beansprucht, bedeutet, dass sich diese beiden Aussagen in einer einzigen Datei widersprechen, daher wird die Entität beim Laden zurückgewiesen.
Die Prüfung ist ein Vergleich der Entität mit sich selbst, weshalb sie keine Plugin-Binärdatei benötigt und überall greift, wo die Entität gelesen wird — auch bei einem Katalogdurchlauf auf einer Maschine, die das Artefakt nie abgerufen hat.
Zwei Einträge werden bewusst nicht verglichen. Ein Boundary-bezogener Eintrag nennt keinen Eingabetyp, weil er einmal für eine ganze Boundary aufgelöst wird statt auf dem Render-Pfad eines einzelnen Knotens. Ein Eintrag, der überhaupt keinen Geltungsbereich deklariert, erhebt keinen Anspruch pro Pfad: Er sagt nur, dass das Plugin den Schlüssel irgendwo liest.
Was die Zurückweisung nicht feststellt, ist, dass eine bestehen gebliebene Deklaration wahr ist. Nichts kann beweisen, dass das Plugin, das einen Provider bedient, einen Schlüssel liest, den es nach eigener Aussage liest; was ein Vergleich zweier verfasster Felder leisten kann, ist, das Paar zurückzuweisen, das nicht in beiden Teilen wahr sein kann. Ein Schlüssel, der in einem Geltungsbereich deklariert ist, den der Provider tatsächlich rendert, dessen Plugin dort aber nichts liest, besteht diese Prüfung.
Ausgegebene Meldung:
provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render (der Provider deklariert eine Well-known-Annotation in einem Geltungsbereich, aber sein contract.inputKinds wird nicht beansprucht; deklarieren Sie den Schlüssel nur in einem Geltungsbereich, den der Provider rendert, oder beanspruchen Sie den Eingabetyp: wellKnownAnnotations: Ein Schlüssel ist in einem Geltungsbereich deklariert, den der Vertrag des Providers nicht rendert)
So beheben Sie es: Die Meldung nennt beide Hälften. Entfernen Sie entweder diesen Geltungsbereich aus der scope:-Liste der Annotation, sodass die Geltungsbereiche bleiben, die der Provider tatsächlich rendert, oder beanspruchen Sie den Eingabetyp unter contract.inputKinds, falls der Provider ihn tatsächlich rendert.
A compact-form schema uses a keyword the compact form does not know (Ein Schema in Kompaktform verwendet ein Schlüsselwort, das die Kompaktform nicht kennt)
Ein in Kompaktform geschriebenes Schema enthält einen Schlüssel, der weder ein Schlüsselwort der Kompaktform ist noch eines der Schlüsselwörter von JSON Schema, die die Form durchreicht, noch einer der drei Marker, die die Form reserviert — $jsonschema:, $mode: und $ref:. Unbekannte Schlüssel werden beim Lesen des Schemas zurückgewiesen statt verworfen, denn eine falsch geschriebene Einschränkung, die ignoriert wird, wird zu gar keiner Einschränkung, und ein Schema, das durchgesetzt aussieht und nichts durchsetzt, ist schlimmer als eines, das fehlschlägt.
Die Zurückweisung tritt überall auf, wo ein Schema kompiliert wird. Die Einträge einer SchemaLibrary werden beim Laden des Katalogs kompiliert; das spec.schema einer Component, ihr valueSchema und infraSchema pro Socket sowie die Schemas, die ein Feature und ein Provider-Plugin deklarieren, werden beim Lesen des Katalogs kompiliert. Bei einer Component oder einem Feature meldet das spec.schema diese Bedingung selbst und nennt dabei die Entität und das Feld; das valueSchema oder infraSchema eines Sockets meldet sie innerhalb von „A declared schema contract cannot be read as a schema (Ein deklarierter Schema-Vertrag kann nicht als Schema gelesen werden)“ weiter unten und führt den hier zitierten Satz als Detail mit.
Der eigene Satz des Kompaktform-Compilers nennt die Position innerhalb des Schemas, die Quellzeile und den Schlüssel, den er nicht erkannt hat:
compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword (compactform: unbekanntes Schlüsselwort)
Ein Schlüssel, der neben einer dokumentübergreifenden $ref: steht, wird unter derselben Bedingung gemeldet, mit einem eigenen Satz, weil nur drei Geschwisterschlüssel eine solche Referenz begleiten dürfen:
compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description) (compactform: Geschwisterschlüssel einer dokumentübergreifenden $ref nicht zulässig (zulässig: properties, required, description))
und wo dieser Geschwisterschlüssel verlangte, die zusammengeführte Struktur wieder zu öffnen, nennt der Satz stattdessen den Weg dorthin:
compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties (compactform: Geschwisterschlüssel einer dokumentübergreifenden $ref nicht zulässig (zulässig: properties, required, description); verwenden Sie $jsonschema:, um ein Schema für ein offenes Objekt einzubetten, wenn die zusammengeführte Struktur beliebige Eigenschaften akzeptieren muss)
Die Bedingung, unter der sie erfasst wird, ist compactform: unknown keyword, worauf sich ihr Kurzcode auflöst.
So beheben Sie es: Korrigieren Sie den Schlüssel an der Position, die der Satz nennt, anhand des Schlüsselwortvokabulars in compact-form-authoring.md — ein Tippfehler ist die häufigste Ursache. Wo die Struktur tatsächlich ein Schlüsselwort von JSON Schema braucht, das die Kompaktform nicht enthält, schreiben Sie dieses Fragment unter $jsonschema:, das JSON Schema wörtlich einbettet. Behalten Sie neben einer dokumentübergreifenden Referenz nur properties:, required: und description:; alles andere gehört in den Bibliothekseintrag, auf den die Referenz zeigt.
A compact-form schema declares a field literally named type (Ein Schema in Kompaktform deklariert ein Feld, das buchstäblich so heißt)
Die Kompaktform entscheidet anhand der Struktur ihres Inhalts, was ein Mapping bedeutet: Ein type:-Schlüssel kennzeichnet ein Einschränkungsblatt, strukturelle Schlüsselwörter von JSON Schema kennzeichnen ein durchzureichendes Fragment, und ein Mapping aus einfachen Namen kennzeichnet ein Objekt, dessen Kinder Schemas sind. Ein Schema, das ein Feld namenstype deklariert, ist die eine Struktur, die diese Lesarten nicht unterscheiden können — es sieht aus wie ein Einschränkungsblatt und ist als Objekt mit einem Feld gemeint —, daher verlangt die Form vom Autor anzugeben, welches von beiden gemeint ist, mit einem $mode:-Schlüssel, der auf compact oder jsonschema gesetzt ist.
Diese Bedingung meldet ein $mode:, das mit einem anderen Wert geschrieben ist. Der Marker existiert, um die Mehrdeutigkeit aufzulösen, daher wird ein Wert, der nichts auflöst, zurückgewiesen statt erraten.
Der eigene Satz des Kompaktform-Compilers:
compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (compactform: Der Wert muss einer der beiden angegebenen sein)
Die Bedingung, unter der sie erfasst wird, ist compactform: ambiguous dispatch — $mode required, worauf sich ihr Kurzcode auflöst.
So beheben Sie es: Setzen Sie $mode: compact, wo das Mapping ein Objekt in Kompaktform ist, zu dessen Feldern zufällig eines namens type gehört, oder $mode: jsonschema, wo das Mapping ein Fragment von JSON Schema ist, das so übernommen werden soll, wie es geschrieben ist. Wo keine der beiden Lesarten beabsichtigt war, beseitigt eine Umbenennung des Feldes die Mehrdeutigkeit ganz ohne Marker.
A $jsonschema: escape carries content that is not a schema (Ein Escape enthält Inhalt, der kein Schema ist)
Der Schlüssel $jsonschema: bettet ein Fragment von JSON Schema wörtlich ein, für Strukturen, die die Kompaktform nicht ausdrückt. Was er einbettet, wird so übernommen, wie es geschrieben ist, und nie übersetzt, daher muss es ein Schema sein: ein Block-Skalar, der sich als YAML parsen lässt, oder ein verschachteltes Mapping. Inhalt, der keines von beiden ist, wird hier zurückgewiesen, statt weitergereicht zu werden, um dagegen zu validieren, wo der Fehler gegenüber dem Verbraucher des Schemas statt gegenüber dem Schema gemeldet würde.
Vier Strukturen werden unter dieser Bedingung gemeldet, und der Satz sagt, welche bei Ihnen vorliegt. Der Escape-Rumpf lässt sich nicht als YAML parsen. Der Wert des Escapes ist weder ein Block-Skalar noch ein Mapping. Ein properties:-Schlüssel enthält etwas, das kein Mapping von Namen auf Schemas ist. Und auf der äußersten Ebene ist das an den Compiler übergebene Dokument leer oder enthält einen Knoten, für den der Leser keine Regel hat.
Die eigenen Sätze des Kompaktform-Compilers:
compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (compactform: Der Inhalt des Escapes lässt sich nicht als YAML parsen) compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping (compactform: Block-Skalar-String oder verschachteltes Mapping erwartet) compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas (compactform: Mapping von Eigenschaftsnamen auf Schemas erwartet) compactform: unsupported YAML node kind (compactform: nicht unterstützter YAML-Knotentyp)
Die Bedingung, unter der sie erfasst wird, ist compactform: $jsonschema content invalid, worauf sich ihr Kurzcode auflöst.
So beheben Sie es: Schreiben Sie den Escape-Rumpf als Block-Skalar unter $jsonschema: — ein Rumpf, dessen erste Zeile sich wie ein YAML-Schlüssel liest, wird sonst in das umgebende Mapping aufgenommen, was die häufige Ursache ist —, und prüfen Sie, ob sein Inhalt für sich genommen gültiges JSON Schema ist. Wo das Fragment klein genug war, um es in der Kompaktform auszudrücken, ist das Weglassen des Escapes die einfachere Lösung.
A compact-form constraint does not apply to the type it was written on (Eine Einschränkung in Kompaktform gilt nicht für den Typ, an dem sie geschrieben wurde)
Einschränkungen in Kompaktform werden nach dem deklarierten Typ des Feldes zugeordnet: min: und max: werden bei einer Zahl zu einer numerischen Grenze, bei einem String zu einer Längengrenze und bei einem Array zu einer Anzahlgrenze. Eine Einschränkung muss also an einem Feld stehen, dessen Typ sie akzeptiert, und der Typ muss ein einzelner Wert sein, damit die Zuordnung überhaupt eine Antwort hat.
Vier Strukturen werden unter dieser Bedingung gemeldet. Eine Einschränkung, die geschrieben ist, wo type: fehlt oder eine Union nennt, sodass nichts entscheidet, welche Grenze gemeint war. Eine Einschränkung an einem Typ, der keine Grenze dieser Art annimmt — einem Objekt oder einem Boolean. Ein type:, dessen Wert weder ein skalarer Name noch eine Folge von Namen ist. Und ein valuesType:, dem etwas anderes als ein skalarer Name gegeben wurde.
Die eigenen Sätze des Kompaktform-Compilers:
compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint (compactform: Die Einschränkung gilt für einen einzelnen deklarierten Typ (integer/number/string/array); der Typ ist nicht aufgelöst (Union oder fehlend) — schränken Sie den Typ auf einen einzelnen Wert ein oder entfernen Sie diese Einschränkung) compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> (compactform: Die Einschränkung gilt für integer/number/string/array; der deklarierte Typ ist der angegebene) compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind (compactform: skalarer Typname oder Folge von Typnamen erwartet (Array von Typen nach JSON Schema 2020-12); nicht unterstützten Knotentyp erhalten) compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name (compactform: skalarer Typname erwartet)
Die Bedingung, unter der sie erfasst wird, ist compactform: constraint not valid for declared type, worauf sich ihr Kurzcode auflöst.
So beheben Sie es: Der Satz nennt beide Hälften — die Einschränkung und den Typ, auf den sie traf. Schränken Sie type: auf einen einzelnen Namen ein, wo es eine Union enthält, fügen Sie es hinzu, wo es fehlt, oder entfernen Sie die Einschränkung, wo das Feld tatsächlich einen von mehreren Typen annimmt. Eine Grenze, die mit dem Typ variieren muss, wird als Menge von Alternativen unter $jsonschema: ausgedrückt, wobei jeder Zweig seinen eigenen Typ und seine eigene Grenze trägt.
A $ref: is not written in a form the compiler can resolve (Ein Verweis ist nicht in einer Form geschrieben, die der Compiler auflösen kann)
Ein Schema verweist mit $ref: auf eine andere Struktur, entweder innerhalb desselben Dokuments oder dokumentübergreifend auf einen Eintrag einer SchemaLibrary. Zwei Bedingungen decken die zwei Arten ab, auf die ein Verweis scheitert, und der Satz sagt Ihnen, welche bei Ihnen vorliegt: Der Verweis ist nicht in einer Form geschrieben, die der Compiler liest, oder er ist wohlgeformt und nennt ein Ziel, das nicht vorhanden ist.
Der Verweis ist nicht lesbar. Der Wert ist leer, oder seine dokumentübergreifende Form ist nicht <Library>#/schemas/<Entry>, oder er trennt die Version mit @ ab — was mit der korrigierten Schreibweise statt als allgemeine Beanstandung gemeldet wird, weil es der Fehler ist, zu dem diese Form am häufigsten verleitet:
compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL (compactform: eine nicht leere Verweis-URL wurde erwartet) compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> (compactform: ein dokumentübergreifender $ref muss die angegebene Form haben) compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written> (compactform: das Versionstrennzeichen eines dokumentübergreifenden $ref ist ’:’, nicht ’@’ — verwenden Sie den korrigierten Wert)
Die Bedingung, unter der diese erfasst werden, ist compactform: $ref unresolvable.
Das Ziel ist nicht vorhanden. Der Verweis wird korrekt gelesen, und die Bibliothek oder der Eintrag darin fehlt — oder es wurde überhaupt kein Bibliothekskatalog bereitgestellt, gegen den aufgelöst werden könnte:
compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> (compactform: SchemaLibrary nicht im Katalog gefunden) compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> (compactform: Eintrag nicht in der SchemaLibrary gefunden) compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written> (compactform: dokumentübergreifender $ref, aber kein SchemaLibrary-Katalog bereitgestellt)
Die Bedingung, unter der diese erfasst werden, ist compactform: cross-document $ref target not found.
Die beiden auseinanderzuhalten macht die Meldung umsetzbar: Das Erste ist ein Wert, den Sie in dem Dokument, das Sie gerade betrachten, neu schreiben müssen, und das Zweite ist eine Frage danach, was der Build sehen kann. Ein Verweis, der sich in sich selbst expandiert, ist wiederum etwas Drittes und wird oben als „A library reference expands into itself (Eine Bibliotheksreferenz expandiert in sich selbst)“ gemeldet.
So beheben Sie es: Schreiben Sie bei einem nicht lesbaren Verweis den Wert neu — <Library>#/schemas/<Entry> für einen dokumentübergreifenden Verweis, #/$defs/<name> für einen innerhalb desselben Dokuments — und verwenden Sie : vor einer Mindestversion statt @. Prüfen Sie bei einem fehlenden Ziel den Namen des Eintrags anhand der Bibliothek, die ihn veröffentlicht, und prüfen Sie, ob die Bibliothek aus dem Abhängigkeitsabschluss des Release erreichbar ist: Eine Bibliothek, von der nichts eine Abhängigkeit deklariert, wird nicht geladen, sodass auch ein korrekter Verweis darauf ins Leere aufgelöst wird.
Wenn die Bibliothek nur im Artefakt-Cache liegt. Der Cache enthält, was ein Abruf dort abgelegt hat, und eine zwischengespeicherte Bibliothek zählt nur dann als Kataloginhalt, wenn ein Eintrag im Lockfile des Release für ihren Digest bürgt. Wenn der Cache eine SchemaLibrary enthält, die kein Lockfile-Eintrag fixiert und kein Katalogverzeichnis liefert, folgt auf die Meldung eine Zeile remediation:, die jede solche Bibliothek nennt und die Maßnahme, die für den meldenden Befehl funktioniert:
aggrega build und aggrega validate --release lesen das Lockfile des Release, daher nennt ihre Zeile aggrega pull --release <release>, das die Bibliothek auflöst und ihren Eintrag erfasst, oder das Verfassen der Bibliothek unter einem Katalogverzeichnis.
aggrega validate ohne Argument und aggrega validate mit einem Entitätspfad, ob mit oder ohne --release, lesen Bibliotheken nur aus Katalogverzeichnissen und lesen kein Lockfile, sodass ein erfasster Eintrag ihr Urteil nicht ändern würde. Ihre Zeile sagt das und verweist auf das Verfassen der Bibliothek unter einem Katalogverzeichnis oder auf aggrega pull --release <release>, gefolgt von aggrega validate --release <release>, das das Release gegen die Bibliotheken prüft, die sein Lockfile fixiert.
A $ref: addresses a library by registry location (Ein Verweis adressiert eine Bibliothek über ihren Registry-Ort)
Ein dokumentübergreifender $ref: nennt seine Bibliothek über ihre Identität — den bloßen Namen der Bibliothek, dann # und den Pfad des Eintrags — und niemals über die Registry, in der sie zufällig veröffentlicht ist. Über welche Registry ein Name aufgelöst wird, ist Sache der Workspace-Konfiguration, und welche Version verwendet wird, beantwortet das Lockfile; ein Verweis, der einen Host enthält, würde daher im Schema zwei Dinge festlegen, über die der Build entscheiden soll, und würde das Schema als defekten Verweis zwischen Workspaces verschieben.
Wenn sich der Wert mit Host dennoch in eine Bibliothek und einen Eintrag zerlegen lässt, enthält der Satz die stattdessen zu verwendende Schreibweise in Identitätsform:
compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written> (compactform: der dokumentübergreifende $ref enthält einen Registry-Host; verweisen Sie über die Identität auf die Bibliothek)
und wo nicht, endet der Satz nach dem Wert:
compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written> (compactform: der dokumentübergreifende $ref enthält einen Registry-Host; verweisen Sie über die Identität auf die Bibliothek)
Die Bedingung, unter der dies erfasst wird, ist compactform: cross-document $ref carries a registry host; reference the library by identity, worauf sein Kurzcode aufgelöst wird.
So beheben Sie es: Entfernen Sie den Host und alles vor dem Namen der Bibliothek, sodass <Library>#/schemas/<Entry> übrig bleibt. Wenn eine Mindestversion gewünscht ist, schreiben Sie sie nach dem Namen der Bibliothek als :<version>. Dieselbe Regel gilt für die Felder $import: eines Recipe und eines FeatureRecipe, die separat unter „A library $import: addresses its library by registry location (Ein Bibliotheksimport adressiert seine Bibliothek über ihren Registry-Ort)“ weiter unten gemeldet werden.
A schema $import: cannot be applied (Ein Schemaimport kann nicht angewendet werden)
Das spec.schema einer Component oder eines Feature — der ganze Block oder eine seiner Säulen — sowie das valueSchema: oder infraSchema: eines Sockets usesSchema können jeweils als $import: geschrieben werden, das eine Datei neben der Entität nennt. Der Import wird angewendet, wenn die Entität geladen wird, sodass jeder spätere Leser den importierten Vertrag statt des Zeigers sieht. Diese Bedingung tritt ein, wenn etwas, das Sie geschrieben haben, fehlerhaft ist: die Direktive selbst oder die Struktur dessen, was die von ihr genannte Datei tatsächlich enthielt.
Diese Fehler bilden eine einzige Bedingung, weil jeder dieselbe Oberfläche unbrauchbar macht und Ihnen dasselbe zu tun gibt — die Direktive korrigieren oder die Datei, die sie nennt. Die Diagnose beginnt mit dem festen Satz und sagt dann, welcher Fehler vorliegt; der Satz ist also der Teil, auf den Sie abgleichen, und der nachfolgende Teilsatz das, worauf Sie handeln:
a schema $import: could not be applied. <surface>: <the clause for this occurrence> (ein Schemaimport konnte nicht angewendet werden)
Der Teilsatz nennt die gelesene Oberfläche — spec.schema, eine seiner Säulen wie spec.schema.values oder das valueSchema eines Sockets —, gefolgt vom konkreten Fehler. Die Fehler und was jeder bedeutet:
$import: must be the only key when a schema is imported from a file. (Der Import muss der einzige Schlüssel sein, wenn ein Schema aus einer Datei importiert wird.) Die Direktive teilt sich ihr Mapping mit verfasstem Schemainhalt. $import: ersetzt einen ganzen Wert, daher hat ein Geschwisterschlüssel nichts, womit er kombiniert werden könnte.
$import: value must be a path to a file. (Der Wert des Imports muss ein Pfad zu einer Datei sein.) Der Wert ist leer oder keine einzelne Zeichenkette.
$import: takes a file path beside this entity, not a registry location <value>. (Der Import nimmt einen Dateipfad neben dieser Entität an, keinen Registry-Ort.) Der Wert adressiert eine Registry. Über welche Registry ein Name aufgelöst wird, ist Sache der Workspace-Konfiguration, daher enthält eine Schemaoberfläche nie eine; die Meldung nennt stattdessen die zu verwendende Verweisform.
$import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead. (Der Import nimmt einen Dateipfad neben dieser Entität an; verweisen Sie stattdessen auf den Eintrag der SchemaLibrary.) Der Wert adressiert einen Bibliothekseintrag. Auf einen Bibliothekseintrag wird verwiesen, er wird nicht importiert — $ref: ist das Schlüsselwort, das einen solchen auflöst.
imported schema <value> must be a YAML map of schema content; it is not. (das importierte Schema muss eine YAML-Map mit Schemainhalt sein; das ist es nicht.) Die Datei wurde gefunden, gelesen und geparst, und das Ergebnis ist ein Skalar oder eine Sequenz, sodass es keinen Schemainhalt zum Einsetzen gibt.
Die Kopfzeile enthält die Kategorie und den Kurzcode dieser Bedingung, E0266, also den Bezeichner, den Sie festhalten, wenn Sie diesen Abbruch dauerhaft benennen müssen — in einem Gate der kontinuierlichen Integration, einem Issue oder einem Runbook. Eine Nummer wird einmal vergeben und bleibt dann fest, sodass sie gleich bleibt, wie auch immer sich die Formulierung um sie herum verbessert; die Tabelle aller Bedingungen löst sie auf.
Eine wohlgeformte Direktive, die eine Datei nennt, an die der Build nicht herankommt, wird an anderer Stelle unter einem anderen Code gemeldet. Ein Pfad, der sich nicht auflöst, eine Datei, die nicht vorhanden ist oder nicht gelesen werden kann, und Bytes, die sich nicht als YAML parsen lassen, sind keine Fehler in dem, was Sie geschrieben haben — es gibt kein importiertes Dokument zu beurteilen —, daher werden sie als der Ladevorgang gemeldet, der sie sind, unter „A file cannot be read, or its bytes do not parse (Eine Datei kann nicht gelesen werden, oder ihre Bytes lassen sich nicht parsen)“ weiter oben, wo der Teilsatz dokumentiert ist, den jeder davon trägt. Gleichen Sie auf diese Bedingung ab und halten Sie ihren Code fest, wenn Sie eine fehlende oder nicht lesbare Importdatei abfangen.
Ein Pfad wird relativ zu dem Verzeichnis aufgelöst, das die Entitätsdatei enthält — dieselbe Basis, die jedes andere importtragende Feld verwendet. Einem Import, dessen Inhalt selbst einen $import: deklariert, wird gefolgt, und eine Kette, die zu einer bereits in Bearbeitung befindlichen Datei zurückkehrt, wird oben als „A library reference expands into itself (Eine Bibliotheksreferenz expandiert in sich selbst)“ gemeldet statt hier. Eine Direktive, die in einer durch einen Import eingebrachten Datei steht, wird an dieser Datei und der Zeile darin gemeldet, weil dort die Korrektur hingehört; eine in der Entität geschriebene Direktive wird an der Entität gemeldet.
So beheben Sie es: Machen Sie $import: zum einzigen Schlüssel in seinem Mapping und geben Sie ihm einen relativen Pfad zu einer YAML-Datei neben der Entität, deren oberste Ebene eine Map mit Schemainhalt ist. Um eine Struktur zu nutzen, die eine SchemaLibrary veröffentlicht, verwenden Sie stattdessen $ref: <Library>#/schemas/<Entry> — auf einen Bibliothekseintrag wird verwiesen, statt ihn zu importieren.
A schema block names a key that is not a data pillar (Ein Schemablock nennt einen Schlüssel, der keine Datensäule ist)
Der Block spec.schema einer Component oder eines Feature enthält die Datensäulen der Entität, und drei Schlüssel sind alles, was er zulässt: values, die Struktur, die der Entwickler pro Instanz befüllt; infra, die physische Dimensionierung, die der Operator liefert; und provides, die Schlüssel, die die Entität jedem bereitstellt, der sie konsumiert. Diese Bedingung tritt ein, wenn der Block auf seiner obersten Ebene einen anderen Schlüssel enthält.
Die Menge ist geschlossen statt offen, aus demselben Grund, aus dem der Inhalt jeder Säule geschlossen validiert wird: Ein Block, der eine zulässige Oberfläche aufzählt, macht alles außerhalb dieser Oberfläche zu einem Fehler. Ein Schlüssel, den nichts erkennt, würde einen Vertrag tragen, den nie etwas kompiliert, gegen den nie etwas validiert und den nie etwas an einen Konsumenten übergibt — was Sie darunter geschrieben haben, sähe also deklariert aus und wäre wirkungslos. Das ist schwerer zu bemerken als ein Vertrag, den Sie nie geschrieben haben, und deshalb wird der Block zurückgewiesen, statt den verirrten Schlüssel zu ignorieren.
Die Diagnose beginnt mit dem festen Satz und nennt dann die Entität, die Regel, die Stelle, an der der Schlüssel geschrieben wurde, und was stattdessen zu schreiben ist:
a schema block declares a key that names no data pillar (<Kind><name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set. (ein Schemablock deklariert einen Schlüssel, der keine Datensäule nennt, Regel schema-pillars; benennen Sie den Schlüssel in einen der Säulenschlüssel um oder entfernen Sie ihn samt dem Vertrag darunter; zulässig: values, infra, provides. Siehe vocabulary/data-pillars.md für die kanonische Menge der Säulen.)
Die Kopfzeile enthält die Kategorie und den Kurzcode dieser Bedingung, E0267, also den Bezeichner, den Sie festhalten, wenn Sie diesen Abbruch dauerhaft benennen müssen — in einem Gate der kontinuierlichen Integration, einem Issue oder einem Runbook. Eine Nummer wird einmal vergeben und bleibt dann fest, sodass sie gleich bleibt, wie auch immer sich die Formulierung um sie herum verbessert; die Tabelle aller Bedingungen löst sie auf.
Zwei Dinge, die an dieser Position geschrieben werden, sind keine Schlüssel dieser Menge, und keines davon wird hier gemeldet. Ein $import:, das eine Datei neben der Entität nennt, wird durch den Inhalt dieser Datei ersetzt, bevor der Block gelesen wird; was diese Bedingung prüft, ist also die oberste Ebene des importierten Dokuments selbst — ein verirrter Schlüssel innerhalb der importierten Datei wird hier gemeldet, die Direktive selbst nie. Und eine Component, die extends deklariert, schreibt anstelle des Blocks die bloße Zeichenkette inherited, die ein Skalar ohne jegliche Schlüssel ist.
So beheben Sie es: Der Satz nennt den angetroffenen Schlüssel und die drei zulässigen, sodass die häufigste Ursache — ein Tippfehler oder ein Singular, wo der Säulenname im Plural steht — allein an der Diagnose erkennbar ist. Wenn der Inhalt unter dem verirrten Schlüssel zu einer Säule gehört, verschieben Sie ihn unter values:, infra: oder provides:, wie es seine Zugehörigkeit vorgibt; data-pillars.md sagt, welche Säule was besitzt. War er als eigenständiger Schemainhalt gemeint, gehört er eine Ebene tiefer, in eine Säule hinein, statt neben die Säulen. Eine von einer SchemaLibrary veröffentlichte Struktur wird mit $ref: <Library>#/schemas/<Entry> erreicht, geschrieben innerhalb einer Säule, nicht auf Ebene des Blocks.
A plugin asks the host to parse a source while a parse is already running for it (Ein Plugin bittet den Host, eine Quelle zu parsen, während für es bereits ein Parse-Vorgang läuft)
Ein Plugin kann den Host bitten, eine Quelle zu parsen und das Ergebnis zurückzugeben, sodass ein Plugin, das ein Dokument in einem bestimmten Format benötigt, keinen eigenen Leser dafür mitbringen muss. Der Host führt das Plugin aus, das den Parse-Vorgang erzeugt, und gibt zurück, was es erzeugt hat. Diese Bedingung tritt ein, wenn das auf diesem Weg erreichte Plugin seinerseits einen Parse-Vorgang anfordert: Die Anfrage würde erneut in denselben Mechanismus eintreten, in dem sie bereits läuft, und der Host weist sie zurück, statt eine Ebene tiefer zu gehen. Eine Ebene davon ist das, was der Mechanismus bietet, und die Zurückweisung ist das, was ihn auf eine Ebene begrenzt.
Die Verweigerung erreicht das Plugin, nicht den Build. Der Host hält dort nicht an und wickelt den Aufrufstapel ab; er beantwortet den Aufruf mit einem Fehler-Envelope, der den unten stehenden Satz und einen Code für die Zurückweisung enthält, und das anfragende Plugin erhält ihn als Antwort auf seine Anfrage. Was der Build dann tut, hängt davon ab, was dieses Plugin mit der Antwort macht — ein Plugin, das sie als fatal behandelt, beendet den Build, eines, das sie meldet und weitermacht, nicht. Die Zurückweisung selbst ist in beiden Fällen dieselbe.
Es liegt nicht speziell an einem der beiden Plugins: Die Sperre gilt für jedes Paar von Plugins, über das die Anfrage geleitet wurde, und nicht für eine bestimmte Paarung, sodass dieselbe Zurückweisung überall auftritt, wo der Mechanismus erneut betreten wird.
Ausgegebene Meldung, wie das Plugin sie erhält:
aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call (Wiedereintritt in den Erzeuger-Verbrauch verweigert: Ein über den Host erreichter Erzeuger darf keinen weiteren Erzeuger-Verbrauchsaufruf absetzen)
So beheben Sie es: Nichts in Ihren eigenen Dateien verursacht dies, und keine Änderung an dem, was Sie schreiben, behebt es — es ist eine Eigenschaft der Plugins, mit denen der Build konfiguriert ist. Zu korrigieren ist das Plugin, das innerhalb eines Parse-Vorgangs einen weiteren anfordert; melden Sie die Bedingung daher dessen Herausgeber und zitieren Sie dabei die Meldung. Ist dieses Plugin Ihres, lassen Sie es die übergebene Quelle direkt lesen, statt den Host zu bitten, eine weitere zu parsen, während es selbst einen Parse-Vorgang bedient.
The workspace configuration is invalid (Die Workspace-Konfiguration ist ungültig)
Ein Workspace wird durch eine .aggrega-config.yaml in seinem Stammverzeichnis beschrieben: in welche Registry er veröffentlicht und aus welcher er abruft, wo der Artefakt-Cache liegt, welche Plugins an welchen Sockets angebunden sind und welche Haltung jede Registry beim Signieren einnimmt. Diese Datei wird gelesen und gegen ihr Schema geprüft, bevor irgendeine Entitätsdatei geöffnet wird, weil alles Weitere aus ihr gelesen wird.
Eine fehlende Datei ist kein Fehler. Ein Workspace ohne Konfigurationsdatei erhält die dokumentierten Standardwerte, daher nennt dieser Abbruch nie eine Datei, die nicht vorhanden ist. Er nennt die Datei, die den Wert enthielt — oder, bei einer Einstellung, die eine Umgebungsvariable überschreibt und die das Schema nie sieht, die Variable.
Die Prüfung läuft, bevor das Dokument in typisierte Einstellungen umgewandelt wird. Diese Reihenfolge ermöglicht es der Meldung, den Feldpfad zu nennen, den das Schema beanstandet hat, statt einen Typkonflikt von irgendwo weiter hinten zu melden, ohne ein Feld, auf das sie zeigen könnte.
Diese Strukturen werden hier über eine einfache Schema-Beanstandung hinaus gemeldet, jede, weil das Schema allein nur etwas zu Allgemeines sagen kann, um danach zu handeln: ein workspace:-Schlüssel, unter dem nichts steht, ein Schlüssel, der auf die oberste Ebene gehört, aber stattdessen unter workspace: steht, ein cache:-Block unter einem Namen, den die Datei nicht verwendet, ein Registry-Host, der nicht so geschrieben ist, wie ein Registry-Host geschrieben wird, und drei Einstellungen, deren Werte das Schema zulässt, die der Workspace aber nicht verwenden kann — ein artifact_cache_dir, das absolut ist oder das Stammverzeichnis des Workspace selbst nennt, ein signing.kinds-Eintrag, der etwas nennt, das kein veröffentlichbarer Artefakttyp ist, und ein plugins.providers- oder providers_append-Eintrag, dessen uri ein mit oci:// geschriebener Registry-Ort ist. Eine Provider-Bindung nennt ihr Plugin über dessen Identität, provider/<name> mit einem optionalen :<version>, weil diese Identität das ist, womit die Bindung beim Auflösen einer Fähigkeit abgeglichen wird; ein Registry-Ort sagt, wo ein Plugin veröffentlicht ist, nicht, welches Plugin es ist, sodass ein so geschriebener Eintrag nie etwas auswählen könnte. Ein Eintrag, der mit function: eine Einstiegsfunktion und kein uri: nennt, wird ebenfalls hier gemeldet, wenn er ein plugins.linter- oder linter_append-Eintrag oder ein plugins.governance- oder governance_append-Eintrag in einer Verdikt-Rolle ist, ir-verdict oder render-verdict: Diese Anbindungen wählen ihr Plugin über uri aus, daher bindet ein solcher Eintrag kein Plugin an, und die Funktion, die er nennt, würde nie aufgerufen — ein Lint würde weiterlaufen, als gäbe es den Eintrag nicht, und ein Build würde erst später anhalten, wenn er ein Plugin auflösen müsste, das der Eintrag nie genannt hat.
Ein Katalogverzeichnis, das die Konfiguration auflistet — unter workspace.catalog_dirs oder catalog_dirs_append oder im eigenen Eintrag eines Release unter workspace.releases, in jeder Datei, aus der die Konfiguration gelesen wird —, wird ebenfalls hier gemeldet, wenn es kein Verzeichnis ist: Unter dem Pfad existiert nichts, oder dort steht eine Datei oder ein Link, der ins Leere führt. Es wird beurteilt, wenn ein Katalog gerade darüber gelesen werden soll, sodass jeder Befehl, der den Katalog liest, es zurückweist, bevor er irgendetwas liest oder schreibt, während ein Befehl, der keinen Katalog liest, weiterhin läuft. Ohne es weiterzulesen hieße, gegen weniger Kataloge zu bauen, als Sie aufgelistet haben, ohne dass etwas angibt, welche. Ein Verzeichnis, das AGGREGA_CATALOG_DIRS auflistet, unterliegt derselben Regel, und die Zurückweisung nennt statt einer Datei die Variable.
Ein Registry-Host — der host eines registries-Eintrags oder der Host, mit dem default_registry beginnt, sofern er nicht einen dieser Einträge über dessen name: nennt, in welchem Fall er für den Host dieses Eintrags steht — wird als der Host selbst geschrieben: in Kleinbuchstaben, einen Punkt enthaltend, oder localhost, oder ein einzelner Name gefolgt von einem Port, oder eine IP-Adresse (eine IPv6-Adresse in eckigen Klammern), jeweils mit einem optionalen :port und ohne Schema oder Zugangsdaten. Der Host eines registries-Eintrags trägt keinen Pfad; default_registry darf seinem Host / und einen Repository-Pfad folgen lassen — durch / verbundene Segmente in Kleinbuchstaben, ohne Tag, Digest oder abschließenden /. Ein Wert, der einen Host in einer anderen Schreibweise nennt, wird unter Nennung der zu schreibenden Schreibweise zurückgewiesen — bei default_registry der gesamte Ort einschließlich Pfad —, damit die unter diesem Host geführte Vertrauensrichtlinie für ihn gilt; das schließt Port 443 bei einem über HTTPS erreichten Host ein, da es der Standardport dieses Hosts ist. Ein Pfad, der kein Repository-Pfad ist, wird unter Nennung des Hosts zurückgewiesen, dem er folgt, und der name: eines Eintrags gefolgt von einem Pfad wird unter Nennung der beiden stattdessen zu schreibenden Schreibweisen zurückgewiesen, des Namens allein oder des Hosts des Eintrags gefolgt vom Pfad, da ein Name für den Host seines Eintrags steht und nicht für einen Ort darunter. Ein Wert, der überhaupt keinen Host nennt — ein einzelner Name ohne Port, den kein Eintrag trägt, Text mit Leerzeichen oder geschweiften Klammern —, wird als kein Host zurückgewiesen, und bei default_registry sagt die Zurückweisung, dass auch der Name eines Eintrags genügen würde. AGGREGA_DEFAULT_REGISTRY unterliegt derselben Lesart und wird auf dieselbe Weise zurückgewiesen, unter Nennung der Variablen.
Ausgegebene Meldungen. Eine Schema-Beanstandung nennt die Datei, den Feldpfad und das, was das Schema gesagt hat:
workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (die Workspace-Konfiguration ist ungültig)
Die Formen mit Korrekturhinweis beginnen mit der Datei und sagen anstelle des Feldpfads und der Schema-Beanstandung einen Satz über die konkrete Struktur. Ein artifact_cache_dir, das das Stammverzeichnis des Workspace nennt:
<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir nennt das Stammverzeichnis des Workspace selbst; ein Katalogverzeichnis im Stammverzeichnis des Workspace würde dann als Cache übersprungen, sodass nichts zu laden bliebe — geben Sie dem Cache ein eigenes Unterverzeichnis: die Workspace-Konfiguration ist ungültig)
ein unbrauchbarer signing.kinds-Eintrag, der auch den Platzhalter nennt, der jeden Typ abdeckt:
<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (der signing.kinds-Eintrag ist kein signierbarer Artefakttyp; verwenden Sie einen Katalogentitäts- oder Plugin-Typ oder den Platzhalter für jeden Typ: die Workspace-Konfiguration ist ungültig)
eine als Registry-Ort geschriebene Provider-Bindung, die den Eintrag, die Fähigkeit und die zu schreibende Form nennt:
<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid (plugins.providers bindet die Fähigkeit an einen Ort, der angibt, wo ein Plugin veröffentlicht ist, und nicht, welches Plugin es ist; eine Provider-Bindung nennt ihr Plugin über dessen Identität — schreiben Sie uri mit der Identität des Providers, optional mit einer Version: die Workspace-Konfiguration ist ungültig)
eine Linter- oder Governance-Anbindung in Verdikt-Rolle, die eine Einstiegsfunktion und kein Plugin nennt und deren Meldung die Liste, den Eintrag und die Funktion nennt, hier für plugins.linter:
<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid (plugins.linter nennt die Einstiegsfunktion, aber keine Plugin-uri; eine Anbindung in dieser Liste wählt ihr Plugin über uri aus, daher bindet diese kein Plugin an, und die Funktion wird nie aufgerufen — fügen Sie die uri des Plugins hinzu, das sie exportiert: die Workspace-Konfiguration ist ungültig)
ein in einer anderen Schreibweise geschriebener Registry-Host, hier HUB.AGGREGA.AI:
<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry ist nicht als der Registry-Host geschrieben, den es nennt; schreiben Sie ihn — in Kleinbuchstaben, ohne Schema, Pfad, Zugangsdaten oder Standardport —, denn das ist die Schreibweise, unter der die Vertrauensrichtlinie dieses Hosts geführt wird: die Workspace-Konfiguration ist ungültig)
eine Standard-Registry, deren Host vor ihrem Repository-Pfad in einer anderen Schreibweise geschrieben ist, hier GHCR.io/acme, deren Meldung den gesamten zu schreibenden Ort nennt:
<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry ist nicht als der Registry-Ort geschrieben, den es nennt; schreiben Sie ihn — den Registry-Host in Kleinbuchstaben, ohne Schema, Zugangsdaten oder Standardport, gefolgt vom Repository-Pfad —, wodurch die Vertrauensrichtlinie dieses Hosts weiterhin dafür gilt: die Workspace-Konfiguration ist ungültig)
der Name eines Eintrags gefolgt von einem Pfad, hier local/acme, wobei der Eintrag namens local für 127.0.0.1:5000 steht:
<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid (default_registry ist der Name des registries-Eintrags gefolgt von einem Pfad, und der Name eines Eintrags steht allein für den Host dieses Eintrags; schreiben Sie den Namen allein, um den Eintrag zu verwenden, oder seinen Host gefolgt vom Pfad: die Workspace-Konfiguration ist ungültig)
ein Wert, der keinen Host nennt und dessen Satz die Formen auflistet, die ein Host annimmt:
<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid (der Host des registries-Eintrags ist kein Registry-Host; schreiben Sie einen Hostnamen in Kleinbuchstaben, der einen Punkt enthält (registry.example.com), localhost, einen einzelnen Namen gefolgt von einem Port (registry:5000) oder eine IP-Adresse, eine IPv6-Adresse in eckigen Klammern — jeweils mit einem optionalen :port und nichts weiter: die Workspace-Konfiguration ist ungültig)
ein aufgelistetes Katalogverzeichnis, unter dem nichts existiert, wobei die Meldung die Datei und Zeile, die Liste, den Eintrag wie geschrieben und den aufgelösten Pfad nennt — die Liste ist workspace.catalog_dirs, workspace.catalog_dirs_append oder die Liste eines Release-Eintrags wie `catalog_dirs` of the `workspace.releases` entry "release.yaml":
<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid (der Eintrag von workspace.catalog_dirs nennt ein Verzeichnis, das nicht existiert; legen Sie dieses Verzeichnis an oder entfernen Sie den Eintrag: die Workspace-Konfiguration ist ungültig)
und ein leerer workspace:-Marker:
workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspace muss ein Mapping sein; schreiben Sie ein leeres Mapping, um ein Workspace-Stammverzeichnis ohne Katalogverzeichnisse zu kennzeichnen: die Workspace-Konfiguration ist ungültig)
Zwei weitere nennen einen an der falschen Stelle geschriebenen Schlüssel — default_registry, offline, auto_pull und artifact_cache_dir stehen alle auf der obersten Ebene statt unter workspace:, und der Block des Parse-Caches heißt parse_cache:. Jede sagt, welchen Schlüssel sie meint und wohin dieser Schlüssel gehört.
So beheben Sie es: Öffnen Sie die Datei, die die Meldung nennt, und gehen Sie zu dem Feldpfad, den sie zitiert. Enthält die Meldung einen Korrektursatz, nennt sie die richtige Schreibweise oder Platzierung direkt, und weiteres Lesen ist nicht nötig. Enthält sie stattdessen eine Schema-Beanstandung, ist der Feldpfad der fehlerhafte Schlüssel, und die Beanstandung sagt, was das Schema dort erwartet hat — die Entitätsseiten regeln diese Datei nicht, lesen Sie also die Beanstandung, statt nach einem Entitätsvertrag zu suchen. Ein artifact_cache_dir wird relativ zum Stammverzeichnis des Workspace geschrieben und benötigt ein eigenes Unterverzeichnis, damit ein Katalogverzeichnis im Stammverzeichnis des Workspace nicht für Cache gehalten und übersprungen wird. Eine als Registry-Ort geschriebene Provider-Bindung wird von Hand auf die Identität des Plugins umgeschrieben — aus oci://hub.aggrega.ai/plugin/provider/compose wird provider/compose —, weil jeder Befehl, der die Datei liest, sie bis dahin zurückweist, aggrega plugin remove eingeschlossen; aggrega plugin add provider schreibt die Identitätsform selbst. Ein Linter- oder Governance-Eintrag in Verdikt-Rolle, der eine Funktion und kein Plugin nennt, erhält die uri des Plugins, das diese Funktion exportiert; wo keines das tut, entfernen Sie den Eintrag — in der Linter-Liste läuft dann der Standard-Linter so, wie er ohne konfigurierten Linter läuft. Ein aufgelistetes Katalogverzeichnis, das kein Verzeichnis ist, wird an dem Pfad angelegt, den die Zurückweisung nennt, oder sein Eintrag wird aus der Zeile entfernt, die die Zurückweisung nennt; eine Kopie eines Projekts, die ohne einen von ihm aufgelisteten benachbarten Checkout angelegt wurde, entfernt diesen Eintrag.
A plugin binding sets a key the socket it attaches to does not read (Eine Plugin-Bindung setzt einen Schlüssel, den der Socket, an den sie angebunden ist, nicht liest)
Sockets in der Workspace-Konfiguration binden Plugins auf zwei verschiedene Arten an, und ein Schlüssel, der zu der einen Art gehört, bedeutet bei der anderen nichts. Statt den Schlüssel zu akzeptieren und stillschweigend zu ignorieren, wird die Konfiguration zurückgewiesen, sodass ein Operator erfährt, dass die Einstellung wirkungslos ist, statt sich später zu fragen, warum sie keine Wirkung hatte.
Die beiden Unstimmigkeiten sind Spiegelbilder voneinander.
Ein Querschnitts-Socket, gebunden per Fähigkeit. Die Sockets für Governance, Linter und Importer binden ein Plugin direkt per uri: an. Ein Governance- oder Linter-Plugin bedient keine Fähigkeit, daher würde eine capability:-Bindung dort gegen nichts nachgeschlagen und auf nichts passen — eine Anbindung, die sich nie auflösen kann. Ein Importer kündigt zwar die Formate an, die er verarbeitet, aber welches Format gewünscht ist, bestimmt der Import und nicht die Anbindung: Eine Importer-Anbindung benennt ihren Importer per uri:, und genau das wählt ihn unter den Importern aus, die das von einem Import angeforderte Format ankündigen.
Ein Provider-Socket, der einen Schlüssel ohne Bezugsobjekt setzt. Eine Provider-Bindung benennt eine Fähigkeit und das Plugin, das sie bedient, und das Plugin steuert einen festen Satz von Exporten statt eines einzelnen auswählbaren Einstiegspunkts, daher benennt function: dort nichts. with: wird aus einem anderen Grund zurückgewiesen: Die Render-Konfiguration für einen Provider wird im Recipe geschrieben, sodass sie auf der Workspace-Bindung auf der falschen Seite der Trennung zwischen Entwickler und Operator landet.
Ausgegebene Meldungen. Eine Fähigkeit auf einem Querschnitts-Socket:
workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (der Socket ist per Fähigkeit gebunden, aber die Querschnitts-Sockets binden per uri an: ihr Plugin bedient keine Fähigkeit, daher passt eine Suche nach Fähigkeit auf nichts; binden Sie ihn stattdessen per uri an: ein Querschnitts-Socket ist per Fähigkeit gebunden, bindet aber per uri an)
ein wirkungsloses function: auf einer Provider-Bindung:
workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (die Provider-Socket-Bindung für die Fähigkeit setzt dieses Feld, aber ein Provider steuert einen festen Satz phasenbezogener Exporte statt eines einzelnen auswählbaren Einstiegspunkts, daher benennt das Feld dort nichts; entfernen Sie es: eine Provider-Socket-Bindung setzt ein Feld ohne Bezugsobjekt auf diesem Socket)
und ein wirkungsloses with:, das in derselben Struktur gemeldet wird und stattdessen angibt, wohin die Konfiguration gehört:
workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (die Provider-Socket-Bindung für die Fähigkeit setzt dieses Feld, aber die Render-Konfiguration für einen Provider gehört in das Recipe, nicht in die Provider-Bindung des Workspace; entfernen Sie es: eine Provider-Socket-Bindung setzt ein Feld ohne Bezugsobjekt auf diesem Socket)
Ein in .aggrega-config.yaml geschriebenes function: erreicht seinen obigen Satz nicht: Das Schema der Workspace-Konfiguration deklariert keinen solchen Schlüssel auf einer Provider-Bindung, daher wird die Datei zuerst zurückgewiesen, unter E0224, und die Abhilfe ist dieselbe — den Schlüssel entfernen:
workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (plugins.providers[].function: gegen /$defs/FixedEntryPluginRef: unerwartete Eigenschaft: “function”: Workspace-Konfiguration ist ungültig)
So beheben Sie es: Die Korrektur erfolgt in .aggrega-config.yaml, und jede Meldung benennt die genaue Änderung. Ersetzen Sie bei einer Governance-, Linter- oder Importer-Anbindung das capability: durch die uri: des Plugins, das Sie anbinden wollten. Entfernen Sie bei einer Provider-Bindung den genannten Schlüssel — und wenn es with: war, verschieben Sie diese Konfiguration in das Recipe, das über den Provider rendert, denn das ist die Oberfläche, die sie liest.
A capability is bound to more than one provider plugin (Eine Fähigkeit ist an mehr als ein Provider-Plugin gebunden)
Eine Fähigkeit benennt eine Art, eine Arbeitslast in Artefakte umzuwandeln, und genau ein Plugin bedient sie in einem aufgelösten Workspace. Zwei Bindungen für eine Fähigkeit lassen keine Antwort darauf, welche von ihnen rendert, und eine Workspace-Konfiguration wird aus mehreren Ebenen zusammengesetzt — einer gemeinsam genutzten Datei, einer Workspace-Datei und den Append-Begleitdateien, die jede davon beisteuern kann —, daher wird die zweite Bindung oft von einer Ebene beigesteuert, deren Autor die erste nicht sehen konnte.
Die Zurückweisung macht das sichtbar. Ließe man eine Bindung stillschweigend gewinnen, hinge die gerenderte Ausgabe davon ab, welche Ebene zufällig zuletzt gelesen wurde.
Ausgegebene Meldung, die die Fähigkeit und die Regel benennt:
workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (die Fähigkeit ist an mehr als ein Provider-Plugin gebunden; behalten Sie genau einen plugins.providers-Eintrag pro Fähigkeit: Fähigkeit ist an mehr als ein Provider-Plugin gebunden)
So beheben Sie es: Behalten Sie einen plugins.providers-Eintrag für die in der Meldung genannte Fähigkeit und entfernen Sie den anderen. Stammen die beiden aus verschiedenen Konfigurationsebenen, ist die Ebene zu bearbeiten, die Sie kontrollieren — wenn Sie Ihren eigenen Eintrag entfernen, wird der von der gemeinsamen Ebene beigesteuerte übernommen, und wenn Sie Ihren behalten, muss stattdessen der Eintrag der gemeinsamen Ebene weichen. Zwei Plugins, die tatsächlich beide den Workspace bedienen, bedienen zwei verschiedene Fähigkeiten; wenn also beide gewünscht sind, geben Sie jedem seine eigene Fähigkeit, statt eine zweimal zu binden.
An importer is attached by more than one plugins.importer entry (Ein Importer ist durch mehr als einen Eintrag angebunden)
Ein plugins.importer-Eintrag bindet den Importer an, den seine uri benennt: Wo dieser Importer das von einem Import angeforderte Format ankündigt, entscheidet der Eintrag, welche Version davon läuft, und übergibt ihm die with.sources und with.settings des Eintrags. Ein Eintrag tut das für einen Importer, daher würde ein zweiter Eintrag, der denselben Importer benennt — dieselbe Identität, in derselben oder in einer anderen Version —, von nichts gelesen, und sein with würde keinen Importer erreichen, ohne dass ein Wort darüber fiele. Stattdessen wird die Konfiguration beim Laden zurückgewiesen, gleich welcher Befehl sie liest.
Eine Workspace-Konfiguration wird aus mehreren Dateien zusammengesetzt — der globalen Datei, jeder .aggrega-config.yaml vom Projektstamm bis hinunter zu dem Verzeichnis, in dem ein Befehl ausgeführt wird, der importer_append-Begleitdatei, die jede davon haben kann, und der .aggrega-config-append-ci.yaml einer Pipeline —, daher steht der zweite Eintrag oft in einer anderen Datei als der erste. Die Meldung benennt den Importer und beide Einträge, den früheren zuerst, jeweils mit dem Schlüssel und der Position, unter denen er geschrieben ist, der Datei, in der er geschrieben wurde, und seiner uri, wie sie dort geschrieben ist.
Nur die Importer-Liste wird beurteilt: Die Governance- und die Linter-Liste akzeptieren ein mehrfach angebundenes Plugin, wobei jede Anbindung ihr eigenes with trägt. Ein Eintrag, dessen uri ein Dateisystempfad ist, benennt keinen Importer und wird daher nicht verglichen.
Ausgegebene Meldung:
importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (Importer ist durch einen Eintrag in einer Datei und erneut durch einen Eintrag in einer Datei angebunden; behalten Sie genau einen plugins.importer-Eintrag pro Importer, dessen uri die gewünschte Version benennt: Importer ist durch mehr als einen plugins.importer-Eintrag angebunden)
So beheben Sie es: Behalten Sie einen Eintrag für den in der Meldung genannten Importer — denjenigen, dessen uri die gewünschte Version benennt und der das with trägt, das dieser Importer erhalten soll — und entfernen Sie den anderen. Liegen die beiden in verschiedenen Dateien, ist die Datei zu bearbeiten, die Sie kontrollieren: Wenn Sie Ihren Eintrag entfernen, wird der der anderen Datei übernommen, und wenn Sie Ihren behalten, muss stattdessen der Eintrag der anderen Datei weichen.
A provider binding names a capability containing a colon (Eine Provider-Bindung benennt eine Fähigkeit, die einen Doppelpunkt enthält)
Das capability: eines Recipe wird als Name der Fähigkeit bis zu ihrem letzten Doppelpunkt und als Versions-Pin danach gelesen — helm:1.0.0 fordert die Fähigkeit helm in Version 1.0.0 an. Ein plugins.providers-Eintrag wird unter diesem Namen nachgeschlagen, daher trägt die Fähigkeit, die eine Bindung benennt, nie einen Doppelpunkt, und ein Eintrag, dessen Fähigkeit einen trägt, ist einer, den kein Recipe je erreichen kann. Statt ihn ungelesen in der Konfiguration stehen zu lassen, wird die Konfiguration beim Laden zurückgewiesen, gleich welcher Befehl sie gelesen hat.
Nur die Provider-Liste wird beurteilt. Die Importer-Liste teilt die Struktur der Einträge, aber ihre Plugins werden per uri: angebunden und benennen ihre Formate import:<format>, wobei der Doppelpunkt Teil des Namens ist. Die uri: einer Bindung darf dennoch auf :<version> enden; das ist nicht der Teil, den diese Regel liest.
Ausgegebene Meldung, die die Fähigkeit benennt:
the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (die Provider-Socket-Bindung für die Fähigkeit: Die Fähigkeitsreferenz eines Recipe wird als Fähigkeit bis zu ihrem letzten Doppelpunkt und als Versions-Pin danach gelesen, daher trägt die Fähigkeit, die eine Bindung benennt, keinen Doppelpunkt; binden Sie nur den Namen der Fähigkeit und lassen Sie jedes Recipe die benötigte Version pinnen: eine Provider-Socket-Bindung benennt eine Fähigkeit, die einen Doppelpunkt enthält und die kein Recipe auswählen kann)
So beheben Sie es: Schreiben Sie nur den Namen der Fähigkeit in den Eintrag — capability: helm — und pinnen Sie Versionen dort, wo sie hingehören: Ein Recipe pinnt die benötigte Provider-Version in seinem eigenen capability:, und eine Bindung, die eine bestimmte Version ihres Plugins auswählen soll, schreibt sie in die Plugin-Identität, uri: provider/helm:1.0.0.
A governance attachment declares no role, or one that is not a known role (Eine Governance-Anbindung deklariert keine Rolle oder eine, die keine bekannte Rolle ist)
Eine Governance-Anbindung trägt eine Rolle, und die Rolle — nicht die vom Plugin selbst deklarierte Art — legt fest, wo die Anbindung läuft und was sie tun darf: ob sie einen Build akzeptiert oder ablehnt und ob sie den Graphen oder die gerenderten Artefakte liest. Anbindungen werden anhand dieser Rolle verteilt, daher würde eine Anbindung, die keine trägt oder eine, die niemand erkennt, an nichts angebunden und stillschweigend übergangen.
Genau diese Stille verhindert die Zurückweisung. Ein Governance-Plugin, das konfiguriert, aber nie befragt wird, erzeugt genau die Ausgabe eines Builds, der nie einer Governance unterzogen wurde, und nichts im Ergebnis sagt, welches von beiden Sie in der Hand halten.
Ausgegebene Meldungen, beide benennen die Anbindung und listen die vorhandenen Rollen auf. Eine fehlende Rolle:
workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (Governance-Anbindung deklariert keine Rolle; setzen Sie die Rolle auf eine der bekannten Rollen: eine Governance-Anbindung deklariert keine Rolle oder eine unbekannte Rolle)
und eine nicht erkannte:
workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (Governance-Anbindung deklariert eine unbekannte Rolle; verwenden Sie eine der bekannten Rollen: eine Governance-Anbindung deklariert keine Rolle oder eine unbekannte Rolle)
So beheben Sie es: Setzen Sie role: an der Anbindung unter plugins.governance auf eine der Rollen, die die Meldung auflistet. Welche, ist eine Entscheidung darüber, was das Plugin tun soll, nicht über das Plugin: Eine Rolle, die akzeptiert oder ablehnt, liest den Build und gibt ein Verdikt zurück, und eine Rolle, die transformiert, ist eine ausdrückliche Anweisung, das Plugin verändern zu lassen, was es erhält. Die Meldung listet die vollständige Menge auf, sodass die zu verwendende Schreibweise in der Meldung selbst steht.
A registry alias matches more than one host (Ein Registry-Alias passt auf mehr als einen Host)
Einer Registry kann in der Workspace-Konfiguration ein kurzer Alias gegeben werden, damit Befehle und Referenzen sie benennen können, ohne ihren Host auszuschreiben. Ein Alias wählt genau einen Host aus. Diese Bedingung meldet ein Token, das auf den Alias zweier Registry-Einträge passt: Es gibt keine Antwort darauf, welcher Host gemeint war, und die Wahl eines davon würde Artefakte stillschweigend an eine Registry senden oder von einer Registry abrufen, die der Autor nicht benannt hat.
Ausgegebene Meldung, die den Alias benennt, wie viele Einträge ihn beansprucht haben und um welche Hosts es sich handelt:
registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (Registry-Alias passt auf mehrere Hosts; adressieren Sie die Registry über den Host oder entfernen Sie den doppelten Alias: Registry-Alias passt auf mehr als einen Host)
So beheben Sie es: Öffnen Sie .aggrega-config.yaml und geben Sie den Alias einem der Hosts, die die Meldung auflistet, oder adressieren Sie die Registry über ihren Host und entfernen Sie den Alias aus der Referenz. Die Meldung benennt jeden Host, der den Alias trägt, sodass die zu prüfenden Einträge in der Meldung stehen. Stammen die Einträge aus verschiedenen Konfigurationsebenen, bearbeiten Sie die Ebene, die Ihnen gehört.
The lockfile does not satisfy its schema (Das Lockfile erfüllt sein Schema nicht)
Das Lockfile eines Release hält fest, worauf der Build aufgelöst wurde: für jede Entität, jede Bibliothek und jedes Plugin, die er erreicht, die ausgewählte Version und den Digest der Bytes in dieser Version. Es wird gelesen und gegen sein Schema geprüft, bevor es in typisierte Pins umgewandelt wird, sodass ein Dokument, das nicht passt, mit dem Feldpfad zurückgewiesen wird, an dem es gescheitert ist, statt stillschweigend lückenhafte Pins zu erzeugen.
Das Lockfile wird maschinell geschrieben. Es wird von dem Pull erzeugt, der ein Release auflöst, und es wird committet, damit derselbe Build später auf dieselbe Weise aufgelöst wird. Ein Schemafehler ist daher fast immer eine manuelle Bearbeitung, ein Merge, der das Dokument halb aufgelöst hinterlassen hat, oder ein Lockfile, das für eine frühere Form der Datei geschrieben wurde — etwa eines, dessen entities kein kind tragen —, und nicht etwas bewusst Verfasstes.
Ein fehlendes Lockfile ist eine andere Bedingung und wird anders gemeldet — das Lockfile ist erforderlich, daher wird sein Fehlen dort gemeldet, wo der Build danach sucht, mit der Anweisung, den Pull auszuführen, der es erzeugt.
Ausgegebene Meldung, die die Datei, den Feldpfad und den eigenen Einwand des Schemas benennt:
lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: lockfile: Datei hat die Schemavalidierung nicht bestanden)
Ein Build und ebenso aggrega pull --verify fügen den Befehl hinzu, der das Lockfile neu schreibt:
…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: Die Datei hat die Schemavalidierung nicht bestanden; führen Sie den Befehl aus, um sie aus dem Release neu zu schreiben)
Ein vollständig leeres Dokument wird gesondert gemeldet, da es kein Feld zu benennen gibt:
lockfile: <path>: document is empty (lockfile: Dokument ist leer)
So beheben Sie es: Reparieren Sie das Lockfile nicht von Hand. Führen Sie den Pull für das Release erneut aus, der das Dokument aus der von ihm durchgeführten Auflösung neu schreibt, und committen Sie das Ergebnis — erst das erneute Auflösen erzeugt ein Dokument, dessen Pins mit dem übereinstimmen, was das Release tatsächlich erreicht. Folgte der Fehler auf einen Merge, vermeidet das Auflösen des Konflikts durch erneutes Pullen statt durch Bearbeiten ein Dokument, das zwar geparst wird, aber die falschen Versionen pinnt. Es lohnt sich, zuerst den Feldpfad in der Meldung zu lesen: Er zeigt Ihnen, ob der Schaden in einem Eintrag oder in der Gesamtstruktur des Dokuments liegt.
Beim Auflösen des Katalogs
Nach dem Laden durchläuft der Compiler die zwei Ebenen im Manifest (Typ-Mapping, dann Namens-Mapping), um für jede Component das Recipe auszuwählen, und er durchläuft alle extends-Ketten an Manifests, Components oder Features. Die eigene extends-Kette eines Release wird vom selben Durchlauf verfolgt, einen Schritt früher: Sie wird verfolgt, während das Release aufgelöst wird, bevor nach dem Manifest oder dem Aggregate gesucht wird, das es benennt, sodass die folgenden Bedingungen für das Release gemeldet werden statt für einen Geschwisterzeiger, den die Kette liefern sollte.
Cyclic extends chain (Zyklische extends-Kette)
Eine Kette von extends-Zeigern läuft in sich selbst zurück. Jeder Typ, der extends deklariert — Component, Feature, Manifest und Release —, wird von einem einzigen Kettendurchlauf durchlaufen, sodass ein Zyklus überall, wo er gefunden wird, mit denselben Worten gemeldet wird.
Ausgegebene Meldung. Sie beginnt mit dem Satz, der die Bedingung benennt, dann folgen die Entität, von der die Auflösung ausging, und die Regel, die sie zurückgewiesen hat, und dann die Kante, die den Zyklus schließt — die Entität mit dem beanstandeten extends: und die Referenz, die sie deklariert:
cyclic extends chain (<kind><name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (zyklische extends-Kette (Typ und Name, Regel extends). Die Entität erweitert die Referenz, die bereits in der Kette ist; entfernen Sie das extends an der Entität oder lassen Sie es auf eine Entität außerhalb der Kette zeigen)
Die zuerst genannte Entität und die in der Kante genannte Entität sind meist verschieden, und genau darum geht es: Ein Zyklus wird für jede Entität auf ihm gemeldet, während die zu bearbeitende extends:-Zeile diejenige ist, die die Kante nennt. Folgen Sie der Kante, nicht der Kopfzeile.
Bei einem Manifest lautet <kind>Manifest, jede Entität wird über ihren metadata.name benannt, und <reference> ist der Wert von extends: genau wie geschrieben — ein relativer Pfad wie ./base.yaml oder der bloße metadata.name eines Manifest neben dem Release. Welche der beiden Formen Sie geschrieben haben, ändert nicht, was gemeldet wird: Ein Manifest-Glied ist die Datei, zu der es aufgelöst wird, sodass zwei Manifest-Dateien, die zufällig denselben metadata.name deklarieren, zwei Glieder sind und eine Kette durch beide kein Zyklus ist.
Ein Release liest sich genauso, und der Punkt der Dateiidentität wiegt dort schwerer, weil die Struktur, die er schützt, alltäglich ist: <kind> lautet Release, <reference> ist der relative Pfad, den extends: nennt, und ein Release-Glied ist die Datei, zu der es aufgelöst wird. Zwei Release-Dateien, die das bereitgestellte System statt der Umgebung benennen — beide metadata.name: shared-release, die eine erweitert die andere —, sind zwei Glieder, und eine Kette durch beide ist kein Zyklus.
Ein Zyklus wird als Zyklus gemeldet, wie lang er auch ist. Der Kettendurchlauf wendet seine Tiefengrenze nur auf eine Kette an, die endet, sodass ein Zyklus, der mehr Entitäten umfasst, als die Grenze zulässt, trotzdem hier gemeldet wird und nicht als zu tiefe Kette — die Abhilfe für einen Zyklus ist nie, ihn zu verkürzen.
So beheben Sie es: Öffnen Sie die Entität, die die Kante nennt, und entfernen Sie entweder ihr extends:, oder lassen Sie es auf eine Entität zeigen, die noch nicht in der Kette ist. Wo mehrere Ebenen Inhalte teilen sollten, entfernt das Zusammenführen der duplizierten Inhalte in eine einzige Basisentität den Zyklus und die Duplizierung zugleich.
Recipe implements does not match the mapped component type (Die Implementierungsangabe des Recipe passt nicht zum zugeordneten Komponententyp)
Der Mapping-Eintrag im Manifest verweist auf ein Recipe, dessen spec.implements:-Deklaration nicht zum Komponententyp-Schlüssel dieses Mapping-Eintrags passt. spec.implements ist ein Konsistenzanker und kein Dispatch-Mechanismus: Der Mapping-Wert benennt das Recipe direkt, und diese Prüfung bestätigt, dass das vom Autor benannte Recipe eines ist, das den zugeordneten Typ deklariert.
Die Prüfung liest das zusammengesetzte Manifest, bevor irgendein Recipe aufgelöst wird, und meldet daher den Mapping-Eintrag, den der Autor geschrieben hat, und nicht ein nachgelagertes Symptom davon.
Ausgegebene Meldung:
manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends) (die spec.implements des Rezepts im Manifest-Mapping-Eintrag passt nicht zum zugeordneten Komponententyp- / Feature-Typ-Schlüssel (Manifest-Mapping vom Komponententyp zur Rezept-URI, spec.implements des Rezepts ist der deklarierte Wert, erwartet wird der Komponententyp oder ein Typ, den er erweitert))
Jeder Befehl, der die Abhängigkeiten eines Release liest, führt diese Prüfung durch; unterschiedlich ist, was jeder mit dem Ergebnis macht.aggrega build und aggrega pull brechen ab, weil beide etwas erzeugen, das Sie anschließend verwenden würden — gerenderte Artefakte und ein Lockfile. aggrega validate und aggrega lint melden den Befund zusammen mit jeder anderen gefundenen Diagnose und beenden sich dann mit einem Exit-Code ungleich null: Deren Aufgabe ist es, Ihnen alles zu sagen, was am Workspace falsch ist, sodass ein einzelner Fehler den Bericht nicht abkürzt. Im Editor wird der Befund als Diagnose neben den anderen veröffentlicht, und alles andere, was dieses Dokument zu melden hatte, bleibt unberührt. Beachten Sie, wo er erscheint: Der Editor veröffentlicht den Befund auf dem Manifest, in dem das Mapping steht, auf dem Schlüssel des Mapping-Eintrags, den er nennt, und nicht auf dem Aggregate — in der ersten Zeile des Manifest, wo dessen geöffneter Text diesen Eintrag nicht enthält, etwa bei einem Eintrag, den es über extends erbt. Die übrigen Befunde des Release auf Abhängigkeitsebene, die kein Dokument Ihres Workspace nennen, bleiben auf dem Aggregate. aggrega validate meldet ihn, welches Dokument Sie auch geöffnet haben.
Ein Mapping-Eintrag, der ein Recipe benennt, das der Katalog nicht enthält, ist nicht diese Bedingung: Die Prüfung hat nichts zum Vergleichen und überspringt den Eintrag, und das nicht auflösbare Recipe wird gemeldet, wenn die Rezepte aufgelöst werden.
FeatureRecipe-Einträge folgen derselben Struktur; die Mapping-Prüfung für features.type gibt manifest feature mapping ... featurerecipe spec.implements is ... (expected ...) aus, und der Feature-Zweig vergleicht direkt mit dem Mapping-Schlüssel, sodass er keine extends-Alternative nennt.
Ein components.type-Schlüssel wird außerdem pro Instanz beurteilt, wann immer er eine Instanz einer anderen Version erreicht. Ein Schlüssel, der nicht den genauen Typ einer Instanz nennt, erreicht sie über die Basis des Typs, wenn kein Schlüssel genau diesen Typ nennt und kein anderer Schlüssel für dieselbe Basis geschrieben ist — ein ohne Version geschriebener Schlüssel oder einer, der eine andere Version nennt, kann sie also erreichen. Der Eintrag allein kann daher nicht sagen, ob sein Recipe passt, sodass der Build das Recipe für jede Komponenteninstanz, die der Schlüssel auf diese Weise erreicht, erneut beurteilt, wobei der eigene Typ der Instanz in der Version, als die der Build sie kompiliert, an die Stelle des Schlüssels tritt: die Version, die die Instanz nennt, oder, bei einer Instanz ohne Version, die höchste Version dieser Component, die der Katalog enthält. Eine Instanz, deren Version die spec.implements: des Recipe nicht erfüllt — exakt, per Caret-Bereich, durch Versionslosigkeit oder über eine Basis, die der Typ der Instanz per extends erweitert —, löst diese Bedingung aus, gemeldet am Pfad .spec.components.<instance> der Instanz statt an der Manifest-Datei:
manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version (die spec.implements des Rezepts im Manifest-Mapping-Eintrag passt nicht zum zugeordneten Komponententyp- / Feature-Typ-Schlüssel (Manifest, am Pfad der Instanz, Instanz vom Komponententyp, kompiliert als Typ mit Version, erreicht über den Manifest-Mapping-Schlüssel, zugeordnet zum Rezept, dessen spec.implements der deklarierte Wert ist). Ordnen Sie diesen Typ in dieser Version einem Rezept zu, das ihn implementiert, mit einem Mapping-Schlüssel, der die Version nennt)
Der Wert compiled as erscheint nur bei einer Instanz, deren Typ keine Version nennt; eine Instanz, die eine nennt, zeigt ihre Version in of type. Ein Schlüssel, der die eigene Version der Instanz nennt, braucht keine zweite Beurteilung, da die Prüfung des Eintrags diese Frage bereits gestellt hat, und ein bereits wegen seines Schlüssels zurückgewiesener Eintrag wird einmal gemeldet, wie oben, statt noch einmal für jede Instanz. aggrega build und aggrega pull brechen dabei ab, und aggrega validate --release meldet es und beendet sich mit einem Exit-Code ungleich null. aggrega lint beurteilt die Mapping-Einträge eines Manifest und nicht die Instanzen, die sie erreichen, und meldet es daher nicht.
So beheben Sie es: Korrigieren Sie entweder die spec.implements:-Deklaration des Recipe, sodass sie zum Komponententyp-Schlüssel des Manifest passt, oder ändern Sie den Manifest-Eintrag so, dass er auf ein Recipe verweist, dessen spec.implements: zum Komponententyp-Schlüssel passt. Für eine Instanz, die ein Schlüssel in einer anderen Version erreicht, fügen Sie einen Mapping-Schlüssel hinzu, der die Version der Instanz nennt und einem Recipe zugeordnet ist, das sie implementiert, oder lassen Sie den erreichenden Schlüssel auf ein solches Recipe verweisen.
Manifest mapping value is not a shape a recipe reference accepts (Der Mapping-Wert im Manifest hat keine Struktur, die eine Rezeptreferenz akzeptiert)
Ein Mapping-Wert im Manifest benennt ein Recipe oder FeatureRecipe in einer Struktur, die die Referenzgrammatik nicht ausdrücken kann. Eine Rezeptreferenz akzeptiert einen bloßen Namen, einen Namen mit Version, einen durch eine Fähigkeit qualifizierten Namen oder einen durch eine Fähigkeit qualifizierten Namen mit Version — höchstens ein /. Ein Wert mit mehr als dem (ein Pfad im Stil eines Komponententyps wie core/helm/eso-aws-fetcher:1.0.0) kann nie eine Katalogentität benennen, was auch immer der Katalog enthält.
Die Struktur wird beurteilt, während das Manifest zusammengesetzt wird, bevor irgendetwas nachgeschlagen wird — das Urteil ergibt sich aus dem Zählen von Trennzeichen in einer Zeichenkette und braucht daher überhaupt keinen Katalog. Die Beurteilung an dieser Stelle macht die Diagnose ehrlich: Das Rezept, das der Wert gemeint hat, ist oft vorhanden und korrekt benannt, und die Aussage, es fehle, schickt Sie auf die Suche nach dem Falschen. Jeder Befehl, der die Abhängigkeiten eines Release auflöst, meldet es auf dieselbe Weise, sodass es nicht davon abhängt, welchen Sie gerade ausführen.
Ausgegebene Meldung:
malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (fehlerhafte Rezeptreferenz in einem Mapping-Wert im Manifest: Der Schlüssel wird einem Wert zugeordnet, der mehrere durch Schrägstriche getrennte Segmente enthält; eine Rezeptreferenz akzeptiert Name, Name:Version, Fähigkeit/Name oder Fähigkeit/Name:Version; korrigieren Sie den Mapping-Wert im Manifest)
Der Abschnitt features erzeugt dieselbe Meldung für seine eigene Koordinate, und eine Feature-Rezeptreferenz wird als solche benannt.
Ein Wert, dessen Fähigkeitssegment einen Versions-Pin trägt — compose:1.2.3/svc:1.0.0 —, wird auf dieselbe Weise zurückgewiesen, bevor irgendetwas nachgeschlagen wird, sodass nichts aus einer Registry abgerufen wird. Ein Pin gehört an die capability, die das Recipe deklariert, wo er auswählt, welche Version des diese Fähigkeit bedienenden Plugins es rendert; eine Referenz benennt das Recipe über seine bloße Fähigkeit (compose/svc:1.0.0).
malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (fehlerhafte Rezeptreferenz in einem Mapping-Wert im Manifest: Der Schlüssel wird einem Wert zugeordnet, der in seinem Fähigkeitssegment einen Versions-Pin trägt; ein Pin gehört an die Fähigkeit, die das Rezept deklariert, und eine Rezeptreferenz benennt das Rezept über seine bloße Fähigkeit, als Name, Name:Version, Fähigkeit/Name oder Fähigkeit/Name:Version; korrigieren Sie den Mapping-Wert im Manifest)
So beheben Sie es: Kürzen Sie den Mapping-Wert auf eine Struktur, die die Grammatik akzeptiert. Ein Rezept wird über seinen eigenen metadata.name identifiziert — optional mit seiner spec.capability als Präfix und seiner Version als Suffix —, nie über den Komponententyp-Pfad, den es implementiert. Der Schlüssel des Mappings ist der Komponententyp; der Wert des Mappings ist das Rezept.
Nicht zu verwechseln mit einem korrekt strukturierten Wert, der ein Rezept benennt, das der Katalog nicht enthält: Das ist eine tatsächlich fehlende Entität und wird weiterhin als solche gemeldet, mit der URI und dem Mapping-Eintrag, der darauf verwies.
Several Recipes implement one Component type (Mehrere Recipes implementieren einen Component-Typ)
Zwei oder mehr Recipes deklarieren denselben Component-Typ unter spec.implements: — zwei Recipes mit exakter Version für einen Typ oder ein Recipe ohne Version neben einem gepinnten.
Dies löst keinen eigenen Abbruch aus, und es ist keine Mehrdeutigkeit, die der Build auflösen muss. Die Recipe-Auswahl erfolgt nur über das Mapping: Nichts liest spec.implements: und wählt unter den Kandidaten, sodass, wie viele Recipes einen Typ auch implementieren, dasjenige eine Instanz rendert, dem das Manifest sie zuordnet. spec.implements: wird als Konsistenzanker gelesen — zur Bestätigung, dass das Recipe, das ein Autor zugeordnet hat, eines ist, das den Typ deklariert, unter dem er es zugeordnet hat — und als Quelle der Pin-Kandidaten, die ein Abbruch vorschlägt. Es wählt nie aus.
Was Sie stattdessen sehen, ist der Abbruch für eine Instanz, der das Manifest nichts zuordnet, und dieser Abbruch listet jedes Recipe auf, das den Typ implementiert, damit Sie eines pinnen können — siehe „No Recipe is mapped for a component or feature instance (Für eine Komponenten- oder Feature-Instanz ist kein Recipe zugeordnet)“ weiter unten. Er wird auf dieselbe Weise gemeldet, ob ein Recipe den Typ implementiert oder fünf, weshalb es keine eigene Mehrdeutigkeitsbedingung zum Nachschlagen gibt.
So beheben Sie es: Fügen Sie das Mapping hinzu. Ein typbasierter Eintrag routet jede Instanz des Typs; ein namensbasierter Eintrag routet eine benannte Instanz und wird zuerst gelesen, weshalb Sie damit auch einer Instanz ein anderes Recipe als ihren Geschwistern geben.
Ein Release verwendet extends:, um von einem Basis-Release zu erben, deklariert aber auch einen eigenen aggregate:-Zeiger. Das JSON Schema des Release weist diese Struktur bei der Schemavalidierung zurück (Ebene 1, die Hüllenprüfung), über eine allOf-Einschränkung: Wenn extends: vorhanden ist, ist aggregate: verboten; wenn extends: fehlt, sind sowohl aggregate: als auch manifest: erforderlich.
Es bricht als gewöhnliche Verletzung der Hülle ab, sodass die Diagnose die Struktur dieser Klasse annimmt — siehe „Die Fehlerklasse der Dokumenthülle“ in error-translation.md —, und der Befund verweist auf den Schlüssel, der hier nicht zulässig ist:
document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema (Validierung der Dokumenthülle fehlgeschlagen (Release, am Pfad); Zeile und Spalte: spec.aggregate: Der Wert entspricht einer Struktur, die hier nicht zulässig ist. Korrigieren Sie das Dokument, sodass es dem Schema seines Typs entspricht)
So beheben Sie es: Entfernen Sie das Feld aggregate: aus dem Kind-Release. Die Vererbung zwingt das Kind absichtlich, dieselbe Entwicklerabsicht wie das Eltern-Release bereitzustellen; wenn Sie ein anderes Aggregate bereitstellen müssen, verfassen Sie ein neues Release ohne extends:.
A feature attached by both the Aggregate and the Release cannot be merged (Ein sowohl vom Aggregate als auch vom Release angebundenes Feature kann nicht zusammengeführt werden)
Wenn ein lokales Manifest ein Basis-Manifest per extends erweitert, werden die zwei Ebenen (type:-Mapping, name:-Mapping) unabhängig voneinander zusammengeführt. Innerhalb jeder Ebene überschreiben Kind-Schlüssel die Eltern-Schlüssel auf oberster Ebene — das ist eine flache Ersetzung, keine tiefe Zusammenführung. Ein Kind-Eintrag für einen bestimmten Schlüssel ersetzt den Eltern-Eintrag für diesen Schlüssel vollständig.
Wenn derselbe Feature-Instanzname sowohl auf der Aggregate-Seite als auch auf der Release-Seite mit widersprüchlichem, nicht zusammenführbarem Zustand erscheint (über die zulässige infra-Schichtung hinaus), bricht der Compiler ab und positioniert die Diagnose an der Anbindung, die er nicht in Einklang bringen konnte. Die zwei widersprüchlichen Deklarationen folgen in fester Reihenfolge — zuerst der Typ, den das Aggregate deklariert hat, dann der Typ, den das Release deklariert hat —, sodass Sie erkennen können, welches Dokument was gesagt hat, ohne beide zu öffnen.
Ausgegebene Meldung:
feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>") (Feature-Zusammenführungskonflikt: Bringen Sie die Deklarationen von Aggregate und Release für das Feature in Einklang (Aggregate, am Pfad der Anbindung, vom Aggregate deklarierter Typ, vom Release deklarierter Typ))
Dasselbe gilt für eine Anbindung, die eine Verbindung trägt. Wenn der Verbindungseintrag des Aggregate und der Eintrag des Release für dieselbe Verbindung beide eine Anbindung unter einem Slot schreiben und verschiedene Features nennen, bricht der Build am Eintrag des Release ab — wo der zweite Typ geschrieben wurde —, sobald die Komposition abgeflacht ist, und nennt beide Typen, den Slot, die Verbindung, den Socket und die Komponente:
feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents. (Feature-Zusammenführungskonflikt: Bringen Sie die Deklarationen von Aggregate und Release für das Feature in Einklang (Release, am Pfad der Verbindung, das Aggregate nennt einen Typ, das Release einen anderen, für den Slot, an der Verbindung, über den Socket, der Komponente). Entfernen Sie den Typ aus dem Eintrag des Release, damit er die Anbindung dimensioniert, die das Aggregate deklariert, oder nennen Sie in beiden Dokumenten dasselbe Feature.)
So beheben Sie es: Bringen Sie die zwei Deklarationen in Einklang. Aggregate-seitige und Release-seitige Deklarationen derselben Feature-Instanz werden pro Säule kombiniert — das Aggregate steuert values bei, das Release steuert infra bei. Wenn beide Seiten dasselbe Feld außerhalb der Säulen angeben (etwa type:), müssen die Werte übereinstimmen; korrigieren Sie eine Seite passend zur anderen, oder entfernen Sie die redundante Deklaration.
Annotation binding does not resolve against its target Feature (Annotationsbindung lässt sich nicht gegen ihr Ziel-Feature auflösen)
Das Feld feature: einer Annotationsbindung im Manifest nennt ein Feature, das der Katalog nicht lädt, oder die Listen maps.infra / maps.values der Bindung deklarieren Pfade in Punktnotation, die das spec.schema des genannten Features tatsächlich nicht enthält. Jede der beiden Bedingungen bricht das Laden des Workspace ab — die Bindung würde Feature-Anbindungen erzeugen, die Werte an Pfade routen, die die Laufzeitumgebung nicht auflösen kann.
Eine einzige Bedingung deckt die drei Arten ab, auf die sich das Routing einer Bindung nicht auflösen lässt, und die Diagnose nennt, welche davon eingetreten ist:
Feature nicht gefunden. Der Wert von feature: verweist auf eine Feature-URI, die im geladenen Katalog fehlt.
Feature-Schema lässt sich nicht auflösen. Das genannte Feature wird geladen, aber sein spec.schema: lässt sich nicht in eine Darstellung nach JSON Schema 2020-12 auflösen — der Inhalt ist fehlerhaft, oder er nennt einen dokumentübergreifenden Verweis, dem nicht gefolgt werden kann. Diese Variante führt die eigene Diagnose des Auflösungsfehlers mit, sodass der Grund, aus dem sich das Schema nicht auflösen ließ, am selben Abbruch ablesbar ist.
Bindungspfad nicht im Zielschema. Der Eintrag maps.infra oder maps.values der Bindung nennt einen Pfad in Punktnotation, den spec.schema.<pillar>.<path> des Features nicht deklariert.
Ausgegebene Meldung (Variante „Feature nicht gefunden“):
annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature") (Annotationsbindung lässt sich nicht gegen ihr Ziel-Feature auflösen (Manifest: routet an ein Feature, das der Katalog dieses Builds nicht enthält; korrigieren oder veröffentlichen Sie das in der Bindung genannte Feature))
Ausgegebene Meldung (Variante „Schema lässt sich nicht auflösen“):
annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>) (Annotationsbindung lässt sich nicht gegen ihr Ziel-Feature auflösen (Manifest: Die Annotationsbindung routet an ein Feature, dessen deklariertes Schema sich nicht auflösen lässt))
Diese Variante nennt das Feature und den Auflösungsfehler und führt weder den Bindungsschlüssel noch eine Quellposition mit — der Fehler liegt im eigenen spec.schema: des Features, das die Bindung lediglich nennt. Die betroffene Bindung finden Sie, indem Sie mappings.features.annotations nach der Feature-URI durchsuchen, die die Meldung zitiert.
Ausgegebene Meldung (Variante „Pfad nicht gefunden“):
annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema") (Annotationsbindung lässt sich nicht gegen ihr Ziel-Feature auflösen (Manifest: routet an ein Feature, an eine Säule und einen Pfad, für den dieses Feature in seinem Schema keine Eigenschaft deklariert))
So beheben Sie es: Prüfen Sie, ob die feature:-URI der Bindung im Katalog existiert und mit der URI übereinstimmt, die ein Recipe unter implements: angibt, wobei Groß- und Kleinschreibung zählen. Tritt die Variante „Pfad nicht gefunden“ bei einem Pfad auf, den das Feature-Schema tatsächlich deklariert, prüfen Sie die Schreibweise des Pfads in Punktnotation (Groß- und Kleinschreibung zählen) und den Namen der Säule (infra oder values).
A bound annotation value does not conform to the target Feature’s schema (Ein gebundener Annotationswert entspricht nicht dem Schema des Ziel-Features)
Eine von Ihnen verfasste Annotation routet über eine Bindung einen Wert an einen Pfad des Ziel-Features — und der Wert erfüllt das Teilschema nicht, das das Feature an diesem Pfad deklariert, oder das Feature deklariert dort überhaupt keine Eigenschaft. Die Bedingung wird am Wert statt an der Bindung geprüft, weshalb sie vom oben beschriebenen Abbruch zum Bindungsziel getrennt ist: Jener weist zurück, was das Manifest deklariert, dieser weist zurück, was darüber geschrieben wurde.
Vollständige Validierung am ermittelten Pfad; weiches Überspringen nur, wenn sich der Pfad nicht ermitteln lässt. Sobald das Teilschema des gebundenen Unterschlüssels ermittelt ist, wird der Wert gegen den vollständigen Satz der Einschränkungen von JSON Schema 2020-12 an diesem Pfad validiert (Typ, enum, pattern, numerischer Bereich, verschachtelte Objekt- oder Array-Struktur) — ein abschließendes $ref / allOf / oneOf wird gegen die Definitionen des Schemas aufgelöst und validiert, nicht übersprungen. Die Disziplin des weichen Überspringens gilt nur für die Navigation: Trifft der Durchlauf auf einem dazwischenliegenden Segment — bevor das gebundene Blatt erreicht ist — auf einen Ausweg ($ref, patternProperties, oneOf/anyOf/allOf oder additionalProperties mit Schema-Rumpf), ist der Pfad statisch nicht auflösbar, sodass der Validator fortfährt, ohne den Fehler auszulösen, statt einen falschen Abbruch zu riskieren; die Laufzeitumgebung bleibt für diese Bindung die Validierungsoberfläche.
Ausgegebene Meldung (Variante zur Konformität des Werts):
annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure> (Annotations-Unterschlüssel entspricht an der gerouteten Säule nicht dem Schema des Ziel-Features: Der Wert des Annotations-Unterschlüssels entspricht nicht dem Schema des Features)
Ausgegebene Meldung (Variante zum nicht deklarierten Unterschlüssel):
annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey> (Annotations-Unterschlüssel entspricht an der gerouteten Säule nicht dem Schema des Ziel-Features: Der Annotations-Unterschlüssel ist im Schema des Features nicht deklariert)
Der Abbruch wird an der Annotation in ihrer geschriebenen Form ausgelöst, bevor sie zu einer Feature-Anbindung erweitert wird, daher nennt die Diagnose das Dokument und den Geltungsbereich, in dem der Wert geschrieben wurde — die Boundary und die Komponente bei einer Release-seitigen Annotation, den Komponentenpfad bei einer Aggregate-seitigen — sowie den Annotationsschlüssel, aus dem er stammt.
Eine Annotation, die ein Governance-Plugin injiziert hat, wird ebenso beurteilt, und die Diagnose sagt, wer sie geschrieben hat. Ein Plugin, das zum Injizieren von Annotationen angebunden ist, setzt seinen Wert auf eine Release-Komponente, daher wird der Wert genau so geprüft wie einer, den ein Operator dort geschrieben hat — aber die Release-Zeile, auf die die Diagnose zeigt, hat niemand geschrieben. Die Diagnose fügt deshalb hinzu, welches Plugin den Wert injiziert hat und in welcher Governance-Rolle es angebunden ist, und die Korrektur liegt in der Entscheidung dieses Plugins statt im Release.
So beheben Sie es: Korrigieren Sie den gebundenen Wert so, dass er das deklarierte Teilschema erfüllt, oder erweitern Sie das Schema dieser Eigenschaft, wenn der Wert legitim ist. Der Variante zum nicht deklarierten Unterschlüssel kommt meist der oben beschriebene Abbruch zum Bindungsziel zuvor; wird sie erreicht, deklariert die Bindung den Pfad, das Schema des Features enthält ihn aber nicht, also korrigieren Sie, was von beiden falsch ist. Wenn ein dazwischenliegender Kompositionsoperator einen Pfad unauflösbar macht und die Laufzeitumgebung ihn später zurückweist, schränken Sie das Schema so ein, dass die Eigenschaft direkt am Pfad der Bindung sichtbar wird.
An annotation subkey is not routed by its binding (Ein Annotations-Unterschlüssel wird von seiner Bindung nicht geroutet)
Eine von Ihnen verfasste Annotation enthält Unterschlüssel unter einem Schlüssel, den eine Annotationsbindung im Manifest beansprucht, und einer dieser Unterschlüssel ist ein Name, den die Bindung nicht routet: Er steht weder unter maps.infra noch unter maps.values. Jeder Unterschlüssel wird für sich geroutet, an den Feature-Pfad, den die Bindung für ihn deklariert, sodass ein Unterschlüssel, den die Bindung nicht nennt, nirgendwohin kann. Die Annotation ohne ihn zu erweitern, würde einen von Ihnen geschriebenen Wert kommentarlos aus dem Build herauslassen, und ein falsch geschriebener Unterschlüssel ist die übliche Ursache — daher bricht der Build stattdessen ab und nennt den Unterschlüssel, den Annotationsschlüssel, unter dem er geschrieben wurde, und jeden Unterschlüssel, den die Bindung routet.
Der Abbruch wird an der Annotation in ihrer geschriebenen Form ausgelöst, bevor sie zu einer Feature-Anbindung erweitert wird, wie bei den beiden benachbarten Bedingungen: „A bound annotation value does not conform to the target Feature’s schema (Ein gebundener Annotationswert entspricht nicht dem Schema des Ziel-Features)“ oben weist einen Unterschlüssel zurück, den die Bindung routet, wenn das Feature seinen Wert zurückweist, und „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)“ unten weist einen zurück, der über die falsche Säule geroutet wird. Ein Schlüssel, den keine Bindung beansprucht, fällt nicht unter diese Bedingung: Nichts routet ihn, und der Build übergeht ihn.
Ausgegebene Meldung, die das Dokument und die Stelle nennt, an der die Annotation geschrieben wurde, den Unterschlüssel, den Annotationsschlüssel und die Unterschlüssel, die die Bindung routet:
annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>") (Annotations-Unterschlüssel wird von der Bindung der Annotation nicht geroutet (Release: der Unterschlüssel, geschrieben unter der Annotation, deren Bindung nur die aufgeführten Unterschlüssel routet))
Eine in einem Aggregate geschriebene Annotation wird auf die gleiche Weise benannt, an der Stelle, an der sie dort geschrieben wurde — (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …) für eine auf einem Subsystem geschriebene. Der Build meldet eine Release-seitige Annotation unter einem OPS_ERROR-Tag und eine Aggregate-seitige unter einem DEVELOPER_ERROR-Tag, je nach dem Dokument, das sie geschrieben hat.
So beheben Sie es: Vergleichen Sie den Unterschlüssel mit den in der Meldung aufgeführten. Handelt es sich um einen Schreibfehler, korrigieren Sie ihn zu dem Unterschlüssel, den die Bindung routet. Soll der Wert das Feature erreichen, muss die Bindung ihn routen: Fügen Sie den Pfad im Manifest zu maps.infra oder maps.values der Bindung hinzu — einen Pfad, den das Schema des Features deklariert —, oder entfernen Sie den Unterschlüssel aus der Annotation.
A bare annotation value does not route to exactly one path of its binding (Ein einfacher Annotationswert wird nicht an genau einen Pfad seiner Bindung geroutet)
Eine Annotation, die Sie als einfachen Wert geschrieben haben — feature.aggrega.ai/monitoring: "30s" statt einer Map von Unterschlüsseln —, nennt keinen Unterschlüssel, sodass nichts in ihr sagt, welchen Feature-Pfad sie füllt. Sie wird an den einen Pfad gesetzt, den die Bindung deklariert, wobei maps.infra und maps.values zusammen gezählt werden. Eine Bindung, die mehr als einen Pfad deklariert, lässt dem Wert mehrere mögliche Ziele und nichts, um zwischen ihnen zu wählen, daher bricht der Build ab, statt eines auszuwählen. Gezählt wird über beide Listen hinweg, sodass eine Bindung, die einen Pfad über infra und einen anderen über values routet, einen einfachen Wert zurückweist, gleich in welchem Dokument er geschrieben ist.
Der Abbruch wird an der Annotation in ihrer geschriebenen Form ausgelöst, bevor sie zu einer Feature-Anbindung erweitert wird, wie bei den benachbarten Bedingungen, daher nennt die Diagnose das Dokument und die Stelle, an der der Wert geschrieben wurde. Die Prüfung erfolgt einmal pro Annotation, die Sie geschrieben haben: Ein auf einer Boundary oder einem Subsystem geschriebener Wert wird dort zurückgewiesen, einmal, unabhängig davon, ob eine Komponente darin ihn übernimmt. Jeder solche Wert im Build wird gemeldet, nicht nur der erste. Der Build meldet eine Release-seitige Annotation unter einem OPS_ERROR-Tag und eine Aggregate-seitige unter einem DEVELOPER_ERROR-Tag, je nach dem Dokument, das sie geschrieben hat. Die Bedingung lautet a scalar annotation value does not route to exactly one path of its binding; das gibt aggrega explain für ihren Code aus.
Ausgegebene Meldung, die das Dokument und die Stelle nennt, an der die Annotation geschrieben wurde, den Annotationsschlüssel, den Wert und die Pfade, die die Bindung routet:
a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>") (ein skalarer Annotationswert wird nicht an genau einen Pfad seiner Bindung geroutet (Release: Der Schlüssel trägt einen einfachen Wert, dessen Bindung die aufgeführten Pfade routet))
Ein leerer Wert schreibt nichts, daher wird er überall dort gesetzt, wo eine der beiden Listen einen einzigen Pfad enthält, und nur dort zurückgewiesen, wo keine von beiden das tut. Eine Bindung, die gar keinen Pfad deklariert, wird zurückgewiesen, wenn das Manifest geladen wird, weil das Manifest-Schema einen verlangt, sodass ein Build diese Bedingung auf diesem Weg nicht erreicht.
Eine Annotation, die ein Governance-Plugin injiziert hat, wird ebenso beurteilt, und ihre Diagnose fügt hinzu, welches Plugin den Wert injiziert hat und in welcher Governance-Rolle es angebunden ist, wie bei den benachbarten Bedingungen.
So beheben Sie es: Schreiben Sie die Annotation als Map, die den Unterschlüssel nennt, für den jeder Wert bestimmt ist — feature.aggrega.ai/monitoring: {interval: 30s} —, sodass jeder Wert über seinen eigenen Namen geroutet wird; oder geben Sie dem einzelnen Wert eine eigene Bindung unter einem anderen Annotationsschlüssel, die nur den Pfad deklariert, den er füllt.
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)
Annotationen sind nach Autorenseite aufgeteilt, und die Aufteilung ist dieselbe, die jede andere verfasste Säule regelt: Eine Aggregate-seitige Annotation darf nur über einen Bindungspfad geroutet werden, der auf values zielt, und eine Release-seitige Annotation nur über einen Pfad, der auf infra zielt. Jede andere Kombination führt zum Abbruch.
Die Aufteilung verhindert, dass die Abkürzung über Annotationen zu einem Weg wird, die Säule der anderen Seite zu verfassen. Die Annotation eines Entwicklers steuert values bei; die eines Operators steuert die Dimensionierung über infra bei. Eine Bindung, die Pfade in beiden Säulen deklariert, ist an sich kein Fehler — jede Seite routet die Teilmenge, die ihr erlaubt ist, und die Pfade der anderen Seite sind von ihr aus schlicht nicht erreichbar.
Eine Bindung, die einen Pfad in beiden Säulenlisten deklariert, ist der Fall, der am häufigsten zu diesem Abbruch führt. Die Gleichstandsregel des Routings schickt einen solchen Pfad über infra, wodurch er von der Aggregate-Seite aus unerreichbar wird, und eine Aggregate-seitige Annotation, die an ihn geroutet wird, bricht hier ab. Der Hinweis, der diese Bindungsstruktur nennt, bevor ein Build diesen Abbruch erreicht, ist in warnings.md beschrieben.
Ausgegebene Meldung:
annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar> (Annotation wird über eine Säule geroutet, die ihre Autorenseite nicht verwenden darf: Die Annotation wird über eine Säule an einem Pfad geroutet, aber Annotationen dieser Seite dürfen nur über die erlaubte Säule geroutet werden)
Eine Annotation, die ein Governance-Plugin injiziert hat, sitzt auf einer Release-Komponente, ist also eine Release-seitige Annotation, und für sie gilt dieselbe Aufteilung. Ihre Diagnose fügt hinzu, welches Plugin sie injiziert hat und in welcher Governance-Rolle es angebunden ist, weil der Release-Schlüssel, auf den sie zeigt, einer ist, den niemand geschrieben hat.
So beheben Sie es: Routen Sie die Annotation von der Seite aus, auf deren Säule die Bindung zielt, oder fügen Sie eine Bindung hinzu — unter einem eigenen Annotationsschlüssel —, deren Pfade auf die Säule zielen, die der Autorenseite erlaubt ist. Wo eine Bindung denselben Pfad in beiden Säulenlisten deklariert, teilen Sie sie in zwei Bindungen auf, sodass jede Seite einen Pfad hat, den sie erreichen kann. Wo die Diagnose ein injizierendes Plugin nennt, stammt die Annotation aus der Entscheidung dieses Plugins: Korrigieren Sie das Plugin oder die Bindung, unter der es injiziert.
Authored values or infra do not conform to the declared schema (Verfasste values oder infra entsprechen nicht dem deklarierten Schema)
Die aufgelösten values: oder infra: einer Komponenteninstanz — oder eines angebundenen Features — entsprechen nicht dem deklarierten Katalogschema. Der Build validiert jede Säule vor dem Rendern gegen ihr deklariertes Schema, sodass ein vertippter Schlüssel, ein Wert vom falschen Typ, eine Zahl außerhalb des Bereichs oder ein fehlendes Pflichtfeld an seiner Quelle erkannt wird, statt beim Bereitstellen ein fehlerhaftes Manifest zu erzeugen.
Die Prüfung deckt die üblichen Schema-Einschränkungen ab: einen Wert des falschen Typs (eine Zeichenkette, wo das Schema eine Ganzzahl deklariert), einen Wert außerhalb eines deklarierten Bereichs oder eines enum, einen Wert, der ein deklariertes pattern nicht erfüllt, eine Zeichenkette, die keine gültige Instanz ihres deklarierten format ist — eines der benannten Formate —, und ein erforderliches Feld, das nicht angegeben wurde. Ein Formatfehler nennt das Schlüsselwort und enthält den Wert, das Format und das, was daran falsch ist — so wie aggrega pull und aggrega validate --release ihn für ein Feld uri ausgeben, dem :::: übergeben wird: "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:". Die Prüfung ist Default-bewusst: Ein Feld, dem das Schema einen default: gibt, gilt auch dann als angegeben, wenn es weggelassen wird, sodass ein erforderliches Feld mit Default die „fehlt“-Prüfung nie auslöst.
Die Säule values ist die Authoring-Oberfläche des Entwicklers. Sie wird geschlossen validiert — eine Eigenschaft, die das Schema nicht deklariert, wird als wahrscheinlicher Tippfehler zurückgewiesen. Ein values-Schema, das sich innerhalb seines eigenen Dokuments zusammensetzt (ein lokales #/$defs$ref oder allOf), wird aufgelöst und gegen diesen Definitionskontext validiert.
Die Säule infra ist die Dimensionierungsoberfläche des Operators, und sie wird nur geprüft, wenn die Component eine Säule schema.infra deklariert — diese Deklaration ist der Vertrag, für den sich die Komponente entscheidet. Sie wird geschlossen gegen diese Deklaration validiert und gegen nichts anderes, genau wie die Säule values gegen schema.values validiert wird: Ein Schlüssel, den die Component nicht deklariert, wird als Tippfehler zurückgewiesen, und bei einem Schlüssel, den sie deklariert, werden Typ und Bereich durchgesetzt. Eine Komponente, die einen vom Provider geschichteten Schlüssel wie replicas validiert haben möchte, deklariert diesen Schlüssel in ihrem eigenen schema.infra; das von einem Provider akzeptierte Vokabular wird über das valuesMapping in seinem Recipe erreicht, statt auf die verfasste infra-Oberfläche geschichtet zu werden.
Die Prüfung misst die Dimensionierung jeder Komponente, die das Release platziert hat, und auch ein Eintrag, der überhaupt keinen Block infra: schreibt, wird gemessen: Ein fehlender Block ist ein leerer, sodass ein Schlüssel required: ohne default: als fehlend gemeldet wird — genau der Fall, für den es einen solchen Schlüssel gibt. Beide Arten, eine Komponente zu platzieren, zählen. Sie unter den components einer Boundary zu nennen, platziert sie, und ebenso das Routen des Untermoduls, das sie beiträgt, unter aggregates; ein Routing-Eintrag platziert Komponenten, ohne etwas über eine einzelne von ihnen zu sagen, sodass eine so platzierte Komponente mit einem leeren Dimensionierungsblock beginnt und ein Schlüssel required: ohne Default an ihrem Typ als fehlend gemeldet wird. Eine Komponente, die das Release auf keinem der beiden Wege platziert, wird überhaupt nicht an diesem Vertrag gemessen. Sie hat einen anderen Fehler, und der Build meldet stattdessen diesen: eine Komponente, die in keiner Boundary platziert ist, wobei die beiden Wege, sie zu platzieren, genannt werden.
Der Vertrag bindet eine Komponente, wo auch immer sie verfasst wurde: Eine Komponente, die ein Untermodul beiträgt, wird genau so gemessen wie eine, die das eigene Aggregate des Release deklariert. Wie tief eine Komponente verschachtelt ist, ändert nicht, welche Einschränkungen ihres Typs gelten.
Feature-Anbindungen werden auf die gleiche Weise validiert, gegen das schema.values / schema.infra, das das angebundene Feature deklariert. Anbindungen teilen sich eine Oberfläche, sodass ein Zugangsdaten-Feature — eines mit dem Label feature.aggrega.ai/kind: secret — genau wie jede andere Anbindung gegen sein eigenes deklariertes Schema gemessen wird. Der geprüfte Wert ist das effektive zusammengeführte Ergebnis, nachdem die Anbindungswerte über die Geltungsbereiche (Komponente, Subsystem, Boundary und komponentenspezifisch) kaskadiert sind — sodass ein Wert, der in einem Geltungsbereich zulässig eingeführt, aber in einem spezifischeren Geltungsbereich mit einem unzulässigen Wert überschrieben wurde, am zusammengeführten Ergebnis erkannt wird, nicht am Fragment. Eine Anbindung, deren Typ kein Schema deklariert, wird nicht validiert; das infra einer Anbindung wird gegen das eigene schema.infra der Anbindung validiert (eine Anbindung ist eine Überlagerung und trägt keine Provider-Vereinigung).
Der Befund einer Anbindung wird in dem Dokument gemeldet, das die fehlerhafte Säule geschrieben hat, unter dem Namen dieses Dokuments, und seinem Autor zugeordnet. Ihre values werden an dem Aggregate-Block gemeldet, der sie geschrieben hat — dem eigenen Eintrag features: der Komponente, .spec.components.<component>.features.<attachment>.values.<field>, vor dem Block eines Subsystems, der die Komponente erreicht — als Entwicklerfehler. Ihr infra wird an dem Release-Block gemeldet, der es geschrieben hat — dem Eintrag des Release für die Komponente, unter der Boundary, die sie nennt, vor dem eigenen Block features: der Boundary — als Operatorfehler. Eine Säule, die das Dokument, dem sie gehört, nicht geschrieben hat, wird dort gemeldet, wo die Anbindung selbst geschrieben wurde, also dort, wo ihr type genannt wird. Eine Anbindung, die nur das Release vornimmt und die keine values trägt, meldet also ein Feld, das ihr Feature in seinen values verlangt, am Eintrag des Release und als Operatorfehler, an einem Pfad, den das Release enthält — dem Eintrag der Komponente oder dem Block features: der Boundary für eine Anbindung, die die Boundary für jede Komponente unter ihr vornimmt:
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))
Dieselbe Anbindung, an der Komponente im Aggregate geschrieben, meldet [DEVELOPER_ERROR E0168] an .spec.components.app.features.check.values.schema, unter dem Aggregate-Namen. Ein Editor zeigt jeden Befund an dem Dokument, das ihn geschrieben hat, am tiefsten Schlüssel dieses Pfads, den das Dokument enthält.
Eine Anbindung, die eine Verbindung trägt, wird auf die gleiche Weise gemessen und am Verbindungseintrag des Dokuments gemeldet, das die fehlerhafte Säule geschrieben hat, statt am eigenen Block features: der Komponente, der sie nicht enthält. Ihre values werden am Verbindungseintrag im Aggregate gemeldet, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> — im eigenen Dokument des Untermoduls, bei einer Komponente, die ein Untermodul beiträgt —, und ihr infra am Eintrag des Release für diese Verbindung, unter der Boundary, die die Komponente nennt, wo das Release Boundaries nennt. Eine Anbindung, die nur das Release vornimmt, wird für beide Säulen am Eintrag des Release gemeldet: Eine solche Anbindung trägt keine values, sodass ein Feature, dessen values ein Feld verlangen, es dort als fehlend meldet, an dem Eintrag, den der Operator geschrieben hat.
Kantenbezogene Verbindungskonfiguration wird auf die gleiche Weise gegen den kantenbezogenen Vertrag des Sockets validiert: die vom Entwickler verfassten values einer Kante gegen das valueSchema des Sockets und das vom Operator verfasste infra einer Kante (aus einem Release) gegen das infraSchema des Sockets. Ein Socket, der für eine Säule kein kantenbezogenes Schema deklariert, akzeptiert für sie keine validierte Konfiguration (Weglassen = kein Vertrag, nichts zu prüfen). Die Diagnose nennt die Kante über Konsument, Socket und Alias. Bei einer Komponente, die das eigene Aggregate des Release deklariert, wird das infra des Operators für jeden Eintrag gemessen, den das Release für eine ihrer Verbindungen schreibt — einschließlich eines Eintrags ohne infra, auf diese Weise wird ein Schlüssel required: ohne Default als fehlend gemeldet — und an diesem Eintrag im Release gemeldet, unter der Boundary, die die Komponente nennt, wo das Release Boundaries nennt, also dort, wo der Operator es bearbeitet; die values des Entwicklers werden am Verbindungseintrag im Aggregate gemeldet.
Bei einem Blatt, das als sensitive: true deklariert ist, wird die Verletzung der Einschränkung zurückgehalten. Der Fehlertext zitiert den fehlerhaften Wert, und eine Build-Diagnose wird von jedem gelesen, der den Build verfolgt; daher steht auf einem als sensibel deklarierten Blatt — oder irgendwo innerhalb eines als sensibel deklarierten Objekts — unten statt <constraint failure> der Text <redacted>. Dasselbe gilt an einer Position, die unter sich ein als sensibel deklariertes Blatt enthält, die Säule selbst eingeschlossen: Ein $ref, das neben anderen Schlüsselwörtern geschrieben ist, wird dort, wo es geschrieben ist, als Ganzes geprüft, sodass ein Fehler innerhalb der Definition, die es nennt, an dieser Position gemeldet wird und sonst den Wert des Blatts zitieren würde. Die Entität, der Feldpfad, die Säule und der Vertragsname werden weiterhin alle genannt, sodass die Diagnose Ihnen weiterhin sagt, wo der Fehler liegt; nur der Text, der den Wert wiedergeben würde, entfällt. Die Sensibilität wird je Säule gelesen, sodass ein Blatt, das in values und infra gleich benannt ist, nur in der Säule zurückgehalten wird, die es deklariert.
Ausgegebene Meldung:
authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (die verfasste Säule entspricht nicht ihrem deklarierten Schema) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (die verfasste Säule entspricht nicht ihrem deklarierten Schema) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (die verfasste Säule entspricht nicht ihrem deklarierten Schema: Die Säule values entspricht nicht dem Feature-Schema) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>) (die verfasste Säule entspricht nicht ihrem deklarierten Schema: Die Säule infra entspricht nicht dem Feature-Schema) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (die verfasste Säule entspricht nicht ihrem deklarierten Schema: Die Säule values entspricht nicht dem Feature-Schema) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (die verfasste Säule entspricht nicht ihrem deklarierten Schema) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (die verfasste Säule entspricht nicht ihrem deklarierten Schema: Die Säule values entspricht nicht dem Feature-Schema) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (die verfasste Säule entspricht nicht ihrem deklarierten Schema: Die Säule values entspricht nicht dem Feature-Schema) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (die verfasste Säule entspricht nicht ihrem deklarierten Schema)
So beheben Sie es: Korrigieren Sie den fehlerhaften Wert so, dass er das deklarierte Schema erfüllt, oder — wenn der Wert legitim ist — erweitern Sie das deklarierende Schema (schema.values/schema.infra der Component oder das des angebundenen Feature), sodass es ihn deklariert. Untersuchen Sie das deklarierte Schema einer Component mit aggrega inspect <component-type>, um die genauen Typen, Bereiche, Defaults und erforderlichen Felder zu sehen, die jede Säule erwartet.
A declared schema contract cannot be read as a schema (Ein deklarierter Schema-Vertrag kann nicht als Schema gelesen werden)
Eine Component oder ein Feature deklariert einen Schema-Vertrag, der nichts liefert, wogegen validiert werden könnte, sodass die Konfiguration, die er abdeckt, an nichts gemessen wird. Drei Verträge können den Fehler tragen, jeder in seinem eigenen Feld verfasst: das eigene spec.schema der Entität und die beiden kantenbezogenen Verträge, die ein Abhängigkeits-Socket deklariert — valueSchema für die Entwicklerseite einer Verbindung und infraSchema für die des Operators. Auch ein SchemaLibrary-Eintrag, auf den diese Verträge verweisen können, kann den dritten der unten beschriebenen Fehler tragen; wie dieser Fall gemeldet wird, ist weiter unten dargelegt.
Drei Fehler führen zu diesem Abbruch, und zwei davon sind leicht zu übersehen, weil der Vertrag in Ordnung aussieht. Ein Socket-Vertrag lässt sich womöglich gar nicht zu JSON Schema 2020-12 kompilieren — ein falsch geschriebenes Schlüsselwort ist die häufigste Ursache; ein eigenes spec.schema einer Entität, das sich nicht kompilieren lässt, wird stattdessen unter der Kompaktform-Bedingung gemeldet, auf die seine Kompilierung gestoßen ist (E0120 für ein unbekanntes Schlüsselwort, E0116 für eine Einschränkung, die sein Typ nicht annimmt). Oder er kompiliert sauber und baut dennoch keinen Validator: Der Inhalt ist als Kompaktform lesbar und ist kein Schema, gegen das irgendetwas validiert werden kann, etwa ein bloßer Skalar, wo das Schema einer Eigenschaft hingehört (items: nonsense). Oder er ist in jeder anderen Hinsicht wohlgeformt und nennt ein Format außerhalb der unterstützten Menge — format: password oder eine falsche Schreibweise wie format: emial —, das zurückgewiesen wird, statt als Einschränkung gelesen zu werden, die nichts prüft, ob nun ein Wert das Feld erreicht oder nicht; die Namen, die ein format annehmen kann, sind unter Benannte Formate aufgeführt. Alle drei sind eine einzige Bedingung, weil die Abhilfe dieselbe ist und das Übergehen jedes einzelnen von ihnen dieselbe Folge hat.
Keinen Vertrag zu deklarieren und einen zu deklarieren, der nicht gelesen werden kann, sind verschiedene Situationen, und der Build behandelt sie unterschiedlich. Ein Feld, das nichts deklariert, wird übersprungen: Die Konformität je Säule und je Kante ist optional, sodass ein Socket, der keine der beiden Säulen einschränkt, gewöhnliches Authoring ist und keine Diagnose auslöst. Ein Feld, das etwas Unlesbares deklariert, wird zurückgewiesen. Es zu übergehen, ließe jede Payload, die es abdeckt, unvalidiert, während der Build Erfolg meldet — eine Prüfung, die aufgehört hat zu laufen, ohne dass etwas sagt, dass sie aufgehört hat. Die Zurückweisung ist also das, was die beiden auseinanderhält: Stille bedeutet, dass es nichts zu prüfen gab, und ein Abbruch bedeutet, dass es etwas gab und es nicht gelesen werden konnte.
Die Zurückweisung nennt die Entität, die den Vertrag deklariert hat, und nicht das Dokument, das die Konfiguration geschrieben hat, weil dort die Korrektur hingehört. Ein Aggregate-Autor, dem ein Komponententyp übergeben wird, dessen Vertrag nicht gelesen werden kann, hat in seiner eigenen Datei nichts zu ändern. Die Zurückweisung tritt auf, während der Katalog gelesen wird, wo die deklarierende Entität, die Säule, das verfasste Feld und die Quellzeile alle bekannt sind — sodass derselbe Fehler identisch gemeldet wird, ob Sie ihn über einen Build, über aggrega validate oder über das Build-Werkzeug erreichen, das aggrega mcp bereitstellt. Ein Vertrag, den die Entität über $import: liest — ihr ganzes spec.schema, eine Säule davon oder der Vertrag eines Sockets —, wird an der importierten Datei gemeldet: Die Position nennt diese Datei und die Zeile darin, in der das Fragment geschrieben ist, während die Meldung weiterhin die Entität und das Feld nennt, das den Vertrag deklariert hat. Die Kompaktform-Abbrüche, auf die ein eigenes spec.schema einer Entität stößt, werden auf die gleiche Weise lokalisiert.
Ein SchemaLibrary-Eintrag, der ein Format außerhalb der unterstützten Menge nennt, führt zu diesem Abbruch, sobald seine Bibliothek gelesen wird, und die Zurückweisung nennt die Bibliothek und den Eintrag und verweist auf den Eintrag in der Bibliotheksdatei. aggrega validate über den ganzen Katalog liest jede Bibliothek und meldet den Eintrag daher unabhängig davon, ob ein Schema auf ihn verweist, während ein Release, dessen Abhängigkeitsauflösung die Bibliothek nie erreicht, sie nicht liest. Ein Release, dessen Schemas den Eintrag über ein $ref: tatsächlich erreichen, wird ebenfalls zurückgewiesen, doch die Zurückweisung nennt das Format nicht: aggrega pull meldet die Bibliothek als im Katalog nicht gefunden (E0114), und aggrega validate --release meldet das Ziel des Verweises als nicht gefunden (E0121). Führen Sie aggrega validate über den Katalog aus, um den Eintrag und den fehlerhaften Namen zu sehen.
Die Meldung enthält den Fehler so, wie das Werkzeug, das auf ihn gestoßen ist, ihn gemeldet hat: bei einem Kompilierfehler den Schlüssel innerhalb des Vertrags, die Quellzeile und das fehlerhafte Schlüsselwort; bei einem Inhalt, der keinen Validator baut, die Position, die der Validator zurückgewiesen hat; bei einem Formatnamen außerhalb der unterstützten Menge das Feld, das Schlüsselwort format, den Namen, wie er geschrieben ist, und jeden unterstützten Namen. Ein dokumentübergreifendes $ref: in einem Socket-Vertrag, dessen SchemaLibrary-Eintrag nicht in der geladenen Abschlussmenge liegt, führt zum selben Abbruch, wenn aggrega validate die Entität oder das Release prüft; in einem eigenen spec.schema einer Entität wird es so gemeldet, wie es „A $ref: is not written in a form the compiler can resolve (Ein Verweis ist nicht in einer Form geschrieben, die der Compiler auflösen kann)“ oben beschreibt. aggrega pull liest beide Stellen für die Bibliotheken, die ein Release benötigt, sodass eine im Katalog fehlende Bibliothek den Pull früher stoppt, wie es „A reference names no entity the catalog holds (Eine Referenz benennt keine Entität, die der Katalog enthält)“ (E0114) beschreibt, gleich welche der beiden Stellen auf sie verweist — und eine Bibliothek, die der Katalog enthält, wird für beide im Lockfile gepinnt.
Eine wohlgeformte Einschränkung neben einer unlesbaren wird nicht durchgesetzt. Ein Vertrag wird als ein Dokument gelesen, sodass ein einziges unlesbares Fragment jede daneben deklarierte Einschränkung außer Kraft setzt. Deshalb ist der Abbruch mehr wert als die Einschränkungen, die er kostet: Die Alternative ist ein Vertrag, der durchgesetzt aussieht, sich wie durchgesetzt liest und nichts durchsetzt.
Ausgegebene Meldung, die die Entität mit ihrer Version und das Feld nennt, das den Vertrag deklariert, dann die Säule, die dieser Vertrag einschränkt, dann den Fehler — hier ein Socket-Vertrag mit einem falsch geschriebenen Schlüsselwort:
declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword (der deklarierte Schemavertrag konnte nicht zu einem verwendbaren Schema kompiliert werden, daher wurde nichts dagegen validiert: Korrigieren Sie den Vertrag dort, wo er deklariert ist, oder entfernen Sie ihn, wenn die Konfiguration, die er abdeckt, keine Validierung benötigt. Component: spec.usesSchema.valueSchema des Sockets deklariert ein Schema, aus dem sich kein Validator bauen lässt, sodass die Werte, die es einschränkt, ungemessen blieben: compactform an dem genannten Schlüssel und der genannten Zeile: unbekanntes Schlüsselwort)
und ein Formatname außerhalb der unterstützten Menge in der Säule values einer Component:
declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (der deklarierte Schemavertrag konnte nicht zu einem verwendbaren Schema kompiliert werden, daher wurde nichts dagegen validiert: Korrigieren Sie den Vertrag dort, wo er deklariert ist, oder entfernen Sie ihn, wenn die Konfiguration, die er abdeckt, keine Validierung benötigt. Component: spec.schema.values deklariert ein Schema, aus dem sich kein Validator bauen lässt, sodass die Werte, die es einschränkt, ungemessen blieben: validator/jsonschema: Schemaauflösung fehlgeschlagen (im Feld unter values, Schlüsselwort format: das Format wird nicht unterstützt; die unterstützten Formate sind email, uri, hostname, ipv4, ipv6, uuid, date-time, date))
Ein Feature wird als Feature "<name>:<version>" benannt, der Vertrag eines Sockets über sein eigenes Feld, etwa spec.usesSchema.<socket>.infraSchema, und die Säule über diejenige, die der Vertrag einschränkt — values, infra oder provides. aggrega validate nennt die Entität ohne ihre Version, wenn es die eigene Datei der Entität erhält. Ein SchemaLibrary-Eintrag wird über seine Bibliothek und seinen Eintrag benannt:
declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (der deklarierte Schemavertrag konnte nicht zu einem verwendbaren Schema kompiliert werden, daher wurde nichts dagegen validiert: Korrigieren Sie den Vertrag dort, wo er deklariert ist, oder entfernen Sie ihn, wenn die Konfiguration, die er abdeckt, keine Validierung benötigt. SchemaLibrary: das Schema nennt ein Format, das kein Validator prüfen kann, sodass die Werte, die es einschränkt, ungemessen blieben: validator/jsonschema: Schemaauflösung fehlgeschlagen (im genannten Feld, Schlüsselwort format: das Format wird nicht unterstützt; die unterstützten Formate sind email, uri, hostname, ipv4, ipv6, uuid, date-time, date))
So beheben Sie es: Öffnen Sie das Feld, das die Diagnose nennt, und korrigieren Sie das Fragment an dem gemeldeten Schlüssel und der gemeldeten Zeile — meist ein falsch geschriebenes Schlüsselwort, das Sie mit dem Schlüsselwortvokabular in vocabulary/compact-form-authoring.md abgleichen, oder ein Wert, der dort steht, wo ein verschachteltes Schema hingehört. Nennt der Fehler ein nicht unterstütztes Format, schreiben Sie eines der benannten Formate oder entfernen Sie das format:; ein Feld mit geheimem Material deklariert stattdessen sensitive: true, da password kein Format ist. Bei einem SchemaLibrary-Eintrag gehört die Korrektur in die Bibliotheksdatei, die die Diagnose nennt. Nennt der Fehler einen dokumentübergreifenden Verweis, prüfen Sie, ob der SchemaLibrary-Eintrag existiert und ob die Bibliothek aus der Abschlussmenge der Abhängigkeiten des Release erreichbar ist. Benötigt die Konfiguration, die dieses Feld abdeckt, tatsächlich keine Validierung, entfernen Sie das Feld, statt einen Vertrag zu hinterlassen, den nichts lesen kann.
Recipe source: is an empty string (Das Feld source des Recipe ist ein leerer String)
Ein Recipe deklariert source: "" — einen leeren String. Das source: eines Recipe wählt zwischen zwei Erstellungsmodi: dem Modus sourceless, in dem es kein externes Artefakt gibt und die Ausgabe vollständig aus den anderen Eingabearten des Recipe erzeugt wird, und dem Modus sourced, in dem source: ein externes Chart, ein externes Modul oder eine externe Datei nennt, woraus gerendert wird. Das Weglassen des Feldes wählt den ersten, ein nicht leerer Wert den zweiten und ein leerer String keinen von beiden — es ist also eine Mehrdeutigkeit und kein Wert mit einer Bedeutung. Ein als null geschriebenes source: ist gleichbedeutend mit dem Weglassen.
Das Recipe wird zurückgewiesen, statt dass der Compiler für Sie eine der beiden Lesarten wählt. Am häufigsten entsteht ein leeres source:, wenn man einen URI löscht und den Schlüssel stehen lässt: Gemeint war der Modus sourced, und den leeren String als sourceless zuzulassen, würde die Komponente ohne das Artefakt ausliefern und nie sagen, welche der beiden Lesarten gewählt wurde.
Diese Regel wird beim Laden des Recipe geprüft, wobei der Wert genau so gelesen wird, wie Sie ihn geschrieben haben, sodass jeder Befehl, der das Recipe lädt, diese Bedingung nennt, bevor irgendetwas versucht, den leeren Wert zu verwenden. aggrega validate über die Recipe-Datei lehnt ihn ab; aggrega pull, ein Build, aggrega validate --release und das Build-Tool, das aggrega mcp bereitstellt, melden ihn für ein Release, das das Recipe erreicht, vor dem Verweis auf das Recipe, der deswegen nicht mehr aufgelöst werden konnte. Ein Pull nennt daher diese Bedingung, statt die leere Referenz als eine zu melden, deren Source-Art er nicht bestimmen kann. Sie wird vor den Regeln geprüft, die lesen, ob eine Source deklariert ist, sodass einem Recipe, dessen source: leer ist, das source: gemeldet wird und nicht ein valuesMapping ohne etwas zum Überlagern oder eine fehlende Eingabeart.
Ausgegebene Meldung, positioniert an der Recipe-Datei, in der das leere source: geschrieben wurde, und an dem Schlüssel darin — .spec.source — statt an einer Komponente, die das Recipe bindet, weil der Eintrag von jeder Komponente geteilt wird, die das tut:
recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (das Feld source des Rezepts ist ein leerer String, der weder den Modus sourceless noch den Modus sourced benennt. lassen Sie das Feld source für den Modus sourceless weg, oder geben Sie für den Modus sourced einen nicht leeren Pfad oder URI an)
Der Build gibt die Zeile unter einem CATALOG_ERROR-Tag mit dem Kurzcode dieser Bedingung, E0251, und daneben die Recipe-Datei aus.
So beheben Sie es: Lassen Sie das Feld source: ganz weg (oder setzen Sie es auf null), wenn das Recipe sourceless ist, oder geben Sie einen nicht leeren Pfad / URI / ein strukturiertes Quellobjekt an, wenn das Recipe sourced ist.
No Recipe is mapped for a component or feature instance (Für eine Komponenten- oder Feature-Instanz ist kein Recipe zugeordnet)
Der Typ einer Instanz hat kein Manifest-Mapping, das sich in ein Recipe auflöst, das der Katalog enthält. Die Auswahl des Recipe erfolgt ausschließlich über Mappings: Der Compiler wählt nie ein Recipe aus, indem er spec.implements: liest und unter den Kandidaten auswählt, daher führt ein nicht zugeordneter Typ zum Abbruch, ganz gleich, wie viele Recipes ihn implementieren. implements informiert die Wahl; der Autor trifft sie; das Manifest hält sie fest.
Dieselbe Bedingung erfasst ein Mapping, das existiert, aber ins Leere führt — ein Wert in einer akzeptierten Referenzstruktur, der ein Recipe nennt, das der Katalog nicht enthält, einschließlich eines, das unter einer anderen Version vorhanden ist als der, die der Wert pinnt, und eines, dessen bloßen Namen zwei Fähigkeiten zugleich anbieten. Keines davon löst sich in ein Recipe auf, von dem man sagen könnte, der Autor habe es gewählt. Ein Mapping-Wert, dessen Struktur keine Referenz ausdrücken kann, wird gesondert gemeldet, unter „Manifest mapping value is not a shape a recipe reference accepts (Der Mapping-Wert im Manifest hat keine Struktur, die eine Rezeptreferenz akzeptiert)“ weiter oben, sodass die Aussage, eine Entität fehle, nur über eine Referenz getroffen wird, die sich hätte auflösen können.
Ausgegebene Meldungen, für eine Komponenteninstanz. Wo ein Mapping existiert und etwas Fehlendes nennt:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names (kein Rezept für die Komponenten-/Feature-Instanz aufgelöst: Fügen Sie für ihren Typ ein explizites Manifest-Mapping hinzu (Manifest, mit der Instanz, ihrem Typ und dem Rezept, dem sie zugeordnet ist). korrigieren Sie den Mapping-Wert im Manifest, oder veröffentlichen Sie das Rezept, das er nennt)
Wo kein Mapping existiert und Recipes vorhanden sind, die den Typ implementieren, werden sie als die zu pinnenden Kandidaten aufgeführt:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest (kein Rezept für die Komponenten-/Feature-Instanz aufgelöst: Fügen Sie für ihren Typ ein explizites Manifest-Mapping hinzu (Manifest, mit der Instanz, ihrem Typ und den Rezepten, die ihn implementieren). pinnen Sie eines davon im Manifest)
Und wo überhaupt nichts den Typ implementiert, gibt es nichts aufzuführen:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it (kein Rezept für die Komponenten-/Feature-Instanz aufgelöst: Fügen Sie für ihren Typ ein explizites Manifest-Mapping hinzu (Manifest, mit der Instanz und ihrem Typ). kein Rezept im Katalog implementiert diesen Typ; schreiben Sie eines und ordnen Sie den Typ dann diesem zu)
In einem Workspace, der kein Katalogverzeichnis nennt, werden nur die Recipes durchsucht, die das Lockfile pinnt: Die einer Registry werden nicht aufgeführt, und ein Manifest, das für den Typ keines zuordnet, pinnt keines. Wo dort kein gepinntes Recipe den Typ implementiert, wird das Fehlen in Bezug auf die Pins statt auf den Katalog festgestellt, und die Meldung sagt das auch:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it (kein Rezept für die Komponenten-/Feature-Instanz aufgelöst: Fügen Sie im Manifest eine explizite Zuordnung für ihren Typ hinzu (Manifest, an der genannten Stelle, für die genannte Instanz und den genannten Typ). kein vom Lockfile gepinntes Rezept implementiert diesen Typ; ohne Katalogverzeichnis werden nur die Rezepte durchsucht, die das Lockfile pinnt, nicht die einer Registry; pinnen Sie im Manifest eines, das eine Registry veröffentlicht, oder schreiben Sie eines und ordnen Sie den Typ dann ihm zu)
Einem Typ, den das Aggregate ohne Version schreibt, werden die Recipes angeboten, die die Version implementieren, mit der der Build ihn kompiliert — die höchste Version dieser Component, die der Katalog enthält. Einer Instanz von core/datastore/postgres, wobei der Katalog diese Component in 1.0.0 enthält, wird jedes Recipe angeboten, das spec.implements: core/datastore/postgres:1.0.0 deklariert, sowie jedes, das den unversionierten Typ oder einen Caret-Bereich deklariert, der 1.0.0 zulässt. Einem Typ, von dem der Katalog keine Component enthält, werden nur die Recipes angeboten, die genau diesen unversionierten Typ deklarieren.
Eine Feature-Instanz meldet diese Fälle in einer eigenen Form, jeweils nach dem Satz der Bedingung. Ein Feature-Typ, den das Aggregate ohne Version schreibt, wird wie ein Komponententyp abgeglichen, und zwar in der Version, in der der Build ihn kompiliert — der höchsten Version dieses Feature, die der Katalog enthält —, und eine Meldung, die <type>:<version> nennt, nennt den Typ in dieser Version, also das, wonach im Katalog gesucht wurde. Ist das Recipe bekannt, auf das die Komponente einer Anbindung abgebildet ist, werden die FeatureRecipes anhand der Fähigkeit unterschieden, an die dieses Recipe bindet: Diejenigen, die an die Fähigkeit der Komponente binden, werden zuerst angeboten, und ein FeatureRecipe, das an eine andere Fähigkeit bindet, wird dennoch gerendert, als eigene Ausgabe neben der der Komponente statt in sie hinein; bindet also keines an die Fähigkeit der Komponente, werden stattdessen diese angeboten. Eine Zuordnung, die ins Leere führt, lautet feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog. Implementieren FeatureRecipes den Typ für die Fähigkeit der Komponente, werden nur diese aufgeführt: feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest. Implementieren sie ihn nur für andere Fähigkeiten: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it. Implementiert keines den Typ überhaupt: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. Und ist die Fähigkeit nicht bekannt — die eigene Zuordnung der Komponente löst zu keinem Recipe auf, was gesondert gemeldet wird, oder die Anbindung ist an einer Grenze geschrieben, deren Komponenten über mehrere Fähigkeiten rendern können —, wird jede Implementierung aufgeführt: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. In einem Workspace, der kein Katalogverzeichnis nennt, werden nur die FeatureRecipes durchsucht, die das Lockfile pinnt: Die einer Registry werden nicht aufgeführt, und ein Manifest, das für den Typ keines zuordnet, pinnt keines. Dort wird das Fehlen in Bezug auf die Pins statt auf den Katalog festgestellt, und die Meldungen sagen das auch. Implementiert keines den Typ: feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it — und ist die Fähigkeit nicht bekannt, nennt die Meldung keine und endet mit pin one a registry publishes in the Manifest, or write one, then map the type to it. Implementieren gepinnte FeatureRecipes ihn nur für andere Fähigkeiten, lautet die Meldung für diesen Fall no feature recipe the lockfile pins implements statt no feature recipe in the catalog implements, mit demselben Satzteil nach der Fähigkeit.
So beheben Sie es: Fügen Sie das Mapping hinzu, das die Meldung verlangt, unter spec.mappings.components.type im Manifest, mit dem Komponententyp als Schlüssel und dem Recipe als Wert. Wo die Meldung Kandidaten aufführt, wählen Sie einen davon — diese Liste umfasst genau die Recipes, die deklarieren, dass sie den Typ in der Version implementieren, in die der Build ihn auflöst. Wo sie ein Recipe nennt, das nicht im Katalog ist, korrigieren Sie entweder den Wert oder fügen Sie das Recipe einem Katalogverzeichnis hinzu, das der Build liest; eine Version im Wert muss einer Version entsprechen, die der Katalog enthält. Wo nichts den Typ implementiert, fehlt das Recipe selbst. Wo die Meldung sagt, dass nur die vom Lockfile gepinnten Rezepte oder Feature-Rezepte durchsucht werden, liest der Workspace kein Katalogverzeichnis, sodass eine Registry dennoch ein Recipe oder FeatureRecipe veröffentlichen kann, das den Typ implementiert: Erst die Zuordnung des Typs zu ihm im Manifest bewirkt, dass der Pull es abruft und pinnt.
A Manifest name mapping names nothing in the build (Ein Namens-Mapping im Manifest benennt nichts im Build)
Ein Schlüssel unter spec.mappings.components.name oder spec.mappings.features.name nennt keine Komponenteninstanz und keine Anbindung, die der Build enthält. Die Ebene name wird mit dem exakten Namen dessen abgeglichen, was realisiert wird: ein Schlüssel components.name mit dem Namen einer Komponenteninstanz, so wie das Aggregate ihn schreibt, und ein Schlüssel features.name mit dem eigenen Namen einer Anbindung — dem Schlüssel, unter dem sie in den features: einer Komponente geschrieben ist, oder <alias>.<slot> für eine an einer Verbindung geschriebene Anbindung — niemals mit dem Namen der Komponente, an der die Anbindung sitzt. Ein Schlüssel, der nichts nennt, würde nie herangezogen: Jede Instanz, für die er gedacht war, würde über die Ebene type aufgelöst, und der Build würde enden, ohne ein Wort über den ignorierten Eintrag zu verlieren. Deshalb bricht der Build stattdessen ab, bevor irgendetwas gerendert wird.
Die Meldung nennt das Manifest, den Schlüssel und den Abschnitt, in dem er geschrieben ist, die Namen dieser Art, die der Build tatsächlich enthält — eingegrenzt auf den Typ, den das Recipe oder FeatureRecipe des Eintrags implementiert, wo dieser Typ bekannt ist und der Build einen davon enthält — und, wo sie es erkennen kann, den Namen, den Sie wahrscheinlich gemeint haben: für einen Schlüssel features.name, der der Name einer Komponente ist, die Anbindungen dieses Typs, die die Komponente trägt; für einen Schlüssel components.name, der der Name einer Anbindung ist, die Komponente, die sie trägt; und andernfalls einen Namen, der eine Bearbeitung entfernt ist.
Ausgegebene Meldung, für einen Schlüssel features.name, der als Name der Komponente geschrieben ist, an der die Anbindung sitzt:
a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"? (der Schlüssel eines Namens-Mappings im Manifest nennt keine Komponenteninstanz und keine Anbindung in diesem Build, daher bindet der Eintrag nichts: Manifest, Schlüssel unter mappings.features.name: keine Anbindung in diesem Build trägt diesen Namen; ein features.name-Schlüssel nennt eine Anbindung bei ihrem eigenen Namen — dem Schlüssel, unter dem sie in den features einer Komponente geschrieben ist, oder Alias und Slot für eine an einer Verbindung geschriebene — niemals die Komponente, an die sie angebunden ist; Anbindungen des genannten Typs in diesem Build: aufgeführt; dieser Name ist eine Komponente, und ein features.name-Schlüssel nennt die Anbindung statt der Komponente, an die sie angebunden ist — meinten Sie die vorgeschlagene Anbindung?)
Und für einen Schlüssel components.name, der eine Bearbeitung vom Namen einer Instanz entfernt ist:
a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"? (der Schlüssel eines Namens-Mappings im Manifest nennt keine Komponenteninstanz und keine Anbindung in diesem Build, daher bindet der Eintrag nichts: Manifest, Schlüssel unter mappings.components.name: keine Komponenteninstanz in diesem Build trägt diesen Namen; ein components.name-Schlüssel nennt eine Komponenteninstanz genau so, wie das Aggregate sie schreibt; Komponenteninstanzen des genannten Typs in diesem Build: aufgeführt; meinten Sie die vorgeschlagene Instanz?)
Jeder Schlüssel, der nichts nennt, wird in einem einzigen Build gemeldet, in der Reihenfolge, in der das Manifest sie schreibt.
So beheben Sie es: Benennen Sie den Schlüssel in den Namen um, den die Meldung vorschlägt, oder in einen der Namen, die sie aufführt — bei einer Anbindung den Namen, unter dem sie geschrieben ist, nicht den ihrer Komponente. Wird der Eintrag nicht mehr gebraucht, entfernen Sie ihn; die Instanzen dieses Typs werden dann über die Ebene type aufgelöst.
A Manifest maps two version-distinct keys onto one type (Ein Manifest bildet zwei versionsverschiedene Schlüssel auf einen einzigen Typ ab)
Eine Typsuche hat mehr als einen Mapping-Schlüssel im Manifest getroffen. Typschlüssel werden versionstolerant abgeglichen, sodass core/api-server, core/api-server:1.0.0 und core/api-server:2.0.0, als separate Mapping-Schlüssel geschrieben, alle für denselben Basistyp antworten — und eine Suche, die zwei davon erreicht, hat zwei Recipes zur Auswahl und keine Regel, eines davon zu bevorzugen.
Der Build bricht ab, statt den Schlüssel aufzulösen, den er zufällig zuerst gelesen hat. Einen davon auszuwählen, würde die gerenderte Ausgabe von der Reihenfolge abhängig machen, in der das Mapping durchlaufen wurde, und genau das schließt eine byteidentische Ausgabe aus.
Ausgegebene Meldung:
manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys (das Manifest bildet mehrere versionsverschiedene Schlüssel auf denselben Basistyp ab; die Zuordnung vom Typ zum Recipe ist mehrdeutig: der Typ passt auf versionsverschiedene Schlüssel — pinnen Sie die Version des geschriebenen Typs oder entfernen Sie die doppelten Mapping-Schlüssel)
So beheben Sie es: Es gibt zwei Richtungen, und die Meldung nennt beide. Entfernen Sie die doppelten Mapping-Schlüssel und behalten Sie den, der für den Typ antworten soll — das ist richtig, wenn die zusätzlichen Schlüssel Überbleibsel einer Versionserhöhung sind. Oder pinnen Sie die Version auf der Autorenseite, sodass der Typ, den die Komponente deklariert, genau den Schlüssel nennt, den Sie gemeint haben, was richtig ist, wenn die mehreren Schlüssel beabsichtigt sind und verschiedene Komponenten tatsächlich verschiedene Recipes wollen.
Two catalog entities in one directory share an identity (Zwei Katalogentitäten in einem Verzeichnis teilen sich eine Identität)
Zwei Entitäten derselben Art, aus demselben Katalogverzeichnis geladen, tragen dieselbe Identität. Eine Identität ist das, was eine Referenz nennt, daher lassen zwei Dateien, die eine Identität beanspruchen, jeder Referenz darauf zwei Antworten.
Innerhalb eines Verzeichnisses bricht dies den Build ab; über Verzeichnisse hinweg nicht. Dieselbe Identität in zwei verschiedenen Katalogverzeichnissen wird als Verschattung aufgelöst, bei der der erste Treffer gewinnt — das früher aufgeführte Verzeichnis gewinnt —, und genau das erlaubt es einem lokalen Verzeichnis, eine veröffentlichte Entität bewusst zu überschreiben. Nur eine Kollision innerhalb eines Verzeichnisses ist ein Authoring-Fehler, den keine Lesart als beabsichtigt erscheinen lässt.
Die Regel ist für jede indizierte Entitätsart dieselbe: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary und Aggregate. Der Abbruch wird an der zweiten Datei verortet und nennt die Art und die Identität, die kollidiert sind.
Ausgegebene Meldung:
duplicate entity identity within a single catalog directory (Component identity "<identity>") (doppelte Entitätsidentität innerhalb eines einzelnen Katalogverzeichnisses (Component-Identität))
mit dem eigenen Wort der Art anstelle von Component — recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity und so weiter.
So beheben Sie es: Benennen Sie eine der beiden Entitäten um oder verschieben Sie sie in ein eigenes Verzeichnis. Bei einem Recipe oder einem FeatureRecipe umfasst die Identität den Provider-Geltungsbereich und die Version, sodass zwei Dateien, die sich nur in der Version unterscheiden, nicht kollidieren — eine echte Kollision bedeutet dort, dass dieselbe Version zweimal veröffentlicht wurde. Die übliche Ursache ist, eine Entitätsdatei zu kopieren, um eine neue zu beginnen, und dabei zu vergessen, metadata.name zu ändern.
A file the operation reads leads through a link out of the directory it must stay inside (Eine Datei, die der Vorgang liest, führt über einen Link aus dem Verzeichnis hinaus, in dem sie bleiben muss)
Zwei Orte werden als Ganzes gelesen statt Datei für Datei: ein Katalogverzeichnis, aus jedem Dokument unterhalb dessen eine Suche nach Namen antworten kann, und das Verzeichnis, das ein Release enthält, gegen dessen Aggregates und Manifests ein Release aufgelöst wird, das sie per Identität nennt. Ein symbolischer Link unter diesen Dateien kann überallhin auf dem Rechner führen, daher hat jedes solche Verzeichnis ein Verzeichnis, in dem seine Lesevorgänge bleiben müssen, und ein Link, der daraus hinausführt, wird nicht gelesen. Die Grenze des Workspace legt die Regel fest, die hier angewendet wird, sowie die anderen Pfade, für die sie gilt.
Welches Verzeichnis das ist, hängt davon ab, wo das gelesene Verzeichnis liegt:
Der Workspace, für ein Katalogverzeichnis oder das Verzeichnis eines Release darin. Das gilt für das konventionelle Verzeichnis catalog des Workspace, wann immer niemand es genannt hat — wenn es nur gelesen wird, weil es da ist: Dann gehört es dem Workspace selbst, sodass ein catalog, das selbst ein Link ist, der aus dem Workspace hinausführt, nicht gelesen wird.
Ein von Ihnen genanntes Verzeichnis, das außerhalb des Workspace liegt, für das, was darunter liegt: ein Katalogverzeichnis, das Sie mit --catalog übergeben oder das die Workspace-Konfiguration unter catalog_dirs aufführt — für den Workspace oder für ein einzelnes Release —, und das Verzeichnis eines Release, das Sie nennen oder das die Konfiguration nennt und das außerhalb des Workspace liegt. Das Verzeichnis selbst wird so verwendet, wie Sie es genannt haben — eines, das ein Link ist, wird dort gelesen, wohin es zeigt —, und was darunter gelesen wird, bleibt darin. Das schließt das konventionelle Verzeichnis catalog ein, sobald Sie es nennen: Unter catalog_dirs aufgeführt oder mit --catalog übergeben, wird ein catalog, das ein Link ist, der aus dem Workspace hinausführt, dort gelesen, wohin es zeigt, wie jedes andere Verzeichnis, das Sie nennen. Stattdessen den Ort zu nennen, auf den es zeigt, in beliebiger Schreibweise, oder ein Verzeichnis oberhalb dieses Ortes, nennt es ebenfalls: Das von Ihnen genannte Verzeichnis liest bereits, was dort liegt, sodass es nur einmal gelesen wird, über dieses Verzeichnis. Ein Verzeichnis in der Konfiguration zu nennen, ist der Weg, auf dem ein Workspace Entitäten liest, die außerhalb von ihm aufbewahrt werden.
Beurteilt wird jeder Eintrag, aus dem der Lesevorgang etwas entnehmen würde: ein Link auf eine Datei, die wie ein YAML-Dokument benannt ist, und ein Link auf ein Verzeichnis, das eigene Dokumente enthalten kann. Ein Link, der an einen Ort innerhalb des Verzeichnisses führt, in dem der Lesevorgang bleiben muss, wird dort gelesen, wo der Durchlauf auf ihn trifft. Ein Link auf eine Datei, aus der kein Kataloglesevorgang etwas entnimmt — eine Notizdatei, ein Chart-Archiv —, wird hier nicht beurteilt, und ein Link, der nirgendwohin führt, hat nichts dahinter, das gelesen werden könnte.
Eine Suche, von der eine Kompilierung abhängt, hält bei einem solchen Link an, statt ihn zu übergehen. Die Entität hinter dem Link könnte diejenige sein, die eine Referenz nennt, und sie stillschweigend zu übergehen, würde eine andere Entität gleichen Namens aus einem späteren Katalogverzeichnis an ihrer Stelle aufgelöst werden lassen. Daher halten aggrega build, aggrega pull, aggrega validate, aggrega inspect, wo immer es den Katalog liest, ein Lint eines einzelnen Release sowie die Anfragen des Editors und eines Assistenten, die ein Release bauen, in der Vorschau anzeigen, als Graph darstellen, validieren oder beschreiben, alle an, bevor irgendetwas aufgelöst wird, und nennen den Link. Ein Lint des gesamten Katalogs hält auf dieselbe Weise an: Sein Urteil steht für jedes Dokument ein, das die Katalogverzeichnisse enthalten, daher meldet er keinen sauberen Katalog, während eines davon nicht gelesen werden konnte. Für das Verzeichnis des Release gilt dieselbe Regel überall dort, wo ein Release sein Aggregate oder sein Manifest per Identität nennt oder ein Manifest das Manifest, das es erweitert, auf diese Weise nennt, und der Scan hält bei einem Link unter den Dokumenten neben dem Release an, auch wenn der Link nicht derjenige ist, den eine Referenz nennt, aus demselben Grund, aus dem ihn dort ein Duplikat anhält: Das Verzeichnis kann nicht für einen Namen einstehen, solange eines seiner Dokumente nicht gelesen werden kann. Das Release, für das der Vorgang aufgerufen wurde — oder ein Manifest, das Sie für sich allein inspizieren —, ist keines dieser Dokumente: Es wurde dort gelesen, wo es genannt wurde, daher wird ein Release, das selbst ein Link ist, der hinausführt, dort gelesen, wohin es zeigt, und was es nennt, wird neben dem Link gesucht, in dem Verzeichnis, in dem Sie es genannt haben (Ein Release oder ein Manifest, das über einen Link genannt wird).
Eine Auflistung übergeht einen solchen Link dagegen und listet nichts auf, was dahinter liegt. Der Entitätsindex des Editors, seine Vervollständigungen und die Kandidaten, die er anbietet, listen keine Entität auf, für die ein hinausführender Link steht, und der Entitätsindex nennt einen solchen Link innerhalb des Workspace unter den Links, die er nicht gelesen hat.
Die Konfigurationsdateien des Workspace sind auf dieselbe Weise an den Workspace gebunden. Jede .aggrega-config.yaml vom Stammverzeichnis des Workspace bis hinunter zu dem Verzeichnis, in dem ein Befehl ausgeführt wird, und die .aggrega-config-append-ci.yaml, die eine Pipeline neben einer davon aufbewahrt, ist eigener Inhalt des Workspace. Eine, die ein Link ist, der aus dem Workspace hinausführt — oder die über einen hinausführenden Verzeichnislink erreicht wird —, wird nicht gelesen, und da jeder Befehl, der Sprachserver des Editors und die Werkzeuge eines Assistenten die Konfiguration vor allem anderen lesen, hält jeder davon dort an und nennt den Link, statt mit einer Konfiguration zu laufen, die aus dem Übriggebliebenen gebildet wurde. Der Sprachserver und der Server eines Assistenten, der über seine eigenen Streams kommuniziert, starten über einem solchen Workspace dennoch: Die Auflistungen seiner Releases und seiner Entitäten antworten, ohne jede Konfiguration gelesen, und nennen die Datei unter den Links, die sie nicht gelesen haben, während jede andere Anfrage, über die die Konfiguration entscheidet, mit dieser Bedingung zurückgewiesen wird, wobei der Link genannt wird. Die Abhilfe, die diese Meldung nennt, ist die der Konfiguration selbst: Die globale Konfigurationsdatei ist die einzige Konfiguration, die gelesen wird, wo immer sie aufbewahrt wird, und wird mit --config oder AGGREGA_CONFIG angegeben.
Das Lockfile eines Release wird auf dieselbe Weise gebunden, dort, wo es gelesen wird, wie dort, wo es geschrieben wird. Das Lockfile neben einem Release wird für die Pins gelesen, gegen die ein Build, ein Pull, eine Validierung, ein Lint, eine Inspektion, aggrega cache prune und die Anfragen des Editors und eines Assistenten auflösen, und es ist an das Verzeichnis gebunden, an das sein Schreiben gebunden ist: den Workspace oder das eigene Verzeichnis des Release bei einem Release, das außerhalb davon genannt wird. Eines, das ein Link ist, der hinausführt, wird nicht gelesen, und jeder dieser Vorgänge hält an und nennt den Link, statt gegen Pins aufzulösen, die anderswo auf dem Rechner aufbewahrt werden, oder ohne sie. Die Abhilfe, die diese Meldung nennt, ist die des Lockfiles selbst: Es hat einen einzigen Ort, neben dem Release, an dem ein Pull es schreibt.
Eine neben einer Entität gelesene Datei wird auf dieselbe Weise gebunden. Zwei Vorgänge lesen eine Datei, die neben dem eigenen Dokument einer Entität liegt, statt einer, die eine Referenz nennt. Das Pinnen einer Entität oder ihre Veröffentlichung liest jedes andere YAML-Dokument im Verzeichnis der Entität, um festzustellen, ob eine andere Entität es mit ihr teilt. Das Laden einer Plugin-Entität, die in einem Katalogverzeichnis geschrieben wurde, liest die gebaute .wasm, die daneben abgelegt ist. Jede dieser Dateien ist an das Verzeichnis gebunden, unter dem das eigene Dokument der Entität gelesen wurde — den Workspace, ein Katalogverzeichnis, das Sie außerhalb davon genannt haben, oder, bei einer Entität, die Sie pinnen oder veröffentlichen, indem Sie ihr Dokument außerhalb des Workspace nennen, das eigene Verzeichnis dieses Dokuments —, und eine, die ein Link ist, der daraus hinausführt, wird nicht gelesen. aggrega pin, aggrega push mit oder ohne --dry-run, ein Pull, der pinnt, sowie das Pinnen und die Veröffentlichung durch den Editor und einen Assistenten halten an und nennen den Link, weil ein ungelesen gebliebenes Dokument die Entität sein könnte, die im Weg steht. Auch ein Build oder ein Pull, der das Plugin lädt, hält an und nennt den Link, statt Bytes auszuführen, die anderswo auf dem Rechner aufbewahrt werden, oder das Plugin stattdessen woanders zu suchen. Die Abhilfe, die diese Meldung nennt, ist die einer Datei neben einer Entität: Bewahren Sie die Datei selbst dort auf.
Der Artefakt-Cache des Workspace wird auf dieselbe Weise gebunden, dort, wo er gelesen wird, wie dort, wo er geschrieben wird. Alles, was aus dem Cache unter artifact_cache_dir gelesen wird — eine zwischengespeicherte Entität, ein Plugin oder eine Bibliothek und das Manifest daneben, ein Quellarchiv und seine Metadaten, eine gepinnte externe Eingabe, ein Signatur-Bundle, der lokale Suchindex einer Registry —, und jeder Workspace-Eintrag, den aggrega cache status, aggrega cache prune und aggrega cache clear auflisten, ist an das Verzeichnis gebunden, an das ein Schreiben in den Cache gebunden ist: das Cache-Verzeichnis selbst, das Standardverzeichnis .aggrega/cache ebenso wie eines, das die Konfiguration nennt und das aus dem Stammverzeichnis des Workspace hinaufsteigt. Alles darin, was ein Link ist, der aus dem Cache-Verzeichnis hinausführt — an eine andere Stelle innerhalb des Workspace ebenso wie anderswohin —, wird nicht gelesen, und ebenso wenig alles hinter einem innerhalb des Stammverzeichnisses des Workspace geschriebenen Cache-Verzeichnis, das selbst ein Link ist, der aus dem Workspace hinausführt: Ein Build, ein Pull, eine Validierung, eine Suche, die drei Cache-Befehle und die Anfragen des Editors und eines Assistenten, die den Cache lesen, halten an und nennen den Link — einschließlich Inhalten, die der Cache unter einem aufgezeichneten Digest aufbewahrt, da ein Digest sagt, was die Bytes sind, nicht, wo sie gelesen werden dürfen. Ein innerhalb des Stammverzeichnisses des Workspace geschriebenes Cache-Verzeichnis, das ein Link an eine andere Stelle innerhalb des Workspace ist, wird dort gelesen, wohin es führt. Der Veraltungshinweis, den aggrega inspect ausgibt und der nichts entscheidet, ist ausgenommen. Ein Prune oder ein Clear behandelt eines der eigenen Verzeichnisse des Cache, das ein Link ist, der aus dem Cache-Verzeichnis hinausführt, oder ein Cache-Verzeichnis, das selbst ein Link ist, der aus dem Workspace hinausführt, als die Entfernung, die es wäre, unter „A path the operation writes leads through a link out of the directory it must stay inside (Ein Pfad, den der Vorgang schreibt, führt über einen Link aus dem Verzeichnis hinaus, in dem er bleiben muss)“, bevor er irgendetwas auflistet. Die Abhilfe, die diese Meldung nennt, ist die des Cache selbst: Ist der Link entfernt, füllt ein Pull den Cache erneut, und ein anderswo aufbewahrter Cache wird mit artifact_cache_dir angegeben, relativ zum Stammverzeichnis des Workspace, statt über einen Link erreicht zu werden.
Ein Repository, das eine Quelle abruft, ist an seinen eigenen Checkout gebunden. Wenn ein Pull — aggrega pull oder ein Build oder eine Anfrage des Editors oder eines Assistenten, die die Abhängigkeiten eines Release auflöst — eine Quelle git-repository abruft, checkt er das Repository aus und archiviert das Verzeichnis, das die Quelle nennt, und der Checkout ist ein eigenes Verzeichnis: Jeder Link, den das Repository enthält, module_subdir selbst eingeschlossen, ist an ihn gebunden. Ein Link auf eine Datei oder ein Verzeichnis innerhalb des Repository wird als das archiviert, worauf er zeigt, unter dem Namen des Links. Ein Link, der aus dem Repository hinausführt — und auf jede beliebige Datei auf dem Rechner zeigen könnte, auf dem der Pull läuft —, wird nicht gelesen: Der Pull hält an und nennt den Link und sein Ziel, und nichts wird zwischengespeichert. Der Checkout ist ein temporäres Verzeichnis, das entfernt wird, sobald der Pull anhält, daher nennt die Meldung den Link über seine Stelle im Repository — chart/secret.txt, wie in der ersten Zeile der Befehlszeilenausgabe und im Satz — und das Verzeichnis, in dem er bleiben muss, als das Repository und die Revision, die die Quelle nennt: which must stay inside the repository <url> at <ref> (commit <commit>) oder at commit <commit>, wo die Quelle keinen ref nennt oder den Commit selbst nennt. Wohin der Link führt, wird als der Ort auf Ihrem Rechner genannt, der er ist. Die Abhilfe, die diese Meldung nennt, ist die des Repository selbst: Der Link ist dort committet, also wird er dort geändert — so, dass er innerhalb des Repository zeigt, oder durch die Datei selbst ersetzt —, und die Quelle nennt dann eine Revision, die die Änderung enthält. Ein Verzeichnislink, der zurück in ein Verzeichnis führt, das die Archivierung bereits über ihn liest, hält den Pull ebenfalls an, weil der Baum, für den er steht, kein Ende hat; diese Zurückweisung ist ein gewöhnlicher Fehler und nicht diese Bedingung.
Die Überlagerungen, die eine Kataloggenerierung liest, werden auf dieselbe Weise gebunden.aggrega plugin gen-catalog --from-embedded liest jede Überlagerung unterhalb des Überlagerungsverzeichnisses, das es erhält — mit --overlay eingegeben, im Editor ausgewählt oder von einem Assistenten genannt —, und bindet jede an das Verzeichnis, unter dem dieses Überlagerungsverzeichnis gelesen wird: den Workspace, für ein Überlagerungsverzeichnis darin, und das Überlagerungsverzeichnis selbst für eines, das außerhalb des Workspace genannt wird. Das Überlagerungsverzeichnis wird so verwendet, wie Sie es genannt haben — eines, das ein Link ist, wird dort gelesen, wohin es zeigt. Eine Überlagerung darunter, die ein Link ist, der aus dem Verzeichnis hinausführt, an das sie gebunden ist, wird nicht gelesen, und ebenso wenig ein Verzeichnislink, der daraus hinausführt und eigene Überlagerungen enthalten kann: Die Generierung hält an und nennt den Link, ohne etwas zu schreiben, statt ohne die Überlagerung zu generieren. Eine Überlagerung, die ein Link an eine andere Stelle innerhalb des Verzeichnisses ist, an das sie gebunden ist, wird dort gelesen, wohin sie zeigt; ein Verzeichnislink, der hineinführt, wird nicht betreten. Die Abhilfe, die diese Meldung nennt, ist die einer Überlagerung: Bewahren Sie die Überlagerung selbst unterhalb des Überlagerungsverzeichnisses auf, oder nennen Sie ein Verzeichnis, das alle Überlagerungen enthält, als Überlagerungsverzeichnis.
Ein Verzeichnis, das Sie importieren, ist an sich selbst gebunden.aggrega import mit einem Verzeichnis, das Import-Werkzeug des Assistenten und die Methode aggrega/import der Sitzung übergeben dem Importer die Dateien des Verzeichnisses, die seine Dateimuster auswählen, jede an ihrem Platz im Verzeichnis, sodass das Verzeichnis dasjenige ist, innerhalb dessen diese Lesevorgänge bleiben, wo immer es liegt — innerhalb des Workspace ebenso wie außerhalb. Beurteilt wird jeder Eintrag, aus dem der Import etwas übernehmen würde: ein Link auf eine Datei, die eines der maßgeblichen Muster auswählt — die Muster des Importers, der das genannte Format bedient, oder, wo das Format erkannt wird, die jedes Importers, zwischen denen der Import wählt, die Core-Importer des Compilers eingeschlossen — und ein Link auf ein Verzeichnis, das nie betreten wird. Ein Link, der aus dem Verzeichnis hinausführt, an eine andere Stelle im Workspace oder anderswohin, wird nicht gelesen: Der Import bricht ab und nennt den Link, bevor irgendeine Datei des Verzeichnisses geöffnet wird, ohne dass etwas geschrieben wird. Ein ausgewählter Link auf eine Datei an anderer Stelle innerhalb des Verzeichnisses wird dort gelesen, wohin er zeigt, unter dem eigenen Namen des Links, und ein Link auf eine Datei, die kein Muster auswählt, wird weder beurteilt noch gelesen. Das Verzeichnis selbst wird so verwendet, wie Sie es genannt haben — eines, das ein Link ist, wird dort gelesen, wohin es zeigt. Über einen Listener erreicht, nennt das Werkzeug des Assistenten den Link mit seinem Platz im Workspace und sagt nichts darüber, wohin er führt. Die Abhilfe, die diese Meldung nennt, ist die eines importierten Verzeichnisses: Behalten Sie die Datei selbst im Verzeichnis statt eines Links darauf, oder importieren Sie das Verzeichnis, zu dem der Link führt.
Ausgegebene Meldung. Sie beginnt mit dem eigenen Satz der Bedingung, dann folgen der Pfad, den der Lesevorgang erreicht hat, das Verzeichnis, innerhalb dessen er bleiben muss, der Link, auf den er unterwegs trifft, und der Ort, zu dem dieser Link führt, dann die Abhilfe:
a file this operation reads leads through a link out of the directory it must stay inside (reading <workspace>/catalog-local/component/app/1.0.0/component.yaml, which must stay inside <workspace>, the link <workspace>/catalog-local/component/app/1.0.0/component.yaml leads to <elsewhere>/component.yaml). nothing was read through that link. Remove the link, or make it lead to a place inside <workspace>. To read what is kept outside, list the directory holding it as a catalog directory in the workspace configuration, rather than reaching it through a link beneath one: a listed directory is read where it leads, even when it is itself a link (eine Datei, die dieser Vorgang liest, führt über einen Link aus dem Verzeichnis hinaus, innerhalb dessen sie bleiben muss (beim Lesen einer Datei, die innerhalb des Workspace bleiben muss, führt der Link anderswohin). über diesen Link wurde nichts gelesen. Entfernen Sie den Link, oder lassen Sie ihn zu einem Ort innerhalb des Workspace führen. Um zu lesen, was außerhalb aufbewahrt wird, führen Sie das Verzeichnis, das es enthält, in der Konfiguration des Workspace als Katalogverzeichnis auf, statt es über einen Link unterhalb eines solchen zu erreichen: Ein aufgeführtes Verzeichnis wird dort gelesen, wohin es führt, auch wenn es selbst ein Link ist)
Die Diagnose trägt keine Kategorie: Fehlerhaft ist die Anordnung auf der Festplatte, nicht ein Dokument, das Sie geschrieben haben.
So beheben Sie es: Ersetzen Sie den Link durch eine Kopie dessen, wohin er führt, oder entfernen Sie ihn; oder, wo die Entität außerhalb des Workspace bleiben soll, führen Sie das Verzeichnis, das sie enthält, unter catalog_dirs in der Konfiguration des Workspace auf, oder übergeben Sie es mit --catalog, sodass das Verzeichnis als eigenes Katalogverzeichnis gelesen wird. Führen Sie das Verzeichnis auf, zu dem der Link führt, nicht dasjenige, in dem er liegt: Ein Link, der unterhalb eines Verzeichnisses angetroffen wird, wird gleich beurteilt, wie auch immer dieses Verzeichnis gelesen wurde, sodass das Aufführen nichts ändert. Wo der Link das konventionelle Verzeichnis catalog des Workspace selbst ist, genügt es, catalog — oder das Verzeichnis, auf das es zeigt — unter catalog_dirs aufzuführen oder eines von beiden mit --catalog zu übergeben, da ein Verzeichnis, das Sie nennen, dort gelesen wird, wohin es zeigt. Wo der Link die Lockfile eines Release ist, entfernen Sie ihn und führen Sie erneut einen Pull des Release aus, der daneben eine neue Lockfile schreibt. Ein Manifest hat keine Katalogebene, daher wird ein Manifest, das das Release liest, neben dem Release selbst aufbewahrt. Wo der Link eine Konfigurationsdatei ist, ersetzen Sie ihn durch eine Kopie im Workspace; eine Konfiguration, die Sie zwischen Workspaces teilen möchten, wird gelesen, indem Sie sie als globale Konfigurationsdatei nennen, mit --config oder AGGREGA_CONFIG, unterhalb der eigenen Dateien jedes Workspace. Wo der Link neben einer Entität liegt, die gepinnt oder veröffentlicht wird, ersetzen Sie ihn durch die Datei selbst, oder verschieben Sie ein Dokument, das eine Entität ist, in ein eigenes Verzeichnis; wo er die .wasm neben einer Plugin-Entität ist, legen Sie dort die gebaute .wasm selbst ab. Wo der Link das Artefakt-Cache-Verzeichnis oder etwas darin ist, entfernen Sie ihn — ein Pull füllt den Cache erneut — oder, um den Cache anderswo zu halten, setzen Sie artifact_cache_dir auf dieses Verzeichnis, relativ zum Wurzelverzeichnis des Workspace geschrieben (../shared-cache). Wo der Link in einem Repository committet ist, das eine Quelle git-repository abruft, ändern Sie ihn in diesem Repository — lassen Sie ihn innerhalb des Repositorys zeigen, oder committen Sie die Datei selbst — und nennen Sie die Revision, die die Änderung enthält. Wo der Link eine Überlagerung unterhalb des Überlagerungsverzeichnisses einer Katalog-Generierung ist, ersetzen Sie ihn durch die Überlagerung selbst, oder nennen Sie ein Verzeichnis, das jede Überlagerung enthält, als Überlagerungsverzeichnis. Wo der Link in einem Verzeichnis liegt, das Sie importieren, behalten Sie die Datei selbst im Verzeichnis statt eines Links darauf, oder importieren Sie das Verzeichnis, zu dem der Link führt.
A reference to another file leads out of the directory it must stay inside (Ein Verweis auf eine andere Datei führt aus dem Verzeichnis hinaus, innerhalb dessen er bleiben muss)
Ein Release und ein Manifest können eine andere Datei über einen Pfad nennen: aggregate: und manifest: eines Release, geschrieben als ./… oder ../…, sein extends:, das extends: eines Manifest, als Pfad geschrieben, und die parameters: { $import: … } eines Release. Ein Dokument im Workspace erreicht auf diese Weise nur Dateien innerhalb des Workspace. Ein Release, das außerhalb des Workspace liegt — eines, das Sie auf der Befehlszeile nennen, oder eines, das die Konfiguration des Workspace nennt —, und ein Manifest, das Sie allein auf der Befehlszeile außerhalb des Workspace nennen, erreichen nur Dateien innerhalb ihres eigenen Verzeichnisses: Dieses Verzeichnis ist eine eigene Wurzel, wie es ein Verzeichnis ist, das Sie außerhalb des Workspace nennen, und jedes Release, zu dem seine Kette extends: führt, ist an dasselbe Verzeichnis gebunden. Ein Pfad, der so, wie er geschrieben ist, aus diesem Verzeichnis hinaufsteigt, und ein Pfad, der wie geschrieben innerhalb bleibt, aber unterwegs auf einen symbolischen Link trifft, der hinausführt, werden beide zurückgewiesen, und aus der Datei, die sie nennen, wird nichts gelesen. Ein Pfad, der zu einer Datei führt, die unterhalb des Verzeichnisses noch nicht vorhanden ist, wird hier nicht zurückgewiesen; er wird als Datei gemeldet, die nicht gelesen werden konnte. Die Grenze des Workspace erläutert, warum neben dem Pfad, den Sie nennen, auch ein Verweis gebunden wird.
Von wo aus ein Pfad aufgelöst wird, folgt derselben Regel, die die Sprachreferenz für jeden Schlüssel lehrt: aggregate: und manifest: eines Release sowie das extends: eines Manifest neben dem Release, das ein Befehl oder eine Anfrage nennt — oder, für ein Manifest, das Sie allein nennen, neben diesem Manifest; das extends: eines Release und ein $import: der Parameter neben dem Release, das es schreibt, sodass jedes Glied einer Kette extends: seinen Elternteil neben sich selbst nennt. Die Diagnose nennt das Verzeichnis, von dem aus aufgelöst wurde.
Ein Name statt eines Pfads wird hier nicht beurteilt — aggregate: payments, extends: base-manifest. Er wird unter den Dokumenten neben dem Release gesucht und, für ein Aggregate, in den Katalogverzeichnissen, die von der Regel in „A file the operation reads leads through a link out of the directory it must stay inside (Eine Datei, die der Vorgang liest, führt über einen Link aus dem Verzeichnis hinaus, in dem sie bleiben muss)“ weiter oben gebunden werden.
Jede Oberfläche, die auflöst, was ein Release nennt, bricht dabei ab, bevor die Datei gelesen wird: aggrega pull, aggrega build, aggrega validate, aggrega inspect eines Release oder eines Manifest, ein Lint eines einzelnen Release sowie die Anfragen des Editors und eines Assistenten, die ein Release bauen, in der Vorschau anzeigen, als Graph darstellen, validieren oder beschreiben. Im Editor wird die Diagnose auf den Schlüssel im Release gesetzt, der zur Datei geführt hat.
Ausgegebene Meldung. Sie beginnt mit dem eigenen Satz der Bedingung, dann folgen der Verweis, wie er geschrieben ist, das Dokument, in dem er geschrieben ist, für ein extends: und ein $import: der Parameter, das Verzeichnis, von dem aus er aufgelöst wird, der Ort, zu dem er führt, das Verzeichnis, innerhalb dessen er bleiben muss, und der Link, wo einer ihn hinausführt; dann die Abhilfe. Für ein Dokument im Workspace:
a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (ein Verweis, den ein Dokument auf eine andere Datei macht, führt aus dem Verzeichnis hinaus, innerhalb dessen er bleiben muss: Der Verweis, vom Workspace aus aufgelöst, führt aus dem Workspace hinaus. aus dieser Datei wurde nichts gelesen. Ein Dokument im Workspace erreicht nur Dateien innerhalb des Workspace: Verschieben Sie die Datei dorthin — oder, wo ein Link den Verweis hinausführt, lassen Sie den Link dorthin führen — oder öffnen Sie den Workspace in einem Verzeichnis, das beide Dokumente enthält. Ein Aggregate, das außerhalb dieses Verzeichnisses aufbewahrt wird, wird über seinen Namen statt über einen Pfad erreicht, aus einem Katalogverzeichnis, das die Konfiguration des Workspace aufführt)
und für ein Release oder ein Manifest, das außerhalb des Workspace genannt wird und dessen eigenes Verzeichnis dasjenige ist, innerhalb dessen es bleiben muss:
a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (ein Verweis, den ein Dokument auf eine andere Datei macht, führt aus dem Verzeichnis hinaus, innerhalb dessen er bleiben muss: Der Verweis, vom Verzeichnis aus aufgelöst, führt aus dem Verzeichnis eines Dokuments hinaus, das außerhalb des Workspace genannt wird. aus dieser Datei wurde nichts gelesen. Ein Release oder ein Manifest, das außerhalb des Workspace genannt wird — auf der Befehlszeile oder durch die Konfiguration des Workspace —, erreicht nur Dateien innerhalb seines eigenen Verzeichnisses: Verschieben Sie die Datei dorthin — oder, wo ein Link den Verweis hinausführt, lassen Sie den Link dorthin führen — oder nennen Sie das Dokument aus einem Workspace, der beide Dokumente enthält. Ein Aggregate, das außerhalb dieses Verzeichnisses aufbewahrt wird, wird über seinen Namen statt über einen Pfad erreicht, aus einem Katalogverzeichnis, das die Konfiguration des Workspace aufführt)
mit written in <document> nach dem Verweis für ein extends: oder ein $import: der Parameter, und the link <link> leads to <place> am Ende, wo ein Link den Pfad hinausführt. Ein Verweis aggregate: oder manifest: nennt kein Dokument: Ein Release, das ein anderes erweitert, kann ihn von einem Release weiter oben in der Kette geerbt haben, und er wird in jedem Fall neben dem Release aufgelöst, das der Befehl nennt.
Die Kategorie der Diagnose ist [OPS_ERROR]: Der Verweis ist in einem Release oder einem Manifest geschrieben.
So beheben Sie es: Schreiben Sie für ein Aggregate, das außerhalb des Workspace aufbewahrt wird, seinen metadata.name statt eines Pfads, und führen Sie das Verzeichnis, das es enthält, unter catalog_dirs in der Konfiguration des Workspace auf, oder übergeben Sie es mit --catalog — ein Katalogverzeichnis ist die Art, wie ein Workspace Entitäten erreicht, die außerhalb von ihm aufbewahrt werden. Ein Manifest, ein Release, das ein extends: nennt, und eine Parameterdatei werden neben dem Release gelesen und nie über ihren Namen gesucht; behalten Sie sie also innerhalb des Workspace, oder öffnen Sie den Workspace in einem Verzeichnis, das sowohl das Release als auch die Datei enthält. Für ein Release oder ein Manifest, das Sie von außerhalb des Workspace genannt haben, behalten Sie das, was es nennt, in seinem eigenen Verzeichnis, oder bauen Sie es in dem Workspace, der sowohl das Dokument als auch das, was es nennt, enthält. Wo ein Link den Pfad hinausführt, ersetzen Sie den Link durch eine Kopie dessen, wohin er führt, oder lassen Sie ihn innerhalb des Verzeichnisses führen.
No catalog version satisfies a version constraint (Keine Katalogversion erfüllt eine Versionseinschränkung)
Ein Verweis nennt eine Entität, die der Katalog enthält, und pinnt eine Version, die der Katalog nicht enthält: eine exakte Version, die fehlt, oder einen Caret-Bereich, zu dem nichts Verfügbares passt. Das ist von einem einfachen Fehltreffer zu unterscheiden, bei dem der Name selbst unbekannt ist — hier existiert die Entität und nur die Version ist nicht erfüllbar, weshalb die Meldung genau das sagt, statt die Entität als fehlend zu melden und Sie nach einem Tippfehler im Namen suchen zu lassen.
Jede Entitätsart erreicht dies über eine einzige Auswahl, sodass sich ein nicht erfüllbarer Pin überall gleich verhält, wo er geschrieben ist: Ein Versionstippfehler im Recipe-Mapping eines Manifest wird genau so zurückgewiesen wie derselbe Tippfehler beim Typ einer Komponente.
Die Bedingung ist behebbar, und genau das erlaubt dem Editor, sie als Diagnose anzuzeigen, während Sie weitertippen, statt das Dokument aufzugeben. Auf der Befehlszeile wird sie zu einem Abbruch zusammengeführt.
Ausgegebene Meldung, für einen Verweis, den die Abhängigkeiten eines Release erreichen — einen Komponententyp, einen Mapping-Wert eines Manifest —, mit Angabe, wo er gesammelt wurde:
no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (keine Katalogversion erfüllt die referenzierte Versionseinschränkung)
Ausgegebene Meldung, für einen Pin auf einem Zeiger extends::
no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (keine Katalogversion erfüllt die referenzierte Versionseinschränkung: Keine Katalogversion erfüllt das extends-Elternelement)
mit Feature anstelle von Component, wo die Kette eines Feature den Pin trägt.
So beheben Sie es: Ändern Sie den Pin in eine Version, die der Katalog enthält, oder fügen Sie diese Version dem Katalog hinzu. aggrega inspect listet die Versionen auf, in denen eine Entität verfügbar ist. Ein Caret-Bereich, zu dem nichts passt, bedeutet meist, dass die verfügbaren Versionen alle unter der Untergrenze liegen, die er nennt — erweitern Sie den Bereich, oder veröffentlichen Sie die Version, auf die der Verweis wartet.
Ein Pin, der keine der Formen hat, die ein Pin annimmt, ist eine andere Bedingung, die weiter unten unter „A version pin is none of the forms a pin takes (Ein Versions-Pin hat keine der Formen, die ein Pin annimmt)“ beschrieben wird.
A version pin is none of the forms a pin takes (Ein Versions-Pin hat keine der Formen, die ein Pin annimmt)
Eine Referenz benennt eine andere Entität und kann die gewünschte Version nach einem Doppelpunkt pinnen, in einer von zwei Formen: ein exakter Pin, also eine semantische Version wie 1.0.0 — die Form, die das metadata.version jeder Entität annimmt — oder ein Caret-Pin, ^ gefolgt von einer Version wie ^1.0.0, der die höchste damit kompatible Version auswählt. Ein Pin, der keines von beiden ist — ein Caret, dessen Text sich nicht als Versionsbereich lesen lässt, wie ^garbage, oder ein exakter Pin, der keine semantische Version ist, wie 1.x, 1.0 oder v1.0.0 —, benennt überhaupt keine Version, sodass kein Katalog enthalten könnte, was er verlangt.
Ein solcher Pin wird als fehlerhaft gemeldet statt als Entität oder Version, die der Katalog nicht enthält, sodass die Diagnose Sie auf den eingegebenen Text verweist, statt Sie nach etwas suchen zu lassen, das nicht existiert. Es ist dieselbe Bedingung, wo immer der Pin geschrieben ist: der type einer Komponente oder eines Feature, das extends: einer Component oder eines Feature, ein Mapping-Schlüssel oder -Wert eines Manifest, das spec.aggregate eines Release, das implements: eines Recipe oder FeatureRecipe, die Version, die das capability: eines Recipe pinnt, wenn das Plugin ausgewählt wird, das diese Fähigkeit bedient, und das plugin: eines Pipeline-Schritts.
Er wird dort gemeldet, wo eine Referenz gemeldet wird, die sich nicht auflösen ließ, sodass ein fehlerhafter Pin nie ändert, welche Referenzen sich auflösen — er ändert, was der Fehler aussagt. Ein Pin, der wohlgeformt ist, den aber keine verfügbare Version erfüllt, behält die Bedingung, die diese Oberfläche für ihn meldet: „No catalog version satisfies a version constraint (Keine Katalogversion erfüllt eine Versionseinschränkung)“ oben oder die Nicht-gefunden-Bedingung der Oberfläche, auf der er geschrieben ist.
Nur der Text nach dem letzten Doppelpunkt ist ein Pin, und nur, wenn er kein / enthält. Eine Referenz auf einen Registry-Host mit Port, wie localhost:5000/core/api-server, trägt daher keinen Pin — der Text nach dem Doppelpunkt des Ports setzt die Referenz fort — und wird nie als fehlerhafter Pin gemeldet.
Ausgegebene Meldung für einen Caret-Pin auf einem Komponententyp:
reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it (Referenz trägt einen fehlerhaften Versions-Pin (Referenz, Pin, der Text nach ^ ist kein Versionsbereich, referenziert von der geschriebenen Stelle). Schreiben Sie die Referenz als Name, als Name:Version mit einer semantischen Version wie 1.0.0 oder als Name:^Version für die höchste damit kompatible Version)
Ein exakter Pin lautet an exact pin must be a semantic version anstelle der Caret-Klausel. Der Wert danach gibt an, wo die Referenz geschrieben wurde, in den Worten der Oberfläche, die sie meldet — referenced from und die geschriebene Stelle, in the Release's spec.aggregate oder in the recipe's spec.implements. Wo ein Manifest-Mapping gegen das implements: seines Recipe geprüft wird, stehen stattdessen der Mapping-Eintrag und die Seite davon, die den Pin trägt — in the mapping key oder in the recipe's spec.implements —, vor der Referenz, und das extends: einer Component oder eines Feature nennt die erweiternde Entität und das Feld davor.
So beheben Sie es: Schreiben Sie den Pin in einer der beiden Formen neu, oder entfernen Sie ihn, um die höchste verfügbare Version auszuwählen. Ein Platzhalter wie 1.x wird als Caret-Pin geschrieben, ^1.0.0; eine Version mit führendem v oder weniger als drei Zahlen wird vollständig geschrieben, 1.0.0.
Every version a reference could select has been withdrawn (Jede Version, die eine Referenz auswählen könnte, wurde zurückgezogen)
Eine Referenz löst sich zu einem Repository auf, das die Registry enthält, und jede Version, aus der die Versionserkennung hätte wählen können, wurde als zurückgezogen markiert. Es bleibt nichts Auswählbares übrig.
Dies wird bewusst nicht als fehlende Entität gemeldet. Das Repository existiert und enthält diese Versionen noch; es als abwesend zu bezeichnen, würde das falsche Problem benennen, Sie nach einem Tippfehler suchen lassen und wie ein stiller Rückfall wirken statt wie die Zurückweisung, die es ist. Die Meldung nennt jede zurückgezogene Version mit dem dafür erfassten Grund, sodass Ihnen das gesagt wird, was der Herausgeber erfasst hat.
Eine zurückgezogene Version ausdrücklich zu benennen, ist nicht dieser Abbruch. Eine exakte Version umgeht die Versionserkennung vollständig, daher ist das Pinnen einer solchen Version der Weg, sie bewusst weiter zu verwenden; der Build meldet den Rückzug und fährt fort.
Ausgegebene Meldung:
every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (jede veröffentlichte Version, die diese Referenz auswählen könnte, wurde zurückgezogen: zurückgezogen, jeweils mit dem erfassten Grund)
So beheben Sie es: Lesen Sie die erfassten Gründe, die meist nennen, worauf umzusteigen ist. Migrieren Sie zu dem, was die zurückgezogene Entität ersetzt — das ist das Ergebnis, das ein Rückzug verlangt. Wo Sie die alte vorerst behalten müssen, pinnen Sie in der Referenz eine exakte Version: Die Version zu benennen ist das, was ausdrückt, dass Sie sie akzeptieren, und der Build meldet dann jedes Mal den Rückzug, statt zurückzuweisen.
A plugins.providers binding names a plugin that does not serve the capability (Eine Bindung benennt ein Plugin, das die Fähigkeit nicht bedient)
Der Block plugins.providers des Workspace wählt eine Plugin-Identität für eine Fähigkeit aus, und kein Provider-Rendering-Plugin, das diese Fähigkeit bedient, trägt diese Identität. Die Bindung ist eine ausdrückliche Wahl, die der Katalog nicht erfüllen kann, daher führt sie zum Abbruch, statt stillschweigend auf ein anderes Plugin zurückzufallen — ein Rückfall würde Ihre Ausgabe über ein Plugin rendern, das Sie ausdrücklich nicht verwenden wollten, und nichts dazu sagen.
Eine Bindung wählt nach der Koordinatenidentität des Plugins aus — dem Plugin-Typ und dem Namen des Plugins, was auch das ist, was das Lockfile pinnt — und kann danach eine Version tragen.
Sie wird geprüft, unabhängig davon, ob ein Recipe die Fähigkeit anfordert. Ansonsten wird eine Bindung nur gelesen, wenn das capability: eines Recipe sie benennt, sodass eine Bindung mit falsch geschriebener Fähigkeit von nichts konsultiert und von nichts gemeldet würde. Jeder Build und jedes aggrega validate --release prüft daher jede Bindung, die ein Plugin benennt: Ein Pull löst eine solche Bindung auf, ob ein Recipe sie verwendet oder nicht, sodass der Build das Plugin enthält und weiß, was es bedient, und eine Fähigkeit, die dieses Plugin nicht bedient, ist sicher falsch. Die Prüfung liest die Bindungen in der Workspace-Konfiguration, nicht das Lockfile, und ändert nichts daran, welches Plugin ein Recipe rendert — das bleibt Sache des Lockfile. Eine Bindung, die ein Plugin benennt, das der Build nicht enthält — ein Registry-Plugin, das noch kein Pull abgerufen hat —, wird erst geprüft, wenn ein Pull es abgerufen hat. Eine Bindung, die kein Plugin benennt, wird anders beurteilt, als Hinweis: siehe „A provider binding names a capability no plugin the build reads serves (Eine Provider-Bindung benennt eine Fähigkeit, die kein vom Build gelesenes Plugin bedient)“ unter „Bedingungen, die einen Build nicht abbrechen“ weiter unten.
Ausgegebene Meldung, die ergänzt, was das benannte Plugin tatsächlich bedient, und eine Schreibweise, die eine Bearbeitung entfernt ist, wenn die Fähigkeit der Bindung eine solche ist:
plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (der Eintrag plugins.providers benennt ein Plugin, dem kein Provider-Rendering-Plugin entspricht, das die Fähigkeit bedient: Die Fähigkeit ist an das Plugin gebunden, aber kein Provider-Rendering-Plugin, das sie bedient, entspricht dieser Identität; das Plugin bedient eine andere Fähigkeit, und die Fähigkeit ist eine Bearbeitung von ihr entfernt)
Wo das Plugin, das die Bindung benennt, nicht in dem Katalog ist, den der Build liest, endet die Meldung nach „matches that identity (entspricht dieser Identität)“, weil es nichts darüber zu sagen gibt, was es bedient.
So beheben Sie es: Prüfen Sie zuerst die Schreibweise der Bindung gegen die eigene Koordinate des Plugins — eine Bindung, die die Fähigkeit nennt, wo sie das Plugin nennen sollte, ist der häufige Fehler. Wo die Meldung eine Fähigkeit nennt, die eine Bearbeitung von der geschriebenen entfernt ist, ist das capability: der Bindung der Tippfehler. Prüfen Sie dann, ob das Plugin in dem Katalog ist, den der Build liest, und ob es diese Fähigkeit unter spec.provider.capabilities aufführt; ein Plugin, das die Fähigkeit früher bediente und sie nicht mehr deklariert, erzeugt genau diese Meldung. Die Bindung zu entfernen ist die richtige Lösung, wo nur ein Plugin die Fähigkeit bedient, da die Bindung dann nichts zu unterscheiden hat.
No provider plugin version satisfies a Recipe’s provider pin (Keine Provider-Plugin-Version erfüllt den Provider-Pin eines Recipe)
Ein Recipe bindet einen versionsgepinnten Provider — helm:1.0.0 oder helm:^1.0.0 —, und keine Plugin-Version für das Provider-Rendering erfüllt den Pin. Der Pin ist eine ausdrückliche Anforderung, daher bricht der Build ab, statt ihn zu ignorieren und über die Version zu rendern, die den Provider gerade bedient; einen Pin stillschweigend zu übergehen, würde eine Ausgabe erzeugen, die laut der eigenen Deklaration des Autors nicht existieren sollte.
Zwei Situationen führen dazu, und die Meldung unterscheidet sie: Nichts bedient die Fähigkeit überhaupt, oder etwas bedient sie und keine seiner Versionen erfüllt die Einschränkung.
Dies unterscheidet sich von einer nicht erfüllbaren Entitäts-Version weiter oben. Jene betrifft eine Katalogentität, die in einer Version benannt ist, die der Katalog nicht enthält; diese betrifft die Auswahl des Plugins, das eine Fähigkeit rendert.
Ausgegebene Meldungen:
no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (keine Plugin-Version für das Provider-Rendering erfüllt den Provider-Versions-Pin des Recipe: Die Fähigkeit pinnt eine Version, aber kein Provider-Rendering-Plugin bedient sie) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (keine Plugin-Version für das Provider-Rendering erfüllt den Provider-Versions-Pin des Recipe: Die Fähigkeit pinnt eine Version, aber keine Version eines bedienenden Plugins erfüllt sie)
So beheben Sie es: Erweitern oder korrigieren Sie den Pin im Feld capability: des Recipe, oder fügen Sie die angeforderte Plugin-Version dem Katalog hinzu. Ein Caret-Pin passt auf Versionen ab der Untergrenze innerhalb derselben Hauptversion, daher wird ein Pin ^2.0.0 von keinem Plugin der Version 1.x erfüllt, wie neu es auch sei. Wo die Meldung sagt, dass nichts die Fähigkeit bedient, ist nicht der Pin das Problem: Das Plugin fehlt vollständig, und das Entfernen des Pins hilft nicht.
No plugin advertises a requested parse or import format (Kein Plugin weist ein angefordertes Parse- oder Importformat aus)
Ein Format wurde angefordert, und kein Plugin weist es aus. Die beiden Sockets, die nach Format routen, haben jeweils ihre eigene Bedingung und unterscheiden sich nur darin, welche Arbeit angefordert wurde: Ein Parser-Plugin liest ein fremdes Quellformat, und ein Importer-Plugin übernimmt fremde Inhalte als Aggrega-Entitäten.
Der Formatraum ist offen und gehört vollständig den Plugins. Keiner der beiden Sockets hält eine Liste von Formaten, die der Compiler kennt: Ein Plugin deklariert die Formate, die es verarbeitet, als Fähigkeiten, und ein neues Format wird als neues Plugin ausgeliefert, ohne Änderung am Compiler. Daher meldet dieser Abbruch die ausgewiesene Menge, wie sie ist, statt einer festen Aufzählung, und jedes Fehlen wird deutlich gemeldet: Die Anforderung hat entweder ein Plugin, das sie ausweist, oder sie kann nicht erfüllt werden. Nichts tritt an die Stelle eines fehlenden Plugins, mit der einen Ausnahme der Parser, die der Compiler mitbringt, wie unten beschrieben.
Ausgegebene Meldungen:
no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (kein Parser-Plugin weist das angeforderte Format aus) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (kein Importer-Plugin weist das angeforderte Format aus)
Ein einzelnes Parser-Plugin, das das Format ausweist, aber eine Versionsstruktur trägt, die nicht aufgelöst werden kann, wird so behandelt, als weise kein Plugin das Format aus, statt stillschweigend durchgelassen zu werden, und sagt dies:
no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (kein Parser-Plugin weist das angeforderte Format aus: Für das Format löst sich keine Parser-Plugin-Version auf)
Das Parsen fällt auf die Parser zurück, die der Compiler mitbringt. Ein Build parst jede Datei, die er einer render-verdict-Policy übergibt und deren Format die Policy nicht nativ liest, ein Importer liest seine Quelle über den Parser für die Syntax, die er benennt, und ein Import, der kein Format benennt, parst die Quelle in der Syntax, die jede zutreffende Signatur benennt. Für jede Syntax wird der Parser verwendet, den der Katalog des Workspace bereitstellt, und, wo der Katalog keinen bereitstellt, der Parser, den der Compiler selbst dafür mitbringt — darunter der HCL-Parser, über den ein Build Terraform-Ausgaben liest, und der JSON-Parser, über den die Core-Importer des Compilers lesen, sodass weder eine Policy über Terraform-Ausgaben noch ein Import über einen Core-Importer einen Parser im Katalog benötigt. Wo der Katalog einen Parser für eine Syntax bereitstellt, spielt der des Compilers keine Rolle, und zwei mit unterschiedlichen Namen im Katalog werden zurückgewiesen, wie A parse or import format is advertised by more than one plugin (Ein Parse- oder Importformat wird von mehr als einem Plugin ausgewiesen) beschreibt. Dieser Abbruch nennt also eine Syntax, für die weder der Katalog noch der Compiler einen Parser bereitstellt.
So beheben Sie es: Prüfen Sie, ob das Format so geschrieben ist, wie das Plugin es ausweist — die Fähigkeit besteht aus dem Präfix des Sockets und dem Formatnamen, daher bedient ein Plugin, das parse:hcl ausweist, das Format hcl und nichts anderes. Prüfen Sie dann, ob das Plugin in dem Katalog vorhanden ist, den der Build liest. Wo kein Plugin für das Format existiert, ist dieses Plugin das fehlende Teil; der Compiler kann kein Format lesen, das nichts ausweist.
A parse or import format is advertised by more than one plugin (Ein Parse- oder Importformat wird von mehr als einem Plugin ausgewiesen)
Zwei oder mehr verschiedene Plugins weisen dasselbe Format aus, und die Anforderung kann nicht geroutet werden, ohne zu raten, welches verwendet werden soll.
Ein Katalog, der beide enthält, ist zulässig und wird ohne Beanstandung geladen. Zwei Herausgeber können jeweils einen Parser oder Importer für ein Format ausliefern, und ihre Kataloge zu föderieren ist ein unterstützter Vorgang. Die Mehrdeutigkeit ist eine Bedingung am Verwendungsort: Sie führt zum Abbruch, wenn das umstrittene Format tatsächlich angefordert wird, sodass ein konkurrierendes Paar außerhalb der Reichweite eines Builds diesen nie blockiert.
Jeder Kandidat wird benannt, sortiert, sodass die Meldung bei jedem Lauf dieselbe ist.
Ausgegebene Meldungen:
format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (das Format wird von mehr als einem Parser-Plugin ausgewiesen) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (das Format wird von mehr als einem Importer-Plugin ausgewiesen)
Für einen Importer wird der Abbruch in einer weiteren Struktur ausgelöst: Die Einträge plugins.importer des Workspace binden mehr als einen der Importer an, die das Format ausweisen, und die benannten Importer sind dann die angebundenen.
Die Importer, unter denen ein Import wählt, sind die im Katalog des Workspace und die Core-Importer des Compilers, die ihre Formate in jedem Workspace ausweisen. Daher trifft ein Katalog, der einen eigenen Importer anderen Namens für ein Format enthält, das ein Core-Importer bedient — import:langflow oder import:flowise —, bei einem Import, der keinen von beiden anbindet, auf diesen Abbruch, und die Meldung nennt den Core-Importer neben dem des Katalogs. Ein Importer, den der Katalog unter dem eigenen Namen eines Core-Importers enthält, ist kein zweites ausweisendes Plugin: Innerhalb eines Namens wird die höchste Version gewählt, und einer mit der eigenen Version des Core-Importers, mit seinem Modul daneben, läuft an dessen Stelle. Einer ohne Modul daneben ist kein Kandidat, wo ein lauffähiger Importer dieses Namens das Format ausweist, wie Welcher neben Ihren eigenen Importern läuft beschreibt.
So beheben Sie es: Behalten Sie für einen Importer beide im Katalog — oder behalten Sie Ihren neben dem Core-Importer — und binden Sie den gewünschten an — einen Eintrag plugins.importer, dessen uri ihn mit Identität und Version benennt, uri: importer/<name>:<version>, wie aggrega plugin add importer ihn schreibt. Der angebundene Importer wird unter denen gewählt, die das Format ausweisen, so wie ein Eintrag plugins.providers unter den Plugins wählt, die eine Fähigkeit auf dem Provider-Socket bedienen, beschrieben unter „A capability is served by more than one provider plugin (Eine Fähigkeit wird von mehr als einem Provider-Plugin bedient)“ weiter unten. Wo die benannten Importer solche sind, die Ihre Einträge anbinden, behalten Sie den Eintrag für den gewünschten und entfernen Sie den anderen. Der Parse-Socket hat keine solche Auswahl, daher besteht die Abhilfe für einen Parser darin, den Katalog, den der Build liest, so einzugrenzen, dass nur das gewünschte Plugin darin ist — --catalog auf das Verzeichnis zu richten, das Ihre Wahl enthält, ist der direkte Weg.
A plugins.importer entry pins a version of its importer the catalog does not hold (Ein Eintrag pinnt eine Version seines Importers, die der Katalog nicht enthält)
Ein Eintrag plugins.importer bindet einen Importer über seine Identität und eine Version an — eine exakte, uri: importer/<name>:1.2.0, oder einen Bereich, uri: importer/<name>:^1.2.0 —, und dieser Importer weist das Format aus, das der Import anfordert, aber keine seiner Versionen, unter denen der Import wählt, erfüllt den Pin — die Versionen, die der Katalog des Workspace enthält, und für einen Core-Importer zusätzlich die eigene Version des Compilers: Die exakte Version ist nicht vorhanden, oder keine seiner Versionen liegt im Bereich. Die Version ist eine explizite Wahl, daher wird der Import zurückgewiesen, bevor irgendein Importer läuft, statt an seiner Stelle eine andere Version des Importers auszuführen.
Dies unterscheidet sich vom oben beschriebenen Fall, in dem kein Importer das Format ausweist: Hier gehört der Importer zu denen, unter denen der Import wählt, und weist das Format aus, und nur die Version, die der Eintrag nennt, fehlt. Ein Pin, der keine der Formen eines Versions-Pins hat, etwa :latest, wird stattdessen als fehlerhaft gemeldet, wie „A version pin is none of the forms a pin takes (Ein Versions-Pin hat keine der Formen, die ein Pin annimmt)“ beschreibt.
Ausgegebene Meldung, die die Fähigkeit des Formats und die vom Eintrag gepinnte Version nennt:
no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it (keine Importer-Plugin-Version erfüllt den Versions-Pin des Eintrags plugins.importer: Die Fähigkeit pinnt eine Version, aber keine bedienende Plugin-Version erfüllt sie)
So beheben Sie es: Ändern Sie die Version in der uri des Eintrags auf eine, die der Katalog enthält — für einen Core-Importer gehört auch die eigene Version des Compilers dazu —, erweitern Sie den Bereich, oder fügen Sie die vom Eintrag genannte Version dem Katalog hinzu. Ein Caret-Bereich passt auf Versionen ab seiner Untergrenze innerhalb derselben Major-Version, daher wird ^2.0.0 von einem Importer 1.x nicht erfüllt, so neu er auch ist.
A plugin reference carries a registry host or an artifact path (Eine Plugin-Referenz enthält einen Registry-Host oder einen Artefaktpfad)
Eine Plugin-Referenz beginnt mit einem Segment in Form eines Registry-Hosts — einem, das einen Punkt oder einen Doppelpunkt enthält, wie ein DNS-Name oder eine Kombination aus Host und Port — oder mit einem Artefaktpfad. Ein Plugin wird über seine Koordinatenidentität adressiert: seinen Plugin-Typ, einen Schrägstrich, seinen Namen und optional eine Version. Der Pull bindet diese Identität an einen physischen Ort, indem er die konfigurierte Registry und den Plugin-Pfad selbst voranstellt, sodass eine Referenz, die bereits eine enthält, doppelt mit einem Präfix versehen und an einen Ort gebunden würde, der nicht abgerufen werden kann.
Sie wird dort zurückgewiesen, wo der Ort gebildet wird, und nicht erst beim Abruf, sodass die Meldung nennt, was Sie geschrieben haben, statt später als unlesbarer Tag-Fehler aufzutauchen.
Ausgegebene Meldung, eingerahmt vom Pull, der den Ort gebildet hat, mit der Abhilfe in der Zeile darunter:
catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" (Katalog: Pull der Stufe 3: Die wasm-Plugin-Referenz muss die Plugin-Koordinatenidentität sein, kein registry-qualifizierter Pfad und kein Artefaktpfad) remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice (Abhilfe: Entfernen Sie den Registry-Host und den Artefaktpfad, sodass nur die Koordinate bleibt; der Pull stellt die konfigurierte Registry selbst voran, daher wird eine Referenz, die bereits eine enthält, doppelt mit einem Präfix versehen)
So beheben Sie es: Entfernen Sie alles vor dem Plugin-Typ, sodass die Koordinate allein steht — provider/helm:1.0.0, nicht hub.example.com/plugin/provider/helm:1.0.0. Die Registry, aus der ein Build zieht, ist Workspace-Konfiguration und nicht Teil einer Identität; genau das ermöglicht es, einen Katalog aus mehr als einer Registry bereitzustellen, ohne die Entitäten darin zu bearbeiten.
A plugin or recipe reference carries no scope (Eine Plugin- oder Rezept-Referenz hat keinen Geltungsbereich)
Eine Plugin- oder Recipe-Referenz hat kein führendes Segment für den Geltungsbereich — gar keinen Schrägstrich oder ein leeres Segment vor dem Schrägstrich, wie in /name. Beide Typen werden durch zwei Teile identifiziert, und der erste hält zwei gleichnamige Entitäten auseinander: ein Plugin durch seinen Plugin-Typ und seinen Namen, ein Recipe durch seinen Provider und seinen Namen. Zwei Sockets können jeweils ein Plugin namens redact enthalten, und zwei Provider können jeweils ein Rezept namens postgres ausliefern, daher ist der Geltungsbereich Teil der Identität und keine Dekoration daran.
Ein Ort, der aus einem leeren Geltungsbereich gebildet wird, enthält ein leeres Pfadsegment — einen doppelten Schrägstrich —, das sich nicht auflösen lässt, daher wird die Referenz dort zurückgewiesen, wo der Ort gebildet wird, statt sie später als unlesbaren Abruf scheitern zu lassen.
Die beiden Abhilfen sind das Gegenteil des oben beschriebenen Falls mit qualifiziertem Plugin und auch voneinander, weshalb jede für sich formuliert ist: Hier fehlt einer Referenz ein Segment, und Sie fügen eines hinzu, während eine qualifizierte Referenz eines zu viel enthält und Sie es entfernen.
Ausgegebene Meldungen, jeweils vom Pull eingerahmt und mit ihrer eigenen Abhilfe darunter:
catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" (Katalog: Pull der Stufe 3: Die wasm-Plugin-Referenz muss einen pluginType-Geltungsbereich tragen; ein leerer Geltungsbereich kann nicht an einen OCI-Ort gebunden werden) remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType (Abhilfe: Fügen Sie das fehlende pluginType-Segment hinzu — schreiben Sie die Referenz als Plugin-Typ, Schrägstrich und Name — und verwenden Sie dabei den pluginType, den die Plugin-Entität deklariert)
catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" (Katalog: Pull der Stufe 3: Die Rezept-Referenz muss einen Provider als Geltungsbereich haben; ein leerer Provider kann nicht an einen OCI-Ort gebunden werden) remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable) (Abhilfe: Kein lokales Katalogverzeichnis enthielt diese Referenz, daher wurde sie in der Registry gesucht, wo ein Provider-Segment erforderlich ist; führen Sie den Pull erneut mit der Katalog-Option für das Verzeichnis aus, das sie enthält, damit es zuerst durchsucht wird; die Option ist wiederholbar)
So beheben Sie es: Stellen Sie bei einem Plugin den Plugin-Typ voran, den die Plugin-Entität unter metadata.pluginType deklariert. Stellen Sie bei einem Rezept den Provider voran, den das Recipe unter spec.capability deklariert. Die Abhilfe für Rezepte nennt eine zweite Möglichkeit, die es zu lesen lohnt: Dass überhaupt die Registry erreicht wird, bedeutet, dass zuerst die lokalen Katalogverzeichnisse durchsucht wurden und keines die Referenz enthielt; soll das Rezept also aus einem lokalen Verzeichnis kommen, verweisen Sie den Build auf dieses Verzeichnis, statt einen Geltungsbereich hinzuzufügen.
The build consumes an artifact its publisher has deprecated (Der Build verwendet ein Artefakt, das sein Herausgeber als veraltet markiert hat)
Eine Referenz, die dieser Build auflöst, trägt eine Veraltungsmarkierung, die ihr Herausgeber erfasst hat, und deren Schweregrad liegt auf oder über dem Schweregrad, den der Workspace als Schwelle für den Abbruch konfiguriert hat. Eine Markierung wird einem veröffentlichten Artefakt nachträglich angehängt, sodass ein Artefakt, das gestern fehlerfrei gebaut wurde, heute eine tragen kann, ohne dass sich etwas an Ihren eigenen Dateien geändert hat.
Melden und Abbrechen sind getrennt, und nur das Abbrechen ist konfigurierbar. Jede erfasste Markierung wird gemeldet, bei jedem Schweregrad, und keine Konfiguration unterdrückt das. Ob eine Markierung den Build auch stoppt, entscheidet halt_on_deprecated_severity, indem es den erfassten Schweregrad mit der konfigurierten Schwelle in der Reihenfolge warning < error < retracted vergleicht. Ist keine Schwelle konfiguriert, bricht nichts ab, und jede Markierung ist ein Hinweis. Ein Schweregrad außerhalb dieser drei oder eine Schwelle außerhalb davon führt nie zu einer Übereinstimmung: Ein fehlerhafter Wert kann weder einen Abbruch verursachen noch einen unterdrücken.
Jede Mitteilung wird ausgegeben, bevor der Build stoppt, nicht nur die, die den Abbruch ausgelöst hat, sodass Sie durch das Anheben der Schwelle nie einen Befund verlieren — der Abbruch selbst nennt die eine Referenz, bei der er gestoppt hat. Befunde werden nach Referenz sortiert, sodass dasselbe Lockfile bei jedem Lauf dieselbe Abfolge meldet und immer derselbe Befund den Abbruch auslöst.
Zwei Speicher werden geprüft, und beide melden auf dieselbe Weise: die Referenzen, die das Lockfile pinnt, und die Plugins, die für ein Urteil über Annahme oder Ablehnung als vertrauenswürdig erfasst sind. Keine der Prüfungen greift auf eine Registry zu — beide lesen, was bereits erfasst wurde —, sodass der Build ahead-of-time bleibt.
Ausgegebene Meldung. Jeder Befund wird ausgegeben, während er durchlaufen wird, und der Abbruch wiederholt dann denjenigen, der die Schwelle erreicht hat, und nennt die Einstellung, die den Build gestoppt hat:
deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)
deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error" (Veraltung: Der Build verwendet eine veraltete Entität: Die Referenz ist zurückgezogen, mit der vom Herausgeber erfassten Meldung (beim Pull im Lockfile erfasst; führen Sie den Pull erneut aus, um sie zu aktualisieren): halt_on_deprecated_severity hat den angegebenen Wert)
Eine Markierung mit einem der beiden beratenden Schweregrade wird als deprecated (warning) oder deprecated (error) anstelle von retracted angegeben. Die Unterscheidung bleibt erhalten, weil die beiden Verschiedenes bedeuten — nicht empfohlen, aber weiterhin auswählbar, gegenüber von der Auswahl ausgeschlossen —, und den stärkeren als den schwächeren zu melden, würde untertreiben, was geschehen ist.
So beheben Sie es: Lesen Sie die erfasste Meldung, die die eigene Darstellung des Herausgebers dazu ist, worauf umzusteigen ist, und migrieren Sie. Wo Sie noch nicht migrieren können, macht das Anheben von halt_on_deprecated_severity — oder das Entfernen der Einstellung — aus dem Abbruch wieder einen Hinweis, den Sie weiterhin sehen; das ist eine bewusste Akzeptanz und kein Notbehelf, und die Mitteilung wird weiterhin ausgegeben. Eine Markierung, die für eine Version erfasst ist, die Sie nicht mehr verwenden, verschwindet, wenn das Lockfile mit aggrega pull aktualisiert wird.
A trusted plugin’s recorded digest disagrees with the cached artifact (Der erfasste Digest zu einem vertrauenswürdigen Plugin stimmt nicht mit dem zwischengespeicherten Artefakt überein)
Für ein Plugin, das in einer Rolle angebunden ist, die einen Build annimmt oder ablehnt, ist ein Digest als vertrauenswürdig erfasst, und das zwischengespeicherte Plugin-Manifest meldet einen anderen. Die beiden werden verglichen, bevor die ausführbare Plugin-Datei gelesen wird, und eine Abweichung stoppt die Auflösung an dieser Stelle.
Erst der Vergleich macht den erfassten Digest zu einer Autorität statt zu einer bloßen Wiederholung. Ohne ihn werden Plugin-Bytes nur gegen einen Pin geprüft, der aus genau dem Manifest abgeleitet ist, dessen Bytes er anschließend validiert — konstruktionsbedingt in sich stimmig und unfähig zu bemerken, dass das gesamte Artefakt ersetzt wurde. Erst der Vergleich des Erfassten mit dem, was das Manifest jetzt meldet, gibt dieser Prüfung eine Außensicht.
Dies unterscheidet sich von einer Abweichung des Inhalts-Digests, die meldet, dass aufgelöste Bytes nicht mit dem für sie beanspruchten Digest übereinstimmen. Hier wurde nichts gelesen, und die Bytes können durchaus mit dem Manifest übereinstimmen; was abweicht, ist, welches Artefakt überhaupt aufgelöst wird. Die beiden auseinanderzuhalten ist wichtig, weil die Abhilfen gegensätzlich sind — das eine ist ein beschädigtes oder manipuliertes Artefakt, das andere ein rechtmäßig geändertes Plugin, dessen neue Identität noch nicht geprüft wurde.
Ausgegebene Meldung:
resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports (zwischengespeichertes Plugin auflösen: Der als vertrauenswürdig erfasste Digest weicht von dem ab, den das Plugin-Manifest im Inhalts-Cache meldet; prüfen Sie, was sich geändert hat, und erfassen Sie den vertrauenswürdigen Digest neu, oder stellen Sie das erfasste Artefakt wieder her: Der für dieses Plugin als vertrauenswürdig erfasste Digest stimmt nicht mit dem Digest überein, den sein zwischengespeichertes Manifest meldet)
So beheben Sie es: Finden Sie heraus, was sich geändert hat, bevor Sie irgendetwas neu erfassen — dies ist ein Plugin, das Ihre Builds ablehnen kann, und der erfasste Digest ist die Aussage, dass jemand es geprüft hat. Wo die Änderung erwartet ist, weil Sie das Plugin bewusst aktualisiert haben, prüfen Sie das neue Artefakt und erfassen Sie den vertrauenswürdigen Digest dafür neu. Wo sie nicht erwartet ist, stellen Sie das Artefakt wieder her, das der Eintrag nennt; die Abweichung sagt Ihnen, dass sich die Identität verschoben hat, ohne dass jemand es so entschieden hat.
An extends: chain cannot be assembled (Eine Erweiterungskette kann nicht zusammengesetzt werden)
Die Kette extends: einer Component, eines Feature, eines Manifest oder eines Release nennt ein Elternelement, das sich nicht auflösen lässt, sodass die Kette nicht in eine einzelne aufgelöste Entität überführt werden kann.
Diese Bedingung unterscheidet sich von einem Zyklus, der eine eigene Bedingung und eine eigene Abhilfe hat — siehe „Cyclic extends chain (Zyklische extends-Kette)“ oben —, von einer Kette jenseits der Tiefengrenze, die unten eine eigene Bedingung hat, und von einem nicht erfüllbaren Versions-Pin, bei dem das Elternelement existiert und nur die Version nicht.
Ausgegebene Meldung, die die Entität mit dem nicht auflösbaren extends: und die von ihr deklarierte Referenz nennt:
inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog (Zusammenführung der Vererbung fehlgeschlagen: Die Entität erweitert eine Referenz, die keine Katalog-Entität bereitstellt. Prüfen Sie, ob die extends-Referenz eine im Katalog vorhandene Entität nennt)
Liest die Prüfung, die dies meldet, eine übergeordnete Entität unter dem Pin eines Lockfiles aus dem Artefakt-Cache — die extends-Prüfung eines Builds und von aggrega validate --release, aggrega validate über den gesamten Katalog und aggrega inspect sowie dieselben Prüfungen, ausgeführt aus dem Editor und dem validate-Tool des Assistenten —, nennt der Hinweis zusätzlich den Pull: „a base published to a registry is fetched by aggrega pull --release <release>“ (eine in einer Registry veröffentlichte Basis wird mit dem angegebenen Befehl abgerufen). Die Validierung einer einzelnen Entitätsdatei liest kein Lockfile, sodass ein Pull nichts an dem ändern würde, was sie liest, und ihre Meldung endet beim Katalog.
Feature erscheint anstelle von Component, wenn die Kette eines Feature diejenige ist, die fehlgeschlagen ist. Wie bei einem Zyklus ist die zuerst genannte Entität diejenige, bei der die Auflösung begonnen hat, und die in der Kante genannte Entität diejenige, deren Zeile extends: Sie öffnen sollten; entlang einer Kette über mehrere Ebenen unterscheiden sich die beiden.
Das extends: eines Manifest wird gegen einen anderen Ort aufgelöst und erhält daher einen anderen Rat. Ein Manifest ist Betreiberkonfiguration, die neben dem Release verfasst wird, und kein Kataloginhalt, und sein extends: nennt eine Datei mit relativem Pfad oder den metadata.name eines Manifest im eigenen Verzeichnis des Release — nie eine Katalog-Entität. Seine Meldung schließt daher mit dem, worauf die Referenz nicht aufgelöst werden konnte, und damit, wo stattdessen zu suchen ist:
inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory (Zusammenführung der Vererbung fehlgeschlagen: Die Entität erweitert eine Referenz, die nicht aufgelöst werden konnte. Prüfen Sie, ob die extends-Referenz ein relativer Pfad oder der Name eines Manifest im Verzeichnis des Release ist)
Dieses abschließende Detail ist der Fehler, den die Suche selbst gemeldet hat — die Datei, die nicht gelesen werden konnte, oder der Scan, der unter diesem Namen kein Manifest indiziert hat —, daher sagt es meist, welche der beiden Formen versucht wurde und warum sie leer blieb.
Das extends: eines Release wird gegen ein Verzeichnis aufgelöst und akzeptiert eine einzige Form. Ein Release nennt sein Elternelement als relativen Pfad — ./base-release.yaml oder ../shared/base-release.yaml. Das Verzeichnis, gegen das aufgelöst wird, ist das, in dem das Release liegt, das die Referenz schreibt, und jedes Glied einer Kette wird gegen sein eigenes Verzeichnis aufgelöst — ein Release in der Mitte der Kette, das in einem Unterverzeichnis liegt, nennt sein Elternelement also neben sich selbst, wo auch immer das Release liegt, das ein Befehl nennt. Ein bloßes Token ist kein Pfad und nennt kein Release, nach dem der Compiler suchen wird, daher wird es hier gemeldet, statt an einem Ort gesucht zu werden, an dem es nicht gefunden werden kann:
inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release (Zusammenführung der Vererbung fehlgeschlagen: Die Entität erweitert eine Referenz, die nicht aufgelöst werden konnte. Prüfen Sie, ob die extends-Referenz ein relativer Pfad zu einer Release-Datei ist, etwa ./base-release.yaml, aufgelöst vom Verzeichnis aus, das dieses Release enthält)
So beheben Sie es: Prüfen Sie bei einer Component oder einem Feature, ob der Wert von extends: eine Entität nennt, die der Katalog enthält, geschrieben wie der eigene metadata.name dieser Entität — einschließlich Groß- und Kleinschreibung. Eine in einer Registry veröffentlichte Basis wird unter dem Pin, den das Lockfile des Release für sie erfasst, aus dem Artefakt-Cache gelesen; liegt die Basis also in einer Registry, führen Sie aggrega pull --release <release> aus: Der Pull folgt der Kette, ruft die Basis ab und pinnt sie. Prüfen Sie bei einem Manifest, ob die Datei dort liegt, wohin der relative Pfad zeigt, oder ob ein Manifest mit diesem metadata.name im Verzeichnis des Release liegt und sich parsen lässt. Prüfen Sie bei einem Release, ob der Wert mit ./ oder ../ beginnt und die Datei, auf die er zeigt, vorhanden ist und sich als Release parsen lässt.
An extends: chain runs past the depth bound (Eine Erweiterungskette überschreitet die Tiefengrenze)
Die Kette extends: einer Component, eines Feature, eines Manifest oder eines Release endet sauber, durchläuft aber mehr Entitäten, als die Grenze von zehn zulässt.
Hierfür gibt es eine eigene Bedingung, statt die obige zu teilen, weil die beiden Abhilfen nichts gemeinsam haben: Ein fehlendes Elternelement ist eine zu korrigierende Referenz, und eine zu tiefe Kette ist eine abzuflachende Struktur. Die Grenze ist ein Schutz vor einem Versehen beim Verfassen und keine strukturelle Grenze — Architekten erweitern eine Basis typischerweise um eine oder zwei Ebenen, und eine zehn Ebenen tiefe Kette ist meist ein gewachsener Basisbaum statt eines bewussten Designs.
Nur eine Kette, die ENDET, erreicht sie. Eine Kette, die in sich selbst zurückläuft, wird unabhängig von ihrer Länge als Zyklus gemeldet, daher steht diese Bedingung nie für einen Zyklus, und ihr Rat — die Kette zu kürzen — wird für einen solchen nie gegeben.
Ausgegebene Meldung, die die Grenze und die von der Kette erreichte Länge nennt:
extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (die extends-Kette überschreitet die maximale Tiefe. Die Grenze ist 10, und diese Kette geht darüber hinaus; kürzen Sie die Kette, oder erweitern Sie eine Basis, die näher an ihrer Wurzel liegt)
Feature, Manifest oder Release erscheint anstelle von Component, wenn eine dieser Ketten fehlgeschlagen ist. Die Grenze ist für jeden Typ, der extends deklariert, dieselbe Zehn, und sie zählt die Entitäten auf der Kette, nicht die Glieder zwischen ihnen: Eine Kette aus genau zehn Entitäten wird gebaut, und die elfte Entität ist das, was hier gemeldet wird. Eine Entität, die eine Basis erweitert, die wiederum eine Basis erweitert — drei Entitäten, zwei Glieder —, hat also drei erreicht.
So beheben Sie es: Fassen Sie die Mitte der Kette zusammen. Eine so tiefe Kette bedeutet meist, dass jede Ebene ein wenig hinzufügt, und mehrere Ebenen in eine Basis-Entität zusammenzulegen ist sowohl die Behebung als auch die klarere Struktur. Wo die Ebenen wirklich verschieden sind, kann eine Entität weiter unten in der Kette direkt eine Basis näher an der Wurzel erweitern, statt über jede dazwischenliegende Ebene zu erben. Eine so tiefe Manifest-Kette ist meist ein Überlagerungsstapel pro Umgebung — legen Sie die Ebenen, die niemand variiert, in der Basis zusammen, die sie überlagern.
An assertion name is declared twice along an extends: chain (Ein Assertion-Name wird entlang einer Erweiterungskette zweimal deklariert)
Eine Entität und etwas, das sie erweitert, deklarieren beide eine Assertion unter demselben Namen, und die beiden deklarieren unterschiedliche Regeln. Die Assertions einer erweiternden Entität kommen zu denen ihrer Basis hinzu; sie ersetzen nie eine. Ein zweimal mit zwei unterschiedlichen Regeln deklarierter Name würde also stillschweigend die Invariante der Basis außer Kraft setzen, was das Gegenteil dessen ist, wofür das Erweitern einer Entität da ist.
Denselben Namen mit der identischen Regel zu deklarieren ist keine Kollision und wird gebaut. Das hält die Prüfung entlang einer Kette idempotent: Ohne das würde eine Kette über drei Ebenen jedes Mal mit ihrer eigenen mittleren Ebene kollidieren.
Die Reihenfolge ist Teil des Vertrags und nicht zufällig. Assertions werden in der zusammengeführten Reihenfolge ausgewertet, und die erste fehlschlagende bricht ab, sodass die Invariante einer Basis vor der eines Nachfahren geprüft wird und sich die Menge entlang einer Kette von der Wurzel abwärts ansammelt.
Ausgegebene Meldung:
assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one (Assertion-Name entlang der extends-Kette zweimal deklariert. Die Assertion ist bereits von der Basis-Component mit einer anderen Regel deklariert; benennen Sie die Assertion der erweiternden Entität um; die Assertions einer erweiternden Entität kommen zu denen der Basis hinzu und ersetzen nie eine)
So beheben Sie es: Benennen Sie die Assertion der erweiternden Entität um, die die Meldung zusammen mit der Basis nennt, die sie bereits deklariert. Wenn Sie die Regel der Basis ersetzen wollten, unterstützt das Erweitern das nicht — schränken Sie die Assertion der Basis so ein, dass sie für jede erweiternde Entität gilt, oder verschieben Sie die Regel nach unten auf die Entitäten, die sie tatsächlich brauchen. Wenn die beiden Regeln gleich sein sollen, machen Sie sie textuell identisch, und die Kollision verschwindet.
A Release chain’s links disagree about the routing shape (Die Glieder einer Release-Kette sind sich über die Routing-Struktur uneinig)
Ein Release routet die Komponenten seines Aggregate auf eine von zwei Arten: benannte Boundaries unter boundaries: oder Komponenten auf oberster Ebene unter components:. Die beiden schließen sich gegenseitig aus, und ein einzelnes Dokument, das beide deklariert, wird schon beim Einlesen zurückgewiesen. Diese Bedingung ist dieselbe Regel über eine Kette extends: hinweg: Eine Basis, die benannte Boundaries deklariert, und ein Kind, das Komponenten auf oberster Ebene deklariert, sind jeweils für sich wohlgeformt, und erst ihr Zusammenführen bringt die beiden Entscheidungen in ein einziges aufgelöstes Release.
Keines der beiden Dokumente ist für sich genommen falsch, weshalb die Meldung beide und beide Schlüssel nennt. Eine Diagnose, die nur das Release nennt, auf das der Build gerichtet wurde, würde Sie zu der Datei schicken, in der nichts falsch ist.
Eine Kette, deren Glieder übereinstimmen, bleibt unberührt. Jedes Glied, das benannte Boundaries deklariert, wird normal zusammengesetzt, und ebenso jedes Glied, das Komponenten auf oberster Ebene deklariert. Erst die Mischung bricht ab.
Ausgegebene Meldung, die die beiden Dateien und den Schlüssel nennt, den jede deklariert:
release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>") (die Erweiterungskette des Release setzt sowohl benannte Boundaries als auch Komponenten auf oberster Ebene zusammen: Deklarieren Sie eine einzige Routing-Struktur über die ganze Kette, nie beide — Release, Datei, die die Boundaries deklariert, Datei, die die Komponenten deklariert)
So beheben Sie es: Wählen Sie die Routing-Struktur, die die Kette verwenden soll, und schreiben Sie sie durchgehend bis nach unten. Wo die Basis benannte Boundaries deklariert, adressiert ein Kind, das Komponenten konfigurieren will, diese innerhalb der Boundary, die sie enthält, statt an der Wurzel des Release — und genau das erlaubt ihm auch, die Dimensionierung einer Komponente zu ändern, ohne die Topologie erneut anzugeben. Wo die Basis Komponenten auf oberster Ebene deklariert, beschreibt ein Kind, das benannte Boundaries braucht, eine andere Routing-Struktur als seine Basis und wird besser als eigenes Release verfasst denn als Kind dieses Release.
An external input’s URL uses a scheme that is not allowed (Die URL einer externen Eingabe verwendet ein nicht zulässiges Schema)
Eine URL, auf die eine Entität verweist, verwendet ein Schema außerhalb der zulässigen Menge. Drei sind zulässig: https; http, aber nur zu einem Loopback-Host, sodass Klartext immer nur die lokale Maschine erreichen kann; und oci für Inhalte, die aus einer Registry bezogen werden.
Ausgegebene Meldungen, für eine URL http ohne Loopback und für jedes andere Schema:
externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: unverschlüsseltes http ist nur für Loopback-Hosts zulässig (zulässige Schemata: https, http zu einem Loopback-Host, oci): externalinputs: das URL-Schema ist nicht zulässig) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: das Schema ist nicht zulässig (zulässige Schemata: https, http zu einem Loopback-Host, oci): externalinputs: das URL-Schema ist nicht zulässig)
So beheben Sie es: Stellen Sie die URL auf https um, oder auf oci, wo der Inhalt in einer Registry veröffentlicht ist. Eine unverschlüsselte URL http zu einem entfernten Host wird zurückgewiesen statt herabgestuft, daher ist die Umstellung auf das sichere Schema die Lösung; ein lokaler Entwicklungsserver funktioniert über http weiter, weil ein Loopback-Host zulässig ist.
A render requests an external input the lockfile does not pin (Ein Rendering fordert eine externe Eingabe an, die das Lockfile nicht pinnt)
Etwas, das ein Build benötigt, wird von einer URL abgerufen, die das Lockfile nicht pinnt. Ein Build rendert die Hülle, die sein Lockfile aufzeichnet, und ruft nichts ab, daher gibt es keine Einstellung, mit der dieser Lauf die URL stattdessen beschaffen könnte: Die eingefrorene Hülle ist es, die einen Build reproduzierbar macht, und die Eingabemenge stillschweigend zu erweitern ist das Einzige, was er nicht tun darf.
Dieser Abbruch ist daher aufschlussreich und kein Konfigurationsfehler. Die Pins waren vollständig, als das Release aufgelöst wurde, also bedeutet eine nicht gepinnte URL jetzt, dass sich seitdem etwas geändert hat — ein Wert, der steuert, welche Referenzen ein Rendering anfordert, ein Chart, der begonnen hat, auf ein neues Ziel zu verweisen, oder ein Lockfile, das gegen ein anderes Release aufgelöst wurde.
Ausgegebene Meldung:
"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (ist im Lockfile nicht gepinnt; führen Sie den Befehl aus, um jede externe Eingabe zu pinnen, die das Rendering dieses Release verbraucht, und bauen Sie dann erneut: externalinputs: die Beschaffung ist für nicht gepinnte Eingaben deaktiviert)
So beheben Sie es: Pinnen Sie die Eingabe. aggrega pull --release <path> rendert das Release, um herauszufinden, welche externen Eingaben es verbraucht, ruft jede davon ab und zeichnet ihren Digest im Lockfile neben den Abhängigkeits-Pins auf — danach liefert jeder spätere Build sie aus dem gepinnten Eintrag und benötigt überhaupt kein Netzwerk. Wo die URL neu ist, weil etwas, das Sie verfasst haben, begonnen hat, auf sie zu verweisen, ist das erneute Auflösen des Release der übersprungene Schritt; wo sie unerwartet ist, lohnt es sich, die Referenz zu finden, die sie eingeführt hat, bevor Sie sie pinnen.
Fetched bytes do not match a pinned digest (Abgerufene Bytes stimmen nicht mit einem gepinnten Digest überein)
Eine gepinnte URL wurde erneut abgerufen — weil ihre gespeicherte Kopie fehlte —, und was zurückkam, ist nicht das, was das Lockfile gepinnt hat. Der aufgezeichnete Digest hat immer Vorrang: In den Speicher wird nichts geschrieben, und es werden keine Bytes zurückgegeben.
Eine Neubefüllung wird über den aufgezeichneten Digest abgerufen statt über das Tag der URL, sodass ein Tag, das auf anderen Inhalt umgesetzt wurde, nicht ändern kann, was ein gepinnter Eintrag liefert. Dieser Abbruch bedeutet daher, dass der Inhalt hinter dem Digest selbst nicht unversehrt zurückgekommen ist.
Ausgegebene Meldungen, für Inhalte, die aus einer Registry bezogen werden, und für Inhalte, die über HTTPS abgerufen werden:
externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: der Digest des neu befüllten Manifests weicht vom gepinnten Digest ab: externalinputs: die abgerufenen Bytes stimmen nicht mit dem gepinnten Digest überein) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: der Hash der erneut abgerufenen Bytes weicht vom gepinnten Digest ab: externalinputs: die abgerufenen Bytes stimmen nicht mit dem gepinnten Digest überein)
So beheben Sie es: Behandeln Sie es zuerst als Frage der Lieferkette und nicht als Lockfile, das aufzufrischen ist — der Pin ist die Aussage, dass genau diese Bytes das waren, wogegen Sie gebaut haben, und die Zurückweisung ist diese Aussage, die standhält. Prüfen Sie, ob die Quelle noch den Inhalt veröffentlicht, den der Digest benennt, und ob irgendetwas zwischen Ihnen und ihr Antworten umschreibt; ein Proxy oder ein Mirror, der einen Ersatz ausliefert, ist eine häufige Ursache. Erst wenn Sie wissen, was sich geändert hat, und es akzeptieren, sollten Sie mit aggrega pull neu pinnen, das den neuen Digest aufzeichnet.
A stored external input no longer matches its record (Eine gespeicherte externe Eingabe stimmt nicht mehr mit ihrem Eintrag überein)
Eine gepinnte Eingabe wurde aus dem lokalen Speicher zurückgelesen und stimmt nicht mit dem für sie gepinnten Eintrag überein. Die Prüfung läuft bei jedem Lesen, bevor die Bytes ausgeliefert werden, sodass ein beschädigter oder manipulierter Speicher an der Stelle der Verwendung auffällt, statt stillschweigend in einen Build einzufließen.
Was verglichen wird, hängt davon ab, wie die Eingabe gepinnt ist. Über HTTPS abgerufener Inhalt wird durch Hashen der Nutzlast gepinnt, daher wird er bei jedem Lesen neu gehasht, und beide Digests werden gemeldet. Aus einer Registry bezogener Inhalt wird über seinen Manifest-Digest gepinnt, der die Nutzlast über das eigene Manifest der Registry festschreibt, statt sie direkt zu hashen, daher wird eine gespeicherte Kopie gegen die aufgezeichnete Größe geprüft — die vollständige Digest-Verifikation ist stattdessen bei der Beschaffung und bei jeder über den Digest adressierten Neubefüllung verankert.
Ausgegebene Meldungen:
externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (externalinputs: der sha256 des Blobs im Speicher weicht vom gepinnten Digest ab: externalinputs: der Blob im Speicher stimmt nicht mit seinem gepinnten Eintrag überein) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (externalinputs: die Größe des sha256-Blobs im Speicher weicht von der Größe ab, die der gepinnte Eintrag angibt: externalinputs: der Blob im Speicher stimmt nicht mit seinem gepinnten Eintrag überein)
So beheben Sie es: Löschen Sie den betroffenen Blob aus dem Speicher und lassen Sie den nächsten Lauf ihn aus der Quelle neu befüllen, was gegen den aufgezeichneten Digest geprüft wird, bevor irgendetwas geschrieben wird. Meldet dann auch eine Neubefüllung eine Digest-Abweichung, liegt die Unstimmigkeit vorgelagert statt lokal, und der Eintrag oben ist der zu lesende. Ein zwischen Maschinen geteilter Speicher oder einer, der aus einem mitten in einem Schreibvorgang erstellten Backup wiederhergestellt wurde, ist die übliche lokale Ursache.
A guard needs a catalog entity the build resolved and cannot see (Ein Guard benötigt eine Katalogentität, die der Build aufgelöst hat und nicht sehen kann)
Ein semantischer Guard hat nach der Katalogentität hinter dem Typ einer Komponente gegriffen, und die Entität fehlt in der Sicht, die der Guard erhalten hat — obwohl die Auflösung diesen Typ als Katalogreferenz aufgelöst hat. Eine tatsächlich nicht auflösbare Referenz bricht früher ab, bei der Auflösung, daher bedeutet das Erreichen eines Guards mit fehlender Entität, dass die aufgelöste Menge des Builds und die Sicht des Guards auseinandergefallen sind.
Der Build hält an, statt den Guard zu überspringen. Ein Überspringen würde eine Prüfung außer Kraft setzen, ohne dass irgendetwas meldet, dass sie weggefallen ist, und die Komponenten, um die es dem Guard ging, kämen ungeprüft durch, während der Build Erfolg meldet.
Ein als relativer Pfad geschriebener Typ — beginnend mit ./ oder ../ — wird hier nicht beurteilt: Ein Typ wird nie als Datei gelesen, daher benennt ein solcher Wert überhaupt keine Katalogentität und wird früher zurückgewiesen, wenn die Abhängigkeiten des Release aufgelöst werden, als Referenz, die kein Katalog enthält. Nur eine Katalogreferenz als bloßes Token erreicht diesen Abbruch.
Wo immer die Bedingung eintritt, meldet sie sich mit denselben Worten, sodass der Text den Typ und den Fehler nennt statt der Prüfung, die ihn ausgelöst hat.
Sie nennt auch kein Dokument und keinen Schlüssel darin, was beabsichtigt ist und die einzige Stelle, an der sich dieser Abbruch anders liest als alle anderen. Jeder andere Abbruch positioniert sich auf der Datei und dem Feld, die Sie bearbeiten würden, um ihn zu beheben; hier gibt es keine solche Datei, daher würde eine Position Sie zu einem Schlüssel schicken, der nicht schuld ist. Stattdessen wird der Typ gemeldet, über den die beiden Sichten uneinig sind, denn er macht die Abweichung für diejenigen reproduzierbar, die ihr nachgehen.
Ausgegebene Meldung:
the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>") (die eigenen Sichten des Compilers auf den Katalog sind uneinig (interner Fehler: Dieser Build hat einen Komponententyp aufgelöst, für den der Katalog, den er liest, danach keinen Eintrag enthielt. Dies ist ein Fehler im Compiler und nicht in einem verfassten Dokument, daher gibt es im Aggregate, im Release oder im Katalog nichts zu korrigieren. Bitte melden Sie ihn und nennen Sie den Befehl, der diesen Build erzeugt hat, sowie den Typ, über den die Sichten uneinig sind))
So beheben Sie es: Nichts in Ihren eigenen Dateien — dies meldet eine Inkonsistenz im Compiler und keinen Fehler in dem, was Sie geschrieben haben, und es lohnt sich, sie als Defekt mit dem Typ zu melden, den die Meldung nennt. Der Typ der Komponente ist mit ziemlicher Sicherheit in Ordnung.
A reference names no entity the catalog holds (Eine Referenz benennt keine Entität, die der Katalog enthält)
Bevor ein Build irgendetwas rendert, wird die gesamte Menge der Entitäten, von denen ein Release abhängt, durchlaufen und jede gepinnt, sodass das Lockfile genau das aufzeichnet, was der Build lesen wird. Eine Referenz, die der Katalog nicht beantworten kann, stoppt diesen Durchlauf: Für sie lässt sich nichts pinnen, und weiterzumachen würde ein Lockfile schreiben, dem ein Eintrag fehlt, den der Build später braucht, ohne dass irgendetwas darauf hinweist.
Die Zurückweisung nennt die Referenz und die Stelle, an der sie gesammelt wurde, denn eine Entität wird von vielen Stellen aus erreicht, und die Stelle, die sie benennt, ist die, an der die Korrektur ansetzt. Eine Bibliotheksreferenz wird für sich gemeldet, ohne Sammelpfad — eine Bibliothek wird von den Entitäten erreicht, die sie per $ref oder $import einbinden, und der fehlschlagende Name ist der ganze Fehler.
Ausgegebene Meldung, für eine Katalogentität — der hintere Teil listet die Stellen auf, die sie referenzieren:
resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) (resolve: keine Entität im Katalog entspricht dieser URI: Entität, mit den Pfaden, von denen aus sie referenziert wird)
für eine Bibliothek:
resolve: no entity in the catalog matches this URI: library "<reference>" (resolve: keine Entität im Katalog entspricht dieser URI: Bibliothek)
und für ein Plugin, das an einen Provider-Socket gebunden ist und über den Schlüssel der Workspace-Konfiguration benannt wird, der es enthielt, statt über ein Katalogdokument:
resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers) (resolve: keine Entität im Katalog entspricht dieser URI: Entität, referenziert von .aggrega-config.yaml.plugins.providers)
Wo eine Datei unter den Katalogverzeichnissen den Namen, nach dem die Referenz fragt, unter einem Typ deklariert, den kein Katalog enthält — etwa ein falsch geschriebenes kind —, nennt der Hinweis unter diesem Fehler diese Datei, den Typ, den sie deklariert, und die Typen, die ein Katalog enthält, und lässt den Rat weg, wo lokale Entitäten gelesen werden, bei einem Build, der sein Lockfile befüllt, ebenso wie bei einem, der es liest, und auf jeder anderen Oberfläche, die diesen Fehler meldet; siehe Eine zurückgewiesene Katalogdatei und der Fehler, den sie erklärt.
So beheben Sie es: Lesen Sie die Referenz genau so, wie die Meldung sie zitiert. Ein Name, der nicht existiert, eine Version, die nie veröffentlicht wurde, und ein bloßer Name, auf dessen Registry der Workspace nicht verweist, kommen hier alle identisch an, prüfen Sie die drei also in dieser Reihenfolge: Korrigieren Sie die Schreibweise; vergewissern Sie sich, dass die Version existiert; vergewissern Sie sich, dass die Registry, die sie enthält, konfiguriert und erreichbar ist. Wo die Entität eine ist, die Sie lokal verfassen, vergewissern Sie sich, dass die Datei innerhalb des Katalogs liegt, den der Build durchläuft.
Wo aggrega pull oder aggrega build --auto-pull an einer Bibliotheksreferenz anhält, während der Artefakt-Cache eine SchemaLibrary enthält, die kein Lockfile-Eintrag pinnt und kein Katalogverzeichnis liefert, folgt auf die Meldung eine Zeile remediation:, die jede solche Bibliothek nennt. Eine zwischengespeicherte Bibliothek zählt nur dort als Kataloginhalt, wo ein Lockfile-Eintrag für ihren Digest bürgt, und der Pull zeichnet diesen Eintrag aus der Registry auf, die die Bibliothek ausliefert. Im Offline-Modus kann der Pull die Bibliothek weder abrufen noch einen Eintrag für sie aufzeichnen, daher sagt die Zeile, aggrega pull --release <release> dort auszuführen, wo eine Registry erreichbar ist, oder die Bibliothek unter einem Katalogverzeichnis zu verfassen. Mit Verbindung liefert kein Katalogverzeichnis und keine Registry, die der Pull liest, die Bibliothek, es gibt also keinen Eintrag aufzuzeichnen, und die Zeile verweist darauf, die Bibliothek unter einem Katalogverzeichnis zu verfassen.
A library reference is not written in the identity form (Eine Bibliotheksreferenz ist nicht in der Identitätsform geschrieben)
Ein bibliotheksübergreifendes $ref: oder $import: benennt die Bibliothek über ihre Identität und dann den Eintrag darin: den bloßen Namen der Bibliothek, optional ein : und eine Mindestversion, dann # und den Pfad des Eintrags auf der Oberfläche, die das Feld liest. In dieser Form gibt es keinen Registry-Host. Über welche Registry ein Name aufgelöst wird, ist Workspace-Konfiguration, und welche Version ein Build verwendet, beantwortet das Lockfile, daher würde eine Referenz, die eines von beiden enthält, im Dokument etwas festlegen, das der Build entscheiden soll.
Hier zurückgewiesen werden: ein Wert, der einen Registry-Host enthält; ein dokumentinterner Anker, der dort geschrieben ist, wo eine bibliotheksübergreifende Referenz erwartet wurde; ein leerer Bibliotheksname; und @ als Versionstrenner, was mit der korrigierten Schreibweise gemeldet wird statt als allgemeine Beanstandung der Struktur, weil es der Fehler ist, den diese Form am häufigsten anzieht.
Ausgegebene Meldung:
resolve: invalid library reference URI: "<the value as written>" (resolve: ungültige URI einer Bibliotheksreferenz)
und wo @ als Trenner verwendet wurde, mit dem Zitat dessen, was der Wert stattdessen lauten sollte:
resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>" (resolve: ungültige URI einer Bibliotheksreferenz: der Versionstrenner ist ’:’, nicht ’@’ — verwenden Sie den korrigierten Wert)
So beheben Sie es: Schreiben Sie den Wert als <Library>#<entry-path> um und fügen Sie :<version> nach dem Bibliotheksnamen nur dort hinzu, wo Sie eine Untergrenze dafür brauchen, welche Version ausgewählt werden darf. Entfernen Sie jeden Registry-Host. Wo die Referenz innerhalb desselben Dokuments zeigen sollte, ist ein dokumentinterner Anker etwas anderes als eine Bibliotheksreferenz, und das Feld, in das Sie sie geschrieben haben, erwartet die Bibliotheksform.
Two consumers of one library require incompatible versions (Zwei Konsumenten einer Bibliothek verlangen inkompatible Versionen)
Mehrere Entitäten können auf eine Bibliothek verweisen, jede mit einer Mindestversion oder ganz ohne, und die Version, die der Build auswählt, ist die höchste Mindestversion, die eine von ihnen angegeben hat. Das ermöglicht es einem Konsumenten, der weniger verlangt, dennoch eine Version zu erhalten, die ihn zufriedenstellt, und deshalb hebt das Hinzufügen eines Konsumenten mit einer höheren Mindestversion alle an, statt den Build auf zwei Kopien aufzuteilen.
Die Regel gilt nur, solange die Mindestversionen in der führenden Versionsnummer übereinstimmen. Zwei Konsumenten, die verschiedene Hauptversionen angeben, verlangen zwei Bibliotheken, die zufällig denselben Namen tragen, und keine einzelne Auswahl erfüllt beide — statt also eine zu wählen und den anderen Konsumenten eine Struktur lesen zu lassen, für die er nicht geschrieben wurde, hält der Build an und benennt die Unstimmigkeit. Ein Konsument ohne Mindestversion ist hier an nichts beteiligt: Die Auswahl entscheiden die Konsumenten, die eine Version gepinnt haben.
Ausgegebene Meldung. Die Konsumenten werden in sortierter Reihenfolge verglichen: Der erste, der eine Mindestversion angibt, legt die Hauptversion fest, und die Meldung führt jeden verglichenen Konsumenten bis einschließlich des ersten auf, dessen Mindestversion eine andere Hauptversion angibt, jeweils mit der Version, die er verlangt hat — so nennen dieselben Dokumente stets dieselben Konsumenten:
resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version> (Auflösung: Konflikt bei der minimalen Versionsauswahl — inkompatible Versionsanforderungen an die Bibliothek: Die Bibliothek hat Konsumenten, die inkompatible Hauptversionen verlangen: Konsument verlangt Version; Konsument verlangt Version)
So beheben Sie es: Heben Sie die Mindestversion des niedrigeren Konsumenten auf dieselbe Hauptversion an; das ist die übliche Antwort, sobald die neuere Struktur das ist, was alle wollen. Werden beide Hauptversionen tatsächlich gleichzeitig benötigt, handelt es sich um zwei Bibliotheken: Veröffentlichen Sie die ältere Struktur unter einem eigenen Namen und lassen Sie den Konsumenten, der sie braucht, dorthin verweisen, sodass jeder Verweis das benennt, wofür er geschrieben wurde.
The chain of module imports is deeper than the pin walk descends (Die Kette der Modulimporte ist tiefer, als der Pinning-Durchlauf hinabsteigt)
Das Pinning durchläuft jedes Modul, das ein Aggregate importiert, dann jedes Modul, das diese importieren, sodass die gesamte Menge das Lockfile erreicht und nicht nur die erste Ebene. Ein bereits erfasstes Modul wird kein zweites Mal durchlaufen, und genau das beendet einen gewöhnlichen Zyklus — ein Aggregate, das ein Modul importiert, das es seinerseits wieder importiert, endet ohne Beanstandung, nachdem jedes einmal erfasst wurde.
Eine Tiefengrenze von zehn sichert die Kette ab, die die Wiederholungserkennung nicht sehen kann: eine, die auf jeder Ebene eine neue Identität präsentiert, wie es ein Modul tut, das bei jedem Schritt unter einer neuen Version erneut veröffentlicht wird. Die Grenze ist dieselbe, die der Graph-Builder anwendet, sodass eine Komposition, die sich pinnen lässt, sich auch bauen lässt.
Ausgegebene Meldung:
resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth> (Auflösung: Einbindungstiefe der Sub-Aggregate überschritten: in Tiefe)
So beheben Sie es: Verkürzen Sie die Kette. Eine so tiefe Kette spiegelt meist wider, wie eine Organisation gegliedert ist, und nicht, wie das Release gegliedert ist; suchen Sie daher nach Ebenen, die keine eigenen Komponenten beitragen, und führen Sie sie in ihrem Elternelement zusammen. Wo jede Ebene nur existiert, um die darunterliegende unter einer neuen Version erneut zu veröffentlichen, sind die Versionen die Kette: Importieren Sie das Modul, das Sie tatsächlich wollen, direkt, in der Version, die Sie wollen.
Dies ist die Grenze des Pinning-Durchlaufs. Der Graph-Builder wendet seine eigene an, die weiter unten unter „Sub-aggregate nesting depth exceeded (Verschachtelungstiefe von Sub-Aggregaten überschritten)“ gemeldet wird, und die beiden sind getrennte Meldungen derselben Grenze, die an zwei Stellen erreicht wird — die erste, während das Lockfile befüllt wird, die zweite, während der Graph aufgebaut wird.
The catalog view a build was given cannot load the bodies pinning needs (Die Katalogsicht, die ein Build erhalten hat, kann die Inhalte nicht laden, die das Pinning benötigt)
Zwei der Achsen, die das Pinning durchläuft, brauchen vom Katalog mehr als eine Versionsantwort: Sie brauchen die Dokumente selbst. Die Module, die ein Aggregate importiert, müssen gelesen werden, um zu finden, was sie ihrerseits importieren. Die Recipes, FeatureRecipes und Plugins, die ein Build bindet, müssen gelesen werden, um die Artefakte und Bibliotheken zu finden, die sie benennen. Eine Katalogsicht, die eine Version auflösen, diese Inhalte aber nicht zurückgeben kann, lässt beide Achsen ohne etwas zu lesen.
Beide werden von vornherein zurückgewiesen statt übersprungen, und der Grund ist das, was ein Überspringen hervorbrächte: ein Lockfile, dem eine ganze Klasse von Einträgen fehlt, ohne Beanstandung geschrieben, das ein späterer Build originalgetreu rekonstruiert und unvollständig vorfindet. Keine der beiden Meldungen enthält eigene Werte, weil keine von ihnen ein Dokument betrifft, das Sie geschrieben haben — jede gibt an, welche Achse nicht berechnet werden kann:
resolve: catalog lookup cannot load resolved sub-aggregate bodies (Auflösung: Die Katalogabfrage kann die Inhalte aufgelöster Sub-Aggregate nicht laden) resolve: catalog lookup cannot load resolved recipe and plugin bodies (Auflösung: Die Katalogabfrage kann die Inhalte aufgelöster Recipe- und Plugin-Dokumente nicht laden)
So beheben Sie es: Nichts in Ihren Dateien erzeugt eine der beiden, und es gibt keine Änderung an dem, was Sie geschrieben haben, die eine davon beseitigt — der Fehler liegt darin, wie der Build verdrahtet wurde, und nicht darin, was er bauen sollte. Melden Sie ihn mit dem Befehl, den Sie ausgeführt haben, und der Workspace-Konfiguration, gegen die er lief.
An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Ein annotation-transform-Plugin nennt eine Komponente, die es nicht erhalten hat, oder injiziert einen Wert, den keine Annotation annimmt)
Ein Betreiber kann ein Governance-Plugin in einer Rolle anbinden, die Annotationen hinzufügt, und diese Anbindung ist eine Deklaration: Der Betreiber hat die Transformation verlangt, sodass das, was das Plugin hinzufügt, explizit ist und nicht hinter jemandes Rücken injiziert wird. Die Rolle ist entsprechend eingegrenzt. Das Plugin erhält die Komponentenkoordinaten, die Ihre Dokumente deklarieren, und darf Annotationen auf diese setzen, jede mit einem Wert, den Sie selbst auf diese Annotation hätten schreiben können: ein String oder ein Objekt aus Unterschlüsseln. Die Struktur, die es zurückgibt, lässt kein anderes Feld zu, sodass beim Anwenden seiner Ausgabe nur noch zu prüfen bleibt, ob jede Injektion eine Koordinate benannt hat, die es erhalten hat, und ob jeder Wert einer ist, den eine Annotation annimmt.
Eine Injektion, die ein Paar aus Boundary und Komponente außerhalb dieser Menge benennt, hält den Build an. Ein Plugin, das eine Komponente erreicht, die Ihre Dokumente nie freigegeben haben, würde Infrastruktur konfigurieren, die niemand deklariert hat, und die Annotationen, die es hinzufügt, werden genau wie selbst geschriebene in Feature-Anbindungen expandiert, sodass die Folge Ressourcen wären, die aus einer Komponente entstehen, die der Betreiber ihm nicht vorgelegt hat.
Eine Injektion, deren Wert null, eine Liste, eine Zahl, ein boolescher Wert oder ein Objekt ohne Unterschlüssel ist, hält den Build ebenfalls an. Null und ein leeres Objekt gelten als der Wert, den Sie schreiben, um eine Komponente von einer Annotation auszunehmen, die sie erben würde, und die Rolle fügt Annotationen hinzu, statt sie zu entfernen; die anderen Strukturen sind keine Werte, die eine Annotation annimmt. Die gesamte Ausgabe wird geprüft, bevor irgendein Teil davon angewendet wird, sodass eine zurückgewiesene Ausgabe nichts verändert.
Jede angenommene Injektion trägt außerdem eine Begleitannotation, aggrega.ai/injected-by, die das Plugin nennt, das sie vorgenommen hat. Der Host schreibt diese Annotation; ein Plugin kann keine liefern, sodass das, was sie über die Herkunft einer injizierten Annotation aussagt, nicht vom Plugin gestaltet werden kann.
Ausgegebene Meldung, für eine Koordinate, die das Plugin nicht erhalten hat, und für einen Wert, den keine Annotation annimmt:
annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (Die Ausgabe des annotation-transform-Plugins wurde abgelehnt: Eine Injektion zielt auf eine Komponentenkoordinate, die der Host nicht geliefert hat, oder trägt einen Wert, der weder ein String noch ein Objekt aus Unterschlüsseln ist: Die Injektion zielt auf Boundary, Komponente (Annotation)) annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys (Die Ausgabe des annotation-transform-Plugins wurde abgelehnt: Eine Injektion zielt auf eine Komponentenkoordinate, die der Host nicht geliefert hat, oder trägt einen Wert, der weder ein String noch ein Objekt aus Unterschlüsseln ist: Die Injektion für Boundary, Komponente (Annotation) trägt eine Liste; ein injizierter Annotationswert ist ein String oder ein Objekt aus Unterschlüsseln)
So beheben Sie es: Der Fehler liegt beim Plugin, nicht bei Ihren Dokumenten — korrigieren Sie es so, dass es nur auf die Koordinaten injiziert, die es erhält und die jeweils in seiner Eingabe ankommen, und als Wert nur einen String oder ein Objekt aus Unterschlüsseln. Ist die Komponente in der Meldung eine, von der Sie erwartet haben, dass das Plugin sie sieht, prüfen Sie, ob das Release sie innerhalb einer Boundary deklariert: Nur deklarierte Komponentenkoordinaten werden übergeben. Die Anbindung aus plugins.governance zu entfernen, ist der unmittelbare Weg, einen Build freizugeben, während das Plugin korrigiert wird.
A plugin reference is not a Plugin entity (Ein Plugin-Verweis ist keine Plugin-Entität)
Ein Plugin wird über seine Plugin-Entität referenziert, stets mit dem Geltungsbereich seines eigenen Socket-Typs: <pluginType>/<name>, optional mit einer Version, wie in parser/yaml oder parser/yaml:1.0.0. Der Geltungsbereich ist verpflichtend und nicht eine Form unter mehreren — ein name:version ohne Geltungsbereich wird zurückgewiesen, weil zwei Sockets ein Plugin gleichen Namens enthalten können und erst der Geltungsbereich die Entität auflösbar macht. Die Binärdatei, auf die die Entität verweist, wird über die Entität erreicht und nie direkt benannt, sodass die Entität den Fähigkeitsanspruch, die Laufzeitgrenzen und den erfassten Befehlssatz trägt, gegen die das Laden die Binärdatei prüft. Ein Verweis, der keine Plugin-Entität benennt, hat daher nichts, wogegen die Binärdatei geprüft werden könnte, und der Build hält an, statt Bytes über einen ungeprüften Verweis zu laden.
Zwei Strukturen werden hier gemeldet, und sie werden zu unterschiedlichen Zeitpunkten geprüft. Ein Verweis, dessen Form keine Entität sein kann — ein Dateisystempfad oder ein Artefaktverweis wie eine URL oci://, ein bloßes .wasm oder ein Digest @sha256: —, wird auf den Oberflächen, die nur Entitätsverweise annehmen, von vornherein zurückgewiesen. Ein Verweis, der keine Entität benennt, die irgendetwas enthält, wird nach der Suche zurückgewiesen, und was die Meldung sagt, hängt davon ab, wie er geschrieben ist: Eine Plugin-Entitäts-URI — <pluginType>/<name>, optional versioniert — wird als Entität gemeldet, die kein Katalogverzeichnis enthält, die die Binärdatei nicht mitbringt und die kein Pull abgerufen hat, und jedem anderen Verweis wird gesagt, diese Form anzunehmen. Beide Strukturen melden dieselbe Bedingung, sodass die Reaktion eines Builds auf beide dieselbe ist.
Ein Pull weist die zweite Struktur zurück, bevor ein Build auf sie trifft. Jedes Plugin, das die pipeline eines Recipe oder eines FeatureRecipe benennt, wird zusammen mit den übrigen Abhängigkeiten des Release aufgelöst — aus einem Katalogverzeichnis, der Kopie in der Compiler-Binärdatei, dem Content-Cache oder einer Registry —, und eines, das keine dieser Quellen enthält, hält aggrega pull an, bevor es das Lockfile schreibt, mit dieser Bedingung und derselben Meldung, unter Nennung des Recipe oder FeatureRecipe, dessen Pipeline es benennt.
Nicht jede Oberfläche weist eine Form zurück, die keine Entität ist. Die Oberfläche für Pipeline-Plugins nimmt nur Entitätsverweise an; die Oberflächen, an die ein Betreiber ein Plugin direkt anbindet, akzeptieren jede Form und reichen einen Verweis, der keine Entität ist, zur Auflösung als Artefakt weiter. So kann derselbe Verweis an einem Anbindungspunkt angenommen und an einem anderen zurückgewiesen werden, und dieser Unterschied liegt bei der Oberfläche, nicht beim Verweis.
Ausgegebene Meldungen. Ein Dateisystempfad:
plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (Plugin-Verweis ist keine Plugin-Entität: ist ein Dateisystempfad, aber ein Pipeline-Plugin muss eine Plugin-Entitäts-URI mit dem Geltungsbereich eines Plugin-Typs sein (optional versioniert))
ein Artefaktverweis:
plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (Plugin-Verweis ist keine Plugin-Entität: ist ein Artefaktverweis (ein URL-Schema, eine bloße Wasm-Datei oder ein Digest), aber ein Pipeline-Plugin muss eine Plugin-Entitäts-URI mit dem Geltungsbereich eines Plugin-Typs sein (optional versioniert))
eine Plugin-Entitäts-URI, die nichts enthält:
plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull (Plugin-Verweis ist keine Plugin-Entität: ist eine Plugin-Entitäts-URI, aber kein Katalogverzeichnis enthält die Entität, die sie benennt, die Binärdatei bringt sie nicht mit, und kein Pull hat sie in den Content-Cache abgerufen; legen Sie die Plugin-Entität in ein Katalogverzeichnis, oder veröffentlichen Sie sie in einer Registry und führen Sie den Pull aus)
und jeder andere Verweis, der keine Entität benennt — einer ohne den Geltungsbereich eines Plugin-Typs, mit mehr als einem / vor seiner Version oder mit einem Registry-Host:
plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity (Plugin-Verweis ist keine Plugin-Entität: muss eine Plugin-Entitäts-URI mit dem Geltungsbereich eines Plugin-Typs sein (optional versioniert); ein Verweis auf eine bloße Wasm-Datei oder ein Artefaktverweis benennt keine Plugin-Entität)
So beheben Sie es: Schreiben Sie den Verweis als die Identität der Plugin-Entität mit dem Geltungsbereich ihres Socket-Typs, optional mit ihrer Version — <pluginType>/<name> oder <pluginType>/<name>:<version>. Wenn Sie direkt auf eine Datei oder ein Artefakt verwiesen haben, veröffentlichen oder schreiben Sie dafür eine Plugin-Entität und verweisen Sie stattdessen auf diese — in der Entität liegen die Ansprüche, die das Laden prüft, daher gibt es keine gleichwertige Form, die sie umgeht. Sagt die Meldung, dass der Verweis eine Plugin-Entitäts-URI ist, ist seine Form richtig und es fehlt die Entität: Legen Sie die Plugin-Entität in ein Katalogverzeichnis, das der Workspace auflistet, mit ihrer gebauten .wasm daneben, oder veröffentlichen Sie das Plugin in einer Registry, die der Workspace liest, und führen Sie aggrega pull aus, das es in den Content-Cache abruft — und prüfen Sie, ob die Version, die Sie angeben, existiert.
A cached signature bundle does not match the digest recorded for it (Ein zwischengespeichertes Signatur-Bundle stimmt nicht mit dem dafür erfassten Digest überein)
Ein Artefakt, dessen Signatur beim Abrufen verifiziert wurde, trägt diese Tatsache in seinem Lockfile-Eintrag weiter — oder, bei einem in einer Verdikt-Rolle angebundenen Plugin, in seinem Eintrag in plugins-trust.yaml — als erfassten Digest des Signaturmaterials, das neben dem Artefakt zwischengespeichert wird. Bevor irgendetwas gerendert wird, liest der Build dieses zwischengespeicherte Material für jeden gelesenen Eintrag, der einen solchen Digest erfasst, erneut ein — eine Katalogentität beliebigen Typs, eine Bibliothek, ein Plugin —, berechnet seinen Hash neu, und der Hash muss der erfasste sein. Bei einem Plugin, das das Lockfile pinnt, und bei einem in einer Verdikt-Rolle angebundenen Plugin wird das Material erneut geprüft, wenn seine Bytes geladen werden; dadurch erreicht die Prüfung die Befehle, die ein Plugin außerhalb eines Builds laden — darunter aggrega lint --release und aggrega validate --release. Ein Bundle, das fehlt, nicht lesbar ist oder einen anderen Hash ergibt, bedeutet, dass das geprüfte Material nicht dem entspricht, was jetzt auf der Festplatte liegt, und der Lauf bricht ab, statt ein Artefakt zu verwenden, dessen Signaturnachweise sich gegenüber dem Erfassten verändert haben.
Die erneute Prüfung ist ein Hash-Vergleich und nichts weiter. Sie verifiziert keine Signatur erneut, kontaktiert kein Netzwerk und zieht kein Vertrauensmaterial heran, daher greift sie auch in einem Build ganz ohne Netzwerkzugang — und genau das lässt ein einmal verifiziertes Artefakt über spätere Offline-Builds hinweg verifiziert bleiben.
Der nächste Pull behebt es. Ein Pull unterzieht jeden Eintrag, den der Content-Cache geliefert hat, derselben Prüfung, und wo die Prüfung einen Eintrag zurückweist, fragt er die Registry des Artefakts erneut nach der Signatur — unabhängig davon, was die Signaturanforderung besagt, über dieselbe Verifizierung, die ein von ihm abgerufenes Artefakt erhält —, erfasst im Eintrag, was diese verifiziert, und speichert das von ihr genannte Bundle zwischen, wobei er eine zwischengespeicherte Kopie überschreibt, die nicht mehr zu ihrem Digest passt. Ein in einer Verdikt-Rolle angebundenes Plugin wird bei jedem Pull erneut verifiziert, unabhängig davon, was sein Eintrag erfasst, und sein Bundle wird auf dieselbe Weise zwischengespeichert. Daher nennt die Meldung für einen Eintrag, den der Content-Cache geliefert hat, diesen Pull. Ein Eintrag, der aus einem Katalogverzeichnis, aus der Kopie im Compiler-Binary oder von neben dem Release gelesen wird, wird nie bei einer Registry nachgefragt, daher lässt ein Pull eine darauf erfasste Signatur unverändert, und seine Meldung nennt keinen Pull.
Ausgegebene Meldungen, die das Artefakt, die zwischengespeicherte Datei und — bei einem Eintrag, den der Content-Cache geliefert hat — den Pull nennen, der ihn behebt, die Datei, in der er die Signatur erfasst, und das Release, das er abruft. Aus der Prüfung des Builds, nicht lesbar oder fehlend:
artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (Artefakt: zwischengespeichertes Signatur-Bundle ist nicht lesbar: zwischengespeichertes Signatur-Bundle stimmt nicht mit seinem erfassten Digest überein. Abhilfe: führen Sie den Pull aus, um die Signatur des Artefakts erneut bei seiner Registry zu verifizieren, sie in der Datei zu erfassen und das von ihr genannte Bundle zwischenzuspeichern)
und abweichend:
artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (Artefakt: zwischengespeichertes Signatur-Bundle hat einen anderen Digest als den erfassten: zwischengespeichertes Signatur-Bundle stimmt nicht mit seinem erfassten Digest überein. Abhilfe: führen Sie den Pull aus, um die Signatur des Artefakts erneut bei seiner Registry zu verifizieren, sie in der Datei zu erfassen und das von ihr genannte Bundle zwischenzuspeichern)
und, wo Plugin-Bytes aus dem Content-Cache geladen werden, zusätzlich mit ihrer Herkunft:
plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (Plugin, aufgelöst aus seiner Quelle: zwischengespeichertes Signatur-Bundle ist nicht lesbar: zwischengespeichertes Signatur-Bundle stimmt nicht mit seinem erfassten Digest überein. Abhilfe: führen Sie den Pull aus, um die Signatur des Artefakts erneut bei seiner Registry zu verifizieren, sie in der Datei zu erfassen und das von ihr genannte Bundle zwischenzuspeichern)
plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (Plugin, aufgelöst aus seiner Quelle: zwischengespeichertes Signatur-Bundle hat einen anderen Digest als den erfassten: zwischengespeichertes Signatur-Bundle stimmt nicht mit seinem erfassten Digest überein. Abhilfe: führen Sie den Pull aus, um die Signatur des Artefakts erneut bei seiner Registry zu verifizieren, sie in der Datei zu erfassen und das von ihr genannte Bundle zwischenzuspeichern)
<file> ist das Lockfile des Release oder plugins-trust.yaml im Verzeichnis des Release. Bei einem Eintrag, nach dem kein Pull fragt, endet die Meldung vor remediation:.
Ein Pull, der keine Registry zum Nachfragen hat, bricht stattdessen ab. Eine Katalogentität oder eine Bibliothek wird ohne Registry benannt und über die Einstellung default_registry des Workspace an eine gebunden. Wo der Workspace keine nennt — er tat es, als die Signatur erfasst wurde, und tut es nicht mehr —, ist keine Registry konfiguriert, bei der erneut nach dem Eintrag gefragt werden kann, daher bricht der Pull mit dieser Bedingung ab, statt ein Lockfile zu schreiben, das der nächste Build zurückweist, und lässt das Lockfile, wie es war. Seine Meldung enthält, nach dem Schritt, den der Pull gerade ausführte:
verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest (verify: erfasst eine Signatur, die ein Build nicht akzeptiert, und es ist keine Registry konfiguriert, bei der erneut danach gefragt werden kann: zwischengespeichertes Signatur-Bundle ist nicht lesbar: zwischengespeichertes Signatur-Bundle stimmt nicht mit seinem erfassten Digest überein)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — der Cache gehört dem Build, nicht Ihnen. Führen Sie aggrega pull --release <release> aus, den Befehl, den die Meldung nennt: Er verifiziert die Signatur des Artefakts erneut und schreibt die Signatur und ihr Bundle gemeinsam, was ein Bundle behebt, das seit dem Pull, der es zwischengespeichert hat, entfernt oder verändert wurde. Im Offline-Modus bricht dieser Pull ab — mit der Offline-Zurückweisung, weil Beheben bedeutet, die Registry zu fragen, oder, bei einem in einer Verdikt-Rolle angebundenen Plugin, schon davor, indem er die zum Plugin gehörende .wasm als eine nennt, die er nicht auflösen konnte, weil ein Pull diese .wasm aus der Plugin-Registry auflöst; das Netzwerk für diesen einen Lauf zuzulassen behebt es. Wo der Pull mit der Angabe abbricht, dass keine Registry konfiguriert ist, bei der nach dem Eintrag gefragt werden kann, setzen Sie default_registry auf die Registry, aus der das Artefakt per Pull abgerufen wurde, und führen Sie den Pull erneut aus. Wo der Workspace die Signaturverifizierung für das Artefakt überspringt, erfasst der Pull stattdessen keine Signatur im Eintrag, was der Build unter derselben Einstellung zulässt. Wo die Signatur, die die Registry liefert, sich nicht verifizieren lässt, bricht der Pull mit der eigenen Zurückweisung dieser Verifizierung ab: Die erfasste Signatur und das Material, das der Herausgeber liefert, widersprechen sich tatsächlich, und das ist eine Frage für denjenigen, der das Artefakt veröffentlicht. Bei einem Eintrag, dessen Meldung keinen Pull nennt — einem, der aus einem Katalogverzeichnis, aus der Kopie im Compiler-Binary oder von neben dem Release gelesen wird —, entfernen Sie die signature aus seinem Eintrag: Ein solcher Eintrag wird nie an einer Signaturanforderung gemessen, daher fährt der Build dann fort.
A recorded signature was made for a different artifact (Eine erfasste Signatur wurde für ein anderes Artefakt erstellt)
Eine Signatur gibt an, für welches Artefakt sie erstellt wurde. Wenn ein Pull die Signatur eines Artefakts verifiziert, erfasst er diese Tatsache im Lockfile-Eintrag des Artefakts — oder, bei einem in einer Verdikt-Rolle angebundenen Plugin, in seinem Eintrag in plugins-trust.yaml — und speichert die verifizierte Signatur zwischen. Bevor irgendetwas gerendert wird, liest der Build aus der zwischengespeicherten Signatur jedes Eintrags, den der Content-Cache geliefert hat, für welches Artefakt sie erstellt wurde, und das muss das Artefakt sein, das der Build selbst für den Eintrag gelesen hat: dasjenige, dessen Manifest neben seinen Bytes im Content-Cache liegt, niemals etwas, das der Eintrag erfasst. Eine für ein anderes Artefakt erstellte Signatur lässt den Build abbrechen. So sieht eine signature aus, die von einem Eintrag in einen anderen kopiert wurde: Die zwischengespeicherte Signatur, die sie nennt, ist intakt — sie stimmt noch mit dem für sie erfassten Digest überein — und wurde für das Artefakt des anderen Eintrags erstellt.
Sie hängt von keiner Signaturanforderung ab. Eine erfasste Signatur wird an dem gemessen, was sie beansprucht, unabhängig davon, ob eine erforderlich ist, ebenso wie bei der Prüfung, ob die zwischengespeicherte Signatur mit ihrem erfassten Digest übereinstimmt.
Ein Plugin wird überall, wo es geladen wird, auf dieselbe Weise geprüft. Bei einem Plugin, das das Lockfile pinnt, und bei einem in einer Verdikt-Rolle angebundenen Plugin wird die erfasste Signatur an dem Artefakt gemessen, als das seine Bytes gelesen wurden, wenn diese Bytes aus dem Content-Cache geladen werden; dadurch erreicht die Prüfung die Befehle, die ein Plugin außerhalb eines Builds laden — darunter aggrega lint --release und aggrega validate --release sowie dieselben Operationen, die über aggrega serve und aggrega mcp erreicht werden.
Was die Prüfung liest und was sie nicht unterscheiden kann. Sie liest die zwischengespeicherte Signatur und das Manifest neben dem Artefakt und vergleicht Hashes: Sie verifiziert keine Signatur, kontaktiert kein Netzwerk und zieht kein Vertrauensmaterial heran, daher greift sie auch in einem Build ganz ohne Netzwerkzugang. Sie liest, für welches Artefakt eine Signatur erstellt wurde, in beiden Formen, die ein Pull akzeptiert — eine Signatur über das Artefakt selbst, wie sie die eigenen Signierer der Toolchain erstellen, und eine signierte Aussage, die das Artefakt nennt —, daher wird eine von einem Eintrag in einen anderen kopierte Signatur in beiden Formen zurückgewiesen. Es ist dieselbe Lesart, die ein Pull auf jede Signatur anwendet, die er akzeptiert: Ein Pull weist eine Signatur zurück, die sich verifizieren lässt, die die Lesart aber nicht als für das Artefakt erstellt erkennt oder aus der sie das Artefakt überhaupt nicht lesen kann; daher ist keine Signatur, die ein Pull erfasst, eine, die die Prüfung nicht lesen kann. Ein Eintrag, der aus einem Katalogverzeichnis, aus der Kopie im Compiler-Binary oder von neben dem Release gelesen wird, kommt ohne Manifest, daher wird seine erfasste Signatur nur an seinem erfassten Digest gemessen; ebenso eine von Hand in den Cache gelegte Signatur in einer Form, die keine dieser beiden ist. Und weil keine Signatur verifiziert wird, ist eine von Hand in den Cache geschriebene Signatur, die auf das eigene Artefakt des Eintrags ausgestellt ist, nicht von einer zu unterscheiden, die ein Pull verifiziert hat.
Der nächste Pull behebt es. Ein Pull unterzieht jeden Eintrag, den der Content-Cache geliefert hat, derselben Prüfung, und wo die Prüfung einen Eintrag zurückweist, fragt er die Registry des Artefakts erneut nach der Signatur — unabhängig davon, was die Signaturanforderung besagt — und erfasst im Eintrag anstelle der kopierten Signatur, was diese verifiziert. Ein in einer Verdikt-Rolle angebundenes Plugin wird bei jedem Pull erneut verifiziert, unabhängig davon, was sein Eintrag erfasst. Nur bei einem Eintrag, den der Content-Cache geliefert hat, wird geprüft, für welches Artefakt seine Signatur erstellt wurde, daher nennt jede Zurückweisung dieser Bedingung durch einen Build oder einen Plugin-Ladevorgang diesen Pull.
Ausgegebene Meldungen, die den Eintrag, die Datei, die die Signatur erfasst, die zwischengespeicherte Signatur, das Manifest, das der Build für den Eintrag gelesen hat, und den Pull nennen, der ihn behebt. Aus der Prüfung des Builds:
artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (Artefakt: signing: die erfasste Signatur wurde für ein anderes Artefakt erstellt, mit der Datei, die sie erfasst, dem zwischengespeicherten Signatur-Bundle und dem Manifest des gelesenen Artefakts. Abhilfe: führen Sie den Pull aus, um die Signatur des Artefakts erneut bei seiner Registry zu verifizieren, sie in der Datei zu erfassen und das von ihr genannte Bundle zwischenzuspeichern)
und, wo Plugin-Bytes geladen werden, zusätzlich mit ihrer Herkunft:
plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (Plugin, aufgelöst aus seiner Quelle: signing: die erfasste Signatur wurde für ein anderes Artefakt erstellt, mit der Datei, die sie erfasst, dem zwischengespeicherten Signatur-Bundle und dem Manifest des gelesenen Artefakts. Abhilfe: führen Sie den Pull aus, um die Signatur des Artefakts erneut bei seiner Registry zu verifizieren, sie in der Datei zu erfassen und das von ihr genannte Bundle zwischenzuspeichern)
<file> ist das Lockfile des Release oder plugins-trust.yaml im Verzeichnis des Release.
Ein Pull, der keine Registry zum Nachfragen hat, bricht stattdessen ab, wie bei einem zwischengespeicherten Signatur-Bundle, das nicht mehr zu seinem Digest passt: Wo eine Katalogentität oder eine Bibliothek eine kopierte Signatur trägt und der Workspace keine Einstellung default_registry mehr nennt, über die sie an eine Registry gebunden werden kann, bricht der Pull mit dieser Bedingung ab und lässt das Lockfile, wie es war. Seine Meldung enthält, nach dem Schritt, den der Pull gerade ausführte:
verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>) (verify: erfasst eine Signatur, die ein Build nicht akzeptiert, und es ist keine Registry konfiguriert, bei der erneut danach gefragt werden kann: signing: die erfasste Signatur wurde für ein anderes Artefakt erstellt, mit dem zwischengespeicherten Signatur-Bundle und dem Manifest des gelesenen Artefakts)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — die Signatur, die der Eintrag erfasst, gehört zu einem anderen Artefakt. Führen Sie aggrega pull --release <release> aus, den Befehl, den die Meldung nennt: Er verifiziert die eigene Signatur des Eintrags bei seiner Registry und erfasst sie anstelle der kopierten, für einen Lockfile-Eintrag ebenso wie für ein in einer Verdikt-Rolle angebundenes Plugin. Die eigene erfasste Signatur des Eintrags aus der Versionskontrolle wiederherzustellen, wo die Datei committet ist, funktioniert ebenfalls. Im Offline-Modus bricht der Pull ab — mit der Offline-Zurückweisung, weil Beheben bedeutet, die Registry zu fragen, oder, bei einem in einer Verdikt-Rolle angebundenen Plugin, schon davor, indem er die zum Plugin gehörende .wasm als eine nennt, die er nicht auflösen konnte, weil ein Pull diese .wasm aus der Plugin-Registry auflöst; das Netzwerk für diesen einen Lauf zuzulassen behebt es. Wo der Pull mit der Angabe abbricht, dass keine Registry konfiguriert ist, bei der nach dem Eintrag gefragt werden kann, setzen Sie default_registry auf die Registry, aus der das Artefakt per Pull abgerufen wurde, und führen Sie den Pull erneut aus. Wo der Workspace die Signaturverifizierung für das Artefakt überspringt, erfasst der Pull stattdessen keine Signatur im Eintrag, was der Build unter derselben Einstellung zulässt.
No verified signature is recorded for an artifact that requires one (Für ein Artefakt, das eine Signatur erfordert, ist keine verifizierte Signatur erfasst)
Ein Pull, der ein Artefakt aus einer Registry abruft, verifiziert dessen Signatur anhand der Vertrauensrichtlinie dieser Registry und erfasst die verifizierte Tatsache im Lockfile-Eintrag des Artefakts. Ein Build erreicht keine Registry, daher liest er die erfasste Tatsache, statt erneut zu verifizieren — und bevor irgendetwas gerendert wird, misst er jeden Eintrag, den er liest, an der Anforderung, die der Pull beim Abrufen des Artefakts angewendet hat. Ein vom Content-Cache bereitgestellter Eintrag für ein Artefakt, für das eine Signatur erforderlich ist, der keine verifizierte Signatur erfasst, bricht den Build ab: Nichts, was dem Build vorliegt, besagt, dass das Artefakt, aus dem er gleich rendern wird, jemals verifiziert wurde.
Die Anforderung ist die des Pull, Einstellung für Einstellung. Eine Signatur ist erforderlich, wo die workspaceweite Signaturrichtlinie den Typ des Artefakts abdeckt oder wo der eigene Eintrag der Registry in .aggrega-config.yaml — oder, für hub.aggrega.ai ohne eigenen Eintrag, die eingebaute Richtlinie des offiziellen Hubs — eine verlangt; ein Artefakt, dessen Typ nicht bestimmt werden konnte, gilt unter einer aktiven Richtlinie als erforderlich. Was einem Pull erlaubt, ein Artefakt ohne Signatur zuzulassen, erlaubt auch dem Build, dessen Eintrag zuzulassen: skip_signature_verification auf oberster Ebene, derselbe Schalter im eigenen Eintrag der Registry außer für einen Typ, den die workspaceweite Richtlinie verlangt, und eine als advisory markierte Registry.
Woher ein Eintrag stammt, wird aus dem Build gelesen, nie aus dem Lockfile. Jeder vom Content-Cache bereitgestellte Eintrag wird an der Anforderung gemessen, unabhängig davon, was der Eintrag sonst erfasst, sodass das Entfernen des Manifest-Digests eines Eintrags zusammen mit seiner Signatur ihn nicht ausnimmt. Ein Eintrag, der aus einem Katalogverzeichnis, aus der Kopie im Compiler-Binary oder von neben dem Release gelesen wird, wird nie daran gemessen, weil für Bytes, die nicht aus einer Registry stammen, keine Registry-Signatur existiert. Einträge jedes Abschnitts werden gleich geprüft — Katalogentitäten, Bibliotheken und Plugin-Artefakte —, und jeder Eintrag, den die Prüfung zurückweist, wird im selben Lauf benannt.
Ein in einer Verdikt-Rolle angebundenes Plugin unterliegt derselben Prüfung, über plugins-trust.yaml. Eine Anbindung plugins.governance in einer Rolle ir-verdict oder render-verdict und jede Anbindung plugins.linter formt kein gerendertes Byte und hat daher keinen Lockfile-Eintrag; die Aufzeichnung neben dem Lockfile trägt stattdessen ihre verifizierte Signatur. Jedes solche Plugin, das der Build aus dem Content-Cache liest, wird an derselben Anforderung gemessen, über dieselben Einstellungen: Ein Eintrag in dieser Aufzeichnung, der keine Signatur erfasst, bricht den Build ab, und ebenso das Fehlen jedes Eintrags für das Plugin — das Löschen der Aufzeichnung nimmt es nicht aus. Ein Plugin, das aus einem Katalogverzeichnis oder aus der Kopie im Compiler-Binary bereitgestellt wird, wird nicht daran gemessen. Die Anforderung gilt für ein solches Plugin überall, wo es für ein Release geladen wird, nicht nur in einem Build: aggrega lint --release und aggrega validate --release sowie dieselben über aggrega serve und aggrega mcp erreichten Operationen schlagen bei dieser Bedingung fehl, wenn sie es laden.
Ausgegebene Meldungen, die den Eintrag, die Datei, die keine Signatur dafür erfasst, die Einstellungen, die seine Signatur verlangen, und den Befehl nennen, der sie in dieser Datei erfasst. Für einen Lockfile-Eintrag, mit Nennung des Lockfile:
signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path> (signing: Für ein Artefakt, das eine Signatur erfordert, ist keine verifizierte Signatur erfasst: Das Lockfile erfasst keine Signatur dafür, verlangt von den genannten Einstellungen. Abhilfe: Führen Sie den Pull aus, um die Signatur des Artefakts bei seiner Registry zu verifizieren und im Lockfile zu erfassen)
und für ein in einer Verdikt-Rolle angebundenes Plugin, mit Nennung seiner Aufzeichnung:
signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path> (signing: Für ein Artefakt, das eine Signatur erfordert, ist keine verifizierte Signatur erfasst: Die Aufzeichnung erfasst keine Signatur für das Plugin, verlangt von den genannten Einstellungen. Abhilfe: Führen Sie den Pull aus, um die Plugin-Signatur bei seiner Registry zu verifizieren und in der Aufzeichnung zu erfassen)
Beide Dateien werden über ihren Pfad neben dem Release benannt, das dem Befehl übergeben wurde: <lockfile-path> ist das Lockfile des Release, und <record-path> ist plugins-trust.yaml im Verzeichnis des Release.
Die Einstellungen werden mit den eigenen Worten der Konfigurationsdatei benannt: `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>" oder the official hub's built-in signature requirement for "hub.aggrega.ai", verbunden, wo mehr als eine zutrifft.
So beheben Sie es: Führen Sie den Pull aus, den die Meldung nennt. Für einen vom Content-Cache bereitgestellten Eintrag, der keine Signatur erfasst, wo eine erforderlich ist, fragt der Pull die Registry des Artefakts nach dessen Signatur, über den Manifest-Digest, den der Eintrag erfasst, genau wie bei einem Artefakt, das er abruft, und erfasst die verifizierte Signatur im Eintrag — sodass der nächste Build sie liest. Nach einem in einer Verdikt-Rolle angebundenen Plugin wird ohnehin bei jedem Pull gefragt, und der Pull erfasst, was er verifiziert hat, im Plugin-Eintrag in plugins-trust.yaml und legt den Eintrag an, wo keiner existiert. Eine Registry, die keine Signatur anbindet, oder eine Signatur, die die Vertrauenskonfiguration nicht akzeptiert, bricht stattdessen diesen Pull ab und nennt das Artefakt; das ist eine Frage an denjenigen, der es veröffentlicht. Im Offline-Modus kann der Pull nicht fragen: Bei einem Lockfile-Eintrag weist er zurück und nennt, wie das Netzwerk für einen Lauf erlaubt wird, und bei einem in einer Verdikt-Rolle angebundenen Plugin bricht er vor dem Fragen ab und nennt die zum Plugin gehörende .wasm als eine, die er nicht auflösen konnte, weil ein Pull diese .wasm aus der Plugin-Registry auflöst. Das Wiederherstellen der erfassten Signatur des Eintrags aus der Versionskontrolle behebt es ohne Netzwerk, sofern der Cache das Signaturmaterial, das dieser Eintrag nennt, noch enthält. Wo das Artefakt nicht signiert werden soll, ist die Anforderung das, was zu ändern ist, und die Meldung nennt, welche Einstellung es ist — doch sie zu lockern bedeutet, dass die Artefakte dieser Registry auch bei einem Pull nicht mehr geprüft werden; schränken Sie daher lieber die Typen der workspaceweiten Richtlinie ein, als eine Anforderung abzuschalten.
A recorded signature is not the one a pull would record (Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde)
aggrega pull --verify meldet, ob das Ausführen von aggrega pull jetzt die Dateien ändern würde, die ein Pull festschreibt, und die Signatur, die ein Pull für ein Artefakt verifiziert hat, gehört zu dem, was er schreibt: die signature in einem Lockfile-Eintrag und in einem Eintrag von plugins-trust.yaml für ein in einer Verdikt-Rolle angebundenes Plugin. Diese Bedingung ist das, was ein Verify-Lauf für jede erfasste Signatur meldet, die ein einfacher Pull anders schreiben würde — eine, die er erfassen würde, wo keine erfasst ist, eine, die er ersetzen würde, oder eine, die er löschen würde. Der Verify-Lauf schreibt keine der beiden Dateien und nennt jeden solchen Eintrag, in beiden Dateien, im selben Lauf.
Zwei Lockfile-Einträge werden gemeldet, ohne eine Registry zu fragen, weil ein Pull sie umschreibt, was auch immer die Registry antwortet, sodass sie auch im Offline-Modus gemeldet werden: ein vom Content-Cache bereitgestellter Eintrag, der keine Signatur erfasst, wo die Vertrauenskonfiguration eine verlangt — der Pull erfasst die Signatur des Artefakts oder bricht ab, wo er keine feststellen kann —, und ein Eintrag, dessen erfasste Signatur für ein anderes Artefakt erstellt wurde, die der Pull durch die eigene des Artefakts ersetzt.
Nach jedem anderen Eintrag, den ein Pull erneut nachschlagen würde, wird gefragt, weil nur die Antwort der Registry sagt, ob der Pull ihn ändern würde: ein Eintrag, dessen Bytes der Verify-Lauf abgerufen hat, weil der Content-Cache sie nicht enthielt, und ein Eintrag, dessen zwischengespeichertes Signatur-Bundle entfernt wurde, unlesbar ist oder verändert wurde. Der Verify-Lauf fragt die Registry, wie es der Pull täte, meldet den Eintrag, wo die Antwort seine Signatur erfasst, ersetzt oder löscht, und speichert das Bundle, das er verifiziert hat, so im Cache, wie ein Pull es speichert. Im Offline-Modus wird nach einem solchen Eintrag weder gefragt, noch wird er gemeldet: Der Verify-Lauf gibt eine Zeile aus, die ihn nennt und besagt, dass seine Signatur nicht geprüft wurde.
Für die Plugin-Vertrauensaufzeichnung verifiziert jeder Pull für jedes in einer Verdikt-Rolle angebundene Plugin dessen Signatur bei seiner Registry, und ebenso ein Verify-Lauf: Gemeldet wird ein Eintrag, dessen Signatur diese Verifizierung erfassen, ersetzen oder löschen würde, und ebenso ein Plugin, für das die Aufzeichnung keinen Eintrag enthält, wo ein Build es zurückweist, weil keine Signatur erfasst ist, denn ein Pull schreibt einen Eintrag mit seiner Signatur, und der Build weist das Plugin bis dahin zurück. Jedes andere Plugin, das die Aufzeichnung noch nicht enthält, ist ein erstes Auftreten und wird nicht gemeldet. Im Offline-Modus fragt ein Verify-Lauf keine Registry nach diesen Plugins: Er liest jedes aus dem Content-Cache, wie ein Build es liest, und prüft seine Identität und seine Host-Funktionen, wie es ein verbundener Verify-Lauf tut. Er meldet, ohne zu fragen, ein Plugin, das ein Build zurückweist, weil keine Signatur erfasst ist — sein Eintrag erfasst keine, oder die Aufzeichnung enthält keinen Eintrag dafür —, und eines, das ein Build zurückweist, weil die Signatur, die sein Eintrag erfasst, für ein anderes Artefakt erstellt wurde, denn ein Pull schreibt diesen Eintrag um, was auch immer die Registry antwortet; für jeden anderen Eintrag gibt er eine Zeile aus, die ihn nennt und besagt, dass seine Signatur nicht geprüft wurde.
Veraltungsmarkierungen werden nicht verglichen. Eine Markierung, die nach dem Pull an ein Artefakt angebunden wird, ist der Zustand der Registry und ändert sich, ohne dass sich im Workspace etwas ändert; ein Verify-Lauf, der daran scheiterte, ließe also eine Prüfung über Dateien scheitern, die niemand angefasst hat — der Grund, warum eine erfasste Markierung für einen Build ein Hinweis ist, statt ihn abzubrechen.
Ausgegebene Meldungen, eine pro Eintrag, die den Eintrag, die Datei und das, was sie erfasst, das, was ein Pull stattdessen erfassen würde, und den Pull nennen, der die Datei auf den neuesten Stand bringt. Wo die Antwort der Registry oder die eigene Verifizierung der Aufzeichnung die Signatur liefert, die ein Pull erfassen würde:
signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde: Die Datei erfasst eine Signatur, ein Pull würde eine andere erfassen. Abhilfe: Führen Sie den Pull aus, um die Datei auf den neuesten Stand zu bringen)
für einen Eintrag, der keine Signatur erfasst, wo eine erforderlich ist — ein Lockfile-Eintrag oder, im Offline-Modus, ein Eintrag der Plugin-Vertrauensaufzeichnung:
signing: a recorded signature is not the one a pull would record ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde: Die Datei erfasst keine Signatur, ein Pull würde seine Registry nach der Signatur fragen, die eine Anforderung verlangt, und sie erfassen. Abhilfe: Führen Sie den Pull aus, um die Datei auf den neuesten Stand zu bringen)
für einen Eintrag, dessen erfasste Signatur für ein anderes Artefakt erstellt wurde — ein Lockfile-Eintrag oder, im Offline-Modus, ein Eintrag der Plugin-Vertrauensaufzeichnung:
signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde: Die Datei erfasst eine für ein anderes Artefakt erstellte Signatur, ein Pull würde seine Registry nach der eigenen Signatur dieses Artefakts fragen und sie erfassen. Abhilfe: Führen Sie den Pull aus, um die Datei auf den neuesten Stand zu bringen)
und für ein Plugin, für das die Aufzeichnung keinen Eintrag enthält, wo ein Build es zurückweist, weil keine Signatur erfasst ist — die zweite Form im Offline-Modus, wo der Verify-Lauf keine Registry fragt:
signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde: Die Aufzeichnung enthält keinen Eintrag für das Plugin, und es erfordert eine Signatur; ein Pull würde eine Signatur erfassen. Abhilfe: Führen Sie den Pull aus, um die Aufzeichnung auf den neuesten Stand zu bringen)
signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde: Die Aufzeichnung enthält keinen Eintrag für das Plugin, und es erfordert eine Signatur; ein Pull würde seine Registry nach der Signatur fragen, die eine Anforderung verlangt, und sie erfassen. Abhilfe: Führen Sie den Pull aus, um die Aufzeichnung auf den neuesten Stand zu bringen)
<signature> gibt eine Signatur über ihren Modus, ihren Signierer und den Digest ihres Bundles an — a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, mit issued by <issuer> nach dem Signierer bei einer schlüssellosen Signatur — oder ist no signature. <file> ist das Lockfile des Release, <lockfile-path>, oder plugins-trust.yaml im Verzeichnis des Release, <record-path>.
So beheben Sie es: Führen Sie den Pull aus, den die Meldung nennt. Er schreibt in die genannte Datei die Signatur, die er laut Meldung schreiben würde, und speichert ihr Bundle im Cache, sodass der nächste Verify-Lauf erfolgreich ist. Wo die Meldung besagt, dass ein Pull die Registry fragen würde, erfasst der Pull, was die Registry verifiziert — und bricht stattdessen ab und nennt das Artefakt, wo die Registry eine Signatur anbindet, die die Vertrauenskonfiguration nicht akzeptiert, oder keine, wo eine erforderlich ist; das ist eine Frage an denjenigen, der es veröffentlicht. Im Offline-Modus bricht dieser Pull ab: bei einem Lockfile-Eintrag mit der Offline-Zurückweisung, weil er die Registry fragen muss, und bei einem in einer Verdikt-Rolle angebundenen Plugin schon davor, indem er die zum Plugin gehörende .wasm als eine nennt, die er nicht auflösen konnte, weil ein Pull diese .wasm aus der Plugin-Registry auflöst. Das Netzwerk für diesen einen Lauf zu erlauben bringt die Datei auf den neuesten Stand. Wo die Meldung besagt, dass ein Pull keine Signatur erfassen würde, bindet die Registry keine mehr an, und nichts verlangt eine: Der Pull löscht die Signatur des Eintrags, was ein Build unter denselben Einstellungen zulässt — wenn Sie nicht erwartet haben, dass die Registry aufhört, das Artefakt zu signieren, ist auch das eine Frage an dessen Herausgeber.
A plugin’s .wasm is not on this machine (Die Wasm-Datei zu einem Plugin ist nicht auf diesem Rechner)
Die zu einem Plugin gehörende .wasm wird von einem von vier Orten gelesen, in dieser Reihenfolge: aus den in das Binary des Compilers eingebauten Plugins, aus einer Datei neben seiner Entität Plugin in einem Katalogverzeichnis, aus einem expliziten Dateisystempfad, den der Verweis nennt, und aus dem Content-Cache des Workspace, den aggrega pull füllt. Das Auflösen eines Plugin-Verweises liest nur, was bereits auf dem Rechner ist, und ruft nichts ab, daher meldet diese Bedingung, dass keiner der vier Orte die Bytes enthält — nicht, dass ein Download fehlgeschlagen ist. Ein Plugin ist die Ausnahme: ein Core-Importer, den ein Import benötigt. Sein Modul wird nur aus dem Binary oder dem Content-Cache gelesen, nie von neben einer Katalogentität, und wo keiner von beiden es enthält, ruft der Import es einmal von der Standard-Registry des Workspace ab; die Bedingung meldet dann zusätzlich, dass der Abruf nicht möglich war — der Workspace ist offline, seine Registry war nicht erreichbar oder enthält das Modul nicht, oder der Workspace nennt keine Standard-Registry. Ein Modul, das abgerufen wurde und die Verifizierung nicht besteht, wird stattdessen unter seiner eigenen Bedingung zurückgewiesen, einer Digest-Abweichung oder einer Signatur-Zurückweisung, und nichts wird behalten.
Die Datei neben der Entität wird nach dem Plugin-Typ und dem Namen der Entität benannt, und die Zurückweisung des Pulls weiter unten nennt den Namen: Für pipeline-step/patch ist es pipeline-step--patch.wasm, in dem Verzeichnis, in dem das Dokument der Entität liegt.
Eine Entität Plugin, die in einem Ihrer Katalogverzeichnisse verfasst ist, wird zurückgewiesen, wenn der Pull sie auflöst. Ein Pull ruft die .wasm einer solchen Entität nie ab: Er sucht an den vier oben genannten Orten, genau dort, wo ein Build sucht. Ein Pipeline-Schritt, ein Provider oder ein an eine Verdikt-Rolle angebundenes Plugin wird überhaupt nicht gepinnt, und ein Build liest seine Entität jedes Mal aus dem Katalogverzeichnis. Ein an eine Transform-Rolle angebundenes Plugin wird gepinnt, weil seine Bytes die gerenderte Ausgabe formen: Der Pull erfasst seine Entität und den Inhalts-Digest der dort gefundenen .wasm, und ein Build weist eine .wasm zurück, die nicht mehr übereinstimmt. Ein Pull, der das Artefakt an keinem der vier Orte findet, bricht daher dort ab, bevor er das Lockfile oder irgendein entity.lock schreibt, statt einen Build später scheitern zu lassen, beim Schritt, der das Plugin lädt. Eine .wasm, die das Binary mitbringt, oder eine, die bereits im Content-Cache liegt, genügt dem Pull genau so, wie sie dem Build genügt, sodass eine Entität für ein Plugin, das im Compiler ausgeliefert wird, keine Datei neben sich braucht.
Ausgegebene Meldungen. Die Zurückweisung des Pulls, die auf das Verzeichnis zeigt, in dem er die Datei erwartet hat, mit der Auflösung, nach der er gefragt hat, darunter:
plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (Plugin-Artefakt nicht auf diesem Rechner gefunden: Die Plugin-Entität ist in einem Katalogverzeichnis verfasst, erwartet wurde die angegebene Datei im angegebenen Verzeichnis. Legen Sie die gebaute .wasm unter diesem Namen neben die Entität, oder veröffentlichen Sie das Plugin und verweisen Sie auf die veröffentlichte Plugin-Entität statt auf die im Katalogverzeichnis)
ein Plugin, das ein Build oder ein Import lädt, ohne dass eine Quelle seine Bytes enthält — und ein an eine Verdikt-Rolle angebundenes Plugin, das aggrega pull --verify im Offline-Modus wie ein Build aus dem Content-Cache liest. Wo die zum Plugin gehörende Entität Plugin in einem Katalogordner liegt, mit der Version, auf der es steht, und dem Ort, an den sein Modul gehört:
plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine (das Plugin in der angegebenen Version ist nicht auf diesem Rechner; legen Sie sein Modul unter dem angegebenen Namen neben seine Plugin-Entität im angegebenen Verzeichnis: Plugin-Artefakt nicht auf diesem Rechner gefunden)
und andernfalls, mit jedem Ort, an dem nach dem Modul gesucht wurde:
plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine (das Plugin ist nicht auf diesem Rechner: Das Binary enthält sein Modul nicht, kein Katalogordner enthält seine Plugin-Entität, und der Content-Cache, in den ein Pull abruft, enthält es nicht: Plugin-Artefakt nicht auf diesem Rechner gefunden)
Ein Lint-Lauf, der nur im Binary sucht, nennt allein den ersten dieser Orte.
und dasselbe für einen Verweis, der als Registry-Adresse geschrieben ist:
plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine (Plugin nicht auflösbar: Ein OCI-Plugin-URI erfordert einen vorherigen Pull, damit seine Bytes im Cache liegen, oder einen expliziten lokalen Pfad; die Plugin-Auflösung ruft nichts von einer Registry ab: Plugin-Artefakt nicht auf diesem Rechner gefunden)
ein Core-Importer, den ein Import weder lesen noch abrufen konnte, mit dem Importer, seiner Version und dem Grund — hier, dass der Workspace offline ist — und dann dem, was sein Modul auf den Rechner bringt:
core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine (der Core-Importer in der angegebenen Version ist nicht auf diesem Rechner, und der Workspace ist offline, daher wird seine Registry nicht danach gefragt; führen Sie den Import einmal mit verfügbarem Netzwerk aus, was ihn von der Standard-Registry des Workspace abruft, verifiziert und für jeden späteren Import im Content-Cache behält, oder legen Sie sein Modul unter dem angegebenen Namen neben eine Plugin-Entität dieses Importers in dieser Version in einem Katalogordner: Plugin-Artefakt nicht auf diesem Rechner gefunden)
Die anderen Gründe lauten its registry <host> could not be reached (<cause>), its registry <host> holds no <location>:<version> und the workspace names no default registry to fetch it from; die letzten beiden nennen nur die zweite Abhilfe, weil ein Lauf mit verfügbarem Netzwerk an ihnen nichts ändern würde.
So beheben Sie es: Wo die Entität eine ist, die Sie verfassen, bauen Sie das Plugin und legen Sie seine .wasm unter dem Namen, den die Meldung nennt, neben die Entität — oder veröffentlichen Sie das Plugin mit aggrega push und verweisen Sie auf die veröffentlichte Entität statt auf die Kopie im Katalog, da weder ein Pull noch ein Build die .wasm einer Entität in Ihrem Katalog abruft. Wo das Plugin eines ist, das Sie aus einer Registry beziehen, führen Sie aggrega pull für das Release aus, was es im Cache ablegt. Wo Sie erwartet haben, dass der Compiler das Plugin selbst mitbringt, prüfen Sie, ob das Binary, das Sie ausführen, es tut: aggrega plugin list nennt die eingebauten Plugins. Wo es ein Core-Importer ist, führen Sie den Import einmal dort aus, wo der Workspace seine Standard-Registry erreichen darf — dieser Lauf ruft ihn ab, verifiziert ihn und legt ihn im Cache ab, und jeder spätere Import ist offline — oder, wo diese Registry ihn nicht enthält, legen Sie sein Modul unter dem Namen, den die Meldung nennt, neben eine Plugin-Entität dieses Importers in dieser Version in einem Katalogordner; diese Entität läuft dann an der Stelle des Core-Importers.
A plugin recorded as a trusted gate is no longer attached (Ein als vertrauenswürdiges Gate erfasstes Plugin ist nicht mehr angebunden)
Ein Plugin, das ein Verdikt über Annahme oder Zurückweisung eines Builds liefert, wird erfasst, sobald es aufgelöst wurde, sodass der Workspace eine Aufzeichnung darüber hält, welche Gates geprüft wurden. Diese Bedingung meldet ein erfasstes Gate, das nichts mehr anbindet. Sie bricht den Build ab, statt ihn stillschweigend durchgehen zu lassen, weil seine Ausgabe sonst nicht von einer Ausgabe zu unterscheiden wäre, die das Gate genehmigt hat: Ein Build, bei dem das Gate stillschweigend fehlt, und ein Build, den das Gate durchgelassen hat, erzeugen dieselben Dateien, und niemand, der das Ergebnis prüft, könnte sagen, welchen von beiden er vor sich hat.
Das ist eine andere Frage als bei einem Plugin, dessen Bytes abgewichen sind. Jene weist es zurück, ein Plugin auszuführen, das nicht das geprüfte ist — eine Frage der Identität. Diese weist es zurück, mit einem geprüften Gate zu bauen, das ganz fehlt — eine Frage der Anwesenheit. Die Abhilfen unterscheiden sich entsprechend: das Artefakt wiederherstellen, gegenüber die Anbindung wiederherstellen.
Was dies feststellt und was nicht. Die Konfiguration an der Aufzeichnung festzuhalten stellt fest, dass jedes erfasste Gate noch angebunden ist und dass das Artefakt jedes einzelnen das erfasste ist. Es stellt nichts darüber fest, ob ein angebundenes Gate überhaupt ein Verdikt liefert: Eine Anbindung, deren Einstiegsfunktion einen deklarierten Export nennt, der kein Verdikt liefert, läuft, meldet nichts und lässt den Build durch, und kein Vergleich mit der Aufzeichnung bemerkt es — das Plugin, das lief, ist genau das erfasste, und es hat einfach nichts ausgeführt. Zwei benachbarte Fälle brechen den Build sehr wohl ab, und sie werden genannt, damit diese Grenze nicht weiter gelesen wird, als sie ist: Eine Einstiegsfunktion, die einen Export nennt, den das Plugin nicht deklariert, wird zurückgewiesen, wenn das Plugin geladen wird, und eine Ausgabe mit einem Schlüssel, den die Verdikt-Struktur nicht deklariert, wird zurückgewiesen, statt als leere Verdikt-Liste gelesen zu werden.
Ausgegebene Meldung, mit der Aufzeichnung, den entfernten Gates und beiden Abhilfen:
a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry (ein als vertrauenswürdig für ein Verdikt über Annahme oder Zurückweisung erfasstes Plugin ist an keine Verdikt-Rolle mehr angebunden: Die Aufzeichnung erfasst das Plugin als vertrauenswürdig, aber keine Verdikt-Anbindung in der Workspace-Konfiguration nennt es; ein Gate, das geprüft wurde und jetzt fehlt, hinterlässt eine Ausgabe, die nicht von einer Ausgabe zu unterscheiden ist, die dieses Gate genehmigt hat. Binden Sie das Plugin erneut im Governance-Abschnitt der Plugin-Konfiguration an eine IR-Verdikt- oder Render-Verdikt-Rolle an, oder im Linter-Abschnitt; oder, falls es entfernt werden sollte, führen Sie das gezielte Upgrade aus, um es aus der Aufzeichnung zu entfernen — ein gewöhnlicher Pull lässt die Aufzeichnung, wie sie ist, sodass nur ein explizites Upgrade einen Eintrag entfernt)
Wo mehr als ein Gate entfernt wurde, werden sie gemeinsam in einem einzigen Upgrade-Befehl genannt statt mit je einem Befehl: Ein gezieltes Upgrade nimmt mehrere Ziele an und lässt jeden Pin, den es nicht genannt hat, unverändert, sodass das gemeinsame Nennen sowohl kürzer als auch enger ist als die vollständige Aktualisierung, die die Alternative bräuchte.
So beheben Sie es: Die Meldung bietet zwei Abhilfen, weil nur Sie wissen, welche zutrifft. Wenn das Gate versehentlich entfernt wurde, binden Sie das Plugin erneut unter plugins.governance an eine Verdikt-Rolle an, oder unter plugins.linter. Wenn es entfernt werden sollte, sagen Sie das ausdrücklich mit dem gezielten Upgrade, das die Meldung ausschreibt, denn das entfernt seinen Eintrag. Bearbeiten oder löschen Sie die Aufzeichnung nicht, um dies zu beseitigen — sie ist eine committete Aufzeichnung dessen, was geprüft wurde, und ein gewöhnlicher Pull lässt sie absichtlich unverändert, weil das stillschweigende Übernehmen einer Entfernung genau das ist, was diese Zurückweisung verhindern soll.
A gate recorded as trusted resolves to a different identity (Ein als vertrauenswürdig erfasstes Gate wird zu einer anderen Identität aufgelöst)
Ein Plugin, das ein Verdikt über Annahme oder Zurückweisung eines Builds liefert, wird erfasst, sobald es aufgelöst wurde, zusammen mit der Version und dem Artefakt-Digest, zu denen es aufgelöst wurde. Diese Bedingung meldet eine spätere Auflösung, wenn sie für ein Gate, das die Aufzeichnung bereits enthält, eine andere Version oder andere Bytes erreicht und der Lauf nie verlangt hat, diese Identität zu übernehmen.
Eine einzige Bedingung deckt sowohl eine verschobene Version als auch verschobene Bytes ab, weil die Aufzeichnung über die Plugin-Identität adressiert wird und Version und Digest als Felder eines einzigen Eintrags führt: Eine Auflösung mit ihr zu vergleichen ist ein einziger Vergleich mit einem einzigen Ergebnis. Eine Neuveröffentlichung, die keine Bytes geändert hat, und ein erneuter Push mit derselben Version sind für einen Prüfer dasselbe Ereignis — die Identität ist nicht mehr die, die geprüft wurde.
Das ist eine andere Frage als bei einem erfassten Gate, das nichts mehr anbindet; das ist eine Frage der Anwesenheit statt der Identität. Sie unterscheidet sich auch von einem Plugin, dessen gecachte Bytes nicht mit dem erfassten Digest übereinstimmen: Jene weist es zurück, ein Plugin auszuführen, das nicht das geprüfte ist, und ihre Abhilfe ist, das Artefakt wiederherzustellen oder neu zu erfassen, während diese es zurückweist, ungefragt eine neue Identität zu übernehmen, und ihre Abhilfe ist, das Plugin in einem Upgrade zu nennen. Zwei Abhilfen, zwei Bedingungen.
Die neue Identität anzufordern ist das, was ein Pull bereits anbietet, und es gibt zwei Wege, sie anzufordern. Eine vollständige Aktualisierung löst alles neu auf, und ein gezieltes Upgrade löst die Plugins neu auf, die es nennt; beides wird so gelesen, dass die neue Identität angefordert wurde, und die Aufzeichnung wird auf den neuesten Stand gebracht. Jeder andere Pull hält an der erfassten Identität fest und bricht ab, was der Zweck ihrer Erfassung ist — eine Aufzeichnung, die übernähme, was auch immer als Nächstes aufgelöst wird, würde der Auflösung folgen, statt sie zu steuern. Ein erstes Auftreten ist keine Abweichung: Eine Identität, die die Aufzeichnung noch nicht enthält, wird einfach eingetragen.
Der Vergleich läuft auch bei einem Pull, der nur verifiziert, der weder die Aufzeichnung noch das Lockfile schreibt. Ein Verify-Lauf, der die Aufzeichnung überspränge, während er das Lockfile daneben prüft, würde eine Übereinstimmung melden, nach der er nie gesucht hat.
Ausgegebene Meldung, mit dem Plugin, beiden Identitäten und beiden Abhilfen:
plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports (Plugin: Die Aufzeichnung führt dafür eine Version mit einem Digest als vertrauenswürdig, aber diese Auflösung meldet eine andere Version mit einem anderen Digest; prüfen Sie, was sich geändert hat, und übernehmen Sie es mit dem gezielten Upgrade, oder stellen Sie die erfasste Identität wieder her: Die als vertrauenswürdig erfasste Plugin-Identität stimmt nicht mehr mit dem überein, was diese Auflösung meldet)
So beheben Sie es: Entscheiden Sie, welche der beiden Identitäten die gemeinte ist, denn nur Sie können das. Wenn die Verschiebung beabsichtigt ist — das Gate wurde neu veröffentlicht und Sie haben geprüft, was sich geändert hat —, übernehmen Sie sie mit dem gezielten Upgrade, das die Meldung ausschreibt; es löst dieses Plugin neu auf und schreibt seinen Eintrag neu. Wenn Sie sie nicht erwartet haben, ist die erfasste Identität diejenige, die geprüft wurde: Stellen Sie die Version oder das Artefakt wieder her, das die Aufzeichnung nennt, und untersuchen Sie, warum der Verweis jetzt anderswohin aufgelöst wird. Bearbeiten Sie die Aufzeichnung nicht, um dies zu beseitigen — sie ist eine committete Aussage darüber, was geprüft wurde, und ein gewöhnlicher Pull lässt sie absichtlich unverändert, weil das stillschweigende Übernehmen eines geänderten Gates genau das ist, was diese Zurückweisung verhindern soll.
A Plugin entity’s claims disagree with the plugin’s own self-report (Die Angaben einer Plugin-Entität widersprechen der eigenen Plugin-Selbstauskunft)
Eine Plugin-Entität gibt an, was das Plugin bietet, auf das sie verweist: welche Exporte es hat, worauf jeder davon wirkt und in welchem Geltungsbereich, und — bei einem Plugin, das einen Provider bedient — wie es sich beim Rendern verhält. Das Plugin meldet dieselben Dinge über sich selbst, wenn es geladen wird. Diese Bedingung meldet eine Abweichung zwischen beiden.
Der Vergleich erfolgt pro Export, nach Namen zugeordnet, und er läuft in eine Richtung: Alles, was die Entität angibt, muss übereinstimmen, und das Plugin darf mehr bieten. Eine Entität, die einen Teil der Plugin-Oberfläche beschreibt, muss den Rest nicht aufzählen, daher ist ein Export, den das Plugin deklariert und die Entität auslässt, keine Abweichung. Eine Abweichung ist dagegen ein angegebener Export, den das Plugin nicht deklariert, oder ein angegebener Export, dessen operates oder scope von dem abweicht, was das Plugin meldet. Der freie Selektor wird nicht verglichen.
Wenn die Entität zusätzlich einen Render-Verhaltensblock definiert, werden dessen Felder einzeln verglichen — die Eingabetypen, der Assemblierungsmodus, das Trennzeichenpaar der Artefakt-Templates, die Annotation für den Assemblierungsnamen, die Angabe zur wiederverwendbaren Instanz, die Angabe zur Boundary-übergreifenden Verknüpfung, die Angabe zu ausgelassenen Einträgen und das Verschachtelungsverzeichnis —, und das erste abweichende Feld wird genannt. Eine Entität, die keinen solchen Block definiert, überspringt diesen Vergleich vollständig.
Dieselbe Prüfung läuft bei der Veröffentlichung, sodass eine Abweichung normalerweise zutage tritt, bevor die Entität veröffentlicht wird, und nicht erst, wenn ein Build sie lädt.
Ausgegebene Meldungen. Ein angegebener Export, den das Plugin nicht hat:
entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (die Entität gibt einen Export an, den describe() im Plugin nicht deklariert: wasm: die Vertragsangabe der Entität stimmt nicht mit describe() im Plugin überein)
ein Feld eines angegebenen Exports:
entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (der Export der Entität deklariert für operates einen Wert, aber describe() im Plugin meldet einen anderen: wasm: die Vertragsangabe der Entität stimmt nicht mit describe() im Plugin überein)
und ein Feld des Render-Verhaltens, das in derselben Struktur gemeldet wird und das abweichende Feld nennt:
entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (die Entität deklariert für boundary_assembly einen Wert, aber describe() im Plugin meldet einen anderen: wasm: die Vertragsangabe der Entität stimmt nicht mit describe() im Plugin überein)
So beheben Sie es: Zu korrigieren ist die Angabe der Plugin-Entität, nicht Ihr Aggregate oder Ihr Release. Bringen Sie die Angabe in Einklang mit dem, was das Plugin meldet — die Meldung nennt beide Werte, sodass in der Meldung selbst sichtbar ist, in welche Richtung sich die Angabe bewegen muss. Wenn Sie die Entität selbst veröffentlichen, ist ihre Neugenerierung aus der Binärdatei der verlässliche Weg, beide in Übereinstimmung zu bringen; wenn Sie eine veröffentlichte Entität konsumieren, wählen Sie eine Version, deren Angabe zu der Binärdatei passt, auf die sie verweist, und melden Sie die Abweichung demjenigen, der sie veröffentlicht hat.
A Plugin entity’s recorded command set does not match the plugin (Die erfasste Befehlsmenge einer Plugin-Entität stimmt nicht mit dem Plugin überein)
Ein Plugin, das Terminalbefehle beisteuert, hat diese Befehle in seiner Plugin-Entität erfasst. Diese Aufzeichnung wird maschinell geschrieben und nicht von Hand verfasst: sie wird aus dem Plugin ausgelesen und niedergeschrieben, sodass sie die Binärdatei exakt widerspiegelt. Diese Bedingung meldet eine Aufzeichnung, die sie nicht mehr widerspiegelt — einen Unterschied im Namen eines Befehls, in seinem kurzen Hilfetext oder in der Reihenfolge, in der die Befehle deklariert sind.
Der Vergleich prüft auf vollständige Gleichheit, und das ist Absicht. Die Fähigkeits- und Exportangaben an anderer Stelle der Entität sind kuratiert: Ein Autor darf legitimerweise einen Teil der Oberfläche beschreiben und den Rest weglassen, daher werden sie als Teilmenge geprüft. Die Befehlsaufzeichnung ist nicht kuratiert, daher bedeutet alles unterhalb exakter Übereinstimmung, dass die Aufzeichnung von dem abgewichen ist, was das Plugin tatsächlich bietet, und eine Befehlsliste, die nah dran, aber nicht richtig ist, würde einen Aufruf fehlleiten.
Ein ohne Entität geladenes Plugin wird hier nicht geprüft. Die Aufzeichnung liegt an der Entität, daher tragen direkt geladene Bytes keine, und der Vergleich hat nichts, wogegen er laufen könnte.
Ausgegebene Meldung, die beide Mengen nennt und angibt, wie man sie neu erfasst:
wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (wasm: beim angegebenen Plugin stimmt der erfasste Befehlsspiegel nicht mit den describe()-Befehlen im Plugin überein; führen Sie die Plugin-Synchronisierung erneut aus und committen Sie das Ergebnis: wasm: der erfasste Befehlsspiegel stimmt nicht mit describe() im Plugin überein)
Derselbe Vergleich bei der Veröffentlichung meldet die Mengen ohne die Anweisung zum erneuten Erfassen:
plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe() (beim angegebenen Plugin stimmt der erfasste Befehlsspiegel nicht mit den describe()-Befehlen im Plugin überein: wasm: der erfasste Befehlsspiegel stimmt nicht mit describe() im Plugin überein)
So beheben Sie es: Erfassen Sie die Menge erneut aus der Binärdatei und committen Sie das Ergebnis — die Meldung nennt den Befehl, der das tut. Bearbeiten Sie die Aufzeichnung nicht von Hand, damit sie passt: sie wird maschinell verwaltet, und eine Handbearbeitung, die heute zufällig übereinstimmt, wird beim nächsten Erfassen neu abgeleitet und überschrieben. Wenn Sie eine veröffentlichte Entität konsumieren, statt sie zu veröffentlichen, wurde die Entität mit einer Aufzeichnung veröffentlicht, die ihre eigene Binärdatei nicht stützt, und das ist eine Frage an ihren Herausgeber.
A Plugin entity’s recorded version does not match the plugin (Die erfasste Version einer Plugin-Entität stimmt nicht mit dem Plugin überein)
Ein Plugin meldet die Version, die sein Build darin erfasst hat, und seine Plugin-Entität erfasst ebenfalls eine Version; beide müssen dieselbe Zeichenkette sein. Die Build-Rezepte, mit denen die Plugins von Aggrega gebaut werden, entnehmen diese Version dem Tag, mit dem das Plugin veröffentlicht wird — dem eigenen Tag des Compilers bei einem Plugin, das mit dem Compiler ausgeliefert wird, einem plugineigenen Tag bei einem, das außerhalb davon ausgeliefert wird —, sodass ein Build des Commits, den das Tag benennt, die veröffentlichte Version meldet und ein Build jedes anderen Commits eine Entwicklungsversion wie 1.0.0-3-g1a2b3c4. Diese Bedingung meldet ein Paar, das auseinandergeraten ist, und sie wird geprüft, bevor irgendwelche Bytes veröffentlicht werden, damit ein abweichendes Paar keinen Katalog erreicht.
Der Vergleich ist ein exakter Zeichenkettenvergleich. Ein Plugin, das ohne erfasste Build-Version gebaut wurde, meldet eine leere, und diesem leeren Wert muss die Version der Entität dann gleichen — die Prüfung behandelt „keine Version gemeldet“ nicht als „jede Version akzeptiert“, denn ihr Zweck ist, dass die Version einer veröffentlichten Entität immer angibt, was ihre Binärdatei tatsächlich meldet.
Ausgegebene Meldung:
plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (beim angegebenen Plugin stimmt die erfasste metadata.version nicht mit der describe()-Version im Plugin überein: wasm: die metadata.version der Entität stimmt nicht mit describe() im Plugin überein)
Bei der Veröffentlichung nennt die Zurückweisung zusätzlich die Entitätsdatei, die .wasm und die Abhilfe:
Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (beim angegebenen Plugin stimmt die metadata.version in der Entitätsdatei nicht mit der describe()-Version der .wasm am angegebenen Pfad überein — setzen Sie metadata.version auf die Version, die Sie veröffentlichen, und bauen Sie das Plugin aus einem sauberen Checkout des Commits, den das Tag dieser Version benennt, damit es diese Version selbst meldet; committen Sie bei einer neuen Version die Entität zusammen mit dem Quellcode, den sie veröffentlicht, und setzen Sie zuerst das Tag auf diesen Commit: beim angegebenen Plugin stimmt die erfasste metadata.version nicht mit der describe()-Version im Plugin überein: wasm: die metadata.version der Entität stimmt nicht mit describe() im Plugin überein)
So beheben Sie es: Setzen Sie die metadata.version der Entität auf die Version, die Sie veröffentlichen, und bauen Sie das Plugin aus einem sauberen Checkout des Commits, den das Tag dieser Version benennt, damit es diese Version selbst meldet. Committen Sie bei einer neuen Version die Entität zusammen mit dem Quellcode, den sie veröffentlicht, und setzen Sie zuerst das Tag auf diesen Commit — das Tag muss einen Commit benennen, der die Entität bereits enthält. Kopieren Sie nicht die vom Plugin gemeldete Version in die Entität: Ein Build jedes anderen Commits meldet eine Entwicklungsversion, und sie zu kopieren, würde diesen Build unter einer Version veröffentlichen, die kein Veröffentlichungs-Tag benennt. Wenn das Plugin überhaupt keine Version meldet, wurde es ohne erfasste Version gebaut; bauen Sie es mit erfasster Version.
A plugin was built from a working tree with uncommitted changes (Ein Plugin wurde aus einem Arbeitsverzeichnis mit nicht committeten Änderungen gebaut)
Ein Plugin-Build erfasst seine Version aus dem Commit, aus dem er gebaut wurde, und ein Build aus einem Arbeitsverzeichnis mit nicht committeten Änderungen trägt die Markierung -dirty am Ende dieser Version — 1.0.0-dirty an einem Tag, 1.0.0-3-g1a2b3c4-dirty nach einem. Eine solche Version ist eine gültige semantische Version, aber sie benennt einen Commit, der die gebauten Bytes nicht enthält, sodass niemand das, was veröffentlicht würde, aus der Version neu bauen kann, unter der es veröffentlicht würde. Die Plugin-Veröffentlichung weist ein Plugin zurück, dessen eigene Version die Markierung trägt, bevor irgendwelche Bytes veröffentlicht werden und bevor die Registry kontaktiert wird; auch ein Probelauf weist es zurück.
Zurückgewiesen wird nur die Markierung. Eine aus einem Commit gebaute Entwicklungsversion wie 1.0.0-3-g1a2b3c4 benennt einen Commit, der das Gebaute tatsächlich enthält, und wird veröffentlicht; ebenso eine Vorabversion wie 1.0.0-rc.1. Ein Plugin außerhalb einer Veröffentlichung gegen seine Entität zu validieren, löst diese Bedingung nicht aus, da ein Build in Entwicklung routinemäßig aus einem bearbeiteten Arbeitsverzeichnis gemacht wird.
Die Prüfung liest die Version, die das Plugin über seinen eigenen Build meldet, und sie läuft vor dem Vergleich mit der metadata.version der Entität — daher wird ein Plugin, das mit nicht committeten Änderungen unter einer Entität gebaut wurde, die die saubere Version erfasst, hier gemeldet und nicht als eine erfasste Version, die nicht mit dem Plugin übereinstimmt.
Ausgegebene Meldung, die das Plugin, die gemeldete Version und die Abhilfe nennt:
Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty") (beim angegebenen Plugin wurde die .wasm am angegebenen Pfad aus einem Arbeitsverzeichnis mit nicht committeten Änderungen gebaut — setzen Sie metadata.version in der Entitätsdatei auf die Version, die Sie veröffentlichen, und bauen Sie das Plugin aus einem sauberen Checkout des Commits, den das Tag dieser Version benennt, damit es diese Version selbst meldet; committen Sie bei einer neuen Version die Entität zusammen mit dem Quellcode, den sie veröffentlicht, und setzen Sie zuerst das Tag auf diesen Commit: das Plugin wurde aus einem Arbeitsverzeichnis mit nicht committeten Änderungen gebaut, daher reproduziert kein Commit die Version, die es meldet (mit dem Plugin und seiner describe()-Version, die auf die Markierung dirty endet))
So beheben Sie es: Bauen Sie das Plugin aus einem sauberen Checkout des Commits, den das Tag der Version benennt, damit es die veröffentlichte Version meldet, die die Entität erfasst. Um die Änderung selbst zu veröffentlichen, setzen Sie die metadata.version der Entität auf die neue Version, committen Sie die Entität zusammen mit der Änderung, setzen Sie das Tag auf diesen Commit und bauen Sie dort. Die Änderung zu committen und neu zu bauen, macht allein den Weg zu einer Veröffentlichung nicht frei: Das neu gebaute Plugin meldet eine Entwicklungsversion, und sie in die Entität zu kopieren, würde den Build unter einer Version veröffentlichen, die kein Veröffentlichungs-Tag benennt.
A Plugin entity’s recorded host functions do not match the binary (Die erfassten Host-Funktionen einer Plugin-Entität stimmen nicht mit der Binärdatei überein)
Ein Plugin deklariert, welche der eigenen Aufrufe des Hosts es verwendet, und diese Menge wird in seiner Plugin-Entität erfasst, wenn das Plugin veröffentlicht wird — aus der Binärdatei selbst ausgelesen und nicht von Hand verfasst. Wenn das Plugin abgerufen wird, wird die Menge erneut aus den Bytes abgeleitet, deren Inhalt gerade verifiziert wurde, und mit der Aufzeichnung verglichen. Ein Unterschied in einer der beiden Richtungen bricht den Abruf ab.
Dies setzt auf den Inhalts-Pin auf, statt ihn zu wiederholen, und es erkennt zwei Dinge, die der Pin allein nicht erkennt: eine Binärdatei, die auf einem anderen als dem gewöhnlichen Veröffentlichungsweg veröffentlicht wurde und keine Aufzeichnung trägt oder eine, die ihre eigenen Bytes nicht beschreibt; und einen Fehler im Erfassungsschritt selbst. Der Pin stellt fest, dass die Bytes die gepinnten Bytes sind; dies stellt fest, dass das, was über sie niedergeschrieben wurde, auf sie zutrifft.
Eine Entität ohne Aufzeichnung wird mit einer leeren Menge verglichen, die zu einem Plugin passt, das keinen der Aufrufe des Hosts verwendet — dieselbe harmlose Übereinstimmung in beide Richtungen, daher wird eine Entität ohne Aufzeichnung nicht zurückgewiesen, weil ihr eine fehlt.
Ausgegebene Meldung, die das Plugin, beide Mengen und das Artefakt nennt, aus dem die Bytes stammen:
plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports (beim angegebenen Plugin stimmt die gestempelte spec.runtime.hostFunctions nicht mit der Menge überein, die aus der verifizierten .wasm abgeleitet wurde: wasm: die gestempelte Host-Funktions-Aufzeichnung stimmt nicht mit den Importen der .wasm überein)
Derselbe Vergleich, ausgeführt während ein Plugin validiert wird, meldet die beiden Mengen ohne das Artefakt:
plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports (beim angegebenen Plugin stimmt die erfasste Host-Funktions-Aufzeichnung nicht mit den Importen der .wasm überein: wasm: die gestempelte Host-Funktions-Aufzeichnung stimmt nicht mit den Importen der .wasm überein)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und keine Änderung an dem, was Sie verfassen, behebt es. Veröffentlichen Sie das Plugin erneut über den gewöhnlichen Veröffentlichungsweg, der die Aufzeichnung aus der Binärdatei ableitet und beides zusammen schreibt. Wenn Sie ein veröffentlichtes Plugin konsumieren, wurden die Entität und die Binärdatei, auf die sie verweist, nicht im Gleichschritt veröffentlicht; melden Sie die Abweichung daher dem Herausgeber und zitieren Sie dabei beide Mengen aus der Meldung — und bearbeiten Sie die Aufzeichnung nicht von Hand, damit sie übereinstimmt, da sie abgeleitet und nicht verfasst ist und die nächste Ableitung die Bearbeitung verwirft.
The lockfile no longer matches what the release resolves to (Das Lockfile stimmt nicht mehr mit dem überein, worauf das Release aufgelöst wird)
Das Lockfile eines Release pinnt jede Entität, jede Bibliothek und jedes Plugin, die das Release erreicht, jeweils mit der ausgewählten Version und einem Digest, und es erfasst die Release-Dateien selbst — das Release und jedes Release, das es erweitert — über den Digest ihres Inhalts. Der Digest einer Entität deckt ab, was eine Veröffentlichung von ihr enthält: ihr Dokument und jede Datei, die sie neben sich nennt, jeweils über ihren Pfad und ihre Bytes. Bei einer Bibliothek und einem Plugin deckt der Digest deren Bytes ab. Ein erneutes Auflösen des Release erzeugt dieselbe Menge, und die beiden werden verglichen. Eine Abweichung wird über diese Bedingung gemeldet.
Jede Abweichung wird gesammelt, bevor eine davon gemeldet wird, über alles hinweg, was das Lockfile pinnt, sodass Ihnen ein einziger Lauf das ganze Bild zeigt statt jeweils nur einen Eintrag.
Diese Strukturen von Abweichungen werden gemeldet, und es lohnt sich, sie auseinanderzuhalten, weil sich die Abhilfen unterscheiden:
Ein Verweis, den das Lockfile nicht pinnt. Das Release erreicht jetzt etwas, für das das Lockfile keinen Eintrag hat — eine Abhängigkeit, die seit dem Pull hinzugekommen ist, der es geschrieben hat. Der Eintrag nennt die Stelle, an der das Release danach verlangt, sodass ein Recipe oder FeatureRecipe, das das Manifest bindet, mit dem Mapping-Eintrag gemeldet wird, der es bindet, und eines, das die Ebene name bindet, die Instanz oder Anbindung nennt, für die es ausgewählt wurde.
Ein gepinnter Verweis, den das Release nicht mehr erreicht. Das Lockfile pinnt noch etwas, von dem nichts im Release mehr abhängt.
Eine seit dem Pull bearbeitete Release-Datei. Das Release oder ein Release, das es erweitert, enthält nicht mehr die Bytes, die das Lockfile dafür erfasst hat. Alles, wonach das Release verlangt — welche Quellversion abzurufen ist, welche Komponenten wo zu platzieren sind —, wird aus dem aufgelöst, was die Datei enthält, sodass die erfassten Pins möglicherweise nicht mehr beschreiben, wonach es jetzt verlangt. Dies wird hier gemeldet, bevor irgendetwas gerendert wird, statt als das, woran das Rendern gescheitert wäre: Eine bearbeitete Quellversion würde sonst später als ein Abruf zutage treten, der keinen Pin findet. Ein Lockfile, das überhaupt keine Release-Datei erfasst, meldet das Release als nicht erfasst, und eine Release-Datei, die das Release nicht mehr erweitert, wird als nicht mehr gelesen gemeldet.
Ein Quellverweis, der sich an seinem Remote verschoben hat. Eine Quelle, die mit einem Git-Verweis ref: geschrieben ist, wird mit dem Commit erfasst, zu dem der Ref aufgelöst wurde. Jeder Pull, der kein Upgrade ist, fragt das Remote, wohin der Ref jetzt zeigt, und ebenso aggrega pull --verify, wo das Netzwerk erreichbar ist; ein Ref, der zu einem anderen Commit aufgelöst wird, wird hier gemeldet statt übernommen. Nur diese beiden melden es: Ein Build liest den erfassten Commit und fragt nicht nach.
Der Vergleich erfolgt über den Inhalt, sodass identischer Inhalt, der auf einem anderen Weg erreicht wird, nicht als Drift gilt: Was sich unterscheiden muss, damit dies ausgelöst wird, sind die Bytes. Bei einer Release-Datei gehört dazu ein Kommentar oder eine Änderung an Leerzeichen, genau wie beim Aggregate und beim Manifest, die das Release nennt. Bei einer Entität ist es der Inhalt dessen, was sie enthält, sodass dieselbe Entität, aus einem Katalogverzeichnis gelesen und aus einer Registry abgerufen, nicht als Drift gilt, ebenso wenig ein Checkout, dessen Dateien sich nur in den Berechtigungsbits unterscheiden, das Ausführungsbit eingeschlossen, noch eine Veröffentlichung, deren Archiv anders komprimiert wurde.
Ausgegebene Meldung. Sie beginnt mit dem eigenen Satz der Bedingung, und jede gesammelte Abweichung folgt, jeweils mit ihrer Achse — und bei einer Entität mit ihrer Art, denn eine Entität wird durch ihre Art und ihre URI gemeinsam identifiziert, sodass ein Release, dessen Aggregate und Manifest einen Namen teilen, zwei Einträge hat und eine Bearbeitung an einem der beiden für das bearbeitete gemeldet wird:
lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (lockfile: veraltet; es stimmt nicht mehr mit dem überein, worauf sein Release aufgelöst wird: Entität mit ihrer Art nicht im Lockfile, mit der Stelle, von der aus auf sie verwiesen wird) <axis>"<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (der angegebene Verweis auf der angegebenen Achse hat sich geändert: Version und Digest im Lockfile weichen von den aktuellen ab) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (die angegebene Entität der angegebenen Art hat sich geändert: Version und Digest im Lockfile weichen von den aktuellen ab) <axis>"<uri>" no longer used by the release (der angegebene Verweis auf der angegebenen Achse wird vom Release nicht mehr verwendet) release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand (das angegebene Release-Dokument wurde bearbeitet, nachdem das Lockfile geschrieben wurde: Sein Inhalt stimmt nicht mehr mit dem erfassten Digest überein, sodass die Pins möglicherweise nicht mehr beschreiben, wonach es verlangt; ein erneutes Auflösen des Release erfasst die Dateien, die es liest, so, wie sie jetzt sind)
<site> ist die Stelle, an der das Release nach dem Verweis verlangt, geschrieben als Pfad zu dem Eintrag, der ihn nennt — etwa manifest.spec.mappings.components.name.db-primary —, wobei bis zu drei solcher Stellen in sortierter Reihenfolge aufgeführt werden und ... dahinter steht, wenn es mehr gibt. Ein Verweis, dessen Auflösung keine solche Stelle erfasst, wird ohne die Klammer gemeldet.
Ein Pull, der einen verschobenen Quellverweis meldet, nennt das Artefakt so, wie sein Autor es geschrieben hat, mit chart= und module_subdir=, wo die Quelle sie nennt:
source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release> (source-artifact: der angegebene Verweis hat sich verschoben — das Lockfile pinnt einen Commit, und er wird jetzt zu einem anderen aufgelöst; übernehmen Sie das neue Ziel mit einem Upgrade-Pull)
Ein Build gibt die Abhilfe nach den Einträgen aus:
run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile (führen Sie den Pull aus, um das Release erneut aufzulösen und sein Lockfile neu zu schreiben)
Welche Befehle ein Release an sein Lockfile binden.aggrega build vergleicht vor dem Rendern und bricht ab. aggrega validate --release und jede Auswahl von aggrega inspect, die ein Release auflöst — die Standardansicht, --resolved, --ir-graph und --closure —, führen denselben Vergleich durch, sobald die Abhängigkeiten des Release aufgelöst sind, und brechen mit derselben Meldung und derselben Abhilfe ab, ohne etwas auf die Standardausgabe zu schreiben; daher lässt keiner von beiden ein Lockfile passieren, das ein Build als abgewichen zurückweist. Die Assistenten-Tools build, validate mit release und describe mit release lehnen unter denselben Bedingungen ab. aggrega pull führt ihn gegen das Lockfile aus, das es gleich schreiben wird, und aggrega pull --verify gegen das auf der Festplatte. Ein Befehl, der kein Release auflöst — aggrega validate ohne Argument, wobei es Lockfile-Pins nur liest, um ein übergeordnetes Element aus extends zu finden, oder mit einem Entitätspfad sowie aggrega inspect --raw oder --output yaml ohne --ir-graph —, ist an kein Lockfile gebunden, und ebenso wenig ein Release ohne Lockfile daneben. Der Language Server des Editors bricht seine Builds daran ab und meldet ihn bei einer Graph-Anfrage als Warnung auf dem Lockfile, während er den Graphen dennoch zeichnet.
So beheben Sie es: Lösen Sie das Release erneut auf und committen Sie das neu geschriebene Lockfile. Für alles, was ein Build meldet, ist ein einfaches aggrega pull --release <release> — der Befehl, den der Build ausgibt — die ganze Behebung: Es löst das Release so auf, wie es jetzt ist, schreibt die Pins neu, die sich verschoben haben, und hält jeden anderen fest, sodass sich nichts verschiebt, was Sie nicht angefasst haben. Wo das, was sich verschoben hat, eine Datei unter der lokalen Quelle eines Recipe oder FeatureRecipe ist, bricht dieser Pull zunächst ab und nennt aggrega pin für die Entität, weil das Erfassen des neuen Pins daneben der Schritt des Autors ist; führen Sie es aus oder übergeben Sie dem Pull --pin-sources, und der Pull beseitigt den Drift. Der eine Eintrag, den ein einfacher Pull nicht beseitigt, ist ein Quellverweis, der sich an seinem Remote verschoben hat, denn ihn zu beseitigen bedeutet, den Commit zu übernehmen, den der Verweis jetzt nennt: aggrega pull --upgrade --release <release> tut das, und der Eintrag sagt es — wo die entity.lock des Recipe diese Quelle erfasst, bricht das Upgrade auf dieselbe Weise ab, bis der neue Commit daneben gepinnt ist. Lesen Sie die Einträge, bevor Sie das tun, denn die dritte Struktur ist diejenige, bei der es sich innezuhalten lohnt: Ein Verweis, den das Release nicht mehr erreicht, ist meist eine Abhängigkeit, die Sie absichtlich entfernt haben, aber wo Sie sie nicht entfernt haben, hat sich etwas anderes geändert, das sie unerreichbar gemacht hat. Ein Paar, das sich bei einem Verweis verschoben hat, den Sie nicht angefasst haben, bedeutet, dass der Inhalt unter dieser Version nicht der Inhalt ist, der geprüft wurde — eine Frage an denjenigen, der ihn liefert, statt etwas, das man ungeprüft übernimmt.
Ein Pull führt genau diesen Vergleich mit dem Lockfile durch, das er gleich schreiben wird, und schreibt keines, das der Vergleich zurückweist, sodass ein Lockfile, das ein Pull gerade geschrieben hat, ihn bei einem Build mit denselben Eingaben besteht. Wo diese Bedingung direkt nach einem abgeschlossenen Pull wieder auftritt, haben die beiden Läufe unterschiedliche Eingaben erhalten: ein Katalogverzeichnis, das dem einen übergeben wurde und dem anderen nicht, oder eine zwischen ihnen bearbeitete Workspace-Konfiguration. Führen Sie Pull und Build über dieselben Eingaben aus.
An artifact is not at the source the build was told to find it (Ein Artefakt befindet sich nicht an der Quelle, an der der Build es finden sollte)
Ein Katalogverweis nennt ein Artefakt und eine Version. Diese Bedingung meldet, dass nichts diesem Paar entspricht — weder in der Registry, zu der der Verweis aufgelöst wird, noch im lokalen Artefakt-Cache, aus dem der Build liest.
Ein Build liest den Cache; er greift nicht von sich aus nach außen. Die Beschaffung ist ein eigener Schritt: Der Pull, der ein Release auflöst, ruft ab, was das Release benötigt, und schreibt es in den Cache, und der Build liest dann, was dort liegt. Daher erreicht diese Bedingung einen Build als Cache-Fehltreffer und einen Pull als Registry, die kein solches Artefakt hat. Wo ein Build so konfiguriert ist, dass er beim Start sein Lockfile füllt, ist die Beschaffung, die er ausführt, genau dieser Pull.
Ausgegebene Meldungen. Eine Registry ohne ein solches Tag und ein Abruf, der ein Manifest aufgelöst hat, dessen Content-Blob fehlt:
oci: "<reference>:<version>": oci: artifact not found at remote source (oci: für den angegebenen Verweis und die angegebene Version: oci: Artefakt an der entfernten Quelle nicht gefunden)
oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: Inhalt für den angegebenen Verweis und die angegebene Version: oci: Artefakt an der entfernten Quelle nicht gefunden)
ein Cache-Lesevorgang, der keinen Eintrag gefunden hat — die Struktur, auf die ein Build trifft:
oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: Cache-Fehltreffer für den angegebenen Verweis und die angegebene Version: oci: Artefakt an der entfernten Quelle nicht gefunden)
und dasselbe für ein zwischengespeichertes Artefakt, dessen Manifest daneben fehlt:
oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: Manifest-Cache-Fehltreffer für den angegebenen Verweis und die angegebene Version: oci: Artefakt an der entfernten Quelle nicht gefunden)
So beheben Sie es: Prüfen Sie zuerst den Verweis und die Version — eine Version, die nicht mehr existiert, und ein Name mit einem Tippfehler ergeben dieselbe Antwort, und die Meldung zitiert beide, damit sie mit dem Katalog verglichen werden können. Wo der Verweis stimmt, wurde das Artefakt nicht beschafft: Führen Sie den Pull für das Release aus, der abruft, was das Release erreicht, und den Cache befüllt. Wo der Workspace offline ist, muss dieser Pull von einem Ort mit Netzwerkzugang ausgeführt werden; ein Offline-Build liest nur, was bereits im Cache liegt, und dies ist das, was er sagt, wenn der Cache es nicht enthält.
The registry will not serve an artifact without credentials it accepts (Die Registry liefert ein Artefakt nicht ohne Anmeldedaten aus, die sie akzeptiert)
Die Registry hat geantwortet und abgelehnt: Entweder wurden keine Anmeldedaten vorgelegt, oder die vorgelegten wurden nicht akzeptiert. Dies unterscheidet sich von einer Registry, die überhaupt nicht erreicht werden konnte — hier fand das Gespräch statt, und die Antwort war Nein.
Vier Zeitpunkte melden sie, alle während Artefakte beschafft oder veröffentlicht werden: das Auflösen eines Verweises, das Pullen seines Inhalts, das Auflisten der Versionen, die ein Repository enthält, und das Prüfen von Anmeldedaten in dem Moment, in dem sie gespeichert werden.
Ausgegebene Meldungen, jeweils mit dem, was angefragt wurde, und mit dem zitierten Wortlaut der Registry:
oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: Auflösen des angegebenen Verweises, mit der Antwort der Registry: oci: Authentifizierung erforderlich oder fehlgeschlagen)
das Auflisten der Versionen eines Repositorys, das stattdessen den Status nennt:
oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: tags/list für das angegebene Repository, mit dem Statuscode: oci: Authentifizierung erforderlich oder fehlgeschlagen)
und das Prüfen von Anmeldedaten beim Speichern:
oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: Prüfen der Anmeldedaten für den angegebenen Host, mit der Antwort der Registry: oci: Authentifizierung erforderlich oder fehlgeschlagen)
Wo der Fehler von einem Schritt gemeldet wird, der eine Abhilfe liefert, endet die Zeile mit dem Login, der für den abgeleiteten Host auszuführen ist:
remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (Abhilfe: Führen Sie aggrega login, oder docker login, für den angegebenen Host aus, bevor Sie aggrega pull —release für das angegebene Release erneut ausführen)
und, wo ein Import einen der Core-Importer des Compilers abgerufen hat, mit demselben Login, bevor der Import erneut ausgeführt wird:
remediation: aggrega login <host> (or docker login <host>) before re-running the import (Abhilfe: aggrega login (oder docker login) vor dem erneuten Ausführen des Imports)
Ein klassisches Helm-Chart-Repository oder Chart-Archiv, ein Compose-Fragment und ein Git-Repository, die über http oder https abgerufen werden, melden diese Bedingung ebenfalls, wenn der Server die Anfrage als nicht autorisiert ablehnt, und ihre Abhilfe nennt den hinzuzufügenden netrc-Eintrag statt einer Anmeldung, da diese Abrufe ihre Anmeldedaten aus dieser Datei lesen:
remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (Abhilfe: Fügen Sie der netrc-Datei einen Eintrag für den Host hinzu (mit machine, login und password) und führen Sie den Befehl dann erneut aus)
So beheben Sie es: Dies ist Sache des Betreibers statt des Entitätsautors — nichts in einem Aggregate, einer Component oder einem Recipe verursacht es. Der offizielle Hub, hub.aggrega.ai, stellt das, was er veröffentlicht, allen bereit, sodass das Lesen von ihm keine Anmeldedaten erfordert, das Veröffentlichen dort hingegen schon; eine andere Registry kann auch für das Lesen Anmeldedaten verlangen. Melden Sie sich bei dem Host an, den die Meldung nennt — oder fügen Sie bei einer über http oder https abgerufenen Quelle den netrc-Eintrag hinzu, den die Abhilfe nennt —, und führen Sie die Beschaffung erneut aus. Wo Sie bereits angemeldet sind, sind die Anmeldedaten im Speicher keine, die dieser Host für dieses Repository akzeptiert: Melden Sie sich erneut an, um sie zu aktualisieren, und prüfen Sie, ob das Konto Lesezugriff auf das Repository hat, zu dem der Verweis aufgelöst wird, denn ein privates Repository antwortet genau so einem Konto, das es nicht sehen kann. Wo der Verweis zu einem Host aufgelöst wird, den Sie nicht erwartet haben, zeigt der Registry-Alias oder die Standard-Registry in .aggrega-config.yaml woandershin.
The netrc file cannot be read (Die netrc-Datei kann nicht gelesen werden)
Ein klassisches Helm-Chart-Repository oder Chart-Archiv, ein Compose-Fragment und ein über http oder https abgerufenes Git-Repository beziehen ihre Anmeldedaten aus der netrc-Datei, die gelesen wird, wenn eine solche Quelle abgerufen wird — durch einen Pull, einen Pin-Lauf oder einen Build, der sein Lockfile füllt. Welche Datei gelesen wird und welcher Eintrag eine Anfrage beantwortet, ist unter Authentifizierung beschrieben. Diese Bedingung meldet eine netrc-Datei, die existiert und nicht verwendet werden konnte: Sie konnte nicht gelesen werden — sie ist etwa ein Verzeichnis, oder Sie haben keine Berechtigung, sie zu lesen —, oder sie folgt nicht dem netrc-Format. Das Format wird streng gelesen, weil ein an der falschen Stelle gelesenes Wort jedes folgende Wort verschiebt: Ein falsch geschriebenes Schlüsselwort würde sonst das Passwort danach zum nächsten Schlüsselwort machen, und die Anfrage würde ohne Anmeldedaten oder mit den falschen hinausgehen, während die Datei in Ordnung aussah.
Eine Datei, die nicht existiert, fällt nicht unter diese Bedingung: Sie enthält keine Anmeldedaten, und eine Anfrage, die welche benötigt, wird durch die Zurückweisung des Servers beantwortet. Auch eine Datei, die andere Benutzer des Rechners lesen können, fällt nicht darunter: Unter Linux und macOS erzeugt sie eine Warnung, die die Datei nennt, und wird trotzdem gelesen.
Die Meldung nennt die Datei und bei einem Formatfehler die Zeile, und sie sagt allein in Begriffen des Formats, was falsch ist — nie ein Wort, das die Datei enthält, da ein falsch platziertes Wort ein Passwort sein kann. Die Diagnose trägt keine Kategorie: Die netrc-Datei ist Ihre eigene Anmeldedatendatei und kein Dokument, das der Build liest.
Ausgegebene Meldung bei einem Formatfehler, der einer der folgenden ist: ein Wort an einer Stelle, an der ein Schlüsselwort erwartet wird, ein Schlüsselwort, auf das sein Wert nicht folgt, ein login, password oder account vor jedem Eintrag machine oder default, und ein Wort in Anführungszeichen, das auf der Zeile, auf der es beginnt, nicht geschlossen wird:
the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (die netrc-Datei konnte nicht gelesen werden: In der angegebenen Datei und Zeile steht ein Wort, wo ein Schlüsselwort erwartet wird (machine, default, login, password, account oder macdef). Korrigieren Sie die Datei, oder setzen Sie NETRC auf den Pfad einer anderen netrc-Datei, die stattdessen gelesen werden soll)
und bei einer Datei, die nicht gelesen werden konnte, mit Angabe des Grundes:
the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (die netrc-Datei konnte nicht gelesen werden: die angegebene Datei, mit dem Grund, warum sie nicht gelesen werden konnte. Korrigieren Sie die Datei, oder setzen Sie NETRC auf den Pfad einer anderen netrc-Datei, die stattdessen gelesen werden soll)
So beheben Sie es: Öffnen Sie die Datei, die die Meldung nennt. Bei einem Formatfehler gehen Sie zu der Zeile, die sie nennt: Jeder Eintrag ist machine <host> — oder default —, gefolgt von login <user> und password <secret>, und ein falsch geschriebenes oder ohne seinen Wert gelassenes Schlüsselwort ist die übliche Ursache. Bei einer Datei, die nicht gelesen werden konnte, machen Sie sie zu einer Datei, die Sie lesen können und die nur Sie lesen können (chmod 600). Wo die Datei nicht die ist, die gelesen werden sollte, setzen Sie NETRC auf den Pfad der gemeinten Datei.
The registry could not be reached (Die Registry ist nicht erreichbar)
Die Kommunikation mit der Registry hat nie stattgefunden: Die Namensauflösung, die Verbindung oder der sichere Handshake ist fehlgeschlagen. Es ist das Gegenstück zu einer Registry, die geantwortet und abgelehnt hat — hier wurde in keiner Richtung etwas festgestellt, daher ist der Zustand des Artefakts auf der Gegenseite unbekannt, statt als fehlend bekannt zu sein.
Es ist außerdem das, was ein Transportfehler ohne spezifischere Ursache meldet, während die Quelle eines Recipe beschafft wird; auf diesem Pfad ist es daher die allgemeine Antwort „die Gegenseite war nicht erreichbar“ und keine Aussage darüber, welche Ebene fehlgeschlagen ist.
Ausgegebene Meldung, die die beschaffte Quelle nennt und den zugrunde liegenden Transportfehler zitiert, mit der Abhilfe, die die Bedingung mitführt:
sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported (sourceresolver: mit dem angegebenen Typ, der angegebenen URL und Version: oci: Netzwerk nicht erreichbar (Ursache: der Transportfehler); Abhilfe: Prüfen Sie die Netzwerkverbindung zum angegebenen Host; Unternehmensproxys benötigen in der Regel ein exportiertes HTTPS_PROXY)
So beheben Sie es: Die Behebung ist Sache des Operators und liegt außerhalb Ihres Katalogs. Prüfen Sie, ob der Host in der Meldung von dort aus erreichbar ist, wo der Befehl ausgeführt wird. Wo die Umgebung das Netzwerk über einen Proxy erreicht, muss der Proxy in die Umgebung exportiert werden, wie die Abhilfe angibt — ein Proxy, der nur für einen Browser oder einen Paketmanager konfiguriert ist, wird nicht übernommen. Wo der Host manuell erreichbar ist, von hier aus aber nicht, liegt der Unterschied meist in Anmeldedaten an einem Proxy oder in einem Abfangzertifikat, das der Handshake nicht akzeptiert hat. Sobald die Artefakte im Cache liegen, lesen spätere Builds den Cache und benötigen das Netzwerk überhaupt nicht.
A server did not answer in time (Ein Server hat nicht rechtzeitig geantwortet)
Eine Anfrage wartete auf den Server, an den sie gerichtet war — eine Registry oder einen anderen Server, den ein Befehl erreicht, etwa das Transparenzprotokoll, in dem eine Signatur verzeichnet wird —, und wurde zurückgezogen. Eine Anfrage wartet höchstens 30 Sekunden darauf, dass der Server seine Antwort beginnt, sobald die Anfrage vollständig gesendet wurde, und höchstens 30 Sekunden auf den nächsten Teil einer bereits eintreffenden Antwort; wird eine der beiden Grenzen überschritten, wird sie unter dieser Bedingung abgewiesen, wobei der Server und die Wartezeit genannt werden. Dies erzeugt ein Server, der eine Verbindung annimmt und nie antwortet, und ebenso eine Adresse, die nie eine annimmt, statt eines Befehls, der endlos wartet. Ein Durchlauf durch die gesamte Repository-Liste einer Registry wartet stattdessen auf jeder Seite so lange, wie der Durchlauf laufen darf, und wird durch eine eigene Bedingung begrenzt, E0377.
Begrenzt ist nur das Warten. Ein Download oder Upload, der in Bewegung bleibt, dauert so lange, wie er dauert, weil die Wartezeit nur gemessen wird, solange nichts eintrifft. Ein Helm-Chart, das der source: einer Recipe über HTTPS abruft, unterliegt nur der Wartezeit bis zum Beginn seiner Antwort, und dieser Ablauf wird mit den eigenen Worten der Netzwerkbibliothek gemeldet statt unter dieser Bedingung. Eine Anfrage, die ein Befehl ohnehin erneut stellt, wenn sie in eine Zeitüberschreitung läuft — ein Lesevorgang während aggrega registry update, ein Schreibvorgang während einer Veröffentlichung —, wird zuerst erneut gestellt, sodass die Abweisung das ist, was nach ihrem letzten Versuch bleibt.
Ausgegebene Meldung für eine Versionsauflistung, auf die die Registry nicht geantwortet hat:
aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: Versionen für plugin/cli/mo auflisten: oci: Tags auflisten: Get: 127.0.0.1:18471 hat nicht innerhalb von 30s geantwortet: egress: der Server hat nicht rechtzeitig geantwortet)
und für eine Antwort, die mittendrin abbrach:
<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (hat aufgehört zu antworten: 30s lang ist nichts mehr von seiner Antwort eingetroffen: egress: der Server hat nicht rechtzeitig geantwortet)
So beheben Sie es: Die Behebung ist Sache des Operators und liegt außerhalb Ihres Katalogs. Prüfen Sie, ob der Server, den die Meldung nennt, läuft und von dort erreichbar ist, wo der Befehl ausgeführt wird; eine Registry unter Last oder in Wartung antwortet später wieder, und der Befehl kann einfach erneut ausgeführt werden. Wenn die Umgebung das Netzwerk über einen Proxy erreicht, prüfen Sie, ob der Proxy die Anfrage weiterleitet, statt sie festzuhalten. Die Wartezeit ist fest; es gibt keine Einstellung, die sie verlängert.
A registry’s repository listing did not end in time (Die Repository-Liste einer Registry endete nicht rechtzeitig)
Ein Durchlauf durch die gesamte Repository-Liste einer Registry lief fünf Minuten, ohne das Ende der Liste zu erreichen, und wurde abgebrochen. Zwei Befehle durchlaufen die Liste: aggrega plugin add, nur wenn kein Plugin genau den übergebenen Namen trägt und der Befehl nach einem sucht, dessen Name ihn enthält, und aggrega registry update, das die Repositories einer Registry auflistet, bevor es jedes einzelne liest. Eine Liste, die ohne Ende neue Repositories nennt, und eine, die eine Registry zu langsam ausliefert, um fertig zu werden, enden beide hier, statt den Befehl aufzuhalten; der Durchlauf liefert überhaupt keine Repositories, sodass aus einer abgeschnittenen Liste nichts ausgewählt und nichts indiziert wird. Die Meldung gibt an, wie viele Repositories die Liste bis zum Abbruch genannt hatte.
Ausgegebene Meldung für das Hinzufügen eines Plugins, dessen Suchanfrage Teil eines Namens ist:
aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: kein cli-Plugin heißt „mo“, und die Suche in jedem Repository nach einem Namen, der ihn enthält, wurde nicht abgeschlossen; nennen Sie das Plugin genau, etwa aggrega plugin add cli gefolgt vom Namen: der Durchlauf wurde nach 5m0s abgebrochen, bevor die Liste endete (bisher genannte Repositories: 146): registry: die Repository-Liste endete nicht rechtzeitig)
So beheben Sie es: Nennen Sie bei aggrega plugin add das Plugin genau — aggrega plugin add cli moo statt aggrega plugin add cli mo —, wodurch das Plugin mit einer einzigen Anfrage unter diesem Namen nachgeschlagen und die Liste nie durchlaufen wird. Bei aggrega registry update ist die Liste der Registry die Ursache: Klären Sie mit dem Betreiber der Registry, dass ihre Liste endet, und führen Sie die Aktualisierung erneut aus, sobald sie es tut. Die Grenze von fünf Minuten ist fest; es gibt keine Einstellung, die sie verlängert.
A registry kept asking to slow down (Eine Registry bat wiederholt um Verlangsamung)
Eine Registry, die zu stark ausgelastet ist, antwortet mit 429 Too Many Requests oder mit 503 Service Unavailable und einem Retry-After-Header, der angibt, wie lange zu warten ist. Jede Anfrage, die ein Befehl an eine Registry stellt, wartet so lange, wie die Registry verlangt — zehn Sekunden, wo sie es nicht angibt —, und wird erneut gestellt; jede Anfrage an diese Registry wartet mit, und es werden ihr weniger Anfragen gleichzeitig gesendet, bis sie wieder antwortet. Eine Registry, die fünf Minuten lang nichts anderes als „langsamer“ antwortet, wird unter dieser Bedingung abgewiesen, wobei die Registry, ihre letzte Antwort und die Dauer, während der sie nichts anderes geantwortet hatte, genannt werden, und ebenso eine Anfrage, deren eigenes Zeitlimit während des Wartens abläuft. aggrega registry update meldet diese Registry dann als nicht indiziert, und sie behält den Index, den sie vor dem Lauf hatte.
Ausgegebene Meldung, für eine Registry, die fünf Minuten lang um Verlangsamung gebeten hat:
<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (bat wiederholt um Verlangsamung: Ihre letzte Antwort war 429 Too Many Requests, und sie hatte 5m0s lang nichts anderes geantwortet: oci: die Registry bat wiederholt um Verlangsamung)
und für eine Anfrage, deren eigenes Zeitlimit das Warten beendete:
<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (bat wiederholt um Verlangsamung: Ihre letzte Antwort war 429 Too Many Requests, und sie hatte nichts anderes geantwortet, als die eigene Zeit der Anfrage ablief: oci: die Registry bat wiederholt um Verlangsamung)
So beheben Sie das Problem: Die Ursache ist das Ratenlimit der Registry, nicht etwas, das Sie verfasst haben. Eine Registry, die begrenzt, wie schnell ein Client anfragen darf, begrenzt in der Regel alles, was von derselben Adresse kommt; prüfen Sie daher, ob andere Befehle oder Rechner hinter dieser Adresse gleichzeitig bei ihr anfragen, und führen Sie den Befehl erneut aus, sobald diese fertig sind. Wenn Sie die Registry selbst betreiben, prüfen Sie ihr Ratenlimit. Die Grenze von fünf Minuten ist fest; es gibt keine Einstellung, die sie verlängert.
Fetched or cached bytes do not match the digest committed for them (Abgerufene oder zwischengespeicherte Bytes stimmen nicht mit dem für sie festgeschriebenen Digest überein)
Jedes Artefakt trägt ein Manifest, das den Digest seines Inhalts festschreibt, und das Lockfile pinnt unabhängig davon den Digest dieses Manifests. Beide Festschreibungen werden geprüft, indem die vorliegenden Bytes erneut gehasht und verglichen werden. Dies meldet ein fehlgeschlagener Vergleich, und er greift auf dieselbe Weise bei gerade abgerufenen Bytes wie bei Bytes, die aus dem Cache zurückgelesen werden.
Zwei Bedingungen, und welche greift, zeigt, welche Ebene nicht übereinstimmte. Die eine nennt Inhalt, der nicht mit dem Digest übereinstimmt, den sein eigenes Manifest festschreibt. Die andere nennt ein zwischengespeichertes Manifest, das nicht mit dem Digest übereinstimmt, den das Lockfile dafür gepinnt hat — die Prüfung, die verhindert, dass ein manipuliertes Manifest zur Autorität wird, der eine spätere Inhaltsprüfung vertraut. Der Pin macht diese zweite Prüfung aussagekräftig: Er stammt aus dem Lockfile, statt das Manifest aus den zwischengespeicherten Bytes neu abzuleiten, sodass die beiden wirklich unabhängig sind.
Eine Entität wird dann an ihrer eigenen Zeile gemessen, vor dem, was die Bytes mitführen. Sobald die Bytes einer zwischengespeicherten Entität mit ihrem Manifest übereinstimmen, werden sie mit dem Digest verglichen, den das Lockfile für die Entität erfasst; dieser deckt die Dateien ab, die ihre Veröffentlichung mitführt — jede nach ihrem Pfad und ihren Bytes — statt der komprimierten Bytes. So stimmen dieselben Dateien, mit einer anderen Kompression veröffentlicht, weiterhin überein, während andere Dateien unter derselben Version es nicht tun, und eine Abweichung wird unter der Inhaltsbedingung gemeldet. Ein Pull, der einen Pin beachtet, führt denselben Vergleich über das durch, was eine Registry unter der gepinnten Version ausliefert.
Keine dieser Prüfungen benötigt das Netzwerk. Jede ist ein Hash-Vergleich über bereits vorliegende Bytes; deshalb kann ein vollständig offline laufender Build dennoch feststellen, dass das, was er liest, dem Gepinnten entspricht.
Ausgegebene Meldungen. Inhalt gegenüber seinem Manifest:
oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch (oci: der berechnete Inhalts-Digest weicht vom im Manifest-Layer festgeschriebenen ab: oci: Abweichung des Inhalts-Digests)
eine Plugin-Entität, die ein Manifest an einer anderen Stelle festschreibt:
oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch (oci: der berechnete Konfigurations-Digest weicht von dem der Manifest-Konfiguration ab: oci: Abweichung des Inhalts-Digests)
ein zwischengespeichertes Manifest gegenüber dem gepinnten Digest:
oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch (oci: der berechnete Digest des zwischengespeicherten Manifests weicht vom gepinnten ab: oci: Abweichung des Digests des zwischengespeicherten Manifests)
eine zwischengespeicherte Entität gegenüber ihrer Zeile, und eine Registry, die unter einer gepinnten Version anderen Inhalt ausliefert:
catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch (catalog: der Inhalts-Digest der angegebenen zwischengespeicherten Entität stimmt nicht mit dem Pin des Lockfiles überein: oci: Abweichung des Inhalts-Digests)
oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin (oci: Abweichung des Inhalts-Digests: angegebene gepinnte Entität: die Registry liefert für die gepinnte Version jetzt einen anderen Digest als den gepinnten aus; führen Sie den Upgrade-Pull aus, um den Pin zu aktualisieren)
Beide werden von dem eingerahmt, was gerade gelesen wurde. Eine gepinnte Entität, die keine Quelle an ihrem Pin enthält, mit der Bedingung des Manifests, wo das Manifest des Cache-Eintrags abwich, und sonst der des Inhalts:
pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above> (angegebene gepinnte Entität: keine Quelle enthält die gepinnten Bytes, mit dem, was jede gelesene Quelle enthielt; bei erreichbarer Registry ruft der Pull die gepinnte Version erneut ab: die obige Meldung)
Ein Archiveintrag, der einen Pfad nennt, der aus dem Archiv herausführt, wird ebenfalls unter der Inhaltsbedingung gemeldet, da ein Bundle, das dies versucht, nicht das Bundle ist, das festgeschrieben wurde:
path traversal entry "<name>": oci: content digest mismatch (angegebener Eintrag mit Pfadtraversierung: oci: Abweichung des Inhalts-Digests)
Beide tragen dieselbe Abhilfe, wo der Schritt, der sie meldet, eine liefert:
remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache (Abhilfe: Führen Sie aggrega pull —upgrade —release für das angegebene Release aus, um Lockfile und Cache zu aktualisieren)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und keine Änderung beim Authoring behebt es. Aktualisieren Sie Cache und Lockfile gemeinsam mit aggrega pull --upgrade --release <release>, das erneut von der Quelle abruft und beide neu schreibt. Wo das den Fehler behebt, war die zwischengespeicherte Kopie seit dem Schreiben verändert oder abgeschnitten worden. Wo die Abweichung eine Aktualisierung übersteht, unterscheiden sich die Bytes, die der Herausgeber ausliefert, tatsächlich vom Gepinnten — eine erneut veröffentlichte Version, was eine Frage an den Herausgeber ist, und eine, die sich zu stellen lohnt, bevor man den neuen Digest übernimmt, nicht danach.
A manifest carries no layer of the expected kind, or more than one (Ein Manifest enthält keinen Layer des erwarteten Typs oder mehr als einen)
Das Manifest eines Artefakts listet seine Layer auf, und derjenige, der den Inhalt trägt, wird über seinen Medientyp statt über seine Position ausgewählt. Das erlaubt es einem Artefakt, mehr als einen Layer zu bündeln — etwa ein Chart mit einem separaten Provenienz-Layer daneben — und den Inhalt trotzdem zuverlässig herauszugreifen.
Zwei Strukturen lassen nichts zur Auswahl. Kein Layer des erwarteten Typs bedeutet, dass das Manifest etwas anderes beschreibt als das, wofür der Verweis gelesen wurde. Mehr als einer bedeutet, dass die Wahl keine Antwort hat, und den ersten zu nehmen wäre manchmal richtig und manchmal stillschweigend falsch.
Ausgegebene Meldungen, jede mit dem erwarteten Medientyp. Keiner:
oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type (oci: das Manifest hat keinen Layer des angegebenen Medientyps: oci: das Manifest hat keinen Layer des erwarteten Inhalts-Medientyps)
und mehr als einer, wobei auch die Anzahl genannt wird:
oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type (oci: das Manifest hat mehrere Layer des angegebenen Medientyps; genau einer wurde erwartet: oci: das Manifest hat mehrere Layer des erwarteten Inhalts-Medientyps)
So beheben Sie es: Die Behebung ist Sache des Herausgebers, nicht Ihre — das Manifest ist nichts, was ein Katalogautor schreibt. Prüfen Sie zuerst, ob der Verweis dorthin zeigt, wohin Sie wollten: Ein Verweis, der auf einen anderen Artefakttyp aufgelöst wird, erzeugt die erste Struktur, denn das Manifest ist ein echtes Manifest für etwas anderes. Wo der Verweis stimmt, wurde das Artefakt mit einem Manifest veröffentlicht, das es nicht als den Typ beschreibt, der es angeblich ist; geben Sie daher den Medientyp aus der Meldung an den Herausgeber weiter. Die Veröffentlichung über den gewöhnlichen Veröffentlichungsweg erzeugt ein Manifest mit genau einem Inhalts-Layer; ein Artefakt in einer der beiden Strukturen wurde also auf andere Weise zusammengestellt.
A published bundle holds no entity, or holds two (Ein veröffentlichtes Bundle enthält keine Entität oder zwei)
Eine Entität, die neben ihrem Dokument Dateien deklariert — das lokale Chart eines Recipe oder dessen Lock, das importierte Schema einer Component —, wird als .tar.gz veröffentlicht, das die Entität zusammen mit diesen Dateien bündelt. Ein solches zurückzulesen bedeutet, die Entität unter ihnen wiederzufinden — und die Datei, in der sie geschrieben wurde, kann beliebig heißen, sodass sie durch die Entitätspräambel identifiziert wird, die sie trägt, nicht durch ihren Namen. Das Dokument im Wurzelverzeichnis des Bundles, dessen kind: ein veröffentlichbarer Entitätstyp ist, ist die Entität; ein Compose-Fragment, eine Chart-Vorlage oder ein Kubernetes-Manifest daneben ist es nicht, und ebenso wenig ein Entitätsdokument weiter unten in einem Baum source/, das Inhalt ist, den die Entität ausliefert, und nicht die Entität selbst.
Zwei Strukturen lassen nichts zur Auswahl, und beide sind Eigenschaften der Art, wie das Artefakt veröffentlicht wurde.
Kein Entitätsdokument im Wurzelverzeichnis des Bundles. Das Bundle wurde ohne die Entität in seinem Wurzelverzeichnis gepackt — ihr Dokument wurde weggelassen oder in ein Unterverzeichnis gelegt statt neben die Dateien, die es mitführt. Die Meldung listet auf, was das Wurzelverzeichnis des Bundles tatsächlich enthält, was meist genügt, um zu sehen, was davon geschehen ist.
Zwei Entitätsdokumente im Wurzelverzeichnis des Bundles. Das Bundle wurde aus einem ganzen Verzeichnis gepackt, in dem zwei Entitäten geschrieben wurden — was aggrega push nie tut, da jede Entität nur die Dateien mitführt, die sie deklariert, was ein anderer Client aber tun kann. So gepackt, trägt jede ihrer veröffentlichten Koordinaten dieselben Bytes — eine Antwort mit einer der beiden würde also die andere Entität unter dem angefragten Namen zurückgeben, ohne dass irgendetwas nachgelagert es bemerken könnte. Es gibt keine sichere Wahl, also wird keine getroffen.
Ausgegebene Meldungen, die auflisten, was gefunden wurde. Keines, wo das Bundle andere Dateien enthält:
bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (das Wurzelverzeichnis des Bundles enthält unter den angegebenen Dateien kein Entitätsdokument: oci: das veröffentlichte Bundle enthält kein Entitätsdokument)
keines, wo es überhaupt nichts enthält:
bundle root carries no files at all: oci: published bundle carries no entity document (das Wurzelverzeichnis des Bundles enthält überhaupt keine Dateien: oci: das veröffentlichte Bundle enthält kein Entitätsdokument)
und mehr als eines, wobei sowohl die Anzahl als auch die kollidierenden Dokumente genannt werden:
bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (das Wurzelverzeichnis des Bundles enthält mehrere Entitätsdokumente, in den angegebenen Dateien: oci: das veröffentlichte Bundle enthält mehr als ein Entitätsdokument)
So beheben Sie es: Beide sind vom Herausgeber zu beheben, nicht von Ihnen, und die Behebung liegt im Versionsverzeichnis, aus dem die Entität veröffentlicht wurde. Geben Sie jeder Entität ein eigenes Versionsverzeichnis, sodass dieses Verzeichnis eine Entität und die zu ihr gehörenden Dateien enthält — die Struktur, der jede veröffentlichte Entität bereits folgt, bei der das Verzeichnis nach dem metadata.version der Entität benannt ist und unter dem eigenen Namen der Entität liegt. Veröffentlichen Sie dann erneut mit einer neuen Version: Veröffentlichte Bytes sind eingefroren, daher wird ein erneutes Veröffentlichen über die bestehende Version zurückgewiesen statt korrigiert. Wenn Sie konsumieren statt veröffentlichen, geben Sie die Meldung an den Herausgeber des Artefakts weiter; die Dateinamen darin bezeichnen das aufzuteilende Verzeichnis.
A published artifact cannot be read as an entity (Ein veröffentlichtes Artefakt kann nicht als Entität gelesen werden)
Das Lesen einer Entität von der Koordinate, an der sie veröffentlicht ist, beginnt bei den Bytes, die die Registry dort ausliefert — aggrega inspect oci://… liest sie, damit Sie sie ansehen können, und ein Abhängigkeits-Pull liest die eines Archivs auf dieselbe Weise, um die Version zu finden, die er pinnt. Zwei Strukturen dieser Bytes enthalten keine Entität, die gelesen werden könnte.
Ein Archiv, das sich nicht entpacken lässt. Eine Entität, die mit den von ihr deklarierten Dateien veröffentlicht wird, wird als .tar.gz veröffentlicht, und die Bytes beginnen auch so, aber der Kompressionsstrom oder das Archiv darin ist nicht wohlgeformt — meist, weil es abgeschnitten wurde. Die Bytes stimmen weiterhin mit dem Digest überein, den das eigene Manifest des Artefakts für sie erfasst, sie sind also genau das, was veröffentlicht wurde: Der Schaden entstand vor oder während der Veröffentlichung und nicht auf dem Weg zu Ihnen.
Ein Dokument, das keine Entität ist. Die Koordinate trägt ein einzelnes Dokument, und es lässt sich nicht parsen, deklariert kein kind: oder deklariert einen Typ, der nie veröffentlicht wird, etwa ein Release oder ein Manifest. Der Verweis nennt dann etwas, das neben dem Katalog veröffentlicht wurde, statt einer Entität — etwa ein Datenartefakt, das mit aggrega push-artifact veröffentlicht wurde.
Ausgegebene Meldungen. Ein Archiv, dessen Kompressionsstrom nicht wohlgeformt ist, mit dem Fehler, der es gestoppt hat:
oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: gzip-Entpacken des Bundles: der Archivfehler: oci: das veröffentlichte Bundle kann nicht entpackt werden)
eines, das mitten in einer Datei abbricht:
read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (Lesen der angegebenen Datei aus dem veröffentlichten Bundle: der Archivfehler: oci: das veröffentlichte Bundle kann nicht entpackt werden)
ein Dokument, das einen Typ deklariert, der nie veröffentlicht wird:
the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (das veröffentlichte Dokument deklariert einen Typ, den eine Registry nicht veröffentlicht: oci: das veröffentlichte Artefakt ist kein Entitätsdokument)
und Bytes, die überhaupt kein Dokument sind:
the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (die veröffentlichten Bytes lassen sich nicht als Dokument parsen, mit dem Parse-Fehler: oci: das veröffentlichte Artefakt ist kein Entitätsdokument)
So beheben Sie es: Ein Archiv, das sich nicht entpacken lässt, muss der Herausgeber ersetzen. Veröffentlichte Bytes sind eingefroren, daher besteht die Abhilfe darin, die Entität mit einer neuen Version erneut zu veröffentlichen; wenn Sie sie konsumieren, geben Sie die Meldung an den Herausgeber weiter. Ein Dokument, das keine Entität ist, bedeutet fast immer, dass der Verweis nicht der gemeinte ist: Prüfen Sie, ob er die Koordinate nennt, an der eine Entität veröffentlicht ist, also den Verweis, den aggrega push ausgibt, wenn es eine veröffentlicht.
The registry could not answer what is attached to an artifact (Die Registry konnte nicht beantworten, was an ein Artefakt angebunden ist)
Signaturen und andere Anbindungen hängen an einem Artefakt, statt in ihm zu liegen, und sie zu finden ist eine Frage an die Registry. Diese Bedingung besagt, dass die Frage unbeantwortet blieb — die Registry bietet diese Abfrage nicht an, das Artefakt, an dem die Anbindungen hängen, konnte nicht gefunden werden, oder die Anfrage selbst ist fehlgeschlagen.
Das ist nicht dasselbe wie die Antwort „nichts ist angebunden“, und genau die Verwechslung der beiden soll dies verhindern. Ein Artefakt, das tatsächlich keine Signatur trägt, wird normal aufgelöst und ergibt eine leere Liste. Dies besagt, dass die Liste nie erhalten wurde, sodass über das Angebundene überhaupt nichts bekannt ist.
Ob der Build abbricht, hängt davon ab, ob eine Signatur erforderlich ist, und beide Richtungen sind beabsichtigt:
Eine Signatur ist erforderlich. Der Build hält an. Eine erforderliche Prüfung, die nicht laufen konnte, ist nicht bestanden, und das Artefakt zuzulassen würde auf einer Frage beruhen, die niemand stellen konnte.
Keine Signatur ist erforderlich. Der Build läuft weiter und sagt es laut, statt zu schweigen. Die Abfrage hat in keiner Richtung etwas zum Verifizieren ergeben, daher würde eine Zurückweisung ein Artefakt aufgrund einer unbeantworteten Frage ablehnen — Schweigen aber würde sich wie ein sauberer Pull ohne Signatur lesen, was es nicht ist.
Ausgegebene Meldungen. Eine Registry, die die Abfrage nicht anbietet:
oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: das Ziel unterstützt keine Referrer-Ermittlung, mit dem angegebenen Zieltyp: oci: die Referrer-Ermittlung konnte nicht abgeschlossen werden)
das Artefakt selbst nicht auffindbar:
oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: Auflösen des angegebenen Subjekts: der zugrunde liegende Fehler: oci: die Referrer-Ermittlung konnte nicht abgeschlossen werden)
und die fehlschlagende Abfrage:
oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: Auflisten der Referrer des angegebenen Verweises: der zugrunde liegende Fehler: oci: die Referrer-Ermittlung konnte nicht abgeschlossen werden)
Wo keine Signatur erforderlich ist, erscheint derselbe Text stattdessen als Hinweis:
signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (die Signaturprüfung konnte für das angegebene Artefakt nicht ausgeführt werden (die Registry konnte die Signaturabfrage nicht beantworten und es ist keine Signatur erforderlich; es wird fortgefahren): die obige Meldung)
So beheben Sie es: Die Behebung ist Sache des Operators und liegt bei der Registry, nicht bei Ihrem Katalog. Wo die Registry Abfragen von Anbindungen überhaupt nicht anbietet, kann sie keine Signaturen tragen; spiegeln Sie das Artefakt daher in eine Registry, die das kann, oder hören Sie auf, in .aggrega-config.yaml Signaturen von diesem Host zu verlangen — und halten Sie fest, welche der beiden Möglichkeiten Sie wählen, denn die zweite bedeutet, dass Signaturen von diesem Host nicht mehr geprüft werden. Wo die Abfrage bei einer Registry fehlgeschlagen ist, die sie anbietet, handelt es sich um ein Transport- oder Berechtigungsproblem speziell am Endpunkt für Anbindungen, und ein erneuter Lauf, sobald die Registry erreichbar ist, ist die ganze Abhilfe.
An artifact that must be signed carries no signature (Ein Artefakt, das signiert sein muss, trägt keine Signatur)
Eine Signatur ist für ein Artefakt erforderlich, wenn entweder die eigene Signaturrichtlinie des Workspace seinen Typ abdeckt oder die Registry, aus der es stammt, so konfiguriert ist, dass sie eine verlangt. Diese Bedingung meldet, dass die Registry die Abfrage der Anbindungen beantwortet hat, nichts angebunden war und eine Signatur erforderlich war.
Die beiden Anforderungen sind eine Haltung, gelesen in zwei Geltungsbereichen. Die workspaceweite Richtlinie erzwingt eine Signatur für einen Typ in ihrem Geltungsbereich auch von einem Host, dessen eigener Eintrag keine verlangt; ein Host, der nichts verlangt, nimmt also kein Artefakt aus, das die workspaceweite Richtlinie abdeckt.
Wo keine Signatur erforderlich ist, ist dies überhaupt kein Fehler. Das Artefakt wird verifiziert, wenn eine Signatur vorhanden ist, und passiert stillschweigend, wenn keine vorhanden ist; genau das macht einen Host ohne konfigurierte Haltung ohne Umstände nutzbar.
Ein Artefakt, dessen Typ nicht bestimmt werden konnte, während eine workspaceweite Richtlinie aktiv ist, wird als signaturpflichtig behandelt statt als ausgenommen, sodass ein nicht klassifizierbares Artefakt nicht an einer eingeschalteten Richtlinie vorbeischlüpfen kann.
Ausgegebene Meldung, eingerahmt vom Verweis, den sie prüfte:
verifying the signature of <uri>: signing: no signature found for an artifact that requires one (Verifizieren der Signatur des angegebenen Artefakts: signing: keine Signatur für ein Artefakt gefunden, das eine erfordert)
So beheben Sie es: Die Behebung ist Sache des Operators oder des Herausgebers, nicht des Entitätsautors. Wo Sie erwartet haben, dass das Artefakt signiert ist, wurde es ohne Signatur veröffentlicht — geben Sie den Verweis an den Herausgeber weiter, denn nur er kann eine anbinden. Wo das Artefakt nicht signiert sein soll, ist die Anforderung das, was zu ändern ist: Sie stammt entweder aus dem Eintrag der Registry in .aggrega-config.yaml oder aus der workspaceweiten Signaturrichtlinie, und der Verweis in der Meldung sagt Ihnen, welchen Host Sie prüfen müssen. Eine Anforderung abzuschalten bedeutet, dass Artefakte von diesem Host nicht mehr geprüft werden; schränken Sie daher lieber den Geltungsbereich der Richtlinie auf einen Typ ein, statt sie ganz abzuschalten.
A signature does not verify (Eine Signatur lässt sich nicht verifizieren)
Eine Signatur wurde gefunden und geprüft, und die Prüfung ist fehlgeschlagen. Es ist das allgemeine negative Ergebnis dieser Prüfung und umfasst eine Zertifikatskette, die nicht im Vertrauensmaterial wurzelt, eine Signatur ohne Eintrag im Transparenzlog, wo einer erforderlich ist, eine Signatur über ein anderes Artefakt als das vorliegende, ein Bundle, das verändert wurde, und ein Bundle, das gegen einen gepinnten Schlüssel geprüft wurde und sich mit ihm nicht verifizieren lässt.
Sie ist bewusst von einer Signatur unterschieden, deren Signierer nicht vertrauenswürdig ist. Jene ist strukturell einwandfrei und vom falschen Signierer erstellt; diese hat die Prüfung überhaupt nicht bestanden. Beide getrennt zu halten, ermöglicht es Ihnen, „das Artefakt ist nicht das, was signiert wurde“ von „das Artefakt wurde von jemandem signiert, den Sie nicht akzeptiert haben“ zu unterscheiden.
Für welches Artefakt eine Signatur erstellt wurde, wird zweimal geprüft. Sobald die kryptografische Prüfung der Signatur besteht, liest die Toolchain aus der Signatur selbst, für welches Artefakt sie erstellt wurde — dieselbe Lesart, an der jeder spätere Build die erfasste Signatur misst, und genau das lässt einen Build eine von einem Artefakt auf ein anderes kopierte Signatur zurückweisen, ohne etwas zu verifizieren — und weist die Signatur zurück, wo diese Lesart nicht das vorliegende Artefakt nennt oder wo die Signatur in einer Form vorliegt, aus der die Lesart das Artefakt nicht ermitteln kann. Beide Formen, die ein Pull akzeptiert, werden gelesen: eine über das Artefakt selbst erstellte Signatur und eine signierte Aussage, die es nennt. Die Lesart folgt den eigenen Regeln der kryptografischen Prüfung, daher stimmen beide bei einer Signatur, die diese Prüfung akzeptiert, überein; eine Zurückweisung dieser Art bedeutet, dass sie nicht übereinstimmten, und sie sollte mit dem Verweis und der Meldung gemeldet werden, statt sie per Konfiguration zu umgehen.
Wo der Eintrag einer Registry die Verifizierung als beratend kennzeichnet, wird derselbe Text als Hinweis gemeldet, und der Lauf wird fortgesetzt.
Ausgegebene Meldungen. Aus der Prüfung selbst, mit dem, was der Verifizierer gemeldet hat:
signing: signature bundle does not verify: <what the verifier reported> (signing: das Signatur-Bundle lässt sich nicht verifizieren: was der Verifizierer gemeldet hat)
und, wo die kryptografische Prüfung besteht und die Lesart, für welches Artefakt die Signatur erstellt wurde, nicht übereinstimmt:
signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (signing: das Signatur-Bundle lässt sich nicht verifizieren: seine kryptografische Prüfung besteht, aber es nennt den angegebenen Manifest-Digest nicht als das Artefakt, für das es erstellt wurde)
signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (signing: das Signatur-Bundle lässt sich nicht verifizieren: seine kryptografische Prüfung besteht, aber es liegt in einer Form vor, aus der sich das Artefakt, für das es erstellt wurde, nicht lesen lässt)
jeweils eingerahmt vom zu verifizierenden Verweis:
verifying the signature of <uri>: <the message above> (Verifizieren der Signatur des angegebenen Artefakts: die obige Meldung)
und, wo der Eintrag der Registry die Verifizierung beratend macht, als Hinweis statt als Abbruch:
signature verification failed for <uri> (advisory; continuing): <the message above> (die Signaturprüfung ist für das angegebene Artefakt fehlgeschlagen (beratend; es wird fortgefahren): die obige Meldung)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und keine Authoring-Änderung behebt es. Behandeln Sie es als Aussage über das Artefakt statt über Ihre Konfiguration: Die vorliegenden Bytes sind nicht die Bytes, die signiert wurden, oder die Signatur ist keine, die das konfigurierte Vertrauensmaterial prüfen kann. Beschaffen Sie das Artefakt zuerst erneut, denn eine abgeschnittene oder veränderte zwischengespeicherte Kopie schlägt genau so fehl, und ein frischer Abruf behebt es. Wo es einen frischen Abruf übersteht, geben Sie den Verweis und den Wortlaut des Verifizierers an den Herausgeber des Artefakts weiter. Greifen Sie nicht zur beratenden Einstellung, um daran vorbeizukommen — diese Einstellung lässt die Prüfung weiterlaufen und hindert sie am Abbruch, was eine bewusste Entscheidung ist, nicht verifizierte Artefakte von diesem Host zu akzeptieren, und kein Weg, eines zu reparieren.
A signature verifies but its signer is not one the registry trusts (Eine Signatur lässt sich verifizieren, aber ihr Signierer ist keiner, dem die Registry vertraut)
Die Signatur hat die Prüfung bestanden — die Zertifikatskette wurzelt im Vertrauensmaterial, und der Transparenzeintrag ist vorhanden —, und die Identität in diesem Zertifikat stimmt mit keiner der Identitäten überein, die für die Registry als akzeptabel konfiguriert sind. Das Artefakt wurde von einem echten Signierer signiert, der nicht akzeptiert wurde.
Beide Hälften einer Identität werden verglichen, das Subjekt und der Aussteller, der dafür gebürgt hat, und jede der beiden kann diejenige sein, die nicht übereinstimmte. Die Meldung nennt beide, wo sie sich aus dem Zertifikat ablesen lassen, denn ein Signierer, der ein erwartetes Subjekt unter einem Aussteller vorlegt, den niemand akzeptiert hat, sieht genauso aus wie ein falsches Subjekt, sofern nicht beide angezeigt werden.
Ausgegebene Meldungen. Mit beiden Hälften lesbar:
signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (signing: die Signaturidentität ist für diese Registry nicht vertrauenswürdig: was der Verifizierer gemeldet hat; der Signierer hat den angegebenen Aussteller mit der angegebenen Identität vorgelegt, aber keine vertrauenswürdige Identität lässt diesen Aussteller zu)
und wo sie sich nicht lesen lassen, mit dem eigenen Bericht des Verifizierers als Rückfall:
signing: signature identity is not trusted for this registry: <what the verifier reported> (signing: die Signaturidentität ist für diese Registry nicht vertrauenswürdig: was der Verifizierer gemeldet hat)
So beheben Sie es: Dies ist die Entscheidung des Operators, und es ist eine echte Entscheidung und keine Formalität. Vergleichen Sie den Aussteller und die Identität in der Meldung mit den vertrauenswürdigen Identitäten, die für diese Registry in .aggrega-config.yaml konfiguriert sind. Wo der Signierer einer ist, den Sie akzeptieren wollen, fügen Sie ihn hinzu — ein Eintrag nennt eine Identität oder ein dazu passendes Muster zusammen mit dem Aussteller, und beide müssen stimmen. Wo nicht, wurde das Artefakt von jemandem signiert, den Sie nicht akzeptiert haben, und die Identität hinzuzufügen, damit der Build durchläuft, ist die eine Reaktion, die zu vermeiden ist. Bei Registries, die ihre eigene Vertrauensrichtlinie bekannt geben, lässt sich diese beim Hinzufügen der Registry pinnen; so gelangen die vorgesehenen Identitäten hinein, ohne dass man sie abschreibt.
A keyless trust policy names no acceptable signer (Eine schlüssellose Vertrauensrichtlinie nennt keinen akzeptablen Signierer)
Die schlüssellose Verifizierung entscheidet, ob ein Artefakt akzeptiert wird, indem sie die Identität in seinem Signaturzertifikat mit einer Menge von Identitäten abgleicht, die als akzeptabel konfiguriert sind. Eine leere Menge wird zurückgewiesen, statt überhaupt als Richtlinie behandelt zu werden: Ein Abgleich gegen nichts würde entweder jeden Signierer akzeptieren oder jeden zurückweisen, und keines von beidem meinte ein Operator, der die Verifizierung konfiguriert hat.
Ausgegebene Meldung, die der eigene Satz der Bedingung ist:
signing: keyless verification requires at least one trusted identity (signing: die schlüssellose Verifizierung erfordert mindestens eine vertrauenswürdige Identität)
So beheben Sie es: Konfigurieren Sie in .aggrega-config.yaml mindestens eine vertrauenswürdige Identität für die Registry. Ein Eintrag nennt die Identität — als exaktes Subjekt oder als dazu passendes Muster — zusammen mit dem Aussteller, der für sie bürgt, und beide sind erforderlich. Wo die Registry ihre eigene Vertrauensrichtlinie bekannt gibt, füllt das Pinnen dieser Richtlinie beim Hinzufügen der Registry die Menge mit dem, was die Registry veröffentlicht. Wo Sie Signaturen von dieser Registry überhaupt nicht verifizieren wollen, ist das eine andere Einstellung als eine leere Identitätsmenge, und sie ausdrücklich zu setzen ist das, was dies aussagt.
The pinned trust root cannot be read (Die gepinnte Vertrauenswurzel kann nicht gelesen werden)
Eine im Workspace gepinnte Vertrauenswurzel ist das, was eine schlüssellose Prüfung ohne Netzwerkzugang verifizieren lässt, wo immer sie läuft: eine Datei, deren Inhalt das Material ist, gegen das jede Signatur geprüft wird. Diese Bedingung meldet, dass die Datei unter dem konfigurierten Pfad nicht in nutzbares Vertrauensmaterial umgewandelt werden konnte — sie fehlt, sie ist nicht lesbar, oder ihr Inhalt ist keine Vertrauenswurzel.
Sie bricht ab, statt auf etwas anderes zurückzufallen. Eine gepinnte Wurzel ist eine bewusste Entscheidung, Signaturen gegen Material zu prüfen, das Sie kontrollieren; stattdessen stillschweigend eine abzurufen, würde diese Entscheidung durch eine andere ersetzen und ein Verifizierungsergebnis liefern, um das niemand gebeten hat.
Ausgegebene Meldung, die den Pfad nennt und wiedergibt, was das Lesen gemeldet hat:
signing: cannot load pinned trust root: <path>: <what the read reported> (signing: die gepinnte Vertrauenswurzel kann nicht geladen werden: der angegebene Pfad: was das Lesen gemeldet hat)
So beheben Sie es: Dies ist Sache des Operators. Prüfen Sie, ob der für die Vertrauenswurzel konfigurierte Pfad existiert und für denjenigen lesbar ist, der den Befehl ausführt — ein Pfad relativ zu einem anderen Arbeitsverzeichnis und eine vorhandene, aber nicht lesbare Datei werden beide hier gemeldet. Wo die Datei existiert und lesbar ist, ist ihr Inhalt keine Vertrauenswurzel; ersetzen Sie sie daher durch ein aktuelles Bundle aus der Quelle, von der Sie sie bezogen haben, statt sie zu bearbeiten. Wo keine gepinnte Wurzel beabsichtigt war, ist die Konfiguration das, was zu ändern ist: Entfernen Sie den Pin, und die Verifizierung verwendet das Material, das sie andernfalls erhalten würde.
A pinned verification key is not the key profile the verifier accepts (Ein gepinnter Verifizierungsschlüssel entspricht nicht dem Schlüsselprofil, das der Verifizierer akzeptiert)
Signieren und Verifizieren mit einem gehaltenen Schlüssel verwenden ein einziges Schlüsselprofil, und ein Schlüssel jeder anderen Art wird zurückgewiesen, statt dass ein Versuch damit unternommen wird. Es ist eine Aussage über den Typ des Schlüssels, nicht darüber, ob er etwas verifiziert.
Die beiden Momente, in denen sie gemeldet wird, sind unterschiedliche Aufgaben. Der eine ist das Laden eines Schlüssels zum Signieren, was dort geschieht, wo ein Artefakt veröffentlicht wird; der andere ist das Prüfen einer Signatur gegen einen für eine Registry gepinnten Schlüssel, was dort geschieht, wo ein Artefakt verifiziert wird. Die Zurückweisung ist in beiden dieselbe.
Ausgegebene Meldungen, die jeweils den Algorithmus des tatsächlich gelieferten Schlüssels nennen — an RSA key oder an Ed25519 key. Ein gepinnter Verifizierungsschlüssel:
signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256 (signing: nicht unterstützter Typ eines gehaltenen Schlüssels: der gepinnte Schlüssel verwendet den angegebenen Algorithmus, erwartet wird ECDSA P-256)
und ein zum Signieren geladener Schlüssel:
signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (signing: nicht unterstützter Typ eines gehaltenen Schlüssels: der gehaltene Schlüssel verwendet den angegebenen Algorithmus, erwartet wird ECDSA P-256)
So beheben Sie es: Liefern Sie einen Schlüssel des Profils, das die Meldung nennt. Wo Sie verifizieren, ist der Schlüssel derjenige, der für die Registry in .aggrega-config.yaml gepinnt ist, und er muss die öffentliche Hälfte des Schlüssels sein, mit dem der Herausgeber signiert — eine Abweichung bedeutet hier meist, dass die falsche Datei gepinnt wurde, denn ein Schlüssel des richtigen Typs, der aber nicht der richtige Schlüssel ist, wird stattdessen als Signatur gemeldet, die sich nicht verifizieren lässt. Wo Sie signieren, erzeugen Sie einen Schlüssel des genannten Profils oder verwenden Sie den schlüssellosen Weg, der überhaupt keinen gehaltenen Schlüssel benötigt.
The workspace is offline and the step needs the network (Der Workspace ist offline, und der Schritt benötigt das Netzwerk)
Ein Workspace kann als offline gekennzeichnet werden, und diese Einstellung ist eine Zurückweisung und keine Präferenz: Jeder Schritt, der das Netzwerk erreichen würde, wird dort zurückgewiesen, wo er konstruiert wird, bevor irgendeine Verbindung aufgebaut wird. Die frühe Zurückweisung sorgt dafür, dass der Fehler „dieser Workspace ist offline“ sagt, statt später als Zeitüberschreitung ohne Erklärung aufzutauchen.
Eine Entscheidung, an einer Stelle gelesen. Ein Schritt, der im Voraus wissen muss, ob das Netzwerk erreicht werden könnte, stellt dieselbe Frage, die auch der Abruf selbst stellt, sodass eine Prüfung und die Operation, die sie schützt, nicht zu unterschiedlichen Ergebnissen kommen können.
Sie erreicht mehrere Arten von Arbeit, alle mit derselben Zurückweisung: das Beschaffen eines Artefakts aus einer Registry, das Beschaffen der Quelle eines Recipe über das Netzwerk, das Abrufen einer externen Eingabe, das Beziehen einer Identität zum Signieren und das Abrufen von Vertrauensmaterial. Ein Build, der einen befüllten Cache liest, erreicht keine davon, und genau das ist der Zweck der Einstellung.
Wo der gesamte Befehl ein Netzwerk-Roundtrip ist, kommt die Zurückweisung zuerst statt zuletzt.push, push-artifact und registry update existieren, um eine Registry zu erreichen, daher sagen sie dies, bevor sie Ihre Entität lesen oder Ihre Repositorys durchlaufen, und sie nennen, welche der drei Stellen den Modus gesetzt hat — das Flag, das Sie eingegeben haben, die Umgebungsvariable oder die Datei und den Schlüssel darin. Ein --dry-run ist die Ausnahme, und er ist eine Ausnahme wegen dessen, was er tut, nicht wegen seines Namens: Er meldet, was er veröffentlichen würde, und ruft nichts auf; er ist also die Form einer Veröffentlichung, die offline sicher ist, und funktioniert weiter.
Ausgegebene Meldung, die ihre eigene Abhilfe mitführt und der eigene Satz der Bedingung ist:
egress: network access refused because the workspace is offline; remediation: pass --offline=false to allow the network for this one run, or clear the top-level offline key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run aggrega pull --release <release> from a connected environment first to populate the cache (egress: Netzwerkzugriff zurückgewiesen, weil der Workspace offline ist; Abhilfe: Übergeben Sie das Flag, das das Netzwerk für diesen einen Lauf erlaubt, oder entfernen Sie den Top-Level-Schlüssel für den Offline-Modus in der Konfigurationsdatei (oder AGGREGA_OFFLINE), um es von nun an zu erlauben; wo die Arbeit ein Build ist, der Inhalte benötigt, die die Maschine nicht hat, führen Sie zuerst den Pull des angegebenen Release aus einer verbundenen Umgebung aus, um den Cache zu befüllen)
Eingerahmt von dem, was das Netzwerk benötigte — etwa das Beschaffen der Quelle eines Recipe:
sourceresolver: kind=<kind> url=<url> version=<version>: <the message above> (sourceresolver: mit dem angegebenen Typ, der angegebenen URL und Version: die obige Meldung)
Das Hinzufügen des offiziellen Hubs in einem Offline-Workspace wird nicht zurückgewiesen: Der Hub wird mit seiner eingebauten Grundkonfiguration hinzugefügt, und der Hinweis besagt, dass der Hub nicht nach seiner Vertrauensrichtlinie gefragt wurde, weil der Workspace offline ist.
So beheben Sie es: Die Meldung nennt drei Wege, und welcher zutrifft, entscheiden Sie. Wo der Modus gesetzt ist und Sie für diesen einen Befehl daran vorbeimöchten, übergeben Sie --offline=false; dafür ist das Flag da, und es ist die einzige Antwort, die jemandem zur Verfügung steht, der die Konfigurationsdatei nicht selbst geschrieben hat. Wo der Workspace offline sein soll, ist der fehlende Inhalt das, was zu beheben ist: Führen Sie den Pull von einem Ort mit Netzwerkzugang aus, sodass der Cache alles enthält, was das Release erreicht; danach benötigt der Offline-Build nichts weiter. Wo er überhaupt nicht offline sein soll, entfernen Sie die Einstellung an ihrer Quelle — den Top-Level-Schlüssel offline in .aggrega-config.yaml oder die Umgebungsvariable, die die Meldung nennt; die Variable ist diejenige, die Leute überrascht, weil sie in keiner Datei steht. Beachten Sie, dass ein Offline-Workspace überhaupt nicht über den schlüssellosen Weg signieren kann, da das Ausstellen eines Zertifikats und seine Erfassung Netzwerkoperationen ohne Offline-Form sind.
Beim Aufbau der Topologie
Sobald jede Component ein aufgelöstes Recipe hat, fügt der Compiler die Components zum IR-Graphen zusammen, indem er den Block uses: jeder Component liest und Ziele sowie Feature-Anbindungen abgleicht.
Dangling uses target (Hängendes Kantenziel)
Eine Kante uses: nennt eine Zielkomponente, die in der aufgelösten Topologie nicht existiert. Der Abbruch ist agnostisch gegenüber der Herkunft — eine vom Entwickler verfasste Aggregate-Kante und eine von einem Release verdrahtete Kante werden gleichermaßen abgefangen. Ein hängendes Ziel ist ein fataler Abbruch, kein stilles Verwerfen: Eine Kante zu einem nicht existierenden Ziel würde sonst verschwinden und die injizierten Werte des Konsumenten zum Zeitpunkt der Bereitstellung stillschweigend leer lassen. Er ist das strukturelle Gegenstück zum Abbruch wegen eines nicht deklarierten Sockets weiter unten: In welchen Socket eine Verbindung auch verdrahtet ist, ihr Ziel muss zu einer existierenden Komponente aufgelöst werden, bevor die Typen der Kante geprüft werden.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann das Ziel, dem nichts entspricht, und der Socket, in den die Verbindung verdrahtet wurde — dann, was dagegen zu tun ist:
uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (das Ziel der uses-Kante existiert nicht: das angegebene Ziel, verdrahtet in den angegebenen Socket. Richten Sie das Ziel auf eine Komponente, die das Aggregate deklariert, oder deklarieren Sie eine Komponente unter diesem Namen.)
Der Befund wird an dem verfassten Eintrag positioniert, den er betrifft, in dem Dokument, in dem dieser Eintrag geschrieben wurde, sodass eine Verbindung, die der eigene Block uses: einer Komponente gezogen hat, eine, die eine Anbindung projiziert hat, und eine, die ein Release verdrahtet hat, jeweils an ihrem eigenen Block gemeldet werden. Jede fehlerhafte Verbindung wird als eigener Befund gemeldet, sodass ein einziger Build sie alle nennt, statt bei der ersten anzuhalten.
So beheben Sie es: Deklarieren Sie die fehlende Zielkomponente, oder korrigieren Sie den Zielnamen im Eintrag uses:, sodass er einer existierenden Komponente entspricht.
Two connections of one component under one alias (Zwei Verbindungen einer Komponente unter einem Alias)
Eine Komponente liest jede ihrer Verbindungen über ihren Alias — den Schlüssel, unter dem die Verbindung geschrieben wurde, oder, bei einer als Listeneintrag geschriebenen Verbindung, den eigenen Namen ihres Ziels. Ein Recipe-Template liest die Verbindungen einer Komponente allein nach Alias geschlüsselt, und eine Assertion liest sie nach Socket und dann nach Alias geschlüsselt, sodass zwei Verbindungen einer Komponente unter einem Alias in mindestens einer dieser Sichten einen einzigen Slot teilen würden: Die spätere würde ihn einnehmen, und die andere würde in dem fehlen, was das Template oder die Assertion sieht. Ein Alias nennt also eine einzige Verbindung einer Komponente — gleich, in welchen Socket jede verdrahtet ist, was sie gezogen hat (der eigene Block uses: der Komponente, der Block uses: einer Anbindung in einem beliebigen Geltungsbereich oder ein kantenbezogener Eintrag eines Release) und was ihr Ziel ist. Ein Paar bricht den Build ab, sobald der Graph endgültig ist, bevor irgendeine Assertion läuft und bevor irgendetwas gerendert wird.
Das Paar entsteht aus Verfassen, das auf jeder Oberfläche für sich zulässig ist: der eigene Eintrag einer Komponente und der einer Anbindung auf demselben Socket und Alias; eine Liste, die ein Ziel zweimal nennt (models: [llama, llama]); ein Alias, der auf zwei Sockets geschrieben ist (models: { local: … } neben databases: { local: … }); zwei Anbindungen, die denselben Alias verdrahten; oder ein Release-Eintrag, der eine Verbindung auf einem Socket zieht, den das Aggregate ungebunden gelassen hat, unter einem Alias, den das Aggregate bereits auf einem anderen Socket verwendet hat. Zwei benachbarte Strukturen erreichen diesen Abbruch nie: Ein Schlüssel, der in einem Block von Einträgen mit Schlüssel zweimal geschrieben ist, lässt das Laden des Dokuments fehlschlagen, und ein Release-Eintrag an einem Socket und Alias, die ein anderer Block bereits gezogen hat, konfiguriert diese Verbindung — oder bricht, wenn er ein anderes Ziel nennt, als Zieländerung ab —, statt eine zweite zu ziehen.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann der Alias und die Komponente, dann der Socket dieser Verbindung, ihr Ziel und die Stelle, an der ihr Eintrag geschrieben wurde, dann dasselbe für die Verbindung, die den Alias bereits hält — dann, was dagegen zu tun ist:
connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases. (der Verbindungsalias wird bereits von einer anderen Verbindung derselben Komponente verwendet: der angegebene Alias und die angegebene Komponente, Socket, Ziel, Datei und Schlüsselpfad dieser Verbindung, dann dieselben Angaben für die Verbindung, die den Alias bereits hält. Geben Sie einer der beiden Verbindungen einen eigenen Alias: Eine Komponente liest jede Verbindung über ihren Alias, gleich, in welchen Socket sie verdrahtet ist. Ein Listeneintrag übernimmt den Namen seines Ziels als Alias, daher wird ein zweimal aufgeführtes Ziel einmal aufgeführt oder als zwei Einträge mit Schlüssel unter zwei Aliassen geschrieben.)
Wo beide Verbindungen unter demselben Schlüsselpfad geschrieben wurden — eine Liste, die ein Ziel zweimal nennt —, wird jede zusätzlich über ihre Stelle in dieser Liste benannt, list entry "2" neben list entry "1", was das Einzige ist, das die beiden Einträge unterscheidet.
Der Befund wird am eigenen Eintrag der späteren Verbindung positioniert — derjenigen, die als zweite gezogen wurde, also derjenigen, die sonst den Slot des Alias eingenommen hätte —, in dem Dokument, in dem dieser Eintrag geschrieben wurde. Ein Release-Eintrag oder eine Anbindung, die das Release schreibt, wird daher als Betriebsfehler eingeordnet, und ein Eintrag im Aggregate als Entwicklerfehler. Jede fehlerhafte Verbindung wird als eigener Befund gemeldet, sodass ein einziger Build sie alle nennt.
Einige Strukturen werden weniger genau benannt. Ein Anbindungsname, der in mehr als einem Geltungsbereich deklariert ist — etwa an einer Komponente und an dem Subsystem, das sie enthält —, zieht aus jedem deklarierenden Block eine Verbindung, und der Build erfasst beide allein unter dem Namen der Anbindung. Beide Verbindungen werden dann an einem der deklarierenden Blöcke benannt — dem eigenen Anbindungsblock der Komponente, wo immer der Name dort deklariert ist —, und keine trägt eine Listenposition. Dasselbe gilt innerhalb eines importierten Aggregate, wo die deklarierenden Blöcke — der einer Komponente und der eines der eigenen Subsysteme des Moduls — im eigenen Dokument des Moduls benannt werden. In jeder dieser Strukturen wird das Paar dennoch zurückgewiesen.
So beheben Sie es: Geben Sie einer der beiden Verbindungen einen eigenen Alias. Bei einer Liste, die ein Ziel zweimal nennt, führen Sie das Ziel einmal auf oder schreiben Sie die beiden Verbindungen als Einträge mit Schlüssel unter zwei Aliassen. Bei einem Alias auf zwei Sockets benennen Sie einen der beiden Schlüssel um. Eine Anbindung, die einen Socket unter einem Alias verdrahtet, den die Komponente bereits verwendet, erhält in ihrem eigenen Block uses: einen anderen Schlüssel.
uses: socket not declared in the owning entity’s usesSchema (Socket nicht im Socket-Schema der besitzenden Entität deklariert)
Ein Block uses: nennt einen Socket, den die Entität, der die Oberfläche gehört, in ihrem usesSchema nicht deklariert, auf einer der beiden Oberflächen, auf denen nur ein deklarierter Socket genannt werden darf: dem uses:einer Feature-Anbindung, wo der Socket am angebundenen Feature deklariert sein muss, und dem kantenbezogenen uses:eines Release, wo er an der konsumierenden Component deklariert sein muss. Ein Release darf Kanten nur innerhalb von Sockets verdrahten oder konfigurieren, die das usesSchema der Component bereits deklariert.
Die Anbindungsoberfläche wird in jedem Geltungsbereich geprüft, in dem eine Anbindung geschrieben ist: an einer Komponente, an einem Subsystem — des Aggregate oder eines Moduls, das es importiert —, an einer Release-Boundary und an einem Komponenteneintrag des Release, einschließlich des Eintrags für eine Komponente, die ein Modul beisteuert. Die eigenen Deklarationen eines Moduls werden geprüft, sobald die Komposition, die es importiert, aufgebaut ist, und der Befund nennt das Aggregate des Moduls und den Schlüssel in seinem Dokument.
Der Block uses:einer Komponente selbst ist bewusst keine dieser Oberflächen, sodass dieser Abbruch für ihn nicht ausgelöst wird. Ein Entwickler besitzt die Topologie, die das Aggregate deklariert, und darf einen Socket nennen, den der Katalog nicht deklariert hat; schweigt der Katalog zu einem Socket, bedeutet das, dass die Verbindung nicht vorgesehen war, nicht, dass sie verboten ist. Ein solcher Socket ist zulässig, und seine Kante wird aufgebaut — was er aufgibt, sind der Selektor und der kantenbezogene Vertrag, die ein deklarierter Socket mitbringt. Ein falsch geschriebener Socket-Name ist dort daher kein Abbruch, sondern eine eigene Ad-hoc-Verbindung, und wird als Warnung gemeldet, die beide Schreibweisen nennt — siehe warnings.md „Uses-socket near-miss lint (Lint für beinahe passende uses-Sockets)“.
Ausgegebene Meldung:
unknown uses socket: name a socket the entity declares in its usesSchema — only a component’s own uses block may name one the catalog did not declare (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>") (unbekannter uses-Socket: Nennen Sie einen Socket, den die Entität in ihrem usesSchema deklariert — nur der eigene uses-Block einer Komponente darf einen nennen, den der Katalog nicht deklariert hat; mit dem Release, dem Komponenteneintrag, dem Komponententyp, dem Socket-Namen und den deklarierten Sockets)
Der Anbindungszweig nennt den Feature-Typ anstelle des Komponententyps; ein angebundenes Feature, das überhaupt kein usesSchema deklariert, meldet stattdessen, dass Deklarationen uses: dafür nicht erlaubt sind.
So beheben Sie es: Korrigieren Sie an einer Anbindung den Socket-Namen auf einen, den das angebundene Feature deklariert, oder deklarieren Sie diesen Socket im usesSchema des Feature. Korrigieren Sie an einem kantenbezogenen Release-Eintrag den Socket-Namen auf einen, den die konsumierende Component deklariert — ein Release kann keinen Socket einführen, den die Component nicht deklariert, und die Deklaration in die Katalogentität zu verlagern ist der unterstützte Weg. Deklariert die Katalogentität überhaupt kein usesSchema, akzeptiert sie auf dieser Oberfläche keine Deklarationen uses: — entfernen Sie den Block.
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)
Der Block features: eines Verbindungseintrags nennt eine Anbindung, die kein Slot des Sockets der Verbindung deklariert. Die Anbindungen, die eine Verbindung trägt, sind eine geschlossene Menge: Der Socket, über den die Verbindung verdrahtet ist, deklariert in einem featuresSchema am Eintrag im usesSchema der konsumierenden Component jeden Slot, den eine Verbindung an ihm füllen darf, und eine Anbindung unter jedem anderen Namen wird beim Laden des Builds zurückgewiesen. Ein Socket, der kein featuresSchema deklariert, lässt an seinen Verbindungen keine Anbindung zu, und ebenso wenig ein Socket, den das Aggregate nennt, ohne dass die Component ihn deklariert — ein solcher Socket deklariert keine Slots.
Die Regel gilt in beiden Dokumenten, die die Anbindungen einer Verbindung schreiben: im Verbindungseintrag des Aggregate unter dem uses: einer Komponente und im kantenbezogenen Eintrag uses: des Release. Bei einer Komponente, die ein Sub-Aggregat beisteuert, werden die Namen des Entwicklers geprüft, sobald das eigene Dokument des Sub-Aggregats gelesen wurde, und der Befund nennt die Datei dieses Dokuments und den Eintrag der Komponente darin. Die Namen des Release werden geprüft, sobald die Komposition abgeflacht ist, für jede Komponente, gegen die das Release schreibt, und der Befund nennt den eigenen Eintrag des Release — innerhalb der Boundary, in der er steht, oder unter dem Routing-Eintrag, der die Komponente eines Sub-Aggregats erreicht. Ein Release-Eintrag an einem Socket, den die Component nicht deklariert, wird vom Abbruch wegen eines nicht deklarierten Sockets weiter oben gemeldet, der die tatsächlich vorhandenen Sockets aufführt, und nicht von diesem.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann das Dokument und der Eintrag, der Name der Anbindung, die Verbindung, der Socket, die Komponente und die Slots, die der Socket deklariert — dann, was dagegen zu tun ist:
a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component. (eine Verbindung trägt eine Anbindung unter einem Namen, für den ihr Socket keinen Slot deklariert: das angegebene Aggregate, der Eintrag, die Anbindung, die Verbindung, der Socket und die Komponente, mit den Slots, die der Socket deklariert. Schreiben Sie die Anbindung unter einen der Slots, die der Socket deklariert, oder deklarieren Sie diesen Slot im featuresSchema des Sockets an der Component.)
Wo der Name eine Bearbeitung von einem Slot entfernt ist, den der Socket deklariert — ein vertauschtes, ausgelassenes, verdoppeltes oder falsches Zeichen, die Struktur, die ein Tippfehler annimmt —, wird dieser Slot direkt danach genannt, sodass die wahrscheinlich beabsichtigte Schreibweise im selben Satz steht:
a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …) (eine Verbindung trägt eine Anbindung unter einem Namen, für den ihr Socket keinen Slot deklariert: das angegebene Release und der Eintrag, der Name der Anbindung neben dem deklarierten Slot, die angegebene Verbindung, …)
Für einen solchen Namen wird kein gesonderter Hinweis ausgelöst. Im eigenen Block features: einer Komponente ist ein Name, der eine Bearbeitung von einem deklarierten Slot entfernt ist, zulässig und löst nur den Hinweis unter „An attachment name is one edit from a declared slot (Ein Anbindungsname ist eine Bearbeitung von einem deklarierten Slot entfernt)“ weiter unten aus; an einer Verbindung wird der Name zurückgewiesen, und die Zurückweisung trägt die Zuordnung selbst.
Wo der Socket keine Slots deklariert, fehlt die Liste, und die Empfehlung lautet „The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component. (Der Socket deklariert keine Slots, daher trägt keine über ihn verdrahtete Verbindung eine Anbindung: Entfernen Sie die Anbindung, oder deklarieren Sie den Slot im featuresSchema des Sockets an der Component.)“ Wo die Component den Socket überhaupt nicht deklariert, lautet sie „The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema. (Der Typ der Komponente deklariert diesen Socket nicht, daher deklariert der Socket keine Slots, und keine über ihn verdrahtete Verbindung trägt eine Anbindung: Entfernen Sie die Anbindung, oder deklarieren Sie den Socket und seinen Slot im usesSchema der Component.)“
Jede fehlerhafte Anbindung wird als eigener Befund gemeldet, sodass ein einziger Build sie alle nennt.
So beheben Sie es: Schreiben Sie die Anbindung unter einen Slot, den der Socket deklariert; oder, falls die Verbindung einen Slot braucht, den der Socket nicht hat, deklarieren Sie ihn im featuresSchema des Sockets an der Component. Bei einem Socket, den die Component nicht deklariert, deklarieren Sie den Socket und seinen Slot im usesSchema der Component, oder entfernen Sie die Anbindung.
Release retargets a developer-declared edge (Das Release ändert das Ziel einer vom Entwickler deklarierten Kante)
Ein kantenbezogener Eintrag uses: eines Release nennt ein Ziel, das sich von dem Ziel unterscheidet, das der Entwickler für denselben Socket und Alias bereits verdrahtet hat. Ein Release darf eine vom Entwickler deklarierte Kante konfigurieren (kantenbezogen infra setzen und dabei dasselbe Ziel nennen oder es weglassen) und eine Kante in einen deklarierten, aber ungebundenen Socket verdrahten, darf aber das Ziel einer vom Entwickler deklarierten Kante nicht ändern — der Entwickler besitzt die Architektur, die er verfasst hat.
Beide Ziele werden so verglichen, wie sie geschrieben wurden, nicht so, wie sie aufgelöst werden. Ein target: darf statt einer Komponenten-ID den veröffentlichten Alias eines Sub-Aggregats nennen, und dieser Alias wird zu der Komponente aufgelöst, für die das Modul ihn veröffentlicht — ein Release-Eintrag, der genau den Alias wiederholt, den der Entwickler geschrieben hat, ist also eine Konfiguration und wird akzeptiert, genau wie die Wiederholung einer einfachen Komponenten-ID.
Die Kante behält das Ziel, das der Entwickler ihr gegeben hat, ob dieser Abbruch ausgelöst wird oder nicht, und der Block infra: des Release-Eintrags wird nicht auf sie angewendet. Eine zurückgewiesene Zieländerung wird nie halb angewendet.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann das Ziel, das der Entwickler deklariert hat, das Ziel, das das Release genannt hat, und der Socket — dann, was dagegen zu tun ist:
release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (die Release-Kante ändert das Ziel einer vom Entwickler deklarierten Kante: das angegebene deklarierte Ziel, das Ziel, das das Release nennt, und der Socket, in den sie verdrahtet ist. Entfernen Sie das Ziel aus dem Release-Eintrag, um die Verbindung so zu konfigurieren, wie sie deklariert wurde, oder ändern Sie das Ziel dort, wo die Verbindung deklariert ist.)
Der Befund wird an dem verfassten Eintrag positioniert, in dem die Verbindung deklariert wurde, in dem Dokument, das sie deklariert hat. Jeder fehlerhafte Eintrag wird als eigener Befund gemeldet, sodass ein einziger Build sie alle nennt statt einen pro Lauf.
So beheben Sie es: Entfernen Sie das abweichende target aus dem Eintrag uses: des Release, um die bestehende Kante zu konfigurieren (nur kantenbezogenes infra), oder verdrahten Sie die Verbindung, falls sie tatsächlich zu einem anderen Socket gehört, über einen Socket, den der Entwickler ungebunden gelassen hat. Um das Ziel selbst zu ändern, ändern Sie es im Aggregate, wo die Topologie verfasst wird.
Release per-edge configuration has no edge to apply to (Die kantenbezogene Konfiguration des Release hat keine Kante, auf die sie angewendet werden kann)
Ein kantenbezogener Eintrag uses: eines Release setzt infra:, Anbindungen unter features: oder beides, aber an dem Konsumenten, dem Socket und dem Alias, die er nennt, existiert keine Kante, nachdem jede Kante im Build gezogen wurde.
Die zwei Dinge, die ein Release-Eintrag tun kann, sind eine Kante verdrahten und eine konfigurieren, und was er tut, entscheidet sich daran, ob er ein target: nennt. Ein Eintrag mit einem Ziel erzeugt die Kante, die er konfiguriert. Ein Eintrag ohne Ziel konfiguriert eine Kante, die bereits existieren muss — vom Entwickler im Aggregate deklariert oder von einem angebundenen Feature beigesteuert. Ein Eintrag, der kein Ziel nennt und keiner bestehenden Kante entspricht, wirkt also auf nichts: Der Block infra: und die Anbindungen darunter erreichen nie eine Ausgabe. Der Build hält an, statt Verfassen zu akzeptieren, das nichts bewirkt, denn ein erfolgreicher Build läse sich sonst als Bestätigung, dass die Infrastruktur angewendet wurde und die Verbindung trägt, was der Eintrag auf sie gelegt hat.
Der Alias ist Teil dessen, was ein Eintrag nennt, sodass ein Eintrag, der einen Alias konfiguriert, den der Entwickler nie deklariert hat, keine Kante erreicht, selbst wenn der Socket unter einem anderen Alias gebunden ist. Ebenso ein Eintrag, der eine Komponente nennt, die das Aggregate nicht deklariert.
Zwei benachbarte Bedingungen werden von ihren eigenen Abbrüchen gemeldet und nicht von diesem, weil jede Ihnen mehr zu sagen hat. Ein Socket, den das usesSchema der konsumierenden Component nicht deklariert, wird als nicht deklarierter Socket gemeldet, wobei die tatsächlich vorhandenen Sockets aufgeführt werden können. Ein target:, das keine Komponente nennt, wird als hängendes Ziel gemeldet. Eine Komponente, die ein Schalter active: ausschaltet, nimmt ihre Kanten absichtlich mit, sodass ein Eintrag, der an ihr zurückbleibt, akzeptiert wird, statt einen Abbruch auszulösen.
Jeder fehlerhafte Eintrag wird gemeldet. Ein Release mit mehreren Einträgen, die keine Kante erreichen, bricht in einem einzigen Build mit einer dieser Meldungen pro Eintrag ab, in der Reihenfolge, in der das Dokument sie deklariert, statt den ersten zu melden und den Rest dem nächsten Build zu überlassen.
Ausgegebene Meldung, wo der Eintrag eine existierende Komponente nennt. Sie trägt den Pfad zum Eintrag selbst, sodass die zu bearbeitende Zeile genannt wird und nicht die Komponente, die sie enthält:
release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (die kantenbezogene Konfiguration des Release hat keine Kante, auf die sie angewendet werden kann: das angegebene Release, der Eintrag, der Konsument, der Socket und der Alias. Geben Sie dem Eintrag ein Ziel, um die Kante zu verdrahten, oder entfernen Sie ihn: Ein Eintrag ohne Ziel konfiguriert eine Kante, die bereits existieren muss.)
Ein Release, das seine Komponenten auf oberster Ebene statt unter Boundaries nennt, trägt die Struktur, die sein Autor geschrieben hat — .spec.components.<consumer>.uses.<socket>.<alias> —, und eine Komponente, die innerhalb eines Routing-Eintrags aggregates: genannt wird, wird über diesen Eintrag benannt, unter dem lokalen Namen, den sie dort trägt.
Wo der Eintrag eine Komponente nennt, die das Aggregate nicht deklariert, stammt der Abbruch aus einer früheren Phase des Builds und lautet wie folgt, wobei er nennt, was der Eintrag setzt — infra, features oder infra and features:
release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology (die kantenbezogene Konfiguration des Release hat keine Kante, auf die sie angewendet werden kann: die angegebene Release-Kante setzt die angegebenen Blöcke auf dem angegebenen Konsumenten, der keine Komponente in der Topologie ist)
So beheben Sie es: Fügen Sie dem Eintrag ein target: hinzu, das die Kante verdrahtet und die Konfiguration auf sie anwendet; korrigieren Sie den Alias auf den, den das Aggregate für diese Verbindung deklariert hat, sodass der Eintrag die bestehende Kante konfiguriert; korrigieren Sie den Komponentennamen auf einen, den das Aggregate deklariert; oder entfernen Sie den Eintrag, wenn die Konfiguration nicht mehr gewünscht ist.
A Release attachment takes the name of a connection’s attachment (Eine Anbindung des Release übernimmt den Namen der Anbindung einer Verbindung)
Ein Release schreibt eine Anbindung unter dem Namen, den eine Anbindung an einer der Verbindungen einer Komponente trägt: dem Alias der Verbindung, einem Punkt und dem Slot, den die Anbindung füllt — gpt.credential für die Anbindung, die den Slot credential an der Verbindung gpt füllt. Die Anbindung einer Verbindung wird an ihrem Verbindungseintrag geschrieben — der Verbindung des Aggregate unter dem uses: der Komponente oder dem kantenbezogenen Eintrag uses: des Release für dieselbe Verbindung — und wird unter diesem zusammengesetzten Namen zu einer Anbindung der konsumierenden Komponente. Das Release schreibt Anbindungen in zwei weiteren Geltungsbereichen, deren Schlüssel einen Punkt enthalten dürfen, sodass der zusammengesetzte Name auch dort geschrieben werden kann:
Der eigene Block features: eines Komponenteneintrags, der an diese Komponente anbindet.
Der eigene Block features: einer Boundary, der an jede Komponente anbindet, die in dieser Boundary oder in einer darin verschachtelten Boundary platziert ist — einschließlich der Komponenten eines Sub-Aggregats, das die Boundary einroutet, ohne sie zu nennen. Ein Schlüssel dort bricht ab, wenn er dem zusammengesetzten Namen an irgendeiner Komponente entspricht, die er erreicht, ob er ein type: nennt oder nicht.
Der Build hält an, statt eines von beiden in die Anbindung der Verbindung einzufalten, denn dann zeigte keines der beiden Dokumente vollständig, was der Build damit tut. Der Slot eines Sockets wird pro Verbindung gefüllt, durch den eigenen Eintrag der Verbindung, und nie durch eine Anbindung, die aus einem weiteren Geltungsbereich auf ihn herabkaskadiert. Ein Schlüssel mit Punkt, den keine Verbindungsanbindung der Komponenten trägt, die er erreicht, ist ein gewöhnlicher Anbindungsname und wird nicht zurückgewiesen.
Die Prüfung erfasst eine Anbindung, die eines der beiden Dokumente an die Verbindung gesetzt hat, und eine Komponente, die ein Sub-Aggregat beisteuert, ebenso wie eine, die das Aggregate deklariert.
Ausgegebene Meldung, für einen Schlüssel an einem Komponenteneintrag. Zuerst kommt die Zurückweisung, dann das Release und der Komponenteneintrag, der Schlüssel, den das Release geschrieben hat, die Komponente, die Verbindung, der Socket und der Slot — dann der Verbindungseintrag, an dem er zu schreiben ist:
a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else. (eine Anbindung des Release übernimmt den Namen einer Anbindung, die eine der Verbindungen einer Komponente trägt: das angegebene Release, der Komponenteneintrag, der Schlüssel, die Komponente, die Verbindung, der Socket und der Slot. Schreiben Sie sie an den Verbindungseintrag, unter dem angegebenen Pfad, und entfernen Sie den Schlüssel aus den features dieses Eintrags: Eine Anbindung, die eine Verbindung trägt, wird an diese Verbindung geschrieben und nirgendwo sonst.)
Ausgegebene Meldung, für einen Schlüssel an einer Boundary. Sie nennt den Anbindungsblock der Boundary und die Komponente, deren Verbindung die Anbindung trägt:
a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else. (eine Anbindung des Release übernimmt den Namen einer Anbindung, die eine der Verbindungen einer Komponente trägt: das angegebene Release, der Anbindungsblock der Boundary, der Schlüssel, die Komponente, die Verbindung, der Socket und der Slot. Schreiben Sie sie an den Verbindungseintrag der angegebenen Komponente, unter dem angegebenen Pfad, und entfernen Sie den Schlüssel aus den features dieser Boundary: Eine Anbindung, die eine Verbindung trägt, wird an diese Verbindung geschrieben und nirgendwo sonst.)
Ein Schlüssel an einer Boundary, der mehrere Komponenten erreicht, deren Verbindungen den zusammengesetzten Namen tragen, wird für jede von ihnen einmal gemeldet, weil jede Verbindung eine eigene Bearbeitung ist.
Der Befund wird an dem Block positioniert, in dem der Schlüssel geschrieben wurde — dem Komponenteneintrag oder dem features: der Boundary —, weil der Schlüssel selbst einen Punkt enthält und eine Position einen solchen Schlüssel nicht adressieren kann; der Schlüssel wird stattdessen in der Meldung genannt. In einem Release, das Boundaries nennt, lautet ein Komponenteneintrag .spec.boundaries.<boundary>.components.<component>, eine Komponente, die innerhalb eines Routing-Eintrags aggregates: genannt wird, wird über diesen Eintrag benannt, unter dem lokalen Namen, den sie dort trägt, und der Block einer verschachtelten Boundary lautet .spec.boundaries.<outer>.boundaries.<inner>.features.
So beheben Sie es: Verschieben Sie die Anbindung in den Eintrag des Release für diese Verbindung — uses.<socket>.<alias>.features.<slot> unter der Komponente — und schreiben Sie dort nur infra:, um eine Anbindung zu dimensionieren, die das Aggregate deklariert, oder type: und infra: für eine, die nur das Release vornimmt; entfernen Sie dann den Schlüssel mit Punkt aus dem features: der Komponente oder der Boundary. Ein Boundary-weiter Schlüssel, der für die Verbindungen mehrerer Komponenten gedacht ist, wird einmal an jeder dieser Verbindungen geschrieben.
A Release connection attachment names no Feature type (Eine Verbindungsanbindung des Release nennt keinen Feature-Typ)
Ein kantenbezogener Eintrag uses: eines Release setzt eine Anbindung an eine Verbindung, unter einem Slot, für den das Aggregate an dieser Verbindung keine Anbindung deklariert, und nennt kein type:. Eine Anbindung, die ein Release an eine Verbindung schreibt, ist eines von zwei Dingen. Entweder dimensioniert sie eine Anbindung, die das Aggregate an derselben Verbindung bereits deklariert, und nennt keinen Typ, weil die Deklaration des Aggregate ihn nennt; oder sie ist eine Anbindung, die nur das Release vornimmt, und dann ist der Release-Eintrag der einzige Ort, aus dem ihr Feature-Typ kommen kann. Ohne einen Typ kann nichts ein FeatureRecipe für die Anbindung wählen.
Die Prüfung erfasst eine Komponente, die ein Sub-Aggregat beisteuert, ebenso wie eine, die das Aggregate deklariert. Eine Komponente, die ein Schalter active: ausgeschaltet hat, nimmt ihre Verbindungen mit, sodass ein Eintrag, der an ihr zurückbleibt, nicht geprüft wird.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann das Release und der Verbindungseintrag, der Slot, die Verbindung, der Socket und die Komponente — dann, was dagegen zu tun ist:
a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here. (eine Verbindungsanbindung des Release nennt keinen Feature-Typ, und der Typ ist für eine Anbindung erforderlich, die nur das Release vornimmt: das angegebene Release, der Verbindungseintrag, der Slot, die Verbindung, der Socket und die Komponente. Nennen Sie das Feature, das diese Anbindung anbindet, unter seinem Typ, oder deklarieren Sie die Anbindung am Verbindungseintrag des Aggregate und dimensionieren Sie sie hier.)
Jede fehlerhafte Anbindung wird als eigener Befund gemeldet, sodass ein einziger Build sie alle nennt.
So beheben Sie es: Fügen Sie ein type: hinzu, das das Feature nennt, das die Anbindung anbindet; oder, wo es Sache des Entwicklers ist, die Anbindung zu deklarieren, deklarieren Sie sie am Verbindungseintrag des Aggregate mit ihren values: und behalten Sie am Release-Eintrag nur infra:.
Component identity cannot be stamped on what it emits (Die Identität der Component kann dem, was sie ausgibt, nicht aufgeprägt werden)
Die Identität einer Komponente ist nicht nur ein Schlüssel in Ihrem Aggregate — sie ist ein Name innerhalb des Clusters. Jeder Ressource, die eine Komponente ausgibt, wird sie aufgeprägt, unter aggrega.ai/component-id und app.kubernetes.io/name, und die Arbeitslast-Synthesizer benennen das, was sie ausgeben, nach ihr. Die Identität muss also ein Name sein, den das Ziel akzeptiert, und einer, der bedeutet, was er sagt.
Ein Name, den Sie geschrieben haben, erreicht seine Ausgabe genau so, wie Sie ihn geschrieben haben, und das macht den Namen in Ihrem Aggregate zu dem Namen, nach dem Sie in Ihrem Cluster suchen können. Das ist es wert, und deshalb wird eine Identität, die das Ziel zurückweisen würde, hier gemeldet, statt stillschweigend zu etwas repariert zu werden, das Sie nie geschrieben haben.
Ein Zeichen ist die Ausnahme, und zwar eines, das Sie nicht schreiben können: der Punkt, der den Namen eines Moduls mit dem Namen einer Komponente darin verbindet. Er ist aus jedem Namen, den Sie verfassen, ausgeschlossen, gerade damit diese Verbindung eindeutig ist, und er wird aus der Identität herausgeschrieben, bevor sie aufgeprägt wird — data-layer.main-db wird als data-layer-zdmain-db aufgeprägt. Das kostet keinen Namen, den irgendjemand getippt hat, und es ist das, was es überhaupt erst ermöglicht, die Identität einer Komponente aufzuprägen, die ein importiertes Aggregate beisteuert: Ein Punkt ist kein Zeichen, das ein Service-Name akzeptiert, und innerhalb einer Cluster-Adresse trennt er einen Dienst von seinem Namespace, sodass ein Name mit Punkt, der einem Konsumenten als Host übergeben wird, zu einem anderen Dienst aufgelöst würde, statt fehlzuschlagen.
Zwei Strukturen werden zurückgewiesen.
Eine Identität, die das Präge-Alphabet nicht tragen kann. Die Identität wird in den Label-Wert geschrieben, den jede ausgegebene Ressource trägt, und dieses Alphabet lässt Buchstaben, Ziffern, -, _ und . zu und verlangt, dass der Wert mit einem Buchstaben oder einer Ziffer beginnt und endet. Die Regeln für verfasste Namen sind dem nahe, aber nicht gleich — sie erlauben einem Namen, mit - oder _ zu beginnen oder zu enden —, sodass _api und api- beide Namen sind, die Sie schreiben können, und keiner von beiden aufgeprägt werden kann.
Wie lang ein Name sein darf, wird hier nicht gefragt. Das ist Sache des Ziels, auf dem eine Komponente bereitgestellt wird, und verschiedene Ziele antworten unterschiedlich: Diese Bedingung erfasst die Strukturen, die kein Ziel tragen könnte. Ein wegen seiner Länge zurückgewiesener Name wird stattdessen von der eigenen Zurückweisung des Ziels gemeldet, die den Grund dieses Ziels und die Länge trägt, die es akzeptieren würde.
Eine Identität, die so beginnt wie eine zusammengesetzte. Ressourcen, die ein Feature ausgibt, kann kein Komponentenname aufgeprägt werden, den Sie geschrieben haben, daher setzt Aggrega für sie eine Identität aus den Teilen zusammen, die Sie geschrieben haben, hinter einem festen Präfix, das sagt, wo das Feature angebunden wurde. Wo das Feature an eine einzelne Komponente angebunden ist, wird die Identität aus dieser Komponente und dem Schlüssel zusammengesetzt, unter dem das Feature angebunden ist, und sie beginnt mit cfr--. Wo es an eine ganze Boundary angebunden ist, gilt überhaupt kein Komponentenname, daher wird die Identität aus dem Pfad der Boundary und dem Namen zusammengesetzt, unter dem das Feature angebunden ist, und sie beginnt mit bfr--. Das Präfix sagt einem Leser, aus welcher der beiden eine Ressource stammt, statt aus einer Komponente. Daher sind bfr-- und cfr-- beide am Anfang einer Komponentenidentität reserviert. Eine Komponente namens bfr--api oder cfr--api würde identisch zu einer zusammengesetzten aufgeprägt, und nichts in der erzeugten Ausgabe könnte die beiden unterscheiden. Nur das vollständige Präfix ist reserviert: Eine Komponente namens bfr, cfr, bfr-api oder bfrontend hat einen gewöhnlichen Namen, und der Build gelingt.
Die Prüfung liest die Identität, die eine Komponente tatsächlich trägt, und das ist bei einer Komponente, die ein importiertes Aggregate beisteuert, die qualifizierte — der Name des Moduls, ein Punkt und der eigene Name der Komponente. Zwei Namen, die jeder für sich akzeptabel sind, können sich daher dennoch zu einer Identität verbinden, die es nicht ist: Ein Modul namens bfr--x und eine Komponente namens y darin verbinden sich zu bfr--x.y, das so beginnt wie eine zusammengesetzte Identität. Der Abbruch nennt die verbundene Identität und zeigt dabei auf den Schlüssel, den Sie geschrieben haben.
Ausgegebene Meldung, für eine Identität, die das Ziel zurückweisen würde:
component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (die Identität der Komponente kann nicht der Name sein, der ihren ausgegebenen Ressourcen aufgeprägt wird: Benennen Sie die Komponente um; mit dem Aggregate, dem Feldpfad und der angegebenen Identität sowie der Regel, die sie erfüllen muss)
und für eine, die so beginnt wie eine zusammengesetzte Identität, wobei <opening> dasjenige der reservierten Präfixe ist, dem der Name entsprach:
component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>") (die Identität der Komponente kann nicht der Name sein, der ihren ausgegebenen Ressourcen aufgeprägt wird: Benennen Sie die Komponente um; mit dem Aggregate, dem Feldpfad und der angegebenen Identität, die nicht mit dem angegebenen reservierten Präfix beginnen darf)
So beheben Sie es: Benennen Sie die Komponente um, auf jeder Oberfläche, die sie nennt — im Aggregate, das sie deklariert, und im Release, das sie platziert und konfiguriert. Geben Sie ihr einen Namen, der mit einem Buchstaben oder einer Ziffer beginnt und endet und weder mit bfr-- noch mit cfr-- beginnt. Das Umbenennen einer Komponente ändert den Namen, den ihre Ressourcen im Cluster tragen, behandeln Sie es bei einer bereits bereitgestellten Anwendung daher wie jede andere Umbenennung einer Ressource.
The target will not accept a name derived from an authored identity (Das Ziel akzeptiert keinen von einer verfassten Identität abgeleiteten Namen)
Jedes Ziel leitet seine eigenen Namen aus der Identität einer Komponente ab: Ein Chart-Installer leitet einen Release-Namen ab, ein Container-Orchestrator leitet Dienstnamen ab. Dieser Abbruch ist das Ziel, das mitteilt, dass es einen davon nicht verwenden kann.
Aggrega hält die Benennungsregeln keines Ziels vor. Es weiß nicht, wie lang ein Name sein darf, welche Zeichen ein Ziel zulässt oder was die Grammatik eines Ziels am Anfang eines Namens verlangt — und es weiß es bewusst nicht, weil sich das je nach Ziel, nach der Art der Ressource, auf der ein Name landet, und manchmal nach einem einzelnen Dienst bei einem einzelnen Provider unterscheidet. Bevor ein Name feststeht, fragt der Compiler daher den Provider, der die Komponente rendern wird, und dieser Abbruch meldet, was der Provider antwortet. Deshalb trägt die Meldung das eigene Wort des Ziels für das, was zurückgewiesen wurde (release name, Service name), und den eigenen Grund des Ziels, statt einer in den Compiler geschriebenen Regel.
Warum der Name zurückgewiesen statt gekürzt wird. Ein Name, den Sie geschrieben haben, ist der Name, unter dem Ihre Arbeitslast bereitgestellt wird: Ihn zu kürzen würde jede Ressource in jeder bestehenden Ausgabe umbenennen, und zwar in Ihrem Namen, ohne dass Sie darum gebeten hätten. Die Person, die einen anderen Namen wählen kann, ist die Person, die diesen geschrieben hat, daher zeigt der Abbruch auf den Schlüssel spec.components, den Sie geschrieben haben, und lässt den Namen unverändert. Namen, die Aggrega selbst zusammensetzt — etwa die Identität eines Feature, das an eine ganze Boundary angebunden ist —, werden stattdessen gekürzt, weil sie aus Teilen zusammengesetzt sind, die über mehrere Dokumente hinweg geschrieben wurden, und kein einzelner Autor die Länge sehen kann, die sie erreichen.
Zwei Antworten, die ein Ziel geben kann, und sie führen an verschiedene Stellen. Wo ein kürzerer Name akzeptiert würde, nennt der Abbruch die Länge, die funktionieren würde, sodass ein neuer Name einmal statt zweimal gewählt wird. Wo keine Länge helfen würde — ein Zeichen, das die Grammatik des Ziels an der Position zurückweist, an der es gelandet ist —, wird keine Länge genannt, weil Kürzen es nicht erreichen kann. Der häufigste Fall der zweiten Art: Ein Ziel, dessen Namen nur Kleinbuchstaben enthalten dürfen, maskiert jedes Zeichen, das es nicht zulässt, und jede Maskierung beginnt mit einem Bindestrich, sodass ein Name, dessen erstes Zeichen maskiert wird, einen Namen ergibt, der mit einem Bindestrich beginnt. Ein Ziel, das dort einen Kleinbuchstaben oder eine Ziffer verlangt, weist ihn zurück, wie kurz der Rest auch sein mag. Ein Ziel kann den Anfang eines Namens auch der strengeren Regel der Ressourcen unterwerfen, die nach ihm benannt werden: Das helm-Ziel weist einen Namen zurück, der mit einer Ziffer beginnt, gemeldet als Service name, weil Helm einen solchen Release-Namen akzeptiert, während der Cluster einen danach benannten Kubernetes-Service zurückweist.
Eine dritte Form tritt nur bei einem zusammengesetzten Namen auf: Ein Ziel kann eine Länge nennen, die kürzer ist als die kürzeste Identität, die der Compiler aus den ihm übergebenen Teilen zusammensetzen kann, da eine zusammengesetzte Identität Platz für einen Diskriminator reserviert. Der Abbruch sagt das und nennt die Abhilfe — die verfassten Teile kürzen —, statt den Provider als fehlerhaft zu melden.
Manche Namen gibt es nur für die Workload, die eine Komponente rendert. Der Provider wird gefragt, sobald die Workload dieser Komponente aufgelöst ist, und die Frage enthält das form der Workload und ihre Service-Schlüssel, sodass ein Ziel auch die Namen beurteilen kann, die es daraus bildet. Beim helm-Ziel kommen dadurch zwei hinzu: ein CronJob name, höchstens 52 Zeichen und nur bei einer scheduled-Workload beurteilt, weil der Cluster den Job jedes Laufs nach dem CronJob mit angehängtem Suffix benennt; und jeder Service name, <release name>-<service key>, höchstens 63 Zeichen. Ein Service-Name wird aus Teilen zweier Autoren gebildet — Ihrem Komponentennamen und dem Schlüssel, den die Workload deklariert, im Recipe oder in einem FeatureRecipe —, daher nennt sein Grund den Schlüssel und die Stelle, an der die Workload ihn deklariert, spec.workload.services.<key>, neben dem Feld, das Sie geschrieben haben. Ein Schlüssel, der so lang ist, dass er keinem Komponentennamen Platz lässt, nennt keine Länge, innerhalb derer gewählt werden könnte, und der Grund besagt, dass der Schlüssel kürzer sein muss. Diese Namen werden bei einem Feature, das an eine ganze Boundary angebunden ist, nicht beurteilt: Seine Identität wird festgelegt, bevor seine Workload aufgelöst wird, weil davon abhängen kann, wo seine Ausgabe zusammengesetzt wird.
Ausgegebene Meldung, für eine verfasste Identität:
the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts (das Ziel akzeptiert keinen Namen, der von der verfassten Identität dieser Komponente abgeleitet ist: Benennen Sie die Komponente um (die angegebene Komponente, geschrieben am angegebenen Pfad, die das Ziel nicht als die angegebene Namensart verwenden kann, mit dem Grund des Ziels). Wählen Sie einen Namen, den das Ziel akzeptiert, mit höchstens der angegebenen Anzahl Zeichen)
So beheben Sie es: Benennen Sie die Komponente so um, dass das Ziel den Namen akzeptiert, auf jeder Oberfläche, die sie nennt — dem Aggregate, das sie deklariert, und dem Release, das sie platziert und konfiguriert. Wo die Meldung eine Länge nennt, bleiben Sie innerhalb davon. Wo nicht, lesen Sie den Grund des Ziels: Meist ist es ein Zeichen, das das Ziel nicht zulässt, und am häufigsten ein Großbuchstabe am Anfang des Namens — oder, beim helm-Ziel, eine Ziffer an dieser Stelle. Bevorzugen Sie Kleinbuchstaben und Ziffern mit Bindestrichen zwischen den Wörtern; das Kapitel zur Benennung erklärt, was ein Name bei jeder Art von Ziel kostet. Wo der Grund einen Service-Schlüssel nennt, lässt sich die Länge auch zurückgewinnen, indem dieser Schlüssel dort gekürzt wird, wo die Workload ihn deklariert — und wo der Grund besagt, dass der Schlüssel keinen Platz lässt, hilft nur das. Das Umbenennen einer Komponente ändert den Namen, den ihre Ressourcen tragen, behandeln Sie es daher bei einer bereits bereitgestellten Anwendung wie jede andere Umbenennung von Ressourcen.
Wo die Identität eine ist, die der Compiler zusammengesetzt hat, statt einer, die Sie geschrieben haben, meldet derselbe Abbruch den zusammengesetzten Wert und bittet Sie, die Teile zu kürzen, aus denen er aufgebaut wurde — den Namen, unter dem Sie ein Feature angebunden haben, und den Boundary-Pfad, an den Sie es angebunden haben.
A provider never accepted a name the compiler composed (Ein Provider hat nie einen Namen akzeptiert, den der Compiler zusammengesetzt hat)
Dieser Abbruch meldet einen Defekt in einem Plugin, nicht in etwas, das Sie geschrieben haben.
Einen zusammengesetzten Namen festzulegen ist ein Austausch: Der Compiler schlägt eine Identität vor, der Provider akzeptiert sie oder sagt, wie kurz sie sein müsste, der Compiler setzt eine kürzere zusammen, und der Provider wird erneut gefragt. Eine zweite Zurückweisung ist normal und erwartet — das Kürzen auf eine Länge kann ein Zeichen an eine Stelle bringen, an der die Grammatik dieses Ziels es nicht zulässt, und dass der Provider das sagt, ist die Art, wie ein Compiler, der die Grammatik keines Ziels kennt, und ein Provider, der sie kennt, zu einer Einigung kommen.
Nicht normal ist ein Provider, der nie etwas akzeptiert: einer, der eine Länge nennt, einen Namen dieser Länge erhält und ihn erneut zurückweist. Der Austausch ist begrenzt, und beim Erreichen der Grenze hält der Build an und nennt den Provider, statt einen Namen zu verwenden, dem der Provider nie zugestimmt hat. Ein durch Aufgeben festgelegter Name würde auf echte Ressourcen gestempelt, ohne dass irgendetwas in der Ausgabe festhielte, dass keine Einigung erzielt wurde, und die Folge träte erst beim Anwenden zutage statt in dem Build, der ihn erzeugt hat.
Ausgegebene Meldung:
provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (der Provider-Guest hat nie eine Komponentenidentität akzeptiert, die der Compiler für ihn zusammengesetzt hat (der angegebene Provider-Guest hat die angegebene Anzahl von Vorschlägen zurückgewiesen, zuletzt die angegebene Identität). Melden Sie den Defekt demjenigen, der dieses Provider-Plugin pflegt)
So beheben Sie es: Melden Sie es demjenigen, der das genannte Provider-Plugin pflegt, und zitieren Sie den letzten Vorschlag aus der Meldung. Es gibt keine Änderung beim Verfassen, die das umgeht: Der Compiler hat bereits jede Länge angeboten, nach der der Provider gefragt hat. Wenn Sie den Provider selbst pflegen, ist zu prüfen, ob ein Name, der auf eine von ihm genannte Grenze gekürzt wurde, ein Name ist, den er dann akzeptiert.
Required uses: socket not populated (Erforderlicher Socket nicht belegt)
Eine Component deklariert in ihrem usesSchema einen Socket mit der Markierung required: true, und nichts im Build verdrahtet für eine der Instanzen dieser Component eine Verbindung an diesem Socket.
Drei Oberflächen können ihn verdrahten, und der Abbruch wird nur ausgelöst, wenn alle drei leer sind. Der eigene Block uses: der Instanz im Aggregate; ein kantenbezogener Eintrag uses: eines Release, der ein target: nennt und damit die Verbindung in einen deklarierten, aber ungebundenen Socket erzeugt; und die Verbindungsmenge, die die Komposition hervorgebracht hat und die für eine Komponente einsteht, die ein importiertes Aggregate beisteuert — der Block uses: einer solchen Komponente steht im eigenen Dokument dieses Aggregate, das erst gelesen wird, sobald die Komposition zusammengesetzt ist. Weil die dritte Oberfläche als letzte vollständig ist, läuft die Prüfung, sobald die gesamte Komposition existiert, statt während die beiden verfassten Dokumente gelesen werden, und sie stellt jeder Komponente dieselbe Frage, gleich welches Dokument sie deklariert hat.
Zwei Strukturen, die so aussehen, als müssten sie den Socket belegen, tun es nicht. Ein Release-Eintrag, der kein target: nennt, konfiguriert eine Verbindung, die bereits existieren muss, statt eine zu erzeugen, und verdrahtet daher nichts (und wird, wo er infra: trägt, von seinem eigenen Abbruch weiter oben gemeldet). Und das uses: einer Feature-Anbindung nennt Sockets, die am angebundenen Feature deklariert sind, eine eigene Socket-Menge an einer eigenen Entität, sodass eine Anbindung nie einen eigenen Socket einer Component belegen kann.
Ausgegebene Meldung:
required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (erforderlicher uses-Socket nicht belegt (Component, am Pfad des Sockets, mit dem Socket-Namen, als erforderlich deklariert vom angegebenen Komponententyp))
Der Befund wird an dem Socket-Eintrag positioniert, den der Autor schreiben muss, .spec.components.<instance>.uses.<socket>. Der Instanzname darin ist der Name, den die Komponente in dem Dokument trägt, das sie deklariert, sodass der Locator bei einer Komponente, die ein importiertes Aggregate beigesteuert hat, einen Schlüssel nennt, den die eigene Datei dieses Aggregate enthält, statt des Namens mit Präfix, den die Komposition ihr gegeben hat.
Jeder nicht belegte erforderliche Socket wird gemeldet, an jeder Komponente: Ein einziger Build informiert Sie über alle statt nur über den ersten.
So beheben Sie es: Fügen Sie einen Eintrag uses: für den erforderlichen Socket hinzu und verdrahten Sie ihn mit einem Ziel, das der selector: des Sockets akzeptiert; oder verdrahten Sie ihn aus dem Release mit einem Eintrag, der ein target: nennt. Soll der Socket nicht mehr erforderlich sein, aktualisieren Sie das usesSchema der Component, um required: false zu setzen, oder entfernen Sie die Deklaration required.
Sub-aggregate nesting depth exceeded (Verschachtelungstiefe von Sub-Aggregaten überschritten)
Eine Kette von Sub-Aggregat-Importen überschreitet die maximale Verschachtelungstiefe des Compilers. Die Grenze verhindert ein unkontrolliertes Abflachen tief verschachtelter Topologien und erzwingt oberhalb eines Schwellenwerts eine architektonische Zerlegung.
Ausgegebene Meldung:
max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (maximale Verschachtelungstiefe von Sub-Aggregaten überschritten: die angegebene Tiefe am angegebenen abgeflachten Präfix.)
So beheben Sie es: Strukturieren Sie die Aggregat-Topologie um, um die Verschachtelung zu verringern. Eine so tiefe Verschachtelung deutet meist darauf hin, dass die Struktur des Aggregate die Organisationshierarchie statt der Bereitstellungstopologie widerspiegelt — erwägen Sie, Gruppen von Sub-Aggregaten zu gleichrangigen Subsystemen innerhalb eines einzigen übergeordneten Aggregate abzuflachen.
Feature type mismatch between Aggregate and Release (Nichtübereinstimmung des Feature-Typs zwischen Aggregate und Release)
Das Aggregate und das Release binden beide ein Feature mit demselben Instanznamen an, aber jedes deklariert einen anderen type:, und die Anbindung des Release erreicht die Komponente über die features: einer Boundary. Wo das Release sie stattdessen in seinem eigenen Eintrag für die Komponente schreibt, wird derselbe Konflikt früher zurückgewiesen und als E0153 gemeldet, unter „A feature attached by both the Aggregate and the Release cannot be merged (Ein sowohl vom Aggregate als auch vom Release angebundenes Feature kann nicht zusammengeführt werden)“ weiter oben.
Ausgegebene Meldung:
feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (Nichtübereinstimmung des Feature-Typs zwischen Aggregate und Release (der angegebene Knoten und die angegebene Anbindung, der bestehende Typ im Aggregate steht im Konflikt mit dem Typ im Release))
So beheben Sie es: Entfernen Sie entweder den type: aus dem Release (es erbt ihn vom Aggregate), oder ändern Sie eine Seite, sodass beide denselben Typ deklarieren. Das Release darf type: weglassen oder den Typ des Aggregate wiederholen, aber es kann keinen anderen einsetzen.
Cyclic extends on Components or Features (Zyklisches extends bei Components oder Features)
Die extends:-Kette einer Component oder die extends:-Kette eines Feature läuft in sich selbst zurück.
Ausgegebene Meldung, mit Feature anstelle von Component, wenn die Kette eines Feature diejenige ist, die einen Zyklus bildet:
cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (zyklische extends-Kette (angegebene Component, Regel extends). Die Entität erweitert die Referenz, die bereits in der Kette ist; entfernen Sie das extends an der Entität oder lassen Sie es auf eine Entität außerhalb der Kette zeigen)
So beheben Sie es: Öffnen Sie die Entität, die die Kante nennt — die bei einer Kette aus drei oder mehr Gliedern nicht die am Anfang der Meldung genannte Entität ist —, und entfernen Sie ihr extends: oder richten Sie es neu aus.
A component the composition holds is placed in no boundary (Eine Komponente, die die Komposition enthält, ist in keiner Boundary platziert)
Ein Release platziert eine Komponente auf zwei Arten in einer Boundary, und jede der beiden zählt. Es nennt die Komponente unter den components einer Boundary, adressiert über die ID, die die Komponente trägt, sobald die gesamte Komposition abgeflacht ist. Oder es routet das Modul, das die Komponente beisteuert, unter aggregates in eine Boundary, was jede Komponente, die dieses Modul enthält, auf einmal platziert.
Eine Komponente, die keines von beiden erreicht, wird außerhalb jeder Boundary gerendert, die das Release deklariert hat. Ihr Ausgabeverzeichnis, ihre sync wave, ihre Annotationen und ihr komponentenbezogenes infra kommen dann aus dem Nichts — und der Build würde sonst erfolgreich sein, die Artefakte ausgeben und nichts darüber sagen, dass die Konfiguration des Operators nie auf sie angewendet wurde. Zwei durch diese Linie getrennte Komponenten werden außerdem in verschiedene Ausgaben gerendert und verlieren die Reihenfolge, die sie haben, wenn sie zusammen platziert sind.
Zwei Strukturen fallen bewusst nicht darunter. Ein Release, das components auf oberster Ebene statt benannter Boundaries deklariert, platziert alles, was es nennt: Die Normalisierung eines solchen Release gibt ihm eine eigene Boundary, die genau diese Komponenten enthält. Und eine Komponente, deren ganzes Modul das Release nirgends platziert hat, wird stattdessen einmal gegen das Modul gemeldet, unter dem Eintrag unten — ein Fehler, eine Abhilfe, ein zu bearbeitender Schlüssel —, statt einmal pro Komponente, deren eigene Deklaration korrekt ist.
Ausgegebene Meldung. Der Wert am Ende ist die ID, die die Komponente trägt, sobald die Komposition abgeflacht ist, was bei einer Komponente, die ein Modul beigesteuert hat, der Name dieses Moduls, ein Punkt und der eigene Name der Komponente ist:
component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>") (Komponente in keiner Boundary platziert: Nennen Sie sie unter den Komponenten einer Boundary, oder platzieren Sie das Untermodul, das sie beisteuert, unter den Aggregaten (mit dem angegebenen Release, dem verfassten Schlüssel und der Komponenten-ID))
So beheben Sie es: Nennen Sie die Komponente unter den components einer Boundary und verwenden Sie genau die ID, die die Meldung zitiert — bei einer Komponente, die ein Modul beigesteuert hat, ist das die ID mit Präfix, nicht der Name, der in der eigenen Datei des Moduls steht. Oder, wo das ganze Modul in eine Boundary gehört, routen Sie es dort unter aggregates hinein und lassen Sie jede Komponente, die es enthält, auf einmal platzieren.
A sub-module’s components are placed in no boundary (Die Komponenten eines Untermoduls sind in keiner Boundary platziert)
Die modulweite Form der Regel oben: Ein Modul, das die Komposition eingebunden hat, hat Komponenten beigesteuert, und keine Boundary enthält eine davon. Es wird einmal für das Modul statt einmal pro Komponente gemeldet, weil ein nirgends platziertes Modul ein einziger Fehler beim Verfassen mit einer einzigen Abhilfe an einem einzigen Schlüssel ist — und eine Meldung pro Komponente würde Komponenten nennen, deren eigene Deklarationen völlig korrekt sind.
Die Regel liest die Platzierung statt der Schreibweise, sodass ein Modul, dessen Komponenten jeweils einzeln unter den components einer Boundary genannt sind, platziert ist und die Prüfung besteht: Es mangels eines Routing-Eintrags zurückzuweisen, würde eine Form des Verfassens ablehnen, die die Sprache zulässt. Auch ein nur teilweise platziertes Modul besteht — welche seiner Komponenten eigene Einträge tragen, ist die Frage der Komponentenregel, und alle, die es ausgelassen hat, werden dort gemeldet, jede an ihrem eigenen Schlüssel.
Ein Modul, das keine Komponenten beigesteuert hat, fällt nicht darunter: Es gibt nichts zu platzieren. Ebenso wenig eines, das ein auf false aufgelöster Schalter active: entfernt hat und das nie zusammengesetzt wurde.
Ausgegebene Meldung, positioniert am Eintrag aggregates, der das Modul deklariert hat, unter dem lokalen Namen, den das importierende Dokument geschrieben hat:
sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>") (Untermodul in keiner Boundary platziert: Routen Sie es unter den Aggregaten in eine Boundary, oder nennen Sie dort seine Komponenten unter den Komponenten (mit dem angegebenen Release, dem verfassten Schlüssel und dem Modulpfad))
So beheben Sie es: Fügen Sie unter der Boundary, in die das Modul gehört, einen Eintrag aggregates für das Modul hinzu, was jede Komponente platziert, die es beisteuert. Oder, wo seine Komponenten in verschiedene Boundaries gehören, nennen Sie jede von ihnen unter der Boundary, in die sie gehört, mit den IDs mit Präfix, die sie nach dem Abflachen tragen.
A boundary names a component the composition does not hold (Eine Boundary nennt eine Komponente, die die Komposition nicht enthält)
Das Gegenstück der beiden Regeln oben für zu viel Genanntes, und eine eigene Frage statt eines Zweigs einer der beiden: Jene fragen bei einer Komponente, ob etwas sie platziert hat, diese fragt bei einem Eintrag, den das Release geschrieben hat, ob ihm etwas entspricht. Keine impliziert die andere. Ein Release kann eine Komponente nennen, die nicht existiert, während jede existierende Komponente ordnungsgemäß platziert ist, und es kann eine echte Komponente unplatziert lassen, während jeder Eintrag, den es geschrieben hat, aufgelöst wird.
Der Eintrag, der nichts nennt, konfiguriert nichts: Sein directory, subDirectory, syncWave, seine Annotationen und sein komponentenbezogenes infra sind für eine Komponente geschrieben, die nicht da ist, sodass nichts darunter gerendert wird und der Build sonst erfolgreich wäre, während die Konfiguration des Operators stillschweigend wirkungslos bliebe.
Eine Boundary nennt eine Komponente auf zwei Arten, und beide werden geprüft. Unter components adressiert ein Eintrag die Komponente über die ID, die sie trägt, sobald die Komposition abgeflacht ist — eine Komponente, die ein Modul beisteuert, wird daher mit dem Präfix dieses Moduls vor ihrem eigenen Namen geschrieben. Innerhalb eines Routing-Eintrags aggregates adressiert ein Eintrag die Komponente über den lokalen Namen, den sie innerhalb dieses Moduls trägt, und der wird zur selben ID aufgelöst. Die Meldung zitiert die ID, die der Eintrag adressiert hat, und das ist auf der gerouteten Achse nicht der Name, den die Datei schreibt: Die Datei trägt die lokale Hälfte, und das Modul liefert den Rest.
Ein Subsystem trägt nichts zur ID einer Komponente bei, daher wird eine innerhalb eines Subsystems deklarierte Komponente über ihren bloßen Namen adressiert. Ein Eintrag, der so geschrieben ist, als wäre das Subsystem Teil der ID, adressiert nichts und fällt hierunter.
Eine Komponente, die ein auf false aufgelöster Schalter active: ausgeschaltet hat, fällt nicht darunter. Eine Komponente auszuschalten ist ein Akt des Verfassens, und vom Release, das sie konfiguriert, wird nicht erwartet, dass es in derselben Bearbeitung umgeschrieben wird — den Eintrag zurückzuweisen würde den Schalter unbrauchbar machen, solange irgendein Release die Komponente nennt.
Ausgegebene Meldung:
boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (Boundary nennt eine Komponente, die die Komposition nicht enthält: Korrigieren Sie den Namen oder entfernen Sie den Eintrag (mit dem angegebenen Release, dem verfassten Schlüssel und der adressierten ID))
So beheben Sie es: Vergleichen Sie die ID, die die Meldung zitiert, mit den Komponenten, die die Komposition tatsächlich enthält. Ein fehlendes Modulpräfix und ein in die ID geschriebener Subsystemname sind die zwei häufigen Ursachen; lassen Sie das Subsystem weg, fügen Sie das Modulpräfix hinzu oder korrigieren Sie die Schreibweise. Wo der Eintrag von einer Komponente übrig ist, die inzwischen entfernt oder umbenannt wurde, löschen Sie ihn.
A uses edge targets a component an active: toggle removed (Eine Kante zielt auf eine Komponente, die ein Schalter entfernt hat)
Das Gegenstück zum Abbruch wegen eines hängenden Ziels weiter oben, getrennt gemeldet, damit dem Autor gesagt wird, warum das Ziel fehlt. Das Ziel fehlt nicht, weil es nie deklariert wurde — es ist deklariert, und es wurde bewusst aus diesem Build entfernt, weil sein Schalter active: zu false aufgelöst wurde, und hat seine Kanten mitgenommen. Eine Komponente, die erhalten geblieben ist, hängt noch davon ab, und die Kante verschwinden zu lassen, würde die injizierten Werte dieses Konsumenten zum Zeitpunkt der Bereitstellung stillschweigend leer lassen.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann das Ziel, das der Schalter entfernt hat, und der Socket, in den die Verbindung verdrahtet wurde — dann, was dagegen zu tun ist:
uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (das Ziel der uses-Kante wurde entfernt, weil sein active-Schalter zu false aufgelöst wurde: das angegebene Ziel, verdrahtet in den angegebenen Socket. Lassen Sie den Schalter des Ziels auf true, oder entfernen Sie die Abhängigkeit davon.)
Der Befund wird an dem verfassten Eintrag positioniert, den er betrifft, an denselben Pfaden, die der Abbruch wegen eines hängenden Ziels weiter oben nennt, und jede fehlerhafte Verbindung wird gemeldet statt nur der ersten.
So beheben Sie es: Entscheiden Sie, welche der beiden in diese Umgebung gehört. Schalten Sie das Ziel wieder ein — wo sein Schalter einen Parameter liest, heißt das, den Parameter für dieses Release anzugeben. Oder stellen Sie den Konsumenten unter denselben Schalter, sodass beide gemeinsam wegfallen und keine Kante ins Leere zeigt. Oder, wo der Konsument es wirklich nicht mehr braucht, entfernen Sie die Kante aus dem Block uses: des Konsumenten.
A uses target names a module’s component the module does not export (Ein Kantenziel nennt eine Komponente eines Moduls, die das Modul nicht exportiert)
Ein Modul veröffentlicht seine Schnittstelle unter exportedComponents:, und ein Dokument, das das Modul importiert, erreicht die Komponenten des Moduls nur über diese Namen: den Namen des Moduls, einen Punkt und einen seiner Aliase. Ein Ziel in uses:, das eine Komponente innerhalb eines Moduls auf andere Weise erreicht — über den Namen der Komponente innerhalb des Moduls oder über einen Pfad durch das Modul in ein darin verschachteltes Modul —, bricht den Build ab, weil die Verbindung an etwas gebunden würde, das der Autor des Moduls nicht veröffentlicht hat und frei umbenennen oder entfernen darf. Der eigene Block uses: einer Komponente, der einer Anbindung und eine von einem Release verdrahtete Verbindung unterliegen dem gleichermaßen. In welche Module eine Verbindung hineinführt, wird daraus gelesen, wo ihr Konsument sitzt, sodass eine Verbindung zwischen zwei Komponenten eines Moduls — einschließlich eines Release, das sie miteinander verdrahtet — keine Schnittstelle überquert und nicht zurückgewiesen wird. Ein Ziel, dem keine Komponente entspricht, wird stattdessen vom Abbruch wegen eines hängenden Ziels gemeldet, sodass ein vertippter Name einmal gemeldet wird.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann das Ziel wie geschrieben, das Modul, in das es hineinführt, und die Aliase, die dieses Modul exportiert, sowie der Socket — dann, was dagegen zu tun ist:
uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (das Ziel der uses-Kante nennt eine Komponente, die ihr Modul nicht exportiert: das angegebene Ziel, das Modul, die von ihm exportierten Aliase und der Socket, in den es verdrahtet ist. Nennen Sie die Komponente über einen der exportierten Aliase des Moduls, oder führen Sie sie unter den exportierten Komponenten des Moduls auf.)
Ein Modul, das nichts exportiert, wird als "nothing" exportierend genannt. Der Befund wird an dem verfassten Eintrag in dem Dokument positioniert, das die Verbindung gezogen hat.
So beheben Sie es: Nennen Sie die Komponente über einen Alias, den das Modul exportiert — finance-db-subsystem.primary_db statt finance-db-subsystem.internal-pg-primary —, oder, wo Sie das Modul verfassen und die Komponente veröffentlichen wollen, führen Sie sie unter den exportedComponents des Moduls auf, unter ihrem eigenen Namen, wenn das der Name ist, den Importierende verwenden sollen.
An active: toggle does not resolve to true or false (Ein Schalter wird nicht zu true oder false aufgelöst)
Ein Schalter active: erreicht den Graph-Builder bereits zu einem Literal aufgelöst — einem direkt geschriebenen booleschen Wert oder einer Parameterreferenz, in die die Werte des Release eingesetzt wurden, bevor das Dokument gelesen wurde. Er wird dann strikt gelesen: Ein Literal, das kein boolescher Wert ist, stoppt den Build, statt auf irgendeinen Standardwert zurückzufallen. Die Regel ist dieselbe für den Schalter einer Komponente und für den eines Moduls.
Ein leeres Literal ist der Fall, der eine Erwähnung verdient, weil es das ist, was ein nicht erfüllter Parameter erzeugt. Ein Schalter, der {{ .parameters.<key> }} liest, wird zu nichts aufgelöst, solange dieser Parameter keinen Wert hat, und nichts als „vorhanden“ zu lesen, würde genau die Entität bereitstellen, die der Autor an den Parameter gekoppelt hat. Nur ein Schalter, den niemand geschrieben hat, gilt standardmäßig als vorhanden, und das wird aus dem Fehlen des Schalters gelesen statt aus seinem Wert — weshalb active: ohne etwas dahinter zu schreiben nicht dasselbe ist, wie den Schlüssel wegzulassen.
Ausgegebene Meldung:
active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (der active-Schalter wurde nicht zu einem booleschen Wert aufgelöst (der angegebene Knoten, active aufgelöst zum angegebenen Wert))
und, wo er zu gar nichts aufgelöst wurde, mit der Empfehlung, die die übliche Ursache nennt:
active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (der active-Schalter wurde nicht zu einem booleschen Wert aufgelöst (der angegebene Knoten, active aufgelöst zu einer leeren Zeichenkette). Ein Schalter, der einen Parameter liest, wird zu nichts aufgelöst, bis dieser Parameter erfüllt ist)
So beheben Sie es: Schreiben Sie true oder false. Wo der Schalter einen Parameter liest, geben Sie diesen Parameter im Release an, oder geben Sie ihm ein default: dort, wo er im Aggregate deklariert ist, damit jede Umgebung eine Antwort hat. Um eine Entität bedingungslos vorhanden zu machen, entfernen Sie den Schlüssel active:, statt ihn leer zu lassen.
A module a composition imports cannot be loaded, or imports itself (Ein Modul, das eine Komposition importiert, kann nicht geladen werden oder importiert sich selbst)
Ein Aggregate setzt andere Aggregates zusammen, indem es sie unter aggregates: nennt, und jedes wird der Reihe nach geladen und durchlaufen, sodass seine Komponenten in den Graphen eingehen. Zwei Dinge halten diesen Durchlauf hier an.
Das Modul kann überhaupt nicht geladen werden — die Referenz wird zu nichts aufgelöst, was der Katalog zurückgeben kann, oder das Dokument dahinter kann nicht gelesen werden. Der Grund, den der Loader angegeben hat, wird unter dem Abbruch mitgeführt, statt in ihn eingearbeitet zu werden, sodass das, was fehlgeschlagen ist, in den eigenen Worten des Loaders gemeldet wird.
Oder das Modul nennt einen Typ, der bereits in der durchlaufenen Kette steht. Ihn zu expandieren würde die Kette reproduzieren, die ihn enthält, ohne Ende. Es wird an der Stelle gemeldet, an der die Referenz die Schleife schließt, und nennt sowohl den Typ als auch, wo in der Komposition er sitzt.
Ausgegebene Meldung, für eine zirkuläre Referenz:
sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (Laden des Sub-Aggregats fehlgeschlagen (zirkuläre Sub-Aggregat-Referenz, mit dem angegebenen Modultyp und dem Pfad in der Komposition))
und für einen Ladefehler, wo der Abbruch nur aus dem Satz besteht, positioniert am Pfad des Moduls, mit dem eigenen Grund des Loaders darunter:
sub-aggregate load failed (Laden des Sub-Aggregats fehlgeschlagen)
So beheben Sie es: Lesen Sie bei einem Ladefehler den Grund unter dem Abbruch — ein Name oder eine Version, auf die der Katalog keine Antwort hat, ist der häufige Fall, und die Korrektur gehört in den Eintrag aggregates:, der ihn nennt. Brechen Sie bei einer zirkulären Referenz die Schleife auf: Der Pfad in der Meldung ist die Stelle, an der sich die Kette schließt, und eines der Module darauf muss aufhören, dasjenige zu importieren, das es importiert. Wo zwei Module wirklich die Komponenten des jeweils anderen brauchen, gehört der gemeinsame Teil in ein drittes Modul, das beide importieren.
Two instances flatten to one identifier (Zwei Instanzen werden zu einem einzigen Bezeichner abgeflacht)
Das Zusammensetzen eines Aggregate flacht jede Komponente in eine einzige Menge ab, und eine Komponente, die ein Modul beigesteuert hat, trägt den Namen dieses Moduls, einen Punkt und ihren eigenen Namen. Die Menge weigert sich, zwei Einträge unter einem einzigen Bezeichner zu halten: Der zweite würde den ersten ersetzen, und eine der beiden Komponenten würde aus der Ausgabe verschwinden, ohne dass etwas darüber gesagt würde.
Dieser Abbruch ist derjenige, der beim Zusammenführen der Komponenten eines Moduls ausgelöst wird, und die Oberfläche des Verfassens bietet die Namen nicht an, die ihn hervorrufen würden. Jede Komponente, die ein Modul beisteuert, trägt den Namen dieses Moduls vor ihrem eigenen; ein Instanzname wird aus Buchstaben, Ziffern, - und _ geschrieben, kann also den Punkt, mit dem die beiden verbunden werden, nicht enthalten, und zwei aus verschiedenen Modulnamen gebildete Bezeichner können nicht zusammentreffen. Zwei unter einem Namen importierte Module sind ein einziger doppelter Schlüssel, und das Dokument wird beim Laden zurückgewiesen. Dieser Abbruch sichert also eine Komposition ab, die auf einem anderen als dem gewöhnlichen Weg des Verfassens zusammengesetzt wurde, und wer auf einen trifft, sollte ihn melden, statt ihn zu umgehen.
flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>") (Kollision abgeflachter Knoten-IDs: Benennen Sie eine der kollidierenden Instanzen um, sodass sich ihre abgeflachten IDs unterscheiden (der angegebene Bezeichner und Pfad in der Komposition, kollidiert mit dem bestehenden Eintrag vom angegebenen anderen Beitragenden))
So beheben Sie es: Benennen Sie eine der beiden Instanzen um, die die Meldung nennt, in dem Dokument, das sie deklariert, und in jedem Release-Eintrag, der sie adressiert.
Two subsystems declare a component under one name (Zwei Subsysteme deklarieren eine Komponente unter einem einzigen Namen)
Subsysteme gruppieren die Komponenten eines Aggregate für den Leser und für das, was auf sie kaskadiert; sie qualifizieren nicht den Namen, unter dem eine Komponente antwortet. Eine unter subsystems.frontend deklarierte Komponente wird als api adressiert, nicht als frontend.api, und eine, die ein Modul beigesteuert hat, trägt den Namen dieses Moduls statt den des Subsystems. Daher können zwei Subsysteme eines Aggregate jeweils eine Komponente namens api deklarieren, und die beiden antworten dann auf denselben Bezeichner.
Das Dokument ist wohlgeformt — die beiden sind getrennte Schlüssel in getrennten Blöcken, und genau deshalb weist nichts davor es zurück —, aber nur eine Komponente kann einen Bezeichner tragen. Der Build hält an, statt die zuletzt gelesene zu behalten und so zu rendern, als wäre eine einzige Komponente deklariert worden.
Derselbe Name zweimal innerhalb eines Subsystems ist ein anderer Fehler: Das sind zwei Einträge unter einem Schlüssel, und das Dokument wird beim Lesen zurückgewiesen.
Ausgegebene Meldung:
components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>") (Komponenten in verschiedenen Subsystemen erhalten dieselbe Identität: Benennen Sie eine davon um, da ein Subsystem nichts zur Identität einer Komponente beiträgt (mit dem angegebenen Aggregate, Pfad und Bezeichner, deklariert unter den angegebenen Subsystemen))
So beheben Sie es: Benennen Sie eine der beiden Komponenten um, in dem Dokument, das sie deklariert, und in jedem Release-Eintrag, der sie adressiert. Wo die beiden wirklich dieselbe Komponente sind, die an zwei Stellen gebraucht wird, deklarieren Sie sie einmal und hängen Sie vom anderen Subsystem aus von ihr ab. Das Subsystem umzubenennen hilft nicht: Das Subsystem ist nicht Teil des Namens.
A re-published component alias points back at itself (Ein erneut veröffentlichter Komponenten-Alias verweist auf sich selbst)
Ein Modul veröffentlicht einen Teil von sich, indem es Komponenten unter Aliasen exportiert, und ein Aggregate, das es importiert, kann einen dieser Aliase unter einem eigenen Namen erneut veröffentlichen. Das Auflösen eines solchen Alias folgt der Kette der erneuten Veröffentlichungen bis zu der Komponente, die er letztlich nennt, sodass eine Kante, die auf den öffentlichen Namen zeigt, eine echte Komponente erreicht.
Eine Kette, die einen Alias erneut besucht, bevor sie eine Komponente erreicht, kommt nie an. Der Durchlauf hält an, statt ihr endlos zu folgen, und nennt die Kette, die er durchlaufen hat, sodass das Glied, das die Schleife schließt, sichtbar ist.
Nichts, was Sie schreiben können, erzeugt eine solche Kette. Der Importbaum ist azyklisch, und jedes Glied nennt etwas, das tiefer verschachtelt ist als das Glied davor, sodass eine aus Importen zusammengesetzte Kette absteigt und endet. Dieser Abbruch sichert daher eine Alias-Tabelle ab, die auf einem anderen als dem gewöhnlichen Weg des Verfassens zusammengesetzt wurde, statt einer Struktur, die ein Aggregate deklarieren kann.
Ausgegebene Meldung:
re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (der erneut exportierte Komponenten-Alias bildet einen Zyklus (mit der angegebenen Alias-Kette))
So beheben Sie es: Nichts in Ihren Dateien erzeugt ihn, und es gibt keine Änderung beim Verfassen, die ihn beseitigt. Melden Sie ihn mit dem Befehl, den Sie ausgeführt haben, und der Alias-Kette, die die Meldung nennt, denn dieses Detail zeigt, wo sich die Schleife geschlossen hat.
An Aggregate reached graph building without being normalised (Ein Aggregate hat den Graphaufbau erreicht, ohne normalisiert worden zu sein)
Ein Aggregate, das mit Komponenten auf oberster Ebene geschrieben ist, und eines, das mit benannten Subsystemen geschrieben ist, nehmen beim Lesen dieselbe Form an: Die Komponenten der obersten Ebene werden in ein Subsystem überführt, das der Compiler bereitstellt, und die oberste Ebene wird geleert. Diese Überführung ist es, die es allem Nachgelagerten erlaubt, einer einzigen Form eine einzige Frage zu stellen.
Ein Aggregate, das mit beidem befüllt beim Graphaufbau ankommt, wurde nicht durch dieses Lesen erzeugt. Die beiden Formen schließen sich dort, wo sie verfasst werden, gegenseitig aus — ein Dokument, das beide deklariert, wird beim Laden zurückgewiesen —, und die Überführung ist es, die sie danach zu einer Form macht, sodass nichts, was ein Autor schreiben kann, hierher gelangt. Dieser Abbruch sichert ein Aggregate ab, das auf einem anderen als dem gewöhnlichen Ladeweg zusammengesetzt wurde, und wer auf einen trifft, sollte ihn melden, statt ihn zu umgehen.
Seine Meldung beginnt so:
aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (Aggregat hat die Topologie ohne Normalisierung erreicht (nicht leere Wurzelkomponenten neben einem synthetisierten Standard-Subsystem))
und setzt sich mit dem Konstruktionspfad fort, den der Compiler erwartet; das ist ein Hinweis für denjenigen, der den Build debuggt, und keine Anweisung für das Verfassen.
So beheben Sie es: Nichts in Ihren Dateien erzeugt ihn, und es gibt keine Änderung beim Verfassen, die ihn beseitigt. Melden Sie ihn mit dem Befehl, den Sie ausgeführt haben.
A label-transform plugin’s patch reaches outside node labels (Der Patch eines label-transform-Plugins reicht über die Knoten-Labels hinaus)
Ein Governance-Plugin, das in einer label-transform-Rolle angebunden ist, erhält eine Projektion des Graphen — einen Eintrag pro Knoten mit den Labels dieses Knotens und den Werten, die seine Instanz deklariert, wobei jeder Wert zurückgehalten wird, den seine Component als sensibel deklariert — und gibt Patches gegen die Knoten-Labels zurück. Der Host wendet sie nur auf die Labels an und prüft dann, ob das Zurückgegebene noch diese Label-Sicht ist: dieselben Knoten, jeder nur mit Labels, jeder Label-Wert ein String.
Alles andere wird zurückgewiesen, und der Build hält an. Einen Knoten hinzuzufügen oder zu entfernen oder ein anderes Feld eines Knotens als seine Labels zu ändern, ist genau das stille Auftauchen von Infrastruktur, die niemand deklariert hat — statt also eine Änderung aufzunehmen, die die Rolle nicht abdeckt, sagt der Build, welche Eingrenzungsregel der Patch verletzt hat. Labels sind die gesamte Oberfläche der Rolle, und ein Operator, der das Plugin angebunden hat, hat so viel deklariert und nicht mehr.
Ausgegebene Meldungen. Der Patch wurde zurückgewiesen, bevor er angewendet wurde:
mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (Mutator-Patch zurückgewiesen: Der angegebene Patch lässt sich nicht als JSON-Patch-Dokument dekodieren: was der Leser nicht tun konnte) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (Mutator-Patch zurückgewiesen: Der angegebene Patch lässt sich nicht auf die Oberfläche der Knoten-Labels anwenden: was die Patch-Engine zurückgewiesen hat)
oder das Ergebnis seiner Anwendung war nicht die Sicht, die der Host übergeben hatte:
mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (Mutator-Patch zurückgewiesen: Die mutierte Knotenmenge hat ihre Größe geändert (ein Mutator darf keine Knoten hinzufügen oder entfernen)) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (Mutator-Patch zurückgewiesen: Die mutierte Knotenmenge hat den angegebenen Knoten eingeführt (ein Mutator darf keine Knoten hinzufügen)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (Mutator-Patch zurückgewiesen: Der angegebene Knoten hat ein Feld außerhalb der Labels erhalten (ein Mutator darf nur Labels berühren)) mutator patch rejected: node "<node>" lost its "labels" field (Mutator-Patch zurückgewiesen: Der angegebene Knoten hat sein Labels-Feld verloren) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (Mutator-Patch zurückgewiesen: Der angegebene Knoten trägt nach dem Patchen einen Label-Wert, der kein String ist: was der Leser gefunden hat)
So beheben Sie es: Der Fehler liegt beim Plugin, nicht bei Ihren Dokumenten. Korrigieren Sie es so, dass jede Operation, die es zurückgibt, einen Eintrag unter den labels eines Knotens adressiert und nur String-Werte setzt — ein numerischer oder boolescher Label-Wert ist der häufige Fall, da die Oberfläche nur Strings akzeptiert. Die Anbindung aus plugins.governance zu entfernen, ist der unmittelbare Weg, einen Build zu entsperren, während das Plugin korrigiert wird.
Bewusste Auslassung: Die Topologie muss nicht azyklisch sein
Aggrega lässt Zyklen in der Topologie zu: Es verlangt nicht, dass der Abhängigkeitsgraph ein gerichteter azyklischer Graph ist. Agent-zu-Agent-Architekturen, Callback-Muster und Paare mit gegenseitiger Authentifizierung erzeugen alle zyklische Kanten, und der Compiler akzeptiert sie. Die Reihenfolge zum Zeitpunkt der Bereitstellung ist Sache des Renderers (über einen Boundary-bezogenen syncWave oder ein Äquivalent), nicht des IR-Graphen.
Bei der Prüfung der Inject-Verträge
Der Compiler durchläuft jeden Block inject: — sowohl self-inject (eine Component, die in sich selbst injiziert) als auch uses-inject (Component-übergreifende Verdrahtung) — und validiert den Zustellungsvertrag gegen das Schema provides: der Ziel-Component, die Label-Partition des Feature und die Menge der deklarierten Zustellungsschlüssel. Ein Schlüssel from: an einem Block, den die eigene Komponente des Aggregate geschrieben hat, wird geprüft, sobald der Katalog aufgelöst ist, sodass er an der Zeile scheitert, die Sie geschrieben haben; einer am Block einer Komponente, die ein Modul beisteuert, wird geprüft, sobald die Komposition aufgebaut ist, die das Modul importiert, und scheitert an der Zeile im eigenen Dokument des Moduls; ein Schlüssel from: an einer Verbindung, die ein angebundenes Feature beisteuert, wird geprüft, sobald jede Oberfläche, die eine Verbindung ziehen kann, ihren Beitrag geleistet hat, was der früheste Zeitpunkt ist, zu dem eine solche Verbindung zum Prüfen existiert.
Inject from key is not in the target’s provides (Der Inject-Schlüssel ist nicht unter dem, was das Ziel bereitstellt)
Ein Eintrag inject: verweist auf einen Schlüssel from:, den die Quelle, aus der er liest, nicht veröffentlicht: das Schema provides: der Ziel-Component für den eigenen Block einer Komponente oder für eine Verbindung, und das FeatureRecipe zum angebundenen Feature für den Block inject:, den ein angebundenes Feature selbst trägt.
Die Prüfung gilt überall, wo die Verbindung geschrieben wurde. Eine Verbindung uses: erreicht die aufgebaute Topologie von mehr als einer Oberfläche des Verfassens aus — dem eigenen Block uses: einer Component und dem Block uses: eines an sie angebundenen Feature, ob diese Anbindung an der Komponente, an einem Subsystem, an einer Release-Boundary oder am Komponenteneintrag einer Release-Boundary geschrieben ist —, und derselbe falsch geschriebene Schlüssel wird an jeder von ihnen zurückgewiesen. Die Diagnose zeigt auf den Block, dessen Autor ihn geschrieben hat: auf den eigenen Eintrag uses: einer Anbindung, an der Stelle, an der die Anbindung selbst deklariert wurde, statt auf den Block uses: der konsumierenden Komponente, der bei einer beigesteuerten Verbindung überhaupt nichts enthält.
Wogegen die Referenz aufgelöst wird, hängt davon ab, wo sie steht. Ein from: eines self-inject auf Component-Ebene wird gegen das eigene provides: derselben Component aufgelöst. Ein from: an einer Verbindung uses: wird gegen das provides: der Komponente aufgelöst, auf die diese Verbindung zeigt — und wo zwei Oberflächen einen Socket und einen Alias schreiben, wird jede Verbindung gegen das Ziel aufgelöst, das sie selbst nennt, im selben Build, der das Paar zurückweist, weil es sich einen Alias teilt. Eine Component, die kein provides: deklariert, weist jede auf sie gerichtete Referenz from: zurück.
Der Block inject: an einem angebundenen Feature selbst. Ein from: dort wird gegen die Schlüssel aufgelöst, die das FeatureRecipe zu diesem Feature in seinem provides: veröffentlicht, so wie sie für die Komponente ausgewertet werden, an die das Feature angebunden ist, und es wird geprüft, wenn diese Komponente gerendert wird. Ein Schlüssel, den das FeatureRecipe nicht veröffentlicht, würde nichts in die Umgebung, die Datei oder das Argument der Komponente bringen, daher bricht der Build stattdessen ab — es sei denn, das FeatureRecipe liest die Einträge am angebundenen Feature selbst, unter .inject, in einem Template, das es gegen den Render-Kontext auswertet, der dem angebundenen Feature selbst gehört — denjenigen, der .inject trägt: seine Werte-Zuordnung, seine Arbeitslast, seine Artefakte, seine Auslassungen oder das with: oder when: eines Pipeline-Schritts, inline geschrieben oder importiert. Seine locals:, provides:, source: und assertions: tragen kein .inject, und sein injectMapping: wird gegen den Kontext der Komponente ausgewertet, sodass ein Lesen in einem davon nicht zählt. Ein solches FeatureRecipe erhält jeden Eintrag so, wie er geschrieben ist, und stellt ihn auf eigene Weise zu, daher werden seine Einträge nicht zurückgewiesen, und ein Schlüssel, den es nicht veröffentlicht, stellt über die eigene Zustellung der Komponente nichts zu und steht dem FeatureRecipe zur Verwendung zu. Ob ein FeatureRecipe .inject liest, wird anhand der Pfade entschieden, die seine Templates nennen: Ein Template, das seinen gesamten Kontext weitergibt (toJson .) oder die Einträge über eine Funktion wie index . "inject" erreicht, gilt nicht als Lesen der Einträge, und seine Einträge, die einen nicht veröffentlichten Schlüssel nennen, werden zurückgewiesen. Ein an einer Grenze angebundenes Feature, dessen FeatureRecipe einmal für diese Grenze rendert, wird gegen diese eine Auswertung geprüft; wo keine Grenze, die die Komponente enthält, eine solche erzeugt hat, gibt es nichts, wogegen seine Schlüssel geprüft werden könnten, und sie werden nicht zurückgewiesen. Ein from:, das einen veröffentlichten Schlüssel nennt, stellt wie bisher zu. Der Befund wird an dem Eintrag positioniert, den das angebundene Feature selbst trägt, in dem Dokument, das ihn geschrieben hat — zum Beispiel .spec.components.<component>.features.<attachment> im Aggregate —, und ein Eintrag, dessen Zustellungsschlüssel zusätzlich eine andere Inject-Quelle bereits hält, wird auch unter „An attachment delivers a key another inject source already claimed (Eine Anbindung stellt einen Schlüssel zu, den eine andere Inject-Quelle bereits beansprucht hat)“ gemeldet, da jeder seine eigene Korrektur braucht.
Im eigenen Block inject: einer Komponente trägt ein Eintrag value: ein Literal und wird gegen nichts aufgelöst, sodass ein Literal, das zufällig wie ein provides-Schlüssel aussieht, dort nicht zurückgewiesen wird; an einer Verbindung wird ein Eintrag value: zurückgewiesen, wie „An inject: entry on a connection carries a literal (Ein Inject-Eintrag an einer Verbindung trägt ein Literal)“ weiter unten beschreibt. Nur from: nennt einen Schlüssel.
Die eigene kantenbezogene Oberfläche uses: des Release trägt target und infra und kein inject:, sodass eine dort verdrahtete Verbindung keine Zustellung vorgibt und keinen Schlüssel from: zum Prüfen hat.
Ausgegebene Meldung, für ein from:, das am eigenen Block inject: einer Component gelesen wird. Zuerst kommt die Zurückweisung, dann der fehlerhafte Schlüssel, der Komponententyp, gegen den er aufgelöst wurde, und die deklarierten Schlüssel dieses Typs in sortierter Reihenfolge — die Alternativen, aus denen Sie wählen können:
invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>") (ungültiger Inject-Schlüssel: Der from-key muss einen provides-Schlüssel nennen, den seine Quelle veröffentlicht (mit dem angegebenen Aggregate, Pfad, from-key, Komponententyp und den deklarierten Schlüsseln))
Für ein from:, das an einer Verbindung uses: gelesen wird, steht dieselbe Zurückweisung vorn, und der Mechanismus und der Zustellungsschlüssel, unter denen der Eintrag geschrieben wurde, kommen vor dem fehlerhaften Schlüssel:
invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>") (ungültiger Inject-Schlüssel: Der from-key muss einen provides-Schlüssel nennen, den seine Quelle veröffentlicht (mit dem angegebenen Aggregate und der Verbindung, dem Mechanismus, dem Zustellungsschlüssel, dem from-key, dem Komponententyp und dem deklarierten Schlüssel))
Für ein from:, das im Block inject: gelesen wird, den ein angebundenes Feature selbst trägt, steht der fehlerhafte Schlüssel an erster Stelle, dann das in: und der Mechanismus des Eintrags, das FeatureRecipe, gegen das er aufgelöst wurde, und jeder Schlüssel, den dieses FeatureRecipe veröffentlicht, in sortierter Reihenfolge:
invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>") (ungültiger Inject-Schlüssel: Der from-key muss einen provides-Schlüssel nennen, den seine Quelle veröffentlicht (mit dem angegebenen Aggregate, Pfad, from-key, in, Mechanismus, FeatureRecipe und den veröffentlichten Schlüsseln))
Wenn das Ziel überhaupt keine Schlüssel provides: deklariert, gibt es keine Alternativen aufzuführen, sodass die Meldung nach dem Komponententyp endet — oder, im Block an einem angebundenen Feature, nach dem FeatureRecipe.
So beheben Sie es: Ändern Sie entweder den Schlüssel from: so, dass er einem der in der Meldung aufgeführten deklarierten Schlüssel entspricht, oder erweitern Sie das Schema provides: der Ziel-Component, um den benötigten Schlüssel zu deklarieren. Im Block an einem angebundenen Feature ändern Sie den Schlüssel from: in einen, den das FeatureRecipe veröffentlicht, oder — wo das FeatureRecipe Ihres ist — veröffentlichen Sie den Schlüssel in seinem provides:, oder lassen Sie es den Eintrag selbst unter .inject lesen, wenn es den Wert auf eigene Weise zustellt.
Required feature not attached (Erforderliches Feature nicht angebunden)
Die Component deklariert eine Präsenzvorgabe — eine Annotation features.aggrega.ai/requiredType.<label> —, die einen Feature-Typ nennt, der unter den Anbindungen, mit denen diese Komponenteninstanz am Ende ausgestattet ist, nicht vorhanden ist, wobei jeder Geltungsbereich zählt: die Blöcke des Aggregate auf Komponenten- und Subsystemebene, die Blöcke des Release auf Boundary- und Komponentenebene sowie die annotationsgesteuerte Expansion.
Ausgegebene Meldung:
missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>) (fehlendes erforderliches Feature: Binden Sie ein Feature des erforderlichen Typs an die Komponente an (der angegebene erforderliche Typ, verlangt vom angegebenen Komponententyp, unter dem angegebenen Anforderungs-Label))
Die drei Werte sind der Feature-Typ, den die Vorgabe verlangt — den der Satz davor bereits nennt, weshalb er ohne Beschriftung steht —, dann der Komponententyp, der die Vorgabe deklariert, und das Label, das die Vorgabe trägt, jeweils beschriftet, damit ein Leser zwei Entitätsreferenzen auseinanderhalten kann. Eine Komponente, die zwei verschiedene Typen verlangt, erzeugt zwei Meldungen, die sich unterscheiden, und zwei Komponenten, die die Vorgabe aus verschiedenen Typen deklarieren, erfahren, welcher Typ welche Forderung gestellt hat. Der Befund wird am eigenen Schlüssel der Komponente unter components: positioniert, und eine innerhalb eines Subsystems geschriebene Komponente wird zuerst unter dem Schlüssel dieses Subsystems positioniert.
Der Name, unter dem eine Anbindung geschrieben ist, spielt hier keine Rolle: Die Vorgabe fragt, ob überhaupt eine Anbindung des genannten Typs vorhanden ist. Das Binden eines Slots erfüllt sie, und ebenso eine Anbindung unter jedem anderen Namen.
So beheben Sie es: Binden Sie ein Feature des erforderlichen Typs an die Komponente im Aggregate oder im Release an, oder in einem weiteren Geltungsbereich, von dem die Komponente erbt. Soll die Component es nicht mehr verlangen, entfernen Sie die Vorgabe-Annotation aus ihrer Katalogdeklaration.
Die Deklaration einer Präsenzvorgabe kann nicht ausgewertet werden. Ein Annotationswert ist ein opaker String, daher validiert nichts seine Form, bevor der Compiler ihn liest: Ein Wert, der keine Feature-Typ-URI ist, oder ein Schlüssel, der die Vorgabenfamilie ohne ein Label nach dem Präfix nennt, wird als fehlerhafte Deklaration gemeldet statt als nicht erfüllte Anforderung — ein Tippfehler darf nie als erfüllte Anforderung gelesen werden.
Ausgegebene Meldungen:
malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity. (fehlerhafte Anbindungsanforderung (der angegebene Schlüssel, deklariert vom angegebenen Komponententyp, der nicht ausgewertet werden kann, weil der Wert eine Feature-Typ-URI der Form Herausgeber/Name in kleingeschriebenen Kebab-Segmenten sein muss, wie im angegebenen Beispiel). Korrigieren Sie diese Annotation an der Katalogentität des Komponententyps.)
malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity. (fehlerhafte Anbindungsanforderung (der angegebene Schlüssel, deklariert vom angegebenen Komponententyp, der nicht ausgewertet werden kann, weil der Schlüssel ein Label braucht, das die Anforderung nennt, wie im angegebenen Beispiel). Korrigieren Sie diese Annotation an der Katalogentität des Komponententyps.)
Die Meldung beginnt mit dem Annotationsschlüssel — der Deklaration, um die es beim Abbruch geht — und nennt danach den Komponententyp, dessen Deklaration fehlerhaft ist, sodass sie die zu korrigierende Entität nennt, obwohl der Befund an der Komponenteninstanz positioniert ist, die diesen Typ verwendet: An der Instanz sehen Sie ihn, und an der Katalogentität liegt die Abhilfe.
Dieser Abbruch wird ausgelöst, sobald die Komposition zusammengesetzt ist, also früher als jede Prüfung, die den fertigen Graphen liest. Ein Build mit einer fehlerhaften Vorgabe meldet sie daher für sich allein: Die Prüfungen, die später liefen, werden nicht erreicht, weil sie über das urteilen, was die Deklaration sagt, und die Deklaration nicht gelesen werden kann. Korrigieren Sie sie und bauen Sie neu, um den Rest zu sehen.
So beheben Sie es: Korrigieren Sie die Katalogentität der Component. Die Abhilfe liegt im Katalog, nicht im Aggregate — deshalb unterscheidet sich dieser Abbruch von „Required feature not attached (Erforderliches Feature nicht angebunden)“, wo Ihre eigenen Dokumente geändert werden müssen.
Required attachment slot not bound (Erforderlicher Anbindungs-Slot nicht gebunden)
Eine Katalogentität deklariert in ihrem featuresSchema einen Anbindungs-Slot mit required: true, und nichts bindet den Namen dieses Slots an einer Instanz der Entität. Die Prüfung läuft gegen die Anbindungen, mit denen die Instanz am Ende ausgestattet ist, nachdem alle Geltungsbereiche zusammengeführt wurden — die Blöcke features: des Aggregate auf Komponenten- und Subsystemebene, die Blöcke des Release auf Boundary- und Komponentenebene sowie Anbindungen, die durch annotationsgesteuerte Expansion entstehen —, sodass eine Anmeldeinformation, die einmal in einem Geltungsbereich angebunden wurde, von dem die Instanz erbt, den Slot genauso bindet wie eine an der Instanz verfasste Füllung.
Ausgegebene Meldung:
required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it. (erforderlicher Anbindungs-Slot nicht gefüllt (der angegebene Slot, als erforderlich deklariert vom angegebenen Komponententyp). Binden Sie ein Feature unter diesem Namen an, im Aggregate oder im Release, an der Komponente oder in einem Geltungsbereich darüber.)
Die beiden Werte sind der eigene Name des Slots und der Komponententyp, der ihn deklariert, sodass eine Instanz, die zwei Slots ungebunden lässt, zwei Meldungen erzeugt, die sich unterscheiden. Der Befund wird am Schlüssel des Slots unter dem Block features: der Komponente im Aggregate positioniert; weil genau dieser Schlüssel fehlt, setzt ein Editor ihn auf den nächstgelegenen Schlüssel, der existiert — den Block features:, wo die Komponente einen schreibt, und die Komponente selbst, wo nicht. Nichts hat die fehlende Anbindung geschrieben, daher wird kein Autor eines Dokuments dadurch herausgegriffen: Der Befund bleibt an der Komponente und wird als Entwicklerfehler eingeordnet, und die Abhilfe nennt beide Dokumente, weil jedes von beiden den Slot füllen kann — das Aggregate an der Komponente oder an einem Subsystem, das sie enthält, das Release an seinem Eintrag für die Komponente oder an einer Boundary, die sie enthält.
Ein Slot, den ein Socket deklariert — im featuresSchema eines Eintrags in usesSchema —, wird von jeder über den Socket verdrahteten Verbindung verlangt statt von der Komponente: Jede Verbindung füllt ihn für sich, an ihrem eigenen Eintrag im Aggregate oder im Release, und kein Geltungsbereich darüber erreicht ihn. Ein Socket mit zwei Verbindungen, von denen eine den Slot füllt, meldet also nur die andere und nennt sie:
required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release. (erforderlicher Anbindungs-Slot nicht gefüllt (der angegebene Slot, als erforderlich deklariert vom angegebenen Socket des angegebenen Komponententyps, von der angegebenen Verbindung ungefüllt gelassen). Binden Sie ein Feature unter diesem Slot in den Features dieser Verbindung an, an ihrem Eintrag im Aggregate oder im Release.)
Dieser Befund wird am Eintrag der Verbindung in dem Dokument positioniert, das die Verbindung gezogen hat — dem Eintrag uses: des Aggregate oder dem kantenbezogenen Eintrag des Release für eine Verbindung, die das Release verdrahtet hat. Eine Verbindung, die ein angebundenes Feature zieht, wird in einen Socket verdrahtet, den das Feature deklariert, nicht in einen der Komponente, daher ist es nicht ihre Sache, die Socket-Slots der Komponente zu füllen.
So beheben Sie es: Binden Sie ein Feature unter dem Namen des Slots an, im Aggregate oder im Release — an der Komponente oder in einem weiteren Geltungsbereich, den jeder Konsument des Slots teilt; bei einem Socket-Slot an der Verbindung, die der Befund nennt. Eine Anbindung unter einem anderen Namen bindet den Slot nicht: Ein Slot ist ein benannter Bindungspunkt, also ist der Name die Bindung. Soll der Slot nicht mehr erforderlich sein, aktualisieren Sie das featuresSchema der Katalogentität — das der Komponente selbst oder das des Sockets —, um die Deklaration required zu entfernen.
Two Features declared to conflict reach one component (Zwei als widersprüchlich deklarierte Features erreichen eine Komponente)
Das Feld interoperability.conflictsWith eines Feature nennt die Features, neben denen es nicht angebunden werden kann, und eine Komponente trägt am Ende das Feature und eines, das es nennt. Die Prüfung läuft gegen die Anbindungen, mit denen die Komponente am Ende ausgestattet ist, nachdem alle Geltungsbereiche zusammengeführt wurden — die Blöcke features: des Aggregate auf Komponenten- und Subsystemebene, die Blöcke des Release auf Boundary-Ebene (jede Boundary, in der die Komponente liegt, verschachtelte eingeschlossen) und seine Einträge auf Komponentenebene sowie Anbindungen, die durch annotationsgesteuerte Expansion entstehen. Ein Paar führt also zum Abbruch, wenn beide an der Komponente geschrieben sind, wenn eines an einer Boundary oder einem Subsystem steht, das sie enthält, oder wenn eines an einer äußeren Boundary und das andere an einer darin verschachtelten Boundary sitzt. Zwei Features, die an benachbarte Boundaries angebunden sind, die keine Komponente teilen, treffen nie aufeinander, und eine Boundary, die keine Komponente enthält, erreicht nichts, sodass keiner der beiden Fälle zum Abbruch führt.
Eine Deklaration genügt: Der Abbruch wird ausgelöst, wenn die Liste eines der beiden Feature das andere nennt. Namen werden auf beiden Seiten ohne eine etwaige Version verglichen, sodass ein Eintrag jede Version des Feature trifft, das er nennt. Der Compiler vergleicht die Namen, die der Autor des Feature deklariert hat, mit den Features, die die Komponente trägt, und liest in keines von beiden mehr hinein.
Ausgegebene Meldung:
a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component. (ein Feature erreicht eine Komponente zusammen mit einem Feature, mit dem es einen Konflikt deklariert (das angegebene Feature, angebunden im Release an der angegebenen Boundary, steht im Konflikt mit dem anderen angegebenen Feature, angebunden im Aggregate an der angegebenen Komponente, an der angegebenen Komponente). Binden Sie nur eines der beiden dort an, wo sie aufeinandertreffen: Entfernen Sie eine Anbindung, oder verschieben Sie sie in einen Geltungsbereich, der diese Komponente nicht enthält.)
Der erste Wert ist das Feature, dessen Liste das andere nennt — dasjenige, das der Satz davor nennt —, und jede Stelle, an der es angebunden wurde, folgt ihm; dann das Feature, mit dem es im Konflikt steht, und jede Stelle, an der dieses angebunden wurde; und zuletzt die Komponente, an der sie aufeinandertreffen. Jede Stelle wird in den Worten des Dokuments ausgedrückt, das Sie öffnen würden, um sie zu ändern: attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary (der Pfad einer verschachtelten Boundary verbindet ihre Ebenen mit /), attached in the Release on the entry for component gefolgt von in boundary, oder attached by annotation-driven expansion of mit der Annotation, gefolgt von declared at mit der Stelle, an der sie geschrieben wurde. Eine an einer Verbindung geschriebene Anbindung wird als Eintrag dieser Verbindung ausgedrückt, da dieser Eintrag und nicht der eigene Block der Komponente der Ort ist, an dem sie bearbeitet wird: attached in the Aggregate on the connection gefolgt von through socket und of component, oder attached in the Release on the connection gefolgt von through socket, of the entry for component und in boundary. Ein an zwei Stellen angebundenes Feature führt beide auf. Der Befund wird am eigenen Schlüssel der Komponente unter components: positioniert, und ein Paar, das an mehreren Komponenten aufeinandertrifft, wird für jede von ihnen einmal gemeldet, in der Reihenfolge, in der das Aggregate die Komponenten deklariert.
So beheben Sie es: Binden Sie nur eines der beiden dort an, wo sie aufeinandertreffen — entfernen Sie eine der Anbindungen, oder verschieben Sie eine in einen Geltungsbereich, der diese Komponente nicht enthält, etwa eine benachbarte Boundary. Wo die Anbindung aus der annotationsgesteuerten Expansion stammt, ist die Annotation zu ändern, nicht der Block, auf den sie expandiert wurde. Dürfen die beiden Features tatsächlich kombiniert werden, ist die Deklaration falsch: Entfernen Sie das andere Feature aus der Liste conflictsWith an der Katalogentität des deklarierenden Feature.
Attachment does not conform to its declared slot shape (Anbindung entspricht nicht der deklarierten Form ihres Slots)
Eine Anbindung bindet einen deklarierten Slot, entspricht aber nicht der Form, die dieser Slot deklariert. Der häufige Fall ist die Zustellung: Die Allowlist inject eines Slots nennt die Mechanismen, über die eine Füllung ihr Material zustellen darf, und eine leere Allowlist ist Blackbox — das Recipe stellt das Material intern zu, und eine Füllung darf überhaupt keine Zustellung vorgeben. Ein leerer Block inject: {} gibt keine Zustellung vor, entspricht also der Form jedes Slots, eine leere Allowlist eingeschlossen, und erhält dasselbe Urteil, wo auch immer die Anbindung geschrieben ist: auf einer Komponente, die das Aggregate deklariert, auf einer Komponente, die ein importiertes Modul beisteuert, oder auf einer breiteren Ebene. Eine Anbindung unter einem Namen, den kein Slot deklariert, ist eine freie Anbindung und unterliegt keiner Slot-Einschränkung.
Ausgegebene Meldung, wenn die Anbindung eine Zustellung vorgibt, die ihr Slot nicht akzeptiert — der Slot, dann der Mechanismus, dann jeder Mechanismus, den die Allowlist inject des Slots akzeptiert, in der Reihenfolge, in der der Slot sie deklariert (bei einer leeren Allowlist folgt keiner):
attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (Anbindung entspricht nicht der deklarierten Form ihres Slots (mit dem angegebenen Aggregate, Pfad, Slot, Mechanismus und zulässigen Mechanismus))
Eine Komponente, die ein importiertes Modul beisteuert, wird geprüft, sobald die Komposition aufgebaut ist, die es importiert, und meldet in einer zweiten Form. Sie nennt das Aggregate des Moduls und den Schlüssel im Dokument des Moduls, den der Slot nicht deklariert — einen Mechanismus unter dem Block inject: der Anbindung oder den Block inject: selbst, wenn er bei einem Slot, dessen Allowlist leer ist, irgendeinen Mechanismus nennt:
attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>) (Anbindung entspricht nicht der deklarierten Form ihres Slots (mit dem angegebenen Aggregate und Pfad, Anbindung entspricht nicht der deklarierten Slot-Form: Dieser Schlüssel ist nicht Teil der Deklaration des Slots — die angegebene Abhilfe))
wobei <remedy> vom Schlüssel abhängt:
remove it, für einen Block inject:, der bei einem Slot, dessen Allowlist leer ist, einen Mechanismus nennt;
remove it, or add it to the slot's inject allowlist in the entity's featuresSchema, für einen Mechanismus, den die Allowlist eines Slots nennen kann — env, file oder arg;
remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg, für jeden anderen Mechanismus, den kein Slot deklarieren kann.
Eine Anbindung, die in einem weiteren Geltungsbereich deklariert ist — subsystemweit, kaskadierend auf jede Komponente darunter —, unterliegt derselben Form und wird gegen den Slot an jeder Komponente geprüft, die sie erreicht. Dieselbe Anbindung kann daher für eine Komponente der Form entsprechen und für eine andere nicht, weshalb diese Form die Komponente und den Slot nennt, an dem sie gescheitert ist, und die Anbindung in dem Geltungsbereich verortet, in dem sie deklariert wurde, statt an einem Schlüssel in ihrem Zustellungsblock:
attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it) (Anbindung entspricht nicht der deklarierten Form ihres Slots (mit dem angegebenen Aggregate und Pfad, diese Anbindung ist in einem Geltungsbereich deklariert, der die angegebene Komponente erreicht, deren angegebener Anbindungs-Slot die Zustellung, die sie trägt, nicht akzeptiert: Verschieben Sie die Anbindung nach unten auf die Komponenten, die sie empfangen dürfen))
Eine Anbindung, die eine Verbindung trägt, erreicht diesen Abbruch nie. Ihre Form ist dort geschlossen, wo sie geschrieben wird: Am Verbindungseintrag des Aggregate nimmt sie type, description und values an, und an dem des Release type, description und infra, sodass sie überhaupt keine Zustellung vorgeben kann — ein dort geschriebenes inject: wird beim Laden des Dokuments unter Nennung des Schlüssels zurückgewiesen —, und der Workload-Eintrag, der sie zustellt, unterliegt stattdessen der Allowlist inject des Socket-Slots. Auch erreicht kein Geltungsbereich den Slot eines Sockets, sodass die oben beschriebene geltungsbereichsweite Form an einer Verbindung kein Gegenstück hat.
So beheben Sie es: Die Formen verlangen zwei verschiedene Änderungen, und der Feldpfad sagt Ihnen, welche Sie vor sich haben. Wo er eine Anbindung an einer Komponente nennt oder einen Schlüssel darin, liegt der Fehler in der Zustellung: Entfernen Sie sie, oder verschieben Sie ihre Einträge unter einen Mechanismus, den die Allowlist inject des Slots nennt. Wo das Material die Arbeitslast tatsächlich über einen Mechanismus erreichen soll, den der Slot nicht aufführt, kann die Allowlist im featuresSchema der Katalogentität erweitert werden — aber nur um env, file oder arg, die Mechanismen, die ein Slot deklarieren kann; eine Component, die dort einen anderen Mechanismus nennt, besteht die Validierung beim Laden nicht, sodass bei jedem anderen Mechanismus das Entfernen die einzige Lösung ist. Wo er eine Anbindung in einem Geltungsbereich nennt, ist die Anbindung wohlgeformt und ihre Platzierung der Fehler: Verschieben Sie sie nach unten auf die Komponenten, deren Slot die Zustellung akzeptiert, und lassen Sie die Komponenten außerhalb ihrer Reichweite, die die Zustellung ihrem Recipe vorbehalten.
Duplicate delivery key across inject sources (Doppelter Zustellungsschlüssel über Inject-Quellen hinweg)
Derselbe Zustellungsschlüssel (zum Beispiel derselbe Name einer Umgebungsvariable) wird unter den vom Entwickler verfassten Inject-Quellen einer Komponente zweimal beansprucht — auf Component-Ebene und unter einem Eintrag uses[], durch zwei Einträge uses[] an derselben Komponente oder unter zwei Zustellungsmechanismen des eigenen Blocks inject: der Component. Die Zustellung kann nicht gleichzeitig von zwei Stellen kommen, daher ist ein zweimal beanspruchter Schlüssel ein Widerspruch und keine Frage, welcher gewinnt.
Der Build liest dies an vier Stellen, weil sie unterschiedliche Mengen verfasster Quellen und Abhängigkeitsverbindungen sehen und ihnen unterschiedliche Fragen stellen, und jede meldet in ihrer eigenen Form.
Die erste liest die Verbindungen, die Sie im Aggregate geschrieben haben, und meldet, während Ihre Dateien aufgelöst werden. Sie nennt den Zustellungsmechanismus, den Schlüssel und dann den Socket und den Alias der ersten Verbindung in Schreibreihenfolge, die ihn ebenfalls beansprucht:
duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (doppelter Zustellungsschlüssel über Inject-Quellen hinweg (mit dem angegebenen Aggregate, Pfad, Mechanismus, Schlüssel, Socket und Alias))
Die zweite liest denselben verfassten Block und stellt ihm eine andere Frage: ob die Komponente einen Schlüssel unter zwei ihrer eigenen Zustellungsmechanismen beansprucht, ganz ohne beteiligte Verbindung. Sie meldet einmal pro Mechanismus, der den Schlüssel beansprucht, positioniert am eigenen Eintrag dieses Mechanismus, und nennt den Mechanismus, um den es im Befund geht, den Schlüssel und dann jeden anderen Mechanismus, der ihn beansprucht, in Schreibreihenfolge:
duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (doppelter Zustellungsschlüssel über Inject-Quellen hinweg (mit dem angegebenen Aggregate, Pfad, Mechanismus, Schlüssel und anderen Mechanismus))
Keiner der beiden Mechanismen ist der Verursacher, und beide Befunde liegen bei Ihnen: Benennen Sie den Schlüssel unter einem von ihnen um, oder lassen Sie eine der beiden Zustellungen weg. Welche Mechanismen eine Komponente überhaupt verwenden darf, ist eine eigene Frage, die ihre Allowlist spec.inject beantwortet — siehe „Self-inject mechanism not in the component’s allowlist (Self-inject-Mechanismus nicht in der Allowlist der Komponente)“ weiter unten.
Auch eine Komponente, die ein Modul beisteuert, trifft auf diese ersten beiden Formen, gelesen aus dem eigenen Dokument des Moduls, sobald die Komposition aufgebaut ist, die es importiert; sie nennen dann das Aggregate des Moduls und den Schlüssel in seinem Dokument.
Die dritte liest die Verbindungen, die die fertige Topologie trägt, einschließlich derer, die eine Feature-Anbindung in Ihrem Namen beigesteuert hat. Sie läuft, bevor irgendetwas gerendert wird, und nennt den Zustellungsschlüssel, den Sie geschrieben haben, zusammen mit dem Abhängigkeits-Socket, der ihn ebenfalls zustellt:
duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (doppelter Zustellungsschlüssel über self-inject und uses-inject hinweg (der angegebene Schlüssel, der angegebene Socket))
Ein verfasster Schlüssel, der über zwei Abhängigkeits-Sockets zugestellt wird, wird einmal pro Socket gemeldet, sodass ein einziger Build Ihnen alle nennt statt nur den, der zuerst erreicht wurde.
Die vierte liest dieselbe fertige Topologie und stellt ihr eine andere Frage: ob zwei der eigenen Abhängigkeitsverbindungen einer Komponente untereinander einen Schlüssel zustellen, ohne dass die Komponente selbst etwas beansprucht. Sie meldet einmal an jeder Verbindung, positioniert am eigenen Zustellungseintrag dieser Verbindung, und nennt den Pfad des Eintrags, gefolgt von jedem Socket, der den Schlüssel zustellt:
duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (doppelter Zustellungsschlüssel über Inject-Quellen hinweg (mit dem angegebenen Pfad des Eintrags und den angegebenen Sockets))
Ein zweimal genannter Socket zeigt Ihnen, dass die beiden Verbindungen unter verschiedenen Aliasen an einem Socket sitzen — dort ist die Position das Einzige, was sie unterscheidet; lesen Sie also den Feldpfad jedes der beiden Befunde statt der Socket-Namen.
Keine der beiden Verbindungen ist der Verursacher, und beide liegen bei Ihnen: Benennen Sie einen der Schlüssel um, oder lassen Sie eine der beiden Zustellungen weg.
Wo der Schlüssel ein Pfad ist, nennt der Feldpfad stattdessen den Block des Mechanismus. Was ein Zustellungsschlüssel ausdrückt, ist Sache des Mechanismus selbst, und ein Mechanismus file stellt in einen Mount-Pfad zu — ein solcher Schlüssel enthält also Punkte, während ein Feldpfad seine eigenen Schritte damit trennt. Ein Feldpfad endet beim letzten Schritt, den er eindeutig nennen kann, statt einen auszuschreiben, der sich wie ein Gang durch Schlüssel lesen würde, die Ihr Dokument nicht enthält; für einen Schlüssel wie /etc/app/config.yaml lautet er also .spec.components.<component>.inject.<mechanism> und endet dort. Die Meldung nennt den Schlüssel in jedem Fall, und das hält den Befund gleichermaßen umsetzbar — wo in der Meldung er zu lesen ist, unterscheidet sich jedoch zwischen den vier obigen Formen; lesen Sie also den Feldpfad für den Block und nehmen Sie den Schlüssel dann aus derjenigen der vier, die Sie vor sich haben: Wo das Detail mit dem Zustellungsmechanismus beginnt, ist der Schlüssel der direkt darauf folgende Wert in Anführungszeichen; wo das Detail mit dem Schlüssel allein beginnt, ist er der erste Wert in Anführungszeichen; und wo das Detail mit dem eigenen Pfad des Zustellungseintrags beginnt, ist der Schlüssel der letzte Schritt dieses Pfads.
So beheben Sie es: Benennen Sie einen der in Konflikt stehenden Schlüssel um, oder entfernen Sie die doppelte Deklaration. Beachten Sie, dass ein injectMapping eines FeatureRecipe, das einen Schlüssel umschreibt, den der eigene Block inject: der Komponente oder einer der Blöcke inject: ihrer Verbindungen zugestellt hat, ein beabsichtigtes Abfangen ist und weder hier noch anderswo gemeldet wird.
Ein Schlüssel, den ein an die Komponente angebundenes Feature beansprucht, trifft von der dritten seiner drei Oberflächen des Verfassens aus auf denselben gemeinsamen Raum und wird unter „An attachment delivers a key another inject source already claimed (Eine Anbindung stellt einen Schlüssel zu, den eine andere Inject-Quelle bereits beansprucht hat)“ weiter unten gemeldet; ein Schlüssel, den zwei angebundene Features zustellen, wobei das spätere der beiden ihn über das injectMapping seines FeatureRecipe zustellt, wird unter „Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Zwei angebundene Features stellen einen Schlüssel zu, das spätere über das injectMapping seines FeatureRecipe)“ gemeldet.
Self-inject on a component without an allowlist (Self-inject an einer Komponente ohne Allowlist)
Der Entwickler hat einen Block inject: auf Komponentenebene geschrieben, aber die Katalogentität der Component deklariert kein spec.inject. Components ohne eine Allowlist spec.inject sind Black-Box-Typen — sie erhalten keine vom Entwickler verfasste Injektion.
Ausgegebene Meldung:
self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (self-inject an einer Komponente ohne Allowlist spec.inject (mit dem angegebenen Aggregate, Pfad, Schlüssel inject und Komponententyp))
Der Befund wird am Block inject: selbst positioniert, dem zu entfernenden Element.
So beheben Sie es: Entfernen Sie den Block inject: aus dieser Component-Instanz, oder wechseln Sie zu einem White-Box-Component-Typ, dessen Katalogdeklaration spec.inject enthält.
Self-inject mechanism not in the component’s allowlist (Self-inject-Mechanismus nicht in der Allowlist der Komponente)
Der Entwickler hat einen Block inject: auf Komponentenebene geschrieben, der einen Mechanismus verwendet (zum Beispiel env oder eine bestimmte Form der Dateieinbindung), der nicht in der Allowlist spec.inject der Component aufgeführt ist.
Ausgegebene Meldung:
self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …) (self-inject an einer Komponente ohne Allowlist spec.inject (mit dem angegebenen Aggregate, Pfad, Komponententyp, Mechanismus und den zugelassenen Mechanismen))
Die Mechanismen, die der Typ zulässt, folgen auf den vorgegebenen, sodass die Meldung sowohl das Geschriebene als auch das vom Typ Erlaubte enthält. Ein Typ, der überhaupt keine Allowlist deklariert, meldet den vorgegebenen Mechanismus ohne etwas danach.
Sowohl diese Regel als auch die obige gelten für eine Komponente, die ein Modul beisteuert, sobald die Komposition aufgebaut ist, die das Modul importiert; der Befund nennt dann das Aggregate des Moduls und den Schlüssel in seinem Dokument.
So beheben Sie es: Wechseln Sie zu einem Mechanismus aus der Allowlist, oder erweitern Sie, falls die Component den benötigten Mechanismus unterstützen soll, ihre Allowlist spec.inject im Katalog.
uses edge dictates delivery on a socket that allowlists none (Eine Kante gibt die Zustellung an einem Socket vor, der keinen Mechanismus zulässt)
Ein Block inject: an einer Kante uses: verdrahtet in einen Socket, dessen Eintrag in usesSchema keine Allowlist inject: deklariert oder eine leere deklariert. Ein solcher Socket ist eine Black-Box-Verbindung: Die Entität, die ihn deklariert hat, verarbeitet die Werte der Abhängigkeit intern, sodass der Konsument das übernimmt, was die Recipe des Produzenten ausgibt, und die Zustellungsform nicht wählt. Ein fehlender Schlüssel inject: und inject: [] sind dieselbe Deklaration.
Der Socket wird an derjenigen Entität gelesen, die ihn deklariert hat: Eine an einer Feature-Anbindung verfasste Kante wird gegen das usesSchema des angebundenen Feature aufgelöst, und jede andere Kante gegen das der konsumierenden Component.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann die Mechanismen, die die Kante vorgegeben hat, der Socket und die Entität, deren Deklaration gelesen wurde — dann, was dagegen zu tun ist:
uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (das inject der uses-Kante gibt einen Zustellungsmechanismus vor, den der Socket nicht zulässt (der angegebene Mechanismus, am angegebenen Socket, deklariert am angegebenen Komponententyp). Der Socket deklariert keine Zustellungs-Allowlist, daher lässt er überhaupt keine Vorgabe zu — die Entität, die ihn deklariert hat, stellt die Werte der Abhängigkeit selbst zu. Entfernen Sie den inject-Block von dieser Verbindung und lesen Sie die Werte aus den provides der Verbindung in der konsumierenden Recipe, oder deklarieren Sie die Mechanismen, die der Socket zulässt, in seinem usesSchema-Eintrag.)
Der Befund wird am verfassten Eintrag positioniert, um den es geht, in dem Dokument, in dem dieser Eintrag geschrieben wurde: .spec.components.<consumer>.uses.<socket>.<alias> für eine Kante, die der eigene Block uses: einer Komponente gezogen hat, und .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> für eine, die eine Anbindung gezogen hat — verankert an dem Block, der die Anbindung deklariert hat, was der eines Subsystems oder einer Boundary statt der eigene der Komponente sein kann. Wo der Socket am angebundenen Feature deklariert wurde, nennt die Meldung den Feature-Typ anstelle des Komponententyps. Jede fehlerhafte Kante wird als eigener Befund gemeldet, sodass ein einziger Build sie alle nennt.
So beheben Sie es: Entfernen Sie den Block inject: von der Kante und lesen Sie die Werte der Abhängigkeit stattdessen aus .context.uses.<alias>.provides.<name> in der konsumierenden Recipe; oder, wenn die Verbindung transparent sein soll, deklarieren Sie die Zustellungsmechanismen, die der Socket zulässt, in der Allowlist inject: seines Eintrags in usesSchema.
Ein Socket, den die deklarierende Entität überhaupt nie deklariert hat, ist ein anderer Fall und wird hier nicht zurückgewiesen: Ein Ad-hoc-Socket trägt keine Allowlist, also gibt es nichts, außerhalb dessen die Kante liegen könnte.
uses edge dictates a delivery mechanism outside the socket’s allowlist (Eine Kante gibt einen Zustellungsmechanismus außerhalb der Allowlist des Sockets vor)
Ein Block inject: an einer Kante uses: nennt einen Zustellungsmechanismus, den die Allowlist inject: des Sockets nicht aufführt. Die Allowlist ist die Aussage der deklarierenden Entität darüber, aus welchen Zustellungsformen ihr Einstiegspunkt die Werte der Abhängigkeit tatsächlich lesen kann, sodass ein Mechanismus außerhalb davon Werte zustellen würde, die nichts konsumiert.
Jeder Mechanismus, den der Block nennt, wird geprüft, und jeder außerhalb der Allowlist wird gemeldet, sodass ein einziger Build sie alle nennt statt einen pro Lauf.
Ausgegebene Meldung. Zuerst kommt die Zurückweisung, dann der zurückgewiesene Mechanismus, der Socket, was dieser Socket zulässt, und die Entität, deren Deklaration gelesen wurde:
uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (das inject der uses-Kante gibt einen Zustellungsmechanismus vor, den der Socket nicht zulässt (der angegebene Mechanismus, am angegebenen Socket, der die angegebenen Mechanismen zulässt, deklariert am angegebenen Komponententyp). Geben Sie einen der Mechanismen vor, die der Socket zulässt, oder erweitern Sie die inject-Allowlist dieses Sockets im usesSchema-Eintrag der deklarierenden Entität.)
Der Befund wird am verfassten Eintrag positioniert, um den es geht, auf denselben Pfaden, die die Zurückweisung oben nennt. Wo der Socket am angebundenen Feature deklariert wurde, nennt die Meldung den Feature-Typ anstelle des Komponententyps.
So beheben Sie es: Wechseln Sie zu einem der zugelassenen Mechanismen, oder, wenn die Entität den benötigten Mechanismus unterstützen soll, erweitern Sie die Allowlist inject: dieses Sockets in seinem Katalogeintrag in usesSchema.
An inject: entry carries both a literal and a source key (Ein Inject-Eintrag trägt sowohl ein Literal als auch einen Quellschlüssel)
Ein Eintrag inject: stellt eines von zwei Dingen zu: ein Literal, geschrieben unter value: — im eigenen Block einer Komponente, dem einen Ort, an dem ein Literal zugestellt wird —, oder einen Schlüssel, der aus der Komponente gelesen wird, auf die die Verbindung zeigt, geschrieben unter from:. Ein Eintrag, der beides trägt, sagt zwei Dinge zugleich und bietet keine Regel, um zwischen ihnen zu wählen, daher wird er zurückgewiesen, statt eines der beiden stillschweigend gewinnen zu lassen.
Die Schemas für das Verfassen lassen genau eines der beiden zu, sodass ein aus einer Datei gelesenes Dokument beim Laden zurückgewiesen wird. Dies ist die Prüfung, die hinter jener steht: Sie liest jeden Block inject:, den das Aggregate und das Release tragen, während die beiden Dokumente aufgelöst werden, sodass ein Dokument, das auf einem anderen Weg als über eine Datei aufgebaut wurde, trotzdem zurückgewiesen wird, bevor etwas daraus gebaut wird, statt dass stillschweigend ein Feld ausgewählt wird. Sie deckt dieselben Blöcke ab wie die Formprüfung weiter unten.
Jeder Zustellungsmechanismus, der einen fehlerhaften Eintrag enthält, wird als eigener Befund gemeldet, positioniert an diesem Mechanismus in dem Dokument, das ihn geschrieben hat — .spec.components.<component>.inject.env für den eigenen Block einer Komponente —, und alle im Build werden auf einmal gemeldet. Der Befund nennt den Mechanismus und dann das Feld in: jedes fehlerhaften Eintrags in der Liste dieses Mechanismus.
Ausgegebene Meldung:
inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (der Inject-Eintrag trägt beide Felder; das Schema verlangt genau eines (mit dem angegebenen Mechanismus und den angegebenen Einträgen))
So beheben Sie es: Öffnen Sie jeden Eintrag, den die Meldung nennt, und löschen Sie dasjenige der beiden, das er nicht braucht. Behalten Sie from:, wo der Wert von der Komponente kommen soll, auf die die Verbindung zeigt — es nennt einen Schlüssel, den das provides: dieser Komponente deklariert. Behalten Sie value:, wo der Wert ein Literal ist, das diese Seite liefert, im eigenen Block einer Komponente; an einer Verbindung und im Block, den ein angebundenes Feature selbst trägt, wird ein Literal zurückgewiesen, also behalten Sie dort from:.
An inject: entry on a connection carries a literal (Ein Inject-Eintrag an einer Verbindung trägt ein Literal)
Eine Verbindung stellt der konsumierenden Komponente zu, was die Komponente veröffentlicht, auf die sie zeigt: Jeder Eintrag im Block inject: der Verbindung nennt unter from: einen der Schlüssel provides: dieser Komponente. Ein unter value: geschriebenes Literal nennt nichts, was das Ziel veröffentlicht, daher hat es an einer Verbindung keinen Platz, und der Eintrag wird zurückgewiesen statt verworfen. Ein Literal, das eine Komponente sich selbst zustellt, gehört in den eigenen Block inject: der Komponente, wo value: zugelassen ist.
Jede Verbindung wird geprüft, gleich welches Dokument sie gezogen hat: eine am eigenen Block uses: einer Komponente, eine, die ein angebundenes Feature im Aggregate zieht, und eine, die eine im Release geschriebene Anbindung zieht. Sie wird zurückgewiesen, bevor etwas gerendert wird, sodass aggrega validate --release sie ebenso meldet wie aggrega build.
Jeder fehlerhafte Eintrag wird als eigener Befund gemeldet, positioniert am Eintrag der Verbindung in dem Dokument, das sie gezogen hat — .spec.components.<component>.uses.<socket>.<alias> für die eigene Verbindung einer Komponente, .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> für eine, die eine Anbindung zieht, und im Release derselbe Pfad unterhalb des Eintrags der Anbindung, etwa .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias> —, und alle im Build werden auf einmal gemeldet. Ein Befund im Aggregate wird unter DEVELOPER_ERROR eingeordnet, einer im Release unter OPS_ERROR. Der Befund nennt den Mechanismus und das Feld in: des Eintrags.
Ausgegebene Meldung:
inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (der Inject-Eintrag an einer Verbindung trägt ein Literal; eine Verbindung stellt die veröffentlichten Schlüssel des Ziels zu, jeden als Quelle benannt (mit dem angegebenen Mechanismus und Eintrag))
So beheben Sie es: Wo der Wert einer ist, den das Ziel veröffentlicht, ersetzen Sie value: durch from:, das diesen Schlüssel provides: nennt. Wo es ein Literal ist, das die konsumierende Komponente braucht, verschieben Sie den Eintrag in den eigenen Block inject: dieser Komponente, dessen Mechanismen die Allowlist spec.inject ihres Component-Typs regelt.
An inject: entry on an attached Feature carries a literal (Ein Injektionseintrag an einem angebundenen Feature enthält ein Literal)
Der an einem angebundenen Feature geschriebene Block inject: stellt der Komponente zu, was das FeatureRecipe dieser Anbindung veröffentlicht: Jeder Eintrag nennt einen der Schlüssel, die das provides: des FeatureRecipe veröffentlicht, unter from:. Ein unter value: geschriebenes Literal nennt nichts, was die Anbindung veröffentlicht, sodass unter dem in: dieses Eintrags nichts die Komponente erreichen würde; der Eintrag wird zurückgewiesen, statt gebaut und verworfen zu werden. Ein Literal, das die Komponente braucht, gehört in den eigenen Block inject: der Komponente, wo value: zugelassen und zugestellt wird.
Jede Anbindung, an der ein Aggregate einen Block inject: schreibt, wird geprüft: eine im eigenen Block features: einer Komponente und eine im Block features: eines Subsystems, die jede Komponente erreicht, die das Subsystem enthält — im Aggregate, das das Release nennt, und in jedem Modul, das dieses Aggregate unter aggregates: importiert, in beliebiger Tiefe. Eine Verbindung, die eine Anbindung zieht, trägt ihren eigenen Block inject:, und ein Literal dort fällt unter die oben beschriebene Zurückweisung für Verbindungen. Eine Anbindung im Release schreibt keinen eigenen Block inject:. Ein solcher Eintrag wird zurückgewiesen, bevor irgendetwas gerendert wird, sodass aggrega validate --release ihn ebenso meldet wie aggrega build.
Jeder fehlerhafte Eintrag wird als eigener Befund gemeldet, als DEVELOPER_ERROR gegen das Aggregate abgelegt, dessen Dokument den Block geschrieben hat — das eigene Dokument eines Moduls für eine in einem Modul geschriebene Anbindung —, und am Zustellungsmechanismus innerhalb des Blocks der Anbindung in diesem Dokument positioniert: .spec.components.<component>.features.<attachment>.inject.<mechanism> oder .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism> für die Anbindung eines Subsystems. Alle in einem Dokument werden auf einmal gemeldet; die in einem importierten Modul werden gemeldet, sobald das importierende Aggregate die Prüfung besteht. Der Befund nennt den Mechanismus und das in: des Eintrags. Ein Eintrag, der sowohl value: als auch from: trägt, wird nur einmal gemeldet, unter „An inject: entry carries both a literal and a source key (Ein Injektionseintrag trägt sowohl ein Literal als auch einen Quellschlüssel)“ oben.
Ausgegebene Meldung:
inject entry on an attachment carries value:; an attachment delivers the keys its FeatureRecipe publishes, each named with from:, and a literal belongs in the component’s own inject block ("<mechanism>", "<in>") (ein Inject-Eintrag an einer Anbindung trägt ein Literal; eine Anbindung stellt die Schlüssel zu, die ihr FeatureRecipe veröffentlicht, jeweils als Quellschlüssel benannt, und ein Literal gehört in den eigenen Inject-Block der Komponente)
So beheben Sie es: Wo der Wert einer ist, den das FeatureRecipe der Anbindung veröffentlicht, ersetzen Sie value: durch from: mit dem Namen dieses Schlüssels provides:. Wo es ein Literal ist, das die Komponente braucht, verschieben Sie den Eintrag in den eigenen Block inject: der Komponente, dessen Mechanismen die Allowlist spec.inject ihres Component-Typs regelt:
components:
api:
type:core/api
inject:
env:
-in:LITERAL_NAME
value:a-literal# the literal, delivered by the component's own block
features:
token:
type:core/token
inject:
env:
-in:TOKEN_NAME
from:name# a key the attachment's FeatureRecipe publishes
An inject: delivery is not a list of entries (Eine Inject-Zustellung ist keine Liste von Einträgen)
Jeder Zustellungsmechanismus in einem Block inject: — env, file, arg oder ein daneben benannter Mechanismus — ist eine Liste von Einträgen, die jeweils in: und genau eines von from: oder value: tragen. Ein Mechanismus, der etwas anderes enthält, etwa eine Zuordnung von Namen zu Schlüsseln, stellt nichts zu, was der Compiler lesen kann, daher wird er zurückgewiesen statt verworfen. Ein Mechanismus, der ganz ohne Wert geschrieben ist, stellt nichts zu und wird nicht zurückgewiesen.
Die Schemas für das Verfassen lassen nur die Liste zu, sodass ein aus einer Datei gelesenes Dokument beim Laden zurückgewiesen wird, als Dokument, das nicht dem Schema seiner Art entspricht. Dies ist die Prüfung, die hinter jener steht: Sie liest jeden Block inject:, den das Aggregate und das Release tragen, während die beiden Dokumente aufgelöst werden, sodass ein Dokument, das auf einem anderen Weg als über eine Datei aufgebaut wurde, trotzdem zurückgewiesen wird, bevor etwas daraus gebaut wird, statt dass die Zustellung verschwindet. Sie deckt jeden Block ab, den eines der beiden Dokumente trägt: im Aggregate den eigenen einer Komponente, den einer Anbindung und die an den Verbindungen, die eine von beiden zieht; im Release die an den Verbindungen, die seine Anbindungen ziehen.
Jeder fehlerhafte Mechanismus wird als eigener Befund gemeldet, positioniert an diesem Mechanismus in dem Dokument, das ihn geschrieben hat, und unter Nennung des Mechanismus, und alle im Build werden auf einmal gemeldet. Die Befunde des Aggregate werden vor denen des Release gemeldet.
Ausgegebene Meldung:
inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (Inject-Zustellung: Die Form muss eine Liste von Einträgen sein, jeder mit einem Ziel und genau einer Quelle oder einem Literal (mit dem angegebenen Mechanismus))
Die Position ist der Schlüsselpfad, den der Autor geschrieben hat. Im Aggregate .spec.components.<component>.inject.<mechanism> für den eigenen Block einer Komponente, .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism> für einen Block an einer ihrer Verbindungen und .spec.components.<component>.features.<attachment>… für den einer Anbindung, mit .subsystems.<name> für jedes Subsystem, in dem eine Komponente oder eine Anbindung deklariert ist. Im Release der Block an einer Verbindung, die eine Anbindung zieht, über diese Anbindung — .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism> für eine, die für die ganze Boundary angebunden ist, .spec.boundaries.<boundary>.components.<component>.features.<attachment>… für eine an einer Komponente, mit .boundaries.<name> für jede verschachtelte Boundary und .aggregates.<module> für jeden Routing-Eintrag, über den eine Komponente benannt wird.
So beheben Sie es: Schreiben Sie jeden Mechanismus, den die Meldung nennt, als Liste. Ein Eintrag DB_URL: host unter env: wird zu - in: DB_URL mit from: host, wenn host einen Schlüssel provides: nennt — den der verbundenen Komponente an einer Verbindung, den eigenen der Komponente an ihrem eigenen Block —, oder, am eigenen Block der Komponente, mit value: host, wenn es ein Literal ist, das diese Seite liefert.
The Feature filling an attachment slot does not satisfy the slot’s selector (Das Feature, das einen Anbindungs-Slot füllt, erfüllt den Selektor des Slots nicht)
Eine Component deklariert benannte Bindungspunkte für die Features, die sie erwartet, und ein Slot kann einen selector: deklarieren, der die Labels dessen einschränkt, was ihn füllt. Eine Anbindung bindet einen Slot, indem sie den Namen des Slots trägt; wenn sie das tut, werden die Labels des Feature, das sie nennt, mit dieser Einschränkung abgeglichen, und eine Füllung, die sie nicht erfüllt, hält den Build an. Ein Slot, der keine Einschränkung deklariert, akzeptiert jede Füllung.
Ob ein Slot überhaupt ungebunden bleiben darf, ist eine andere Frage mit einer anderen Abhilfe, die ihr eigener Abbruch weiter oben meldet: Dieser hier setzt eine Füllung voraus und fragt, ob die Füllung zulässig ist, daher ist ein ungebundener Slot nicht seine Sache.
Zwei Ergebnisse werden unter dieser einen Bedingung gemeldet, und die Meldung unterscheidet sie an dem, was ihr letzter Wert besagt. Eine Füllung, die die Einschränkung nicht erfüllt hat, nennt das Feature, dessen Labels nicht übereinstimmten. Eine Einschränkung, die überhaupt nicht gelesen werden konnte, nennt stattdessen den Grund — einen Ausdruck, den der Label-Matcher nicht auswerten konnte —, was ein Fehler in der eigenen Deklaration des Slots ist und nicht in dem, was an ihn angebunden wurde.
Ausgegebene Meldung, wenn die Labels der Füllung die Einschränkung nicht erfüllt haben:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (Selektor des Anbindungs-Slots nicht erfüllt (der angegebene Selektor, deklariert am angegebenen Slot, nicht erfüllt von den Labels des Feature, das ihn füllt, dem angegebenen Feature-Typ). Fügen Sie die Labels, die der Selektor des Slots verlangt, den Labels des Feature hinzu, oder füllen Sie den Slot mit einem Feature, das sie bereits trägt.)
und wenn die Einschränkung selbst nicht ausgewertet werden konnte:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity. (Selektor des Anbindungs-Slots nicht erfüllt (der angegebene Selektor, deklariert am angegebenen Slot, der nicht ausgewertet werden konnte: mit dem angegebenen Grund). Korrigieren Sie den Selektor an der Deklaration des Slots in der Katalogentität der Komponente.)
Er wird am Schlüssel der Füllung in dem Dokument positioniert, das die Füllung geschrieben hat, und dem Autor dieses Dokuments zugeordnet: Der Block features: der Komponente im Aggregate ist ein Entwicklerfehler, und eine Füllung, die nur das Release vornimmt — an seinem Eintrag für die Komponente oder an einer Boundary, die sie enthält —, ist ein Operatorfehler, gemeldet am eigenen Pfad des Release:
[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.
Dieselbe Füllung, an der Komponente im Aggregate geschrieben, meldet [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity.
Ein Slot, den ein Socket deklariert — im featuresSchema eines Eintrags in usesSchema —, misst die Füllung jeder Verbindung auf dieselbe Weise an seinem selector:. Die Anbindung, die eine Verbindung im Slot trägt, wird mit der Einschränkung abgeglichen, und eine Füllung, die sie nicht zulässt, hält den Build an und nennt dabei neben dem Slot auch den Socket und die Verbindung:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (Selektor des Anbindungs-Slots nicht erfüllt (der angegebene Selektor, deklariert am angegebenen Slot des angegebenen Sockets, gefüllt an der angegebenen Verbindung, nicht erfüllt von den Labels des Feature, das ihn füllt, dem angegebenen Feature-Typ). Fügen Sie die Labels, die der Selektor des Slots verlangt, den Labels des Feature hinzu, oder füllen Sie den Slot mit einem Feature, das sie bereits trägt.)
Er wird am Schlüssel der Anbindung unter dem features: dieser Verbindung positioniert, in dem Dokument, das die Füllung geschrieben hat: am Verbindungseintrag des Aggregate oder am kantenbezogenen Eintrag des Release für eine Füllung, die nur das Release vornimmt.
Auch ein Slot-Selektor, den die Grammatik nicht lesen kann, wird zurückgewiesen, bevor irgendetwas den Slot füllt.aggrega validate liest über den gesamten Katalog oder über eine einzelne Component oder ein einzelnes Feature jeden Slot-Selektor, den das eigene Dokument der Entität deklariert — die eigenen Slots einer Component, die Slots, die ihre Sockets deklarieren, und die Slots eines Feature —, und weist einen, den die Grammatik nicht lesen kann, unter genau dieser Bedingung zurück, ob nun etwas den Slot füllt oder nicht. Die Meldung ist die oben gezeigte Form „konnte nicht ausgewertet werden“; ein Slot, den ein Socket deklariert, fügt den Socket hinzu:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity. (Selektor des Anbindungs-Slots nicht erfüllt, deklariert auf dem Slot des Sockets, der nicht ausgewertet werden konnte. Korrigieren Sie den Selektor in der Deklaration des Slots im featuresSchema des Sockets in der Katalog-Entität der Komponente.)
Bei einem Slot eines Feature nennt die Abhilfe stattdessen die Katalog-Entität des Feature. Nichts hat den Slot gefüllt, daher liegt der Fehler bei der Katalog-Entität: Er wird als CATALOG_ERROR eingestuft und nennt die Datei der Entität.
So beheben Sie es: Binden Sie bei einer Füllung, die die Einschränkung nicht erfüllt hat, ein Feature an, dessen Labels sie erfüllen — der Selektor in der Meldung sagt, welche Labels verlangt werden —, oder erweitern Sie den selector: des Slots in der Component, die ihn deklariert. Wo die Meldung sagt, dass die Einschränkung nicht ausgewertet werden konnte, liegt der Fehler im Ausdruck des Selektors: Korrigieren Sie ihn in der Slot-Deklaration der Component oder in der des Sockets.
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)
Die eigene Anbindungsoberfläche einer Component ist offen: Eine Anbindung unter einem Namen, den kein Slot deklariert, ist eine freie Anbindung und zulässig. Eine Struktur auf dieser Oberfläche führt zum Abbruch, weil sie die Struktur ist, die eine für einen Slot gedachte Füllung annimmt, wenn sie unter dem falschen Namen geschrieben wird. Der Build hält an, wenn für eine Anbindung alle folgenden Bedingungen gelten:
sie ist an der Komponente selbst geschrieben — im eigenen Block features: der Komponente im Aggregate oder am Eintrag des Release für genau diese eine Komponente;
ihr Name ist kein Slot, den der Typ der Komponente deklariert;
die Labels ihres Feature erfüllen den selector: eines Slots, den der Typ deklariert;
nichts bindet diesen Slot an der Komponente, nachdem jeder Geltungsbereich zusammengeführt wurde.
Bleibt sie unverändert, ist eine solche Anbindung eine freie Anbindung, während der Slot, für den sie gedacht war, leer bleibt — und ein optionaler, leer gelassener Slot führt zu einem grünen Build und stellt nichts zu. Die Regel gilt für jedes Feature, nicht nur für Anmeldeinformationen.
Alles andere auf der Oberfläche bleibt frei. Eine Anbindung, deren Feature zu keinem deklarierten Slot passt, lässt sich bauen; ebenso eine zusätzliche Anbindung neben einem Slot, den bereits etwas bindet, solange kein anderer Slot, zu dem sie passt, leer bleibt. Eine Anbindung, die die Komponente von einem Subsystem oder einer Release-Boundary erbt, wird nie beurteilt, sodass sich die gemeinsame Struktur — eine Anmeldeinformation, die einmal in einem Geltungsbereich angebunden ist, in dem mehrere Komponenten liegen, ohne dass eine Komponente den Slot füllt — bauen lässt. Ein Slot, der keinen selector: deklariert, sagt nichts darüber aus, für welches Feature er gedacht ist, sodass keine Anbindung auf diese Weise an ihm gemessen wird. Auch eine Anbindung, die eine Verbindung trägt, wird hier nicht beurteilt: Die Slots eines Sockets sind eine geschlossene Menge, und jeder andere Name an einer Verbindung führt zum Abbruch unter „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)“.
Ausgegebene Meldung. Zuerst kommt der Satz der Bedingung, dann der Name, unter dem die Anbindung geschrieben wurde, die Komponente, das Feature, das sie anbindet, und der leere Slot, zu dem sie passt — dann, was dagegen zu tun ist:
attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot. (eine unter einem Namen, den kein Slot deklariert, geschriebene Anbindung passt zu einem Slot, den ihre Komponente leer lässt (die angegebene Anbindung, an der angegebenen Komponente, die das angegebene Feature anbindet, das zum angegebenen leeren Slot passt). Binden Sie sie unter dem Namen des angegebenen Slots an, um den Slot zu füllen.)
Wo das Feature zu mehr als einem leeren Slot passt, nennt die Meldung jeden davon, in der Reihenfolge, in der der Typ der Komponente sie deklariert, und überlässt Ihnen die Wahl:
attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill. (eine unter einem Namen, den kein Slot deklariert, geschriebene Anbindung passt zu einem Slot, den ihre Komponente leer lässt (die angegebene Anbindung, an der angegebenen Komponente, die das angegebene Feature anbindet, das zum angegebenen leeren Slot und zum anderen angegebenen leeren Slot passt). Binden Sie sie unter dem Namen des Slots an, den sie füllen soll.)
Er wird am Schlüssel der Anbindung in dem Dokument positioniert, das sie geschrieben hat, und dem Autor dieses Dokuments zugeordnet. Eine Anbindung im eigenen Block features: der Komponente im Aggregate wird unter .spec.components.<component>.features.<attachment> als Entwicklerfehler gemeldet; eine, die nur das Release geschrieben hat, an seinem Eintrag für die Komponente, wird dort gemeldet — unter der Boundary, die die Komponente nennt, .spec.boundaries.<boundary>.components.<component>.features.<attachment> — als Operatorfehler:
[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.
Der leere Slot selbst ist ein eigener Befund, wo er erforderlich ist, gemeldet an der Komponente im Aggregate unter „Required attachment slot not bound (Erforderlicher Anbindungs-Slot nicht gebunden)“.
Wie sich dies vom Beinahe-Treffer-Hinweis unterscheidet. Der Hinweis unter „An attachment name is one edit from a declared slot (Ein Anbindungsname ist eine Bearbeitung von einem deklarierten Slot entfernt)“ betrifft die Schreibweise eines Namens: einen Namen, der eine Bearbeitung von einem Slot entfernt ist, dessen selector: das Feature der Anbindung nicht erfüllt, was sich bauen lässt und eine Warnung meldet. Dieser Abbruch betrifft das, wozu das Feature passt, unabhängig vom Namen: Der Name kann beliebig sein, und der Slot, zu dem es passt, muss leer gelassen worden sein. Wo ein Name eine Bearbeitung von einem Slot entfernt ist und sein Feature tatsächlich zu diesem Slot passt, wird kein Hinweis ausgelöst, und wenn der Slot leer bleibt, ist dieser Abbruch der einzige gemeldete Befund.
So beheben Sie es: Binden Sie sie unter dem Namen des Slots an, damit sie den Slot füllt — die Meldung nennt den Slot oder, wenn es mehrere gibt, jeden Kandidaten. Ist sie wirklich eine eigene Anbindung, füllen Sie zusätzlich den Slot, denn eine zusätzliche Anbindung ist frei, sobald jeder Slot, zu dem sie passt, gebunden ist; oder binden Sie sie, wo sie mehrere Komponenten erreichen soll, an dem Subsystem oder der Release-Boundary an, in dem bzw. der diese liegen. Soll das Feature diesen Slot nie füllen, verengen Sie den selector: des Slots in der Component, die ihn deklariert.
An attachment delivers a key another inject source already claimed (Eine Anbindung stellt einen Schlüssel zu, den eine andere Inject-Quelle bereits beansprucht hat)
Drei Oberflächen des Verfassens stellen über einen Block inject: in den Injektionskanal einer Komponente zu: der eigene Block inject: der Komponente, die Blöcke inject: an den Einträgen ihres Abhängigkeitsblocks und der Block an jedem an sie angebundenen Feature. Sie teilen sich einen Schlüsselraum pro Zustellungsmechanismus, sodass ein Schlüssel, den zwei von ihnen beanspruchen, mehrdeutig ist, was den ankommenden Wert betrifft, und der Build hält an, statt eine Oberfläche stillschweigend eine andere verdrängen zu lassen. Ein angebundenes Feature kann auch auf einem zweiten Weg zustellen, über das injectMapping seines FeatureRecipe; dieser Weg trifft auf denselben Raum, nachdem jeder Block zugestellt hat, und wird weiter unten unter „Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Zwei angebundene Features stellen einen Schlüssel zu, das spätere über das injectMapping seines FeatureRecipe)“ gemeldet.
Diese Bedingung ist die Seite des Anbindungsblocks in diesem Raum. Sie wird gemeldet, wenn der eigene Block inject: einer Anbindung einen Schlüssel beansprucht, den bereits eine frühere Zustellung hält — der Eintrag weiter oben unter „Duplicate delivery key across inject sources (Doppelter Zustellungsschlüssel über Inject-Quellen hinweg)“ ist dieselbe Regel, von der vom Entwickler verfassten Seite aus gelesen, und zusammen decken sie die Beanspruchung jedes Blocks ab.
Die Reihenfolge entscheidet, wer kollidiert ist. Die erste Beanspruchung unter einem Schlüssel ist diejenige, die ihn hält, und spätere Beanspruchungen sind die gemeldeten — eine Anbindung, deren Schlüssel vergeben ist, erfährt das also, während eine Anbindung, die zuerst beansprucht hat, nichts von einer späteren erfährt, die nichts verdrängt hat. Eine Beanspruchung, die überhaupt nichts zugestellt hat, lässt den Schlüssel frei und nimmt an alldem nicht teil.
Der Befund wird am eigenen Eintrag der Anbindung im Block der Komponente positioniert, also an der zu bearbeitenden Position; die Meldung nennt den Schlüssel und den Mechanismus, in dessen Schlüsselraum er liegt. Jeder kollidierende Schlüssel wird einzeln gemeldet, sodass eine Anbindung, die zwei Schlüssel doppelt belegt, Ihnen beide nennt.
Ausgegebene Meldung:
duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (doppelter Zustellungsschlüssel über das Inject der Anbindung und eine andere Inject-Quelle hinweg (der angegebene Schlüssel, der angegebene Mechanismus))
So beheben Sie es: Keine der beiden Seiten ist der Verursacher, und beide liegen bei Ihnen. Benennen Sie den Schlüssel auf der Seite um, die Sie kontrollieren — meist im eigenen Eintrag inject: der Komponente, da das Mapping des Feature in einem Katalogdokument geschrieben ist —, oder lassen Sie eine der beiden Zustellungen weg. Wo die Anbindung den Wert tatsächlich liefern soll, entfernen Sie die vom Entwickler verfasste Beanspruchung statt der der Anbindung. Beachten Sie, dass ein injectMapping des FeatureRecipe eines Feature, das einen Schlüssel schreibt, ein anderer Weg ist und hier nicht gemeldet wird: Einen Schlüssel umzuschreiben, den der eigene Block inject: der Komponente oder eine ihrer Verbindungen zugestellt hat, ist Abfangen und wird überhaupt nicht gemeldet, und einen Schlüssel zu schreiben, den ein anderes angebundenes Feature zugestellt hat, wird unter dem folgenden Eintrag gemeldet.
Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Zwei angebundene Features stellen einen Schlüssel zu, das spätere über das injectMapping seines FeatureRecipe)
Ein angebundenes Feature stellt auf zwei Wegen in den Injektionskanal seiner Komponente zu: über den Block inject:, der an der Anbindung geschrieben ist, und über das injectMapping seines FeatureRecipe, dessen Ausgabe den Zustellungsschlüssel nennt — oft aus einem Wert, den die Anbindung trägt, etwa der gewählten Umgebungsvariable einer Anmeldeinformation. Wenn zwei angebundene Features unter einem Zustellungsmechanismus bei einem Schlüssel ankommen und das spätere der beiden über sein Mapping dorthin gelangt, hält der Build an. Ließe man ihn weiterlaufen, würde die Komponente den Wert lesen, der zufällig zuletzt geschrieben wurde, sodass eine Anmeldeinformation anstelle einer anderen präsentiert werden könnte, ohne dass etwas in der Ausgabe darauf hinweist.
Sie deckt jedes angebundene Feature ab, wo auch immer es angebunden wurde: den eigenen Block features: der Komponente, ein Subsystem, eine Release-Boundary oder einen Komponenteneintrag des Release, die Expansion einer Annotation und den Eintrag features: einer Verbindung. Die frühere der beiden Zustellungen kann das Mapping des anderen Feature oder dessen eigener Block inject: sein — der Build meldet beide Paarungen unter dieser einen Bedingung.
Die Reihenfolge entscheidet, wer kollidiert ist. Jeder Block inject: stellt zu, bevor irgendein Mapping gerendert wird, und die Mappings werden in einer festen Reihenfolge gerendert — der Reihenfolge, in der das Inject-Mapping die angebundenen Features einer Komponente durchläuft, beschrieben in der Kompilierungspipeline —, sodass die erste Zustellung unter einem Schlüssel diejenige ist, die ihn hält, und das spätere Feature das gemeldete. Allein das Vorhandensein entscheidet: Werte werden nicht verglichen, sodass zwei Features, die denselben Wert unter einem Schlüssel zustellen, dennoch gemeldet werden. Ein Schlüssel, den die Ausgabe eines Mappings überhaupt nicht trägt, ist keine Zustellung; ein Schlüssel, den sie mit leerem Wert trägt, ist eine, weil der leere Wert ersetzt, was dort stand. Ein Schlüssel unter zwei verschiedenen Zustellungsmechanismen sind zwei Schlüssel, keine Kollision.
Was nicht gemeldet wird. Ein injectMapping eines FeatureRecipe, das einen Schlüssel umschreibt, den der eigene Block inject: der Komponente oder einer der Blöcke inject: ihrer Verbindungen zugestellt hat, ist Abfangen — ein Routing-Feature, das einen Host qualifiziert, ein Guard, der einen Upstream umleitet —, und der Wert des Mappings ersetzt diesen einen Eintrag. Das Mapping eines Feature, das einen Schlüssel umschreibt, den sein eigener Block inject: zugestellt hat, ist dieses Feature, das seine eigene Zustellung transformiert, und wird ebenfalls nicht gemeldet.
Der Befund wird am eigenen Eintrag des späteren Feature positioniert — im Block features: der Komponente oder, bei einem Feature, das eine Verbindung trägt, an seinem Eintrag unter dieser Verbindung in dem Dokument, das ihn geschrieben hat, etwa .spec.components.<component>.uses.<socket>.<alias>.features.<slot> im Aggregate. Die Meldung nennt den Schlüssel, den Zustellungsmechanismus und beide Features mit den Namen, die sie an der Komponente tragen; ein Feature, das eine Verbindung trägt, wird mit dem Alias der Verbindung und dem Slot benannt, den es füllt, verbunden durch einen Punkt. Jeder kollidierende Schlüssel wird einzeln gemeldet.
Ausgegebene Meldung:
duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release. (doppelter Zustellungsschlüssel über zwei Anbindungen hinweg: Das FeatureRecipe einer Anbindung schreibt einen Zustellungsschlüssel, den eine andere Anbindung bereits zugestellt hat. Geben Sie einer der beiden Anbindungen einen eigenen Schlüssel, oder binden Sie eine weniger an: Der Schlüssel, unter dem diese Anbindung zustellt, wird von ihrem FeatureRecipe gewählt, das die eigenen values und infra der Anbindung lesen kann, und der Schlüssel der anderen wird auf dieselbe Weise gewählt oder durch ihren eigenen inject-Block, sofern sie über einen solchen zugestellt hat. Ein Release setzt die infra einer Anbindung und nie ihre values; wo ein Schlüssel durch einen Wert gewählt wird, binden Sie diese Anbindung daher im Aggregate mit dem Wert an und geben Sie den Rest weiterhin aus dem Release vor.)
So beheben Sie es: Geben Sie einem der beiden Features einen eigenen Schlüssel — bei einem Anmeldeinformations-Feature ist das meist der Schlüssel, den seine Werte nennen — oder entfernen Sie eine der beiden Anbindungen. Wo beide eine Variable liefern sollen, entscheiden Sie, welches die Komponente lesen soll, und binden Sie nur dieses an. Zwei Anmeldeinformationen, die ein Release eigenständig anbindet, kommen beide unter dem Schlüssel an, den ihr Feature standardmäßig nennt, weil ein Release die values einer Anbindung nicht schreiben kann: Binden Sie eine davon im Aggregate mit dem Wert an, der ihren Schlüssel nennt, und geben Sie ihre Herkunft im selben Eintrag aus dem Release an.
A component declares an inject mechanism the attached Feature maps nothing to (Eine Komponente deklariert einen Inject-Mechanismus, auf den das angebundene Feature nichts abbildet)
Die Allowlist spec.inject einer Component kann über die Standardmechanismen hinaus Zustellungsmechanismen nennen — einen Mechanismus, den die eigene interne Logik der Komponente versteht und für den alles, was in sie zustellt, einen Wert erzeugen muss. Wenn ein Feature an eine solche Komponente angebunden ist, legt das injectMapping des FeatureRecipe fest, unter welchem Mechanismus jeder Wert, den es erzeugt, zugestellt wird. Ein Mechanismus, den die Komponente deklariert hat und für den das Mapping keinen Schlüssel erzeugt, ist eine Zustellung, die stillschweigend nie stattfände, daher hält der Build stattdessen an.
Ein Mapping, das nichts über Mechanismen sagt, ist kein Mapping, das alle ausschließt. Ein FeatureRecipe, dessen Mapping als flaches Wörterbuch von Zustellungen gerendert wird, trifft überhaupt keine Aussage über Mechanismen — das ist die gewöhnliche Schreibweise für ein Feature, das Zustellungen als Umgebungsvariablen erzeugt —, und ebenso wenig eine Anbindung, die ein FeatureRecipe ohne auszuwertendes Mapping bindet. Keines von beiden wird hier gemeldet; diese Bedingung betrifft nur ein Mapping, das Mechanismen nennt und einen auslässt, den die Komponente deklariert hat.
Jeder nicht abgebildete Mechanismus ist ein eigener Befund, sodass eine Komponente, die zwei deklariert, von denen eine Anbindung keinen abbildet, Ihnen beide nennt. Der Befund wird am Eintrag der Anbindung in Ihrer eigenen Datei positioniert und nennt auch das FeatureRecipe — denn das ist das Dokument, in dem das Mapping geschrieben ist, und es liegt an einer ganz anderen Stelle.
Ausgegebene Meldung:
custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (der benutzerdefinierte Inject-Mechanismus hat keinen passenden Schlüssel in der Ausgabe des injectMapping; fügen Sie den Schlüssel des Mechanismus zum injectMapping des Recipe hinzu (der angegebene Mechanismus, das angegebene FeatureRecipe))
So beheben Sie es: Die Meldung nennt beide Hälften. Fügen Sie den Schlüssel des Mechanismus zum injectMapping des FeatureRecipe hinzu, damit das Feature einen Wert dafür erzeugt, oder entfernen Sie den Mechanismus aus der Allowlist spec.inject der Component, wo nichts darunter zustellen soll. Wo das FeatureRecipe zum Katalog eines anderen gehört, ist das Anbinden eines Feature, dessen Mapping den Mechanismus abdeckt, die dritte Antwort.
An attached Feature’s injectMapping output cannot be read (Die injectMapping-Ausgabe eines angebundenen Feature kann nicht gelesen werden)
Das injectMapping eines FeatureRecipe ist ein Template, und was es erzeugt, wird als YAML gelesen: ein Wörterbuch, das nach Zustellungsmechanismus geschlüsselt ist — env, file, arg oder ein eigener Mechanismus der Komponente —, oder ein flaches Wörterbuch von Umgebungszustellungen. Wenn sich die Ausgabe als keines von beiden lesen lässt, kann keiner ihrer Schlüssel zugestellt werden, daher hält der Build an, statt die Komponente so zu rendern, als hätte das angebundene Feature nichts zugestellt. Eine Anmeldeinformation ist der Fall, auf den es am meisten ankommt: Eine Komponente, die ein Passwort erwartet, das sie nie erhalten hat, könnte sonst ohne eines laufen, und nichts in der Ausgabe würde darauf hinweisen.
Die übliche Ursache ist ein Wert, den das Template unverändert zwischen Anführungszeichen geschrieben hat. Ein doppeltes Anführungszeichen darin beendet den Skalar in Anführungszeichen vorzeitig, und ein Backslash leitet eine Escape-Sequenz ein, die YAML möglicherweise nicht kennt, sodass ein Mapping, das für die meisten Werte korrekt gerendert wird, bei dem Wert bricht, der ein solches Zeichen enthält — oft ein Passwort. Eine Ausgabe, die leer ist oder sich als Wörterbuch parsen lässt, das nichts zustellt, ist nicht diese Bedingung: Sie stellt nichts zu, und genau das sagt sie aus.
Der Rahmen über der Meldung nennt die gerenderte Komponente, dann die Anbindung mit dem Namen, den sie an der Komponente trägt, und das FeatureRecipe, in dem das Mapping geschrieben ist, als feature "<attachment>" (recipe "<featurerecipe>") injectMapping output. Unter der Meldung steht der Grund, warum die Ausgabe nicht gelesen werden konnte — die Zeile und was YAML dort gefunden hat, etwa yaml: line 2: found unknown escape character. Wo das Template einen Wert liest, den ein Autor als sensibel deklariert hat, und der Grund davon abhängt, was dieser Wert enthält, wird der Grund zurückgehalten, und an seiner Stelle steht ein Satz, der dies sagt, sodass der Abbruch nie den Wert zitiert, der die Ausgabe beschädigt hat. Der Build meldet den Abbruch unter einem Tag CATALOG_ERROR, weil das Mapping vom Autor des FeatureRecipe geschrieben wird.
Ausgegebene Meldung:
FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (die injectMapping-Ausgabe des FeatureRecipe konnte nicht als Wörterbuch von Zustellungen gelesen werden)
So beheben Sie es: Schreiben Sie im injectMapping des FeatureRecipe jeden Wert über toJson — {{ .values.key }}: {{ .values.origin | toJson }} —, wodurch er als JSON-String geschrieben wird, den YAML exakt zurückliest, welche Zeichen er auch enthält. Wo das FeatureRecipe zum Katalog eines anderen gehört, kann auch der Wert so geändert werden, dass er kein doppeltes Anführungszeichen und keinen Backslash enthält, bis das Mapping korrigiert ist.
An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Die injectMapping-Ausgabe eines angebundenen Feature schreibt Auslieferungen unter einen Schlüssel, den nichts ausliefert)
Die Ausgabe des injectMapping eines FeatureRecipe wird anhand ihrer Schlüssel der obersten Ebene in den Injektionskanal der Komponente zusammengeführt. env, file und arg werden als diese Mechanismen zugestellt, und jeder andere Schlüssel wird als eigener Mechanismus unter diesem Namen zugestellt, den das Recipe der Komponente unter .context.inject.<name> liest. Die Sicht all ist anders: Sie wird nach der Zusammenführung aus den Mechanismen aufgebaut und nie aus einer Ausgabe zusammengeführt, sodass Werte, die ein Mapping unter all: schreibt, nichts erreichen. Die Ausgabe lässt sich trotzdem fehlerfrei lesen, sodass ohne diesen Abbruch ein Build, der diese Werte optional liest, ohne sie erfolgreich ist — eine dort geschriebene Anmeldeinformation erreicht die Komponente nie, und nichts im Build nennt das Mapping, das sie verloren hat.
Sie gilt überall, wo all: mindestens einen Eintrag trägt, allein oder neben anderen Mechanismen; die anderen Mechanismen in derselben Ausgabe sind nicht das Problem, und ein leer geschriebenes all: verliert nichts und wird nicht gemeldet. Ein flaches Wörterbuch, das zufällig einen Schlüssel namens all mit einem einzelnen Wert trägt, ist eine Umgebungszustellung namens all, nicht diese Bedingung.
Der Befund wird am Eintrag der Anbindung in Ihrer eigenen Datei positioniert und nennt den Schlüssel und das FeatureRecipe, in dem das Mapping geschrieben ist — denn das ist das zu ändernde Dokument, und es liegt an einer ganz anderen Stelle —, zusammen mit den Schlüsseln, die eine Ausgabe tragen darf. Jeder solche Schlüssel ist ein eigener Befund. Der Build meldet ihn unter einem Tag CATALOG_ERROR.
Ausgegebene Meldung:
FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name") (die injectMapping-Ausgabe des FeatureRecipe schreibt einen Schlüssel, den kein Zustellungsmechanismus des Hosts liest (der Schlüssel all, das angegebene FeatureRecipe und die Schlüssel, die eine Ausgabe tragen darf))
So beheben Sie es: Verschieben Sie im injectMapping des FeatureRecipe die Einträge unter all: zu dem Mechanismus, aus dem die Komponente sie liest — meist env: oder der Name des Mechanismus, den das Recipe der Komponente liest. Wo das FeatureRecipe zum Katalog eines anderen gehört, binden Sie stattdessen ein Feature an, dessen Mapping den Wert zustellt.
Beim Rendern der Ausgabe
Nachdem jeder Vertrag validiert ist, wertet der Compiler Go-Templates in den Component-Werten, den FeatureRecipe-Blöcken injectMapping sowie den Recipe- und FeatureRecipe-Quellen aus und übergibt das Ergebnis dann an den Renderer.
provides: template references a non-self-contained root (Das provides-Template verweist auf eine nicht in sich geschlossene Wurzel)
Das Template provides: eines Recipe verweist auf eine Wurzel außerhalb der in sich geschlossenen Menge. Der Block provides wird bei der provides-Auswertung ausgewertet, bevor der Inject-Kanal hydriert wird und bevor knotenübergreifende Kanten durchlaufen werden, daher darf er nur auf Daten verweisen, die zu seinem eigenen Knoten gehören: .context.instance_id, .context.rendered_name, wo der Provider des Knotens einen meldet, .values, .infra, die aufgelösten .locals des Knotens und statische Strings. Die Prüfung ist eine positive Allowlist, daher bricht jede andere Wurzel ab — .context.inject und .context.uses (knotenübergreifend), .context.annotations.*, .context.labels, .context.metadata und .metadata.* (an Platzierung oder Bereitstellung gekoppelte Daten, die die provides-Oberfläche nicht offenlegt) sowie .attachment_name (der provides-Durchlauf eines Basis-Recipe löst keine Anbindung auf). Ein Verweis auf eine dieser Wurzeln bricht deutlich ab, statt stillschweigend einen leeren Wert zu rendern.
.locals gehört zur Oberfläche: Die locals eines Knotens werden in der Präambel derselben Phase aufgelöst, vor seinen provides, daher liest ein Template provides sie und erhält aufgelöste Werte.
Ausgegebene Meldung:
provides block references a root outside the self-contained set ("<expression>") (der provides-Block verweist auf eine Wurzel außerhalb der in sich geschlossenen Menge (mit dem angegebenen Ausdruck))
Der Abbruch wird an dem Recipe positioniert, das den Eintrag deklariert, und an dem verfassten Schlüssel darin — .spec.provides.<name> —, daher nennt er den zu bearbeitenden Block statt der Komponente, die das Recipe gebunden hat. Jeder Eintrag, der über die Oberfläche hinausgreift, wird im selben Build gemeldet; wo es mehr als einer ist, werden die Befunde unter provides entries that reach outside the data they are evaluated against gruppiert.
So beheben Sie es: Bauen Sie das Template so um, dass es nur aus den eigenen Säulen des Recipe schöpft. Hängt der Wert von der Ausgabe eines anderen Knotens ab, gehört diese Abhängigkeit in den Block uses[].inject eines Aufrufers, nicht in die provides des Ziels. Ist der Wert berechnet, legen Sie den Ausdruck in einen Eintrag locals: und lesen Sie ihn aus provides — dann steht der Ausdruck an einer einzigen Stelle. Wenn Sie nach dem Bereitstellungs-Namespace (oder anderen Platzierungsdaten) gegriffen haben, um einen namespace-übergreifenden Host zu bilden, veröffentlichen Sie hier den bloßen Host und qualifizieren Sie ihn auf der Konsumentenseite mit einem Routing-Feature — die provides des Produzenten dürfen nicht davon abhängen, wo er bereitgestellt wurde.
Das provides: eines FeatureRecipe folgt derselben locals-Regel: Seine eigenen locals: werden vor seinem provides: aufgelöst, daher liest auch ein Eintrag provides eines FeatureRecipe .locals.
locals: entry references a sibling defined later in the same block (Ein locals-Eintrag verweist auf einen Geschwistereintrag, der später im selben Block definiert ist)
Ein Block locals: wird in der Reihenfolge aufgelöst, in der seine Einträge geschrieben sind, und ein Eintrag liest nur einen Geschwistereintrag, der über ihm definiert ist. Ein direkter Verweis .locals.<key> auf einen Eintrag, den der Block später definiert, bricht ab: Der Compiler sortiert den Block nie und ordnet ihn nie um, damit sich der Verweis auflöst, weil die erzeugte Ausgabe dann einer Schlussfolgerung statt dem Verfassten folgen würde. Ohne den Abbruch würde sich der Verweis über die Richtlinie für fehlende Schlüssel zu einem leeren String auflösen, sodass ein abgeleiteter Hostname oder Secret-Name stillschweigend das Segment verlieren würde, aus dem er gebildet wurde.
Beide Auflösungen eines Blocks locals: entscheiden über diesen Fehler, und eine davon ist das Pinnen. Ein Block wird zu zwei verschiedenen Zwecken aufgelöst: damit die eigenen Templates des Recipe ihn lesen können, während ein Artefakt gerendert wird, und damit eine strukturierte Koordinate source: aufgelöst und das von ihr benannte Artefakt gepinnt werden kann. Der Fehler wird anhand der deklarierten Schlüsselreihenfolge und des verfassten Textes entschieden, was alles ist, was er braucht, daher erreichen ihn beide Auflösungen und melden dieselbe Bedingung — aggrega pull und ein Build, der das Lockfile füllt, weisen den Block genauso zurück wie ein Rendern. Zwei Folgen sind beim Verfassen gut zu kennen. Der ganze Block wird gelesen, während eine Koordinate aufgelöst wird, daher bricht ein Eintrag in falscher Reihenfolge auch dort ab, wo jedes Feld source: literal ist und kein local liest. Und ein Recipe, dessen source: ein einfacher String ist oder das gar kein source: deklariert, löst keine Koordinate auf, daher wird der Fehler bei diesem Recipe gemeldet, wenn die Ausgabe gerendert wird.
Ausgegebene Meldung, für einen Eintrag im eigenen Block locals: des Recipe einer Komponente. Sie wird am verfassten Schlüssel innerhalb des Recipe positioniert, und jeder fehlerhafte Eintrag wird in einem einzigen Build gemeldet; wo es mehr als einer ist, werden die Befunde unter locals entries that read a sibling they cannot gruppiert:
locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block (der locals-Eintrag verweist auf einen Geschwistereintrag, der später im selben Block definiert ist (mit dem angegebenen Ausdruck, dem genannten Schlüssel, den an dieser Stelle aufgelösten locals und der angegebenen Komponente, über die er erreicht wurde). Definieren Sie den genannten Schlüssel im locals-Block über dem angegebenen Eintrag)
Ein Selbstverweis ist dieselbe Bedingung — der Schlüssel ist deklariert und nicht aufgelöst —, und keine Umordnung behebt ihn, daher sagt die Meldung das anstelle der Verschiebe-Anweisung:
locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (der locals-Eintrag verweist auf einen Geschwistereintrag, der später im selben Block definiert ist (mit dem angegebenen Ausdruck, dem genannten Schlüssel, den an dieser Stelle aufgelösten locals und der angegebenen Komponente, über die er erreicht wurde). Ein locals-Eintrag kann sich nicht selbst lesen; berechnen Sie den Wert direkt aus .values und .infra)
Ein Recipe wird von vielen Komponenten gebunden, daher wird ein Fehler in einem gemeinsam genutzten Block einmal für jede Komponente gemeldet, die ihn bindet — und reached through the component ist das, was diese Befunde unterscheidet. Sie teilen sich eine Position, weil sie alle denselben verfassten Eintrag im selben Dokument betreffen; die Position ist die Stelle, an der Sie bearbeiten, und der Komponentenname sagt, für welche Ihrer Komponenten jeder Befund steht. Die Befunde werden nicht zu einem zusammengeführt, weil das Zusammenführen sagen würde, dass etwas falsch ist, ohne zu sagen, welche Komponenten es erreicht, und das ist der Teil, auf den Sie reagieren müssen.
Derselbe Fehler in einem Block locals:, den das Rezept eines Feature deklariert, wird auf dieselbe Weise gemeldet: positioniert am verfassten Schlüssel innerhalb dieses Rezepts, benannt nach der Komponente, an der die Anbindung sitzt, und gruppiert mit allen Geschwistereinträgen, die denselben Fehler tragen. Wo das Rezept an mehr als einer Stelle angebunden ist, wird der Fehler für jede einmal gemeldet — jede Anbindung bindet diesen Block unabhängig, daher ist jede ein eigenes Vorkommen und keine Wiederholung eines einzigen.
Wo diese Form einen Selbstverweis meldet, nennt ihre Positionsangabe den verweisenden Eintrag selbst statt eines späteren, weil dort der Schlüssel steht.
So beheben Sie es: Verschieben Sie den referenzierten Eintrag über seinen Leser. Das Umordnen eines Blocks locals: ist überall dort eine Verhaltensänderung, wo ein Eintrag einen anderen liest, daher ist die Korrektur genau die Umordnung, die die Meldung nennt. Ein Selbstverweis — ein Eintrag, der seinen eigenen Schlüssel nennt — lässt sich nicht durch Umordnen beheben; berechnen Sie stattdessen den Wert direkt aus .values und .infra, was die Meldung anstelle der Verschiebe-Anweisung sagt.
locals: key does not exist (Der locals-Schlüssel existiert nicht)
Ein Template liest .locals.<key> für einen Schlüssel, den der Block locals: überhaupt nicht deklariert — ein Tippfehler oder ein Schlüssel, der umbenannt oder entfernt wurde. Jede Oberfläche, die die Säule liest, löst diesen Abbruch aus: ein Eintrag locals:, ein Template provides:, ein Template source: eines Recipe und die Auflösung einer strukturierten Koordinate source:, die den ganzen Block liest, um das von der Koordinate benannte Artefakt zu pinnen. Die locals-Säule ist eine offene Map mit Schlüsseln, daher besteht ein unbekannter Schlüssel darunter die Wurzelprüfung und würde sich sonst zu einem leeren String auflösen; der Abbruch ist das, was verhindert, dass dieser leere Wert ein ausgegebenes Artefakt erreicht.
Ausgegebene Meldung, wenn der fehlerhafte Verweis in einem Template provides: steht:
template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name (das Template verweist auf einen Schlüssel, den der locals-Block nicht deklariert (der angegebene provides-Eintrag des angegebenen Recipe verweist auf den angegebenen Ausdruck, der locals-Block deklariert den angegebenen Schlüssel nicht, er deklariert die angegebenen Schlüssel). Korrigieren Sie den Schlüsselnamen)
Ausgegebene Meldung, wenn er in einem Eintrag locals: selbst steht. Sie trägt die Komponente, über die der Block gebunden wurde, aus dem Grund, den der Reihenfolge-Abbruch oben nennt — ein gemeinsam genutzter Block wird einmal pro Komponente gemeldet, die ihn bindet, und dies ist es, was diese Befunde voneinander trennt:
template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name (das Template verweist auf einen Schlüssel, den der locals-Block nicht deklariert (mit dem angegebenen Ausdruck, dem fehlenden Schlüssel, den Schlüsseln, die der Block deklariert, und der angegebenen Komponente, über die er erreicht wurde). Korrigieren Sie den Schlüsselnamen)
So beheben Sie es: Korrigieren Sie den Schlüsselnamen zu einem, den der Block deklariert; die Meldung führt sie auf. Der Abbruch unterscheidet sich vom Reihenfolge-Abbruch oben, weil die Abhilfen verschieden sind — keine Umordnung lässt einen Schlüssel auflösen, der nicht existiert.
Die Prüfung liest den Pfad, zu dem sich ein Verweis auflöst, statt der getippten Zeichen, daher wird einem Alias des Blocks gefolgt: Ein Schlüssel, der über den Punkt erreicht wird, den ein Body with .locals neu bindet, oder über eine an .locals gebundene Variable, wird unter genau denselben Bedingungen geprüft wie die direkte Schreibweise und bricht auf dieselbe Weise ab, und ebenso ein Schlüssel, der in Klammern vom Block gelesen wird — {{ (.locals).nope }} oder {{ ($.locals).nope }} —, weil die Klammern den Block selbst liefern und nichts weiter. Eine Schreibweise entgeht der Prüfung: ein Schlüssel, der über einen Aufruf erreicht wird, dessen Ergebnis der Template-Text nicht benennen kann — {{ index .locals "nope" }} oder {{ (default dict .locals).nope }} —, weil das, was ein solcher Aufruf liefert, bei der Ausführung des Templates entschieden wird und nicht durch das Geschriebene. Ein fehlender Schlüssel, der als Feld vom Ergebnis eines solchen Aufrufs gelesen wird — die Form (default dict .locals).nope —, bricht nicht ab und rendert den Platzhaltertext der Template-Engine <no value>. Ein fehlender Schlüssel, der über index erreicht wird, bricht ab, aber als „A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)“ weiter unten statt als diese Prüfung: index bricht bei jedem Map-Schlüssel ab, den die Map nicht enthält. index bleibt daher der Weg, einen Schlüssel zu erreichen, dessen Name selbst berechnet wird, und ein berechneter Name, den der Block nicht deklariert, wird trotzdem anhand seines Schlüssels gemeldet.
Template references a root the render context does not define (Das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert)
Ein Template verweist auf eine Wurzel der obersten Ebene — das erste Pfadsegment nach dem führenden Punkt —, die sein Render-Kontext nicht definiert: ein Tippfehler wie {{ .valeus.port }} oder eine Wurzel, die auf der gerade verfassten Oberfläche nicht existiert. Die Prüfung ist eine positive Allowlist über die Namen der Wurzeln, und die zugelassene Menge wird aus der Form des Render-Kontexts selbst abgeleitet, statt als separate Liste daneben geführt zu werden, sodass die Menge, die der Build zurückweist, und die Menge, die der Kontext tatsächlich liefert, nicht auseinanderdriften können. Die Diagnose nennt den fehlerhaften Verweis und führt die Wurzeln auf, die dieser Kontext definiert.
Der Abbruch erfolgt identisch, ob der Verweis bloß steht oder in einen Fallback default, if, with oder range eingeschlossen ist, und die eingeschlossene Schreibweise ist die, auf die es am meisten ankommt: Ein Wrapper kann einen Fallback für einen fehlenden Schlüssel unter einer definierten Wurzel liefern, aber nie für eine fehlende Wurzel, daher würde sich ohne diesen Abbruch die eingeschlossene Form stillschweigend zu einem leeren Wert auflösen und den Build erfolgreich abschließen lassen. Ein fehlender Schlüssel unter einer definierten Wurzel bleibt unberührt und folgt weiterhin der Richtlinie missingkey=zero für Werte-Templates, die in „Missing template key — asymmetric policy (Fehlender Template-Schlüssel — asymmetrische Richtlinie)“ weiter unten beschrieben ist, sodass Idiome für optionale Schlüssel wie {{ .values.optional_field | default "fallback" }} weiterhin funktionieren.
Derselbe Abbruch deckt einen vertippten Schlüssel eine Ebene tiefer ab, unter einer Säule, deren Form deklariert ist. Einige Säulen haben eine Menge von Schlüsseln, die der Compiler definiert: .context, .metadata, .inject, .workload und .boundary im Render-Kontext von Recipe und FeatureRecipe sowie .manifest in einem Pfad-Template. Ein Verweis auf einen Schlüssel, den eine dieser Säulen nicht definiert — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} —, bricht genau wie eine falsche Wurzel ab, und die Diagnose führt die Schlüssel auf, die diese Säule definiert. In den eigenen Templates einer Feature-Anbindung definiert .inject neben env, file, arg und all einen weiteren Schlüssel für jeden Zustellmechanismus, den der eigene Block inject: der Anbindung nennt: Eine Anbindung, die einen Mechanismus vault_ref: schreibt, wird unter {{ .inject.vault_ref.VAULT_PATH }} gelesen, und die Diagnose führt .inject.vault_ref unter den Schlüsseln auf, die .inject definiert. Ein Mechanismus, den die Anbindung nicht nennt, bricht selbst innerhalb eines if oder eines with ab, weil der Verweis geprüft wird, bevor das Template ausgeführt wird. Um einen Mechanismus zu lesen, den die Anbindung möglicherweise nicht nennt, sichern Sie den Zugriff ab: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Mit dem abgesicherten Paar gelingt der Build, ob die Anbindung den Mechanismus nennt oder nicht und ob sie überhaupt einen Block inject: schreibt oder nicht — .inject enthält dann nichts, sodass das with seinen Rumpf überspringt, während hasKey direkt über .inject bei einem Wert abbrechen würde, der keine Map ist. Innerhalb der Absicherung bricht index weiterhin bei einem Schlüssel ab, den der genannte Mechanismus nicht enthält. Andere Säulen sind offen, weil das, was sie enthalten, Daten mit Schlüsseln sind statt einer Menge, die der Compiler deklariert — darunter .values, .infra, .locals, .provides, .features und .steps im Render-Kontext sowie .parameters und .parent_boundary in einem Pfad-Template. Eine offene Säule akzeptiert jeden Schlüssel. Ein fehlender Schlüssel unter einer offenen Säule ist nicht dieser Abbruch — er folgt der Richtlinie der Oberfläche für fehlende Schlüssel, die in „Missing template key — asymmetric policy (Fehlender Template-Schlüssel — asymmetrische Richtlinie)“ weiter unten beschrieben ist, sodass {{ .values.optional_field | default "fallback" }} und jedes andere Idiom für optionale Schlüssel weiterhin funktionieren.
Welche Säulen deklariert und welche offen sind, ist eine Eigenschaft der Oberfläche, nichts, was ein Template beeinflussen kann: Der Compiler liest es aus der Form des Render-Kontexts, den er gleich liefern wird. Das ist es, was den Tippfehler-Abbruch und das Rendern des optionalen Schlüssels im selben Template ermöglicht.
Eine Oberfläche kann auch einen Schlüssel einschränken, den ihre Säule sonst definiert, und eine solche Meldung ist kein Tippfehler. Wo ein Schlüssel auf einer bestimmten Oberfläche eine Antwort trägt, die bedeutungslos ist — oder zu einem anderen Knoten gehört —, weist diese Oberfläche den Verweis zurück, statt ihn zum Falschen aufzulösen, und die Diagnose führt die Schlüssel auf, die sie definiert. Zwei Fälle sind zu kennen, beide {{ .context.rendered_name }}. In den eigenen Templates einer Feature-Anbindung trägt der Schlüssel den Namen der Host-Komponente, wie ihn der eigene Provider des Hosts meldet, daher wird er an einer Anbindung eines Hosts zurückgewiesen, dessen Provider keinen Namen meldet — eines Hosts, der allein eine Artefaktmenge platziert, oder eines, der über einen Provider rendert, der keinen solchen Namen ableitet —, und auf jedem anderen Host zugelassen. {{ .context.instance_id }} ist auf dieser Oberfläche zugelassen und nennt die Host-Komponente, für die die Anbindung aufgelöst wird, nach der auf einem solchen Host die eigenen Ressourcen des Hosts benannt sind. In den Einträgen locals: eines Recipe wird der Schlüssel zurückgewiesen, gleich was der Provider des Knotens meldet: Ein local teilt seinen Kontext mit dem Template source: des Recipe, und ob der Knoten eine Quelle liefert, ist eines der Dinge, von denen der Name abhängt, daher wird der Name dort nicht angeboten. Die Diagnose führt .context.instance_id als den einen Schlüssel auf, den .context dort definiert; lesen Sie den gerenderten Namen stattdessen in einem Eintrag provides: oder einem Inline-Template. Siehe ../templates/rendered-resource-names.md dazu, was jeder der beiden Schlüssel benennt und wo jeder lesbar ist.
Ausgegebene Meldung, wenn die Wurzel selbst nicht definiert ist:
template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>) (das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert (das angegebene Template verweist auf den angegebenen Pfad, der Render-Kontext definiert die angegebenen Wurzeln))
Und wenn die Wurzel stimmt, ein Schlüssel unter einer deklarierten Säule aber nicht:
template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert (das angegebene Template verweist auf den angegebenen Pfad, die angegebene Säule definiert die angegebenen Schlüssel))
So beheben Sie es: Korrigieren Sie den Verweis zu einem, den die Diagnose aufführt — die meisten Meldungen sind ein Tippfehler bei .values, .infra oder .context oder bei einem Schlüssel unter .context oder .metadata. Das Entfernen des Fallback-Wrappers beseitigt den Abbruch nicht, und das Hinzufügen eines Wrappers hat ihn nie unterdrückt; der Wrapper hat immer nur verborgen, welcher Verweis falsch war. Gehören die Daten tatsächlich zu einem anderen Knoten, erreichen sie dieses Template über den Inject-Kanal — verdrahten Sie sie mit einem Eintrag uses[].inject am Konsumenten und lesen Sie sie aus .context.inject — statt über eine eigene Wurzel.
Die Prüfung deckt jede Template-Oberfläche ab, die der Renderer auswertet, jede gegen die Verweismenge, die ihre eigene Oberfläche definiert: valuesMapping, injectMapping und workload von Recipe und FeatureRecipe, Bodys von artifacts:, Einträge provides: und locals:, source:, Bodys when: und with: der Schritte von pipeline, assertions:, die self-inject-Templates value: auf Komponentenebene in einem Aggregate und die Pfad-Templates der Boundaries eines Release (directory: / subDirectory:). Zwei dieser Oberflächen benennen einige Zurückweisungen mit einer eigenen Diagnose, weil der Fehler, den sie beschreiben, spezifischer ist als „dieser Verweis existiert nicht“: Ein Pfad-Template, das nach einer Variablen greift, die ihm nicht gegeben wird, wird durch „Path-template references a variable outside the allowlist (Das Pfad-Template verweist auf eine Variable außerhalb der Allowlist)“ weiter unten abgedeckt, und ein FeatureRecipe auf Boundary-Ebene, das nach einer komponentenbezogenen Säule greift, durch „FeatureRecipe template references a field outside its scope’s allowlist (Das FeatureRecipe-Template verweist auf ein Feld außerhalb der Allowlist seines Geltungsbereichs)“. Alles andere, was diese beiden Oberflächen zurückweisen — einschließlich eines vertippten Schlüssels unter einer Säule, die sie zulassen —, meldet diesen Abbruch, sodass keine Diagnose Ihnen sagt, Ihr Verweis sei etwas, das er nicht ist.
An artifacts: template reads a pillar the Recipe does not declare (Ein artifacts-Template liest eine Säule, die das Recipe nicht deklariert)
Das Template eines Eintrags artifacts: liest .workload oder einen Schlüssel darunter in einem Recipe, das kein workload: deklariert; oder es liest .source oder einen Schlüssel darunter in einem Recipe, das kein source: deklariert. Beide Säulen sind im Render-Kontext der Artefakte immer vorhanden — sie sind Wurzeln, die die Oberfläche definiert —, daher ist der Verweis wohlgeformt, und beim Abbruch geht es darum, dass die Deklaration fehlt, nicht darum, dass der Verweis falsch ist. Ein Recipe, das ein Deployment aus seiner synthetisierten Workload rendert, und ein Recipe, das ein Chart aus einer Quelle rendert, sind verschiedene Formen, und ein für eines davon geschriebener Body artifacts: greift nach einer Säule, die das andere nie füllt.
Die Prüfung läuft, bevor der Eintrag ausgewertet wird, und diese Reihenfolge macht die Meldung nützlich. Eine fehlende Säule kommt im Template als leerer Wert an, daher würde der Build, der Auswertung überlassen, entweder nichts in die ausgegebene Datei einfügen oder mit dem fehlschlagen, was die Template-Engine zum Lesen eines Schlüssels aus dem Nichts sagt — und keines von beiden nennt die Säule oder die fehlende Deklaration. Das vorherige Zurückweisen lässt den Abbruch genau den Ausdruck nennen, der nach der Säule gegriffen hat, zitiert so, wie Sie ihn geschrieben haben.
Ein source:, das deklariert ist, aber zu einem leeren String gerendert wird, gilt als gar keine Quelle, weil die Prüfung die Quelle nach der Auswertung ihres eigenen Templates liest. Das ist derselbe Wert, aus dem der Provider anschließend rendert, daher hat ein Recipe, dessen source: zu nichts aufgelöst wurde, auch keine Quelle, die es einem Body artifacts: anbieten könnte.
Ausgegebene Meldung, in einer einzigen Form, wo auch immer der Eintrag artifacts: geschrieben wurde. Was sich ändert, ist nicht der Satz, sondern die Beschriftungen danach, die sagen, welches Dokument den Eintrag enthält.
Jeder fehlerhafte Verweis im Template wird genannt, daher meldet Ihnen ein Body, der nach zwei fehlenden Säulen greift, beide statt nur den, der zuerst kam. Jeder Verweis wird an dem Dokument gemeldet, das den Eintrag deklariert, zitiert so, wie Sie ihn geschrieben haben, und mit der Ausgabe beschriftet, zu der er gehört:
artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (das Artefakt-Template verweist auf eine Säule, die das Recipe nicht deklariert (mit dem angegebenen Ausdruck und dem angegebenen Artefakt))
Der Ausdruck nennt die Säule in seinem ersten Segment, und daran erkennen Sie, welche Deklaration fehlt: .source.chart greift nach source:, .workload.containers nach workload:.
Ein Eintrag, den das eigene Recipe einer Komponente deklariert, wird am Block artifacts: dieses Recipe gemeldet.
Ein Eintrag, den ein FeatureRecipe deklariert — als Feature an eine Komponente angebunden oder an einer Boundary deklariert —, wird gegen die Säulen geprüft, die dieses FeatureRecipe deklariert, statt gegen die der Host-Komponente, wird am Block artifacts: des FeatureRecipe gemeldet und trägt eine weitere Beschriftung, die die Anbindung nennt, die ihn bindet:
artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (das Artefakt-Template verweist auf eine Säule, die das Recipe nicht deklariert (mit dem angegebenen Ausdruck, dem angegebenen Artefakt und der angegebenen Anbindung))
Die Beschriftung der Anbindung sagt, was die Position allein nicht sagen kann: Eine Komponente kann mehrere Anbindungen tragen, und eine an einer Boundary deklarierte Anbindung erreicht jede Komponente, die die Boundary enthält. Der Satz selbst nennt auf beiden Wegen ein Recipe; erst die Position und die Beschriftung der Anbindung zusammen sagen, welches Dokument zu öffnen ist.
Wo ein Template mehrere Verweise nennt, erhält jeder eine eigene Meldung unter einer Zeile, die den gemeinsamen Eintrag nennt, und diese Zeile nennt auch das Dokument:
artifact <output-name> references pillars its Recipe does not declare (das angegebene Artefakt verweist auf Säulen, die sein Recipe nicht deklariert)
artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (das angegebene Artefakt verweist auf Säulen, die das von der angegebenen Anbindung gebundene FeatureRecipe nicht deklariert)
Jede dieser Meldungen trägt dieselbe Abbruchbedingung, gleich um welches Dokument es geht, daher sieht alles, was auf die Bedingung statt auf den Text abgleicht, keinen Unterschied zwischen ihnen.
So beheben Sie es: Deklarieren Sie entweder die Säule, die das Template liest, oder lesen Sie sie nicht mehr. Das Deklarieren ist die Lösung, wenn der Body artifacts: zu dieser Recipe-Form gehört — fügen Sie das workload: hinzu, das die Verweise des Templates auf Container, Ports oder Volumes erwarten, oder das source:, dessen Chart- oder Modulpfad es interpoliert. Das Entfernen des Verweises ist die Lösung, wenn der Body für ein anderes Recipe geschrieben wurde und ein Fragment wiederverwendet, das hier nicht zutrifft; wo der Wert tatsächlich von anderswo kommt, veröffentlichen Sie ihn über das provides: des produzierenden Knotens und lesen Sie ihn aus dem Inject-Kanal, statt nach einer Säule zu greifen, die dieses Recipe nicht füllt. Den Verweis mit einem Fallback-Wrapper abzusichern, beseitigt den Abbruch nicht — es fehlt die Säule, nicht der Schlüssel darunter —, und ebenso wenig das Verschieben des Verweises in einen anderen Eintrag desselben Recipe, weil jeder Eintrag in einem Block artifacts: gegen dieselben Säulen ausgewertet wird.
Dieser Abbruch unterscheidet sich von „Template references a root the render context does not define (Das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert)“ weiter oben, und es lohnt sich, die beiden auseinanderzuhalten, weil die Abhilfen verschieden sind. Jener greift bei einer Wurzel, die die Oberfläche gar nicht definiert, oder bei einem vertippten Schlüssel unter einer Säule mit fester Form — {{ .workload.containres }} in einem Recipe, das sehr wohl eine Workload deklariert. Dieser greift bei einem korrekt geschriebenen Verweis auf eine Säule, die schlicht nicht vorhanden ist.
A template reads a rendered name the node’s provider does not report (Ein Template liest einen gerenderten Namen, den der Provider des Knotens nicht meldet)
Ein Template liest {{ .context.rendered_name }} — den Namen, den der gebundene Provider der Ausgabe gibt, die er für den Knoten rendert, aus vom Autor gelieferter Quelle oder aus einer von ihm synthetisierten Workload — auf einem Knoten, dessen Provider keinen solchen Namen meldet. Der Verweis ist wohlgeformt, und der Schlüssel ist einer, den der Render-Kontext definiert; was fehlt, ist eine Antwort für diesen Knoten.
Die Zurückweisung existiert, weil die Alternative schlimmer ist als ein Abbruch. Der Name erreicht ein Template als einfacher String, daher würde ein Knoten ohne Namen den Verweis wegrendern und eine Adresse ausgeben, der ein Segment fehlt — .svc.cluster.local, wo ein Hostname gemeint war —, mit Exit-Code null und ohne etwas im Build, das man lesen könnte. Dieses Artefakt lässt sich bereitstellen, und was es benennt, existiert nicht. Das Zurückweisen, bevor irgendetwas ausgewertet wird, meldet den Fehler stattdessen an dem Template, das der Autor geschrieben hat.
Ob der Provider eines Knotens einen solchen Namen meldet, wird durch die Recipe-Bindung festgelegt, vor jeder Auswertung, daher wird hier nichts geraten.
Zwei Meldungen, und welche Sie erhalten, hängt vom Knoten ab, nicht davon, wo Sie den Verweis geschrieben haben. Ein Knoten, der keine eigene Quelle liefert, unter einem Provider, der keinen Namen für ihn meldet, hat Ressourcen, die nach seiner Identität benannt sind, daher gibt es einen korrekten Wert, und die Meldung nennt ihn. Ein Knoten, der sehr wohl Quelle liefert, unter einem Provider, der keinen Namen für ihn ableitet, hat keinen Ersatz — und dort die Identität anzubieten, würde Sie zu einem Wert schicken, der keine der Ressourcen dieses Knotens benennt, daher sagt die Meldung stattdessen genau das.
Ausgegebene Meldung, wenn der Knoten keine eigene Quelle liefert:
template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity (das Template liest den Namen, den das Ziel den Ressourcen gibt, die es für den Knoten rendert, und der Provider dieses Knotens meldet keinen solchen Namen; ein konformes Template liest einen Wert, den der eigene Provider des Knotens liefert (mit dem angegebenen Schlüssel und dem angegebenen Provider). Lesen Sie stattdessen den angegebenen Schlüssel: Dieser Knoten liefert keine eigene Quelle, daher sind seine Ressourcen nach der Identität des Knotens benannt)
Und wenn er sehr wohl Quelle liefert, unter einem Provider, der keinen solchen Namen ableitet:
template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here (das Template liest den Namen, den das Ziel den Ressourcen gibt, die es für den Knoten rendert, und der Provider dieses Knotens meldet keinen solchen Namen; ein konformes Template liest einen Wert, den der eigene Provider des Knotens liefert (mit dem angegebenen Schlüssel und dem angegebenen Provider). Schreiben Sie einen Wert, der nicht von einem Namen abhängt, den dieses Ziel ableitet: Es meldet keinen für die Ausgabe, die es aus gelieferter Quelle rendert, daher gibt es hier nichts dieser Art zu lesen)
Wo der Verweis in einem anderen Template als einem Eintrag provides: steht, nennt die Meldung zusätzlich das Feld, in dem er geschrieben wurde — field "valuesMapping", field "artifacts[probe.tf.json]" —, weil der Schlüssel eines Eintrags artifacts: ein Ausgabedateiname ist und das Zeichen enthält, mit dem die Position ihre eigenen Segmente trennt, daher endet die Position an dem Block, der den Eintrag enthält.
Welche Templates sie abdeckt: jedes Template, das ein Recipe inline schreibt — seine Einträge provides:, sein valuesMapping:, seinen Body workload:, jeden Eintrag artifacts: sowie with: und when: jedes Pipeline-Schritts. Eine Template-Oberfläche liegt außerhalb: Ein Eintrag valuesMapping:, workload: oder artifacts:, der über $import: geliefert wird — ob der Import eine lokale Datei oder einen Bibliothekseintrag nennt —, trägt im Recipe keinen Text, bis das Rendern ihn auflöst, daher wird ein Verweis in einem solchen Body als leerer Wert gerendert, statt abzubrechen.
So beheben Sie es: Lesen Sie den Schlüssel, den die Meldung nennt. Wo die Ausgabe Ihres Knotens etwas ist, das für ihn unter einem Provider gebaut wird, der keinen Namen meldet — eine synthetisierte Workload, eine platzierte Artefaktmenge —, ist {{ .context.instance_id }} der Name, den diese Ressourcen tatsächlich tragen, und er ist der richtige Wert, kein Fallback. Wo Ihr Knoten ein eigenes Chart oder Modul liefert und die Meldung keinen Ersatz anbietet, ist der Name, nach dem Sie gegriffen haben, keiner, den dieser Provider ableitet: Veröffentlichen Sie etwas, das nicht davon abhängt, oder benennen Sie die Ressource in der von Ihnen gelieferten Quelle und lesen Sie diesen Namen aus einem Wert zurück, den Sie selbst setzen. ../templates/rendered-resource-names.md legt dar, welche Provider einen Namen melden und, für jeden der anderen, warum es keinen zu meldenden gibt.
A template reads its callers’ render facts without declaring it (Ein Template liest die Render-Fakten seiner Aufrufer, ohne es zu deklarieren)
Ein Template in einem an eine Komponente angebundenen FeatureRecipe liest render_facts unter .context.used_by — das, was die Komponenten, die sich mit dem Host der Anbindung verbinden, über ihr eigenes Rendern gemeldet haben —, und das FeatureRecipe setzt readsCallerRenderFacts: true nicht.
Der Schlüssel entscheidet, wann die Anbindung gerendert wird. Ohne ihn wird die Anbindung direkt nach der Komponente gerendert, an die sie angebunden ist, und eine verbindende Komponente, die später in der Reihenfolge des Builds kommt, ist zu diesem Zeitpunkt noch nicht gerendert, daher kann das, was sie ausgegeben hat, nicht zum Lesen da sein. Das Zurückweisen des Templates, bevor irgendetwas gerendert wird, meldet die fehlende Deklaration an dem Feld, das Sie geschrieben haben, statt eines Builds, dessen Template liest, was einige seiner Aufrufer ausgegeben haben, und was andere nicht.
Ausgegebene Meldung:
template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (das Template liest die Render-Fakten seiner Aufrufer, aber das FeatureRecipe setzt readsCallerRenderFacts nicht (mit dem angegebenen Verweis und dem angegebenen Feld, in dem er geschrieben ist))
Der Verweis wird relativ zu der Verbindung zitiert, von der er gelesen wurde — .render_facts oder .render_facts.<name> —, weil ein Template die Aufrufer eine Verbindung nach der anderen liest, innerhalb von {{ range .context.used_by }} oder von einer Verbindung, die es auswählt. Das Feld nennt den Block, in dem das Template geschrieben wurde: valuesMapping, workload oder artifacts[<output-name>]. Ein with: oder when: eines Pipeline-Schritts, das dieselben Fakten liest, wird stattdessen vom nächsten Eintrag gemeldet, gleich was das FeatureRecipe setzt, weil das Setzen des Schlüssels einen Schritt sie nicht lesen ließe. Wo mehrere Felder die Fakten lesen, erhält jedes eine eigene Meldung unter einer Zeile, die nennt, was sie gemeinsam haben:
attachment templates reading their callers’ render facts without declaring it (Anbindungs-Templates, die die Render-Fakten ihrer Aufrufer lesen, ohne es zu deklarieren)
So beheben Sie es: Setzen Sie readsCallerRenderFacts: true im spec des FeatureRecipe. Das rendert seine Anbindungen, nachdem jede Komponente gerendert wurde, und ändert sonst nichts an dem, was sie rendern — siehe die FeatureRecipe-Entitätsseite. Der Schlüssel ist der Vertrag, und dieser Abbruch hilft Ihnen nur, ein Template zu finden, das ihn sichtbar braucht: Die Prüfung liest das Template so, wie es geschrieben ist, daher bricht ein Verweis, der während der Ausführung des Templates gebildet wird, oder einer, der in aus einer Datei oder einer Bibliothek importiertem Inhalt steht, nicht ab — setzen Sie den Schlüssel bei einem solchen FeatureRecipe trotzdem. Ein Template, das ein Feld namens render_facts von einer anderen Liste neben .context.used_by liest, bricht ebenfalls ab, und ebenso eines, das die eigenen Fakten seines Hosts als .render_facts innerhalb von {{ with .context }} daneben liest — schreiben Sie die eigenen des Hosts vollständig als .context.render_facts, was nie für die der Aufrufer gehalten wird; das Setzen des Schlüssels beseitigt beides ohne andere Kosten als das spätere Rendern.
Ein FeatureRecipe, das einmal pro Boundary rendert (executionScope: boundary), wird hier nicht geprüft: Die Templates, die seine Ressourcen erzeugen, haben kein .context zum Lesen, und ein Verweis darauf wird stattdessen als Feld außerhalb der Allowlist seines Geltungsbereichs zurückgewiesen.
A pipeline step reads its callers’ render facts (Ein Pipeline-Schritt liest die Render-Fakten seiner Aufrufer)
Das with: oder when: eines Pipeline-Schritts in einem FeatureRecipe, das an eine Komponente angebunden ist, liest render_facts unterhalb von .context.used_by — was die Komponenten, die sich mit dem Host der Anbindung verbinden, über ihr eigenes Rendern gemeldet haben.
Ein Pipeline-Schritt sieht diese Verbindungen nie. Ein Schritt darf die eigenen Dokumente der Host-Komponente umschreiben, und die eigene Ausgabe einer Komponente bleibt gleich, wer auch immer sich mit ihr verbindet, daher werden die Templates eines Schritts ohne .context.used_by ausgewertet — für jedes FeatureRecipe, ob es readsCallerRenderFacts: true setzt oder nicht. Dieser Schlüssel entscheidet, wann die Anbindung gerendert wird, nie, was ein Schritt sieht. Ein Schritt, der die Fakten seiner Aufrufer liest, würde daher nichts lesen, und der Build bricht ab, bevor irgendetwas gerendert wird, statt diesen Lesezugriff als leeren Wert zu rendern.
Ausgegebene Meldung:
pipeline step reads its callers’ render facts, but a pipeline step does not read the components connecting to its host; it reads only the host’s own render facts (<reference>, written in <field>) (der Pipeline-Schritt liest die Render-Fakten seiner Aufrufer, aber ein Pipeline-Schritt liest nicht die Komponenten, die sich mit seinem Host verbinden; er liest nur die eigenen Render-Fakten des Hosts (mit dem angegebenen Verweis und dem Feld, in dem er geschrieben ist))
Der Verweis wird relativ zu der Verbindung zitiert, von der er gelesen wurde — .render_facts oder .render_facts.<name> —, wie im Eintrag oben, und das Feld nennt den Schritt über seine ID: pipeline[<step>].with oder pipeline[<step>].when. Wo mehrere Schritte die Fakten lesen, erhält jeder eine eigene Meldung unter einer Zeile, die nennt, was sie gemeinsam haben:
pipeline steps reading their callers’ render facts (Pipeline-Schritte, die die Render-Fakten ihrer Aufrufer lesen)
So beheben Sie es: Lesen Sie in einem Schritt die eigenen Render-Fakten des Hosts unter .context.render_facts, vollständig ausgeschrieben — sie stammen aus dem eigenen Rendern des Hosts, daher macht ihr Lesen nichts davon abhängig, wer sich mit ihm verbindet. Lesen Sie die Fakten der Aufrufer stattdessen in den Templates, die die eigenen Ressourcen der Anbindung erzeugen — ihrem valuesMapping:, workload: oder artifacts: —, mit gesetztem readsCallerRenderFacts: true, wie es die FeatureRecipe-Entitätsseite beschreibt. Den Schlüssel allein zu setzen, beseitigt diesen Abbruch nicht. Die Prüfung liest das Template so, wie es geschrieben ist, mit den Grenzen, die der Eintrag oben beschreibt: Ein Verweis, der während der Ausführung des Templates gebildet wird, oder einer, der in aus einer Datei oder einer Bibliothek importiertem Inhalt geschrieben ist, bricht nicht ab, und ein Schritt, der ein Feld namens render_facts von einer anderen Liste neben .context.used_by liest oder die eigenen Fakten seines Hosts als .render_facts innerhalb von {{ with .context }} daneben, bricht ebenfalls ab.
Ein FeatureRecipe, das einmal für eine Boundary rendert (executionScope: boundary), wird hier nicht geprüft, aus dem Grund, den der Eintrag oben nennt.
A template reads its targets’ render facts without declaring it (Ein Template liest die Render-Fakten seiner Ziele, ohne es zu deklarieren)
Ein Template in einem FeatureRecipe, das an eine Komponente angebunden ist, liest render_facts unterhalb von .context.uses — was die Komponenten, mit denen der Host der Anbindung verdrahtet ist, über ihr eigenes Rendern gemeldet haben —, und das FeatureRecipe setzt readsTargetRenderFacts: true nicht.
Der Schlüssel entscheidet zwei Dinge. Er lässt die Anbindung rendern, sobald jede Komponente gerendert hat: Ohne ihn wird die Anbindung direkt nach der Komponente gerendert, an die sie angebunden ist, und ein Ziel, das später in der Reihenfolge des Builds kommt, ist zu diesem Zeitpunkt noch nicht gerendert. Und er ist das, was die Fakten jedes Ziels auf die Verbindungen legt, die die Anbindung liest: Ohne ihn trägt kein Eintrag von .context.uses überhaupt .render_facts. Das Template zurückzuweisen, bevor irgendetwas gerendert wird, meldet die fehlende Deklaration an dem Feld, das Sie geschrieben haben, statt eines Builds, dessen Template nichts liest, wo es die Fakten eines Ziels erwartet hat.
Ausgegebene Meldung:
template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (das Template liest die Render-Fakten einer Komponente, mit der sein Host verdrahtet ist, aber das FeatureRecipe setzt readsTargetRenderFacts nicht (mit dem angegebenen Verweis und dem Feld, in dem er geschrieben ist))
Der Verweis ist der, den das Template geschrieben hat: vollständig unterhalb des Alias einer Verbindung — .context.uses.<alias>.render_facts oder .context.uses.<alias>.render_facts.<name> — oder, wo das Template die Verbindungen einzeln liest, innerhalb von {{ range .context.uses }}, {{ with .context.uses.<alias> }} oder von einer Verbindung, die es auswählt, relativ zu dieser Verbindung: .render_facts oder .render_facts.<name>. Das Feld nennt den Block, in dem das Template geschrieben wurde: valuesMapping, workload oder artifacts[<output-name>]. Ein with: oder when: eines Pipeline-Schritts, das dieselben Fakten liest, wird stattdessen vom nächsten Eintrag gemeldet, gleich was das FeatureRecipe setzt. Wo mehrere Felder die Fakten lesen, erhält jedes eine eigene Meldung unter einer Zeile, die nennt, was sie gemeinsam haben:
attachment templates reading the render facts of the components their host is wired to, without declaring it (Anbindungs-Templates, die die Render-Fakten der Komponenten lesen, mit denen ihr Host verdrahtet ist, ohne es zu deklarieren)
So beheben Sie es: Setzen Sie readsTargetRenderFacts: true im spec des FeatureRecipe — readsCallerRenderFacts: true beseitigt diesen Abbruch nicht, da es Fakten auf die Komponenten legt, die sich mit dem Host verbinden, statt auf die, mit denen er verdrahtet ist. Das rendert seine Anbindungen, nachdem jede Komponente gerendert hat, legt die Fakten jedes Ziels auf seine Verbindung und ändert sonst nichts daran, was sie rendern — siehe die FeatureRecipe-Entitätsseite. Der Schlüssel ist der Vertrag, und dieser Abbruch hilft Ihnen nur, ein Template zu finden, das ihn sichtbar braucht: Die Prüfung liest das Template so, wie es geschrieben ist, daher bricht ein Verweis, der während der Ausführung des Templates gebildet wird, oder einer, der in aus einer Datei oder einer Bibliothek importiertem Inhalt geschrieben ist, nicht ab — setzen Sie den Schlüssel bei einem solchen FeatureRecipe trotzdem. Ein Template, das .context.uses überhaupt liest und außerdem ein Feld namens render_facts von einem anderen Wert liest — darunter die Fakten eines Aufrufers innerhalb von {{ range .context.used_by }} —, bricht ebenfalls ab; setzen Sie den Schlüssel, und auch readsCallerRenderFacts, wo das Template die Fakten seiner Aufrufer liest.
Ein FeatureRecipe, das einmal für eine Boundary rendert (executionScope: boundary), wird hier nicht geprüft, aus dem Grund, den der Eintrag zu den Aufrufern oben nennt.
A pipeline step reads its targets’ render facts (Ein Pipeline-Schritt liest die Render-Fakten seiner Ziele)
Das with: oder when: eines Pipeline-Schritts in einem FeatureRecipe, das an eine Komponente angebunden ist, liest render_facts unterhalb von .context.uses — was die Komponenten, mit denen der Host der Anbindung verdrahtet ist, über ihr eigenes Rendern gemeldet haben.
Ein Schritt liest die Verbindungen, die sein Host herstellt, so wie das eigene Recipe des Hosts sie liest, und nie die Render-Fakten ihrer Ziele — für jedes FeatureRecipe, ob es readsTargetRenderFacts: true setzt oder nicht. Ein Schritt darf die eigenen Dokumente der Host-Komponente umschreiben, und das eigene Rendern des Hosts liest, was seine Ziele veröffentlichen, nie, was sie ausgegeben haben, daher werden die Templates eines Schritts ohne diese Fakten ausgewertet. Ein Schritt, der sie liest, würde daher nichts lesen, und der Build bricht ab, bevor irgendetwas gerendert wird, statt diesen Lesezugriff als leeren Wert zu rendern.
Ausgegebene Meldung:
pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host’s own render facts (<reference>, written in <field>) (der Pipeline-Schritt liest die Render-Fakten einer Komponente, mit der sein Host verdrahtet ist, aber ein Pipeline-Schritt liest nur die eigenen Render-Fakten des Hosts (mit dem angegebenen Verweis und dem Feld, in dem er geschrieben ist))
Der Verweis wird wie im Eintrag oben zitiert, und das Feld nennt den Schritt über seine ID: pipeline[<step>].with oder pipeline[<step>].when. Wo mehrere Schritte die Fakten lesen, erhält jeder eine eigene Meldung unter einer Zeile, die nennt, was sie gemeinsam haben:
pipeline steps reading the render facts of the components their host is wired to (Pipeline-Schritte, die die Render-Fakten der Komponenten lesen, mit denen ihr Host verdrahtet ist)
So beheben Sie es: Lesen Sie in einem Schritt die eigenen Render-Fakten des Hosts unter .context.render_facts, vollständig ausgeschrieben. Lesen Sie die Fakten der Ziele stattdessen in den Templates, die die eigenen Ressourcen der Anbindung erzeugen — ihrem valuesMapping:, workload: oder artifacts: —, mit gesetztem readsTargetRenderFacts: true, wie es die FeatureRecipe-Entitätsseite beschreibt. Den Schlüssel allein zu setzen, beseitigt diesen Abbruch nicht. Die Prüfung liest das Template so, wie es geschrieben ist, mit den Grenzen, die der Eintrag oben beschreibt.
Ein FeatureRecipe, das einmal für eine Boundary rendert (executionScope: boundary), wird hier nicht geprüft, aus dem Grund, den der Eintrag zu den Aufrufern oben nennt.
Cross-node type safety violation via selector: (Verletzung der knotenübergreifenden Typsicherheit über selector)
Ein einziger Abbruch deckt die beiden Label-Ausdrücke ab, die ein Katalogautor schreibt, um einzuschränken, was verdrahtet oder angebunden werden darf, weil beide auf dieselbe Weise scheitern: eine Label-Menge, die einen Ausdruck nicht erfüllt, den eine Katalogentität deklariert hat.
Eine Kante uses:, deren Ziel den selector: ihres Sockets nicht erfüllt. Ein Socket usesSchema deklariert ein Feld selector:, das die Ziel-Component am anderen Ende der Kante ausschließt. Der Selektor ist die Art des Katalogautors zu sagen: „Dieser Socket akzeptiert nur Ziele, deren Labels zu diesem Ausdruck passen“; eine Kante, die die Suche nach dem Socket-Namen erfüllt, den Selektor-Ausdruck aber nicht, ist eine Verletzung der Typsicherheit.
Ausgegebene Meldung:
selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them. (Selektor-Verletzung (der angegebene Ausdruck, deklariert am angegebenen Socket, wird von den Labels des angegebenen Ziels nicht erfüllt). Fügen Sie dem Komponententyp des Ziels die Labels hinzu, die der Selektor verlangt, oder verdrahten Sie den Socket mit einer Komponente, die sie bereits trägt.)
Eine Anbindung, deren Komponente das appliesTo: des Feature nicht erfüllt. Ein Feature deklariert, an welche Komponenten es angebunden werden darf, über appliesTo: und über appliesToAnyOf:. Die Anforderungen des einzelnen Ausdrucks gelten zusammen, und die Alternativen gelten alternativ, wobei jede einzelne genügt; beide Oberflächen müssen erfüllt sein, und eine Oberfläche, die das Feature weglässt, wird von allem erfüllt. Eine Anbindung, deren Komponente Labels trägt, die die Deklaration des Feature nicht zulässt, ist dieselbe Klasse von Verletzung wie der Fall der Kante oben.
Ausgegebene Meldung:
selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies. (Selektor-Verletzung (der angegebene appliesTo-Ausdruck, deklariert vom angegebenen Feature, wird von den Labels der angegebenen Komponente nicht erfüllt). Fügen Sie dem Typ dieser Komponente die Labels hinzu, die das appliesTo des Feature verlangt, oder binden Sie ein Feature an, dessen Anwendbarkeit die Komponente bereits erfüllt.)
Jeder der beiden Ausdrücke kann auch in einer Form geschrieben sein, die die Label-Grammatik überhaupt nicht lesen kann. Das wird als derselbe Abbruch gemeldet, dessen letzter Wert der Grund ist, warum er nicht gelesen werden konnte, statt der Label-Menge, von der er nicht erfüllt wurde — und genau das unterscheidet einen Ausdruck, der nicht ausgewertet werden konnte, von einem, der ausgewertet wurde und falsch ergab:
selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (Selektor-Verletzung (der angegebene appliesTo-Ausdruck, deklariert vom angegebenen Feature, der aus dem angegebenen Grund nicht ausgewertet werden konnte). Korrigieren Sie den appliesTo-Selektor an der Katalogentität des Feature.)
Auch ein Socket-Selektor, den die Grammatik nicht lesen kann, wird zurückgewiesen, bevor irgendetwas den Socket verdrahtet.aggrega validate liest über den gesamten Katalog oder über eine einzelne Component oder ein einzelnes Feature jeden Socket-Selektor, den das eigene Dokument der Entität deklariert, und weist einen, den die Grammatik nicht lesen kann, unter genau dieser Bedingung zurück, ob nun eine Kante durch den Socket verdrahtet ist oder nicht:
selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (Selektorverletzung, deklariert auf dem Socket, der nicht ausgewertet werden konnte. Korrigieren Sie den Selektor in der Deklaration des Sockets im usesSchema des Komponententyps.)
Bei einem Socket eines Feature nennt die Abhilfe stattdessen das usesSchema des Feature. Nichts hat den Socket verdrahtet, daher liegt der Fehler bei der Katalog-Entität: Er wird als CATALOG_ERROR eingestuft und nennt die Datei der Entität.
Der Abbruch trägt den verfassten Schlüssel, um den es geht — den Socket-Eintrag uses: oder den Eintrag features:, der die Anbindung nennt —, zusammen mit der Datei, die ihn deklariert, sodass die Position, die er meldet, der Eintrag ist, den Sie bearbeiten, statt des Anfangs des Dokuments. Eine Component, die innerhalb eines Subsystems verfasst ist, wird an dem Subsystem positioniert, unter dem sie verfasst wurde, Ebene für Ebene. Eine Anbindung wird an dem Eintrag features: positioniert, der sie geschrieben hat, in dem Dokument, das sie geschrieben hat, und dem Autor dieses Dokuments zugeordnet: dem eigenen Block der Komponente oder dem Block eines Subsystems im Aggregate, ein Entwicklerfehler; und, bei einer Anbindung, die nur das Release vornimmt, seinem Eintrag für die Komponente oder dem Block features: einer Boundary, die die Komponente enthält, ein Operatorfehler. Wo beide Dokumente die Anbindung schreiben, wird sie dort positioniert, wo ihr type genannt wird, was das Aggregate immer tut. Eine Anbindung, die an einer Verbindung geschrieben ist, wird an ihrem Schlüssel unter dem features: dieser Verbindung positioniert, in dem Dokument, das sie geschrieben hat — dem Verbindungseintrag des Aggregate oder dem Eintrag pro Kante des Release bei einer Anbindung, die nur das Release vornimmt. Für ein Feature, das allein das Release an eine Komponente anbindet, die seine Deklaration nicht zulässt, lautet die Meldung:
[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.
und für dieselbe Anbindung, im Aggregate an der Komponente geschrieben, lautet sie [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics. Eine Anbindung, die die annotationsgesteuerte Erweiterung erzeugt hat, wurde von keinem Eintrag features: geschrieben, daher wird sie am eigenen Schlüssel features: der Komponente in dem Dokument positioniert, das die Komponente deklariert, als Entwicklerfehler.
So beheben Sie eine Kanten-Verletzung: Leiten Sie entweder die Kante uses: zu einer Component, deren Labels den Selektor erfüllen, oder passen Sie den Selektor-Ausdruck in der Katalogentität so an, dass er die beabsichtigte Zielklasse akzeptiert. Prüfen Sie die metadata.labels der Ziel-Component mit aggrega inspect, um zu bestätigen, welche Labels sie trägt.
So beheben Sie eine Anbindungs-Verletzung: Binden Sie das Feature entweder an eine Komponente an, deren Labels seine Deklaration zulässt, oder erweitern Sie das appliesTo: des Feature — indem Sie unter appliesToAnyOf: eine Alternative hinzufügen, wo das Feature tatsächlich mehr als eine Komponentenklasse bedient. Wo die Komponente die Bedingungen erfüllen soll und es nicht tut, ist das fehlende Stück meist ein Label: Prüfen Sie sie mit aggrega inspect und fügen Sie an den metadata.labels der Component hinzu, was der Ausdruck verlangt.
Unknown provider (Unbekannter Provider)
Ein Recipe deklariert capability: <name>, wobei <name> keinen Provider nennt, den der Compiler bedient. Der Compiler kann das Rendern nicht an einen Provider weiterleiten, von dem er nie gehört hat.
Ausgegebene Meldung:
unknown provider: <provider-name> (unbekannter Provider: der angegebene Name)
So beheben Sie es: Prüfen Sie, ob der Provider-Name richtig geschrieben ist — cloudformation, compose, helm, helm-chart und terraform sind die Namen, die die eingebetteten Provider-Plugins bedienen. Wenn Sie einen eigenen Unternehmens-Provider beabsichtigt haben, stellen Sie sicher, dass ein Provider-Rendering-Plugin, das diesen Namen bedient (pluginType: provider mit dem Namen in seinen spec.provider.capabilities), in dem Katalog-Workspace vorhanden ist, auf den der Build zeigt.
A capability is served by more than one provider plugin (Eine Fähigkeit wird von mehr als einem Provider-Plugin bedient)
Ein Build erreicht eine Fähigkeit — oder ein Pull löst eine auf —, die von mehr als einem Provider-Rendering-Plugin bedient wird (pluginType: provider, jedes mit dieser Fähigkeit in seinen spec.provider.capabilities), und der Workspace hat nicht ausgewählt, welches sie rendert. Statt willkürlich einen Provider zu wählen, bricht der Build ab und nennt beide Kandidaten. Ein Katalog, der zwei Plugins für dieselbe Fähigkeit enthält, ist zulässig — zwei Herausgeber können jeweils ein Plugin für helm oder compose ausliefern, und der Katalog akzeptiert beide. Die Mehrdeutigkeit tritt erst am Ort der Verwendung zutage: Der Abbruch erfolgt, wenn ein Build oder Pull die umstrittene Fähigkeit tatsächlich erreicht, nicht zur Ladezeit.
Ausgegebene Meldung. Die Regel, die den Build abgebrochen hat, steht vorn, und die Einzelheiten — welche Fähigkeit, welche Kandidaten und die zu schreibende Bindung — folgen ihr:
capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one (die Fähigkeit wird von mehr als einem Provider-Plugin bedient; fügen Sie einen Eintrag plugins.providers hinzu, um eines auszuwählen: Die angegebene Fähigkeit wird von mehr als einem Provider-Plugin bedient (den angegebenen); fügen Sie für die angegebene Fähigkeit einen Eintrag plugins.providers hinzu, der eines auswählt)
So beheben Sie es: Fügen Sie in der Workspace-Konfiguration einen Eintrag plugins.providers hinzu, dessen Schlüssel die Fähigkeit ist und dessen Wert die Plugin-Identität auswählt, die sie rendert. Behalten Sie beide Plugins im föderierten Katalog; die Bindung teilt diesem Workspace mit, an welches er die umstrittene Fähigkeit weiterleitet.
The plugin serving a provider cannot assemble what that provider combines (Das Plugin, das einen Provider bedient, kann nicht assemblieren, was dieser Provider kombiniert)
Ein Provider gibt an, was aus der knotenweisen Ausgabe einer Weiterleitungsgruppe wird: die Ausgabe jedes Knotens direkt am Weiterleitungspfad geschrieben, die Fragmente zu einem Dokument zusammengeführt oder jeder Knoten an einer eigenen Position innerhalb einer umschließenden Struktur platziert. Wo ein Provider angibt, dass die Ausgabe kombiniert wird — eine zusammengeführte Compose-Datei, ein Umbrella-Chart —, muss das Plugin, das ihn bedient, den Export anbieten, der das Kombinieren übernimmt. Dieser Abbruch greift dort, wo es das nicht tut: Das Plugin kündigt knotenweises Rendern an (render_node) und kein passendes assemble_boundary, sodass die Knoten der Gruppe gerendert werden können, ihre Ausgabe aber nicht zusammengeführt werden kann.
Beide Hälften dieser Unstimmigkeit gehören zum Plugin. Was aus der Ausgabe einer Weiterleitungsgruppe wird, ist Teil dessen, was das Plugin beim Laden über sich selbst meldet, und der Export, der das Kombinieren übernehmen würde, ist einer der Einträge unter spec.exports einer Plugin-Entität, abgeglichen mit eben dieser Meldung — daher nennt der Abbruch ein Plugin, das eine Assemblierung beansprucht, die seine Export-Oberfläche nicht bereitstellt.
Der Build bricht ab, statt die Assemblierung zu überspringen. Würde sie übersprungen, würde das Fragment jedes Knotens an den Pfad geschrieben, an dem ein einziges Artefakt erwartet wurde, und ein Erfolg gemeldet, und nichts weiter hinten kann diese Fragmente von der flachen knotenweisen Ausgabe unterscheiden, die ein Provider, der keine Assemblierung beansprucht, bewusst ausgibt — ein fehlendes Artefakt käme daher erst dort zum Vorschein, wo die Ausgabe angewendet wird, statt zur Build-Zeit.
Eine Weiterleitungsgruppe ohne Weiterleitungspfad wird übergangen. An keinem Pfad geschriebene Ausgabe ist knotenweise Ausgabe, daher wird dort nichts assembliert, worüber ein Anspruch auf Kombinieren bestimmen könnte.
Ausgegebene Meldung — ein Befund je betroffener Weiterleitungsgruppe, der den Provider und den Pfad nennt, an dem diese Gruppe assembliert:
provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (der Provider, der seine Weiterleitungsgruppe assemblieren sollte, stellt keinen Boundary-Assembler bereit (mit dem angegebenen Provider und Weiterleitungspfad))
Ist mehr als eine Weiterleitungsgruppe betroffen, kommen die Befunde gemeinsam unter der Meldung dispatch groups whose provider offers no boundary assembler an.
So beheben Sie es: Bedienen Sie die Fähigkeit mit einem Plugin, das sowohl render_node als auch assemble_boundary ankündigt — siehe ../entities/plugin.md zur Autorenoberfläche spec.exports und ../schema/plugins/wasm-provider.md dazu, was der Assemblierungs-Export erhält. Wenn Sie das Plugin selbst verfassen, liegt es bei Ihnen, beide Seiten in Einklang zu bringen: Fügen Sie den Assemblierungs-Export hinzu, oder melden Sie keinen Assemblierungsanspruch und lassen Sie die Ausgabe jedes Knotens unzusammengeführt am Weiterleitungspfad landen. Wenn Sie ein veröffentlichtes Plugin verwenden, wählen Sie eine Version, die beide Exporte anbietet, oder wählen Sie ein Plugin, dessen Provider für diese Fähigkeit keine Assemblierung beansprucht.
A boundary-level Feature’s output reaches no assembled file (Die Ausgabe eines Feature auf Boundary-Ebene erreicht keine assemblierte Datei)
Ein Feature, das unter dem features: einer Boundary angebunden ist und dessen FeatureRecipe executionScope: boundary deklariert, rendert einmal für die gesamte Boundary, und seine Ausgabe geht in das Verzeichnis, zu dem directory: und subDirectory: der Boundary für es ausgewertet werden. Ein Provider, der seine Ausgabe in ein Dokument zusammenführt — compose in eine docker-compose.yaml, cloudformation in einen Stack —, schreibt den Beitrag eines solchen Feature nur als Teil der Datei, die er dort aus den Komponenten der Boundary assembliert. Diese Datei existiert nur dort, wo die Ausgabe mindestens einer Komponente im selben Verzeichnis unter demselben Provider landet.
Sie existiert nicht, wo die Komponenten der Boundary woanders landen: wenn sie in verschachtelten Boundaries liegen, deren subDirectory: sie anderswohin schickt — etwa "{{ .component_id }}", sodass jede Komponente eine eigene Datei erhält —, oder unter einem Verzeichnis, das die Ausgabe des Feature nicht teilt. Im Verzeichnis des Feature wird nichts assembliert, daher würde seine Ausgabe nirgendwohin geschrieben — bei der Compose-Bridge ein Gateway-Service, den keine Datei enthält —, und der Build würde einen Erfolg melden. Stattdessen bricht der Build ab.
Ein Feature, dessen Provider jeden Beitrag als eigene Dateien schreibt — helm, helm-chart und terraform —, ist nicht betroffen: Diese Dateien werden geschrieben, ob daneben etwas assembliert wird oder nicht.
Ausgegebene Meldung — ein Befund je betroffenem Feature, positioniert an seinem Eintrag unter dem features: der Boundary, der die Boundary, das Feature, den Weiterleitungspfad, an den seine Ausgabe geleitet wurde, und den Provider nennt:
boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to (die Ausgabe des Feature auf Boundary-Ebene wird an einen Weiterleitungspfad geleitet, an dem nichts assembliert wird (mit den angegebenen Werten für Boundary, Feature-Instanz, Weiterleitungspfad und Provider). binden Sie das Feature an eine Boundary an, deren Ausgabepfad auch ihre Komponenten erhält, oder geben Sie den Komponenten der Boundary das Verzeichnis, an das die Ausgabe des Feature geleitet wird)
Eine Compose-Bridge, die an einer übergeordneten Boundary bridge angebunden ist, deren einzige untergeordnete Boundary jede Komponente unter subDirectory: "{{ .component_id }}" platziert, gibt aus:
[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to
Ist mehr als ein Feature betroffen, kommen die Befunde gemeinsam unter der Meldung boundary-level Features whose output is routed to a dispatch path nothing assembles an.
So beheben Sie es: Sorgen Sie dafür, dass das Verzeichnis des Feature eines ist, in dem auch die Komponenten seiner Boundary landen. Binden Sie das Feature entweder an eine Boundary an, deren eigener Ausgabepfad diese Komponenten erhält, oder geben Sie den Komponenten das Verzeichnis, an das die Ausgabe des Feature geleitet wird — für untergeordnete Boundaries directory: "{{ .parent_boundary.directory }}" ohne eigenes subDirectory:, sodass sie die Datei der übergeordneten Boundary teilen. Die Meldung nennt das Verzeichnis, an das die Ausgabe des Feature geleitet wurde; dieses ist zu teilen.
Path-template references a variable outside the allowlist (Das Pfad-Template verweist auf eine Variable außerhalb der Allowlist)
Ein Template directory: oder subDirectory: verweist auf einen Variablennamen, den die Allowlist der Pfad-Template-Variablen nicht enthält — zum Beispiel einen Tippfehler wie {{ .parmaeters.region }} oder ein Feld, das im Render-Kontext des Recipe existiert, Pfad-Templates aber nicht zur Verfügung gestellt wird (etwa .context.inject oder .values). Derselbe Abbruch deckt {{ .component_id }} in einem Template directory: ab: Die Variable existiert, und Templates subDirectory: dürfen sie lesen, aber das directory: einer Boundary wird einmal für die gesamte Boundary ausgewertet statt einmal je Komponente, sodass eine komponentenbezogene Variable dort den ausgegebenen Pfad davon abhängig machen würde, welche Komponente zufällig zuerst ausgewertet wurde.
Pfad-Templates werden zur Parse-Zeit validiert, bevor irgendeine Rendering-Arbeit beginnt, und zwar gegen die Variablen, die der Pfad-Template-Kontext definiert, abzüglich derer, die die jeweilige Oberfläche zurückweist. Der Compiler wertet Pfad-Templates außerdem mit der Semantik missingkey=error aus, sodass ein Verweis, der in der Allowlist steht, zur Auswertungszeit aber nicht definiert ist, einen expliziten Fehler erzeugt, statt stillschweigend eine leere Zeichenkette in einen Verzeichnispfad zu rendern.
Dieser Abbruch betrifft die Variable. Ein vertippter Schlüssel unter einer zugelassenen Variable — {{ .manifest.recipe_nmae }} — meldet stattdessen „Template references a root the render context does not define (Das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert)“ weiter oben und nennt die Schlüssel, die .manifest definiert, weil die Variable selbst zugelassen wurde und nur der Schlüssel falsch war.
Ausgegebene Meldung:
path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>") (das Pfad-Template verweist auf ein Feld, das nicht in der dokumentierten Allowlist steht (mit dem angegebenen Pfad, geschrieben im angegebenen Feld; der Render-Kontext definiert die angegebenen Variablen))
So beheben Sie es: Korrigieren Sie den Feldnamen zu einem aus der Allowlist der Pfad-Templates, oder entfernen Sie den Verweis. Die Allowlist für directory: ist {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }} und {{ .parent_boundary.* }}; subDirectory: fügt {{ .component_id }} hinzu. Andere Oberflächen (valuesMapping des Recipe, injectMapping des FeatureRecipe usw.) verwenden eine andere Kontextform; Verweise auf .context.*, .values, .infra oder .locals werden Pfad-Templates bewusst nicht zur Verfügung gestellt, weil die Pfadausgabe eine strukturelle Angelegenheit ist und keine Angelegenheit des Renderns von Werten.
Path collision: two contributors emit at incompatible paths (Pfadkollision: Zwei Beitragende geben an inkompatiblen Pfaden aus)
Zwei Boundaries, deren Pfaddeklarationen zum selben Assemblierungspfad ausgewertet werden, laufen über verschiedene Provider. Beide assemblieren dort, und jeder schreibt Dateien, von denen der andere nichts weiß, sodass der eine den anderen stillschweigend auf dem Datenträger verdrängt — und der Build, der die verdrängte Ausgabe erzeugt hat, sieht aus, als sei er erfolgreich gewesen.
Das standardmäßige subDirectory: gibt jedem Provider einen eigenen Unterpfad, sodass zwei Provider nur dort einen Pfad erreichen, wo die Deklarationen so geschrieben wurden, dass sie gleich ausgewertet werden: etwa zwei Boundaries, die sich ein directory: teilen und beide subDirectory: auf dasselbe Literal festlegen.
Ausgegebene Meldungen. Je beitragender Boundary wird ein Befund gemeldet, sodass jede Boundary, deren Ausgabe den Pfad erreicht hat, für sich genannt wird, statt in einer Liste innerhalb einer Meldung zusammengefasst zu werden. Der Fehler besteht darin, dass zwei Provider an einem Pfad aufeinandertreffen, daher gibt es immer mindestens zwei Befunde, und sie kommen gemeinsam unter einer Meldung an, die angibt, was sie gemeinsam haben:
assembly paths reached by more than one provider (Assemblierungspfade, die von mehr als einem Provider erreicht werden)
Jeder Befund nennt den Pfad, die Boundary, deren Ausgabe ihn erreicht hat, und den Provider, über den diese Boundary läuft:
dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (der Weiterleitungspfad hat mehrere Provider-Ausgaben erzeugt (mit dem angegebenen Pfad, der angegebenen Boundary und dem angegebenen Provider))
Ein Build, dessen Boundaries api-net und db-net beide directory: ./dist/shared und subDirectory: merged deklarieren, die eine über helm und die andere über compose geleitet, gibt aus:
Die Meldung trägt den Kurzcode, und jeder Befund darunter trägt nur seine Kategorie; das ist die Form, die jede Meldung gesammelter Fehler verwendet — siehe error-translation.md zu dieser Grammatik.
So beheben Sie es: Geben Sie entweder jeder Boundary ein eigenes directory: (sodass sie an getrennten Pfaden assemblieren), oder belassen Sie subDirectory: auf seinem Standardwert, sodass die Ausgabe jedes Providers an einem eigenen Unterpfad landet. Das Compose-Bridge-Muster legt absichtlich zwei Unter-Boundaries auf einen Assemblierungspfad zusammen; dieses Muster setzt voraus, dass beide Boundaries denselben Provider ansteuern und kompatible, kaskadierend aufgelöste Annotationen tragen.
A boundary’s output directory is not a directory beneath the output root (Das Ausgabeverzeichnis einer Boundary ist kein Verzeichnis unterhalb der Ausgabewurzel)
directory: und subDirectory: einer Boundary werden ausgewertet und zu dem Verzeichnis zusammengesetzt, unter dem ihre Ausgabe geschrieben wird, und dieser Pfad wird einmal bereinigt: out/a, out//a, ./out/a und out/a/ sind ein Verzeichnis. Ist der bereinigte Pfad kein Verzeichnis unterhalb der Ausgabewurzel, stoppt der Build, bevor irgendetwas geschrieben wird. Das ist ein Pfad, der aus der Ausgabewurzel hinaussteigt (.., ../escape, a/../..), ein absoluter (/srv/out) oder einer, der überhaupt kein Verzeichnis nennt: ein leerer Wert oder einer, der sich zur Ausgabewurzel selbst bereinigt, etwa directory: "." bei deaktiviertem Unterverzeichnis.
Der Pfad wird so geprüft, wie er ausgewertet wurde, sodass das Ergebnis eines Templates beurteilt wird, nicht der geschriebene Text. Die Meldung nennt das Feld, aus dem der Fehler stammt — directory:, wo bereits das Verzeichnis allein die Ausgabewurzel verlässt oder wo kein Unterverzeichnis daran angefügt wird, andernfalls subDirectory: —, zusammen mit dem Wert, zu dem dieses Feld ausgewertet wurde, und dem Pfad, den es erzeugt hat.
Ausgegebene Meldung:
boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself (das Ausgabeverzeichnis der Boundary nennt kein Verzeichnis unterhalb der Ausgabewurzel (mit dem angegebenen Release, der angegebenen Boundary, dem angegebenen Wert von directory und dem angegebenen Ausgabepfad). schreiben Sie ein Verzeichnis unterhalb der Ausgabewurzel, etwa „deploy/prod“ — ohne führendes „/“, ohne „..“, das darüber hinaussteigt, und nicht die Ausgabewurzel selbst)
Liegt der Fehler beim Unterverzeichnis, lautet der dritte Wert stattdessen subDirectory: "<value>".
So beheben Sie es: Schreiben Sie das Feld, das die Meldung nennt, als Verzeichnis unterhalb der Ausgabewurzel. Ein Verzeichnis, das neben der Ausgabewurzel liegen soll, gehört stattdessen in sie hinein. Um die Ausgabe einer Boundary direkt in ihr directory: zu schreiben, setzen Sie subDirectory: "." — das Verzeichnis selbst muss dennoch ein eigenes Verzeichnis nennen.
A boundary-level Feature is named . or .. (Ein Feature auf Boundary-Ebene heißt . oder ..)
Ein Provider, der jedem Beitragenden ein eigenes Verzeichnis gibt — terraform unter modules/ und helm-chart unter charts/ —, platziert ein an einer Boundary angebundenes Feature in einem Verzeichnis, das allein nach der Instanz benannt ist, neben den Komponenten der Boundary. Der Schlüssel features: einer Boundary lässt . und .. zu, und keiner davon ist ein Verzeichnisname: . würde die Dateien des Feature in das Verzeichnis legen, das alle Beitragenden enthält, und .. in das darüberliegende, sodass die Dateien außerhalb der Position landen würden, die der Provider dem Feature gegeben hat. Stattdessen stoppt der Build. Jeder andere Name bleibt unberührt, einschließlich eines Namens mit Punkt wie audit.v2.
Ausgegebene Meldung:
boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit” (der Instanzname des Feature auf Boundary-Ebene ist kein Verzeichnisname (mit dem angegebenen Release, der angegebenen Boundary und der angegebenen Feature-Instanz). benennen Sie die Feature-Instanz unter den features der Boundary in einen gewöhnlichen Namen um, etwa „audit“)
So beheben Sie es: Benennen Sie die Instanz unter dem features: der Boundary in einen gewöhnlichen Namen um.
Instance-ID collision across boundaries assembling to the same path (Instanz-ID-Kollision zwischen Boundaries, die am selben Pfad assemblieren)
Zwei Boundaries, die zum selben Tupel (Pfad, Provider) assemblieren, steuern Komponenten mit identischen Instanz-IDs bei. Die zusammengeführte Assemblierung kann die beiden Komponentenfragmente nicht unterscheiden — ein einzelnes Helm-Chart kann nicht zwei Deployments namens web-server enthalten, und eine einzelne docker-compose-Datei kann nicht zwei Services namens api enthalten.
Ausgegebene Meldung:
multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group (mehrere Beitragende teilen sich eine Instanz-ID am selben Weiterleitungspfad: der angegebene Weiterleitungspfad und Provider enthalten bereits den angegebenen Knoten (mit den angegebenen beitragenden Boundaries); Komponenten-Instanz-IDs müssen innerhalb einer Assemblierungsgruppe eindeutig sein)
So beheben Sie es: Benennen Sie eine der kollidierenden Komponenten im Aggregate um, oder teilen Sie die beiden Boundaries auf getrennte Pfade mit directory: auf, sodass jede Komponenteninstanz in ihrer eigenen Assemblierung landet.
Two contributors write the same output path (Zwei Beitragende schreiben denselben Ausgabepfad)
Zwei Beitragende zu einer Assemblierung erzeugen eine Datei am selben Ausgabepfad. Das unterscheidet sich von der Instanz-ID-Kollision oben: Die Komponenten sind unterschiedlich benannt, und die Assemblierung kann sie auseinanderhalten — es sind die Dateien, die sie ausgeben, die auf einem Pfad landen. Das geschieht am häufigsten dort, wo ein Provider die Ausgabe jedes Beitragenden nebeneinander schreibt statt unter einer Position pro Komponente, sodass zwei Komponenten, deren Recipes denselben Dateinamen ausgeben (etwa zwei Einträge artifacts:, die beide main.tf heißen), an einem Pfad aufeinandertreffen. Die eigene Ausgabe des Assemblers kann auf dieselbe Weise mit der Datei eines Beitragenden kollidieren.
Ob zwei Beitragende, die einen Dateinamen ausgeben, kollidieren, hängt davon ab, wo ihr Provider sie platziert. Ein Provider, der jeden Beitragenden unter seiner eigenen Position in der Assemblierung verschachtelt, hält zwei gleichnamige Dateien auseinander; ein Provider, der Beitragende nebeneinander schreibt, tut das nicht. Verglichen wird der endgültige Pfad, unter den eine Datei geschrieben würde, nicht der Name, den der Beitragende ausgegeben hat, daher wird der verschachtelte Fall nicht gemeldet.
Der Build bricht ab, statt eine der beiden Dateien zu schreiben und die andere zu verwerfen. Es gibt keine korrekte stillschweigende Auflösung: Eine Datei umzubenennen oder mit einem Suffix zu versehen, würde einen Namen erfinden, den niemand verfasst hat, und ihre Inhalte zusammenzuführen, würde ein Dokument erfinden, das niemand geschrieben hat. Jeder kollidierende Pfad wird gemeldet, und jeder Beitragende, der ihn schreibt, wird genannt, sodass Ihnen ein einziger Build das ganze Bild zeigt statt einer Kollision nach der anderen.
Ausgegebene Meldungen. Pro kollidierendem Pfad wird ein Befund gemeldet — einmal, wie viele Boundaries auch immer die Assemblierung gespeist haben, in der es geschah —, sodass ein Build, dessen Beitragende auf zwei Pfaden aufeinandertrafen, Sie über beide informiert und keine Kollision doppelt gemeldet wird:
assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>") (Kollision in der assemblierten Ausgabe: Zwei Beitragende schreiben denselben Ausgabepfad (mit dem angegebenen Ausgabepfad, den Beitragenden, die ihn schreiben, und den Boundaries, in denen er assembliert wurde))
Jeder Beitragende wird nach dem benannt, was er ist, und das sagt, wo sein Name geschrieben steht: component <name> für eine Komponenteninstanz, feature <name> für ein an eine Boundary angebundenes Feature und the <provider> assembly für die eigene zusammengeführte Ausgabe der Assemblierung. Die Beitragenden werden in Namensreihenfolge aufgeführt, daher ist der Satz bei jedem Build derselben Eingabe gleich.
Auch eine Datei, die ein Recipe zur gemeinsamen Ausgabe der Boundary beiträgt, unterliegt dieser Regel. Der Block boundary: eines Recipe schreibt seine Dateien neben die eigene assemblierte Ausgabe des Providers, einmal pro Dateiname. Mehrere Komponenten, die einen Namen mit identischen Bytes deklarieren, sind eine Datei und kollidieren nie; ihn mit unterschiedlichen Bytes zu deklarieren, kollidiert hier, wobei die Datei und jede Komponente, die sie deklariert hat, genannt werden, und dasselbe gilt für einen Namen, den die Assemblierung des Providers selbst schreibt — etwa aggrega.modules.tf für terraform, was the terraform assembly unter den Beitragenden nennt. Eine Datei, die mehrere Komponenten identisch deklariert haben und die auf die eigene Datei der Assemblierung trifft, wird mit allen von ihnen genannt, als component <name-1> and component <name-2>.
Die Boundaries, von denen die Assemblierung gespeist wurde, werden ebenfalls genannt, und sie werden aufgelistet statt einzeln herausgegriffen. Boundaries, deren Deklarationen directory: gleich ausgewertet werden, werden als eine assembliert, und nichts an einer Kollision sagt, in welcher von ihnen die aufeinandergetroffenen Beitragenden deklariert wurden — daher nennt Ihnen der Befund jede Boundary, deren Deklaration sie trennen könnte, und behauptet von keiner, dass sie die fehlerhafte ist. Der Befund wird aus demselben Grund gegen das Release-Dokument als Ganzes gemeldet: Eine Boundary darin zu nennen, würde Sie zu einem Dokument schicken, das möglicherweise nichts zu dem Pfad beigetragen hat.
Wo mehr als ein Pfad kollidiert, kommen die Befunde zusammen unter einer Meldung an, die nennt, was sie gemeinsam haben:
assembled output paths written by more than one contributor (Pfade der assemblierten Ausgabe, die von mehr als einem Beitragenden geschrieben werden)
So beheben Sie es: Benennen Sie die ausgegebene Datei in dem Recipe um, das Sie kontrollieren — einen Schlüssel von artifacts:, den Schlüssel eines Blocks boundary: oder den Dateinamen, den eine Workload-Übersetzung ableitet —, sodass die beiden nicht mehr aufeinandertreffen. Wo zwei Recipes eine gemeinsame Datei deklarieren und dieselbe Konfiguration meinen, machen Sie ihre Deklarationen Byte für Byte gleich. Wo die beiden Beitragenden tatsächlich zu getrennten Ausgaben gehören, geben Sie ihren Boundaries unterschiedliche Pfade directory:, damit jede für sich assembliert wird.
The same name is derived more than once inside the output (Derselbe Name wird innerhalb der Ausgabe mehr als einmal abgeleitet)
Eine Assemblierung verwendet am Ende denselben Namen zweimal für etwas innerhalb der Dateien, die sie ausgibt, an einer Stelle, an der nur für eines davon Platz ist. Das geschieht auf zwei Arten: Zwei Beitragende leiten denselben Namen ab, oder die eigene Ausgabe eines einzelnen Beitragenden trägt diesen Namen zweimal. Das unterscheidet sich von den beiden Kollisionen oben: Wo zwei Beitragende beteiligt sind, sind die Komponenten unterschiedlich benannt und ihre Dateien landen auf unterschiedlichen Pfaden, daher ist an der Struktur der Assemblierung nichts falsch — es ist ein Name im Inhalt, etwa der Bezeichner, mit dem ein Ziel eine Ressource adressiert, oder der Name, unter dem eine Ausgabe veröffentlicht wird, damit eine andere darauf verweist.
Welche Namen verglichen werden, ergibt sich daraus, was der Provider mit der Ausgabe einer Assemblierung macht. Wo der Provider diese Ausgabe zu einem einzigen Dokument zusammenführt — einem Stack-Template, einer Compose-Datei —, werden die Namen innerhalb dieses einen Dokuments miteinander verglichen, und ein Beitragender, dessen Ausgabe als eigene, getrennte Dateien geschrieben wird, steht außerhalb davon. Seine Namen begegnen keinen anderen, daher bricht zwischen ihnen nichts ab, und nichts, was Sie umbenennen könnten, würde daran etwas ändern. Wo der Provider stattdessen die Ausgabe jedes Beitragenden als eigene Dateien schreibt — ein Chart-Rendern, eine Menge von Manifesten —, wird jeder Beitragende zur Assemblierung mit jedem anderen verglichen, weil ein Name in einer solchen Ausgabe über alles hinweg eindeutig ist, was diese Dateien als Menge liest, statt innerhalb einer einzelnen Datei.
Die eigenen Ressourcen eines FeatureRecipe gehen denselben Weg wie die seiner Host-Komponente, weil eine Anbindung zu der Assemblierung beiträgt, zu der ihr Host gehört. Wo der Provider zusammenführt, werden die Namen einer Anbindung daher mit denen ihrer Host-Komponente und mit denen jeder anderen Anbindung verglichen, genau wie die Namen zweier Komponenten: Sie landen alle innerhalb des einen Dokuments, und von zwei gleichen Namen verdrängt dort einer den anderen. Wo der Provider nicht zusammenführt, werden die Ressourcen der Anbindung unter ein Verzeichnis geschrieben, das die Komponente nennt, an die sie angebunden ist, und ihre Namen werden trotzdem mit jedem Beitragenden zur Assemblierung verglichen — und genau dort wird eine Ressourcenidentität erkannt, die über einen ganzen Cluster hinweg eindeutig sein muss. Der Vergleich ist daher bei beiden derselbe, und es unterscheidet sich nur, wo der Name, der verdrängt würde, am Ende steht.
Eine Hälfte des Abbruchs ist von alldem nicht betroffen: die eigene Ausgabe eines einzelnen Beitragenden, die einen Namen zweimal trägt. Das ist ein Name, der zweimal innerhalb einer Ausgabe verwendet wird, die ein einziger Beitragender geschrieben hat, daher bricht der Build ab, wo auch immer diese Ausgabe geschrieben wurde, und die beiden zu trennenden Dinge liegen immer darin.
Die meisten solchen Namen sind die eines Providers, abgeleitet aus der Komponenteninstanz und der Ressource, daher können zwei Komponenten bei einem Namen ankommen, wann immer die Teile, aus denen er abgeleitet wird, übereinstimmen — und eine Komponente kann auf dieselbe Weise zweimal bei einem Namen ankommen, wenn zwei ihrer eigenen Ressourcen aus übereinstimmenden Teilen gebildet werden. Da der Name in den eigenen Bytes der Datei steht, kann die Assemblierung ihn nicht sehen: Der Provider meldet die Namen, die er abgeleitet hat, und der Build vergleicht sie.
Eine Namensart gehört dem Build statt einem Provider, und sie wird auf dieselbe Weise gemeldet: die Identität, mit der jede Ressource gelabelt ist, die ein FeatureRecipe ausgibt, und die Ihre Ausgabe als Label aggrega.ai/component-id erreicht. Sie wird unter der Namensart component-id gemeldet, sodass Sie denselben String in Ihrer eigenen erzeugten Ausgabe finden können. Wo ein FeatureRecipe seine Ressourcen synthetisiert, ist diese Identität auch das, wonach sie benannt sind; wo es ein Chart oder ein Fragment rendert, das sein Autor bereitgestellt hat, bleiben die Namen in diesem Rendern die der Host-Komponente, und nur die Labels tragen die Identität.
Für ein an eine Komponente angebundenes Feature wird sie aus der Komponente, an die das Feature angebunden ist, und dem Schlüssel gebildet, den Sie unter features: geschrieben haben, hinter einem festen Präfix. Die Host-Komponente ist Teil des Werts, weil ein Feature-Name, der an mehrere Komponenten angebunden ist, auf jeder eine eigene Menge von Ressourcen ausgibt, und jede Menge braucht eine eigene Identität.
Für ein an eine Boundary angebundenes Feature wird sie aus dem Namen des Feature und jedem Segment des Pfads der Boundary gebildet, hinter einem eigenen Präfix. Beide Stellen setzen zusammen, statt zu ersetzen: Ein Zeichen, das das Label-Alphabet zurückweist, wird ausgeschrieben statt ersetzt, und die Teile werden durch eine Zeichenfolge verbunden, die kein geschriebener Teil enthalten kann, sodass zwei Anbindungen, die Sie unterscheiden können, immer zwei Identitäten erreichen. Der einzige Rest ist die Länge: Eine zusammengesetzte Identität, die für einen Label-Wert zu lang ist, wird um einen Digest ihres Ganzen herum gekürzt, und zwei gekürzte Identitäten können grundsätzlich aufeinandertreffen. Dieser Abbruch meldet ein solches Aufeinandertreffen zwischen zwei Beitragenden, deren Namen verglichen werden, und zwei Anbindungen an einer Komponente sind zwei solche Beitragende, wo immer der Provider ihres Hosts sie zusammen assembliert. Siehe ../providers/well-known-annotations.md dazu, wie jede gebildet wird.
Ein Kubernetes-Rendern meldet eine eigene Namensart: den Namen, den jede Ressource, die sein eigenes Rendern erzeugt, in ihrem metadata.name trägt. Ein solcher Name muss innerhalb seines kind eindeutig sein — und, für einen Typ, den der Cluster in Namespaces hält, innerhalb seines Namespace — statt über die gesamte Ausgabe hinweg, daher sagt die Namensart, auf welchen davon sie beschränkt ist. Sie beginnt mit resource-names und trägt dann den kind der Ressource und den Namespace, in dem die Ressource landet, also den, den die Ressource für sich selbst nennt, oder, wo sie keinen nennt, den, mit dem die Boundary annotiert ist. So sind resource-names:Service--default die Namen der Services, die in default landen. Ein Typ, den die Kubernetes-API außerhalb jedes Namespace hält — eine ClusterRole, eine StorageClass, eine CustomResourceDefinition —, und ein benutzerdefinierter Typ, den eine CustomResourceDefinition im selben Rendern mit dem Geltungsbereich Cluster deklariert, tragen nur ihren kind, welchen Namespace ihr Dokument auch schreibt: resource-names:ClusterRole sind die Namen jeder ClusterRole, die die Ausgabe trägt. Alles außerhalb der Buchstaben und Ziffern wird ausgeschrieben statt ersetzt, und die beiden Teile werden durch eine Zeichenfolge verbunden, die kein geschriebener Teil enthalten kann, sodass zwei verschiedene Paare nie eine gemeinsame Namensart erreichen und ein Typ allein nie die Namensart eines Typs und eines Namespace erreicht. Ein Service und ein Deployment dürfen sich einen Namen teilen, und zwei Namespaces halten einen Namen eines namespace-gebundenen Typs unabhängig voneinander, daher bricht keiner dieser Fälle ab. Der Name selbst wird genau so gemeldet, wie Ihr Chart ihn geschrieben hat, was ihn zu dem String macht, nach dem Sie in Ihren Templates suchen.
Daher brechen zwei Beitragende zu einer Ausgabe, die jeweils ein clusterweites Objekt unter einem Namen schreiben, auch dort ab, wo das Release sie in zwei Namespaces platziert, weil das Anwenden beider dieses eine Objekt zweimal schreibt; und ein Chart, das ein solches Objekt unter zwei verschiedenen Namespaces schreibt, was das Rendern als zwei Dateien ausgibt, bricht als einzelner Beitragender ab, der den Namen zweimal trägt. Ein Typ, den nichts im Rendern klassifiziert — ein benutzerdefinierter Typ, dessen CustomResourceDefinition das Rendern nicht ausgibt, oder ein Dokument, das kein apiVersion nennt —, wird innerhalb seines Namespace verglichen, wie ein namespace-gebundener Typ, weil nichts im Rendern sagt, dass der Cluster ihn außerhalb eines Namespace hält; zwei Beitragende, die ein solches Objekt in zwei Namespaces schreiben, treffen daher nicht aufeinander.
Namen werden unter den Beitragenden zu einer Ausgabe verglichen und nie zwischen zwei Ausgaben. Zwei Boundaries sind zwei Ausgaben, wenn jede ein eigenes Verzeichnis hat — eines, das sie nennt, oder das, das jede Boundary erhält, die kein directory: nennt —, und nichts in einem Build sagt, ob zwei Ausgaben auf einen Cluster oder auf zwei angewendet werden: Die CustomResourceDefinition eines Operators, die an jeden von zwei Clustern ausgeliefert wird, ist derselbe Name in zwei Ausgaben, und das ist korrekt. Daher lassen sich zwei Boundaries, die jeweils ein clusterweites Objekt unter einem Namen schreiben, auch dort bauen, wo beide auf einen Cluster angewendet werden; wo das der Fall ist, geben Sie das Objekt nur aus einer von ihnen aus.
Die Anordnung, die diesen Abbruch am häufigsten erreicht, sind zwei Features, die an eine Komponente angebunden sind und jeweils ein Chart ausliefern, das ihr Autor bereitgestellt hat. Beide Charts rendern mit demselben Release-Namen — dem der Host-Komponente, damit das Anbinden eines Charts keine Ressourcen umbenennt, die sein Autor bereits deklariert und bereitgestellt hat —, und eine Ressource nach dem Release-Namen zu benennen, gehört zu den häufigsten Dingen, die ein Chart tut. An der Struktur der Ausgabe ist nichts falsch: Die beiden Ressourcen tragen einfach einen Namen. Wo der Provider der Komponente einzelne Dokumente schreibt, schreibt jede Anbindung unter ein eigenes Verzeichnis, und das Anwenden beider hinterlässt dasjenige, das zuletzt angewendet wurde; wo er seine Gruppe in ein Dokument faltet, tragen beide Anbindungen zu diesem Dokument bei, und von den beiden Namen verdrängt einer den anderen darin. Benennen Sie die Ressource in dem Chart um, das Sie kontrollieren, oder geben Sie ihr einen Namen, der etwas trägt, das die beiden Anbindungen unterscheidet — und es ist die Anbindung, die das Template erreichen muss, weil beide Charts mit dem Release-Namen des Hosts rendern, sodass das Umbenennen der Anbindung allein nichts bewegt. Übergeben Sie .attachment_name über das valuesMapping: des FeatureRecipe an das Chart, und setzen Sie es auf denjenigen der eigenen Werte des Charts, aus dem seine Ressourcennamen gebildet werden.
Eine zweite Anordnung erreicht denselben Abbruch mit einem Feature statt zwei: ein Chart, dessen Template einen Ressourcennamen als Literal schreibt, angebunden an zwei Komponenten. Jeder Host rendert es unter einem eigenen Release-Namen, daher ist das Literal der einzige Grund, warum die beiden Kopien einen Namen tragen — benennen Sie die Ressource nach .Release.Name, und der Host ist wieder darin enthalten, was ein Chart, das seine Ressourcennamen aus seiner Release-Identität bildet, bereits tut.
Eine dritte Anordnung hat dieselbe Struktur, eine Verfassungsoberfläche weiter innen: ein FeatureRecipe, das seine Ressourcen über artifacts: statt über ein Chart ausliefert, unter einem Namen an zwei Komponenten angebunden, dessen Inhalt einen Ressourcennamen als Literal schreibt. Die Ausgabe jeder Anbindung landet unter einem Verzeichnis, das ihren Host nennt, daher unterscheiden sich die ausgegebenen Pfade und an der Struktur der Ausgabe ist nichts falsch — aber beide Inhalte tragen denselben Namen, und das Anwenden beider hinterlässt denjenigen, der zuletzt angewendet wurde. Ein Name in einem artifacts-Inhalt wird genau so verglichen wie ein Name, den ein Chart gerendert hat: Die beiden beschreiben dieselbe Ressource im selben Cluster, daher macht es für das, was geschieht, wenn beide angewendet werden, keinen Unterschied, woher der Name kam. Diese Lesart beruht darauf, dass die beiden Namen zusammen gelesen werden, was dort geschieht, wo ein Provider die Ausgabe jedes Beitragenden als Dateien schreibt, die ein Ziel als eine Menge liest. Wo der Provider die Ausgabe einer Assemblierung stattdessen zu einem einzigen Dokument zusammenführt, stehen die Dateien jeder Anbindung außerhalb dieses Dokuments, und ein Name in einer davon ist auf sie beschränkt, sodass zwei solche Anbindungen nie aufeinandertreffen und der Build fortfährt.
Nicht jeder Name wird gemeldet, daher hat ein Build, der nicht abbricht, nicht festgestellt, dass jeder Name, den seine Ausgabe schließlich tragen wird, verglichen wurde. Eine Ressource, deren Benennung dem Cluster überlassen wird — eine, die generateName statt name deklariert —, trägt noch keinen Namen, daher gibt es keinen zu melden. Und ein Name, der in ein anderes Feld geschrieben wird, damit ein Controller ihn später liest, ist kein Ressourcenname, daher vergleicht ihn nichts. Beide Grenzen sind Eigenschaften des Lesens des ausgegebenen Dokuments, daher gelten beide für einen artifacts-Inhalt genau so, wie sie für ein gerendertes Chart-Template gelten.
Ein Inhalt unter artifacts: ist ein Template, daher wird ein Name darin, der pro Host unterschiedlich sein muss, zusammengesetzt statt als Literal geschrieben. .context.rendered_name ist der Name, den der eigene Provider der Host-Komponente ihr gibt — unter helm ihr Release-Name, geschrieben in den Zeichen, die ein Kubernetes-Name zulässt —, und .attachment_name ist der Schlüssel, unter dem Sie es angebunden haben, sodass {{ .context.rendered_name }}-{{ .attachment_name }} einer Ressource auf jedem Host und unter jeder Anbindung einen eigenen Namen gibt. Auf einem Host, dessen Provider keinen solchen Namen meldet, setzen Sie ihn stattdessen aus .context.instance_id zusammen, der Identität des Hosts. Ein verfasster Inhalt erreicht jeden Host, an den er angebunden ist, mit allen Namen, die er enthält, und ein Literal ist auf allen gleich — geben Sie daher einem Namen, der im Cluster eindeutig sein muss, diese Struktur.
Nichts an der Bedeutung eines Namens wird interpretiert — zwei gemeldete Namen sind entweder derselbe Text oder nicht —, weshalb dieselbe Meldung jede Namensart abdeckt, wer auch immer den Namen abgeleitet hat.
Ein Name kann für eine Komponente in mehr als einer Meldung erscheinen, weil jeder Teil einer Komponente gemeldet wird, sobald er gerendert wird. Das ist eine Ressource, die in jeder Meldung genannt wird, zu der sie gehört, kein zweimal verwendeter Name, und es führt zu keinem Abbruch. Zum Abbruch führt eine einzelne Meldung, die einen Namen zweimal trägt, weil diese Meldung eine Ausgabe beschreibt, in der der Name tatsächlich zweimal verwendet wird.
Diese Lesart hängt davon ab, was als ein Beitragender zählt, und für die Namensart component-id ist die Antwort die Anbindung statt der Komponente oder der Boundary, an der sie sitzt. Eine Anbindung wird durch beide Koordinaten identifiziert, die Sie für sie geschrieben haben — die Komponente, an die sie angebunden ist, zusammen mit dem Schlüssel unter features:, oder den Pfad der Boundary zusammen mit dem Namen an dieser Boundary —, daher sind zwei Anbindungen an einer Komponente zwei Beitragende, genau wie zwei an verschiedenen Komponenten, und ein Feature-Name, der an zwei Boundaries geschrieben ist, ist zwei Beitragende, obwohl der Name an jeder derselbe ist. Zwei Beitragende zu sein, macht ihre Identitäten in jeder dieser Anordnungen vergleichbar; ob zwei von ihnen überhaupt verglichen werden, folgt derselben Regel wie jeder andere Name hier, daher steht dort, wo der Provider zusammenführt, eine Anbindung, deren Ausgabe als eigene, getrennte Dateien geschrieben wird, außerhalb des zusammengeführten Dokuments und wird nur mit sich selbst verglichen. Zwei Anbindungen, die eine Identität erreichen, brechen daher ab, wo immer ihre Ausgabe die der anderen erreichen kann, und jeder Befund nennt beide seiner Koordinaten, sodass Sie erkennen können, welche zwei Dinge zu trennen sind. Da beide Koordinaten Teil des zusammengesetzten Werts sind, erreichen zwei Anbindungen, die Sie unterscheiden können, bei jeder Länge, die passt, zwei Identitäten — daher ist die Anordnung, die diesen Abbruch erreicht, diejenige, bei der ein für sein Ziel zu langer Wert gekürzt wurde und zwei gekürzte Werte aufeinandertrafen. Wo zwei gekürzte Identitäten aufeinandertreffen und ihre Ausgabe die der anderen nicht erreichen kann — zwei Anbindungen an einer Komponente, unter einem Provider, der zusammenführt, jede als eigene, getrennte Dateien geschrieben —, vergleicht sie nichts, und die beiden Mengen von Ressourcen tragen gemeinsam ein einziges aggrega.ai/component-id.
Eine Anordnung verdient es, ausdrücklich genannt zu werden, weil es so aussieht, als müsste sie abbrechen, und sie es nicht tut: Ein Feature unter dem gleichen Namen an zwei Komponenten anzubinden, wird vollständig unterstützt und erfordert keine Umbenennung. Die Komponente ist Teil des zusammengesetzten Werts, daher erreichen metrics an api und metrics an web zwei Identitäten, und die Ressourcen jeder Komponente erhalten eine eigene Identität — was wichtig ist, weil eine Kaskade, die bewusst einen Anbindungsnamen über viele Komponenten hinweg vergibt, einem Autor keinen anderen Namen lässt, den er schreiben könnte. Jede Art, wie ein FeatureRecipe Ressourcen ausliefert, setzt seine Identität auf das, was es ausgibt, einschließlich einer, die eine Quelle nur einbindet und sie unverändert rendert, daher wird jede davon verglichen; ein Feature, dessen FeatureRecipe überhaupt nichts ausgibt, hat nichts zu vergleichen.
Der Build bricht ab, statt einen zu behalten und den anderen zu verwerfen. Es gibt keine korrekte stillschweigende Auflösung: Den ersten zu behalten, würde eine Ressource, die Sie deklariert haben, vollständig aus der Ausgabe entfernen und den Build Erfolg melden lassen, und alles, was auf die entfernte verwies, würde stillschweigend stattdessen auf die verbleibende aufgelöst. Jeder kollidierende Name wird gemeldet, jeder mit der Namensart, die er ist, und mit jedem Beitragenden, der ihn abgeleitet hat, genannt — sodass Ihnen ein einziger Build das ganze Bild zeigt statt einer Kollision nach der anderen. Ein Beitragender, dessen eigene Ausgabe den Namen zweimal trägt, wird als einer genannt, der den Namen mehr als einmal abgeleitet hat, und genau das sagt Ihnen, dass die beiden zu trennenden Dinge innerhalb dieser einen Komponente liegen statt zwischen zwei Komponenten.
Ausgegebene Meldungen. Pro Beitragendem und kollidierendem Namen wird ein Befund gemeldet, sodass jeder Beitragende, der den Namen abgeleitet hat, für sich genannt wird, statt in eine Liste innerhalb einer Meldung gefaltet zu werden. Wo zwei Beitragende den Namen abgeleitet haben, gibt es mindestens zwei Befunde, und sie kommen zusammen unter einer Meldung an, die nennt, was sie gemeinsam haben:
dispatch groups whose contributors derive one name more than once in one key space (Weiterleitungsgruppen, deren Beitragende einen Namen mehr als einmal in einem Schlüsselraum ableiten)
Jeder Befund nennt den Namen, die Namensart, die er ist, den Beitragenden, der ihn abgeleitet hat, sowie den Provider und den Pfad der Assemblierung, in die ihre Ausgabe zusammengeführt wird:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>") (Kollision abgeleiteter Namen: Ein Name wird mehr als einmal in einem Schlüsselraum abgeleitet (mit dem angegebenen Namen, dem Schlüsselraum, der Komponente, die ihn abgeleitet hat, dem Provider und dem Weiterleitungspfad))
Der Beitragende wird nach dem benannt, was er ist, und das sagt, wo sein Name geschrieben steht: derived by component für eine Komponenteninstanz und derived by feature für ein an eine Boundary angebundenes Feature.
Wo der eigene Name des Beitragenden ihn nicht für sich allein identifiziert, folgt eine zweite Koordinate, und welche es ist, hängt von der Art ab. Ein an eine Boundary angebundenes Feature trägt den Pfad der Boundary, weil ein Feature-Name an mehr als einer Boundary geschrieben sein kann:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>") (Kollision abgeleiteter Namen: Ein Name wird mehr als einmal in einem Schlüsselraum abgeleitet (mit dem angegebenen Namen, dem Schlüsselraum, dem Feature, das ihn abgeleitet hat, der Boundary, an die es angebunden ist, dem Provider und dem Weiterleitungspfad))
Eine Komponente trägt den Schlüssel der Anbindung, deren Rendern den Namen abgeleitet hat, weil eine Komponente eine Anbindung pro Schlüssel trägt, den Sie geschrieben haben:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>") (Kollision abgeleiteter Namen: Ein Name wird mehr als einmal in einem Schlüsselraum abgeleitet (mit dem angegebenen Namen, dem Schlüsselraum, der Komponente, die ihn abgeleitet hat, der Anbindung, die sie trägt, dem Provider und dem Weiterleitungspfad))
Das eigene Rendern einer Komponente — ein Name, den ihr Provider für die Komponente selbst statt für eine ihrer Anbindungen abgeleitet hat — trägt keine zweite Koordinate, daher endet der Befund beim Namen der Komponente.
Wo die eigene Ausgabe eines einzelnen Beitragenden den Namen zweimal trägt, ist dieser eine Beitragende der einzige Befund, daher kommt er allein an, ohne Meldung darüber — und er wird als einer genannt, der den Namen mehr als einmal abgeleitet hat, statt als einer, der auf einen anderen Beitragenden getroffen ist:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>") (Kollision abgeleiteter Namen: Ein Name wird mehr als einmal in einem Schlüsselraum abgeleitet (mit dem angegebenen Namen, dem Schlüsselraum, der Komponente, die ihn mehr als einmal abgeleitet hat, dem Provider und dem Weiterleitungspfad))
Die zweite Koordinate folgt dem Beitragenden hier unter denselben Bedingungen wie oben, daher nennt eine Wiederholung innerhalb der eigenen Ausgabe einer Anbindung diese Anbindung statt nur der Komponente, die sie trägt.
So beheben Sie es: Wo zwei Beitragende genannt werden, benennen Sie einen von ihnen im Aggregate um, sodass die daraus abgeleiteten Namen nicht mehr mit denen des anderen übereinstimmen. Wo die Namensart component-id ist, nennt jeder Befund bereits das umzubenennende Element: carrying attachment "…" ist der Schlüssel unter dem Block features: dieser Komponente, und ein feature "…"attached at boundary "…" ist der Name unter dem Block features: dieser Boundary. Wo sich die beiden Befunde nur in der Boundary unterscheiden, die sie nennen, tragen die beiden Anbindungen einen Namen an zwei Boundaries — benennen Sie eine von ihnen um, oder geben Sie den beiden Boundaries unterschiedliche Pfade directory:, damit ihre Ausgabe nicht mehr zusammengeführt wird. Wo die beiden Namen solche sind, die der Build zusammengesetzt hat, können sie nur aufeinandergetroffen sein, nachdem sie gekürzt wurden, um zum Ziel zu passen, daher kürzen Sie die Teile, aus denen sie zusammengesetzt sind, selbst, statt das dem Build zu überlassen. Wo beide Namen aus etwas abgeleitet sind, das Sie ausdrücklich gesetzt haben — einem Wert, den das Recipe an den Provider übergibt, oder einer Annotation, die der Provider liest —, ändern Sie stattdessen dieses bei demjenigen der beiden, den Sie kontrollieren. Wo die beiden Beitragenden tatsächlich zu getrennten Ausgaben gehören, geben Sie ihren Boundaries unterschiedliche Pfade directory:, damit jede für sich assembliert wird und die beiden Namen nie aufeinandertreffen. Wo ein einzelner Beitragender als einer genannt wird, der den Namen mehr als einmal abgeleitet hat, liegen beide kollidierenden Dinge innerhalb dieser einen Komponente: Suchen Sie die beiden Ressourcen, die ihr Recipe erzeugt und deren Namen übereinstimmen, und ändern Sie, wonach eine von ihnen benannt ist — den Schlüssel, unter dem sie deklariert ist, oder einen Wert, aus dem sie gebildet wird —, damit der Provider für jede einen eigenen Namen ableitet. Wo die Namensart nur aus einem clusterweit gültigen Typ besteht, etwa resource-names:ClusterRole, beschreiben die genannten Dokumente ein Objekt im Cluster, in welche Namespaces sie auch platziert wurden: Geben Sie es nur aus einem Beitragenden aus — über einen Wert, den sein Chart anbietet, etwa einen Schalter zum Installieren seiner Definitionen — oder geben Sie, wo die beiden zwei Objekte sein sollen, einem von ihnen einen eigenen Namen in dem Chart oder Inhalt, den Sie kontrollieren; ein einzelner Beitragender, der dafür zweimal genannt wird, schreibt es unter zwei Namespaces, und eines der beiden Dokumente ist das zu entfernende.
An authored export name is one the build derives for a cross-stack reference (Ein verfasster Exportname ist einer, den der Build für eine stackübergreifende Referenz ableitet)
Der Block Outputs: eines cloudformation-Recipe ist verfasstes CloudFormation, und ein Eintrag darin kann ein eigenes Export: mit einem Name: tragen; dieser Name erreicht den assemblierten Stack genau so, wie er geschrieben ist. Unabhängig davon veröffentlicht der Provider, wenn eine Kante uses von einer Boundary zu einer anderen übergeht, den konsumierten Wert als Output des Stacks mit einem Export unter einem Namen, den er aus Release, Boundary, Komponente und bereitgestelltem Schlüssel ableitet. Dieser Abbruch tritt dort ein, wo die beiden aufeinandertreffen: Der Name, den Sie geschrieben haben, ist der Name, den die Ableitung für denselben Build erzeugt hat, daher würde der Stack einen Exportnamen zweimal von zwei Stellen aus deklarieren, und ein Exportname muss eindeutig sein.
Der Abbruch nennt den abgeleiteten Exportnamen zusammen mit den vier Teilen, aus denen er gebildet wurde, sodass Sie sehen können, welche boundary-übergreifende Referenz ihn erzeugt hat, und er nennt den Stack-Output, unter dem Ihre Deklaration steht — gekennzeichnet als ein Name, den der Provider assembliert, statt als einer, den ein Recipe geschrieben hat, weil der Provider diesen Namen bildet, indem er die Komponente und den Eintrag in die Buchstaben und Ziffern codiert, die eine logische ID zulässt, sodass er nicht der String ist, als der einer von beiden geschrieben wurde. Der Exportname ist der Teil, nach dem Sie suchen. Ihr Eintrag schreibt ihn genau so wie der Abbruch, was die beiden zu einer Kollision macht, daher ist er der eine String, der sowohl in der Meldung als auch in Ihren eigenen Dateien erscheint.
Der Vergleich ist auf einen Stack beschränkt: die Exportnamen, die dieser Stack deklariert, gegen die Namen, die für die boundary-übergreifenden Referenzen abgeleitet werden, die in ihn veröffentlichen. Zwei Stacks werden nicht miteinander verglichen, und ein Exportname, der als intrinsische CloudFormation-Funktion geschrieben ist, wird zum Bereitstellungszeitpunkt aufgelöst, daher gibt es keinen Namen zu vergleichen. Worauf ein Name unter den Exporten trifft, die bereits in einem Konto und einer Region bereitgestellt sind, ist eine Eigenschaft der Bereitstellung, die ein Build nicht beobachtet.
Ausgegebene Meldung. Die Bedingung nennt die Art des Fehlers, und der eigene Satz des Providers sagt, was geschehen ist; die umgebende Meldung nennt außerdem die Kante uses, die verdrahtet wird:
two things a plugin produced occupy one name in its output (zwei Dinge, die ein Plugin erzeugt hat, belegen einen Namen in seiner Ausgabe) cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export (ein Exportname, den eine boundary-übergreifende Verknüpfung ableitet, ist bereits durch einen anderen Outputs-Eintrag im selben Stack deklariert: Die Verknüpfung leitet den angegebenen Exportnamen für den angegebenen provides-Schlüssel der angegebenen Komponente in der angegebenen Boundary des angegebenen Release ab, und ein anderer Outputs-Eintrag desselben Stacks deklariert bereits denselben Exportnamen — diese Deklaration steht unter dem angegebenen Stack-Output, einem Namen, den dieser Provider assembliert, statt einem, den ein Recipe geschrieben hat; jeder verdeckende Outputs-Eintrag schreibt seinen Exportnamen genau so wie der Abbruch, daher führt die Suche nach diesem Namen in Ihren Recipes zu dem Eintrag — benennen Sie den Exportnamen um, den der Eintrag deklariert, oder entfernen Sie den Export-Block dieses Eintrags und lassen Sie die Verknüpfung den Export veröffentlichen)
So beheben Sie es: Suchen Sie in Ihren Recipes nach dem Exportnamen, den der Abbruch nennt — der Eintrag Outputs, der ihn deklariert, schreibt ihn identisch —, und benennen Sie dann entweder diesen Exportnamen um, damit er nicht mehr übereinstimmt, oder entfernen Sie den Block Export: dieses Eintrags und lassen Sie die stackübergreifende Verdrahtung den Export selbst veröffentlichen. Ihn zu entfernen, ist in der Regel der richtige Schritt, wo der Eintrag existierte, um denselben Wert zu exportieren, den die Kante konsumiert: Der Provider veröffentlicht für diesen Wert ohnehin ein Export, daher fügt das verfasste nichts hinzu. Behalten Sie stattdessen das verfasste Export: und benennen Sie es um, wo der Eintrag den Wert für einen anderen Konsumenten exportiert, der ihn unter einem von Ihnen gewählten Namen importiert.
The output a cross-stack reference publishes on already carries an Export (Der Stack-Output, auf dem eine stackübergreifende Referenz veröffentlicht, trägt bereits ein Export)
Wenn eine Kante uses von einer Boundary in eine andere führt, veröffentlicht der Provider das Export des konsumierten Werts auf dem Stack-Output, den er für die erzeugende Komponente und den bereitgestellten Schlüssel assembliert — demselben Output, den ein cloudformation-Recipe erreicht, wenn sein Block Outputs: unter diesem Schlüssel einen Eintrag schreibt. Ein Export:, das an diesem Output bereits vorhanden ist, wird nur beibehalten, wenn sein Name: genau der Name ist, den der Provider ableitet: Das ist der Export, den eine frühere stackübergreifende Referenz auf denselben Wert bereits veröffentlicht hat, sodass jeder Konsument den einen Namen importiert. Jedes andere Export: an dieser Stelle führt zum Abbruch, weil das Schreiben des Exports des Providers überschreiben würde, was Sie geschrieben haben, und das Beibehalten Ihres Exports jeden Konsumenten einen Namen importieren ließe, den die Referenz nie veröffentlicht hat.
Der Abbruch erfolgt bei vier Formen von Export: an diesem Output:
ein Name:, der eine andere Zeichenkette ist;
ein Name:, der als intrinsische CloudFormation-Funktion geschrieben ist, die zum Bereitstellungszeitpunkt aufgelöst wird, sodass der Provider nicht lesen kann, was sie ausdrückt;
ein Block Export:, der nichts benennt;
ein Export:, das als einfacher Wert statt als Block geschrieben ist.
Ausgegebene Meldung. Die Bedingung nennt die Art des Fehlers, und der eigene Satz des Providers sagt, was geschehen ist; die umgebende Meldung nennt außerdem die Kante uses, die verdrahtet wird:
two things a plugin produced occupy one name in its output (zwei Dinge, die ein Plugin erzeugt hat, belegen einen Namen in seiner Ausgabe) cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports (der Stack-Output, auf dem eine boundary-übergreifende Verknüpfung ihren Export veröffentlicht, trägt bereits ein Export, das die Verknüpfung nicht geschrieben hat: Die Verknüpfung leitet den angegebenen Exportnamen für den angegebenen provides-Schlüssel der angegebenen Komponente in der angegebenen Boundary des angegebenen Release ab, und der Stack-Output, den dieser Provider für diesen Schlüssel und diese Komponente assembliert, weist das Angegebene auf; entfernen Sie den Export-Block dieses Eintrags und lassen Sie die Verknüpfung den Export veröffentlichen, den jeder Konsument importiert)
<what-it-found> ist eines der Folgenden, in der Reihenfolge der obigen Formen:
already declares the export name <name> (deklariert bereits den angegebenen Exportnamen) already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells (deklariert bereits einen Exportnamen, der keine Zeichenkette ist — einen als intrinsische Funktion angegebenen, die zum Bereitstellungszeitpunkt aufgelöst wird, sodass dieser Provider nicht lesen kann, was sie ausdrückt) already carries an Export block declaring no export name (trägt bereits einen Export-Block, der keinen Exportnamen deklariert) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (trägt bereits ein Export, das kein Block ist, wo CloudFormation eines erwartet, das einen Name trägt)
So beheben Sie es: Suchen Sie im Recipe der Komponente, die der Abbruch nennt, den Eintrag Outputs, der unter dem genannten bereitgestellten Schlüssel geschrieben ist, und entfernen Sie den Block Export: dieses Eintrags — die stackübergreifende Verdrahtung veröffentlicht dann den Export, den jeder Konsument importiert. Wenn der Wert zusätzlich unter einem eigenen Namen exportiert werden soll, für einen Konsumenten außerhalb dieses Builds, schreiben Sie dieses Export: an einen Eintrag Outputs unter einem anderen Schlüssel: Ein Exportname ist dort unterstützt, solange er keiner ist, den der Build ableitet.
Chart-name mismatch on a merged helm-chart umbrella (Abweichender Chart-Name bei einem zusammengeführten helm-chart-Umbrella-Chart)
Zwei oder mehr Boundaries tragen zum selben Assemblierungspfad des Providers helm-chart bei, aber ihre effektiven Annotationen aggrega.ai/chart-name (aufgelöst über die Annotations-Kaskade der Boundaries) stimmen nicht überein. Ein Helm-Umbrella-Chart hat genau einen Chart-Namen; der Renderer kann keinen der widersprüchlichen Kandidaten auswählen.
Ausgegebene Meldungen. Pro beitragender Boundary wird ein Befund gemeldet, jeder mit dem Wert, zu dem diese Boundary aufgelöst wurde, sodass die abweichenden Namen einzeln pro Befund eintreffen statt als eine ausgegebene Sammlung. Die Meldung, unter der sie eintreffen, nennt, was sie gemeinsam haben:
merged dispatch groups whose boundaries disagree on the assembly name (zusammengeführte Weiterleitungsgruppen, deren Boundaries sich beim Assemblierungsnamen nicht einig sind)
Jeder Befund nennt den Wert, zu dem diese Boundary aufgelöst wurde, die Annotation, aus der er gelesen wurde, die Boundary, den Provider und den Pfad, auf dem sie zusammengeführt werden:
merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (die Assemblierung mit zusammengeführtem Pfad hat widersprüchliche Werte der Annotation für den Assemblierungsnamen (mit Wert, Annotation, Boundary, Provider und Weiterleitungspfad wie angegeben))
So beheben Sie es: Deklarieren Sie an jeder beitragenden Boundary eine übereinstimmende Annotation aggrega.ai/chart-name (der Kaskadenmechanismus macht dies DRY, wenn die Beitragenden eine gemeinsame übergeordnete Boundary haben — deklarieren Sie sie einmal an der übergeordneten), oder teilen Sie die Boundaries auf getrennte Pfade directory: auf, sodass jede ihren eigenen Umbrella-Chart erhält.
FeatureRecipe template references a field outside its scope’s allowlist (Das FeatureRecipe-Template verweist auf ein Feld außerhalb der Allowlist seines Geltungsbereichs)
Ein FeatureRecipe mit executionScope: boundary verweist auf ein ausschließlich komponentenbezogenes Feld wie .context.instance_id, .context.inject oder .context.uses — Felder, die auf Boundary-Ebene keinen sinnvollen Wert haben — in einem Template, das einmal für die Boundary ausgeführt wird: seine locals:, provides:, valuesMapping:, artifacts: oder das with: oder when: eines Pipeline-Schritts. Die spiegelbildliche Bedingung gilt ebenfalls: Ein FeatureRecipe auf Komponentenebene (die Voreinstellung), das auf Felder .boundary.* verweist, scheitert am selben Validator. Die Validierung läuft beim Parsen gegen die Feld-Allowlist des jeweiligen Geltungsbereichs, bevor irgendeine Render-Arbeit beginnt. Das injectMapping eines FeatureRecipe auf Boundary-Ebene wird hier nicht geprüft: Es läuft einmal für jede Komponente, die die Anbindung erreicht, im Kontext dieser Komponente, liest also .context.*, und ein Verweis auf .boundary darin wird durch „Template references a root the render context does not define (Das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert)“ weiter oben gemeldet.
Ausgegebene Meldung:
FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (das FeatureRecipe-Template verweist auf ein ausschließlich komponentenbezogenes Feld mit executionScope: boundary (mit dem angegebenen Pfad, geschrieben im angegebenen Feld; der Render-Kontext definiert die angegebenen Wurzeln))
Ein FeatureRecipe auf Boundary-Ebene, dessen valuesMapping.context.instance_id liest, gibt aus:
[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")
So beheben Sie es: Schreiben Sie das Template gegen die im Geltungsbereich verfügbaren Felder um, oder ändern Sie das executionScope des FeatureRecipe. FeatureRecipes auf Boundary-Ebene verweisen auf .boundary.path, .boundary.boundary_name, .boundary.components, die Sammlungen .boundary.*_uses_edges, .boundary.labels, .boundary.annotations und .boundary.feature_attachments. FeatureRecipes auf Component-Ebene verweisen auf .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations. Beide Geltungsbereiche teilen .values, .infra, .locals, .provides, .steps und .metadata. Ein Release-Parameter ist auf dieser Oberfläche keine eigene Säule — er erreicht ein FeatureRecipe-Template über einen Eintrag values oder infra, der auf ihn verweist.
Self-inject value template references cross-node data (Das Werte-Template des Self-Inject verweist auf knotenübergreifende Daten)
Ein Template inject:value: auf Komponentenebene bezieht Daten aus .context.inject oder .context.uses. Der Inject-Kanal ist genau das, was dieser Durchlauf gerade aufbaut — ein Template innerhalb des eigenen Self-Inject-Werts einer Komponente kann nicht aus ihm lesen.
Der .context der Oberfläche ist der Grund dafür: Er trägt instance_id, labels und annotations und sonst nichts. .context.inject und .context.uses sind daher Schlüssel, die der Kontext dieser Oberfläche nicht definiert, und der Verweis bricht als „Template references a root the render context does not define (Das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert)“ weiter oben ab, beim Parsen, bevor irgendetwas gerendert wird. Die Diagnose nennt den Mechanismus und den Zustellschlüssel, zu denen das Template gehört, und führt die Schlüssel auf, die .context hier definiert — sodass dieselbe Meldung sowohl einen echten Zugriff auf knotenübergreifende Daten abdeckt als auch einen einfachen Tippfehler wie {{ .context.nmae }}, der der häufigere Fehler ist und sonst als nichts gerendert worden wäre.
Ausgegebene Meldung — das Detail auf Verweisebene; die umgebende Meldung nennt außerdem den Knoten, den Mechanismus und den Zustellschlüssel:
template references a root the render context does not define (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations) (das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert (das angegebene Self-Inject-Template verweist auf den angegebenen Pfad, der Kontext definiert die angegebenen Schlüssel))
Jeder Frame der Meldung liegt in der Entwicklerdomäne, weil ein Block inject: auf Komponentenebene im Aggregate verfasst wird.
So beheben Sie es: Verlagern Sie die komponentenübergreifende Verdrahtung in einen Eintrag uses[].inject — dort ist der knotenübergreifende Kontext verfügbar. Halten Sie Self-Inject-Templates value: auf Komponentenebene geschlossen über die eigenen values und infra der Komponente, ihre .context.instance_id / .context.labels / .context.annotations und .metadata.
Die Behandlung fehlender Schlüssel hängt von der Template-Oberfläche ab. Wo eine leere Ausgabe an einer begrenzten Stelle landet — einem Manifest-Feld, das der Autor zurücklesen kann —, wird das Fehlen toleriert und der Lesezugriff rendert nichts. Wo eine leere Ausgabe stattdessen eine falsche Struktur oder ein falsches Urteil erzeugen würde, weist die Oberfläche den Verweis zurück, statt ihn zu nichts aufzulösen.
Parameter-Interpolation in einem Aggregate — die Verweise {{ .parameters.<key> }}, die der eigene Text des Aggregate trägt — ist die früheste dieser Oberflächen: Sie läuft über das Rohdokument, bevor der Katalog aufgelöst wird, daher gilt ihre Richtlinie für Text, den noch keine andere Oberfläche gesehen hat. Ein Verweis auf einen Parameter, den das Release nie befüllt hat, wird als nichts gerendert, und eine Pipe default oder ein Wächter if über einem solchen Lesezugriff verhält sich genau so wie über dem nicht befüllten Parameter. Ein Verweis, über den das Template iteriert, iteriert weiterhin als nichts, was eine Iteration über eine optionale Liste genau will — es sei denn, der Text gibt ihn auch aus, was dann abbricht, wie „A template reads and iterates a path that holds nothing (Ein Template liest und iteriert einen Pfad, der nichts enthält)“ weiter unten beschreibt. Ein Verweis, dessen übergeordnetes Element fehlt — .parameters.db.host, wo kein Parameter db befüllt wurde —, bricht weiterhin ab, weil es nichts gibt, in das abgestiegen werden kann, und das Bereitstellen eines übergeordneten Elements den Abbruch gegen ein stillschweigend falsches Artefakt eintauschen würde. Eine Grenze ist es wert, als Grenze statt als Richtlinie benannt zu werden: Ein Verweis, der an einer Wurzel verankert ist, die die Oberfläche nicht definiert, wird unverändert gelassen statt als nichts gerendert, sodass er im interpolierten Dokument als der eigene Platzhaltertext der Template-Engine, <no value>, erhalten bleibt. Nichts auf dieser Oberfläche bricht deswegen ab, verankern Sie daher jeden Parameterverweis an .parameters, und lesen Sie ein verirrtes <no value> als falsch geschriebene Wurzel.
Pfad-Templates (directory: / subDirectory: der Boundaries eines Release) werden mit missingkey=error ausgewertet. Ein Verweis auf eine Variable, die die Oberfläche ihnen nicht gibt, bricht beim Parsen ab — siehe „Path-template references a variable outside the allowlist (Das Pfad-Template verweist auf eine Variable außerhalb der Allowlist)“ weiter oben — und ebenso ein vertippter Schlüssel unter .manifest, dessen Schlüssel deklariert sind. Ein zugelassener, aber zur Auswertungszeit nicht definierter Verweis, etwa ein Schlüssel von .parameters, den das Release nicht liefert, erzeugt einen expliziten Fehler, statt stillschweigend eine leere Zeichenkette in einen Verzeichnispfad zu rendern.
assertions (an einer Component, einem Feature, einem Recipe oder einem FeatureRecipe) werden mit missingkey=error ausgewertet. Ein Verweis auf einen nicht definierten Schlüssel bricht mit einer Diagnose „Schlüssel nicht vorhanden“ ab, die die Entität, die Instanz und die Assertion nennt. Die Strenge ist es, die eine Assertion vertrauenswürdig macht: Ein Prädikat, dessen Verweis als leerer Wert gerendert würde, würde mit nichts vergleichen und bestehen, sodass ein einziger Tippfehler die Regel, zu deren Durchsetzung die Assertion geschrieben wurde, stillschweigend außer Kraft setzen würde. Weil der bloße Verweis abbricht, bevor irgendein Fallback laufen kann, liefert ein einfaches default auf dieser Oberfläche keinen Fallback für ein optionales Feld — schützen Sie den Verweis mit hasKey, oder verwenden Sie den Helper optional, der die Anwesenheitsprüfung direkt durchführt. Auch das Lesen des Schlüssels über index liefert keinen: index bricht bei einem Map-Schlüssel ab, den die Map nicht enthält, und nennt den Schlüssel.
Werte-Templates (valuesMapping des Recipe, Einträge locals: und provides:, Bodys von artifacts:, Workload-Bodys, injectMapping und pipeline.with des FeatureRecipe sowie Self-Inject-Templates value: auf Komponentenebene) werden mit missingkey=zero ausgewertet, sodass ein Verweis auf einen nicht definierten Schlüssel den Build nicht abbricht — der Lesezugriff rendert nichts, und nichts ist das, was das Artefakt erreicht. Was auf dieser Oberfläche doch weiterhin abbricht, ist ein Verweis, der durch einen Container absteigt, den der Autor nie geliefert hat — .values.tls.ca, wo kein tls verfasst wurde —, weil es nichts gibt, in das abgestiegen werden kann. Nur der letzte Schlüssel eines Verweises, dessen Container alle vorhanden sind, wird als nichts gerendert. Ein Feld der obersten Ebene, das der Kontext definiert, für das er aber nichts enthält — .workload an einem Recipe, das keinen synthetisiert, .features an einer Komponente ohne Anbindungen —, wird auf dieselbe Weise als nichts gerendert, wenn es als Ganzes gelesen wird. Ein Verweis ist ein Verweis, wie auch immer er geschrieben wird: .values.list, $.values.list und (.values).list benennen denselben Schlüssel, sodass eine Iteration mit range in einer Schreibweise eine Iteration in allen ist, und ein Schlüssel, der von einer geklammerten Säule gelesen wird, rendert oder bricht genau so ab wie die direkte Schreibweise. Ein Schlüssel, über den das Template mit range iteriert, iteriert weiterhin als nichts, wenn er nicht gesetzt ist, und ein Schlüssel, den es sowohl ausgibt als auch iteriert, bricht ab, wenn er nicht gesetzt ist — siehe „A template reads and iterates a path that holds nothing (Ein Template liest und iteriert einen Pfad, der nichts enthält)“ weiter unten. Absicherungen funktionieren wie erwartet: {{ .values.optional_field | default "fallback" }} liefert tatsächlich den Fallback, weil ein nicht gesetzter Wert für default als leer und für if als falsch gilt. Autoren, die die Unterscheidung zwischen fehlend und null brauchen — „Schlüssel fehlt“ von „Schlüssel vorhanden und leer“ zu unterscheiden —, verwenden den Helper optional, der unter templates/sprig-functions.md dokumentiert ist, und lesen einen gegebenen Schlüssel pro Template nur auf eine Weise: Ein Schlüssel, den dasselbe Template auch als .values.<key> liest, gilt als vorhanden, sodass optional seinen leeren Wert statt des Fallbacks meldet. Was diese Richtlinie nicht abdeckt, ist ein Lesezugriff über index: Das Indizieren einer Map mit einem Schlüssel, den sie nicht enthält, bricht hier wie auf jeder Oberfläche unter Nennung des Schlüssels ab — siehe „A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)“ weiter unten.
Eine Koordinate source: — die mit Templates versehenen Felder eines strukturierten Blocks source: an einem Recipe oder FeatureRecipe (version, ref, chart, module_subdir) — wird mit missingkey=error ausgewertet. Ein Verweis auf einen Schlüssel, den nichts liefert, bricht unter Nennung des Quellfelds ab, statt sich zu nichts aufzulösen: Eine leere Version oder ein leerer Ref würde ein anderes Artefakt fixieren als das, das der Autor benannt hat, und die Fixierung ist das, was jeder spätere Build reproduziert. Diese Oberfläche ist auch diejenige, auf der sich die verfügbare Funktionsmenge unterscheidet und auf der ein Verweis in locals:, den die eigene Verfassungsreihenfolge des Blocks zurückweist, abbricht, bevor irgendetwas ausgewertet wird — siehe unten.
Typisierte Parameterverträge fangen Fälle fehlender Pflichtparameter und Vertragsverletzungen auf der Ebene der Parameterverträge ab, bevor die Interpolation läuft — siehe „Parameter type mismatch / contract violation (Parametertyp stimmt nicht überein / Vertragsverletzung)“ weiter oben.
Die Helper-Menge ist für Werte-Templates, Pfad-Templates und Assertions dieselbe: die Sprig-Funktionen plus die eigenen von Aggrega (optional und capitalizedWords). Das fail von Sprig gehört dazu, sodass ein Werte-Template den Build mit einer eigenen Meldung anhalten kann, wie „A value template failed while it ran (Ein Werte-Template ist während der Ausführung fehlgeschlagen)“ weiter unten beschreibt; eine Assertion ist die dafür geschaffene Oberfläche, da das Abbrechen des Builds ihr ganzer Zweck ist. Zwischen diesen dreien unterscheidet sich die Richtlinie für fehlende Schlüssel — optional ist auch in einem Pfad-Template verfügbar, wo es einen Schlüssel aus .parameters liest, ohne dass zuvor die strenge Richtlinie greift. Das Auflösen einer Koordinate source: unterscheidet sich in der Funktionsmenge selbst und hat einen eigenen Unterabschnitt weiter unten. Die Parameter-Interpolation in einem Aggregate bietet nur die Sprig-Funktionen, daher ist dort keiner der beiden Aggrega-Helper verfügbar. Eine Funktion liest auf jeder dieser Oberflächen auf dieselbe Weise, die Koordinate und die Interpolation eingeschlossen: index, das unter Nennung des Schlüssels abbricht, wenn die gelesene Map ihn nicht enthält.
Die Meldung, die ein Fehlen in einem Pfad-Template ausgibt, wird unter dem Eintrag zitiert, der diese Bedingung dokumentiert, „Path-template references a variable outside the allowlist (Das Pfad-Template verweist auf eine Variable außerhalb der Allowlist)“ weiter oben, sodass sie einmal geschrieben und hier nicht wiederholt wird.
So beheben Sie es: Korrigieren Sie bei Fehlen in Pfad-Templates den Feldnamen zu einem aus der Allowlist, die unter path-template-variables.md dokumentiert ist. Korrigieren Sie bei einem Fehlen in einer Assertion den Verweis — die meisten Meldungen sind ein falsch geschriebener Schlüssel — oder schützen Sie ihn, wo das Feld wirklich optional ist, mit hasKey, oder verwenden Sie den Helper optional; den bloßen Verweis in ein default einzuschließen, beseitigt den Abbruch nicht, weil der Verweis aufgelöst wird, bevor der Fallback läuft, und ihn über index zu lesen ebenso wenig, weil index bei einem Schlüssel abbricht, den die Map nicht enthält. Verwenden Sie bei Fehlen in Werte-Templates, wo eine leere Ausgabe unerwünscht ist, den Helper optional, oder liefern Sie den fehlenden Schlüssel als typisierte Deklaration parameters.* am Aggregate mit einem Wert aus dem Release, als Eintrag provides: einer vorgelagerten Component, verdrahtet über uses[].inject, oder als Eintrag locals: an derselben Entität.
Resolving a source: coordinate registers a narrower function set (Das Auflösen einer source-Koordinate registriert eine engere Funktionsmenge)
Ein strukturierter Block source: wird aufgelöst, damit das Artefakt, das er benennt, fixiert werden kann, und diese Auflösung registriert die eigenen Helper von Aggrega und sonst nichts — optional und capitalizedWords sind verfügbar, und index bricht bei einem Map-Schlüssel, den die Map nicht enthält, genau so ab wie beim Rendern des Recipe; die Sprig-Funktionen sind es nicht. Von den Oberflächen, auf denen ein Recipe oder FeatureRecipe Templates verfasst, ist dies diejenige, deren Funktionsmenge sich unterscheidet, sodass ein Ausdruck, der an anderer Stelle im selben Recipe korrekt gerendert wird, hier zurückgewiesen werden kann. Die engere Menge ist beabsichtigt: Was fixiert wird, bestimmen die values und das infra, die der Autor liefert, und zu den Sprig-Funktionen gehören solche, die die Uhr, die Umgebung, eine Zufallsquelle oder das Netzwerk lesen.
Der Aufruf einer Sprig-Funktion in einem Feld source: oder in einem Eintrag locals:, den dieses Feld liest, bricht beim Parsen ab. Die Diagnose trägt den Kopf E0111 und nennt den Eintrag, das Feld source:, das ihn liest, die Funktion, die sie nicht auflösen konnte, und die Helper, die diese Oberfläche registriert:
resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads (Auflösung: Parsen des Templates am angegebenen locals-Eintrag, gelesen vom angegebenen source-Feld: Auflösung: Parse-Fehler des Source-Templates (Ursache: die angegebene Funktion ist nicht definiert); ein source-Feld und jeder locals-Eintrag, den es liest, wird beim Auflösen der Quelle nur mit den eigenen Helpern von Aggrega (optional, capitalizedWords und index) ausgewertet, nicht mit den Sprig-Funktionen, die ein Rendering hinzufügt; schreiben Sie den Wert ohne diese Funktion, oder verschieben Sie den Wert in einen locals-Eintrag, den kein source-Feld liest)
Ein Feld source:, das die Funktion selbst aufruft, wird auf dieselbe Weise gemeldet und nennt nur das Feld.
Die Reichweite sind die Einträge, die die Koordinate liest. Das Auflösen einer Koordinate wertet jeden Eintrag locals: aus, den ein Feld source: liest, und jeden Eintrag, den ein solcher Eintrag seinerseits liest — und keinen anderen. Ein Eintrag, den kein Feld source: erreicht, wird beim Auflösen der Quelle weder ausgewertet noch geparst noch geprüft, sodass ein locals-Eintrag, den das Rendering braucht — einer, der mit Sprig-Funktionen rechnet oder eine Ressource nach .context.instance_id benennt —, keine Auswirkung auf das Fixieren des Artefakts hat; er wird ausgewertet, und jeder Fehler darin gemeldet, wenn das Recipe gerendert wird. Welche Einträge ein Feld liest, wird anhand seines Textes entschieden, sodass ein Feld, das .locals auf eine Weise liest, die keinen einzelnen Eintrag benennt — {{ index .locals "version" }}, der ganze Block an optional übergeben oder an eine Variable gebunden —, stattdessen jeden Eintrag auswerten lässt, und die Diagnose für einen auf diese Weise erreichten Eintrag sagt das: Statt read by <field> lautet sie evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated.
Zwei Formen liegen außerhalb dieser Oberfläche, und zu wissen, in welcher sich ein Recipe befindet, erklärt, warum derselbe Ausdruck in einem Recipe akzeptiert und in einem anderen zurückgewiesen wird:
Ein als einfache Zeichenkette geschriebenes source: — ein URI oder ein lokaler Pfad statt einer Map — wird unverändert übernommen, hat also keine Felder auszuwerten, und der Block locals: wird hier überhaupt nicht aufgelöst.
Eine Entität, die kein source: deklariert, löst keine Koordinate auf, sodass ihr Block locals: nur für das eigene Rendering dieser Entität aufgelöst wird, wo die vollständige Funktionsmenge gilt.
Der Vertrag über die Verweisreihenfolge ist hier für jeden Eintrag, den die Koordinate liest, derselbe. Das Auflösen einer Koordinate weist in jedem Eintrag, den es auswertet, dieselben Verweise zurück, die ein Rendering zurückweist: einen Eintrag, der einen Geschwistereintrag liest, den der Block weiter unten deklariert, und jedes Template, das einen Schlüssel liest, den der Block nicht deklariert. Beide melden die oben unter „locals: entry references a sibling defined later in the same block (Ein locals-Eintrag verweist auf einen Geschwistereintrag, der später im selben Block definiert ist)“ und „locals: key does not exist (Der locals-Schlüssel existiert nicht)“ dokumentierten Bedingungen — dieselbe Bedingung, mit derselben Abhilfe, gleich welche Auflösung sie zuerst erreicht hat —, und die Meldung nennt das Feld source:, für das der Eintrag ausgewertet wurde. Ein Fehler in einem Eintrag, den kein Feld source: liest, wird beim Rendern des Recipe unter derselben Bedingung zurückgewiesen.
Was diese Oberfläche hingegen übergeht, ist ein Eintrag, den eine Koordinate tatsächlich nicht auflösen kann: einer, der Daten liest, die nur existieren, während ein Artefakt gerendert wird, wobei .context.instance_id der Fall ist, für den es das gibt. Ein solcher Eintrag wird übersprungen, sodass ein Recipe, dessen Koordinate einen solchen Eintrag auf einem Zweig erreicht, den sie nicht nimmt, trotzdem fixiert wird. Wo die Koordinate selbst diesen Eintrag benötigte, bricht die Auflösung unter Nennung des Felds source: ab — die oben für diese Oberfläche beschriebene Meldung eines fehlenden Schlüssels, mit dem Kopf E0110 — und zitiert neben dem Schlüssel, den sie nicht lesen konnte, warum dieser Eintrag hier keinen Wert enthält:
resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context") (Auflösung: Auswerten des Templates am angegebenen source-Feld: Auflösung: Auswertungsfehler des Source-Templates zur Lock-Zeit (Ursache: die Map hat keinen Eintrag für den angegebenen Schlüssel); es liest den angegebenen locals-Eintrag, der hier nicht ausgewertet werden konnte (Ursache: die Map hat keinen Eintrag für den Schlüssel context))
Weder ein Feld source: noch ein Eintrag locals:, den es liest, darf .provides lesen. Ein Block locals: speist einen Block provides: und nie umgekehrt, sodass ein Template auf dieser Oberfläche, das .provides liest, als der umgekehrte Verweis zurückgewiesen wird, der er ist, statt sich zu nichts aufzulösen. Die Zurückweisung ist kein Fehlen zur Lock-Zeit, das eine spätere Phase beheben würde — keine Reihenfolge macht den Verweis gültig —, daher wird sie überall gleich gemeldet, wo die Koordinate aufgelöst wird. Die Diagnose trägt den Kopf E0112; sie nennt das Feld oder den Eintrag und das Feld, das ihn liest, sagt, was an dem Verweis falsch ist, und gibt die Oberfläche an, die der Ausdruck stattdessen lesen darf:
source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference) (das Source-Versions-Template am angegebenen source-Feld verweist auf .provides, was ein ungültiger umgekehrter Verweis ist (locals speist provides, nie umgekehrt) — refaktorisieren Sie es so, dass nur .values und .infra gelesen werden (und .locals über dieselben): Auflösung: das Source-Template verweist auf .provides (ungültiger umgekehrter Verweis))
Wo der Abbruch auftritt: während das Lockfile befüllt oder aufgefrischt wird — aggrega pull oder ein Build, der es befüllt (--auto-pull, --upgrade oder die Workspace-Einstellung auto_pull). Jeder Fehler wird als eine Diagnose gemeldet, deren Kopf der Code dessen ist, was schiefging — E0111 für ein Template, das sich nicht parsen lässt, E0112 für einen Verweis auf .provides, E0110 für ein Template, das geparst wurde und nicht ausgewertet werden konnte —, im Terminal ebenso wie in einem mit aggrega serve verbundenen Editor. Ein fehlender Schlüssel in einem Feld source: wird, anders als eine nicht verfügbare Funktion, bei der Ausführung statt beim Parsen gemeldet und nennt das Feld und den Schlüssel, den die Auflösung nicht lesen konnte.
So beheben Sie es:optional ist auf dieser Oberfläche und auf jedem Werte-Template, Pfad-Template und jeder Assertion registriert, was es zur portablen Wahl macht — {{ optional .values "chart_version" "25.0.8" }} anstelle von {{ default "25.0.8" .values.chart_version }}. Lesen Sie den semantischen Unterschied, bevor Sie ersetzen: optional greift, wenn der Schlüssel fehlt, während default greift, wenn der Wert leer ist, sodass ein als leere Zeichenkette oder als Null verfasster Schlüssel unter optional seinen verfassten Wert behält und unter default ersetzt wird. Wo der Ausdruck wirklich eine Sprig-Funktion braucht — um eine Zeichenkette umzuformen, statt einen Fallback zu liefern —, halten Sie ihn aus dem heraus, was die Koordinate liest: in einem Eintrag locals:, den kein Feld source: liest, oder auf der Oberfläche, die ihn konsumiert (valuesMapping, ein Workload-Body, ein Eintrag artifacts:).
A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)
Ein Template liest eine Map über index — {{ index .values "replicas" }} oder {{ index .context.inject.env $apiKeyVar }} mit einem Schlüsselnamen, den das Template berechnet hat —, und die Map enthält den angefragten Schlüssel nicht. index bricht dort ab und nennt den Schlüssel, auf jeder Oberfläche, die ein Template auswertet: Werte-Templates, Einträge locals: und provides:, Pfad-Templates, Assertions, eine strukturierte Koordinate source:, die Parameter-Interpolation in einem Aggregate und die Prädikate validate: seiner Parameter sowie die Prädikate x-aggrega-when: und x-aggrega-validate: eines Schemas.
Dies ist eine Eigenschaft allein von index, und keine Richtlinie für fehlende Schlüssel einer Oberfläche ändert sie. Ein Punkt-Lesezugriff auf einen nicht gesetzten Schlüssel unter einer offenen Säule rendert auf einem Werte-Template weiterhin nichts, wie „Missing template key — asymmetric policy (Fehlender Template-Schlüssel — asymmetrische Richtlinie)“ weiter oben beschreibt, und ein Template, das prüft, ob der Autor einen solchen Schlüssel geliefert hat, ist nicht betroffen. Was abbricht, ist, index nach einem Schlüssel zu fragen, den die Map nicht enthält. index ist der Weg, auf dem ein Template einen Schlüssel erreicht, dessen Namen es berechnet — etwa eine Zugangsberechtigung, die unter dem Variablennamen gelesen wird, den das konsumierende Recipe gewählt hat —, und ohne den Abbruch würde dieser Lesezugriff den Platzhaltertext der Template-Engine <no value> in das Artefakt schreiben, während der Build erfolgreich wäre: ein Server, der mit diesem Text als Schlüssel gestartet wird. Jede andere Antwort, die index gibt, ist die eigene der Template-Engine: eine Position in einer Liste oder einer Zeichenkette, eine Position außerhalb des Bereichs, ein Schlüssel, den die Map enthält — einschließlich eines, dessen Wert null ist, was <no value> ausgibt.
Ausgegebene Meldung, als letzte Zeile der gesamten Meldung — die Frames darüber nennen den Knoten und das Feld, in dem das Template steht, und bei einem Werte-Template eines Recipe oder FeatureRecipe trägt der Kopf den Code dieser Bedingung:
template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey (Template: Ausführung des angegebenen Templates an der angegebenen Zeile und Spalte, im angegebenen index-Ausdruck: Fehler beim Aufruf von index: das Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält (mit dem angegebenen Schlüssel). Lesen Sie einen Schlüssel, der fehlen kann, über eine Funktion, die zuerst auf ihn prüft, etwa optional, get oder hasKey)
Auf einer Oberfläche, die einen Template-Fehler unter einer eigenen Bedingung meldet — ein Eintrag provides: („A provides: template could not be evaluated (Ein provides-Template kann nicht ausgewertet werden)“), die Parameter-Interpolation („A {{ .parameters.* }} reference cannot be interpolated (Ein Parameterverweis kann nicht interpoliert werden)“), ein Schema-Prädikat („An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Ein Prädikat kann nicht ausgewertet werden)“), eine Koordinate source: („Resolving a source: coordinate registers a narrower function set (Das Auflösen einer source-Koordinate registriert eine engere Funktionsmenge)“) — trägt der Kopf den Code dieser Bedingung, und die Zeile darüber ist der Grund, den er trägt, einschließlich des Schlüssels.
So beheben Sie es: Entscheiden Sie, ob der Schlüssel berechtigterweise fehlen darf.
Er darf. Lesen Sie ihn über eine Funktion, die zuerst auf ihn prüft: {{ optional .values "replicas" 1 }} gibt den Fallback zurück, wenn der Schlüssel fehlt, und den Wert, welcher es auch sei, wenn er vorhanden ist; das get von Sprig gibt für einen fehlenden Schlüssel eine leere Zeichenkette zurück; hasKey prüft, ohne zu lesen. optional ist auf jeder Oberfläche registriert außer der Parameter-Interpolation und den Prädikaten eines Parameters oder eines Schemas, die get und hasKey von Sprig bieten; eine Koordinate source: registriert optional und nicht Sprig.
Er darf nicht. Liefern Sie ihn. Der Schlüssel, den die Meldung nennt, ist der, den das Template angefragt hat, daher sind die üblichen Ursachen ein unter einem anderen Namen veröffentlichter Schlüssel — eine Zugangsberechtigung, deren key nicht der Variablenname ist, den das Recipe liest —, ein falsch geschriebener Schlüssel im Template oder in den verfassten Werten und eine Verbindung, die den Schlüssel liefern würde und nicht verdrahtet ist.
A template reads and iterates a path that holds nothing (Ein Template liest und iteriert einen Pfad, der nichts enthält)
Ein Template gibt einen Pfad unverändert aus und iteriert auch über denselben Pfad — "user": "{{ .values.user }}" und "users": "{{ range .values.user }}…{{ end }}" in einem einzigen valuesMapping, etwa —, und die Daten enthalten dort nichts: Der Schlüssel ist nicht gesetzt, er enthält null, oder er ist ein Feld der obersten Ebene, das der Kontext definiert und für das er nichts enthält, etwa .workload an einem Recipe, das keinen synthetisiert. Der Build bricht ab, bevor das Template läuft, und nennt den Pfad, auf jeder Oberfläche, die einen nicht gesetzten Wert als nichts rendert: die Werte-Templates, die „Missing template key — asymmetric policy (Fehlender Template-Schlüssel — asymmetrische Richtlinie)“ weiter oben aufführt, und die Parameter-Interpolation in einem Aggregate.
Jeder Lesezugriff für sich hat eine Antwort. Ein nicht gesetzter Wert, der ausgegeben wird, rendert nichts, und einer, über den iteriert wird, iteriert über nichts. Ein auf beide Weisen gelesener Pfad kann keine von beiden haben: Ihn als nichts zu rendern, würde den range an Text scheitern lassen, und ihn nicht gesetzt zu lassen, würde den Platzhaltertext der Template-Engine <no value> in das Artefakt schreiben, während der Build erfolgreich wäre. Daher wird keine der beiden Antworten gegeben, und der Build hält stattdessen an.
Was als Ausgabe des Pfads zählt, ist eng gefasst, und die Linie wird dort gezogen, wo das Template ihn mit Sicherheit ausgibt:
Er wird ausgegeben, wenn eine Aktion aus dem Pfad und nichts anderem besteht — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }} oder eine an den Pfad gebundene Variable, {{ $u }} nach {{ $u := .values.user }} — an einer Stelle, die das Template bei jeder Ausführung erreicht.
Er wird nicht ausgegeben, wenn der Lesezugriff in einem Body von if, with oder range oder einem Zweig else steht, weil es von einer Bedingung abhängt, ob dieser Lesezugriff läuft, und die Bedingung kann genau der Test sein, der ihn davor bewahrt, auf nichts zu treffen — so wird {{ if .values.user }}{{ .values.user }}{{ end }} neben einem range .values.user gerendert wie immer. Ebenso wenig wird er ausgegeben, wenn er der eigene Test eines Wächters, die Zuweisung einer Variablen oder ein Argument einer Funktion ist — {{ .values.user | quote }}, {{ toYaml .values.user }} —, deren Ausgabe die Antwort der Funktion statt des Platzhalters ist.
Eine Ausgabe in einem Body, der tatsächlich über einem Pfad läuft, der nichts enthält, schreibt weiterhin <no value>, was diese Prüfung nicht erreicht. Eine Schreibweise eines Pfads ist derselbe Pfad wie jede andere, sodass eine Ausgabe in einer Schreibweise und ein range in einer anderen zusammen beurteilt werden, und die Meldung zitiert die Schreibweise, die das Template zuerst geschrieben hat. Ein Pfad, der einen Wert enthält, wird ausgegeben und iteriert wie immer, und ein Pfad, dessen übergeordnetes Element nichts enthält, bleibt dem Abbruch überlassen, den das Absteigen durch nichts bereits auslöst.
Ausgegebene Meldung, als letzte Zeile der gesamten Meldung — die Frames darüber nennen den Knoten und das Template, und der Kopf trägt den Code dieser Bedingung:
template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only (das Template liest einen Pfad als Wert und iteriert über ihn, und die Daten enthalten an diesem Pfad nichts (mit dem angegebenen Pfad). Liefern Sie einen Wert an dem Pfad, schützen Sie den ausgegebenen Lesezugriff mit einem if oder with über den Pfad, oder lesen Sie ihn nur auf eine Weise)
Die Parameter-Interpolation in einem Aggregate meldet dieselbe Zeile ebenfalls unter dem Code dieser Bedingung. Ein Eintrag provides: meldet einen Template-Fehler unter „A provides: template could not be evaluated (Ein provides-Template kann nicht ausgewertet werden)“, daher trägt der Kopf dort den Code dieser Bedingung, und die Zeile darüber ist der Grund, den er trägt, einschließlich des Pfads.
So beheben Sie es: Entscheiden Sie, welchen der beiden Lesezugriffe das Template meint.
Der Pfad muss vorhanden sein. Liefern Sie ihn — in den values: des Aggregate, im infra: des Release oder in dem Parameter, den das Release befüllt —, oder deklarieren Sie ihn in dem Schema, das ihn regelt, als erforderlich, sodass sein Fehlen dort gemeldet wird, wo er verfasst wird.
Der Pfad darf fehlen. Schützen Sie den ausgegebenen Lesezugriff: {{ with .values.user }}{{ . }}{{ end }} oder {{ if .values.user }}{{ .values.user }}{{ end }} gibt nichts aus, wenn er nicht gesetzt ist, und der range daneben iteriert weiterhin als nichts.
Ein Lesezugriff genügt. Lesen Sie den Pfad auf eine einzige Weise — ein range, der auch schreibt, was er braucht, oder eine Ausgabe über eine Funktion wie toYaml oder join, die selbst für einen nicht gesetzten Wert antwortet.
A value template failed while it ran (Ein Werte-Template ist während der Ausführung fehlgeschlagen)
Das Werte-Template eines Recipe oder FeatureRecipe — eines der Templates, die „Missing template key — asymmetric policy (Fehlender Template-Schlüssel — asymmetrische Richtlinie)“ weiter oben aufführt, darunter ein Workload-Body, ein Body von artifacts: oder ein Eintrag locals: — wurde geparst, begann zu laufen und hielt an, bevor es seinen Text erzeugte. Was es angehalten hat, ist der eigene Grund der Template-Engine, den der Abbruch unter sich trägt: ein Verweis, der durch einen Container absteigt, den nichts geliefert hat, etwa {{ .values.tls.ca }}, wo kein tls verfasst wurde; ein Vergleich zwischen Werten zweier Typen, etwa {{ if eq .context.instance_id 1 }}, der Text mit einer Zahl vergleicht und mit cannot compare text with a number abbricht; oder ein Aufruf des fail von Sprig, den ein Werte-Template ausführen kann, um eine Eingabe mit einer eigenen Meldung zurückzuweisen.
Vier Fehlschläge dieser Templates werden stattdessen unter eigenen Bedingungen gemeldet. Ein Eintrag provides: meldet unter „A provides: template could not be evaluated (Ein provides-Template kann nicht ausgewertet werden)“ weiter unten, mit diesem Satz und dem Grund der Engine innerhalb seiner Meldung. Ein Lesezugriff über index auf einen Schlüssel, den die Map nicht enthält, meldet unter „A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)“ weiter oben. Ein Template, das einen Pfad, der nichts enthält, sowohl ausgibt als auch mit range durchläuft, wird zurückgewiesen, bevor es läuft, unter „A template reads and iterates a path that holds nothing (Ein Template liest und iteriert einen Pfad, der nichts enthält)“ weiter oben. Und ein Template, das sich nicht parsen lässt, hält an, bevor es läuft, daher fällt es nicht unter diese Bedingung.
Ausgegebene Meldung — die Frames darüber nennen die Komponenteninstanz und das Template, etwa recipe "<recipe>" workload template oder Recipe "<recipe>" locals["<key>"], und die eigene Zeile der Template-Engine folgt darunter:
a value template failed while it ran (ein Werte-Template ist während der Ausführung fehlgeschlagen)
Die Zeile der Engine lautet template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> — bei einem Aufruf von failerror calling fail: <the message the template wrote>. Der Build meldet den Abbruch unter einem Tag CATALOG_ERROR, weil das Template vom Autor des Recipe oder FeatureRecipe geschrieben wird. aggrega pull trifft auf denselben Fehlschlag, wenn es das Release rendert, um die externen Eingaben zu ermitteln, die es liest: Es meldet den Fehlschlag, schreibt dennoch die Abhängigkeitsfixierungen der Lockfile und weist darauf hin, dass die Fixierungen der externen Eingaben unvollständig sein können; der Build bricht dabei ab.
So beheben Sie es: Lesen Sie den Grund der Engine am Ende der Meldung — er nennt das Template, die Zeile und Spalte sowie den Ausdruck, an dem es angehalten hat. Liefern Sie bei einem Container, den nichts geliefert hat, diesen, oder sichern Sie den Lesezugriff so ab, dass er nie in etwas Fehlendes absteigt: {{ with .values.tls }}{{ .ca }}{{ end }}, oder der Helper optional. Vergleichen Sie bei zwei verglichenen Typen Gleiches mit Gleichem — eine Zahl mit einer ohne Anführungszeichen geschriebenen Zahl, Text mit in Anführungszeichen geschriebenem Text — oder machen Sie eine Seite mit toString zu Text. Bei einem Aufruf von fail stammt die Meldung vom Autor des Templates und sagt, was das Recipe braucht: Geben Sie ihm das, oder ordnen Sie die Komponente einem Recipe zu, das akzeptiert, was Sie geschrieben haben.
A governance plugin rejected the build (Ein Governance-Plugin hat den Build abgelehnt)
Ein Operator kann ein Governance-Plugin in einer Urteilsrolle anbinden, über dem Graphen, den der Compiler aufgebaut hat, oder über den Artefakten, die er gerendert hat. Ein solches Plugin liest und gibt ein Urteil zurück. Der Host hat keinen Pfad, der eine von ihm zurückkommende Änderung anwenden würde, daher kann eine Urteilsrolle einen Build ablehnen und ihn nicht in Konformität umschreiben — die Ablehnung ist alles, was sie tun kann, und was zu ändern ist, bleibt dem überlassen, der sie liest.
Nur ein Abbruch-Urteil hält den Build an. Warn- und Info-Urteile werden gemeldet, und der Build läuft weiter. Jedes Abbruch-Urteil, das ein Plugin zurückgegeben hat, wird gemeldet, in der Reihenfolge, in der das Plugin sie ausgegeben hat, sodass ein einziger Lauf Sie über alle informiert.
Die Meldung, die ein Build ausgibt, ist die eigene des Plugins, genau so wiedergegeben, wie sie zurückgegeben wurde, und nur von dem Plugin eingerahmt, das sie zurückgegeben hat — wie spezifisch sie ist und wie gut man danach handeln kann, entscheidet daher das Plugin und nicht der Compiler. Welche optionalen Details das Urteil auch trug, sie folgen in eckigen Klammern, jeder Teil benannt: ein Code, eine Regelkennung, eine Klassifizierung, ein Quellverweis, eine Position, ein Vorschlag. Die Bedingung, unter der es erfasst wird, ist policy violation, und darauf löst sich ein Kurzcode im Kopf der Diagnose auf.
Die Ablehnung wird der Governance-Anbindung zugeordnet statt einem Ihrer Dokumente, daher trägt sie keine Dateiposition: Es gibt keinen Schlüssel, der sie hervorgebracht hat, und die Antwort ist, entweder die Policy zu erfüllen oder die Anbindung zu überdenken.
Ausgegebene Meldung:
policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>] (das angegebene Policy-Plugin hat den Build abgelehnt: mit der eigenen Meldung des Plugins und, in eckigen Klammern, dem angegebenen Code, der Regelkennung, der Klassifizierung, dem Quellverweis, der Position und dem Vorschlag)
Der Teil in eckigen Klammern ist nur vorhanden, wo das Urteil Details trug, und jeder Teil darin nur, wo das Plugin ihn gesetzt hat.
So beheben Sie es: Lesen Sie die Meldung des Plugins und den Vorschlag, wo es einen geliefert hat. Wo der Befund zutrifft, ändern Sie das, wogegen er Einwände erhebt. Wo die Policy für dieses Release nicht gelten sollte, ist das eine Frage der Anbindung: Governance-Anbindungen werden unter plugins.governance in der Workspace-Konfiguration konfiguriert, und welches Plugin in welcher Rolle läuft, ist eine Entscheidung des Operators und nichts, was ein Dokument überschreiben kann.
A governance attachment’s settings do not match the plugin’s declared schema (Die Einstellungen einer Governance-Anbindung entsprechen nicht dem deklarierten Schema des Plugins)
Ein Governance-Plugin kann ein Schema für die Einstellungen deklarieren, die seine Anbindung ihm übergibt. Die unter with.settings der Anbindung geschriebenen Einstellungen werden gegen dieses Schema geprüft, bevor das Plugin aufgerufen wird, sodass eine falsch konfigurierte Anbindung als der Konfigurationsfehler gemeldet wird, der sie ist, statt das Plugin als falsch geformte Eingabe zu erreichen und als das zurückzukommen, was das Plugin daraus macht.
Diese Reihenfolge ist der Sinn der Prüfung. Sie grenzt diese Bedingung außerdem klar von einer Ablehnung ab: Das Plugin ist nicht gelaufen, kein Urteil wurde gefällt, und nichts am Build wurde beurteilt. Ein Plugin, das kein Einstellungsschema deklariert, akzeptiert beliebige Einstellungen, daher trifft eine Anbindung an ein solches Plugin nie auf diese Bedingung.
Die Prüfung deckt jede Governance-Rolle ab. Bei einer Anbindung, die unter ir-verdict, render-verdict, label-transform oder annotation-transform verfasst ist, werden die Einstellungen gegen das Schema geprüft, bevor das Plugin aufgerufen wird — with.settings ist in jeder Rolle derselbe verfasste Schlüssel, und jede Rolle liest ihn zuerst gegen das Schema. Eine Transformationsrolle läuft dort, wo der Build sie anwendet, was bei einem Build, der zuerst einen Pull ausführt, während dieses Pulls geschieht, daher beginnt die Meldung dort mit dem Schritt, der sie aufgerufen hat, wie in auto-pull: label-transform:.
Ausgegebene Meldung — die Rolle, unter der die Anbindung verfasst wurde, und das Plugin, das sie nennt, dann der feste Satz, dann das, was die Schemaprüfung gefunden hat:
ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (ir-verdict: das angegebene Plugin: with.settings erfüllt das deklarierte Einstellungsschema des Plugins nicht: mit dem angegebenen Ergebnis der Schemaprüfung: die Einstellungen der Policy-Anbindung erfüllen das deklarierte Einstellungsschema des Plugins nicht)
Die einleitende Klausel lautet render-verdict bei einer Anbindung, die unter dieser Rolle verfasst ist. Was die Schemaprüfung gefunden hat, ist der eigene Bericht des Schema-Validators und erstreckt sich über mehr als eine Zeile.
So beheben Sie es: Korrigieren Sie die Einstellungen unter with.settings dieser Anbindung in plugins.governance. Das Detail in der Mitte der Meldung nennt den fehlerhaften Schlüssel und das, was das Schema dort erwartet hat; die eigene Referenz des Plugins dokumentiert die Einstellungen, die es deklariert.
A pipeline step failed (Ein Pipeline-Schritt ist fehlgeschlagen)
Ein FeatureRecipe kann eine Pipeline deklarieren: eine Folge von Schritten, von denen jeder einen Plugin-Export über den Dokumenten aufruft, die der Knoten ausgegeben hat, sodass ein Feature die Ausgabe formen kann, die das eigene Recipe der Komponente erzeugt hat. Dies ist die Bedingung, unter der ein Schritt meldet, wenn er aus einem anderen Grund fehlschlägt als einem Patch, der etwas adressiert, das die Dokumentmenge nicht enthält, wofür es weiter unten eine eigene Meldung gibt.
Was fehlgeschlagen ist, wird nach der ID des Schritts und seinem Index benannt, und die folgende Klausel sagt, welcher Teil versagt hat: das Rendern der Eingabe with des Schritts, der Aufruf selbst, eine Ausgabe, die der Host nicht lesen konnte, ein Fehler, den das Plugin zurückgegeben hat, eine Diagnose mit Fehlerschweregrad, die das Plugin ausgegeben hat, ein Patch, den die Patch-Engine zurückgewiesen hat, oder ein Patch, der einen Geltungsbereich nennt, den der Durchlauf nicht hat.
Ein fehlgeschlagener Schritt wird vollständig zurückgerollt. Die Dokumente werden auf den Stand vor der Ausführung des Schritts zurückgesetzt, und die eigenen Ausgaben des Schritts werden mit ihnen verworfen, sodass das when oder with eines späteren Schritts kein Teilergebnis lesen kann. Ein als optional: true deklarierter Schritt meldet dann eine Warnung, und der Durchlauf geht weiter; ein Schritt, der nicht optional ist, hält den Build an. Was optional:nicht toleriert, ist ein verletzter deklarierter Vertrag — siehe den Eintrag unten.
Ausgegebene Meldungen:
pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> (Pipeline-Schritt fehlgeschlagen: in der Eingabe des angegebenen Schritts, mit dem angegebenen Index, konnte das Rendern das Angegebene nicht leisten) pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> (Pipeline-Schritt fehlgeschlagen: beim Aufruf des angegebenen Schritts, mit dem angegebenen Index, konnte der Aufruf das Angegebene nicht leisten) pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> (Pipeline-Schritt fehlgeschlagen: der angegebene Schritt, mit dem angegebenen Index, hat eine Fehlerdiagnose mit der angegebenen Meldung des Plugins ausgegeben) pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> (Pipeline-Schritt fehlgeschlagen: im angegebenen Geltungsbereich und Schlüssel hat die Patch-Engine das Angegebene zurückgewiesen) pipeline step failed: unknown patch scope "<scope>" (Pipeline-Schritt fehlgeschlagen: unbekannter Patch-Geltungsbereich, der angegebene)
So beheben Sie es: Lesen Sie die ID des Schritts, dann die Klausel nach dem Index — sie sagt, welche Hälfte des Schritts Sie sich ansehen müssen. Ein Fehlschlag bei with ist ein Template im eigenen Block with: des Schritts, und dessen Behebung liegt bei Ihnen. Eine Fehlerdiagnose ist die eigene Aussage des Plugins über Ihre Eingabe. Ein zurückgewiesener Patch und ein unbekannter Geltungsbereich sind die Ausgabe des Plugins gegenüber dem, was der Knoten ausgegeben hat, und liegen beim Autor des Plugins. Wo ein Schritt tatsächlich fehlschlagen darf — eine optionale Anreicherung statt einer erforderlichen Transformation —, deklarieren Sie ihn als optional: true, wobei Sie bedenken sollten, dass dies einen Fehlschlag toleriert und keinen gebrochenen Vertrag.
A pipeline step’s typed input or output does not satisfy its declared contract (Die typisierte Eingabe oder Ausgabe eines Pipeline-Schritts erfüllt ihren deklarierten Vertrag nicht)
Ein Plugin-Export kann ein Schema für die Eingabe deklarieren, die er entgegennimmt, und für die Ausgaben, die er zurückgibt. Beide werden geprüft: der gerenderte Wert with vor dem Aufruf und die zurückgegebenen Ausgaben danach. Eine Diagnose, deren Schweregrad der gemeinsame Vertrag nicht deklariert, wird auf dieselbe Weise zurückgewiesen.
Dies bricht selbst bei einem als optional: true deklarierten Schritt ab, und genau diese Unterscheidung ist der ganze Grund, warum die Bedingung von einem Fehlschlag des Schritts getrennt ist. Optional toleriert einen Schritt, der seine Aufgabe nicht erfüllen konnte — einen fehlgeschlagenen Aufruf, ein Plugin, das Einwände erhoben hat. Es toleriert keine Ausgabe, die der Host nicht weiterleiten kann, und keine Eingabe, die nie die Struktur hatte, die der Export laut eigener Aussage entgegennimmt: Ein deklarierter Vertrag ist eine Zusage, und ein Build, der einen Schritt mit gebrochenem Vertrag stillschweigend übersprungen hätte, würde Erfolg für ein Feature melden, das nichts getan hat.
Ausgegebene Meldungen:
pipeline step "<id>"with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation (die Eingabe des angegebenen Pipeline-Schritts erfüllt den deklarierten Eingabevertrag nicht: mit dem angegebenen Ergebnis der Schemaprüfung: Verletzung des typisierten E/A-Vertrags des Pipeline-Schritts) pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation (der angegebene Pipeline-Schritt hat Ausgaben zurückgegeben, die den deklarierten Ausgabevertrag nicht erfüllen: mit dem angegebenen Ergebnis der Schemaprüfung: Verletzung des typisierten E/A-Vertrags des Pipeline-Schritts)
und für einen Diagnose-Schweregrad, den der Vertrag nicht deklariert und der innerhalb des Frames des Schritt-Fehlschlags ankommt:
pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation (Pipeline-Schritt fehlgeschlagen: der angegebene Schritt, mit dem angegebenen Index: mit dem angegebenen Schweregrad, den der Host nicht weiterleiten konnte: Verletzung des typisierten E/A-Vertrags des Pipeline-Schritts)
Wo das Template with des Schritts einen als sensibel deklarierten Wert liest, nennt eine Verletzung der Eingabe keinen Wert. Was die Schemaprüfung gefunden hat, wird durch jede fehlerhafte Position und das Schlüsselwort ersetzt, das sie zurückgewiesen hat, abgeschlossen von einem Hinweis, der den Grund nennt — at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive) —, sodass das zu korrigierende Feld dennoch genannt wird. Siehe vocabulary/compact-form-authoring.md „Was eine Zurückweisung über einen deklarierten Wert sagt“.
So beheben Sie es: Korrigieren Sie bei einer Verletzung der Eingabe den Block with: des Schritts anhand des Schemas, das sein Export deklariert — das Detail nennt das Feld und das, was erwartet wurde. Eine Verletzung der Ausgabe und ein nicht deklarierter Schweregrad sind vom Plugin zu beheben; die Deklaration des Schritts ist nicht das, was falsch ist, daher beseitigt es keines von beiden, ihn als optional zu kennzeichnen.
A pipeline patch addresses a document the set does not hold, or one with no tree to address (Ein Pipeline-Patch adressiert ein Dokument, das die Menge nicht enthält, oder eines ohne adressierbaren Baum)
Ein Pipeline-Schritt adressiert ein Dokument über einen Geltungsbereich und einen Schlüssel, und zwei Formen von Adressen werden zurückgewiesen.
Die Menge enthält es nicht. Der Schritt hat ein Paar aus Geltungsbereich und Schlüssel gepatcht, das nicht zu den Dokumenten gehört, die ihm übergeben wurden. Nichts würde bearbeitet, daher hält der Durchlauf an, statt einen Patch auf nichts anzuwenden und Erfolg zu melden:
pipeline patch targets a document not present in the set: scope "<scope>" key "<key>" (der Pipeline-Patch zielt auf ein Dokument, das in der Menge nicht vorhanden ist: mit dem angegebenen Geltungsbereich und Schlüssel)
Es trägt keinen adressierbaren Baum. Manche Einheiten haben keine Struktur, in die ein Patch zeigen kann — ein binärer Inhalt, freier Text, ein Bereich, den der Provider nicht sicher durchlaufen kann. Eine solche Einheit wird dem Schritt trotzdem übergeben, gekennzeichnet mit ihrem Medientyp und ihren Bytes, sodass sie ausgewählt und als Ganzes ausgegeben werden kann; was nicht geht, ist, sie zu patchen, weil es nichts gibt, gegen das sich ein Pfad auflösen könnte. Ein Patch gegen eine solche Einheit hält an, statt stillschweigend übersprungen zu werden:
pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>" (der Pipeline-Patch zielt auf eine opake, nicht strukturierte Einheit: mit dem angegebenen Geltungsbereich und Schlüssel)
Was als strukturiert gilt, ist die eigene Lesart der Einheit durch den Provider und kein fester Test, sodass derselbe Inhalt unter einem Provider adressierbar und unter einem anderen opak sein kann.
Beide sind eigene Zurückweisungen des Durchlaufs, und ein Build meldet sie an dem Knoten, dessen Pipeline den Patch vorgenommen hat, sodass die Meldung oben unter einem Abbruch ankommt, der diesen Knoten nennt. Dieser Abbruch ist die den Build anhaltende Form derselben zwei Adressierungsfehler, dokumentiert unter „A pipeline step addresses documents the node does not have (Ein Pipeline-Schritt adressiert Dokumente, die der Knoten nicht hat)“ weiter unten — was auch die dritte Adresse abdeckt, mit der ein Schritt nichts erreichen kann: eine Anfrage nach den Dokumenten einer Host-Komponente an einer Stelle, an der keine steht.
So beheben Sie es: Beide liegen beim Autor des Plugins und nicht bei Ihnen. Ein Schritt erhält die Dokumentmenge, über der er ausgeführt wird, und kann lesen, welche Schlüssel darin sind, daher ist ein fehlendes Ziel ein Schritt, der ein Dokument adressiert, das dieser Knoten nicht ausgegeben hat — patchen Sie ein Dokument, das vorhanden ist, oder geben Sie das gemeinte zuerst aus und patchen Sie es in einem späteren Schritt. Ersetzen Sie bei einer opaken Einheit den Patch durch eine Ausgabe der ganzen Einheit: Ein opaker Inhalt wird ersetzt statt bearbeitet.
A patch’s test operation did not match the document (Die Testoperation eines Patches stimmte nicht mit dem Dokument überein)
Ein Patch kann eine Operation test enthalten, die zusichert, was sich an einem Pfad befindet, bevor die darauf folgenden Operationen angewendet werden. Die Engine weist den gesamten Patch zurück, wenn die Zusicherung nicht zutrifft, und genau das macht einen bedingten Patch bedingt statt optimistisch: Ein Plugin, das prüft, bevor es bearbeitet, sagt damit, dass es ein Dokument, das es nicht erkennt, nicht anfassen wird.
Zwei Formen werden unter dieser Bedingung gemeldet. Am Pfad befindet sich überhaupt nichts, was die Meldung sagt. Oder es gibt einen Wert, und er ist nicht der zugesicherte, was als bloße Zurückweisung gemeldet wird — weder der zugesicherte noch der gefundene Wert wird zitiert.
Ausgegebene Meldungen:
jsonpatch: test operation failed: no value at path (jsonpatch: Testoperation fehlgeschlagen: kein Wert am Pfad) jsonpatch: test operation failed (jsonpatch: Testoperation fehlgeschlagen)
Wo die Ausgabe eines Pipeline-Schritts den Patch enthielt, kommt die Zurückweisung unter dem Fehlschlag dieses Schritts an und nennt den Schritt. Wo der Patch eines label-transform-Plugins ihn enthielt, kommt sie unter der Zurückweisung des Label-Patches an.
So beheben Sie es: Der Fehler liegt beim Plugin und nicht bei Ihren Dokumenten. Ein Test, der einen Wert erwartete, den das Dokument nicht hat, bedeutet meist, dass das Plugin gegen eine Struktur läuft, für die es nicht geschrieben wurde — die Ausgabe von einem anderen Provider oder ein Dokument, das ein früherer Schritt derselben Pipeline bereits geändert hat. Wo die Korrektur des Patches bei Ihnen liegt, lockern Sie entweder den Test auf das, was das Dokument tatsächlich enthält, oder lassen Sie die Bedingung when des Schritts den Fall überspringen, statt innerhalb des Patches darauf zu prüfen.
A workload: form and the fields beside it do not agree (Die Form einer Workload und die Felder daneben stimmen nicht überein)
Ein workload: deklariert eine form: — die Gestalt dessen, was ausgeführt wird, ausgedrückt in Begriffen, die jedes Ziel versteht, statt im Vokabular eines einzelnen Ziels. Manche Felder ergeben nur bei einer Form Sinn, und eine Form, die ohne das Feld deklariert wird, das sie braucht, hat nichts Kohärentes zu rendern. Beide Richtungen werden geprüft, bevor irgendein Ziel die Workload übersetzt, sodass die Unstimmigkeit einmal gegen das gemeldet wird, was Sie geschrieben haben, statt einmal pro Ziel in den Worten, die jedes Ziel dafür hat.
Fünf Paarungen werden durchgesetzt, und jede meldet ihren eigenen Satz, der beide Hälften nennt und angibt, was zu schreiben ist:
workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (die Workload deklariert ein persistentTemplate-Volume, ist aber nicht form: stateful; deklarieren Sie form: stateful) workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (die Workload ist form: reference, deklariert aber keinen Endpoint; setzen Sie endpoint auf den externen Host oder die URL, auf die der Verweis zeigt) workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (die Workload deklariert einen Endpoint, ist aber nicht form: reference; deklarieren Sie form: reference oder entfernen Sie den Endpoint) workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (die Workload ist form: scheduled, deklariert aber keinen Zeitplan; setzen Sie schedule auf einen Cron-Ausdruck mit 5 Feldern oder ein @-Makro, z. B. @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (die Workload deklariert einen Zeitplan, ist aber nicht form: scheduled; deklarieren Sie form: scheduled oder entfernen Sie den Zeitplan)
Jede wird an der Komponenteninstanz positioniert, deren Workload gelesen wurde, und als Übersetzungsfehler gemeldet, weil die Unstimmigkeit zwischen zwei Feldern eines einzigen verfassten Blocks besteht.
Die Bedingungen, unter denen sie erfasst werden und auf die ihre Kurzcodes aufgelöst werden, sind persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule und schedule requires form: scheduled.
Eine Paarung gilt nur in eine Richtung. Eine Workload mit form: stateful ohne Claim-Template pro Replica ist gewöhnlich und löst nichts aus — die Regel lautet, dass ein Claim-Template die stabile Identität pro Replica braucht, die nur diese Form bietet, nicht dass die Form ein Claim-Template braucht. Die anderen beiden Paarungen gelten in beide Richtungen, weil ein Endpoint und ein Zeitplan jeweils genau eine Form haben, auf der sie überhaupt etwas bedeuten.
Die beiden Paarungen zu endpoint stehen auch im Workload-Schema, sodass eine Workload, die eine davon verletzt, in der Schemaphase unter E0214 zurückgewiesen wird, bevor ihr Satz oben erreicht wird. Ein endpoint: auf einer anderen Form als reference — eine weggelassene form: eingeschlossen, da sie als stateless gelesen wird — wird zurückgewiesen als
workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (Validierung der Workload fehlgeschlagen, in der Workload des angegebenen Recipe am angegebenen Pfad, Schemaphase: .endpoint: der Wert entspricht einer Form, die hier nicht zulässig ist)
und form: reference ohne endpoint: endet stattdessen mit .endpoint: missing required property: endpoint. Die Abhilfe ist die, die der Satz der Paarung angibt.
So beheben Sie es: Jeder Satz nennt die beiden Felder und gibt beide Antworten. Fügen Sie das Feld hinzu, das die Form braucht, oder ändern Sie die Form in diejenige, zu der das Feld gehört, oder entfernen Sie das Feld, wo es bei einer Bearbeitung zurückgeblieben ist — einen Wert von schedule: zu löschen und den Schlüssel stehen zu lassen, ist die Form, in der dieser Fehler am häufigsten auftritt.
A workload schedule: is not an expression the check accepts (Der Zeitplan einer Workload ist kein Ausdruck, den die Prüfung akzeptiert)
Eine Workload mit form: scheduled trägt ein schedule:, das angibt, wann sie läuft, und der Wert wird auf seine Struktur geprüft, bevor irgendein Ziel ihn liest. Zwei Schreibweisen werden akzeptiert: eines der fünf Makros @hourly, @daily, @weekly, @monthly und @yearly oder ein Crontab-Ausdruck mit fünf Feldern, deren Felder nur Ziffern und die Zeichen *, ,, - und / verwenden.
Was die Prüfung liest und was nicht. Sie zählt die Felder und betrachtet die Zeichen darin. Sie wertet keine Bereiche, keine Schrittarithmetik und keine Namen von Wochentagen aus, sodass ein Ausdruck mit fünf Feldern, dessen Zahlen außerhalb des Bereichs liegen, hier durchgeht und vom Ziel zurückzuweisen ist. Ein Ausdruck mit sechs Feldern, der ein führendes Sekundenfeld trägt, wird zurückgewiesen: Fünf Felder sind das, was diese Oberfläche akzeptiert, und ein Ziel, das Sekunden will, erhält sie auf anderem Weg.
Ausgegebene Meldung:
workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly (der Zeitplan der Workload ist kein gültiger Cron-Ausdruck; verwenden Sie einen Crontab-Ausdruck mit 5 Feldern wie im Beispiel oder eines von @hourly, @daily, @weekly, @monthly, @yearly)
Die Bedingung, unter der dies erfasst wird, ist schedule is not a valid cron expression, worauf sein Kurzcode aufgelöst wird.
So beheben Sie es: Zählen Sie zuerst die Felder — ein Zeitplan mit vier oder sechs Feldern ist die häufigste Ursache, und ein überzähliges Leerzeichen innerhalb eines Feldes teilt es in zwei. Ersetzen Sie einen benannten Tag oder Monat durch seine Zahl, und greifen Sie zu einem Makro, wo eines das ausdrückt, was Sie meinten.
A workload suspend: is set on a form other than scheduled (Die Aussetzung einer Workload ist bei einer anderen Form als der geplanten gesetzt)
suspend: true hält den wiederkehrenden Zeitplan einer Workload mit form: scheduled an: Die geplante Ressource wird gerendert, und aus ihrem Zeitplan startet kein Lauf, bis sie fortgesetzt wird. Keine andere Form trägt einen Zeitplan, daher gibt es bei jeder anderen Form nichts, was das Feld anhalten könnte, und der Build bricht ab, statt eine Workload zu rendern, die es stillschweigend verwirft. Die Prüfung läuft zusammen mit den anderen Form-Paarungen, bevor irgendein Ziel die Workload übersetzt, und eine weggelassene form: wird auch hier als stateless gelesen.
Ausgegebene Meldung:
workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (die Workload deklariert suspend, ist aber nicht form: scheduled; deklarieren Sie form: scheduled mit einem Zeitplan oder entfernen Sie suspend)
Sie wird an der Komponenteninstanz positioniert, deren Workload gelesen wurde, und als Übersetzungsfehler gemeldet. Die Bedingung, unter der sie erfasst wird, ist suspend requires form: scheduled, worauf ihr Kurzcode aufgelöst wird.
Die Regel gilt nur in eine Richtung und nur bei true. Eine Workload mit form: scheduled ohne suspend: ist gewöhnlich und läuft nach ihrem Zeitplan, und suspend: false, der Standardwert, löst bei keiner Form etwas aus.
So beheben Sie es: Wo die Workload nur laufen sollte, wenn jemand sie startet, machen Sie sie zu form: scheduled mit einem schedule: und behalten Sie suspend: true bei; andernfalls behalten Sie die Form wie geschrieben bei und entfernen Sie suspend:, das keine andere Form liest.
A library $import: is not written in the bare-name form (Ein Bibliotheksimport ist nicht in der Form mit bloßem Namen geschrieben)
Drei Felder eines Recipe und eines FeatureRecipe können ihren Inhalt aus einer Bibliothek beziehen, statt ihn an Ort und Stelle zu schreiben: ein Eintrag artifacts.<name>:, ein valuesMapping: und ein workload:. Jedes schreibt $import: mit dem bloßen Namen der Bibliothek, dann #, dann den Pfad des Eintrags auf der Oberfläche, die dieses Feld liest — #/artifacts/, #/mappings/ bzw. #/workloads/. Ein Wert, der nicht diese Form hat, nennt nichts, was der Build auflösen kann, und wird beim Auflösen des Feldes zurückgewiesen.
Die drei Felder sind bewusste Spiegelbilder voneinander, daher liest sich der Fehler bei allen dreien gleich, und nur die Oberfläche ändert sich:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (der artifacts-Import ist kein Verweis auf eine Artefaktbibliothek in der Form mit bloßem Namen: mit dem angegebenen Wert, wie er geschrieben wurde) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (der valuesMapping-Import ist kein Verweis auf eine Mapping-Bibliothek in der Form mit bloßem Namen: mit dem angegebenen Wert, wie er geschrieben wurde) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (der workload-Import ist kein Verweis auf eine Workload-Bibliothek in der Form mit bloßem Namen: mit dem angegebenen Wert, wie er geschrieben wurde)
Eine mit @ geschriebene Version wird mit der stattdessen zu verwendenden Schreibweise gemeldet, statt in eine Beanstandung zu münden, die Bibliothek sei nicht gefunden worden, weil es der Fehler ist, zu dem diese Form am häufigsten verleitet:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (der artifacts-Import ist kein Verweis auf eine Artefaktbibliothek in der Form mit bloßem Namen: das Versionstrennzeichen ist ’:’, nicht ’@’ — verwenden Sie den angegebenen korrigierten Wert)
Eine weitere Form wird hier gemeldet, und sie ist kein Schreibfehler. Der eigene Dateiinhalt eines ArtifactLibrary-Bundles darf selbst kein $import: eines anderen Bundles sein: Ein Dateiplatz kann sich nicht in viele Dateien entfalten, daher wird ein verschachtelter Import zurückgewiesen, statt in etwas aufgelöst zu werden, das der Autor nicht geschrieben hat. Setzen Sie die Bundles stattdessen an der Stelle zusammen, an der sie konsumiert werden.
Ein Eintrag artifacts:, den das eigene Recipe einer Komponente schreibt, wird entschieden, bevor irgendetwas gerendert wird, daher wird die Meldung am Block artifacts: in diesem Recipe positioniert und nennt den Verweis, das Bundle, die Datei, deren Inhalt den verschachtelten Import trägt, und den Eintrag, an dem der Import geschrieben wurde. Jede Datei des Bundles in dieser Form wird in einem einzigen Build gemeldet; wo es mehr als eine ist, werden die Befunde unter artifacts entries whose library import the compiler cannot resolve gruppiert:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them (der artifacts-Import ist kein Verweis auf eine Artefaktbibliothek in der Form mit bloßem Namen, mit dem angegebenen Wert, wie er geschrieben wurde, dem angegebenen Bundle, der angegebenen Bundle-Datei und dem angegebenen artifacts-Eintrag. Der Inhalt einer Bundle-Datei kann kein anderes Bundle importieren — setzen Sie die beiden an dem artifacts-Eintrag zusammen, der sie konsumiert)
Ein Eintrag artifacts:, den ein FeatureRecipe schreibt, meldet dieselbe Bedingung beim Auflösen des Bundles und nennt die erste Datei in dieser Form:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site) (der artifacts-Import ist kein Verweis auf eine Artefaktbibliothek in der Form mit bloßem Namen: der Inhalt der angegebenen Datei des angegebenen Bundles ist ein Import an der Feldwurzel; ein verschachtelter Bibliotheksimport innerhalb einer Bundle-Datei wird nicht unterstützt; setzen Sie an der Stelle des Konsums zusammen)
Ein valuesMapping:, das das eigene Recipe einer Komponente schreibt, wird entschieden, bevor irgendetwas gerendert wird, daher wird die Meldung am Schlüssel valuesMapping: in diesem Recipe positioniert und enthält die zu verwendende Schreibweise:
valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/ (der valuesMapping-Import ist kein Verweis auf eine Mapping-Bibliothek in der Form mit bloßem Namen, mit dem angegebenen Wert, wie er geschrieben wurde. Nennen Sie die Bibliothek und den Eintrag zu beiden Seiten des Fragments — schreiben Sie die angegebene Form)
Ein valuesMapping:, das ein FeatureRecipe schreibt, meldet beim Auflösen des Verweises, in der Form, die die Liste oben enthält.
Ein workload:, das das eigene Recipe einer Komponente schreibt, wird entschieden, bevor irgendetwas gerendert wird, daher wird die Meldung am Schlüssel workload: in diesem Recipe positioniert und enthält die zu verwendende Schreibweise:
workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/ (der workload-Import ist kein Verweis auf eine Workload-Bibliothek in der Form mit bloßem Namen, mit dem angegebenen Wert, wie er geschrieben wurde. Nennen Sie die Bibliothek und den Eintrag zu beiden Seiten des Fragments — schreiben Sie die angegebene Form)
Ein workload:, das ein FeatureRecipe schreibt, meldet beim Auflösen des Verweises, in der Form, die die Liste oben enthält.
So beheben Sie es: Schreiben Sie den Wert als <Library>#<entry-path> neu und fügen Sie :<version> nach dem Namen der Bibliothek nur dort hinzu, wo Sie eine Untergrenze dafür brauchen, welche Version ausgewählt werden darf. Prüfen Sie, ob das Fragment zum Feld passt — ein Eintragspfad #/mappings/… auf einem workload: nennt eine Oberfläche, die dieses Feld nicht liest, und wird hier gemeldet statt als fehlender Eintrag. Dieselbe Identitätsform gilt für den $ref: eines Schemas, dessen Zurückweisungen oben unter „A $ref: is not written in a form the compiler can resolve (Ein Verweis ist nicht in einer Form geschrieben, die der Compiler auflösen kann)“ dokumentiert sind.
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
Ein $import: ist korrekt geschrieben, und das, worauf er zeigt, ist nicht vorhanden. Sechs Bedingungen decken die zwei Hälften eines Verweises über die drei Bibliotheksarten ab, und welche Sie erhalten, sagt Ihnen, welche Hälfte Sie prüfen müssen: Die Bibliothek selbst fehlt in dem, was der Build sehen kann, oder die Bibliothek ist vorhanden und veröffentlicht den Eintrag nicht.
Die Menge, gegen die ein Verweis aufgelöst wird, ist der eigene Katalog des Workspace plus die Bibliotheken, die das Lockfile fixiert und beim Laden des Build eingebracht hat. Eine Bibliothek, von der nichts im Abhängigkeitsabschluss des Release eine Abhängigkeit deklariert, ist daher nicht in dieser Menge, wie korrekt der Verweis darauf auch aussehen mag.
Die Bibliothek ist nicht vorhanden:
artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (ein Artefaktbibliotheksimport verweist auf eine ArtifactLibrary, die im Katalog nicht vorhanden ist: mit der angegebenen ArtifactLibrary und dem angegebenen Bundle) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (ein Mapping-Bibliotheksimport verweist auf eine MappingLibrary, die im Katalog nicht vorhanden ist: mit der angegebenen MappingLibrary und dem angegebenen Eintrag) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (ein Workload-Bibliotheksimport verweist auf eine WorkloadLibrary, die im Katalog nicht vorhanden ist: mit der angegebenen WorkloadLibrary und dem angegebenen Eintrag)
Der Eintrag ist nicht vorhanden:
artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (ein Artefaktbibliotheksimport verweist auf ein Bundle, das in der ArtifactLibrary nicht vorhanden ist: mit dem angegebenen Bundle in der angegebenen ArtifactLibrary) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (ein Mapping-Bibliotheksimport verweist auf einen Eintrag, der in der MappingLibrary nicht vorhanden ist: mit dem angegebenen Eintrag in der angegebenen MappingLibrary) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (ein Workload-Bibliotheksimport verweist auf einen Eintrag, der in der WorkloadLibrary nicht vorhanden ist: mit dem angegebenen Eintrag in der angegebenen WorkloadLibrary)
Ein Eintrag artifacts:, den das eigene Recipe einer Komponente schreibt, meldet ein fehlendes Bundle in einer eigenen Form. Dieser Eintrag wird entschieden, bevor irgendetwas gerendert wird, daher ist die Meldung am Block artifacts: in diesem Recipe positioniert und nennt den Eintrag, an dem der Import geschrieben wurde, zusammen mit beiden Hälften des Verweises:
artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (ein Artefaktbibliotheksimport verweist auf ein Bundle, das in der ArtifactLibrary nicht vorhanden ist: mit dem angegebenen Bundle, der angegebenen ArtifactLibrary und dem angegebenen artifacts-Eintrag)
Ein valuesMapping:, das das eigene Recipe einer Komponente schreibt, meldet einen fehlenden Eintrag in einer eigenen Form, aus demselben Grund: Auch es wird entschieden, bevor irgendetwas gerendert wird, daher ist die Meldung am Schlüssel valuesMapping: in diesem Recipe positioniert und nennt beide Hälften des Verweises:
mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (ein Mapping-Bibliotheksimport verweist auf einen Eintrag, der in der MappingLibrary nicht vorhanden ist: mit dem angegebenen Eintrag und der angegebenen MappingLibrary)
Ein workload:, das das eigene Recipe einer Komponente schreibt, meldet einen fehlenden Eintrag in einer eigenen Form, aus demselben Grund: Auch es wird entschieden, bevor irgendetwas gerendert wird, daher ist die Meldung am Schlüssel workload: in diesem Recipe positioniert und nennt beide Hälften des Verweises:
workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (ein Workload-Bibliotheksimport verweist auf einen Eintrag, der in der WorkloadLibrary nicht vorhanden ist: mit dem angegebenen Eintrag und der angegebenen WorkloadLibrary)
Ein Eintrag artifacts:, den ein FeatureRecipe schreibt, ein valuesMapping: oder ein workload:, das ein FeatureRecipe schreibt, und jeder Verweis auf eine Bibliothek, die der Build nicht sehen kann, melden, während der Verweis aufgelöst wird, in den Formen, die die beiden Listen oben aufführen.
Jede nennt sowohl die Bibliothek als auch den Eintrag, gleich welche Hälfte fehlgeschlagen ist, sodass eine einzige Meldung genügt, um eine fehlende Bibliothek von einem fehlenden Eintrag zu unterscheiden, ohne etwas zu öffnen.
So beheben Sie es: Prüfen Sie bei einem fehlenden Eintrag den Namen anhand dessen, was die Bibliothek veröffentlicht — ein Eintragsname ist ein Schlüssel in der eigenen Map dieser Bibliothek und unterscheidet zwischen Groß- und Kleinschreibung. Bei einer fehlenden Bibliothek ist der Verweis meist richtig, und was nicht ausreicht, ist der Abschluss: Deklarieren Sie die Abhängigkeit von dieser Bibliothek, damit sie geladen wird, und aktualisieren Sie das Lockfile, damit sie fixiert wird. Eine Bibliothek, die in einem Workspace erreichbar ist und in einem anderen nicht, ist derselbe Fehler, von der anderen Seite gesehen.
A library $import: addresses its library by registry location (Ein Bibliotheksimport adressiert seine Bibliothek über ihren Registry-Ort)
Ein $import: einer Bibliothek nennt seine Bibliothek über ihre Identität, niemals über die Registry, in der sie zufällig veröffentlicht ist. Über welche Registry ein Name aufgelöst wird, ist Sache der Workspace-Konfiguration, und welche Version verwendet wird, beantwortet das Lockfile; ein Verweis, der einen Host enthält, legt daher in einem Katalogdokument zwei Dinge fest, über die der Build entscheiden soll — und das Dokument funktioniert dann in keinem anders konfigurierten Workspace mehr.
Wo ein solcher Verweis diesen Abbruch noch erreichen kann, ist enger, als es aussieht. Die eigenen Felder $import: eines Recipe und eines FeatureRecipe werden früher zurückgewiesen, von ihrem Schema, das an keiner der drei Positionen ein Registry-Präfix zulässt. Übrig bleibt der Verweis, den kein Schema beschreibt: einer, der aus dem eigenen Inhalt eines Bibliothekseintrags gelesen wird, den die Entität, die ihn konsumiert, nicht geschrieben hat und erst sehen kann, wenn der Inhalt aufgelöst ist.
Ausgegebene Meldung, von den Oberflächen valuesMapping: und workload:, wo der Resolver nur den Wert meldet:
library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" (der Bibliotheksimport enthält einen Registry-Host; verweisen Sie über die Identität mit dem bloßen Namen auf die Bibliothek: mit dem angegebenen Wert, wie er geschrieben wurde)
Ein Eintrag artifacts: erreicht diesen Abbruch nicht, und der Grund ist wissenswert, falls Sie ihn dort suchen. Sein eigener Verweis wird mit dem Rest des Dokuments zurückgewiesen, wie jede andere Position; und anders als bei den beiden anderen Oberflächen wird eine Bundle-Datei, deren Inhalt selbst ein Import ist, zurückgewiesen statt verfolgt — es gibt also keinen Inhalt, aus dem ein Verweis mit Host kommen könnte.
So beheben Sie es: Entfernen Sie den Host und alles vor dem Namen der Bibliothek, sodass <Library>#<entry-path> übrig bleibt. Wenn der fehlerhafte Wert in einer Bibliothek steht, die Sie konsumieren, statt in einer, die Sie veröffentlichen, ist die Korrektur Sache des Autors dieser Bibliothek; bis sie vorliegt, bringt das Importieren eines anderen Eintrags oder das Schreiben des Inhalts an Ort und Stelle den Build wieder durch.
Two artifact outputs of one Recipe carry the same filename (Zwei Artefaktausgaben eines Recipe tragen denselben Dateinamen)
Der Block artifacts: eines Recipe benennt eine Ausgabe pro Schlüssel, und ein unter einem Schlüssel importiertes Bundle steuert seine Dateien darunter bei. Zwei Ausgaben, die bei einem Dateinamen ankommen, würden bedeuten, dass eine die andere überschreibt, daher bricht der Build ab, statt zu wählen, welche bestehen bleibt.
Dies ist ein Restschutz, und das zu sagen gehört zu dem, was er ist. Eine Ausgabe wird nach dem Schlüssel benannt, unter dem sie verfasst wurde, Map-Schlüssel sind innerhalb eines Dokuments eindeutig, und die Authoring-Oberfläche beschränkt einen Schlüssel auf einen einzigen Dateinamen — daher können zwei verfasste Einträge nicht kollidieren, und ein Schlüssel kann auch nicht den verschachtelten Namen schreiben, den das Bundle eines anderen Schlüssels erzeugt. Was der Schutz noch abdeckt, ist Inhalt, der die Projektion erreicht hat, ohne die Zurückweisung doppelter Schlüssel eines verfassten Dokuments zu durchlaufen: Zustand, der während der Ausführung des Build zusammengesetzt statt aus einer Datei gelesen wurde. Eine hier gemeldete Kollision verweist daher darauf, wie der Build zusammengesetzt wurde, statt auf eine Zeile, die Sie sehen können.
Er wird pro Recipe über die eigenen Ausgaben dieses Recipe ausgelöst, und das unterscheidet ihn von zwei verschiedenen Beitragenden, die in einer Assemblierung auf einem Pfad landen — das ist „Two contributors write the same output path (Zwei Beitragende schreiben denselben Ausgabepfad)“ weiter oben, mit einer anderen Abhilfe.
Ausgegebene Meldung:
artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (Kollision des Dateinamens einer artifacts-Ausgabe: Zwei Artefaktausgaben tragen denselben Dateinamen, mit dem angegebenen Recipe und der angegebenen Artefaktausgabe, die mehr als einmal ausgegeben wurde)
So beheben Sie es: Öffnen Sie das Recipe, das die Meldung nennt, und prüfen Sie seine Schlüssel unter artifacts: anhand der Dateien, die ein von ihm importiertes Bundle beisteuert. Wenn die Schlüssel tatsächlich verschieden sind und die Kollision dennoch besteht, ist im Dokument nichts fehlerhaft, und es lohnt sich, die Meldung bei denjenigen vorzubringen, die den Build betreuen.
An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Eine Bundle-Datei einer ArtifactLibrary benennt keine eigene Datei unter dem Schlüssel, unter dem sie importiert wurde)
Ein Eintrag artifacts:, der ein Bundle importiert, wird zu einer Ausgabe pro Datei in diesem Bundle expandiert, jede unter dem Schlüssel verschachtelt, an dem der Import geschrieben wurde. Der Schlüssel benennt also ein Verzeichnis, und jede Datei, die das Bundle beisteuert, gehört darunter, unter einem eigenen Namen. Ein Dateiname, der aus diesem Verzeichnis heraussteigt, einen absoluten Ort benennt oder gar nichts benennt, tut das nicht, und der Build bricht ab, statt die Datei an einem Ort abzulegen, den das konsumierende Recipe nie gewählt hat.
Nichts zu benennen umfasst jeden Namen, der nicht die eine Schreibweise einer einzelnen Datei unter dem Schlüssel ist.. und ./ sowie ein Name, der wieder auf den Schlüssel zurückfällt, wie x/.., benennen den Schlüssel selbst, sodass die Datei dort geschrieben würde, wo das Verzeichnis des Schlüssels hingehört. Ein Name mit einem abschließenden oder doppelten / oder mit einem Teil . oder .. — x/, a//b, ./a, a/./b, a/../b — ist eine zweite Schreibweise einer Datei, die ein anderer Name tragen kann: a//b neben a/b sind zwei Namen für eine Datei, und eine würde über die andere geschrieben, ohne dass eine Kollision gemeldet wird. Auch der leere Name wird zurückgewiesen.
Was er verhindert, ist ein stilles Umordnen statt eines Schreibvorgangs außerhalb des Ausgabeverzeichnisses. Wo die Dateien geschrieben werden, ist noch einmal abgesichert, sodass ein Name, der weit genug hinaufsteigt, dort ohnehin zurückgewiesen wird. Der Name, der diesen Schutz übersteht, ist derjenige, der genau eine Ebene hinaufsteigt: Er landet wieder innerhalb des Ausgabeverzeichnisses, an einer Position, die niemand gewählt hat. Das ist schlimmer als ein zurückgewiesener Schreibvorgang, weil jeder Kollisionsschutz auf diesem Pfad einen Namen so liest, wie er zusammengesetzt wurde, und nicht so, wie er sich auflöst — daher können zwei solche Dateien auf eine Ausgabe aufgelöst werden, ohne dass etwas eine Kollision meldet, und welche bestehen bleibt, entscheidet nichts, was irgendjemand geschrieben hat.
Ein verschachteltes Layout, das schlicht innerhalb des Schlüssels geschrieben ist, bleibt unberührt. Ein Bundle darf eigene Unterverzeichnisse mitbringen, etwa rbac/role.yaml, und sie unter dem Konsumschlüssel zu verschachteln, ist genau der Zweck des Schlüssels. Ein Name, der lediglich Punkte innerhalb eines Teils enthält, etwa ..config oder role.v1.yaml, ist ein gewöhnlicher Name.
Das konsumierende Recipe und das veröffentlichte Bundle werden meist von verschiedenen Autoren geschrieben, daher nennt die Meldung beide Hälften zusammen mit der Abhilfe.
Ein Eintrag artifacts:, den das eigene Recipe einer Komponente schreibt, wird entschieden, bevor irgendetwas gerendert wird, daher ist die Meldung am Block artifacts: in diesem Recipe positioniert und nennt zuerst die Datei, dann die Bibliothek, aus der sie stammt, und den Eintrag, an dem sie konsumiert wird. Jede Datei des Bundles, deren Name zurückgewiesen wird, wird in einem Build gemeldet; wo es mehr als eine ist, werden die Befunde unter artifacts entries whose library import the compiler cannot resolve gruppiert:
artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (der Dateiname in einem Bundle einer Artefaktbibliothek benennt keine eigene Datei unter dem artifacts-Schlüssel, unter dem seine Ausgabe verschachtelt ist, mit der angegebenen Datei, der angegebenen ArtifactLibrary und dem angegebenen artifacts-Eintrag. Benennen Sie die Datei innerhalb des Bundles der ArtifactLibrary in einen gewöhnlichen Dateinamen unter dem artifacts-Schlüssel um, an dem sie konsumiert wird, etwa „config.yaml“ oder „rbac/role.yaml“ — kein Teil „.“ oder „..“ und kein führendes, abschließendes oder doppeltes „/“)
Ein Eintrag artifacts:, den ein FeatureRecipe schreibt, meldet dieselbe Bedingung, während das Bundle aufgelöst wird, und nennt das Rezept, in dem er geschrieben wurde, sowie die erste solche Datei:
artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (der Dateiname in einem Bundle einer Artefaktbibliothek benennt keine eigene Datei unter dem artifacts-Schlüssel, unter dem seine Ausgabe verschachtelt ist, mit dem angegebenen Recipe, dem angegebenen Artefakt und der angegebenen Bundle-Datei. Benennen Sie die Datei innerhalb des Bundles der ArtifactLibrary in einen gewöhnlichen Dateinamen unter dem artifacts-Schlüssel um, an dem sie konsumiert wird, etwa „config.yaml“ oder „rbac/role.yaml“ — kein Teil „.“ oder „..“ und kein führendes, abschließendes oder doppeltes „/“)
So beheben Sie es: Benennen Sie die Datei innerhalb der ArtifactLibrary in einen gewöhnlichen Dateinamen unter dem Schlüssel um. Wenn die Bibliothek nicht Ihre ist, bringt das Importieren eines anderen Bundles oder das Schreiben des Eintrags an Ort und Stelle den Build wieder durch, während die Korrektur upstream vorgenommen wird. Eine Datei, die ganz woanders landen soll, ist ein zweiter Eintrag artifacts: unter dem Schlüssel, unter den sie gehört, und kein Name, der dorthin wandert.
An imported artifact no longer matches the digest recorded beside its Recipe (Ein importiertes Artefakt stimmt nicht mehr mit dem neben seinem Recipe erfassten Digest überein)
Bei einem Eintrag artifacts:, der eine lokale Datei importiert, wird der Inhalt fixiert, wenn das Recipe fixiert wird — durch aggrega pin oder durch einen Pull oder einen Push, der denselben Schritt ausführen soll: Der Digest der Bytes der Datei wird in entity.lock neben dem Recipe erfasst. Ein Eintrag von boundary.artifacts: eines Recipe wird auf dieselbe Weise fixiert und verglichen und unter boundary/<key> erfasst, dem Namen, den die Meldung ihm gibt. Jeder Build liest die Datei erneut, berechnet ihren Digest neu und weist die Abweichung zurück — sodass eine Datei, die nach dem Fixieren bearbeitet wurde, nie so gerendert wird, als wäre sie geprüft worden. aggrega pull --verify führt denselben Vergleich durch und meldet eine Abweichung mit derselben Meldung.
Verglichen wird der Inhalt des Eintrags, nicht das, was sein Rendern erzeugt hat. Der Inhalt eines Artefakts ist ein Template, und seine Auswertung setzt Werte ein, die sich pro Komponenteninstanz unterscheiden, sodass ein Digest über die Ausgabe für jede Instanz abweichen würde, deren Werte sich unterscheiden. Der erfasste Inhalt ist für jede Instanz, die das Recipe bindet, derselbe Text, und das macht einen einzigen erfassten Digest zum richtigen Vergleichsmaßstab.
Drei Oberflächen tragen dieselbe Prüfung über verschiedene Dokumente — das eigene Recipe einer Komponente, ein an eine Komponente angebundenes Feature und ein an eine Boundary angebundenes Feature —, daher wird der Inhalt des FeatureRecipe an dem Digest gemessen, der neben dem FeatureRecipe erfasst ist, und nicht neben dem Recipe der Host-Komponente. Auf den beiden Anbindungsoberflächen nennt die Meldung auch die Anbindung, und das sagt, welches Dokument zu öffnen ist.
Ausgegebene Meldungen:
imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (der Inhalt des importierten Artefakts stimmt nicht mit dem Digest überein, der dafür in entity.lock erfasst ist, mit dem angegebenen Artefakt, der importierten Datei, dem Digest ihres Inhalts und der erfassten Fixierung. Wenn die Datei absichtlich geändert wurde, führen Sie aggrega pin auf der Entität aus, die sie importiert, um ihren neuen Digest zu erfassen; andernfalls stellen Sie die Datei wieder her) imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (der Inhalt des importierten Artefakts stimmt nicht mit dem Digest überein, der dafür in entity.lock erfasst ist, mit dem angegebenen Artefakt, der importierten Datei, dem Digest ihres Inhalts, der erfassten Fixierung und der Anbindung. Wenn die Datei absichtlich geändert wurde, führen Sie aggrega pin auf der Entität aus, die sie importiert, um ihren neuen Digest zu erfassen; andernfalls stellen Sie die Datei wieder her)
So beheben Sie es: Zwei Antworten, und welche richtig ist, hängt davon ab, ob die Änderung beabsichtigt war. Wenn ja, führen Sie aggrega pin auf dem Recipe aus, damit die Fixierung aus den aktuellen Bytes der Datei neu genommen wird, und committen Sie die entity.lock, die es neu schreibt. Wenn nicht, stellen Sie die Datei wieder her — der erfasste Digest ist die Aufzeichnung der Bytes, die fixiert wurden, und ein Build, der die geänderte Datei renderte, würde Inhalt ausliefern, den nichts geprüft hat.
A local source no longer matches the pins recorded beside its Recipe (Eine lokale Quelle stimmt nicht mehr mit den neben ihrem Recipe erfassten Fixierungen überein)
Bei einem Recipe oder FeatureRecipe, dessen source: ein Verzeichnis oder eine Datei daneben benennt, wird diese Quelle fixiert, wenn die Entität fixiert wird — durch aggrega pin oder durch einen Pull oder einen Push, der denselben Schritt ausführen soll. Die entity.lock neben der Entität erfasst einen Digest pro Datei, die die Quelle zu dem beisteuert, was eine Veröffentlichung der Entität mitführt, mit dem Pfad der Datei als Schlüssel. Sobald das Lock sie erfasst, vergleicht jeder Build die Quelle in ihrem aktuellen Zustand mit diesen Fixierungen, bevor der Provider sie liest, und weist eine Abweichung zurück — sodass ein Chart oder ein Modul, das nach dem Fixieren bearbeitet wurde, nie so gerendert wird, als wäre es geprüft worden. aggrega pull --verify führt denselben Vergleich durch und meldet eine Abweichung mit derselben Meldung. Ein Build nennt die Komponenteninstanz, deren Quelle er gerade auflöste, und darunter das Recipe-Dokument.
Die Quelle wird als eine einzige Menge von Dateien verglichen. Eine Datei, deren Inhalt sich geändert hat, eine der Quelle hinzugefügte Datei und eine aus ihr entfernte Datei ändern jeweils, woraus die Entität rendert, daher wird jede gemeldet, mit dem Digest, den die Datei jetzt hat, und dem für sie erfassten Digest. Eine Datei neben der Entität, die die Quelle nicht beisteuert — eine Notiz oder eine README neben dem Recipe —, wird nicht verglichen. Eine als Template geschriebene Quelle, etwa ./charts/{{ .values.flavour }}, steuert jede Datei im Verzeichnis der Entität bei, weil jedes Release entscheidet, welches Verzeichnis sie benennt; bei dieser Form wird eine Bearbeitung jeder Datei im Verzeichnis gemeldet.
Ein Recipe, dessen Lock keine Fixierung für seine Quelle erfasst, hat nichts, was ein Build vergleichen könnte. Ein Build weist es nicht zurück; ein Pull oder ein Push, der nicht fixiert, tut es, wie An entity reads an input the lock beside it records no pin for (Eine Entität liest eine Eingabe, für die das Lock neben ihr keine Fixierung erfasst) beschreibt. Fixierungen, die ein Lock noch für eine lokale Quelle erfasst, die das Recipe nicht mehr deklariert, fixieren nichts, was es liest, und werden daher mit nichts verglichen. Ein Recipe, das ein Pull aus einer Registry aufgelöst hat, ist stattdessen durch den Digest abgedeckt, den das Lockfile für das erfasst, was seine Veröffentlichung mitführt.
Ein Lockfile, das vor der Änderung geschrieben wurde, meldet zuerst. Das Lockfile erfasst die Entität anhand dessen, was sie mitführt, und die Dateien der Quelle gehören dazu, daher bricht ein Build oder aggrega pull --verify mit einem Lockfile, das geschrieben wurde, bevor sich eine Datei geändert hat, ab, bevor dieser Vergleich läuft, wobei The lockfile no longer matches what the release resolves to (Das Lockfile stimmt nicht mehr mit dem überein, worauf das Release aufgelöst wird) die Entität und beide Digests nennt. Ein einfaches aggrega pull nennt die geänderte Datei, mit An entity reads an input the lock beside it records no pin for (Eine Entität liest eine Eingabe, für die das Lock neben ihr keine Fixierung erfasst). Dasselbe gilt für eine importierte Datei. Wo das Lockfile keinen eigenen Eintrag der Entität hat, ist dieser Vergleich derjenige, auf den ein Build und ein prüfender Pull treffen: Ein Recipe oder FeatureRecipe, das das Manifest über eine Referenz benennt, die zugleich der Name einer vom Release erreichten Component oder eines vom Release erreichten Feature ist, wird unter dieser Referenz als Component oder Feature erfasst, sodass sich im Lockfile nichts ändert, wenn sich die Dateien des Recipe ändern.
Ausgegebene Meldungen:
the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (die Dateien der lokalen Quelle der Entität stimmen nicht mit den dafür in entity.lock erfassten Fixierungen überein, mit der angegebenen Datei, ihrem Digest und ihrer erfassten Fixierung. Wenn die Quelle absichtlich geändert wurde, führen Sie aggrega pin auf der Entität aus, um ihre Dateien erneut zu erfassen; andernfalls stellen Sie die Dateien wieder her) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (die Dateien der lokalen Quelle der Entität stimmen nicht mit den dafür in entity.lock erfassten Fixierungen überein, mit der angegebenen Datei und ihrem Digest, für die keine Fixierung erfasst ist. Wenn die Quelle absichtlich geändert wurde, führen Sie aggrega pin auf der Entität aus, um ihre Dateien erneut zu erfassen; andernfalls stellen Sie die Dateien wieder her) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (die Dateien der lokalen Quelle der Entität stimmen nicht mit den dafür in entity.lock erfassten Fixierungen überein, mit der angegebenen Datei, die nicht mehr in der Quelle ist, und ihrer erfassten Fixierung. Wenn die Quelle absichtlich geändert wurde, führen Sie aggrega pin auf der Entität aus, um ihre Dateien erneut zu erfassen; andernfalls stellen Sie die Dateien wieder her)
So beheben Sie es: Wie bei einer importierten Datei gibt es zwei Antworten, und welche richtig ist, hängt davon ab, ob die Änderung beabsichtigt war. Wenn ja, führen Sie aggrega pin auf dem Recipe aus, damit die Dateien seiner Quelle erneut fixiert werden, und committen Sie die entity.lock, die es neu schreibt. Wenn nicht, stellen Sie die Dateien wieder her, die die Meldung nennt.
A symbolic link sits among the files an entity carries (Ein symbolischer Link befindet sich unter den Dateien, die eine Entität mitführt)
Jede Datei, die eine Veröffentlichung einer Entität mitführt, wird aus dem eigenen Verzeichnis der Entität gelesen, und ein symbolischer Link dort wird zurückgewiesen statt verfolgt. Ihm zu folgen, würde die Bytes, auf die er zeigt, unter dem eigenen Namen des Links veröffentlichen — von wo auch immer er hinzeigt, auch außerhalb des Verzeichnisses der Entität — in einem Artefakt, dessen Digest dann berechnet wird und das, wo Signierung gilt, signiert wird. Ihn stattdessen zu überspringen, würde ein Artefakt veröffentlichen, dessen Inhalt stillschweigend von Ihrem Verzeichnis abweicht. Daher wird jede Form von Link auf dieselbe Weise zurückgewiesen: ein Link auf eine Datei, ein Link auf ein Verzeichnis, ein Link, der ins Leere zeigt, ein Link, der auf sich selbst zeigt, und zwei Links, die aufeinander zeigen.
Die Zurückweisung erfolgt überall, wo die Dateien der Entität gelesen werden: durch aggrega pin, durch eine Veröffentlichung, bevor sie irgendetwas packt (einschließlich eines Probelaufs), durch einen Pull und einen prüfenden Pull, die die entity.lock mit den Dateien der Entität abgleichen, durch einen Build, der eine lokale Quelle mit ihren Fixierungen vergleicht, und durch ein Rendern, das ein lokales Quellverzeichnis liest, bevor einem Provider irgendetwas davon übergeben wird. Die Meldung nennt den Link über seinen Pfad neben dem Entitätsdokument, und die Diagnose ist am Link selbst positioniert.
Ein Link, den Ihre Ignorierregeln auslassen, ist keine Datei, die die Entität mitführt, daher wird er wie jede andere Datei übergangen, die diese Regeln auslassen, und nie verfolgt. Diese Regeln sind diejenigen, die in der entity.lock erfasst wurden, als die Entität fixiert wurde, daher wird eine Zeile, die Sie zu .aggregaignore hinzufügen, wirksam, wenn Sie die Entität erneut fixieren.
Ausgegebene Meldung:
a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points (ein symbolischer Link befindet sich unter den Dateien, die eine Entität mitführt, mit dem angegebenen Pfad. Abhilfe: Ersetzen Sie den Link durch eine Kopie dessen, worauf er zeigt, abgelegt im eigenen Verzeichnis der Entität. Ein Link innerhalb eines Quellverzeichnisses kann stattdessen mit einer Zeile in der .aggregaignore neben der Entität ausgelassen werden, die wirksam wird, wenn die Entität erneut fixiert wird. Ein Link wird zurückgewiesen statt verfolgt, weil die Bytes, auf die er zeigt, unter dem Namen des Links reisen würden, von wo auch immer er hinzeigt)
So beheben Sie es: Wenn die Entität braucht, worauf der Link zeigt, ersetzen Sie den Link durch eine Kopie seines Ziels im Verzeichnis der Entität und fixieren Sie die Entität erneut. Wenn der Link nur Ihrer eigenen Bequemlichkeit dient und die Entität ihn nicht liest, fügen Sie seinen Pfad zur .aggregaignore neben dem Entitätsdokument hinzu und fixieren Sie erneut. Welche Dateien mit einer Entität ausgeliefert werden beschreibt die Regeln, die entscheiden, was eine Entität mitführt.
An entity reads an input the lock beside it records no pin for (Eine Entität liest eine Eingabe, für die das Lock neben ihr keine Fixierung erfasst)
Ein Recipe oder FeatureRecipe kann von Bytes außerhalb seines eigenen Dokuments abhängen: einer entfernten source:, deren Koordinaten vollständig ausgeschrieben sind, einer Datei, die ein Eintrag artifacts mit $import importiert, und den Dateien einer source:, die ein Verzeichnis oder eine Datei daneben benennt. Die Fixierung für jede davon wird in der entity.lock neben der Entität erfasst, und sie zu erfassen ist der Schritt des Autors der Entität, aggrega pin. Daher erfasst ein Pull diese Fixierungen nicht von sich aus: Bei einer Entität in einem Ihrer Katalogverzeichnisse, die das Release baut, vergleicht er, was der Schritt erfassen würde, mit dem, was das Lock enthält, und bricht ab, wenn dem Lock eine Fixierung fehlt — oder es eine enthält, der die Eingabe nicht mehr entspricht —, statt ungefragt in das Verzeichnis des Autors zu schreiben. Ein Build, der sein eigenes Lockfile füllt, ist ein Pull und bricht auf dieselbe Weise ab.
Ein Push bricht beim selben Vergleich ab, und zwar für die eine Entität, die er gerade veröffentlichen will. Bevor das Bundle gebaut und bevor irgendeine Registry kontaktiert wird, vergleicht er, was der Schritt für die Entität erfassen würde, mit dem Lock daneben, und weist auf dieselbe Weise zurück — einschließlich eines Probelaufs —, es sei denn, der Push wurde aufgefordert, den Schritt selbst auszuführen. Was die Meldung am Ende vorschlägt, unterscheidet sich zwischen beiden, weil jeder Befehl seine eigenen Wege hat, die Fixierungen erfassen zu lassen; was sie meldet, nicht.
Eine lokale Quelle wird als eine einzige Menge von Dateien an ihren Fixierungen gemessen. Wo das Lock keine davon erfasst, wird hier jede Datei, die die Quelle beisteuert, als fehlend gemeldet. Wo es sie erfasst, wird eine seit der Fixierung hinzugefügte Datei als fehlend gemeldet und eine geänderte oder entfernte Datei als Fixierung, der die Eingabe nicht mehr entspricht, und ein Build meldet dieselbe Änderung als A local source no longer matches the pins recorded beside its Recipe (Eine lokale Quelle stimmt nicht mehr mit den neben ihrem Recipe erfassten Fixierungen überein). Fixierungen, die ein Lock noch für eine lokale Quelle erfasst, die das Recipe nicht mehr deklariert — deren source: entfernt wurde oder jetzt ein entferntes Artefakt benennt —, fixieren nichts, was das Recipe liest, daher halten sie weder einen Pull noch einen Push, einen prüfenden Pull oder einen Build auf; das nächste aggrega pin entfernt sie.
Die Meldung nennt jede fehlende Eingabe, nach Klasse. Jede ist eine remote source, benannt nach ihrer URL und der Version, auf die sie aufgelöst wurde, eine imported file, benannt nach dem Schlüssel artifacts, der sie konsumiert, oder eine local source file, benannt nach ihrem Pfad neben der Entität — so wissen Sie, ob eine Quelle oder eine Datei fixiert werden muss. Jede solche Entität im Release wird in einem Durchlauf gemeldet.
Eine aus einer Registry aufgelöste Entität wird von einem Pull nie daran gemessen, weil ihre Veröffentlichung es bereits wurde. Sie liegt im Inhalts-Cache statt in einem Verzeichnis, das Sie verfassen, daher liest und schreibt ein Pull kein Lock neben ihr, und ihre Quellen werden am Lockfile des Release gemessen. Eine mit aggrega push veröffentlichte Entität wurde bei der Veröffentlichung zurückgewiesen, sofern ihr Lock nicht jede Fixierung erfasste, die der Schritt damals für sie erfasst hätte, und dieses Lock reist innerhalb des veröffentlichten Bundles mit.
Ausgegebene Meldungen, von einem Pull und von einem Push:
an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration (eine Eingabe, die die Entität liest, hat keine dafür erfasste Fixierung in der entity.lock neben ihr, mit dem angegebenen Recipe, einer angegebenen entfernten Quelle mit ihrer Version, für die keine Fixierung erfasst ist, und einer angegebenen importierten Datei, der die erfasste Fixierung nicht mehr entspricht. Abhilfe: Führen Sie aggrega pin auf dem angegebenen Entitätspfad aus und committen Sie die entity.lock, die es neben die Entität schreibt; damit stattdessen jeder Pull in diesem Workspace die Fixierungen selbst erfasst, setzen Sie pin_sources_at_pull: true in der Workspace-Konfiguration) an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration (eine Eingabe, die die Entität liest, hat keine dafür erfasste Fixierung in der entity.lock neben ihr, mit dem angegebenen Recipe und einer angegebenen entfernten Quelle mit ihrer Version, für die keine Fixierung erfasst ist. Abhilfe: Führen Sie aggrega pin auf dem angegebenen Entitätspfad aus und committen Sie die entity.lock, die es neben die Entität schreibt; damit stattdessen diese Veröffentlichung die Fixierungen selbst erfasst, führen Sie sie mit —pin-sources erneut aus; damit jede Veröffentlichung in diesem Workspace sie erfasst, setzen Sie pin_sources_at_push: true in der Workspace-Konfiguration)
Der mittlere Satzteil der Meldung einer Veröffentlichung nennt, was die Oberfläche akzeptiert, von der aus Sie veröffentlicht haben: --pin-sources in einem Terminal, das Feld pinSources beim Daemon und das Argument pin_sources für das Assistenten-Tool.
So beheben Sie es: Wenn die Entität Ihre ist, führen Sie aggrega pin darauf aus, committen Sie die entity.lock, die es schreibt, und führen Sie dann den Pull oder Push erneut aus — oder pushen Sie mit --pin-sources, das den Schritt ausführt, bevor das Bundle gebaut wird. Wenn sie jemand anderem gehört — ein Katalog, den Sie aus einem eigenen Verzeichnis konsumieren —, hat ihr Herausgeber sie noch nicht fixiert; setzen Sie pin_sources_at_pull: true in Ihrer Workspace-Konfiguration, damit jeder Pull die Fixierungen selbst erfasst, oder übergeben Sie --pin-sources an einen einzelnen Pull. aggrega pin beschreibt den Schritt vollständig.
A provides: template could not be evaluated (Ein provides-Template kann nicht ausgewertet werden)
Ein Eintrag provides: ist ein Template, das den Wert erzeugt, den eine andere Komponente über eine Abhängigkeitsverbindung liest. Diese Bedingung meldet ein Eintrag, der nicht ausgewertet werden konnte: ein Template, das sich nicht parsen lässt, eine Funktion, die es aufruft und die diese Oberfläche nicht registriert, eine Referenz, die durch etwas hinabsteigt, das der Render-Kontext nicht geliefert hat, oder ein Lesen mit index eines Schlüssels, den die Map nicht enthält.
Sie unterscheidet sich von den zwei Zurückweisungen, die vor der Auswertung auf demselben Block laufen — einer Referenz auf eine Wurzel außerhalb der in sich geschlossenen Menge und einer Referenz, die die vom Autor geschriebene Reihenfolge des Blocks selbst zurückweist —, beide weiter oben dokumentiert. Jene nennen den Ausdruck, der zu ändern ist; diese trägt, was auch immer die Auswertung selbst gemeldet hat, weshalb der Eintrag daneben genannt wird.
Ausgegebene Meldung, die die Komponenteninstanz, den Eintrag innerhalb des Blocks und das, was die Auswertung gemeldet hat, nennt:
provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (die Auswertung des provides-Templates ist fehlgeschlagen, mit dem angegebenen Knoten, dem angegebenen provides-Schlüssel und dem, was die Auswertung gemeldet hat)
Der Kopf trägt den Code dieser Bedingung, E0056, was auch immer die Auswertung gemeldet hat. Wo die Auswertung bei einer eigenen Abbruchbedingung angehalten hat — ein Lesen mit index eines Schlüssels, den die Map nicht enthält, ist die übliche —, wird diese Bedingung unter dieser gemeldet statt an ihrer Stelle: Unter caused by (2): kommt der Satz dieser Bedingung zuerst und die eigene Meldung der Auswertung als zweite, ihr Satz eingeschlossen. Wer also Codes abgleicht, ordnet jeden fehlgeschlagenen Eintrag provides: dem Code E0056 zu und liest, was die Auswertung scheitern ließ, an der Bedingung darunter ab, deren Satz in der Tabelle aller Bedingungen auf ihren eigenen Code verweist — E0327 für den fehlenden Schlüssel.
So beheben Sie es: Öffnen Sie den Block provides: des Recipe an dem Schlüssel, den die Meldung nennt, und lesen Sie den gemeldeten Grund — er nennt meist eine Parse-Position oder eine Funktion. Die Behandlung fehlender Schlüssel rendert auf dieser Oberfläche einen fehlenden letzten Schlüssel als nichts, statt fehlzuschlagen, daher ist ein Fehlschlag hier ein struktureller Fehler: ein Template, das sich nicht parsen lässt, eine Referenz, die durch einen Container hinabsteigt, der nie geliefert wurde, oder ein Lesen mit index eines Schlüssels, den die Map nicht enthält, was der gemeldete Grund nennt. Wo der Wert wirklich optional ist, lesen Sie ihn über den Helper optional, statt in etwas hinabzusteigen, das möglicherweise nicht da ist.
A Recipe or FeatureRecipe does not publish a provides key its contract declares (Ein Recipe oder FeatureRecipe veröffentlicht keinen provides-Schlüssel, den sein Vertrag deklariert)
Eine Component und ein Feature deklarieren jeweils unter schema.provides die Schlüssel, die alles veröffentlichen wird, was sie bindet — den Ausgabevertrag, gegen den ein Konsument seine Verbindungen schreibt. Das an eine Component gebundene Recipe und das an ein Feature gebundene FeatureRecipe müssen jeden Schlüssel erzeugen, den dieser Vertrag nennt. Eines, das dies nicht tut, wird zurückgewiesen, denn der fehlende Schlüssel würde sonst überhaupt nichts liefern: Der Verweis des Konsumenten käme als nicht gesetzte Variable, als leeres Argument oder als Datei an, die nicht vorhanden ist, ohne dass irgendetwas sagt, warum.
Der Vertrag ist die Anwesenheit der Schlüssel und nichts weiter. Jeder deklarierte Schlüssel muss vorkommen; zusätzliche Schlüssel sind erlaubt. Die Werte selbst werden nie untersucht — sie sind opake Zeiger, die als Zeichenketten durchgereicht werden, sodass die Typen, die ein Vertrag deklariert, eine Aussage an den Konsumenten bleiben und keine Prüfung, die der Build vornimmt.
Jeder Fehlbestand wird gemeldet. Ein Recipe, dem drei Schlüssel fehlen, löst drei Befunde aus, jeder an seinem eigenen Eintrag im Block provides: dieses Recipe positioniert, sodass alle drei aus einem einzigen Build korrigiert werden. Die Meldung nennt den fehlenden Schlüssel, den Typ, dessen Vertrag ihn deklariert, und die Instanz, an die das Recipe gebunden war — Letztere ist das, was zwei Befunde unterscheidet, wenn ein Recipe mehrere Instanzen eines Typs bedient.
Ausgegebene Meldung:
Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>") (das Recipe oder FeatureRecipe veröffentlicht keinen provides-Schlüssel, den der schema.provides-Vertrag seiner abstrakten Entität deklariert (mit dem angegebenen Schlüssel, deklariert vom angegebenen Komponententyp, gebunden an die angegebene Komponenteninstanz))
Die Paarung aus Feature und FeatureRecipe meldet dieselbe Bedingung über die eigene Auflösung der Anbindung und nennt dabei das Paar und den Schlüssel:
Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract) (das Recipe oder FeatureRecipe veröffentlicht keinen provides-Schlüssel, den der schema.provides-Vertrag seiner abstrakten Entität deklariert (mit dem angegebenen Anbindungskontext: das angegebene FeatureRecipe veröffentlicht den angegebenen provides-Schlüssel nicht, den der schema.provides-Vertrag des angegebenen Feature deklariert))
Dort meldet sie den ersten fehlenden Schlüssel in sortierter Reihenfolge und hält an, sodass diese Paarung einen Schlüssel pro Build nennt, während die Component-Paarung alle nennt. Die Schlüssel werden in beiden Fällen in sortierter Reihenfolge durchlaufen, und das macht beide über Läufe hinweg gleich.
So beheben Sie es: Fügen Sie den fehlenden Schlüssel dem Block provides: des Recipe oder FeatureRecipe hinzu, oder entfernen Sie ihn aus dem schema.provides der Component oder des Feature, wo nichts ihn veröffentlichen soll. Ein Schlüssel, dessen Template zu nichts rendert, wird trotzdem veröffentlicht, mit der leeren Zeichenkette als Wert, sodass ein vorhandener und leerer Eintrag den Vertrag erfüllt und hier nichts meldet. Wo ein leerer Wert den Build anhalten muss, weisen Sie ihn in einer Assertion zurück: Die Assertions eines Recipe lesen seine aufgelösten Werte provides:.
An assertion stopped the build (Eine Assertion hat den Build angehalten)
Eine Component, ein Feature, ein Recipe oder ein FeatureRecipe kann assertions: tragen — benannte Templates, deren Zweck es ist, eine Eingabe zurückzuweisen, statt Text zu erzeugen. Eine Assertion ruft fail auf, und dieser Aufruf ist das, was den Build anhält; das Argument ist die Meldung, die ihr Autor für denjenigen geschrieben hat, der auf sie trifft.
Assertions werden an zwei Punkten ausgewertet, sodass eine Regel den Zustand liest, um den es ihr geht: Die auf einer Component oder einem Feature laufen, sobald der Katalog aufgelöst ist und bevor irgendetwas rendert, und die auf einem Recipe oder FeatureRecipe laufen, sobald die Bindung feststeht und bevor diese Bindung rendert.
Ein Verweis auf einen Schlüssel, den nichts liefert, wird ebenfalls hier gemeldet. Die Oberfläche wertet mit strikter Behandlung fehlender Schlüssel aus, gerade damit ein Prädikat, dessen Verweis als leer gerendert wurde, nicht gegen nichts vergleichen und stillschweigend bestehen kann — ein einziger Tippfehler würde sonst die Regel außer Kraft setzen, die die Assertion durchsetzen sollte. Deshalb liefert ein einfaches default auf dieser Oberfläche keinen Fallback: Der bloße Verweis hält die Auswertung an, bevor der Fallback ausgeführt werden kann. Sichern Sie den Verweis mit hasKey ab oder verwenden Sie den Helper optional; auch das Lesen über index bricht ab und nennt den Schlüssel, wie „A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)“ beschreibt.
Ausgegebene Meldung, die die Entitätsart und den Typ, die Instanz und die Assertion nennt und dann die Meldung trägt, die die Assertion selbst geschrieben hat:
<entity-kind>"<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (angegebene Assertion der angegebenen Instanz, des angegebenen Typs und der angegebenen Entitätsart: angegebene Assertion: Template: an der angegebenen Zeile und Spalte: Ausführung der angegebenen Assertion im angegebenen fail-Ausdruck: Fehler beim Aufruf von fail: Assertion fehlgeschlagen: mit der Meldung, die die Assertion geschrieben hat)
und für einen Schlüssel, den nichts liefert, der Satz der Template-Engine nach dem eigenen Satz der Bedingung:
<entity-kind>"<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>" (angegebene Assertion der angegebenen Instanz, des angegebenen Typs und der angegebenen Entitätsart: angegebene Assertion: Assertion fehlgeschlagen: Template: an der angegebenen Zeile und Spalte: Ausführung der angegebenen Assertion am angegebenen Verweis: die Map hat keinen Eintrag für den angegebenen Schlüssel)
und wo statt des Prädikats die Auswertung fehlgeschlagen ist:
<entity-kind>"<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported> (angegebene Assertion der angegebenen Instanz, des angegebenen Typs und der angegebenen Entitätsart: Parsen der angegebenen Assertion: mit dem angegebenen Ergebnis des Parsens)
Ein als sensibel deklarierter Wert erscheint nicht in der Meldung. Wo die Assertion einen solchen Wert liest und fail mit ihrem Satz aufruft, der als eine einzige Zeichenkette in Anführungszeichen ausgeschrieben ist — fail "…", ohne dass etwas hineingeleitet und ohne dass etwas zusammengesetzt wird —, enthält die Meldung diesen Satz so, wie er geschrieben ist, unabhängig davon, was der Wert enthält, weil der Satz nichts zitiert, was die Assertion gelesen hat. Wo ihre Meldung den Wert zitiert, steht in der Meldung <redacted> an der Stelle des Werts. Wo die Meldung auf andere Weise zusammengesetzt ist und das, was die Assertion getan hat, davon abhing, was der Wert enthält, wird die Meldung nach dem fehlschlagenden Ausdruck durch failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds ersetzt; der Abbruch und sein Code bleiben unverändert. Was als deklariert gilt und welche Zurückweisungen außerhalb davon liegen, steht unter vocabulary/compact-form-authoring.md „Was eine Zurückweisung über einen deklarierten Wert sagt“.
Für sich allein geprüft, meldet eine Entität eine fehlgeschlagene Assertion als Warnung.aggrega validate mit der Datei eines Recipe, die Prüfung dieser Datei durch den Editor über aggrega serve und das Werkzeug validate von aggrega mcp mit einer entity bauen das Recipe um Platzhalter und Schema-Standardwerte herum statt um die Werte, die ein Release setzt, sodass sie eine Assertion, die auf ein Release wartet, nicht von einer unterscheiden können, die fehlerhaft ist. Dort wird eine Assertion, die fail aufruft — die eigene des Recipe oder eine, die die von ihm implementierte Component deklariert —, als Warnung gemeldet, die die obige Meldung trägt, abgeschlossen durch den Satz A Release must satisfy this assertion before a build of it can pass., und die Prüfung besteht. Ein Verweis auf einen Schlüssel, den nichts liefert, und eine Assertion, die sich nicht parsen lässt, sind keine fehlgeschlagenen Assertions: Jedes davon ist ein Fehler im eigenen Text der Assertion, und diese Prüfung beurteilt ihn wie jeden anderen Fehler. Ein Build hat immer ein Release und bricht an der Assertion ab, wie hier beschrieben; siehe eine fehlgeschlagene Assertion ist eine Warnung.
So beheben Sie es: Die Meldung nach dem letzten Doppelpunkt stammt vom Autor der Assertion, und sie ist es, die sagt, was zu ändern ist — eine Assertion wird so geschrieben, dass Ihnen das Auftreffen auf sie die Antwort gibt. Wo die Meldung ein fehlender Schlüssel statt des Satzes des Autors ist, liegt der Fehler bei der Assertion selbst: Korrigieren Sie den Verweis, oder sichern Sie ihn ab, wie oben beschrieben. Wo die Regel für dieses Release nicht gelten soll, ist das eine Frage zu der Entität, die die Assertion trägt, und nicht zu Ihrer eigenen Datei.
A pipeline step addresses documents the node does not have (Ein Pipeline-Schritt adressiert Dokumente, die der Knoten nicht hat)
Ein Pipeline-Schritt adressiert ein Dokument über einen Geltungsbereich und einen Schlüssel. Drei Bedingungen decken die Arten ab, auf die eine Adresse nichts erreicht, und jede hält den Build an, statt einen Schritt Erfolg für eine Bearbeitung melden zu lassen, die nie stattgefunden hat.
Der Knoten hat es nicht ausgegeben. Ein Patch nennt ein Paar aus Geltungsbereich und Schlüssel, das nicht zu den Dokumenten gehört, die dieser Knoten erzeugt hat:
node "<instance>": pipeline PATCH targets a document the node did not emit (angegebener Knoten: der Pipeline-PATCH zielt auf ein Dokument, das der Knoten nicht ausgegeben hat)
Es gibt keinen Host zu adressieren. Ein Schritt hat nach den Dokumenten einer Host-Komponente an einer Stelle gegriffen, an der keine steht — die eigene Pipeline einer Komponente, deren einziger Geltungsbereich ihre eigene Ausgabe ist, oder ein Feature, das an eine Boundary statt an eine einzelne Komponente angebunden ist. Der Host-Geltungsbereich ist überall leer, wo eine solche Pipeline läuft, sodass sich eine Adresse darin gegen nichts auflöst:
node "<instance>": pipeline /host operation from a step with no host component (angegebener Knoten: Pipeline-Operation /host aus einem Schritt ohne Host-Komponente)
Das Dokument trägt keinen adressierbaren Baum. Manche Einheiten haben keine Struktur, in die ein Pfad zeigen kann — ein binärer Inhalt, freier Text, ein Bereich, den das Ziel nicht sicher durchlaufen kann. Eine solche Einheit wird dem Schritt trotzdem übergeben, sodass sie ausgewählt und als Ganzes ausgegeben werden kann; was nicht geht, ist, sie zu patchen:
node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (angegebener Knoten: das Ziel des Pipeline-PATCH ist kein parsebares strukturiertes YAML/JSON) pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>") (das Ziel des Pipeline-PATCH ist kein parsebares strukturiertes YAML/JSON (mit dem angegebenen Knoten und Dokument))
Jede kommt mit der eigenen Darstellung der Adresse durch den Durchlauf darunter an, und jede ist an der Komponenteninstanz positioniert, deren Pipeline sie vorgenommen hat.
Zwei der drei werden auch vor jedem Durchlauf gemeldet. Ob eine Stelle überhaupt Host-Dokumente hat, ergibt sich daraus, wo die Pipeline geschrieben wurde, sodass ein Schritt, der deklariert, auf Host-Dokumenten zu operieren, an einer Stelle, die keine hat, benannt wird, sobald der Build weiß, was jedes Plugin deklariert, ohne darauf zu warten, dass ein Knoten rendert — und ein an eine Boundary angebundenes Feature wird neben dem Schritt genannt:
pipeline /host operation from a step with no host component (Pipeline-Operation /host aus einem Schritt ohne Host-Komponente) pipeline /host operation from a step with no host component ("<attachment>") (Pipeline-Operation /host aus einem Schritt ohne Host-Komponente (mit der angegebenen Anbindung))
Die beiden Lesarten sind eine Aufteilung einer einzigen Bedingung und nicht zweimal derselbe Befund: Was eine Deklaration klären kann, wird aus der Deklaration geklärt, und was nur der Lauf sehen kann, bleibt beim Lauf — ein Schritt, der seinen eigenen Geltungsbereich deklariert, kann dennoch eine Operation gegen einen anderen zurückgeben.
Diese drei sind die den Build anhaltende Form der Adressierungs-Zurückweisungen, die der Pipeline-Durchlauf selbst meldet, dokumentiert unter „A pipeline patch addresses a document the set does not hold, or one with no tree to address (Ein Pipeline-Patch adressiert ein Dokument, das die Menge nicht enthält, oder eines ohne adressierbaren Baum)“ weiter oben.
So beheben Sie es: Alle drei liegen beim Autor des Schritts und nicht bei Ihnen. Patchen Sie bei einem fehlenden Ziel ein Dokument, das der Knoten tatsächlich ausgibt, oder geben Sie das gemeinte in einem früheren Schritt aus und patchen Sie es in einem späteren — ein Schritt kann lesen, welche Schlüssel ihm übergeben wurden. Verschieben Sie bei einem fehlenden Host den Schritt an eine Stelle, an der eine Host-Komponente steht, adressieren Sie stattdessen die eigenen Dokumente der Stelle, oder entfernen Sie ihn. Ersetzen Sie bei einer Einheit ohne Baum den Patch durch eine Ausgabe der ganzen Einheit: Ein opaker Inhalt wird ersetzt statt bearbeitet.
A pipeline patch addresses output that has not been assembled yet (Ein Pipeline-Patch adressiert Ausgabe, die noch nicht assembliert wurde)
Manche Provider fassen die knotenweise Ausgabe einer Weiterleitungsgruppe zu einem einzigen Dokument zusammen — einer zusammengeführten Compose-Datei, einem Umbrella-Chart. Bis diese Zusammenführung stattfindet, gibt es keine einzelnen Dokumente, nur Fragmente, sodass ein Patch, der eines adressiert, nichts hat, in das er zeigen kann. Eine Pipeline gegen eine solche Komponente wird daher vollständig zurückgestellt und erneut ausgeführt, sobald die Zusammenführung die Dokumente erzeugt hat; das ist der gewöhnliche Weg und verlangt vom Autor nichts.
Diese Bedingung ist das, was den Build erreicht, wenn ein Patch dennoch bei einem Fragment ankommt. Der Fall, den sie nennt, ist die eigene Ausgabe eines angebundenen Feature. Wo der Provider der Komponente seine Gruppe zusammenfasst, wird die gesamte Pipeline der Anbindung zurückgehalten, bis die Zusammenführung die Dokumente erzeugt hat — und was dieser erneuten Ausführung übergeben wird, sind allein die Dokumente der Komponente. Ein Schritt gegen die eigene Ausgabe des Feature wird nur angeboten, während die Komponente rendert, also bevor irgendeine Zusammenführung stattgefunden hat, sodass er nichts zu adressieren hat. Das gilt unabhängig davon, wie die eigene Ausgabe des Feature weitergegeben wird: Ob sie in die Zusammenführung eingeht oder als eigene Dokumente geschrieben wird, ihr eigener Geltungsbereich ist nie der Geltungsbereich, den die erneute Ausführung trägt.
Das Ausgeben ist nie betroffen. Eine Ausgabe fügt ein Dokument hinzu, statt eines zu bearbeiten, und läuft bei jedem Provider pro Knoten, sodass sie davon gänzlich ausgenommen ist.
Die Bedingung wird vor jedem Durchlauf gemeldet, aus dem, was die Plugins und Provider deklarieren, und erneut als Absicherung, während ein Knoten rendert. Ausgegebene Meldungen:
pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (der Pipeline-PATCH zielt auf die Fragmente eines Assembler-Providers vor der Assemblierung (mit der angegebenen Anbindung)) pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete (der Pipeline-PATCH zielt auf die Fragmente eines Assembler-Providers vor der Assemblierung (angegebener Knoten; das angegebene Dokument im angegebenen Geltungsbereich wird von einem Assembler-Provider gerendert). die Phase nach der Assemblierung führt diesen PATCH erneut aus, sobald die Dokumente einzeln vorliegen)
So beheben Sie es: Adressieren Sie die Dokumente der Komponente statt der eigenen des Feature, was die Form ist, die nach der Zusammenführung erneut ausgeführt wird; oder setzen Sie die Komponente auf einen Provider, der seine Weiterleitungsgruppe nicht zusammenfasst; oder entfernen Sie den Schritt. Welche der drei Möglichkeiten richtig ist, hängt davon ab, was der Schritt ändern sollte, und die Meldung nennt den Geltungsbereich, den er adressiert hat, damit Sie es erkennen können. Die eigene capability: des FeatureRecipe zu ändern, gehört nicht dazu: Es ändert nicht, welcher Geltungsbereich der erneuten Ausführung nach der Zusammenführung übergeben wird, und genau darum geht es bei dieser Bedingung.
A pipeline step’s plugin does not claim the provider rendering what it addresses (Das Plugin eines Pipeline-Schritts beansprucht nicht den Provider, der rendert, was der Schritt adressiert)
Ein Plugin, das ein Pipeline-Schritt verwendet, kann die Provider deklarieren, gegen die es getestet wurde. Diese Liste ist ein expliziter Anspruch und kein impliziter „alles Ähnliche“: Ein Plugin gegen einen Provider auszuführen, den es nicht nennt, riskiert einen Patch, der für eine andere Ausgabeform geschrieben wurde, daher hält der Build an, statt es zu versuchen.
Gegen welchen Provider ein Schritt abgeglichen wird, ist derjenige, der die Dokumente rendert, die dieser Schritt adressiert — der eigene Provider der Komponente für einen Schritt gegen die Dokumente der Komponente und der eigene Provider des Feature für einen Schritt gegen die des Feature. Bei einem an eine Komponente angebundenen Feature treten beide auf, und es sind zwei verschiedene Werte aus zwei verschiedenen Dokumenten.
Eine leere oder fehlende Anspruchsliste passt auf nichts, sodass jeder Schritt, der ein solches Plugin verwendet, hier gemeldet wird. Ein Plugin, das der Build nicht fragen konnte, ist ein anderer Fall und wird hier nicht gemeldet: Eine nicht erhältliche Selbstauskunft ist das Fehlen eines Anspruchs und kein leerer Anspruch, und ein solcher Schritt hält mit dem Fehler beim Auflösen, beim Laden oder bei der Selbstauskunft selbst an, der zu beheben ist.
Die Bedingung wird gemeldet, sobald der Build weiß, was jedes Plugin über sich selbst deklariert, vor dem Lauf, der den Schritt aufrufen würde, und einmal pro verfasstem Schritt statt einmal pro Build — so sieht ein Autor jeden beanstandeten Schritt einer Pipeline aus einem einzigen Build. Provider-Namen werden exakt abgeglichen.
Ausgegebene Meldungen, die erste aus der eigenen Pipeline einer Komponente und die zweite aus der eines Feature, die auch die Anbindung nennt:
pipeline plugin is not compatible with the rendering provider ("<provider>") (das Pipeline-Plugin ist nicht mit dem rendernden Provider kompatibel, dem angegebenen) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (das Pipeline-Plugin ist nicht mit dem rendernden Provider kompatibel (mit der angegebenen Anbindung und dem angegebenen Provider))
So beheben Sie es: Der Befund ist am verfassten Schritt positioniert, und der Provider, den er nennt, ist das, womit die Deklaration in Einklang gebracht werden muss. Wo das Plugin Ihres ist, fügen Sie den Provider der Kompatibilität hinzu, die es deklariert, sobald Sie dagegen getestet haben. Wo nicht, wählen Sie eine Plugin-Version, die den Provider beansprucht, rendern Sie diesen Geltungsbereich über einen Provider, den das Plugin beansprucht, oder entfernen Sie den Schritt.
A provider refused a node’s input (Ein Provider hat die Eingabe eines Knotens abgelehnt)
Ein Provider kann die Eingabe, die ihm für eine Komponente übergeben wird, vor dem Rendern prüfen und melden, was er findet. Befunde mit dem Schweregrad Abbruch halten den Build an; Befunde mit den Schweregraden Warnung und Information werden neben der Ausgabe des Builds angezeigt und ändern nichts an den ausgegebenen Bytes.
Dies ist die eigene Lesart Ihrer Eingabe durch den Provider und nicht die des Compilers, daher entscheidet der Provider, woran er Anstoß nimmt und wie genau er es sagt. Der Compiler nennt die Komponente und den Provider und überbringt die Meldungen des Providers so, wie sie zurückgegeben wurden; wo ein Provider mehrere gemeldet hat, kommen sie zusammen an, durch Semikolons getrennt, sodass ein einziger Build Sie über alle informiert.
Dieselbe Weiterleitung wird verwendet, ob die Eingabe zum eigenen Recipe einer Komponente oder zu einem angebundenen Feature gehört, sodass die Prüfung eines Providers bei beiden identisch lautet.
Ausgegebene Meldung:
provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (der Provider hat die Eingabe des Knotens abgelehnt: mit dem angegebenen Knoten, dem angegebenen Provider und den Meldungen des Providers)
So beheben Sie es: Lesen Sie die Meldungen des Providers — sie nennen, was er in der aufgelösten Eingabe nicht akzeptieren konnte. Die Eingabe wird aus den Werten des Recipe und der eigenen Konfiguration der Komponente zusammengesetzt, daher liegt die Korrektur meist in einem davon; die eigene Referenzseite des Providers sagt, was er verlangt. Wo der Provider etwas beanstandet, das Sie nicht aus einem Dokument heraus ändern können, ist das eine Frage für denjenigen, der das Recipe oder das Plugin verfasst hat.
A provider rendered the same input twice and produced different output (Ein Provider hat dieselbe Eingabe zweimal gerendert und unterschiedliche Ausgaben erzeugt)
Bei identischer Eingabe erzeugt ein Build identische Ausgabe — das ist der Vertrag, an dem Review-Werkzeuge und Bereitstellungswerkzeuge das Ergebnis eines Builds messen. Ein optionaler Build-Modus prüft das direkt: Jede Komponente wird zweimal aus derselben Eingabe gerendert, und die ausgegebenen Bytes werden verglichen. Ein Provider, dessen zwei Renderings voneinander abweichen, trägt Zustand von einem zum anderen oder ist auf andere Weise keine Funktion seiner Eingabe, und der Build hält an.
Der gewöhnliche Build rendert jede Komponente einmal, daher tritt diese Bedingung nur im Prüfmodus auf. An einem normalen Build ändert sich nichts dadurch, dass dieser Modus verfügbar ist.
Verglichen wird die rohe ausgegebene Ausgabe des Providers — dieselben Bytes, aus denen die gerenderten Artefakte herausgeschnitten werden —, sodass ein Unterschied an beliebiger Stelle dessen, was er erzeugt hat, erkannt wird und nicht nur ein Unterschied, der bis in eine endgültige Datei überlebt.
Ausgegebene Meldung:
rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (Rendern des angegebenen Knotens: angegebener Knoten, mit dem angegebenen Provider: zwei Renderings identischer Eingabe haben unterschiedliche Ausgabe erzeugt: das Rendering des Providers ist nicht deterministisch)
So beheben Sie es: Finden Sie zuerst heraus, was sich zwischen zwei Builds der Komponente unterscheidet, die die Meldung nennt — bauen Sie sie zweimal und vergleichen Sie die Ausgaben. Wo der Unterschied ein Wert ist, den ein von Ihnen als Quelle verwendetes Chart bei jedem Rendern neu generiert — ein zufälliges Passwort, ein generierter Schlüssel, ein Zeitstempel in einem Secret oder einer ConfigMap —, liegt der Fehler in der Ausgabe dieses Charts und nicht im Provider, und Sie können ihn auf eine von zwei Arten selbst beheben. Liefern Sie den Wert über die Einstellung, die das Chart dafür anbietet, aus dem valuesMapping: des Recipe, sodass das Chart ihn nicht mehr generiert. Oder, wo das generierte Dokument eines ist, das das Release nicht ausliefern darf — etwa ein Secret, das der Betreiber separat bereitstellt —, lassen Sie es mit einem Eintrag omits: im Recipe aus dem Build weg; siehe Recipe → Das Feld omits:. Andernfalls liegt der Fehler beim Provider und nicht bei Ihren Dokumenten, und nichts, was Sie schreiben können, behebt ihn. Melden Sie ihn demjenigen, der das Plugin veröffentlicht, das diesen Provider bedient, und nennen Sie die Komponente, die die Meldung angibt — die üblichen Ursachen sind ein Zeitstempel, ein Zufallswert oder eine Reihenfolge, die der Iteration einer Map folgt statt der Reihenfolge, die der Autor geschrieben hat. Bis er behoben ist, ist der gewöhnliche Build-Modus nicht betroffen, und das Plugin auf eine Version zu fixieren, die die Prüfung bestanden hat, ist die praktische Antwort.
An omits entry left out nothing the source rendered (Ein omits-Eintrag hat nichts von dem weggelassen, was die Quelle gerendert hat)
Jeder Eintrag der Liste omits: eines Recipe oder eines FeatureRecipe, der für einen Build gilt — sein when: fehlend, leer oder wahr —, muss mindestens eine Sache, die die Quelle gerendert hat, aus der Ausgabe weglassen: ein Dokument, das ein Chart rendert, einen Service, ein Volume oder eine Config, die eine Compose-Datei deklariert, oder eine Ressource, die ein CloudFormation-Template deklariert. Der Provider, der die Quelle rendert, gleicht jeden Eintrag mit dem ab, was er gerendert hat, und meldet, wie viele Einheiten jeder weggelassen hat; ein Eintrag, der keine weggelassen hat, hält den Build an.
Ein Eintrag, der auf nichts passt, ist eine Aussage über die Quelle, die nicht mehr zutrifft. Die übliche Ursache ist ein Upgrade der Quelle, das umbenannt oder entfernt hat, was der Eintrag nennt — und ein umbenanntes Dokument oder ein umbenannter Service steht dann unter seinem neuen Namen in der Ausgabe, was genau das ist, was der Eintrag fernhalten sollte —, und die andere ist ein Fehler im Eintrag selbst. Darüber hinwegzugehen würde ausliefern, was der Eintrag weglassen sollte, daher hält der Build an und nennt den Eintrag.
Die Meldung nennt den Knoten, den Provider, das Dokument, das den Eintrag deklariert, und die Position des Eintrags in der Liste omits: dieses Dokuments, gezählt ab 0, sowie den Kind, den Namen und den Namespace, zu denen der Eintrag aufgelöst wurde, den Namespace nur dort, wo der Eintrag einen nennt. Bei einem an eine Komponente angebundenen FeatureRecipe ist der Knoten diese Komponente; bei einem an eine Boundary angebundenen nennt die Zeile über der Meldung die Anbindung und ihre Boundary. Wo mehrere Einträge auf nichts gepasst haben, wird der erste in der Reihenfolge genannt, in der Sie sie geschrieben haben, sodass bei jedem Lauf derselbe Eintrag genannt wird. Ein Feld, dessen Template einen als sensibel deklarierten Wert gelesen hat, wird als <redacted> angezeigt statt als das, wozu es aufgelöst wurde. Ein Eintrag, den sein when: verworfen hat, wird nie an den Provider übergeben und nie geprüft.
Ausgegebene Meldung. Die Kategorie erreicht Sie im Kopf in eckigen Klammern:
an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause (ein omits-Eintrag hat nichts von dem weggelassen, was die Quelle gerendert hat (mit dem angegebenen Knoten, Provider, der Position in der omits-Liste des angegebenen Dokuments sowie dem angegebenen Kind, Namen und Namespace). korrigieren Sie den Eintrag, sodass er etwas nennt, das die Quelle rendert, oder entfernen Sie ihn; die übliche Ursache ist ein Upgrade der Quelle, das das Genannte umbenannt oder entfernt hat)
Der Kopf trägt den Kurzcode dieser Bedingung, E0334.
So beheben Sie es: Vergleichen Sie den Eintrag mit dem, was die Quelle jetzt rendert — bauen Sie mit entferntem Eintrag und lesen Sie, was die Komponente rendert —, korrigieren Sie dann Kind, Namen oder Namespace des Eintrags, oder entfernen Sie den Eintrag, wo das, was er nannte, nicht mehr existiert. Bei einem Chart benennt ein Eintrag ein Dokument über den eigenen kind und metadata.name des Dokuments und, sofern der Eintrag einen Namespace nennt, den Namespace, in dem sich das Dokument befindet; bei einer Compose-Datei benennt er einen service, ein volume oder eine config über den jeweiligen Schlüssel; bei einem CloudFormation-Template benennt er eine Ressource über ihren Type und ihre logische ID, in jedem der Templates der Quelle. Siehe Recipe → Das Feld omits:.
A provider’s omitted counts do not match the omits entries it was handed (Die Auslassungszahlen eines Providers stimmen nicht mit den omits-Einträgen überein, die ihm übergeben wurden)
Ein Provider, der deklariert, dass er gerenderte Einheiten weglässt, meldet für jeden ihm übergebenen Eintrag omits:, auf wie viele Einheiten dieser Eintrag gepasst hat — eine Zahl pro Eintrag, in der Reihenfolge, in der die Einträge übergeben wurden. Eine Meldung, die fehlt, zu wenige oder zu viele Zahlen enthält oder eine Zahl unter null enthält, lässt keine Möglichkeit zu erkennen, ob ein Eintrag überhaupt etwas weggelassen hat, daher hält der Build an. Nichts, was Sie geschrieben haben, verursacht dies: Es meldet einen Provider, dessen zurückgegebene Ausgabe den Vertrag nicht einhält, den er deklariert.
Ausgegebene Meldung. Die Meldung nennt den Knoten und den Provider, dann, wie viele Einträge übergeben wurden und was zurückkam — entweder wie viele Zahlen oder die Zahl unter null und den Eintrag, für den sie angegeben wurde:
a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts) (die Auslassungszahlen eines Providers stimmen nicht mit den omits-Einträgen überein, die ihm übergeben wurden (mit dem angegebenen Knoten und Provider, der angegebenen Anzahl übergebener omits-Einträge und der angegebenen Anzahl zurückgegebener Auslassungszahlen))
Der Kopf trägt den Kurzcode dieser Bedingung, E0336.
So beheben Sie es: Melden Sie es demjenigen, der das Plugin veröffentlicht, das diesen Provider bedient, und nennen Sie die Komponente, die die Meldung angibt. Was ein Provider schuldet, ist im Plugin-Vertrag unter Gerenderte Einheiten weglassen dargelegt.
Assembled output still carries a cross-boundary placeholder (Die assemblierte Ausgabe trägt noch einen Boundary-übergreifenden Platzhalter)
Wo eine Abhängigkeitsverbindung zwischen zwei assemblierten Ausgaben verläuft, kann der Wert, den sie trägt, nicht bekannt sein, während die konsumierende Seite gerendert wird — er wird von der anderen Seite veröffentlicht und aufgelöst, sobald beide assembliert wurden. Daher schreibt der Build einen Platzhalter in die Eingabe der konsumierenden Komponente, und der Provider ersetzt ihn durch seine eigene Form von Querverweis, sobald die Assemblierung existiert.
Diese Bedingung ist das, was ein Platzhalter meldet, der diese Ersetzung überlebt hat. Überleben bedeutet, dass die Auflösung ihn nie erreicht hat: Der Wert ist an einer Stelle gelandet, die der Provider nicht adressieren konnte — meistens in eine längere Zeichenkette eingefügt, statt als ganzer Wert dazustehen —, oder eine Überquerung wurde markiert, ohne dass auf der anderen Seite etwas da war, das sie auflöst. Ein Platzhalter ist nie gültige Ausgabe, daher hält der Build an, statt eine Datei auszuliefern, die einen enthält.
Die Meldung nennt den Provider, der die Datei geschrieben hat, und den Pfad, unter dem die Datei steht: Ein Pfad ist nur innerhalb einer Assemblierung eindeutig, daher identifizieren erst beide zusammen eine Datei. Jede beanstandete Datei wird gemeldet, nicht nur die erste, und jede wird einmal gemeldet, wie viele Boundaries auch immer die Assemblierung gespeist haben, in der sie steht. Sie wird gegen das Release-Dokument als Ganzes gemeldet statt gegen eine Boundary darin — der Fehler liegt darin, wie ein Wert die Datei erreicht hat, und nicht in einer Boundary-Deklaration, daher ist keine Boundary-Deklaration das, was zu ändern ist.
Ausgegebene Meldung:
assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (die assemblierte Ausgabe enthält noch einen nicht aufgelösten Platzhalter für eine Boundary-übergreifende Verknüpfung (mit dem angegebenen Provider und Ausgabepfad))
So beheben Sie es: Die häufigste Ursache ist ein Wert, den die konsumierende Seite in eine längere Zeichenkette interpoliert hat. Ein Querverweis muss den ganzen Wert bilden, als der er injiziert wird, ändern Sie also das Mapping des Recipe so, dass es ihn ganz liefert, und bauen Sie stattdessen im eigenen Vokabular des Ziels um ihn herum auf. Wo der Wert ganz dasteht und der Platzhalter trotzdem überlebt, liegt der Fehler auf der Seite des Providers bei der Auflösung und gehört zu demjenigen, der dieses Plugin veröffentlicht.
A template did more than copy a value it read off a cross-boundary link (Ein Template hat mehr getan, als einen Wert zu kopieren, den es von einer Boundary-übergreifenden Verknüpfung gelesen hat)
Ein Template kann die Werte eines Produzenten direkt von einer Verbindung lesen, unter .context.uses.<alias>.provides — oder, in einem FeatureRecipe mit Boundary-Geltungsbereich, von den Verbindungen der Boundary unter .boundary. Wo die Verbindung zwei Komponenten verbindet, die in unterschiedliche Ausgaben rendern, und der Provider sie mit einer eigenen Referenz verdrahtet, erreicht jeder dieser Werte das Template als Platzhalter, den der Provider ersetzt, sobald beide Ausgaben assembliert sind: durch eine stackübergreifende Referenz oder durch den Wert selbst. Daher darf ein Template einen solchen Wert nur kopieren — ihn ganz schreiben, innerhalb einer längeren Zeichenkette oder über eine Funktion, die ihn unverändert lässt, wie quote.
Ein Vergleich, eine Verzweigung, eine Länge oder eine Funktion, die den Wert ändert — eq, if, len, upper, trimPrefix —, würde stillschweigend anhand des Platzhalters statt des Werts entschieden. Der Build prüft das, indem er das Template zweimal auswertet, einmal über den Platzhaltern und einmal über den echten Werten, und bricht ab, wo die beiden voneinander abweichen, sobald jeder Platzhalter zurückgeschrieben ist. Das gilt für jedes Template, das eine solche Verbindung liest: die eigenen Templates eines Recipe, das injectMapping: eines angebundenen FeatureRecipe und die Templates eines FeatureRecipe mit Boundary-Geltungsbereich.
Die Meldung nennt das Template — das Feld und das Recipe, zu dem es gehört — und für jeden provides-Wert, an dem der Unterschied hängt, die konsumierende Komponente, Alias und Socket der Verbindung sowie die produzierende Komponente. Ein Wert, den das Template nur kopiert hat, wird nicht genannt.
Ausgegebene Meldung:
a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead (ein Template tut mehr, als einen Wert zu kopieren, den es von einer Boundary-übergreifenden Verknüpfung liest (mit dem angegebenen Template und dem angegebenen provides-Schlüssel, den die angegebene konsumierende Komponente von ihrer angegebenen Verbindung am angegebenen Socket zur angegebenen produzierenden Komponente liest). Kopieren Sie den Wert so, wie er dasteht, ganz oder innerhalb einer längeren Zeichenkette, denn der Provider schreibt an seine Stelle, was der Wert in der anderen Ausgabe wird, und verzweigen Sie stattdessen anhand eines eigenen Werts der Komponente)
So beheben Sie es: Kopieren Sie den Wert, den die Meldung nennt, statt ihn zu prüfen oder umzuwandeln, und stützen Sie die Entscheidung auf einen Wert, den die konsumierende Komponente selbst verfasst — einen ihrer eigenen Schlüssel values oder infra —, statt auf das, was ihre Verbindung liest. Der CloudFormation-Provider beschreibt, was ein kopierter Wert im anderen Stack wird.
A provider named a directory for a contributor that is not one directory (Ein Provider hat für einen Beitragenden ein Verzeichnis benannt, das kein einzelnes Verzeichnis ist)
Ein Provider, der jeden Beitragenden unter seiner eigenen Position innerhalb einer umschließenden Ausgabe platziert, deklariert das Verzeichnis, unter dem diese Positionen liegen, und der Build setzt die Identität jeder Komponente darin zusammen. Der Wert muss genau ein Verzeichnis benennen: Ein Wert, der ein Pfadtrennzeichen enthält oder das aktuelle oder das übergeordnete Verzeichnis benennt, würde die Dateien einer Komponente an einer anderen Stelle als unter ihrer eigenen Position platzieren — entweder ganz außerhalb der Assemblierung oder stillschweigend darin umgeordnet.
Der Build hält an, statt einen solchen Pfad zusammenzusetzen. Die Meldung nennt den Provider, der den Wert deklariert hat, und den Wert selbst, sodass klar ist, welcher Provider zu ändern ist und was er deklariert hat.
Ein Provider, der kein solches Verzeichnis deklariert, ist nicht betroffen. Jeder Beitragende liegt dann direkt im Bereitstellungsverzeichnis unter seinem eigenen Namen, sodass der Verzicht darauf, ein umschließendes Verzeichnis zu benennen, eine legitime Antwort und kein Versäumnis ist.
Ausgegebene Meldung:
provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory (der Provider hat für das eigene Unterverzeichnis jedes Beitragenden ein Verzeichnis benannt, das kein einzelner Verzeichnisname ist: der angegebene Provider hat nest_segment mit dem angegebenen Wert deklariert; der Wert muss ein einziges Verzeichnis benennen, ohne Pfadtrennzeichen und ohne das aktuelle oder das übergeordnete Verzeichnis zu benennen)
So beheben Sie es: Nichts in irgendeinem Katalogdokument erzeugt diesen Wert, daher gibt es in Ihren eigenen Dateien nichts zu korrigieren — er stammt aus dem Plugin, das den Provider bedient. Melden Sie ihn demjenigen, der dieses Plugin veröffentlicht, und zitieren Sie den Wert, den die Meldung nennt. Wo das Plugin Ihres ist, deklarieren Sie einen einzelnen Verzeichnisnamen, oder deklarieren Sie keinen und lassen Sie jeden Beitragenden im Bereitstellungsverzeichnis liegen.
A boundary-scope Feature is attached only to a component (Ein Feature mit Boundary-Geltungsbereich ist nur an eine Komponente angebunden)
Ein FeatureRecipe kann deklarieren, dass es einmal für eine Boundary statt einmal für jede Komponente generiert — eine gemeinsame Ressource für alles, was die Boundary enthält, statt einer pro Komponente. Die Boundary ist daher der Ort, an dem eine solche Anbindung geschrieben werden muss: Eine Anbindung dieses Namens, die nur an einer Komponente geschrieben ist, nennt keinen Geltungsbereich, für den das Rezept generieren könnte, sodass nichts entscheidet, an welcher Boundary es laufen würde, welche Werte es lesen würde oder wohin seine Ausgabe geschrieben würde.
Sie zusätzlich an einer Komponente zu schreiben, ist üblich und wird nicht gemeldet. Eine an einer Boundary deklarierte Anbindung erreicht jede Komponente, die diese Boundary enthält, einschließlich derer in darin verschachtelten Geltungsbereichen, daher ist es die normale Form, sie zu tragen. Geprüft wird, ob der eigene Geltungsbereich der Komponente oder einer, der ihn umschließt, den Namen deklariert — die Suche geht von der Stelle, an der die Komponente sitzt, nach außen und hält am ersten Geltungsbereich an, der ihn deklariert. Eine Komponente, die an sich selbst eine Anbindung wiederholt, die ihr umschließender Geltungsbereich bereits deklariert, rendert genau wie die nur am Geltungsbereich deklarierte Form und wird aus demselben Grund zugelassen.
Eine Komponente, die in keinem Geltungsbereich platziert ist, hat nichts zu durchlaufen, daher wird eine Anbindung mit Boundary-Geltungsbereich an ihr hier gemeldet — was die ehrliche Lesart ist, da es keinen Geltungsbereich gibt, für den ein solches Rezept generieren könnte.
Ausgegebene Meldung, die die Anbindung und den Geltungsbereich nennt, in dem die Komponente sitzt:
attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (die Anbindung bindet ein FeatureRecipe mit executionScope: boundary, und keine Boundary, die die Komponente enthält, deklariert sie (mit der angegebenen Anbindung, an einer Komponente in der angegebenen Boundary))
und für eine Komponente in keinem Geltungsbereich, die keinen solchen Wert beiträgt:
attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (die Anbindung bindet ein FeatureRecipe mit executionScope: boundary, und keine Boundary, die die Komponente enthält, deklariert sie (mit der angegebenen Anbindung))
So beheben Sie es: Deklarieren Sie die Anbindung unter features: an der Boundary, für die sie generieren soll — dem Geltungsbereich, in dem die Komponente sitzt, oder einem, der ihn umschließt —, statt nur an der Komponente. Wo Sie eine Generierung pro Komponente gemeint haben, binden Sie stattdessen ein Feature an, dessen FeatureRecipe den Boundary-Geltungsbereich nicht deklariert.
The sandbox refused a plugin (Die Sandbox hat ein Plugin zurückgewiesen)
Jedes Plugin meldet, was es ist und was es braucht, bevor es irgendeine Arbeit verrichten darf, und die Sandbox gleicht diese Meldung mit dem ab, was sie zu gewähren bereit ist. Diese Bedingung deckt die gesamte Klasse von Meldungen ab, die die Sandbox nicht akzeptiert, und der Satz sagt, welcher Teil davon zurückgewiesen wurde: eine Version der Plugin-Schnittstelle, die der Host nicht spricht, eine Art von Plugin, für die der Host kein Vokabular hat, ein Plugin, das ausgehenden Netzwerkzugriff oder Dateisystemzugriff verlangt, ein Plugin, das einen Host-Aufruf außerhalb der Menge nennt, die der Host anbietet, oder aus einem Namespace außerhalb der Menge importiert, die er zulässt, ein fehlender oder falsch geformter Export, ein Feld, das einen Wert außerhalb der Menge trägt, auf die es beschränkt ist, oder eine Selbstauskunft, die überhaupt nicht lesbar ist.
Die Zurückweisung geschieht, bevor das Plugin läuft, und ein zurückgewiesenes Plugin wird beendet, bevor sich der Fehlschlag fortpflanzt, sodass nichts, was es verlangt hat, auch nur kurz gewährt wird.
Manches, was ein Plugin nicht haben kann, wird hier nicht geprüft, weil es nie gewährt wird. Der Host gibt einem Gast eine eingefrorene Uhr, kein Dateisystem, keine Umgebung und keinen Ort, an den seine eigene Ausgabe gehen könnte, sodass ein Gast, der eines davon zu erreichen versucht, beim Versuch fehlschlägt, statt vorab zurückgewiesen zu werden. Was diese Bedingung abdeckt, ist die Meldung, die das Plugin über sich selbst macht, geprüft, bevor es startet.
Ausgegebene Meldungen. Der Satz der Bedingung schließt jede ab, und was ihm vorangeht, nennt das Plugin und den Teil seiner Meldung, der zurückgewiesen wurde. Eine Schnittstellenversion, die der Host nicht spricht:
plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (das angegebene Plugin deklariert die angegebene abi_version; der Host spricht die angegebene unterstützte Version: wasm: Plugin von der Sandbox zurückgewiesen)
eine Art von Plugin, für die der Host kein Vokabular hat:
plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (das angegebene Plugin deklariert einen unbekannten plugin_type, den angegebenen: wasm: Plugin von der Sandbox zurückgewiesen)
eine Selbstauskunft, die nicht gelesen werden kann:
wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: die Ausgabe von describe() des angegebenen Plugins ist kein gültiges JSON: mit dem angegebenen Ergebnis des Lesens: wasm: Plugin von der Sandbox zurückgewiesen)
ein Plugin, dem der Export fehlt, den seine Art verlangt, benannt aus derselben Registry, aus der auch die Art selbst gelesen wird:
<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (das angegebene Plugin der angegebenen Art deklariert den angegebenen Export nicht: wasm: Plugin von der Sandbox zurückgewiesen)
ein Feld, das auf eine feste Menge beschränkt ist und etwas anderes trägt — dieselbe Form deckt den Assemblierungsmodus sowie die Felder operates und scope jedes Exports ab:
plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (der angegebene Export des angegebenen Plugins deklariert einen unbekannten Geltungsbereich, den angegebenen (erwartet wird einer der angegebenen Werte oder leer): wasm: Plugin von der Sandbox zurückgewiesen)
eine gepaarte Fähigkeit, die ohne ihre beiden Exporte deklariert ist, oder die Exporte ohne den Anspruch:
plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (das angegebene Plugin deklariert die Fähigkeit zur Boundary-übergreifenden Verknüpfung, exportiert aber nicht beide angegebenen Exporte: wasm: Plugin von der Sandbox zurückgewiesen)
ein Fähigkeitsname, den ein Recipe nie auswählen könnte — ein Provider, der einen Namen mit einem Doppelpunkt bedient, oder ein damit kompatibler Pipeline-Schritt —, weil das capability: eines Recipe als der Name bis zu seinem letzten Doppelpunkt und eine Versionsfixierung danach gelesen wird. Das parse:<format> eines Parsers und das import:<format> eines Importers werden nicht zurückgewiesen: Der Doppelpunkt ist Teil dieser Namen, und sie werden nach Format statt über ein Recipe nachgeschlagen. Dieselbe Zurückweisung verhindert, dass die Entität eines solchen Plugins für die Veröffentlichung generiert wird:
plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox (das angegebene Plugin (mit dem angegebenen plugin_type) bedient die angegebene Fähigkeit, die einen Doppelpunkt enthält; der Fähigkeitsverweis eines Recipe wird als die Fähigkeit bis zu ihrem letzten Doppelpunkt und eine Versionsfixierung danach gelesen, sodass kein Recipe diese Fähigkeit nennen kann: melden Sie den Fähigkeitsnamen ohne Doppelpunkt: wasm: Plugin von der Sandbox zurückgewiesen)
und die Host-Aufrufe, die ein Plugin beansprucht, gegenüber denen, die sein Binary tatsächlich verwendet, was in beide Richtungen geprüft wird, sodass ein Plugin weder eine Oberfläche ankündigen kann, die es nicht verwendet, noch eine verbergen kann, die es verwendet:
plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (das angegebene Plugin deklariert in describe() die angegebene Host-Funktion, die sein wasm nicht importiert: wasm: Plugin von der Sandbox zurückgewiesen) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (das angegebene Plugin importiert die angegebene Host-Funktion, die sein describe() nicht deklariert: wasm: Plugin von der Sandbox zurückgewiesen)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und keine Änderung beim Verfassen beseitigt es — die zurückgewiesene Meldung ist die eigene des Plugins. Wo Sie ein veröffentlichtes Plugin verwenden, leiten Sie die Meldung an denjenigen weiter, der es veröffentlicht, und wählen Sie in der Zwischenzeit eine Version, die der Host akzeptiert. Wo das Plugin Ihres ist, nennt die Meldung das Feld und beide Werte, sodass die Korrektur die ist, auf die der Satz zeigt: Sprechen Sie die Schnittstellenversion, die der Host spricht, deklarieren Sie eine Art, die er kennt, halten Sie jedes Feld innerhalb der Menge, auf die es beschränkt ist, deklarieren Sie den Export, den Ihre Art verlangt, und deklarieren Sie genau die Host-Aufrufe, die Ihr Binary verwendet — nicht mehr und nicht weniger.
A plugin is not the kind of plugin the socket expects (Ein Plugin ist nicht die Art von Plugin, die der Socket erwartet)
Jeder Anbindungspunkt gibt an, an welche Art von Plugin er weiterleitet, und jedes Plugin meldet seine eigene Art. Diese Bedingung meldet eine Unstimmigkeit zwischen beiden: ein Plugin, das einen Provider bedient, angebunden, wo ein Linter erwartet wird, ein Parser angebunden, wo ein Importer erwartet wird, ein Plugin, das kein Terminalbefehl ist, als solcher ausgeführt. Die Prüfung findet beim Laden des Plugins statt, sodass ein Plugin der falschen Art nie die Arbeit erreicht, um die es gebeten worden wäre.
Der Grund, warum sie anhält, statt es trotzdem zu versuchen, ist, dass die Arten keine Schnittstelle teilen. Ein Plugin einer anderen Art würde über Exporte aufgerufen, die es nicht hat, und was zurückkäme, würde gegen eine Gestalt gelesen, die es nie erzeugt hat.
Das Lesen der Selbstauskunft eines Plugins, ohne eine Art vorauszusetzen, ist nicht betroffen. Eine Oberfläche, die nur wissen will, was ein Plugin über sich selbst sagt — das Auflisten dessen, was konfiguriert ist, das Generieren einer Entität für ein Plugin —, äußert keine Erwartung, und diese Prüfung wird dort übersprungen.
Ausgegebene Meldung, die das Plugin und beide Arten nennt, wobei die erwartete Art sowohl in Worten als auch mit ihrem deklarierten Wert angegeben ist:
wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe() (wasm: das angegebene Plugin: erwartet wurde ein Plugin der in Worten angegebenen Art (mit dem angegebenen erwarteten Plugin-Typ), aber sein describe() meldet den angegebenen Plugin-Typ: wasm: der deklarierte Plugin-Typ stimmt nicht mit dem describe() des Plugins überein)
So beheben Sie es: Binden Sie ein Plugin der Art an, die der Anbindungspunkt annimmt — die Meldung nennt die erwartete Art. Wo das Plugin das gemeinte ist, sitzt die Anbindung an der falschen Stelle: Verschieben Sie sie an die Oberfläche, zu der seine Art gehört. Wo Sie das Plugin selbst verfassen und es die erwartete Art sein sollte, meldet es über sich selbst die falsche, und das ist eine Korrektur im Plugin statt in der Konfiguration, die es anbindet.
A plugin failed while it was running (Ein Plugin ist während der Ausführung fehlgeschlagen)
Ein Plugin, das um etwas gebeten wurde, ist nicht mit einem Ergebnis zurückgekommen. Drei Bedingungen decken dies ab, und was sie unterscheidet, ist nur, wie sich der Fehlschlag fortgepflanzt hat — ein Plugin, das abgestürzt ist, ein Plugin, das seine eigene Ausführung beendet hat, und ein Plugin, das bis zum Ende lief und meldete, dass es nicht tun konnte, worum es gebeten wurde. Sie bilden bewusst eine einzige Taxonomie, damit ein Build jede Art, auf die ein Plugin fehlschlagen kann, gleich behandelt.
Ein Plugin, das abgestürzt ist. Die meisten Fehler innerhalb eines Plugins — eine unerreichbare Anweisung, eine Division durch null, ein Lesezugriff außerhalb seines Speichers — werden auf dem Weg nach außen in gewöhnliche Fehlschläge umgewandelt und erreichen diese Bedingung nie. Sie ist das Netz hinter diesem Pfad, für einen Absturz, der ihm entkommt.
Ein Plugin, das seine eigene Ausführung beendet hat. Ein Plugin, das sich beenden will, tut etwas, wofür das Plugin-Modell keine Verwendung hat: Ein Plugin gibt sein Ergebnis über den Aufruf zurück, mit dem es aufgerufen wurde, nicht durch Beenden. Seine eigene Ausführung endet; der Build-Prozess bleibt unberührt.
Ein Plugin, das einen Fehlschlag gemeldet hat. Die Ergebnishülle, die ein Plugin zurückgibt, hat einen Platz, an dem es sagen kann, dass es nicht abschließen konnte, und eine Meldung, die das sagt, wird als Fehlschlag weitergereicht, statt als Ergebnis gelesen zu werden.
Ausgegebene Meldungen, die jeweils das Plugin oder den Export nennen und tragen, was auch immer der Fehlschlag geliefert hat. Ein Absturz trägt den wiederhergestellten Wert:
wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: das angegebene Gast-Plugin ist im angegebenen Export in Panik geraten: mit dem angegebenen wiederhergestellten Wert: wasm: Gast-Plugin ist während des Aufrufs in Panik geraten)
ein Plugin, das sich selbst beendet hat, trägt den Code, mit dem es sich beendet hat:
wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: der Aufruf des angegebenen Plugins an den angegebenen Export hat proc_exit mit dem angegebenen Code aufgerufen: wasm: Plugin hat proc_exit aufgerufen)
und ein gemeldeter Fehlschlag trägt die eigene Meldung des Plugins:
call "<export>": wasm: guest plugin reported an error: <the plugin's message> (Aufruf des angegebenen Exports: wasm: Gast-Plugin hat einen Fehler gemeldet: mit der angegebenen Meldung des Plugins)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht eine der drei, und keine Änderung beim Verfassen beseitigt sie — jede ist ein Fehler innerhalb des Plugins. Leiten Sie die Meldung an denjenigen weiter, der es veröffentlicht, und nennen Sie dabei den Export, den sie angibt, und fixieren Sie das Plugin auf eine Version, die funktioniert hat, solange es korrigiert wird. Wo das Plugin Ihres ist: Geben Sie einen Fehlschlag in der Ergebnishülle zurück, statt abzustürzen oder sich zu beenden, damit der Build eine Meldung erhält, die er anzeigen kann; und wo der gemeldete Fehlschlag die wohlüberlegte Antwort des Plugins selbst ist, ist seine Meldung das, was ein Leser sehen wird, daher lohnt es sich zu sagen, was an der Eingabe es nicht akzeptieren konnte.
A plugin returned something that is not the shape the socket reads (Ein Plugin hat etwas zurückgegeben, das nicht die Gestalt hat, die der Socket liest)
Jeder Anbindungspunkt liest das Ergebnis, das er zurückerhält, gegen die Gestalt, die er erwartet, und weist alles andere zurück — ein Feld, das die Gestalt nicht deklariert, ein Feld, dessen Wert nicht den dafür deklarierten Typ hat, oder Bytes, die überhaupt kein wohlgeformtes Ergebnis sind.
Er weist zurück, statt zu lesen, was er kann, und der Grund ist, dass das Lesen dessen, was er kann, stillschweigend geschähe. Welchen Export eine Anbindung aufruft, kann pro Anbindung gewählt werden, sodass eine Anbindung einen Export nennen kann, dessen Ergebnis eine völlig andere Gestalt hat. Das Überspringen der Teile, die nicht passen, ergibt ein leeres Ergebnis — und ein leeres Ergebnis ist selbst eine legitime Antwort: kein Urteil zurückgegeben, kein Befund erhoben. Beides wäre dann nicht zu unterscheiden, und ein Build würde genau so weiterlaufen, als hätte das Plugin ihn gebilligt.
Ausgegebene Meldung, die den Export nennt, von dem das Ergebnis zurückkam, und den Grund trägt, warum das Lesen fehlgeschlagen ist — zusammen identifizieren sie den Export, den die Anbindung hätte nennen sollen:
call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (Aufruf des angegebenen Exports: wasm: Gast-Plugin hat eine Ausgabe zurückgegeben, die nicht die Gestalt hat, die der Socket liest: mit dem angegebenen nicht lesbaren Teil)
So beheben Sie es: Prüfen Sie die Einstiegsfunktion, die die Anbindung nennt, gegen die Exporte, die das Plugin deklariert — eine auf den falschen Export gerichtete Anbindung ist die häufige Ursache, und der Grund in der Meldung nennt das Feld, das nicht dazugehört. Wo der Export der richtige ist, gibt das Plugin eine Gestalt zurück, die der Anbindungspunkt nicht liest, was eine Korrektur im Plugin ist; melden Sie es demjenigen, der es veröffentlicht, und zitieren Sie dabei sowohl den Export als auch den Grund.
A plugin returned a diagnostic at a severity that is not declared (Ein Plugin hat eine Diagnose mit einem nicht deklarierten Schweregrad zurückgegeben)
Ein Plugin kann neben seinem Ergebnis Beobachtungen zurückgeben, und jede trägt einen Schweregrad aus einer geschlossenen Menge: einen, der den Build anhält und nennt, was zu beheben ist, einen, der neben einem Build angezeigt wird, der dennoch abgeschlossen wird, und einen, der die Beobachtung erfasst und nichts ändert. Ein Schweregrad außerhalb dieser Menge ist einer, für den der Host keinen Weg hat, und der Build hält an.
Er weist zurück, statt einen Weg zu wählen, und beide Alternativen sind schlechter. Eine Beobachtung zu übergehen, die er nicht weiterleiten kann, hieße, sie so zu behandeln, als gäbe es nichts zu tun — was, wo das Plugin entscheidet, ob es den Build akzeptiert, als Billigung gelesen wird: Ein Einwand, den das Plugin erhoben hat, würde den Build durchlassen, ohne je angezeigt zu werden. Sie als den anhaltenden Schweregrad zu behandeln, würde einen Build wegen eines Werts ablehnen, den niemand gewählt hat. Beides geschieht stillschweigend, daher sagt der Host, dass der Wert falsch ist, und stattdessen wird das Plugin korrigiert.
Die Prüfung läuft einmal, dort, wo das Ergebnis gelesen wird, statt an jeder Stelle, an der eine Beobachtung später angezeigt wird — was auch der einzige Punkt ist, an dem die Identität des Plugins noch zur Hand ist, da eine Beobachtung, die in eine Meldung eingeflossen ist, nicht mehr weiß, welches Plugin sie erhoben hat.
Ausgegebene Meldung, die das Plugin, den Export, die fehlerhafte Beobachtung, ihren Wert und die deklarierten Werte nennt:
plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info" (Aufruf des angegebenen Exports des angegebenen Plugins: wasm: Gast-Plugin hat eine Diagnose zurückgegeben, deren Schweregrad der Vertrag nicht deklariert: die Diagnose mit dem angegebenen Index hat den angegebenen Schweregrad; die deklarierten Schweregrade sind die drei angegebenen)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — der Wert kam vom Plugin. Melden Sie ihn demjenigen, der das Plugin veröffentlicht, und zitieren Sie dabei den Wert, den die Meldung nennt. Wo das Plugin Ihres ist, geben Sie einen der drei deklarierten Schweregrade aus; die Meldung nennt sie, und der Index sagt Ihnen, welche Beobachtung Sie sich ansehen müssen.
A provider returned two output files under one path (Ein Provider hat zwei Ausgabedateien unter einem Pfad zurückgegeben)
Ein Provider gibt seine Ausgabe als Liste von Dateien zurück, von denen jede den Pfad nennt, unter dem sie geschrieben wird. Der Host sammelt sie nach Pfad geschlüsselt und schreibt die Bytes jeder Datei unverändert, ohne einen eigenen Serialisierer auszuführen. Zwei Dateien, die denselben Pfad nennen, hinterlassen in dieser Sammlung zwei Werte für einen Schlüssel.
Er weist zurück, statt eine auszuwählen, weil sich keine der beiden Entscheidungen hinterher von der anderen unterscheiden lässt. Die letzte zu behalten, verwirft eine Datei, die der Provider zu schreiben angewiesen hat; die erste zu behalten, verwirft eine spätere. So oder so ist die Ausgabe auf der Festplatte wohlgeformt und um eine Datei zu kurz, ohne dass irgendetwas festhält, dass eine Datei verworfen wurde — und der Pfad, der übrig blieb, ist der Pfad, der ohnehin übrig geblieben wäre, sodass nichts am Ergebnis verrät, dass eine Kollision stattgefunden hat. Welche der beiden gemeint war, ist eine Frage, die nur der Provider beantworten kann.
Die Bedingung wird überall ausgelöst, wo ein Provider Dateien zurückgibt: beim Rendern eines einzelnen Knotens und beim Assemblieren der Ausgabe einer Weiterleitungsgruppe zu einem einzigen Artefakt. Bedingung und Behebung sind in beiden Fällen dieselben, daher melden beide sie.
Ausgegebene Meldung, die den doppelt zurückgegebenen Pfad und den Knoten oder Weiterleitungspfad nennt, für den er zurückgegeben wurde:
provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (der Provider-Gast hat zwei Ausgabedateien unter einem Pfad zurückgegeben; ein konformer Gast gibt jeden Ausgabepfad höchstens einmal zurück (mit dem angegebenen Pfad und dem angegebenen Knoten))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — die Pfade kamen vom Provider. Melden Sie es demjenigen, der ihn veröffentlicht, und zitieren Sie dabei den Pfad, den die Meldung nennt. Wo der Provider Ihrer ist, geben Sie jeden Ausgabepfad höchstens einmal zurück: Bauen Sie die Pfadliste gegen eine Menge auf, damit eine zweite Datei unter einem Pfad dort abgefangen wird, wo sie erzeugt wird, und geben Sie der zweiten Datei einen eigenen Pfad, wenn beide gewünscht sind.
A provider reported a render fact whose value is not a list (Ein Provider hat einen Render-Fakt gemeldet, dessen Wert keine Liste ist)
Ein Provider kann neben seinen Dateien Fakten über die Ausgabe melden, die er gerendert hat — jeweils einen Namen und einen Wert, im eigenen dokumentierten Vokabular dieses Providers —, und die an eine Komponente angebundenen Features lesen sie aus ihren Templates. Der Wert jedes Fakts ist eine Liste, auch wenn sie nur einen Eintrag enthält: Ein Name kann von mehr als einem Rendern einer Komponente gemeldet werden, den Aufrufen ihres eigenen Providers und den Rendervorgängen der an sie angebundenen Features, und die Listen werden für die Templates, die ihn lesen, unter diesem Namen zu einer zusammengeführt. Ein Provider kann beim Rendern nicht wissen, ob seine Meldung die einzige unter einem Namen sein wird, daher wird ein Wert, der ein Objekt, ein String, eine Zahl, ein Boolean oder null ist, dort zurückgewiesen, wo der Provider ihn übergibt, bei jedem Rendern, unabhängig davon, ob ein Template den Fakt liest.
Ausgegebene Meldung, die den Fakt, den Knoten, für den er gemeldet wurde, den Provider, der ihn gemeldet hat, und die Art des Werts nennt:
provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact’s value as a JSON array, even with one entry (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>) (der Provider-Gast hat einen Render-Fakt gemeldet, dessen Wert keine Liste ist; ein konformer Gast meldet den Wert jedes Render-Fakts als JSON-Array, auch mit nur einem Eintrag (mit dem angegebenen Fakt, Knoten und Provider; sein Wert ist von der angegebenen Art))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — der Wert kam vom Provider. Melden Sie es demjenigen, der ihn veröffentlicht, und zitieren Sie dabei den Fakt, den die Meldung nennt. Wo der Provider Ihrer ist, melden Sie den Wert dieses Fakts als JSON-Array — ein einzelnes Objekt wird zu einer Liste, die dieses Objekt enthält — und dokumentieren Sie ihn als Liste in den Fakten, die Ihr Provider meldet; siehe Fakten darüber melden, was ein Gast ausgegeben hat.
A provider’s link wiring names an output file that was never emitted (Die Verknüpfungsverdrahtung eines Providers nennt eine Ausgabedatei, die nie ausgegeben wurde)
Wenn eine Verbindung zwischen zwei Weiterleitungsgruppen verläuft, wird der Provider auf jeder Seite gebeten, sie zu verdrahten: Das konsumierte Ende veröffentlicht eine Identität, das konsumierende Ende löst sich gegen sie auf, und jedes kann eine strukturelle Verdrahtung zurückgeben, die auf die Ausgabe seiner eigenen Gruppe anzuwenden ist. Jedes Verdrahtungsstück nennt die Ausgabedatei, auf die es sich bezieht. Ein späterer Durchlauf zerlegt diese Datei, wendet die Operationen an und reassembliert sie bytegetreu.
Ein Name, der keiner ausgegebenen Datei entspricht, lässt diesem Durchlauf nichts zum Zerlegen, und er weist zurück, statt die Verdrahtung zu übergehen. Die Operationen, die sie trägt, sind das, was die Verbindung auflöst, daher hinterlässt ihr Verwerfen eine assemblierte Ausgabe, die auf einen Endpunkt verweist, den nichts verdrahtet hat — was erst bei der Bereitstellung scheitert, weit entfernt vom Provider, der es verursacht hat, und wie ein Fehler in der Verbindung statt in der Verdrahtung aussieht.
Die Dateien, die ein Verdrahtungsstück nennen darf, sind die Dateien, die das eigene Rendern dieser Gruppe zurückgegeben hat. Sie werden dem Provider im selben Aufruf übergeben, sodass der Provider nie einen Namen erraten muss: Er wählt einen aus der Menge aus, die er erhalten hat.
Ausgegebene Meldung, die die Datei nennt, nach der die Verdrahtung verlangt hat, und den Endpunkt, für den sie zurückgegeben wurde:
link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group’s own render returned (file "<file>", node "<node>") (der Verknüpfungs-Patch nennt eine Ausgabedatei, die die Weiterleitungsgruppe nicht ausgegeben hat; ein konformer Verknüpfungs-Patch nennt eine Datei, die das eigene Rendern der Gruppe zurückgegeben hat (mit der angegebenen Datei und dem angegebenen Knoten))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — der Name kam vom Provider. Melden Sie es demjenigen, der ihn veröffentlicht, und zitieren Sie dabei die Datei, die die Meldung nennt. Wo der Provider Ihrer ist, entnehmen Sie den Dateinamen den assemblierten Dateien, die Ihnen der Aufruf übergibt, statt einem unabhängig gebildeten Namen — ein von Hand zusammengesetzter Pfad veraltet in dem Moment, in dem sich das Rendern ändert, das ihn erzeugt, und so sieht das aus.
A pipeline step’s file emission carries no file (Die Dateiausgabe eines Pipeline-Schritts trägt keine Datei)
Ein Pipeline-Schritt kann neben den Dokumenten, die er patcht, ein neues Dokument ausgeben. Jede Ausgabe deklariert ihre Art, und eine Ausgabe der Art Datei trägt die Datei, die sie schreibt: den Pfad und den Inhalt.
Hier ist die Art richtig und die Datei fehlt, sodass der Schritt eine Absicht deklariert hat, die seine Antwort nicht umsetzt. Das ist der Unterschied zwischen diesem Halt und dem Halt für eine undefinierte Art weiter unten: Der Host weiß genau, was er mit einer Ausgabe emit_file tun soll, und hat nichts, woran er es tun könnte.
Er weist zurück, statt nichts auszugeben, weil eine Ausgabe, die stillschweigend keine Datei beisteuert, unsichtbar wäre. Ein Schritt, der ein Dokument ausgibt, ist oft der ganze Grund, warum er in der Pipeline steht, und seine Ausgabe ist eine Datei, die vorher nicht da war — ein Build, der ihn überginge, würde also eine Ausgabe erzeugen, der ein Dokument fehlt, während der Schritt meldet, dass er gelaufen ist.
Ausgegebene Meldung, die den Knoten nennt und angibt, welche der Ausgaben des Schritts fehlerhaft war:
emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (der Nebeneffekt emit_file trägt keine Datei; ein konformer Nebeneffekt emit_file trägt eine Datei mit ihrem Pfad und ihrem Inhalt (mit dem angegebenen Knoten und dem angegebenen Index des Nebeneffekts))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — die Antwort kam vom Plugin. Melden Sie es demjenigen, der es veröffentlicht, und zitieren Sie dabei den Index, den die Meldung nennt. Wo das Plugin Ihres ist, befüllen Sie das Dateimitglied bei jeder Ausgabe emit_file mit seinem Pfad und seinem Inhalt; der Index sagt, welche Ausgabe in der Antwort dieses Schritts Sie sich ansehen müssen.
A pipeline step declares an emission kind the contract does not define (Ein Pipeline-Schritt deklariert eine Ausgabeart, die der Vertrag nicht definiert)
Jede Ausgabe, die ein Pipeline-Schritt zurückgibt, deklariert ihre Art, und der Vertrag definiert zwei: Eine schreibt eine Datei, eine steuert ein Custom-Resource-Dokument bei. Die Art ist auf der Leitung ein offener String, und das ermöglicht es, später eine Art hinzuzufügen, ohne bestehende Plugins zu beschädigen.
Genau diese Offenheit ist der Grund, warum eine undefinierte Art zurückgewiesen statt übergangen wird. Ein Wert, den der Host nicht definiert, lässt sich allein an seiner Gestalt nicht von einem unterscheiden, den eine spätere Version definieren wird — ein Host, der ihn überspränge, würde also bei jedem Build stillschweigend verwerfen, was der Schritt damit gemeint hat, während der Schritt Erfolg meldet. Das Zurückweisen hält den Erweiterungspunkt offen, ohne ihn zu einem Loch zu machen: Eine Art, die dieser Build nicht definiert, wird als undefiniert gemeldet, unter Zitierung des Werts, den der Schritt gesendet hat, statt angenommen und ignoriert zu werden.
Ausgegebene Meldung, die den Knoten, die fehlerhafte Ausgabe und die von ihr deklarierte Art nennt:
side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>") (der Nebeneffekt deklariert eine Art, die der Plugin-Vertrag nicht definiert; ein konformer Nebeneffekt deklariert emit_file oder emit_crd (mit dem angegebenen Knoten, dem angegebenen Index des Nebeneffekts und der angegebenen Art))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — der Wert kam vom Plugin. Melden Sie es demjenigen, der es veröffentlicht, und zitieren Sie dabei die Art, die die Meldung nennt. Wo das Plugin Ihres ist, deklarieren Sie eine der Arten, die die Meldung aufführt; ein Tippfehler in einer definierten Art ist die häufige Ursache, und der zurückgemeldete Wert ist das, was Sie gesendet haben.
A provider’s reassembly is handed a unit its own carve never produced (Die Reassemblierung eines Providers erhält eine Einheit, die seine eigene Zerlegung nie erzeugt hat)
Ein Provider, dessen Ausgabegestalt sich nicht direkt adressieren lässt, kann sie selbst zerlegen: Er teilt eine Ausgabedatei in adressierbare Einheiten, jede unter einem Token, und gibt sie zurück. Ein Pipeline-Schritt adressiert dann eine Einheit über dieses Token, und die Reassemblierung fügt die bearbeiteten Einheiten bytegetreu wieder in die Datei ein. Die beiden Hälften sind ein einziger Vertrag — die Tokens, unter denen eine Datei zerlegt wird, sind die Tokens, die ihre Reassemblierung auflöst.
Wenn die Reassemblierung ein Token erhält, das die Zerlegung derselben Datei nicht erzeugt hat, gibt es keinen Bytebereich, in den der bearbeitete Inhalt zurückkehren könnte. Sie weist zurück, statt die Einheit zu verwerfen, weil eine verworfene Einheit eine Datei ergibt, die wohlgeformt ist und der eine Bearbeitung fehlt, die ein Schritt vornehmen sollte: Nichts ist fehlgeschlagen, nichts ist fehlerhaft, und die Bearbeitung fehlt einfach.
Die beiden Hälften können nur dort voneinander abweichen, wo sie getrennt sind — bei einem Codec, der selbst zerlegt und für den Rest die strukturelle Standard-Reassemblierung übernimmt. Unter einer Menge von Tokens zu zerlegen und gegen eine andere zu reassemblieren, erzeugt dann genau dies. Ein Codec, dem beide Hälften gehören, kann es nicht erreichen: Seine eigene Reassemblierung steht für seine eigenen Tokens ein.
Ausgegebene Meldung, die das Token nennt, das sich in nichts auflöste, und die Datei, gegen die es genannt wurde:
reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>") (die Reassemblierung nennt ein Token einer gepatchten Einheit, das die Zerlegung nicht erzeugt hat; ein konformer Codec zerlegt und reassembliert eine Datei unter denselben Tokens (mit dem angegebenen Token und der angegebenen Datei))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies. Wo der Provider Ihrer ist, sorgen Sie dafür, dass die Tokens, die eine Hälfte erzeugt, die Tokens sind, die die andere auflöst: Leiten Sie sie einmal ab und reichen Sie sie weiter, statt sie auf jeder Seite unabhängig abzuleiten, und wo die Zerlegung eine Datei vor dem Aufteilen umschreibt, reassemblieren Sie gegen dieselbe umgeschriebene Form. Wo der Provider nicht Ihrer ist, melden Sie es demjenigen, der ihn veröffentlicht, und zitieren Sie dabei das Token, das die Meldung nennt.
A workload declares a form compose cannot express (Eine Workload deklariert eine Form, die compose nicht ausdrücken kann)
Der compose-Provider rendert langlebige Dienste. Eine Workload, die deklariert, dass sie eine Kopie pro Maschine ausführt, nach einem Zeitplan läuft oder einmal läuft und endet, hat keine saubere Entsprechung auf einer einzelnen Maschine, daher hält das Rendern an, statt einen einfachen Dienst auszugeben — der sie starten, am Laufen halten und falsch darstellen würde, was verlangt wurde.
Ausgegebene Meldung. Die Bedingung nennt die Art des Fehlschlags — ein Provider ohne Ausdruck für etwas, das der Build deklariert —, und der eigene Satz des Providers nennt die Form, die er erhalten hat:
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (compose: die angegebene Workload-Form hat keine compose-Zuordnung; compose unterstützt nur stateless und stateful: compose kann diese Workload-Form nicht ausdrücken)
So beheben Sie es: Wo das Ziel tatsächlich eine compose-Umgebung auf einer einzelnen Maschine ist, drücken Sie die Arbeit als langlebigen Dienst aus — die Formen stateless und stateful sind die beiden, die er rendert. Wo die Form das Gemeinte ist, rendern Sie diese Boundary über einen Provider, dessen Ziel eine Entsprechung hat: Eine Kopie pro Maschine, ein geplanter Lauf und ein Job, der bis zum Abschluss läuft, haben anderswo alle direkte Ausdrucksformen, und die Wahl des Providers ist Sache der Boundary statt der Workload.
A container declares a field compose has no primitive for (Ein Container deklariert ein Feld, für das compose kein Primitiv hat)
Zwei Container-Felder haben keine compose-Entsprechung, und beide halten das Rendern an, statt verworfen zu werden.
Hooks, die laufen, wenn ein Container startet oder gleich anhält. compose hat nichts, das sie ausführt, und ein Hook, der stillschweigend nicht ausgeführt wird, ist eine Korrektheitsüberraschung, die zur Laufzeit statt zur Build-Zeit zutage tritt.
Umgebung im Block aus einem benannten Objekt. compose kann Variablen aus einer Datei lesen, aber ein Verweis auf ein Objekt ist keine Datei — das eine als das andere umzudeuten, würde ändern, was der Container erhält, ohne es zu sagen.
Beide werden für gewöhnliche Container und für Container geprüft, die vor dem Hauptcontainer laufen, sodass dasselbe Feld überall anhält, wo es deklariert ist, und die Meldung nennt, aus welchem Container es stammt.
Ausgegebene Meldungen. Beide melden dieselbe Bedingung — ein Provider ohne Ausdruck für etwas, das der Build deklariert —, und der eigene Satz des Providers ist das, was sagt, welches Feld:
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks (compose: im angegebenen Knoten und Container: compose: der angegebene Knoten deklariert Lifecycle-Hooks des Containers; compose hat kein Primitiv für Lifecycle-Hooks: compose hat kein Primitiv für Lifecycle-Hooks; der Container deklariert Lifecycle-Hooks)
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom (compose: im angegebenen Knoten und Container: compose: der angegebene Knoten deklariert envFrom für den Container; compose hat kein Primitiv für Umgebung aus einem Objekt: compose hat kein Primitiv für Umgebung aus einem Objekt; der Container deklariert envFrom)
So beheben Sie es: Entfernen Sie für ein compose-Ziel das Feld und erledigen Sie seine Arbeit auf andere Weise — Startarbeit gehört in einen Container, der vor dem Hauptcontainer läuft, und Herunterfahrarbeit in die eigene Signalbehandlung des Containers; die Umgebung im Block kann als explizite Variablen ausgeschrieben oder aus einer Datei bereitgestellt werden, die das compose-Ziel lesen kann. Wo das Feld das Gemeinte ist, rendern Sie diese Boundary über einen Provider, dessen Ziel das Primitiv hat.
An omits entry names a kind or a namespace a compose file does not have (Ein omits-Eintrag nennt einen Kind oder einen Namespace, den eine Compose-Datei nicht hat)
Ein Eintrag omits: an einem Recipe oder einem FeatureRecipe, das eine Compose-Datei als Quelle verwendet, lässt eine Einheit oberster Ebene dieser Datei weg, und eine Compose-Datei hat genau drei Kinds, die ein Eintrag nennen kann — einen service, ein volume und eine config, jeweils über ihren Schlüssel unter services:, volumes: oder configs: angegeben — und keine Namespaces. Ein Eintrag, der einen anderen Kind nennt, darunter das Secret eines Chart-Dokuments oder ein network von Compose, oder der einen namespace trägt, nennt nichts, was die Datei weglassen könnte, daher hält das Rendern an, statt den Eintrag als einen zu behandeln, der auf nichts gepasst hat. Kinds werden exakt verglichen, daher wird Service zurückgewiesen, wo service gemeint ist. Jeder Eintrag wird geprüft, bevor irgendetwas weggelassen wird, und genannt wird der erste fehlerhafte, in der Reihenfolge, in der die Einträge geschrieben wurden.
Ausgegebene Meldungen. Beide melden die Bedingung für ein Konstrukt, für das ein Provider keinen Ausdruck hat, und der eigene Satz des Providers nennt den Eintrag und die Kinds, die er akzeptiert. Ein Feld, dessen Template einen als sensibel deklarierten Wert gelesen hat, wird als <redacted> angezeigt:
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind (compose: ein omits-Eintrag (mit dem angegebenen Namen) nennt den angegebenen Kind: compose lässt einen Service, ein Volume oder eine Config weg, jeweils über ihren Schlüssel unter services:, volumes: oder configs: benannt, und keinen anderen Kind)
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry (compose: ein omits-Eintrag (mit dem angegebenen Kind und Namen) nennt den angegebenen Namespace, und eine Compose-Datei hat keine Namespaces: compose lässt einen Service, ein Volume oder eine Config weg, jeweils über ihren Schlüssel unter services:, volumes: oder configs: benannt, und keinen anderen Kind; entfernen Sie den Namespace aus dem Eintrag)
So beheben Sie es: Benennen Sie die Einheit so, wie die Compose-Datei es tut — kind: service, volume oder config, und als name: ihren Schlüssel unter diesem Abschnitt —, und entfernen Sie den namespace:. Siehe compose → Modus mit Quelle.
An omits entry names a namespace a CloudFormation template does not have (Ein omits-Eintrag nennt einen Namespace, den ein CloudFormation-Template nicht hat)
Ein Eintrag omits: an einem Recipe oder einem FeatureRecipe, das ein CloudFormation-Template als Quelle verwendet, lässt eine Ressource weg, benannt über ihren Type als kind des Eintrags und ihre logische ID als name des Eintrags. Ein Template hat keine Namespaces, daher nennt ein Eintrag, der einen namespace trägt, nichts, was ein Template weglassen könnte, und das Rendern hält an, statt den Eintrag als einen zu behandeln, der auf nichts gepasst hat. Jeder Eintrag wird geprüft, bevor irgendetwas weggelassen wird, und genannt wird der erste, der einen Namespace trägt, in der Reihenfolge, in der die Einträge geschrieben wurden.
Ausgegebene Meldung. Sie meldet die Bedingung für ein Konstrukt, für das ein Provider keinen Ausdruck hat, und der eigene Satz des Providers nennt den Eintrag und das, was dieser Provider weglässt. Ein Feld, dessen Template einen als sensibel deklarierten Wert gelesen hat, wird als <redacted> angezeigt:
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry (cloudformation-provider: ein omits-Eintrag (mit dem angegebenen Kind und Namen) nennt den angegebenen Namespace, und ein CloudFormation-Template hat keine Namespaces: cloudformation lässt eine Ressource weg, benannt über ihren Type als Kind des Eintrags und ihre logische ID unter Resources als Namen des Eintrags; entfernen Sie den Namespace aus dem Eintrag)
A published port declares a transport compose cannot spell (Ein veröffentlichter Port deklariert einen Transport, den compose nicht schreiben kann)
Ein veröffentlichter Compose-Port trägt seinen Transport als Suffix am Eintrag, und dieses Suffix hat zwei Schreibweisen. Ein Port, der einen anderen Transport deklariert, hat überhaupt keine Compose-Schreibweise.
Das Rendern hält an, statt das Suffix wegzulassen, weil ein veröffentlichter Port, der stillschweigend auf den Standardtransport zurückfällt, mit Verkehr hochfährt, den seine Clients nicht erreichen können — was genau der Fehlschlag ist, den das Deklarieren eines Transports verhindern soll, im Moment der Übersetzung wieder eingeführt.
Ein Port, der keinen Transport deklariert, ist nicht betroffen. Er wird ohne Suffix veröffentlicht, genau wie ein Port, der nie einen Transport getragen hat.
Ausgegebene Meldung. Die Bedingung nennt die Art des Fehlschlags — ein Wert ohne Darstellung in dem, was der Provider ausgibt —, und der eigene Satz des Providers folgt ihr:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express (compose: im angegebenen Knoten, Anwenden der Service-Ports: compose veröffentlicht den Transport eines Ports als tcp- oder udp-Suffix; dieser Port deklariert einen Transport, den compose nicht ausdrücken kann)
So beheben Sie es: Deklarieren Sie für ein compose-Ziel den Transport des Ports als einen der beiden, die compose schreiben kann, oder lassen Sie ihn undeklariert und den Eintrag ohne Suffix veröffentlichen. Wo der Transport das ist, was Sie gemeint haben, rendern Sie diese Boundary über einen Provider, dessen Ziel ihn ausdrücken kann.
A resources quantity cannot be converted to a compose value (Eine Ressourcenmenge kann nicht in einen Compose-Wert umgewandelt werden)
Die Prozessor- und Speichermengen eines Containers sowie seine Anzahl nvidia.com/gpu werden in der Notation geschrieben, die Kubernetes für Ressourcen verwendet, und compose trägt sie in eigenen Einheiten — eine GPU-Anzahl wird zur Anzahl einer NVIDIA-Gerätereservierung —, daher wird jede als Mengenangabe gelesen und aus ihrem Wert umgerechnet. Zwei Dinge verhindern das, und die Meldung sagt, auf welches sie gestoßen ist: ein Wert, der überhaupt keine Mengenangabe ist, und eine Mengenangabe, für die compose keine exakte Form hat — eine negative Menge, eine Speichermenge, die keine ganze Zahl von Bytes ist, eine Prozessormenge, die feiner ist als neun Dezimalstellen eines Kerns, eine GPU-Anzahl, die keine ganze Zahl von Geräten ist, oder eine Menge jenseits der größten, die compose aufnehmen kann. Ein Container, dessen Anforderung und Limit für nvidia.com/gpu unterschiedliche Anzahlen verlangen, hält das Rendern ebenfalls an, weil compose eine Anzahl pro Service reserviert. Das Rendern hält an, statt den Wert zu runden oder eine Näherung auszugeben, weil ein Limit, das stillschweigend nicht das verlangte Limit ist, die Art von Unterschied ist, nach der niemand sucht, bis etwas angehalten wird, weil es ihn überschritten hat.
Ausgegebene Meldungen. Jede beginnt mit der Bedingung — ein Wert ohne Darstellung in dem, was der Provider ausgibt —, nennt dann die Ressource, ob der Wert eine Anforderung oder ein Limit ist, seinen Pfad in der Workload und den Wert. Auf einen Wert, der keine Mengenangabe ist, folgt, was ihn daran gehindert hat, eine zu sein, und die Form, die eine Mengenangabe hat:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu><request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value (compose: im angegebenen Knoten und Container: compose: die angegebene Anforderung oder das angegebene Limit der angegebenen Ressource am angegebenen Pfad: der angegebene Wert ist keine Mengenangabe: mit dem angegebenen Grund; eine Mengenangabe ist eine Zahl wie 2, 0.5 oder 1.5, mit einem optionalen Vorzeichen und höchstens einem von einem ganzzahligen Exponenten (1e3, 5E-2) oder einem Einheitensuffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): die resources-Menge kann nicht in einen deploy.resources-Wert von compose umgewandelt werden)
Auf eine Mengenangabe, die compose nicht darstellen kann, folgt der Bereich, den compose für diese Ressource zulässt:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: im angegebenen Knoten und Container: compose: die angegebene Speicher-Anforderung oder das angegebene Speicher-Limit am angegebenen Pfad ist der angegebene Wert, eine Mengenangabe, die compose nicht exakt darstellen kann; ein Compose-Speicherwert ist eine ganze Zahl von Bytes von 0 bis 9223372036854775807: die resources-Menge kann nicht in einen deploy.resources-Wert von compose umgewandelt werden)
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value (compose: im angegebenen Knoten und Container: compose: die angegebene cpu-Anforderung oder das angegebene cpu-Limit am angegebenen Pfad ist der angegebene Wert, eine Mengenangabe, die compose nicht exakt darstellen kann; ein cpus-Wert von compose ist eine Anzahl von Kernen von 0 bis 9223372036.854775807 mit höchstens neun Dezimalstellen: die resources-Menge kann nicht in einen deploy.resources-Wert von compose umgewandelt werden)
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: im angegebenen Knoten und Container: compose: die angegebene nvidia.com/gpu-Anforderung oder das angegebene nvidia.com/gpu-Limit am angegebenen Pfad ist der angegebene Wert, eine Mengenangabe, die compose nicht exakt darstellen kann; eine Compose-Geräteanzahl ist eine ganze Zahl von Geräten von 0 bis 9223372036854775807: die resources-Menge kann nicht in einen deploy.resources-Wert von compose umgewandelt werden)
Eine GPU-Anforderung und ein GPU-Limit, die unterschiedliche Anzahlen verlangen, nennen beide Pfade und beide Anzahlen:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value (compose: im angegebenen Knoten und Container: compose: die nvidia.com/gpu-Anforderung am angegebenen Pfad und das Limit am angegebenen Pfad verlangen unterschiedliche Anzahlen (die angegebenen); compose reserviert eine Geräteanzahl pro Service, schreiben Sie daher dieselbe Anzahl in beide oder nur das Limit: die resources-Menge kann nicht in einen deploy.resources-Wert von compose umgewandelt werden)
Wo das Template der Workload einen Wert liest, den ein Autor als sensibel deklariert hat, zitiert keine Meldung den Wert, den sie zurückgewiesen hat, und die beiden Anzahlen werden auf dieselbe Weise weggelassen.
So beheben Sie es: Wo der Wert keine Mengenangabe ist, schreiben Sie ihn in der Form, die unter Workload → Ressourcenmengen beschrieben ist; ein bloßes Suffix wie m ist das, was ein Template hinterlässt, wenn der Wert, den es interpoliert, leer ist, daher ist die zu korrigierende Eingabe die, die das Template gelesen hat. Wo es eine Mengenangabe ist, die compose nicht darstellen kann, schreiben Sie eine Menge innerhalb des Bereichs, den die Meldung angibt — Speicher als ganze Zahl von Bytes in einer beliebigen Einheit (1536Mi statt 1.5001Gi), Prozessorzeit mit höchstens neun Dezimalstellen eines Kerns und eine GPU-Anzahl als ganze Zahl von Geräten (1, nicht 0.5 oder 500m). Wo eine GPU-Anforderung und ein GPU-Limit nicht übereinstimmen, schreiben Sie dieselbe Anzahl in beide oder schreiben Sie nur das Limit, das die Anzahl ist, die Kubernetes für dieselbe Workload einplant.
A resource quantity the helm provider emits is not a quantity (Eine Ressourcenmenge, die der helm-Provider ausgibt, ist keine Mengenangabe)
Der helm-Provider kopiert jede Ressourcenmenge unverändert in die Manifeste, die er ausgibt — die Werte resources.requests und resources.limits jedes Containers und Init-Containers, erweiterte Ressourcen eingeschlossen, sowie ephemeral.sizeLimit, persistent.size und persistentTemplate.size jedes Volumes — und prüft jede zuerst gegen die Form einer Mengenangabe, an der Workload, wie die Templates des Recipe sie ausgewertet haben. Ein Wert außerhalb der Form hält den Build hier an, wo er sonst sauber bauen und vom Cluster abgelehnt würde, wenn das Chart installiert wird.
Ausgegebene Meldung. Sie beginnt mit der Bedingung, nennt dann den Knoten, den Pfad des Felds in der Workload, den Wert und das, was ihn daran gehindert hat, eine Mengenangabe zu sein, und gibt die Form an, die eine Mengenangabe hat:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) (helm: im angegebenen Knoten: angegebener Pfad: der angegebene Wert ist keine Mengenangabe: mit dem angegebenen Grund; eine Mengenangabe ist eine Zahl wie 2, 0.5 oder 1.5, mit einem optionalen Vorzeichen und höchstens einem von einem ganzzahligen Exponenten (1e3, 5E-2) oder einem Einheitensuffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei))
So beheben Sie es: Schreiben Sie den Wert in der Form, die unter Workload → Ressourcenmengen beschrieben ist. Wo das Feld ein Template ist, ist der zu korrigierende Wert der, den das Template gelesen hat: ein bloßes Suffix wie m oder Mi ist das, was ein Template hinterlässt, wenn der Wert, den es interpoliert, leer ist, und ein Parameter des Release erreicht das Feld genau so, wie er geschrieben wurde.
A service type the helm provider cannot render (Ein Service-Typ, den der helm-Provider nicht rendern kann)
Der helm-Provider rendert jeden Eintrag services einer Workload als Kubernetes-Service, dessen Typ der type des Eintrags ist. Ein Eintrag Loopback verlangt, dass seine Ports von der eigenen Loopback-Adresse des Hosts aus erreichbar sind und von nirgendwo sonst, und ein Kubernetes-Service hat keinen Typ, der das tut: Auf welchen Knotenadressen ein Service vom Typ NodePort lauscht, ist eine Einstellung des gesamten Clusters, nicht eines einzelnen Service. Daher hält der Build beim ersten Eintrag Loopback an, in der Reihenfolge, in der die Services deklariert sind, bevor irgendeine Ressource geschrieben wird.
Der Build hält an, statt den Eintrag als anderen Typ zu rendern, weil jeder der Typen, die ein Service hat, verändert, was der Port erreicht: Ein Service vom Typ ClusterIP lässt die veröffentlichte Reichweite fallen, die der Eintrag verlangt, und einer vom Typ NodePort veröffentlicht den Port auf jeder Knotenadresse, die der Cluster zulässt — die breitere Exposition, die der Eintrag vermeiden soll.
Ausgegebene Meldung. Sie beginnt mit der Bedingung, nennt dann den Knoten, den Pfad des Service in der Workload und den Typ:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it (helm: im angegebenen Knoten: angegebener Service unter services: der Typ „Loopback“ veröffentlicht die Ports des Service nur auf der Loopback-Adresse des Hosts, und ein Kubernetes-Service hat keinen Typ, der das tut; deklarieren Sie ClusterIP, um die Ports innerhalb des Clusters zu halten, oder NodePort oder LoadBalancer, um sie außerhalb zu veröffentlichen)
So beheben Sie es: Deklarieren Sie für ein helm-Ziel den Typ, der angibt, wie weit der Port im Cluster reichen soll — ClusterIP, um ihn innerhalb zu halten, NodePort oder LoadBalancer, um ihn zu veröffentlichen. Ein Eintrag Loopback ist für ein compose-Ziel, das den Port auf 127.0.0.1 veröffentlicht; siehe Workload → services.
A Kubernetes version the helm provider cannot render a chart for (Eine Kubernetes-Version, für die der helm-Provider kein Chart rendern kann)
Der helm-Provider rendert ein Chart aus der Quelle für die Kubernetes-Version, die die Annotation aggrega.ai/kubernetes-version an einer Komponente oder an ihrer Boundary nennt, und liest den Wert so, wie helm template --kube-version sein Flag liest. Ein Wert, den dieses Flag zurückweisen würde — "one.two", "latest", eine einzelne Zahl wie "1", eine mit führender Null geschriebene Zahl wie "01.20" —, hat keine Version, die das Chart als .Capabilities.KubeVersion lesen könnte, daher hält der Build an, bevor das Chart gerendert wird.
Der Build hält an, statt das Chart für die Standardversion zu rendern, weil ein Chart die Version liest, um eine API-Version, ein Feld oder einen ganzen Mechanismus zu wählen, und ein Chart, das für eine andere als die von Ihnen genannte Version gerendert wird, die Form für jene andere Version ausgibt — eine, die der Cluster, in dem es bereitgestellt wird, möglicherweise nicht ausführt.
Ein leerer Wert wird nicht zurückgewiesen. Er wird als nicht gesetzt behandelt, und das Chart wird für den Standard gerendert: die Version, für die das unveränderte helm template derselben helm-Version rendert.
Ausgegebene Meldung. Sie beginnt mit der Bedingung, nennt dann den Knoten und die Boundary, in der er platziert ist, die Annotation, den Wert und das, was ihn daran gehindert hat, eine Version zu sein, und gibt die zu schreibende Form an:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary (helm: im angegebenen Knoten in der angegebenen Boundary: Annotation aggrega.ai/kubernetes-version: der angegebene Wert ist keine Kubernetes-Version, für die ein Chart gerendert werden kann: mit dem angegebenen Grund; schreiben Sie die Version des Clusters, in dem das Chart bereitgestellt wird, etwa „1.31“ oder „v1.31.2“, an die Komponente oder an ihre Boundary)
Die Meldung nennt sowohl den Knoten als auch seine Boundary, weil der Provider die Annotationen einer Komponente und die ihrer Boundary zusammen liest, wobei der eigene Wert der Komponente Vorrang hat, sodass der Wert an einer der beiden geschrieben worden sein kann.
So beheben Sie es: Schreiben Sie die Version des Clusters, in dem das Chart bereitgestellt wird — eine Haupt- und Nebenversion wie "1.31" oder eine vollständige wie "v1.31.2" —, an die Komponente oder an ihre Boundary, oder entfernen Sie die Annotation, um für den Standard zu rendern. Siehe helm → Die Kubernetes-Version, für die ein Chart gerendert wird.
A health probe cannot be turned into a compose healthcheck (Eine Health-Probe kann nicht in einen Compose-Healthcheck umgewandelt werden)
Eine deklarierte Health-Probe wird zu einem Compose-Healthcheck, und zwei Dinge können das verhindern.
Eine Probe, die einen Pfad über HTTP prüft, an einem Container, der keinen Port veröffentlicht. Die Prüfung wird als Anfrage an einen Port des Containers aufgebaut, daher gibt es ohne deklarierten Port keine Adresse, gegen die sie aufgebaut werden könnte.
Eine Probe, die überhaupt keine Art der Prüfung deklariert — weder einen Pfad noch einen Port zum Verbinden noch einen auszuführenden Befehl. Es gibt nichts, was in eine Prüfung umgewandelt werden könnte. Dies ist eine Absicherung hinter dem Schema und keine Form, die Sie wahrscheinlich schreiben: Eine Probe wird darauf geprüft, dass sie eine der drei hat, bevor sie hierher gelangt.
Ausgegebene Meldungen. Beide melden dieselbe Bedingung — etwas, das der Provider benötigt und das er nicht in genau einen Wert auflösen konnte —, und der eigene Satz des Providers sagt, welche:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none (compose: im angegebenen Knoten und Container: Probe http: erfordert mindestens einen Container-Port; der Container deklariert keinen)
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec) (compose: im angegebenen Knoten und Container: die Probe deklariert keine Form (http/tcp/exec))
So beheben Sie es: Deklarieren Sie den Port, gegen den die Prüfung erfolgen soll, am selben Container wie die Probe — eine Probe über HTTP liest den ersten Container-Port, daher muss der Port existieren, damit die Prüfung aufgebaut werden kann. Wo der Container tatsächlich nichts veröffentlicht, prüfen Sie ihn auf andere Weise: Eine Probe, die einen Befehl ausführt, benötigt keinen Port. Geben Sie einer Probe ohne deklarierte Art der Prüfung eine der drei.
A configmap volume has no file behind it (Hinter einem configmap-Volume steht keine Datei)
Ein Volume, das Konfiguration einhängt, wird über den eigenen Mechanismus von compose dafür geliefert, per Name referenziert, und der Eintrag, der den Inhalt enthält, stammt aus einer Datei, die das Recipe ausgibt. Diese Bedingung ist das, was eine Referenz ohne passenden Eintrag meldet: Die Datei ist nicht da, daher würde der Mount existieren, ohne dass etwas dahintersteht, und der Container würde hochfahren und einen leeren Pfad lesen.
Die Prüfung läuft über die gesamte assemblierte Ausgabe statt pro Komponente, und das ist beabsichtigt: Die Referenz und der Eintrag, der den Inhalt enthält, kommen auf verschiedenen Wegen an und können von verschiedenen Komponenten derselben Gruppe stammen, daher ist die assemblierte Ausgabe der erste Punkt, an dem beide vorhanden sind. Eine Prüfung pro Komponente würde eine Referenz zurückweisen, deren Inhalt eine andere Komponente derselben Gruppe liefert.
Jede nicht aufgelöste Referenz wird gemeldet, nicht nur die erste, in einer stabilen Reihenfolge, sodass ein einziger Build sie alle nennt.
Ausgegebene Meldung. Die Bedingung steht vorn, dann jeder Service, die Referenz, die er gemacht hat, und wo sie eingehängt wird:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found (compose AssembleBoundary: der angegebene Service referenziert die angegebene Config, eingehängt am angegebenen Pfad; deklarieren Sie jede als Eintrag configs: oberster Ebene aus der Eingabe artifacts: des Recipe: ein configmap-Volume erfordert eine über die Eingabe artifacts: des Recipe ausgegebene Datei; keine gefunden)
So beheben Sie es: Geben Sie die Datei aus der Eingabe artifacts: des Recipe unter dem Namen aus, den das Volume referenziert — die beiden werden über diesen Namen abgeglichen, daher ist eine Abweichung zwischen dem, was das Volume verlangt, und dem, was das Recipe ausgibt, die häufige Ursache. Wo der Inhalt von woanders kommen sollte, ist das Volume der falsche Mechanismus dafür: Ein Wert, der in die Umgebung gehört, kommt stattdessen dorthin.
What an omits entry left out is still named by the compose file (Was ein omits-Eintrag weggelassen hat, wird von der Compose-Datei noch genannt)
Ein Eintrag omits: lässt einen Service, ein Volume oder eine Config aus einer als Quelle verwendeten Compose-Datei weg, und compose weist eine Datei zurück, die eines nennt, das sie nicht deklariert. Sobald also die Einheiten der Einträge entfernt sind, hält jede Referenz, die der Rest der Datei noch auf eine davon macht, das Rendern an: ein Service, der von depends_on, links, volumes_from, extends, einem Wert von build.additional_contexts oder einem Netzwerk-, IPC-, PID- oder UTS-Modus service: genannt wird; ein Volume, das als Quelle eines Eintrags volumes: genannt wird; eine Config, die von einem Eintrag configs: genannt wird — gelesen in jedem Service, in den Hooks pre_start jedes Service und in jedem Job. Die vollständige Liste und die Werte, die nur wie Referenzen aussehen, finden Sie unter compose → Modus mit Quelle.
Die Prüfung liest die eigene Datei des Recipe oder FeatureRecipe, das den Eintrag deklariert, daher hält sie das Rendern auch dort an, wo ein anderer Beitragender zur selben assemblierten Datei eine Einheit mit dem Namen der weggelassenen deklariert. Jede Referenz wird gemeldet, nicht nur die erste — Services in Schlüsselreihenfolge, dann Jobs, die Hooks jedes Service nach ihm —, sodass ein einziger Build sie alle nennt.
Ausgegebene Meldung. Die Bedingung steht vorn, dann jeder verweisende Eintrag, die Einheit, die er nennt, und das Feld, in dem die Referenz steht:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) compose: what an omits entry left out is still named by the file: service "<service>" names <kind>"<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry (compose: was ein omits-Eintrag weggelassen hat, wird von der Datei noch genannt: der angegebene Service nennt die Einheit mit dem angegebenen Kind und Namen im angegebenen Feld; compose weist eine Datei zurück, die einen Service, ein Volume oder eine Config nennt, die sie nicht deklariert: lassen Sie auch weg, was es nennt, ändern Sie die Referenz über valuesMapping, oder entfernen Sie den Eintrag)
Eine Einheit, deren Eintragsname aus einem als sensibel deklarierten Wert gebildet wurde, wird als <redacted> angezeigt.
So beheben Sie es: Entscheiden Sie, welches der beiden Sie gemeint haben. Wo der verweisende Service die Einheit noch benötigt, behalten Sie sie: Entfernen Sie den Eintrag. Wo nicht, ändern Sie die Referenz über das valuesMapping: des Recipe — eine Liste dort ersetzt die Liste der Basisdatei, daher leert depends_on: [] eine solche —, oder lassen Sie den verweisenden Service mit einem eigenen Eintrag weg.
What an omits entry left out is still named by a CloudFormation template (Was ein omits-Eintrag weggelassen hat, wird von einem CloudFormation-Template noch genannt)
Ein Eintrag omits: lässt eine Ressource aus einem als Quelle verwendeten CloudFormation-Template weg, und CloudFormation weist ein Template zurück, das eine Ressource nennt, die es nicht deklariert. Sobald also die Ressourcen der Einträge entfernt sind, hält jede Referenz, die die verbleibenden Templates noch auf eine davon machen, das Rendern an: ein Ref, ein Fn::GetAtt in seiner Listenform oder seiner Form als Zeichenkette mit Punkt, das DependsOn einer Ressource oder eine Variable eines Fn::Sub — gelesen an beliebiger Stelle im Körper jeder Ressource und jedes Outputs. Die vollständige Liste und die Werte, die nur wie Referenzen aussehen, finden Sie unter cloudformation → Ressourcen aus einem als Quelle verwendeten Template weglassen.
Die Prüfung liest die eigenen Templates des Recipe oder FeatureRecipe, das den Eintrag deklariert, zusammen: Eine Referenz auf eine logische ID, die ein anderes dieser Templates noch deklariert, wird nicht angehalten, während eine auf eine weggelassene Ressource das Rendern auch dort anhält, wo eine andere Komponente eine Ressource mit dieser logischen ID deklariert. Jede Referenz wird gemeldet, nicht nur die erste — Template für Template in der Reihenfolge, in der die Quelle sie trägt, für jedes Template seine Ressourcen und dann seine Outputs in Schlüsselreihenfolge —, sodass ein einziger Build sie alle nennt.
Ausgegebene Meldung. Die Bedingung steht vorn, dann jede Referenz: das Template, in dem sie steht, die Ressource, die sie nennt, wie sie sie nennt, und wo sie sich als Pfad ab der Wurzel des Templates befindet:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry (cloudformation-provider: was ein omits-Eintrag weggelassen hat, wird von den Templates der Quelle noch genannt: das angegebene Template nennt die angegebene Ressource (mit dem angegebenen Typ) auf die angegebene Weise am angegebenen Pfad; CloudFormation weist ein Template zurück, das eine Ressource nennt, die es nicht deklariert: lassen Sie auch weg, was sie nennt, oder entfernen Sie den Eintrag)
Wo die Felder eines Eintrags aus einem als sensibel deklarierten Wert gebildet wurden, werden die logische ID und der Typ seiner Ressource als <redacted> angezeigt, ebenso jeder Schritt des Pfads, der diese logische ID ausschreibt.
So beheben Sie es: Entscheiden Sie, welches der beiden Sie gemeint haben. Wo die verweisende Ressource die weggelassene noch benötigt, behalten Sie sie: Entfernen Sie den Eintrag. Wo nicht, lassen Sie die verweisende Ressource ebenfalls weg, mit einem eigenen Eintrag — ein an einen Parameter gebundener Wert ersetzt nur eine Referenz auf diesen Parameter, daher kann eine Referenz auf eine Ressource dadurch nicht geändert werden. Ein Output, der die Ressource nennt, kann nicht weggelassen werden, daher bleibt eine Ressource, die ein Output nennt.
A valuesMapping key names no parameter of a sourced CloudFormation template (Ein valuesMapping-Schlüssel nennt keinen Parameter eines als Quelle verwendeten CloudFormation-Templates)
Ein als Quelle verwendetes CloudFormation-Template nimmt Werte über die Parameters entgegen, die es deklariert, und das valuesMapping des Recipe oder FeatureRecipe, das es als Quelle verwendet, schreibt einen Schlüssel pro Parameter, den es befüllt. Ein Schlüssel, der keinen Parameter nennt, den irgendein Template der Quelle deklariert, hat kein Ziel, daher hält das Rendern an, statt ihn fallen zu lassen — der Fehlschlag, den CloudFormation selbst für einen unbekannten Parameter melden würde, gemeldet, solange er noch von Ihnen zu beheben ist. Nur ein valuesMapping befüllt Parameter: Werte, die nichts zugeordnet hat, werden nie auf diese Weise gelesen, daher stoßen die eigenen Werte einer Komponente oder einer Anbindung, die für ihre anderen Eingaben geschrieben wurden, nie darauf.
Ausgegebene Meldung. Die Bedingung steht vorn, dann jeder Schlüssel, der nichts genannt hat, und was jedes Template der Quelle deklariert:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping (cloudformation-provider: das valuesMapping des Recipe oder FeatureRecipe schreibt den angegebenen Schlüssel, und kein Template der Quelle deklariert einen Parameter dieses Namens: das angegebene Template deklariert den angegebenen Parameter, …; ein als Quelle verwendetes Template nimmt Werte nur über die Parameter entgegen, die es deklariert, benennen Sie den Schlüssel daher in den Parameter um, für den er gedacht ist, oder entfernen Sie ihn aus dem valuesMapping)
Another component references a CloudFormation parameter a sourced template’s binding filled (Eine andere Komponente referenziert einen CloudFormation-Parameter, den die Bindung eines als Quelle verwendeten Templates befüllt hat)
Das Befüllen des Parameters eines als Quelle verwendeten Templates über das valuesMapping des Recipe oder des FeatureRecipe des angebundenen Feature, das es als Quelle verwendet, ersetzt jede Referenz darauf in jedem Template dieser Quelle und entfernt seine Deklaration. Inhalte von anderswo im selben assemblierten Stack — das Fragment oder als Quelle verwendete Template einer anderen Komponente oder das Fragment der Komponente, an die ein Feature angebunden ist —, die den Parameter noch über Ref, eine Variable von Fn::Sub oder das Fn::ValueOf einer Regel nennen, nennen dann etwas, das der Stack nicht mehr deklariert, was CloudFormation zurückweist, wenn der Stack bereitgestellt wird, daher hält die Assemblierung an. Ein Name, den eine Komponente des Stacks noch deklariert, als eigenen Parameter oder als logische ID einer Ressource, ist eine Referenz, die der Stack auflöst, und wird nicht angehalten.
Ausgegebene Meldung. Die Bedingung steht vorn, dann jede Referenz: die Komponente und das Template, in denen sie steht, der Parameter und die Komponente, deren valuesMapping des Recipe oder angebundenen FeatureRecipe ihn befüllt hat — ein an eine Komponente angebundenes Feature wird über diese Komponente benannt, und eines, das an eine Boundary angebunden ist, über die Identität, die seine Ressourcen als aggrega.ai/component-id tragen, zusammengesetzt aus dem Pfad der Boundary und dem Namen der Anbindung, etwa bfr--stack--aux:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (cloudformation-provider: ein Parameter, den die Bindung eines als Quelle verwendeten Templates befüllt hat, wird von anderswo im assemblierten Stack noch referenziert: das angegebene Template der angegebenen Komponente referenziert den angegebenen Parameter, den das valuesMapping eines Recipe oder FeatureRecipe, das für die angegebene Komponente rendert, bindet; …; das Binden eines Parameters entfernt seine Deklaration aus der Quelle, die ihn deklariert, und kein Template im Stack deklariert ihn mehr, daher nennt die Referenz nichts, was CloudFormation auflösen kann: referenzieren Sie stattdessen, was die bindende Komponente veröffentlicht, deklarieren Sie den Parameter in dem Template, das ihn referenziert, oder entfernen Sie den Schlüssel aus dem valuesMapping)
So beheben Sie es: Wo die referenzierende Komponente den Wert benötigt, lassen Sie die Komponente, die ihn befüllt, ihn über provides veröffentlichen, und referenzieren Sie diesen; oder deklarieren Sie den Parameter im referenzierenden Template, sodass es seinen eigenen Wert erhält; oder entfernen Sie den Schlüssel aus dem valuesMapping, sodass der Parameter deklariert bleibt und jede Komponente den Wert liest, der beim Bereitstellen des Stacks übergeben wird. Siehe cloudformation → Werte für die Parameter eines als Quelle verwendeten Templates.
A value bound to a CloudFormation parameter cannot take the parameter’s type (Ein an einen CloudFormation-Parameter gebundener Wert kann den Typ des Parameters nicht annehmen)
Ein an einen Parameter gebundenes Literal wird so umgewandelt, wie CloudFormation denselben Wert umwandelt, wenn er beim Bereitstellen des Stacks für den Type dieses Parameters übergeben wird. Wo es keine solche Umwandlung gibt, hält das Rendern an: ein Wert, der keine Zahl ist, gebunden an einen Number oder eine List<Number>, eine Liste oder ein Mapping, gebunden an einen Parameter, der einen einzigen Wert annimmt, und jedes Literal, das an einen Parameter AWS::SSM::Parameter::Value<…> gebunden ist, dessen Wert CloudFormation aus dem Parameter Store statt aus dem Template liest. Eine Liste, die an einen Parameter gebunden ist, den das Template als Variable von Fn::Sub nennt, hält das Rendern ebenfalls an, weil eine Variable eine einzige Zeichenkette ersetzt.
Ausgegebene Meldung. Die Bedingung steht vorn, dann der Parameter, sein Template und sein Typ und warum der Wert nicht passt; kein Wert wird zitiert:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (cloudformation-provider: der angegebene Parameter des angegebenen Templates hat den angegebenen Typ, und der Wert passt aus dem angegebenen Grund nicht)
So beheben Sie es: Binden Sie einen Wert vom Typ des Parameters — oder, für einen Parameter-Store-Typ, eine dynamische Referenz {{resolve:ssm:…}} oder eine intrinsische Funktion —, oder lassen Sie den Parameter ungebunden für einen Wert, der beim Bereitstellen des Stacks übergeben wird.
A value bound to a CloudFormation parameter is one its constraints refuse (Ein an einen CloudFormation-Parameter gebundener Wert ist einer, den seine Einschränkungen zurückweisen)
Ein an einen Parameter gebundenes Literal wird gegen die Einschränkungen geprüft, die das Template für ihn deklariert — AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue und MaxValue —, dieselbe Prüfung, die CloudFormation an einem Wert vornimmt, der bei der Bereitstellung des Stacks übergeben wird, vorgezogen auf die Build-Zeit, sodass das Befüllen eines Parameters keine Prüfung entfernt, die das Template deklariert hat. Eine intrinsische Funktion und eine dynamische Referenz bleiben der Prüfung durch CloudFormation überlassen, da ihr Wert erst existiert, wenn der Stack bereitgestellt wird.
Ausgegebene Meldung. Die Bedingung steht vorn, dann der Parameter, sein Template und die Einschränkung; kein Wert wird zitiert:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (cloudformation-provider: der an den angegebenen Parameter des angegebenen Templates gebundene Wert erfüllt seine angegebene Einschränkung nicht, die CloudFormation bei der Bereitstellung des Stacks zurückweisen würde; binden Sie einen Wert, den der Parameter zulässt)
So beheben Sie es: Binden Sie einen Wert, den die Einschränkung zulässt; die eigene Deklaration des Parameters im Template listet auf, was er zulässt.
A secret bound to a CloudFormation parameter would be written into the template (Ein an einen CloudFormation-Parameter gebundenes Geheimnis würde in das Template geschrieben)
Ein an einen Parameter gebundener Wert wird in das Template geschrieben, wo jeder, der das Template des Stacks lesen kann, ihn lesen kann. Das Rendern hält bei einem Literal an, das an einen Parameter gebunden ist, den das Template als NoEcho deklariert, und, wo das valuesMapping des Recipe oder FeatureRecipe einen Wert liest, den ein Autor als sensibel deklariert hat, bei jedem Literal, das dieses Mapping bindet, da sich keine seiner Ausgaben auf den Wert zurückführen lässt, aus dem sie stammt. Eine dynamische Referenz und eine intrinsische Funktion werden so geschrieben, wie sie angegeben sind — einschließlich des Texts innerhalb einer intrinsischen Funktion —, daher erreicht ein sensibler Wert, den das Mapping in einen String Fn::Sub einfügt, das Template als dieser Text, und nur eine dynamische Referenz hält das Geheimnis selbst aus ihm heraus.
Ausgegebene Meldung. Die Bedingung steht vorn, dann die Parameter und das, was stattdessen zu binden ist; kein Wert wird zitiert. Eine der folgenden:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (cloudformation-provider: der angegebene Parameter des angegebenen Templates ist als NoEcho deklariert, und der an ihn gebundene Wert würde unverändert in das Template geschrieben; binden Sie stattdessen eine dynamische Referenz ({{resolve:secretsmanager:…}} oder {{resolve:ssm-secure:…}}) oder eine intrinsische Funktion, oder lassen Sie den Parameter für einen Wert zum Bereitstellungszeitpunkt ungebunden)
cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; … (cloudformation-provider: das valuesMapping des Recipe oder FeatureRecipe liest einen als sensibel deklarierten Wert, daher wird ein Literal, das es erzeugt, zurückgewiesen, und das Binden des oder der angegebenen Parameter, … würde ein Literal unverändert in das Template schreiben; …)
So beheben Sie es: Speichern Sie das Geheimnis in Secrets Manager oder als sichere Zeichenkette im Parameter Store und binden Sie eine dynamische Referenz, die darauf verweist — {{resolve:secretsmanager:<secret>}} oder {{resolve:ssm-secure:<name>}} —, statt es in den Text einer intrinsischen Funktion einzufügen, oder lassen Sie den Parameter für einen Wert ungebunden, der bei der Bereitstellung des Stacks übergeben wird. Siehe cloudformation → Werte für die Parameter eines als Quelle verwendeten Templates.
A dynamic reference is bound where CloudFormation does not resolve it (Eine dynamische Referenz ist dort gebunden, wo CloudFormation sie nicht auflöst)
CloudFormation löst eine dynamische Referenz in den Eigenschaften einer Ressource auf, aber nicht in EC2-Benutzerdaten und nicht in Metadaten AWS::CloudFormation::Init, und es zeigt die Outputs eines Templates jedem, der den Stack liest. Daher hält eine dynamische Referenz, die an einen Parameter gebunden ist, auf den irgendein Template der Quelle in einer Eigenschaft UserData, in diesen Metadaten oder in seinen Outputs verweist, das Rendern an, statt an eine Stelle zu gelangen, an der sie entweder nicht bereitgestellt werden kann oder offengelegt wird.
Ausgegebene Meldung. Die Bedingung steht vorn, dann der Parameter, das Template und die Stelle, an der dieses Template auf ihn verweist; kein Wert wird zitiert:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value (cloudformation-provider: der an den angegebenen Parameter gebundene Wert ist eine dynamische Referenz, und das angegebene Template verweist an der angegebenen Stelle auf den Parameter, wo CloudFormation eine dynamische Referenz nicht auflöst oder sie jedem zeigt, der den Stack liest; binden Sie stattdessen eine intrinsische Funktion, oder lassen Sie den Parameter für einen Wert zum Bereitstellungszeitpunkt ungebunden)
So beheben Sie es: Lassen Sie den Parameter ungebunden und übergeben Sie seinen Wert bei der Bereitstellung des Stacks, oder binden Sie eine intrinsische Funktion, die dort liefert, was das Template benötigt.
A rule reads a bound CloudFormation parameter by name (Eine Regel liest einen gebundenen CloudFormation-Parameter über seinen Namen)
Fn::ValueOf in den Rules eines Templates benennt einen Parameter über seine logische ID statt über Ref und liest den Wert, der für ihn bei der Bereitstellung des Stacks übergeben wird. Das Binden des Parameters entfernt seine Deklaration aus jedem Template der Quelle, was dazu führen würde, dass die Regel — in jedem dieser Templates — nichts benennt, daher hält das Rendern an.
Ausgegebene Meldung. Die Bedingung steht vorn, dann die Regel, ihr Template und der Parameter:
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy (cloudformation-provider: die angegebene Regel des angegebenen Templates liest den angegebenen Parameter über Fn::ValueOf, das einen deklarierten Parameter über seine logische ID benennt, und das Binden des Parameters entfernt seine Deklaration aus der Quelle; lassen Sie den Parameter ungebunden, damit die Regel ihn bei der Bereitstellung lesen kann)
So beheben Sie es: Entfernen Sie den Schlüssel des Parameters aus dem valuesMapping, damit der Parameter deklariert bleibt und die Regel den Wert liest, der bei der Bereitstellung des Stacks übergeben wird.
The assembled CloudFormation stack cannot carry a transform (Der assemblierte CloudFormation-Stack kann keine Transformation tragen)
Der Abschnitt Transform des assemblierten Stacks wird aus denen aller Komponenten gebildet, und eine Transformation verarbeitet das gesamte Template, daher wird eine Transformation, deren Wirkung nicht auf den für sie geschriebenen Inhalt beschränkt ist, zurückgewiesen, statt ändern zu dürfen, wie der Inhalt einer anderen Komponente bereitgestellt wird: AWS::CodeDeployBlueGreen und AWS::Include immer, ein Makro, das Ihr Konto definiert, und AWS::ServiceCatalog neben jeder anderen Komponente, AWS::LanguageExtensions neben dem Serverless-Inhalt einer anderen Komponente und AWS::Serverless-2016-10-31, wo seine Globals die Serverless-Ressourcen einer anderen Komponente erreichen würden oder eine seiner Ereignisquellen eine Ressource nennt, die eine andere Komponente deklariert. Die vollständige Tabelle steht in cloudformation → Abschnitte oberster Ebene im assemblierten Stack.
Ausgegebene Meldung. Die Bedingung steht vorn, dann jede Komponente im Stack, die Transformation und die Komponenten, die sie deklarieren, und warum sie nicht getragen werden kann:
a plugin has no expression for a construct this build declares (ein Plugin hat keinen Ausdruck für ein Konstrukt, das dieser Build deklariert) cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (cloudformation-provider: der assemblierte Stack der angegebenen Komponente, … kann die angegebene Transformation nicht tragen, die von der angegebenen Komponente deklariert wird: mit dem angegebenen Grund)
So beheben Sie es: Platzieren Sie die Komponente, die die Transformation deklariert, in einer eigenen Boundary, damit ihr Stack nichts enthält, was die Transformation ändern könnte; oder verschieben Sie, wo die Meldung Inhalt nennt, den eine andere Komponente deklariert, diesen Inhalt in die Komponente, die die Transformation deklariert.
Two components order one pair of transforms oppositely (Zwei Komponenten ordnen dasselbe Paar von Transformationen entgegengesetzt an)
Der assemblierte Stack führt seine Transformationen in einer einzigen Reihenfolge aus, die aus der eigenen Reihenfolge jeder Komponente und aus der von CloudFormation dokumentierten gebildet wird. Wo zwei Reihenfolgen nicht beide gelten können — zwei Komponenten, die dasselbe Paar von Transformationen in umgekehrter Reihenfolge auflisten, oder eine Komponente, die AWS::Serverless-2016-10-31 vor AWS::LanguageExtensions auflistet, was CloudFormation umgekehrt dokumentiert —, gibt es keine einzelne Reihenfolge, die geschrieben werden könnte, daher hält das Rendern an.
Ausgegebene Meldung. Die Bedingung steht vorn, dann das Paar und wer es in welcher Richtung angeordnet hat:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order (cloudformation-provider: die angegebenen Transformationen sind in beiden Richtungen angeordnet — die erste vor der zweiten durch den angegebenen Urheber und die zweite vor der ersten durch den angegebenen Urheber —, und das Transform des assemblierten Stacks führt sie in einer einzigen Reihenfolge aus; deklarieren Sie sie in einer einzigen Reihenfolge)
So beheben Sie es: Deklarieren Sie das Paar in jeder Komponente, die beide auflistet, in einer einzigen Reihenfolge und folgen Sie dabei der eigenen Reihenfolge von CloudFormation, wo es eine dokumentiert.
Two entries reach one stack output name (Zwei Einträge erreichen denselben Stack-Output-Namen)
Ein Stack-Output-Name lässt nur Buchstaben und Ziffern zu, daher wird er aus dem gebildet, was Sie geschrieben haben, indem die Zeichen, die dieses Alphabet nicht zulässt, codiert statt weggelassen werden. Zwei Einträge, die Sie unterschiedlich geschrieben haben, bleiben daher getrennt, und dieser Abbruch meldet den Fall, in dem zwei von ihnen trotzdem denselben Namen erreichen. Das Rendern hält an, statt einen einzigen Output auszugeben, wo zwei Einträge geschrieben wurden, was einen von ihnen stillschweigend verwerfen würde.
Jeder Name, hinter dem zwei oder mehr Einträge zusammengetroffen sind, wird gemeldet, und jeder Eintrag hinter jedem Namen wird genannt, in einer stabilen Reihenfolge — sodass ein Build Ihnen die ganze Kollision zeigt statt nur einer Seite davon.
Ausgegebene Meldung, die mit der Bedingung beginnt und mit dem eigenen Detail des Providers fortfährt:
two things a plugin produced occupy one name in its output (zwei Dinge, die ein Plugin erzeugt hat, belegen einen Namen in seiner Ausgabe) cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build (cloudformation-provider: zwei Einträge, die ein Autor geschrieben hat, erreichen denselben Stack-Output-Namen: die angegebenen zusammengetroffenen Einträge erreichen den angegebenen Output-Namen; ein Output-Name wird gebildet, indem die Komponente und der Eintrag in die Buchstaben und Ziffern codiert werden, die eine logische ID zulässt, statt das wegzulassen, was sie nicht zulässt, sodass zwei Einträge, die ein Autor getrennt geschrieben hat, getrennt bleiben — das Umbenennen eines der beiden Enden macht den Build frei)
So beheben Sie es: Benennen Sie einen der Einträge oder eine der Komponenten um, damit die beiden nicht mehr denselben Namen erreichen — die Meldung nennt beide Seiten. Der Name trägt die Interpunktion und die Groß- und Kleinschreibung, die Sie geschrieben haben, codiert statt weggelassen, daher bleibt ein Unterschied in einem der beiden darin erhalten, und zwei unterschiedlich geschriebene Einträge erhalten unterschiedliche Namen.
A CloudFormation fragment writes one key twice (Ein CloudFormation-Fragment schreibt einen Schlüssel zweimal)
Ein Mapping enthält einen Wert pro Schlüssel, daher würde ein Fragment, das denselben Schlüssel zweimal schreibt, den zuletzt gekommenen Inhalt behalten und den anderen verwerfen. Wo das Mapping der Block ist, der Ressourcen oder Outputs enthält, ist der verworfene Inhalt eine Ressource oder ein Output, die geschrieben wurde und nicht im Ergebnis stünde. Das Rendern hält stattdessen an.
Beide Stellen, an denen der Schlüssel geschrieben wurde, werden gemeldet, weil ein zweimal geschriebener Schlüssel meist aus zwei Bearbeitungen stammt, die zwei verschiedene Schlüssel sein sollten — und der Autor beide braucht, um zu erkennen, welcher zu ändern ist.
Ausgegebene Meldung, die mit der Bedingung beginnt und mit dem eigenen Detail des Providers fortfährt:
two things a plugin produced occupy one name in its output (zwei Dinge, die ein Plugin erzeugt hat, belegen einen Namen in seiner Ausgabe) cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once (cloudformation-provider: ein Mapping-Schlüssel ist mehr als einmal geschrieben: der angegebene Schlüssel ist in der angegebenen Zeile und erneut in der zweiten angegebenen Zeile geschrieben; ein Mapping enthält einen Wert pro Schlüssel, daher würde einer der beiden Inhalte verworfen — entfernen Sie einen, oder benennen Sie einen um, damit jeder Schlüssel einmal geschrieben ist)
So beheben Sie es: Öffnen Sie das Fragment an den beiden Zeilen, die die Meldung nennt. Wo die beiden Inhalte eine Sache sein sollten, entfernen Sie den nun überflüssigen; wo sie zwei sein sollten, benennen Sie einen um, damit jeder einen eigenen Schlüssel hat. Das Fragment ist ein Template, prüfen Sie daher den gerenderten Text statt nur der Quelle, wo ein Schlüssel zusammengesetzt statt wörtlich geschrieben wird.
A cross-boundary reference has no consuming stack to be written into (Eine Boundary-übergreifende Referenz hat keinen konsumierenden Stack, in den sie geschrieben werden kann)
Wo eine Abhängigkeitsverbindung zwischen zwei getrennt assemblierten Ausgaben verläuft, wird die konsumierende Seite mit einem Platzhalter gerendert, und die Referenz wird eingetragen, sobald beide Seiten existieren. Diese Bedingung ist das, was geschieht, wenn die assemblierte Ausgabe der konsumierenden Seite überhaupt kein Stack-Template enthält: Es gibt kein Dokument, in das die Referenz geschrieben werden könnte, daher kann der Platzhalter nicht ersetzt werden.
Ausgegebene Meldung. Die Bedingung nennt die Art des Fehlschlags, und der eigene Satz des Providers sagt, welche Eingabe:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) cloudformation-provider: cross-boundary link resolve received no consumer stack template (cloudformation-provider: die Auflösung der Boundary-übergreifenden Verknüpfung hat kein Stack-Template des Konsumenten erhalten)
So beheben Sie es: Nichts, was Sie innerhalb der konsumierenden Komponente schreiben, erzeugt dies — es ist die Gestalt dessen, was ihre Boundary assembliert hat. Prüfen Sie, ob die konsumierende Seite überhaupt vom CloudFormation-Provider gerendert wird: Eine Verbindung, die in eine Boundary führt, die etwas anderes assembliert, hat keinen Stack, in dem die Referenz landen kann, und die Verbindung gehört zwischen zwei Boundaries, die derselbe Provider assembliert. Wo beide Seiten CloudFormation sein sollten, hat die konsumierende Boundary kein Stack-Template erzeugt, was eine Frage für diejenigen ist, die die Recipes verfasst haben, die zu ihr beitragen.
A cross-boundary reference was spliced into a longer string (Eine Boundary-übergreifende Referenz wurde in einen längeren String eingefügt)
Ein CloudFormation-Querverweis ist ein Objekt statt Text, daher kann er einen Wert nur als Ganzes ersetzen. Diese Bedingung ist das, was ein Platzhalter meldet, der innerhalb eines größeren Strings gefunden wurde — ein Wert, der um ihn herum zusammengesetzt wurde, statt als das Ganze dessen geliefert zu werden, was injiziert wurde. Es gibt nichts, gegen das das Objekt ausgetauscht werden könnte, daher hält das Rendern an, statt eine Referenz in einer Form auszugeben, die das Ziel nicht lesen kann.
Ausgegebene Meldung. Die Bedingung steht vorn, dann der Wert und die Verbindung, über die er angekommen ist:
a plugin has no representation for a value it was given (ein Plugin hat keine Darstellung für einen Wert, der ihm übergeben wurde) cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>" (cloudformation-provider: der Wert der Boundary-übergreifenden Verknüpfung ist in einen größeren String interpoliert; nur eine Injektion eines ganzen Skalars kann eine stackübergreifende Referenz tragen: mit dem angegebenen Output-Schlüssel am angegebenen Socket)
So beheben Sie es: Liefern Sie den Wert als Ganzes, statt um ihn herum zusammenzusetzen. Wo die konsumierende Seite den Wert innerhalb eines längeren Strings benötigt — eines Verbindungsstrings, einer URL —, bilden Sie diese Zusammensetzung aus der Referenz im eigenen Vokabular des Ziels, statt im Template des Recipe, bevor die Referenz existiert. Das Mapping, das den Wert injiziert, ist die Stelle, an der das Einfügen geschieht, daher ist das die Zeile, die zu ändern ist.
Two rendered resources land at one output file (Zwei gerenderte Ressourcen landen in derselben Ausgabedatei)
Jede gerenderte Ressource wird in eine Datei geschrieben, deren Name sich daraus ergibt, was die Ressource ist und wie sie heißt. Zwei Ressourcen, die beides teilen, tragen denselben Dateinamen, daher würde eine den Platz der anderen belegen, und das Rendern hält an, statt eine einzige Datei auszugeben, wo zwei Ressourcen gerendert wurden.
Zwei Ressourcen, die identisch gerendert werden, sind keine Kollision. Wo der Inhalt Byte für Byte übereinstimmt, geht durch das Behalten einer von ihnen nichts verloren, und das Rendern läuft weiter — daher wird ein Template, das zweimal mit demselben Ergebnis eingebunden wird, nicht gemeldet.
Ausgegebene Meldung. Die Bedingung steht vorn, dann beide Templates, die sie erzeugt haben, und die Datei, in der sie zusammengetroffen sind:
two things a plugin produced occupy one name in its output (zwei Dinge, die ein Plugin erzeugt hat, belegen einen Namen in seiner Ausgabe) helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content (helm: im angegebenen Knoten: die angegebenen gerenderten Ressourcen, die eine und die andere, leiten beide die angegebene Ausgabe mit unterschiedlichem Inhalt ab: zwei gerenderte Ressourcen leiten denselben Ausgabedateinamen mit unterschiedlichem Inhalt ab)
So beheben Sie es: Geben Sie den beiden Ressourcen unterschiedliche Identitäten — der Name ist das, was sich meist unterscheidet, und der Dateiname folgt daraus. Die Meldung nennt beide Templates, öffnen Sie sie daher und prüfen Sie, was jedes erzeugt: Zwei Templates, die dieselbe Ressource unter einem Namen rendern, bedeuten oft, dass eines von ihnen eine ältere Kopie ist. Wo beide gewollt sind, sind es zwei Ressourcen, und jede braucht einen eigenen Namen.
A synthesized StatefulSet has no single service to govern it (Ein synthetisiertes StatefulSet hat keinen einzelnen Dienst, der es steuert)
Eine Workload, die Speicher pro Instanz deklariert, wird als StatefulSet gerendert, und ein StatefulSet nennt einen Dienst, der es steuert — denjenigen, der jeder Instanz ihre stabile Adresse gibt. Dieser Dienst ist derjenige, der ohne eigene Cluster-Adresse deklariert ist. Zwei Gestalten halten das Rendern an: keiner deklariert, sodass es nichts zu nennen gibt; und mehr als einer, sodass die Frage, welcher von ihnen steuert, keine Antwort hat. Beide würden ein StatefulSet erzeugen, das das Ziel zurückweist, daher hält das Rendern an, statt eines auszugeben.
Ausgegebene Meldungen. Beide melden dieselbe Bedingung — etwas, das der Provider benötigt und nicht in genau einen Wert auflösen konnte —, und der eigene Satz des Providers sagt, welche der beiden Gestalten vorlag. Jede wird unter einem Rahmen ausgegeben, der den Knoten nennt:
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (das synthetisierte StatefulSet benötigt einen steuernden Headless-Service (deklarieren Sie einen Dienst mit type: Headless); keiner gefunden: das synthetisierte StatefulSet hat keinen steuernden Headless-Service)
a plugin could not resolve something it requires to exactly one value (ein Plugin konnte etwas, das es benötigt, nicht in genau einen Wert auflösen) synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service (das synthetisierte StatefulSet deklariert mehr als einen Headless-Service; der steuernde Service ist mehrdeutig (deklarieren Sie genau einen Dienst mit type: Headless): das synthetisierte StatefulSet hat mehr als einen Headless-Service)
So beheben Sie es: Deklarieren Sie auf der Workload genau einen Dienst vom Typ Headless. Wo keiner deklariert ist, fügen Sie ihn hinzu — eine Workload mit Speicher pro Instanz braucht einen, und er ist es, der jeder Instanz eine Adresse gibt, die bei ihr bleibt. Wo mehr als einer deklariert ist, behalten Sie denjenigen, der steuern soll, und geben Sie den anderen einen gewöhnlichen Typ, oder entfernen Sie sie; ein zweiter Headless-Dienst ist meist einer, der nicht headless sein musste.
A plugin reported a failure it did not classify (Ein Plugin hat einen Fehlschlag gemeldet, den es nicht klassifiziert hat)
Ein Plugin, das einen Build anhält, meldet zwei Dinge: einen eigenen Satz, der sagt, was geschehen ist, und welche Art von Fehlschlag dieser Satz nennt. Die Arten sind eine kleine Menge, die der Compiler deklariert — ein Konstrukt ohne Ausdruck, eine Eingabe, die nicht in einen einzigen Wert aufgelöst werden konnte, zwei erzeugte Dinge, die einen Namen beanspruchen, ein Wert ohne Darstellung —, und diese Bedingung ist diejenige, die ein Plugin wählt, wenn sein Fehlschlag zu keiner von ihnen passt.
Sie ist ein Rückfall, kein Ziel. Ein Plugin, das zu ihr greift, wo eine der anderen Arten passt, sagt Ihnen weniger, als es weiß, und der Wortlaut sagt deutlich, dass das Plugin auf eine Klassifizierung verzichtet hat, und nicht bloß, dass etwas schiefgegangen ist — sodass ein übermäßig genutzter Rückfall erkennbar ist, statt von einer korrekten Meldung nicht zu unterscheiden zu sein.
Ausgegebene Meldung. Die Bedingung steht vorn, und der eigene Satz des Plugins folgt ihr:
a plugin reported a failure that none of the declared kinds names (ein Plugin hat einen Fehlschlag gemeldet, den keine der deklarierten Arten nennt) <the plugin's own sentence>
So beheben Sie es: Lesen Sie den eigenen Satz des Plugins, denn dort steht alles, was für Ihren Build spezifisch ist. Die Bedingung selbst sagt Ihnen nur, dass das Plugin keine Art dafür hatte. Wo das Plugin Ihres ist, wählen Sie die Art, die der Fehlschlag tatsächlich ist; wo nicht, ist der Satz das, was Sie demjenigen zitieren, der es veröffentlicht.
A plugin named a condition the socket does not declare (Ein Plugin hat eine Bedingung genannt, die der Socket nicht deklariert)
Ein Plugin meldet eine Bedingung, die dieser Compiler deklariert, statt eine eigene Nummer zu erfinden, daher ist der Bezeichner, der Sie erreicht, immer einer, für den aggrega explain eine Antwort hat. Dieser Abbruch ist das, was eine Meldung erzeugt, die irgendetwas anderes nennt: eine Nummer, unter der nichts registriert ist, eine Nummer, die zurückgezogen wurde, einen Kurzcode, der anders geschrieben ist als die Registrierung, in die er sich auflöst, oder ein Paar von Bezeichnern, die zwei verschiedene Bedingungen nennen.
Er hält an, statt die Meldung stillschweigend fallen zu lassen. Die Bezeichner zu verwerfen und die generische Bedingung für den Fehlschlag eines Plugins stehen zu lassen, würde einen Build erzeugen, der genau wie einer von einem Plugin aussieht, das überhaupt keine Bedingung genannt hat, sodass derjenige, der es beheben muss, nie erfahren würde, dass es etwas zu beheben gab. Stattdessen die angebotene Nummer zu melden, würde Ihnen einen Bezeichner geben, der sich in nichts auflöst.
Ihr Build erhält trotzdem, was ihn angehalten hat. Der Abbruch zitiert die beanstandete Nummer, sagt, warum sie sich in keine Bedingung auflöst, nennt die generischen Bedingungen, zu denen ein Plugin greift, wenn es keine bessere Identität hat, und reicht den eigenen Satz des Plugins unverändert durch.
Ausgegebene Meldung:
wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence> (wasm: das Gast-Plugin hat eine Bedingung genannt, die der Socket nicht deklariert: der Gast hat den angegebenen Wert genannt, mit dem angegebenen Grund, warum er sich in keine Bedingung auflöst; ein Plugin nennt eine Bedingung, die dieser Compiler deklariert, und greift zu einer der angegebenen generischen Bedingungen mit ihren Codes, wenn es keine bessere hat: gefolgt vom eigenen Satz des Plugins)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies — die Meldung des Plugins ist falsch, und der Fehlschlag, den es gemeldet hat, ist real. Handeln Sie nach dem eigenen Satz des Plugins, der der letzte Teil der Meldung ist. Wo das Plugin Ihres ist, melden Sie eine Bedingung, die dieser Compiler deklariert — eine der generischen Arten, die die Meldung aufführt, wo der Fehlschlag zu keiner der spezifischeren Bedingungen passt; wo das Plugin nicht Ihres ist, zitieren Sie die beanstandete Nummer demjenigen, der es veröffentlicht.
A source artifact is cached without a workspace root to anchor it (Ein Quellartefakt wird ohne ein Stammverzeichnis des Workspace zwischengespeichert, an dem es verankert ist)
Ein beschafftes Quellartefakt wird in einem Slot unterhalb des Artefakt-Cache des Workspace abgelegt, und der Pfad zu diesem Slot wird vom Stammverzeichnis des Workspace aus nach außen gebildet. Diese Bedingung meldet, dass das Stammverzeichnis leer ankommt, was den Slot-Pfad relativ ließe — aufgelöst gegen das Verzeichnis, in dem sich der Prozess gerade befindet, wenn die Bytes geschrieben werden, sodass der Cache an einem Ort landet, den niemand gewählt hat.
Es wird zurückgewiesen statt aufgelöst, weil ein an der falschen Stelle geschriebener Slot schlimmer ist als gar kein Slot: Spätere Lesevorgänge suchen im richtigen, finden nichts und beschaffen erneut, sodass Sie einen Cache sähen, der scheinbar nie etwas enthält, und nichts anderes, das auf den Grund hinweist.
Ausgegebene Meldung. Der eigene Satz der Bedingung eröffnet sie, und was das Artefakt identifiziert, folgt:
cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (cacheslot: leeres workspaceRoot (mit den angegebenen kind, url, chart und version))
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und keine Änderung an dem, was Sie schreiben, behebt es — das Stammverzeichnis des Workspace wird von dem geliefert, was den Build antreibt, und nicht in einem Katalog geschrieben. Führen Sie den Build innerhalb des Workspace aus, damit das Stammverzeichnis ermittelt statt als nichts übergeben wird. Wo Sie den Compiler aus eigener Software antreiben, übergeben Sie das Stammverzeichnis des Workspace ausdrücklich; ein Aufrufer, der den Cache tatsächlich relativ zum aktuellen Verzeichnis haben will, übergibt einen einzelnen Punkt, der angenommen wird und dies bewusst ausdrückt.
A value would place a cached file outside the cache (Ein Wert würde eine zwischengespeicherte Datei außerhalb des Cache ablegen)
Eine zwischengespeicherte Entität und ein zwischengespeichertes Quellartefakt liegen jeweils in einem Slot, den der Cache für sie benennt, und dieser Slot wird aus Werten zusammengesetzt: der Referenz der Entität und der Version, in die sie aufgelöst wurde, oder der Art, url, chart, module_subdir, Version und Digest einer Quelle. Jeder Wert nennt eine Position im Layout. Diese Bedingung meldet einen Wert, der das, was für ihn geschrieben wird, an eine andere Stelle als die von ihm genannte Position verschieben würde — neben einen anderen Slot oder ganz aus dem Cache hinaus —, und weist ihn zurück, bevor dort irgendetwas geschrieben oder gelesen wird.
Die meisten dieser Werte kommen von einer Stelle, die der Cache nicht kontrolliert: ein Inhalt, den eine Registry ausgeliefert hat, ein von der Festplatte zurückgelesener Datensatz, eine Koordinate, die der Autor eines Recipe oder FeatureRecipe geschrieben hat. Eine Version, die ein Pfad statt einer Version ist, ein Pfad in url oder ein module_subdir, der über seine Position hinaufsteigt, und eine Referenz, die sich in ein Verzeichnis aus Punkten auflöst, werden hier jeweils zurückgewiesen. Ein Wert, der ein einziges Verzeichnis nennt — und ein Pfad in url oder ein module_subdir, der an seiner Position oder darunter bleibt —, bleibt unberührt.
Ein module_subdir, der hinaufsteigt, wird zurückgewiesen, bevor irgendetwas abgerufen wird. Für eine Quelle git-repository nennt derselbe Wert auch das Verzeichnis des Repositorys, das der Pull archiviert, und einer, der über das Repository hinaufsteigt, würde den Pull die Dateien neben seinem Checkout lesen lassen. Daher beurteilt der Pull module_subdir, bevor er das Repository abruft, und weist einen hinaufsteigenden Wert mit dieser Bedingung zurück, wobei er ihn unter seinem Schlüssel zitiert: Nichts wird abgerufen, und nichts neben dem Checkout wird gelesen. Ein Backslash darin wird als Trennzeichen gelesen, wie ein Windows-Pfad ihn liest, daher wird ..\shared auf jedem Rechner zurückgewiesen, statt auf einem davon von neben dem Checkout gelesen zu werden; ein Trennzeichen am Anfang oder Ende des Werts wird entfernt, daher nennt /charts/appcharts/app.
Ausgegebene Meldung. Der eigene Satz der Bedingung eröffnet sie, dann folgen der Wert, wie er unter dem Schlüssel geschrieben wurde, unter dem er geschrieben wurde, und die Abhilfe:
a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one (ein Wert, aus dem ein Cache-Ort gebildet wird, würde zwischengespeicherte Dateien außerhalb der Stelle ablegen, die er im Cache nennt (die angegebene Version für die angegebene Entität). eine Version, ein Name, eine Art oder ein Host nennt ein einziges Verzeichnis des Cache, daher enthält er weder einen Schrägstrich noch einen Backslash und ist weder ein einfacher noch ein doppelter Punkt; ein URL-Pfad oder ein Modul-Unterverzeichnis darf Verzeichnisse unterhalb seiner Position nennen, darf aber nicht darüber hinaufsteigen. Korrigieren Sie den Wert dort, wo er geschrieben wurde, oder bitten Sie, wo eine Registry ihn ausgeliefert hat, deren Herausgeber, eine Version zu veröffentlichen, die einen wohlgeformten Wert trägt)
So beheben Sie es: Wo der Wert einer ist, den Sie geschrieben haben — source.version, url oder module_subdir eines Recipe oder FeatureRecipe —, korrigieren Sie ihn so, dass er ein einziges Verzeichnis nennt oder einen Pfad, der innerhalb seiner Position bleibt; die Meldung zitiert den Wert und den Schlüssel, aus dem er gelesen wurde. Wo eine Registry ihn ausgeliefert hat, trägt die veröffentlichte Entität eine Version oder eine Koordinate, die keine ist, was keine Änderung Ihrerseits beheben kann: Die Meldung nennt, was abgerufen wurde, und die Abhilfe liegt bei demjenigen, der sie veröffentlicht.
A path the operation writes leads through a link out of the directory it must stay inside (Ein Pfad, den der Vorgang schreibt, führt über einen Link aus dem Verzeichnis hinaus, in dem er bleiben muss)
Mehrere Vorgänge schreiben oder entfernen eigene Dateien, an Orten, die sie selbst ermitteln, statt an Orten, die Sie genannt haben: das Ausgabeverzeichnis eines Build und jede Datei, die er dort schreibt, sowie das Verzeichnis .trace, das ein Build mit Tracing ersetzt; das Lockfile eines Release und der Plugin-Vertrauenseintrag daneben, die ein Pull schreibt; die Datei entity.lock neben einer Entität, die aggrega pin schreibt und die ein Pull, der Quellen pinnt, neben jede Entität schreibt, die er pinnt; die Datei .aggrega-config.yaml des Workspace, wenn ein Befehl die Konfiguration des Workspace schreibt; der Artefakt-Cache und jeder seiner Teilbäume, die ein Pull füllt und aggrega cache clear und aggrega cache prune leeren; die Signatur-Bundles, die ein Pull in diesem Cache für jedes Artefakt aufbewahrt, dessen Signatur er geprüft hat; die Entwürfe, die aggrega import schreibt; die Plugin-Entitäten, die aggrega plugin gen-catalog unterhalb seines Ausgabeverzeichnisses schreibt; und die Markierung .aggrega/active-release, die der Sprachserver des Editors schreibt, wenn ein Standard-Release aufgezeichnet wird, sowie das Verzeichnis .aggrega, das sie enthält. Dasselbe gilt, gleich welche Oberfläche den Vorgang gestartet hat — die Befehlszeile, der Sprachserver des Editors oder die Werkzeuge eines Assistenten. Die Grenze des Workspace legt die Regel fest, die hier angewendet wird, sowie die Pfade, die absichtlich aus dem Workspace hinausreichen.
Jeder dieser Orte hat ein Verzeichnis, in dem er bleiben muss, und welches das ist, hängt von dem Verzeichnis ab, unter dem der Vorgang ihn zusammensetzt:
Der Workspace, für alles, was darin zusammengesetzt wird. Das ist der übliche Fall, und er gilt auch für ein von Ihnen genanntes Verzeichnis, das innerhalb des Workspace liegt. dist und .trace eines Build werden immer hier zusammengesetzt, unterhalb des Stammverzeichnisses des Workspace, gleich aus welchem Ordner der Build ausgeführt wird, und ebenso die Entwürfe eines Imports, der kein Ausgabeverzeichnis nennt.
Ein von Ihnen genanntes Verzeichnis, das außerhalb des Workspace liegt, für alles, was darunter zusammengesetzt wird: das Ausgabeverzeichnis, das Sie an aggrega plugin gen-catalog oder aggrega import übergeben; das Verzeichnis eines Release, das Sie nennen oder das die Workspace-Konfiguration nennt und das außerhalb des Workspace liegt, für das Lockfile und den Vertrauenseintrag daneben; und das Verzeichnis einer Entität, die Sie aggrega pin nennen, oder ein Katalogverzeichnis, das Sie mit --catalog nennen oder das die Konfiguration unter catalog_dirs aufführt, für die Datei entity.lock neben jeder Entität dort. Das Verzeichnis selbst wird so verwendet, wie Sie es genannt haben — in eines, das ein Link ist, wird hindurch geschrieben, dorthin, wohin es zeigt —, und was darunter geschrieben wird, bleibt darin.
Das Artefakt-Cache-Verzeichnis selbst, für alles, was darunter in den Cache geschrieben wird, und alles, was aggrega cache clear und aggrega cache prune dort entfernen — das Standardverzeichnis .aggrega/cache ebenso wie ein artifact_cache_dir, das die Konfiguration aus dem Stammverzeichnis des Workspace hinaufsteigend schreibt (../shared-cache). Eines der eigenen Verzeichnisse des Cache oder eine Datei darin, das ein Link ist, der aus dem Cache-Verzeichnis hinausführt, wird auch dort zurückgewiesen, wo er an eine andere Stelle innerhalb des Workspace führt, sodass nichts, was in den Cache geschrieben wird, und nichts, was ein Clear oder ein Prune entfernt, auf einer Datei außerhalb davon landet. Wo das Cache-Verzeichnis selbst liegt, wird zuerst beurteilt: Eines, das innerhalb des Stammverzeichnisses des Workspace geschrieben ist, wird überallhin verfolgt, wohin es innerhalb des Workspace führt, und zurückgewiesen, an den Workspace gebunden, wo es aus ihm hinausführt; eines, das aus dem Stammverzeichnis des Workspace hinaufsteigend geschrieben ist, wird so verwendet, wie Sie es genannt haben, und, falls es ein Link ist, hindurch dorthin geschrieben, wohin es zeigt.
Jeder dieser Orte wird geprüft, bevor dort irgendetwas geschrieben oder entfernt wird. Der tiefste existierende Teil des Pfads, mit jedem symbolischen Link auf dem Weg verfolgt, muss das Verzeichnis sein, in dem er bleiben muss, oder darunter liegen. Ein Link irgendwo auf dem Weg, der aus diesem Verzeichnis hinausführt — ein dist, das auf ein Verzeichnis anderswo verlinkt ist, ein Lockfile, das auf eine Datei in einem anderen Projekt verlinkt ist, ein .aggrega/cache, das auf ein mit anderer Arbeit geteiltes Verzeichnis verlinkt ist, ein Verzeichnis unterhalb eines gen-catalog-Ausgabeverzeichnisses, das woandershin verlinkt ist —, würde das Schreiben oder Entfernen außerhalb landen lassen, daher hält der Vorgang stattdessen an, und dieser Pfad bleibt genau so, wie er war. Am meisten zählt das für einen Build: Das Leeren und Neuschreiben eines Ausgabeverzeichnisses, das ein Link ist, würde sonst ein Verzeichnis an einer anderen Stelle auf dem Rechner löschen und neu schreiben.
Ein Link, der nirgendwohin führt, wird als das behandelt, was er ist — nicht als etwas, das existiert —, daher wird das Verzeichnis geprüft, das ihn enthält. Wo ein solcher Link ganz am Ende eines Pfads steht, den der Vorgang gleich anlegen wird, würde die Datei dort angelegt, wohin der Link zeigt, daher wird auch der Ort geprüft, auf den er zeigt. Ein Link, der irgendwohin innerhalb des Verzeichnisses zeigt, in dem der Pfad bleiben muss, wird wie üblich verfolgt.
Ausgegebene Meldung. Der eigene Satz der Bedingung eröffnet sie, dann der Pfad, den der Vorgang gerade schreiben oder entfernen wollte — writing oder removing sagt, welches von beiden —, das Verzeichnis, in dem er bleiben muss, der Link, auf den er auf dem Weg trifft, und der Ort, wohin dieser Link führt, dann die Abhilfe. Ein Build, dessen dist ein Link ist, der aus dem Workspace hinausführt, wird beim Ersten angehalten, das er berühren würde, dem Leeren der vorherigen Ausgabe:
a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again (ein Pfad, den dieser Vorgang schreibt oder löscht, führt über einen Link aus dem Verzeichnis hinaus, in dem er bleiben muss (Entfernen des angegebenen Pfads, der innerhalb des angegebenen Workspace bleiben muss; der angegebene Link führt zum angegebenen Ziel). in diesen Pfad wurde nichts geschrieben und nichts daraus entfernt. Entfernen Sie den Link oder lassen Sie ihn an einen Ort innerhalb des angegebenen Workspace führen, und führen Sie den Vorgang erneut aus)
Die Diagnose trägt keine Kategorie: Fehlerhaft ist die Anordnung auf der Festplatte, nicht ein Dokument, das Sie geschrieben haben.
So beheben Sie es: Entfernen Sie den Link, den die Meldung nennt, und führen Sie den Vorgang erneut aus, damit er an dieser Stelle ein echtes Verzeichnis oder eine echte Datei anlegt; oder lassen Sie den Link an eine Stelle innerhalb des Verzeichnisses führen, das die Meldung nennt, wo er verfolgt wird. Nichts in Ihren Entitätsdateien verursacht dies, und keine Änderung an dem, was Sie schreiben, behebt es.
A name the operation writes holds a part Windows cannot hold (Ein Name, den der Vorgang schreibt, enthält einen Teil, den Windows nicht aufnehmen kann)
Unter Windows erreichen manche Namen eine Datei nicht so, wie sie geschrieben sind. Ein Name, den Windows für ein Gerät reserviert — CON, PRN, AUX, NUL, CONIN$, CONOUT$, COM0 bis COM9 und LPT0 bis LPT9 sowie die Namen COM und LPT mit einer hochgestellten Eins, Zwei oder Drei —, benennt das Gerät statt einer Datei, in jeder Groß- und Kleinschreibung und gleich welche Dateiendung folgt, sodass nul, Aux.yaml und com1.txt allesamt Geräte sind. Und einen Teil eines Pfads, der auf einen Punkt oder ein Leerzeichen endet, kann Windows kürzen, statt ihn so zu behalten, wie er geschrieben ist. Einen solchen Namen zu schreiben, würde seine Bytes an einen anderen Ort legen als in die Datei, die er benennt.
Wo ein Vorgang daher auf einem Windows-Rechner im Begriff ist, unterhalb eines Verzeichnisses einen Namen zu schreiben, den er nicht selbst gewählt hat, wird ein Name, der einen solchen Teil enthält, zurückgewiesen, bevor irgendetwas geschrieben wird: ein Eintrag des Archivs, das ein Quellartefakt oder eine Katalogentität mitbringt, wenn der Cache das Archiv zum Lesen auslegt; eine Datei, die ein Build in sein Ausgabeverzeichnis rendert; ein Entwurf, den ein Importer an aggrega import zurückgibt, bei einem Probelauf wie bei einem Schreibvorgang; und das Dokument, das aggrega edit-document zurückschreibt, gleich welche Oberfläche die Bearbeitung angefordert hat. Jeder Teil des Namens wird beurteilt, wobei ein Backslash als Trennzeichen gelesen wird, so wie Windows ihn liest — also wird aux/x.yaml wegen seines Verzeichnisses aux zurückgewiesen, report. wegen seines abschließenden Punkts und .. \evil.yaml wegen seines ersten Teils, zwei Punkten und einem Leerzeichen. Eine Menge, die wegen eines einzigen Namens zurückgewiesen wird, schreibt keinen der anderen: Ein Archiv wird nicht ausgelegt, die Ausgabe eines Builds wird weder geleert noch geschrieben, und kein Entwurf erreicht die Festplatte.
Unter Linux und macOS werden dieselben Namen so geschrieben, wie sie benannt sind, und diese Bedingung wird nie ausgelöst. Ein Name, der aus dem Verzeichnis hinausführt, unterhalb dessen er geschrieben wird, ist ein anderer Fehler, der auf jeder Plattform mit der eigenen Meldung dieses Vorgangs zurückgewiesen wird, bevor diese Bedingung geprüft wird.
Ausgegebene Meldung. Der eigene Satz der Bedingung eröffnet sie, dann folgen der Name, der Teil, den Windows nicht aufnehmen kann, und das Verzeichnis, unterhalb dessen der Name geschrieben werden sollte, dann die Abhilfe:
a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. 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; rename that segment where the name is produced (ein Name, den dieser Vorgang schreibt, enthält ein Pfadsegment, das Windows nicht so aufnehmen kann, wie es geschrieben ist (der angegebene Name, sein Segment und das Verzeichnis). Er wurde nicht geschrieben. Windows reserviert Gerätenamen wie CON, PRN, AUX, NUL, COM1 und LPT1, in jeder Groß- und Kleinschreibung und gleich welche Dateiendung folgt, und behält ein Segment, das auf einen Punkt oder ein Leerzeichen endet, nicht so, wie es geschrieben ist; benennen Sie dieses Segment dort um, wo der Name erzeugt wird)
Die Diagnose trägt keine Kategorie: Der Name stammt von dem, was ihn erzeugt hat — dem Herausgeber eines Archivs, einem Recipe oder einer Bibliothek, einem Importer, dem Pfad, den eine Bearbeitung nennt —, statt aus einem einzelnen Dokument, dem der Compiler den Fehler zuordnet.
So beheben Sie es: Benennen Sie den Teil, den die Meldung nennt, dort um, wo der Name herkommt. Bei einem Archiveintrag ist das das veröffentlichte Quellartefakt oder die veröffentlichte Entität, die nur ihr Herausgeber ändern kann. Bei einer gerenderten Datei ist es der Ausgabename, den ihr ein Recipe oder eine ArtifactLibrary gibt; bei einem Entwurf der Importer, der ihn benannt hat; bei einer Bearbeitung der Pfad des Dokuments. Nichts am Windows-Rechner macht den Namen so, wie er geschrieben ist, verwendbar.
Bedingungen, die einen Build nicht abbrechen
Jede der obigen Bedingungen bricht einen Build ab. Manche Bedingungen tragen einen eigenen Kurzcode und eine eigene Meldung, ohne je einen abzubrechen, und sie sind hier katalogisiert, damit ein Code, den Sie in der Hand haben, immer zu etwas aufgelöst wird, von welcher Seite Sie auch gekommen sind.
Sie fallen in vier Arten, und den Unterschied zu kennen lohnt sich, bevor Sie nach einer Lösung suchen.
Ein Hinweis. Der Build meldet ihn und fährt fort, und die gerenderte Ausgabe ist dieselbe, ob Sie darauf reagieren oder nicht. Jeder wird vollständig in warnings.md erklärt — was ihn auslöst, an welcher Stelle der Kompilierung er gelesen wird, was er ausgibt und was dagegen zu tun ist —, und die folgenden Einträge nennen den Abschnitt, statt ihn hier zu wiederholen.
Eine Bedingung, die der Editor auffängt. Sie wird von der Editor-Integration selbst beantwortet und erreicht weder die Ausgabe eines Builds noch eine Diagnose.
Eine Schutzvorrichtung hinter einer früheren Zurückweisung. Die Regel, die sie schützt, wird vor ihr von einer Bedingung durchgesetzt, die sehr wohl abbricht, sodass ein Build zuerst auf die frühere trifft.
Eine Zurückweisung bei einem Befehl, der kein Build ist. Sie ist ein harter Abbruch mit einer echten Abhilfe — sie beendet den Befehl, der auf sie getroffen ist, und nichts wird veröffentlicht, geschrieben oder geändert —, aber keine Phase der Kompilierung erreicht sie, sodass kein Build sie meldet. Ein Artefakt veröffentlichen oder signieren, die Eingaben einer Entität pinnen, eine Registry hinzufügen, ein Dokument bearbeiten, eine fremde Quellbeschreibung in Entwurfs-Autorendateien umwandeln und einen ganzen Katalog prüfen — auf Korrektheit oder gegen die Veröffentlichungskonventionen — sind die Stellen, an denen man auf sie trifft, und jeder Eintrag nennt, zu welchem Befehl er gehört und wer die Lösung in der Hand hat.
An annotation binding declares one path in both pillar lists (Eine Annotationsbindung deklariert einen Pfad in beiden Säulenlisten)
Ein Hinweis. Eine Annotationsbindung eines Manifest nennt denselben Pfad in Punktnotation sowohl in ihrer Liste maps.infra als auch in ihrer Liste maps.values. Die Überschneidung zu deklarieren ist zulässig, und der Compiler überwacht sie nicht: Die Gleichstandsregel des Routings schickt den Pfad deterministisch über infra, wodurch die Seite values dieses Pfads vom Aggregate aus unerreichbar wird.
Seine Meldung beginnt so:
annotation binding declares one path in both pillar lists (eine Annotationsbindung deklariert einen Pfad in beiden Säulenlisten)
Er ist das, was Sie warnt, bevor ein Build auf den oben unter „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)“ beschriebenen Abbruch trifft — der Hinweis ist die frühe Oberfläche, jener Abbruch die durchsetzende. Der Lint wird unter „Binding-map-overlap lint (Lint für Überschneidungen der Bindungs-Maps)“ in warnings.md erklärt.
An attachment name is one edit from a declared slot (Ein Anbindungsname ist eine Bearbeitung von einem deklarierten Slot entfernt)
Ein Hinweis. Eine Komponente bindet ein Feature unter einem Namen an, der keiner der deklarierten Slots ihres Typs ist, aber nur eine einzige Bearbeitung von einem davon entfernt liegt — die Struktur, die ein Tippfehler in einem Slot-Namen annimmt. Eine Anbindung unter einem Namen, den kein Slot deklariert, ist zulässig, sodass nichts abbricht; was der Hinweis nennt, ist die Folge, nämlich dass die Anbindung eine freie Anbindung ist statt der Füllung des Slots, den Sie gemeint haben, und der Slot leer bleibt. An einer Verbindung ist derselbe Tippfehler nicht zulässig und führt stattdessen zum Abbruch, der den nahen Slot nennt; 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)“. Wo das Feature der Anbindung den selector: des nahen Slots erfüllt, wird der Hinweis nicht ausgelöst: Diese Zuordnung beurteilt der Abbruch unter „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)“, der sie meldet, wenn der Slot leer bleibt.
Seine Meldung beginnt so:
attachment name is a near miss for a declared slot (der Anbindungsname ist ein Beinahe-Treffer für einen deklarierten Slot)
Erklärt unter „Attachment-slot near-miss lint (Lint für beinahe passende Anbindungs-Slots)“ in warnings.md, mit der Zuordnungsschwelle und dem, was er bewusst nicht erfasst.
A uses: socket name is one edit from a declared socket (Ein Socket-Name ist eine Bearbeitung von einem deklarierten Socket entfernt)
Ein Hinweis. Der eigene Block uses: einer Komponente nennt einen Socket, den ihr Typ nicht deklariert, der aber nur eine einzige Bearbeitung von einem davon entfernt liegt. Ein Entwickler besitzt die Topologie, die das Aggregate deklariert, und darf einen Socket nennen, den der Katalog nicht vorgesehen hat, sodass ein Socket-Name, den der Typ nicht deklariert, auf dieser Oberfläche zulässig ist und nichts abbricht. Was der Hinweis nennt, ist die Folge: Der falsch geschriebene Name erzeugt eine eigene Ad-hoc-Verbindung, ohne Selektor und ohne kantenbezogenen Vertrag, während der Socket, den Sie gemeint haben, unverdrahtet bleibt.
Seine Meldung beginnt so:
uses socket name is a near miss for a declared socket (der uses-Socket-Name ist ein Beinahe-Treffer für einen deklarierten Socket)
Erklärt unter „Uses-socket near-miss lint (Lint für beinahe passende uses-Sockets)“ in warnings.md. Die beiden benachbarten Oberflächen, auf denen ein Socket-Name, der im usesSchema der besitzenden Entität fehlt, sehr wohl zum Abbruch führt, werden oben unter „uses: socket not declared in the owning entity’s usesSchema (Socket nicht im Socket-Schema der besitzenden Entität deklariert)“ behandelt.
A Recipe publishes a provides key its Component does not declare (Ein Recipe veröffentlicht einen Schlüssel, den seine Component nicht deklariert)
Ein Hinweis. Das an eine Komponente gebundene Recipe veröffentlicht unter provides: einen Schlüssel, den der Typ der Komponente in seinem Vertrag spec.schema.provides: nicht deklariert. Mehr zu veröffentlichen, als die Component deklariert, ist zulässig und bleibt zulässig — der Vertrag verlangt die Teilmenge und erlaubt die Obermenge. Was der Hinweis nennt, ist eine Folge, die von keiner der beiden Seiten aus sichtbar ist: Ein Konsument, der über eine Kante uses: liest, sieht den deklarierten Vertrag des Ziels, nicht das, was dessen Recipe ausgibt, sodass ein nicht deklarierter Schlüssel nicht geliefert wird und ein konsumierendes Template, das ihn liest, leer gerendert wird.
Seine Meldung beginnt so:
Recipe publishes a provides key its Component does not declare (das Recipe veröffentlicht einen provides-Schlüssel, den seine Component nicht deklariert)
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 führt zum Abbruch. Erklärt unter „Undeclared-provides-key lint (Lint für nicht deklarierte provides-Schlüssel)“ in warnings.md.
A declared parameter is read by nothing (Ein deklarierter Parameter wird von nichts gelesen)
Ein Hinweis. Ein Aggregate deklariert einen Eintrag unter spec.parameters:, und keine Referenz {{ .parameters.<key> }} im eigenen Text dieses Aggregate liest ihn, sodass die gerenderte Ausgabe dieselbe ist, was auch immer ein Release dafür liefert. Der Compiler überwacht nicht, welche Stellschrauben ein Autor freilegt, und ein Parameter darf berechtigterweise vor der Referenz deklariert werden, die ihn lesen wird, daher gibt dies einen Hinweis aus, statt abzubrechen.
Seine Meldung beginnt so:
declared parameter is read by no reference in the Aggregate (der deklarierte Parameter wird von keiner Referenz im Aggregate gelesen)
Erklärt unter „Unread declared-parameter warnings (Warnungen zu nicht gelesenen deklarierten Parametern)“ in warnings.md, einschließlich dessen, warum ein Standardwert keine Ausnahme ist und welche Referenzen das Lesen sehen kann und welche nicht.
A provider binding names a capability no plugin the build reads serves (Eine Provider-Bindung benennt eine Fähigkeit, die kein vom Build gelesenes Plugin bedient)
Ein Hinweis. Ein Eintrag plugins.providers nennt eine Fähigkeit und kein Plugin, und keines der Provider-Plugins, die der Build liest — in den Katalogverzeichnissen, im Compiler oder unter denen, die das Lockfile festhält —, bedient diese Fähigkeit. Das ist die Struktur, die eine falsch geschriebene Fähigkeit annimmt, und ein solcher Eintrag wird von nichts gelesen: Eine Bindung wird nur konsultiert, wenn ein Recipe ihre Fähigkeit anfordert, und eine, die kein Plugin nennt, wählt nichts aus, was die Auflösung der Fähigkeit nicht auch ohne sie auswählen würde.
Er gibt einen Hinweis aus, statt abzubrechen, weil der Build nicht sicher sein kann. Bindungen werden einmal für den ganzen Workspace geschrieben, während ein Build ein einzelnes Release betrifft, sodass das Plugin, das die Fähigkeit bedient, eines sein kann, das nur ein anderes Release liest. Der Eintrag, der ein Plugin nennt, wird anders beurteilt und bricht dort ab, wo er sicher falsch ist — siehe oben „A plugins.providers binding names a plugin that does not serve the capability (Eine Bindung benennt ein Plugin, das die Fähigkeit nicht bedient)“.
Seine Meldung beginnt so:
plugins.providers entry names a capability no provider-rendering plugin the build reads serves (der Eintrag plugins.providers nennt eine Fähigkeit, die kein vom Build gelesenes Provider-Rendering-Plugin bedient)
und fährt mit der Fähigkeit fort sowie mit einer bedienten Fähigkeit, die eine Bearbeitung entfernt ist, wo es eine gibt. Erklärt unter „Provider-binding unserved-capability warning (Warnung zu einer nicht bedienten Fähigkeit einer Provider-Bindung)“ in warnings.md.
An editor position falls outside the document (Eine Editor-Position liegt außerhalb des Dokuments)
Eine Bedingung, die der Editor auffängt. Editor-Funktionen, die davon abhängen, wo sich Ihr Cursor befindet — Gehe zu Definition, Hover, Vervollständigung —, ermitteln zuerst die Lage des Cursors in der geparsten Struktur des Dokuments. Diese Bedingung ist das, was dieser Schritt meldet, wenn die Position eine Zeile adressiert, die das Dokument nicht hat; das geschieht vorübergehend, während eine Bearbeitung im Gange ist und die vom Editor gesendete Position an einem Text gemessen wurde, über den das Dokument bereits hinaus ist.
Ihre Meldung lautet:
position out of range (Position außerhalb des gültigen Bereichs)
Sie erreicht keinen Build und keine Diagnose. Jede Funktion, die auf sie treffen kann, antwortet ohne Ergebnis, statt einen Fehler anzuzeigen; das ist das Verhalten, das das Editor-Protokoll verlangt: Eine Anfrage, die nicht beantwortet werden kann, liefert nichts zurück, und der Editor fragt nach dem nächsten Tastendruck erneut.
In Ihren Dateien gibt es nichts zu beheben, und in einem Build erscheint nichts. Eine Funktion, die nicht mehr reagiert, statt sich bei der nächsten Bearbeitung zu erholen, sollte als Defekt gemeldet werden.
The schema-merge step’s own input guard (Der eigene Eingabeschutz des Schritts zur Schemazusammenführung)
Ein Schutz, den ein Build nicht erreicht. Wenn eine Component oder ein Feature eine andere Entität erweitert und beide Schemas deklarieren, werden diese Schemas zu einem zusammengeführt. Die Bibliothek, die das Zusammenführen übernimmt, weist eine Eingabe zurück, die sie strukturell nicht zusammenführen kann:
merger: invalid merge input (merger: ungültige Eingabe für die Zusammenführung)
Er gehört zum Schritt des Zusammenführens, den ein Build sehr wohl erreicht, wann immer eine erweiternde Entität und ihre Basis beide Schemas deklarieren. Wovor er schützt, ist, eine leere Kette übergeben zu bekommen oder einen Ketteneintrag, dessen Schema fehlt — und der Aufrufer kann ihm keines von beiden übergeben: Er setzt die Kette nur aus Schemas zusammen, die er bereits als vorhanden festgestellt hat, und führt nur dann zusammen, wenn diese Kette nicht leer ist.
Der Schutz bleibt, weil er die Zurückweisung fehlerhafter Eingaben durch eine exportierte Bibliothek ist. Ihn zu entfernen, würde keinen Abbruch entfernen, den ein Build erreichen kann; es würde eine klare Zurückweisung in einen Absturz für einen Aufrufer außerhalb des Compilers verwandeln, der eine solche Eingabe übergibt, was in jeder Hinsicht schlechter ist.
Die Kette selbst ist nicht Sache dieses Schritts. Eine Kette, die eine Schleife bildet, und eine Kette, die über die Tiefengrenze hinausläuft, werden von dem einen Durchlauf über extends: zurückgewiesen, bevor irgendein Schema zusammengeführt wird — siehe oben „Cyclic extends chain (Zyklische extends-Kette)“ und „An extends: chain runs past the depth bound (Eine Erweiterungskette überschreitet die Tiefengrenze)“.
Er ist katalogisiert, weil er deklariert ist und einen eigenen Code trägt, sodass ein Code, den Sie in der Hand haben, aufgelöst wird. Nichts, was Sie verfassen können, erzeugt ihn, und auf ihn zu treffen würde bedeuten, dass die oben beschriebene Anordnung nicht mehr gilt — das sollte als Defekt gemeldet werden, statt es zu umgehen.
An explicit value displaced one an annotation supplied (Ein expliziter Wert hat einen von einer Annotation gelieferten verdrängt)
Ein Hinweis. Die annotationsgesteuerte Expansion verwandelt eine Annotation, die ein Aggregate oder ein Release trägt, in eine Feature-Anbindung mit eigener Konfiguration. Wo dieselbe Anbindung auch explizit geschriebene Konfiguration trägt — an der Komponente, in einem Geltungsbereich darüber oder im Release —, gewinnt der explizite Wert bei jedem Schlüssel, den beide abdecken. Das ist die beabsichtigte Regel, und die erzeugte Ausgabe ist nicht falsch, sodass der Build abgeschlossen wird. Was der Hinweis nennt, ist die Folge: Der Beitrag der Annotation zu diesem Schlüssel ist nirgendwo in der Ausgabe mehr sichtbar, und der Autor, der die Annotation geschrieben hat, weiß möglicherweise nicht, dass er unterdrückt wurde.
Er meldet jede Verdrängung, nicht nur die, die etwas verändert haben. Die Zusammenführung überschreibt den unterdrückten Wert, sodass kein Vergleich mehr anzustellen ist und nichts sagen könnte, ob die beiden übereinstimmten — die Aufzeichnung, dass eine Verdrängung stattgefunden hat, ist der gesamte Nachweis. Er wird gelesen, sobald die gesamte Anbindungskaskade und die Expansion zusammengeführt wurden, was der früheste Punkt ist, an dem diese Aufzeichnung existiert.
Seine Meldung beginnt so:
annotation contribution overridden by an explicit value (Beitrag der Annotation durch einen expliziten Wert überschrieben)
und fährt mit der verdrängten Annotation fort, dann mit den Koordinaten des Schlüssels, der sie verdrängt hat, dann damit, wo die verdrängte Annotation geschrieben wurde. Die vorangestellte Position ist das Dokument, in dem der Befund liegt, und der Schlüssel darin:
<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>") (in der angegebenen Datei, am angegebenen Schlüssel: Beitrag der Annotation durch einen expliziten Wert überschrieben (Annotation, Komponente, Anbindung, Säule, betroffener Schlüssel und Ort der Deklaration der Annotation angegeben))
Zwei dieser Werte werden leicht missverstanden. Der Wert component wird nur genannt, wo der verdrängende Eintrag eine Komponente hat: Ein Eintrag, der für einen ganzen Geltungsbereich geschrieben ist, hat keine eigene Komponente, und eine zu nennen, die er nie hatte, würde einen Leser zu einem Schlüssel schicken, den niemand geschrieben hat. Und annotation declared at nennt, wo die verdrängte Annotation geschrieben wurde; das ist der Geltungsbereich, von dem sie geerbt wurde, wo immer sie nicht an der Komponente geschrieben wurde, die sie verdrängt hat — es ist also nicht der Komponentenschlüssel, unter einer anderen Beschriftung wiederholt.
Was zu tun ist: nichts, wo der explizite Wert das ist, was Sie gemeint haben. Der Hinweis existiert, damit die Rangfolge eine Entscheidung ist statt einer Überraschung. Wo es nicht das ist, was Sie gemeint haben, gibt es zwei Möglichkeiten, und sie unterscheiden sich in ihrer Reichweite. Löschen Sie den expliziten Eintrag, und der Wert der Annotation gelangt bis zu diesem Schlüssel. Oder entfernen Sie die Annotation von der Komponente oder dem Geltungsbereich, der sie trägt, und es wird überhaupt kein Beitrag geleistet — was auch jeden anderen Schlüssel betrifft, den diese Annotation liefert. Wo beide Seiten gewünscht sind, aber für verschiedene Schlüssel, schränken Sie diejenige ein, die weiter reicht als beabsichtigt, sodass sich die beiden nicht mehr überschneiden.
A connection crosses between two different providers’ assembled outputs (Eine Verbindung verläuft zwischen den assemblierten Ausgaben zweier verschiedener Provider)
Wo die beiden Enden einer Abhängigkeitsverbindung in verschiedene Ausgaben assembliert werden, verdrahtet ein Provider, der Boundary-übergreifende Verknüpfung anbietet, sie nativ — er veröffentlicht eine Referenz auf der produzierenden Seite und löst sie auf der konsumierenden auf. Diese Verdrahtung ist im eigenen Vokabular eines Providers geschrieben, und ein Provider kann keine Referenz auflösen, die ein anderer veröffentlicht hat. Eine Verbindung, deren beide Enden über verschiedene Provider gerendert werden, wird daher von keinem der beiden verdrahtet.
Dies gibt einen Hinweis aus und bricht den Build nicht ab. Die Verbindung trägt weiterhin ihren Wert: Der Injektionsvertrag leitet den Skalar der produzierenden Seite genau so zur konsumierenden Seite weiter wie überall sonst, sodass eine funktionierende, auf gewöhnliche Weise verdrahtete Verbindung bestehen bleibt statt einer defekten. Was der Befund Ihnen sagt, ist, dass die native Verdrahtung, die Sie vielleicht erwartet haben, nicht stattgefunden hat — und die Ausgabe ist unverändert, ob Sie darauf reagieren oder nicht.
Ein Provider, der Verknüpfung anbietet, genügt für eine Meldung. Beide Enden müssen sie nicht beanspruchen: Ein Anspruch bedeutet, dass die native Verdrahtung erwartet wurde und unmöglich ist, und der Autor, der diesen Provider angebunden hat, ist derjenige, der sie wollte. Beide Ansprüche zu verlangen, würde im üblichen gemischten Release, in dem ein Provider verknüpft und der andere nicht, nichts melden — und genau für diesen Fall ist dies da.
Wo die Enden platziert wurden, spielt keine Rolle. Eine assemblierte Ausgabe wird durch ihren Pfad und ihren Provider gemeinsam identifiziert, sodass zwei Enden, deren Provider sich unterscheiden, immer in verschiedenen Ausgaben liegen, wie auch immer sie platziert sind. Gelesen werden die beiden Provider und ihre beiden Ansprüche.
Er wird einmal pro solcher Verbindung gemeldet, positioniert an dem Dokument und dem Schlüssel, in dem die Verbindung geschrieben wurde.
Ausgegebene Meldung, die mit dem entfernten Ende beginnt und dann den Socket und den Provider jedes Endes nennt:
cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (Boundary-übergreifende Verknüpfung zwischen Endpunkten, die von verschiedenen Providern gerendert werden, wird nicht unterstützt (Zielkomponente, Socket, Provider des Konsumenten und Ziel-Provider angegeben))
So beheben Sie es: Wo der skalare Wert, den die Verbindung bereits trägt, genügt, ist nichts zu tun — dies ist eine Mitteilung, kein Fehler. Wo die native Verdrahtung gewünscht ist, müssen die beiden Enden über einen Provider gerendert werden: Verschieben Sie ein Ende in eine Boundary, die über den Provider des anderen läuft, oder bedienen Sie beide Fähigkeiten mit einem. Wo keines von beidem möglich ist, ist die wertübertragende Form das, was das Release hat, und die Verbindung funktioniert.
A command-line plugin runner was built without a way to find plugins (Ein Befehlszeilen-Plugin-Runner wurde ohne eine Möglichkeit gebaut, Plugins zu finden)
Ein Plugin, das einen Terminalbefehl beisteuert, wird von einer Komponente ausgeführt, die zuerst die Referenz des Plugins in Bytes umwandeln muss. Diese Bedingung meldet, dass diese Komponente ohne den Teil gebaut wurde, der die Umwandlung vornimmt, sodass es keinen Weg von der Referenz zu etwas Ausführbarem gibt.
Sie betrifft einen Terminalbefehl statt eines Builds, sodass keine Phase der Kompilierung sie erreicht: Sie wird dort ausgelöst, wo ein installierter Befehl weitergeleitet wird, und die Antwort, die sie erzeugt, ist, dass dieser Befehl nicht startet, statt eines Abbruchs in irgendeinem Build.
Kein Pfad im ausgelieferten Befehlszeilenwerkzeug kann sie auslösen. Jede Stelle, an der das Werkzeug diese Komponente baut, liefert die Nachschlagefunktion mit, sodass der Schutz nur greift, wo etwas anderes sie baut und die Nachschlagefunktion weglässt.
Ausgegebene Meldung, die der eigene Satz der Bedingung ist:
cliplugin: no plugin resolver configured (cliplugin: kein Plugin-Resolver konfiguriert)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und nichts, was Sie in einen Katalog oder einen Workspace schreiben können, behebt es. Wo Sie das veröffentlichte Befehlszeilenwerkzeug ausführen, ist dies keine Bedingung, die Sie erreichen können — ein installierter Befehl, der nicht startet, meldet etwas anderes, und die Meldung, die er ausgegeben hat, ist die, die Sie lesen sollten. Wo Sie den Plugin-Runner in eigene Software einbetten, liefern Sie beim Erstellen die Nachschlagefunktion mit, die eine Plugin-Referenz in ihre Bytes auflöst.
A registry alias is already bound to another host (Ein Registry-Alias ist bereits an einen anderen Host gebunden)
Eine Zurückweisung beim Hinzufügen einer Registry zum Workspace, nicht bei einem Build. Ein Alias ist ein Kurzname, der einen Registry-Eintrag auswählt, daher ist er über alle Einträge hinweg eindeutig. Einen Alias zu registrieren, den bereits ein anderer Host hält, wird zurückgewiesen, statt zuzulassen, dass er die bestehende Bindung verdeckt, was stillschweigend ändern würde, wohin jede Referenz zeigt, die diesen Alias verwendet.
Den selben Host unter seinem bestehenden Alias erneut hinzuzufügen, ist kein Konflikt — das aktualisiert den Eintrag an Ort und Stelle, was das erneute Ausführen des Befehls zum Ändern der anderen Einstellungen eines Hosts bewirkt.
Ausgegebene Meldung, die den Alias und den Host nennt, der ihn bereits hält:
workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host (workspaceconfig: der angegebene Registry-Alias wird bereits vom angegebenen Host verwendet; wählen Sie einen anderen Alias oder sprechen Sie diesen Host direkt an: Registry-Alias wird bereits von einem anderen Host verwendet)
So beheben Sie es: Die Behebung liegt beim Operator, auf der Befehlszeile. Geben Sie der neuen Registry einen anderen Alias, oder lassen Sie sie ohne Alias und verweisen Sie über den Host auf sie. Wo Sie den Alias auf den neuen Host verschieben wollten, entfernen Sie ihn zuerst aus dem Eintrag, den die Meldung in .aggrega-config.yaml nennt — die Zurückweisung existiert, damit das Verschieben eines Alias etwas ist, das Sie absichtlich tun, statt ein Nebeneffekt des Hinzufügens einer Registry.
A registry serves a trust document that cannot be read as one (Eine Registry liefert ein Vertrauensdokument, das nicht als solches gelesen werden kann)
Eine Zurückweisung beim Hinzufügen einer Registry, nicht bei einem Build. Eine Registry kann die Signaturidentitäten veröffentlichen, mit denen sie Artefakte signiert erwartet, damit das Hinzufügen der Registry sie pinnen kann, statt dass ein Operator sie abschreiben muss. Diese Bedingung meldet eine Registry, die mit einem Dokument geantwortet hat, das als Vertrauensrichtlinie nicht verwendbar ist.
Sie ist gerade deshalb eine harte Zurückweisung, weil der Endpunkt geantwortet hat. Eine Registry, die nichts veröffentlicht, ist ein gewöhnliches, erwartetes Ergebnis, das toleriert wird; eine, die etwas Unlesbares veröffentlicht, ist eine Fehlkonfiguration, und nichts daraus zu pinnen, würde die Registry stillschweigend ungepinnt lassen, während es so aussähe, als wäre sie gepinnt worden.
Drei Strukturen werden hier gemeldet: Inhalt, der sich überhaupt nicht dekodieren lässt, einschließlich eines Dokuments mit einem Feld, das das Format nicht definiert; ein Identitätseintrag, der weder eine exakte Identität noch ein Muster nennt; und ein Identitätseintrag ohne Aussteller. Die letzten beiden werden zurückgewiesen, weil ein solcher Eintrag niemals zu einer Signatur passen kann, sodass er das Pinning schwächen würde, während er es scheinbar stärkt.
Ausgegebene Meldungen. Inhalt, der sich nicht dekodieren lässt:
registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: die bekannt gegebene Vertrauenskonfiguration ist fehlerhaft, gefolgt von dem, was der Decoder gemeldet hat)
ein Identitätseintrag, der nichts hat, woran er abgeglichen werden kann:
registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: die bekannt gegebene Vertrauenskonfiguration ist fehlerhaft: in der angegebenen Liste am angegebenen Index muss ein Identitätseintrag identity oder identity_regexp setzen)
und einer ohne Aussteller:
registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: die bekannt gegebene Vertrauenskonfiguration ist fehlerhaft: in der angegebenen Liste am angegebenen Index muss ein Identitätseintrag issuer setzen)
Jede wird von dem Befehl eingerahmt, der auf sie getroffen ist:
So beheben Sie es: Die Behebung liegt bei dem, der die Registry betreibt, nicht bei Ihnen — geben Sie ihm die Meldung weiter, denn sie nennt den genauen Eintrag und was ihm fehlt. Um in der Zwischenzeit fortzufahren, fügen Sie die Registry hinzu, ohne ihre bekannt gegebene Richtlinie zu pinnen, und liefern Sie die Identitäten oder den Schlüssel selbst; der Befehl nimmt sie direkt entgegen, was Sie auch bei einer Registry tun, die überhaupt keine Richtlinie veröffentlicht.
A registry publishes no trust document (Eine Registry veröffentlicht kein Vertrauensdokument)
Ein gewöhnliches, erwartetes Ergebnis statt eines Fehlers, und es hält nichts an. Eine Registry kann die Signaturidentitäten veröffentlichen, die sie erwartet, und die meisten tun es nicht. Nach einem solchen Dokument gefragt, antwortet eine solche Registry, dass sie keines hat, und das Hinzufügen der Registry geht weiter — das Ergebnis wird als Mitteilung gemeldet, und die Identitäten werden stattdessen von Hand gepinnt.
Es ist bewusst von einer Registry unterschieden, die nicht erreicht werden konnte. Diese hat geantwortet; die Antwort war, dass sie keine Richtlinie veröffentlicht. Die beiden auseinanderzuhalten, ermöglicht es, ein bewusstes Fehlen zu tolerieren, während ein Erreichbarkeitsproblem weiterhin als solches sichtbar bleibt.
Als Mitteilung gemeldet, die die Registry nennt, was sie geantwortet hat und was stattdessen zu tun ist:
Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (Mitteilung: der angegebene Host veröffentlicht keine Vertrauensrichtlinie (HTTP 404); pinnen Sie sein Vertrauen von Hand mit —identity oder —key)
Die Bedingung, unter der es erfasst wird, ist registrytrust: registry advertises no trust config.
Der offizielle Hub ist die Ausnahme: Er bringt eine integrierte Baseline mit, sodass dort, wo er kein Dokument veröffentlicht, stattdessen diese Baseline gepinnt wird, und die Mitteilung sagt, was der Hub geantwortet hat und dass die Baseline an seiner Stelle verwendet wird, statt Sie aufzufordern, Identitäten zu pinnen.
So beheben Sie es: Nichts ist kaputt. Wenn Sie möchten, dass Signaturen dieser Registry geprüft werden, liefern Sie die Identität oder den Schlüssel beim Hinzufügen, genau wie die Mitteilung sagt — das ist der normale Weg für eine Registry, die keine Richtlinie veröffentlicht. Wenn nicht, wird die Registry ohne Signaturhaltung hinzugefügt, und Artefakte aus ihr werden nur dann verifiziert, wenn sie eine Signatur tragen.
A registry is added offline with no trust policy to pin (Eine Registry wird offline ohne eine zu pinnende Vertrauensrichtlinie hinzugefügt)
Eine Zurückweisung beim Hinzufügen einer Registry, nicht bei einem Build. Das Hinzufügen einer Registry ist der eine Moment, in dem ihr Vertrauen gepinnt wird: Die Signaturidentitäten, die sie bekannt gibt, werden einmal abgerufen, und jeder spätere Pull prüft gegen diese gepinnte Kopie. Ist der Workspace offline, kann dieser Abruf nicht erfolgen, sodass die Registry nie gefragt wird. Statt einen Eintrag zu schreiben, der nichts vertraut — und an den jeder spätere Pull die Registry binden würde —, wird das Hinzufügen einer anderen Registry als des offiziellen Hubs zurückgewiesen, sofern Sie die Richtlinie nicht selbst angeben.
Drei Fälle werden nicht zurückgewiesen. Die Angabe von Identitäten oder eines Schlüssels registriert genau diese und führt überhaupt keinen Abruf aus, sodass es offline genauso funktioniert wie online. Der offizielle Hub wird mit seiner integrierten Baseline hinzugefügt, die er mitbringt, ob der Abruf erfolgt oder nicht. Und wer keinen Abruf verlangt — --fetch-trust=false —, registriert den Eintrag aus den Flags, genau wie online.
Man trifft überall darauf, wo eine Registry hinzugefügt wird: aggrega registry add, aggrega config init --registry <host>, die Anfragen aggrega/registryAdd und aggrega/configInit von aggrega serve, deren Fehlermeldung den Kurzcode vor dem Satz trägt, und die Registrierungswerkzeuge von aggrega mcp, die diese Befehle ausführen. Das Anlegen einer Konfiguration nimmt weder Identitäten noch einen Schlüssel entgegen, sodass es offline nur den Hub eintragen kann; fügen Sie jede andere Registry stattdessen mit aggrega registry add hinzu.
Ausgegebene Meldung, die der eigene Satz der Bedingung ist:
a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with aggrega registry add <host> --identity <identity>=<issuer> or --key <public-key-file> (eine andere Registry als der offizielle Hub wird offline nicht ohne eine von Hand angegebene Vertrauensrichtlinie registriert, weil die Richtlinie, die sie bekannt gibt, nicht abgerufen werden kann; registrieren Sie sie einmal, während Sie online sind, oder pinnen Sie ihr Vertrauen von Hand mit einer Identität und ihrem Aussteller oder mit einer Public-Key-Datei)
eingerahmt von dem Befehl, der auf sie getroffen ist, und der Registry, die sie nennt:
aggrega registry add: <host>: <the message above> (aggrega registry add: der angegebene Host, dann die obige Meldung)
So beheben Sie es: Registrieren Sie die Registry einmal, während der Workspace online ist — übergeben Sie --offline=false für diesen einen Lauf, oder entfernen Sie die Einstellung offline —, damit ihre bekannt gegebene Richtlinie abgerufen und gepinnt wird; danach muss nichts wiederholt werden, da spätere Pulls gegen die gepinnte Kopie prüfen. Wo Sie nicht online gehen können, geben Sie die Richtlinie von Hand an: einen oder mehrere Einträge --identity <identity>=<issuer> für eine schlüssellose Registry oder --key, das auf ihre Public-Key-Datei verweist, für eine Registry mit Schlüssel — das, was Sie aus ihrer Bekanntgabe gepinnt hätten.
A tag is already published with different content (Ein Tag ist bereits mit anderem Inhalt veröffentlicht)
Eine Zurückweisung beim Veröffentlichen, nicht bei einem Build. Veröffentlichte Bytes sind eingefroren: Bevor irgendetwas hochgeladen wird, wird die Zielversion nachgeschlagen und der Digest, auf den sie zeigt, mit dem Digest verglichen, den der vorliegende Inhalt ergeben würde. Eine Version, die bereits auf anderen Inhalt zeigt, wird zurückgewiesen.
Byte-identischen Inhalt erneut zu veröffentlichen, ist kein Konflikt. Die Digests stimmen überein, nichts wird hochgeladen, und der Befehl meldet, dass die Version bereits veröffentlicht ist — eine teilweise gelungene Veröffentlichung erneut auszuführen, ist also sicher und vervollständigt die Veröffentlichung: Das Veröffentlichungsdatum, das der Version noch fehlt, und ihre Signatur, wo der Push signiert, werden angehängt, und eine Version, der keines von beiden fehlt, erhält nichts, wie Eine Veröffentlichung vervollständigen, die ein früherer Push unvollständig gelassen hat beschreibt.
Es gibt kein Flag, das dies außer Kraft setzt. Geänderter Inhalt wird unter einer neuen Version veröffentlicht; das lässt Konsumenten eine Version, zu der sie bewusst wechseln können, statt einer Version, die sich unter ihnen verändert hat.
Ausgegebene Meldungen, die die Version, den Digest, den sie hält, und den angebotenen Digest nennen. Beim Veröffentlichen einer Katalogentität, wobei auch die Prüfung genannt wird, die die Versionserhöhung verifiziert:
aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content (aggrega push: die angegebene Version ist bereits mit dem angegebenen vorhandenen Digest veröffentlicht; das Überschreiben mit dem vorgeschlagenen Digest wird verweigert — veröffentlichen Sie eine neue Version (aggrega lint —pre-publish verifiziert die Erhöhung): oci: Tag bereits mit anderem Inhalt veröffentlicht)
und beim Veröffentlichen eines Datenartefakts:
aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content (aggrega push-artifact: die angegebene Version ist bereits mit dem angegebenen vorhandenen Digest veröffentlicht; das Überschreiben mit dem vorgeschlagenen Digest wird verweigert — veröffentlichen Sie eine neue Version: oci: Tag bereits mit anderem Inhalt veröffentlicht)
So beheben Sie es: Erhöhen Sie die Version und veröffentlichen Sie erneut. Bei einer Katalogentität bedeutet das metadata.version und das versionsbezogene Verzeichnis, in dem die Entität liegt, die sich gemeinsam ändern. Prüfen Sie vorher, ob die Änderung beabsichtigt ist: Weichen die beiden Digests bei einer Version ab, die Sie Ihrer Meinung nach nicht angefasst haben, dann ist der Inhalt auf der Festplatte nicht der Inhalt, der veröffentlicht wurde, und herauszufinden, warum, ist mehr wert, als darüber zu veröffentlichen. Die in der Meldung genannte Prüfung vor der Veröffentlichung vergleicht eine Version mit der vorherigen und ist der Weg, um zu bestätigen, dass die Erhöhung richtig ist.
An entity shares its directory with another entity (Eine Entität teilt ihr Verzeichnis mit einer anderen Entität)
Eine Zurückweisung beim Pinnen und beim Veröffentlichen, nicht bei einem Build. Jeder Entitätstyp hat ein eigenes Verzeichnis, außer den dreien, die ein Workspace-Stammverzeichnis nebeneinander enthält: ein Aggregate, ein Release und ein Manifest. Eine veröffentlichte Entität ist ein Artefakt an einer Koordinate pro Version, und das Verzeichnis, in dem sie verfasst wird, spiegelt das wider — der Pin-Schritt schreibt die eine Datei entity.lock, für die ein Verzeichnis Platz hat, und eine Veröffentlichung verpackt die Entität aus ihrem Verzeichnis. Daher wird eine Entität jedes anderen Typs mit einer anderen Entität daneben zu beiden Zeitpunkten zurückgewiesen: von aggrega pin, von einem Pull oder Push, der im Auftrag des Autors pinnen soll, und von aggrega push, ob er pinnt oder nicht. Sie wird zurückgewiesen, bevor irgendetwas abgerufen wird, und nichts wird geschrieben.
Ein Verzeichnis mit mehreren Entitäten wird trotzdem geladen, gelintet, validiert und gebaut. Das Layout wird erst beurteilt, wenn etwas aus dem Verzeichnis erzeugt wird; das ist auch der Moment, in dem die Meldung die im Weg stehende Entität nennen kann. Ein Pull, der nicht pinnt, schreibt nichts neben die Entität und wird nicht zurückgewiesen.
Als Entität daneben gilt jedes andere YAML-Dokument direkt im selben Verzeichnis, dessen kind: ein Entitätstyp ist. Die eigenen Dateien eines Charts, ein Compose-Fragment, ein Kubernetes-Manifest oder ein README sind keine Entitäten, und ein Unterverzeichnis — ein lokales Chart, ein Baum source/ — liegt nicht neben der Entität, gleich was es enthält. Von jedem Nachbarn werden nur Typ und Name gelesen, sodass nichts, was ein Nachbar deklariert, die Antwort ändern kann.
Der Name des Verzeichnisses wird nicht beurteilt. Eine Entität, die allein in ihrem Verzeichnis liegt, wird in der Version gepinnt und veröffentlicht, die sie deklariert, wo auch immer dieses Verzeichnis liegt; das Layout <name>/<version>/, das der Katalog der Standardbibliothek verwendet, ist eine Konvention und keine Prüfung.
Ausgegebene Meldung, die die Entität, jede Entität daneben und die zu verschiebenden Dateien nennt:
the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities (die Entität teilt ihr Verzeichnis mit einer anderen Entität, und eine Entität ihres Typs hat ein eigenes Verzeichnis (das angegebene Recipe, daneben das angegebene Recipe in der angegebenen Datei). Abhilfe: Geben Sie jeder Entität ein eigenes Verzeichnis — verschieben Sie die angegebene Datei in ein eigenes Verzeichnis, zusammen mit jeder Datei, die nur diese Entität liest; nur die Typen Aggregate, Manifest und Release dürfen ein Verzeichnis mit anderen Entitäten teilen)
So beheben Sie es: Verschieben Sie jede Entität, die die Meldung nennt, in ein eigenes Verzeichnis und nehmen Sie die Dateien mit, die nur sie liest — ein lokales Chart, eine importierte Datei und die Datei entity.lock, wenn sie die Pins dieser Entität festhält —, und führen Sie aggrega pin für jede aus, die eine entfernte Quelle liest oder eine Datei importiert, damit jedes Lock seine eigene Entität festhält. Jede als <kind>/<provider-or-publisher>/…/<name>/<version>/ anzulegen, hält sie dort, wo der Katalog der Standardbibliothek jede Entität aufbewahrt. Ein Katalogverzeichnis wird durch Durchlaufen gefunden, sodass ein Build über den Katalog nach dem Verschieben dieselbe Ausgabe rendert.
An entity kind has no artifact media type (Ein Entitätstyp hat keinen Artefakt-Medientyp)
Eine Zurückweisung beim Veröffentlichen, nicht bei einem Build. Jeder veröffentlichbare Entitätstyp hat einen Medientyp für jede der beiden Formen, die sein Artefakt annimmt — nur sein Dokument oder ein Archiv aus dem Dokument und den Dateien, die es deklariert —, und das Verpacken einer Entität schlägt diesen nach Typ nach. Diese Bedingung meldet einen Typ ohne Eintrag.
Kein Build erreicht sie. Die einzige andere Stelle, an der dieselbe Suche läuft, behandelt einen fehlenden Eintrag als „dies ist keine Bibliothek“ und fährt fort, sodass die Bedingung dort nie zutage tritt.
Ausgegebene Meldung, der eigene Satz der Bedingung, eingerahmt vom Befehl und von der Datei, die er verpackte:
aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: Bundle unter dem angegebenen Pfad: oci: unbekannter Entitätstyp für die Medientyp-Zuordnung)
So beheben Sie es: Gleichen Sie das Feld kind: der Datei, die Sie veröffentlichen, mit den Typen ab, die aggrega push --list-kinds ausgibt — ein falsch geschriebener oder nicht unterstützter Typ wird hier gemeldet, und das Feld zu korrigieren, ist die ganze Abhilfe. Ist der Typ einer, den diese Liste führt, handelt es sich um eine Lücke in der Toolchain statt in Ihrer Entität, und es lohnt sich, sie unter Angabe des Typs zu melden.
A published archive carries an entry Windows cannot use (Ein veröffentlichtes Archiv enthält einen Eintrag, den Windows nicht verwenden kann)
Ein Hinweis, der ausgelöst wird, wenn eine Entität veröffentlicht wird; er hält nie etwas an, und ein Build löst ihn nicht aus. Eine Entität, die neben ihrem Dokument Dateien mitbringt, wird als Archiv veröffentlicht, und jeder Name, den das Archiv enthält — der eigene Dateiname des Entitätsdokuments, dann jede Datei, die es mitbringt —, wird nach der Regel beurteilt, die der Abbruch „A name the operation writes holds a part Windows cannot hold (Ein Name, den der Vorgang schreibt, enthält einen Teil, den Windows nicht aufnehmen kann)“ oben unter Windows anwendet: ein Teil, den Windows für ein Gerät reserviert, in jeder Groß- und Kleinschreibung und gleich welche Dateiendung folgt, oder ein Teil, der auf einen Punkt oder ein Leerzeichen endet. Daher löst aux/x.yaml ihn wegen seines Verzeichnisses aux aus, report. wegen seines abschließenden Punkts und ein Dokument namens con.yaml, das eine Schemadatei importiert, wegen seines eigenen Namens. Eine Entität, die nichts mitbringt, wird nur als ihr Dokument veröffentlicht, abgelegt unter einem Namen, den das Produkt wählt, und ein Plugin veröffentlicht kein Archiv, sodass keines von beiden ihn auslöst.
Er wird auf jeder Plattform ausgelöst und weist nichts zurück. Ein Workspace unter Windows weigert sich, einen solchen Eintrag auszulegen, unter jenem Abbruch, und kann die Version daher nicht verwenden; der Hinweis ist der Weg, auf dem der Herausgeber dies erfährt, bevor es jemand unter Windows tut. Die Veröffentlichung oder ihr Probelauf läuft weiter oder bricht ab, genau wie ohne ihn.
Jede Oberfläche, die eine Entität veröffentlicht, löst ihn aus, jede in ihrer eigenen Form.aggrega push und sein --dry-run geben pro Eintrag eine Zeile auf der Standardfehlerausgabe aus, jede beginnend mit warning: . Das Werkzeug publish-entity des Assistenten antwortet mit den Einträgen als windows_unusable_entries, und auch der Text der Antwort nennt sie. aggrega serve beantwortet aggrega/publishEntity mit ihnen als windowsUnusableEntries und reicht die Warnzeilen selbst an eine Anfrage weiter, die darum gebeten hat, informiert zu werden. Jede Antwort lässt das Feld weg, wo es keinen solchen Eintrag gibt.
Seine Meldung beginnt so:
an entry this publication carries cannot be used on Windows (ein Eintrag, den diese Veröffentlichung enthält, kann unter Windows nicht verwendet werden)
und fährt mit dem Eintrag und dem ersten seiner Teile fort, den Windows nicht aufnehmen kann, dann mit der Abhilfe. Erklärt unter „A published archive carries an entry Windows cannot use (Ein veröffentlichtes Archiv enthält einen Eintrag, den Windows nicht verwenden kann)“ in warnings.md.
So beheben Sie es: Benennen Sie den Teil, den die Meldung nennt, um, auf der Festplatte und überall dort, wo die Deklarationen der Entität die Datei nennen, und veröffentlichen Sie erneut. Ist die Version nicht für die Verwendung unter Windows gedacht, muss nichts geändert werden.
Two catalog identities publish to one repository location (Zwei Katalogidentitäten veröffentlichen an denselben Repository-Speicherort)
Eine Zurückweisung beim Prüfen eines ganzen Katalogs, nicht bei einem Build. Wohin eine Entität veröffentlicht wird, wird aus ihrer Identität abgeleitet und in Kleinbuchstaben umgewandelt, sodass zwei Identitäten, die sich nur in der Groß- und Kleinschreibung unterscheiden, am selben Ort landen. Beide zu veröffentlichen, würde die Bytes einer Entität durch die der anderen überschreiben, und nichts in einer der beiden Entitäten würde es verraten.
Die Prüfung läuft über den ganzen Katalog auf einmal, weil eine Kollision eine Eigenschaft eines Paares ist und nicht einer der beiden Entitäten für sich — keine ist für sich genommen falsch, und jede isoliert zu lesen, zeigt nichts.
Ausgegebene Meldung. Der Rahmen der Katalogprüfung eröffnet sie, dann folgen der eigene Satz der Bedingung und dann jede kollidierende Gruppe, jede mit dem gemeinsamen Speicherort und den Identitäten, die ihn erreichen:
catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (Katalogvalidierung fehlgeschlagen: oci: verschiedene Katalogidentitäten werden auf denselben OCI-Repository-Speicherort abgebildet)
<location> <- <identity>, <identity>
So beheben Sie es: Benennen Sie eine der Entitäten um, die die Meldung nennt, in ihrem metadata.name und in dem Verzeichnis, das ihn widerspiegelt. Welche Sie umbenennen, entscheiden Sie; Paare, die sich nur in der Groß- und Kleinschreibung unterscheiden, sind die übliche Form, und eine Schreibweise zu wählen und sie einheitlich zu verwenden, verhindert, dass das Paar wiederkehrt. Eine Umbenennung ist eine echte Änderung der Identität einer Entität, sodass alles, was auf den alten Namen verweist, mitziehen muss — ein Grund, die Kollision zu klären, bevor einer der beiden Namen veröffentlicht wird, statt danach.
Keyless signing was asked for without the services it needs (Schlüssellose Signierung wurde ohne die Dienste angefordert, die sie benötigt)
Eine Zurückweisung beim Signieren während des Veröffentlichens, nicht bei einem Build. Schlüssellose Signierung hat keine Offline-Form: Sie beschafft eine Identität, lässt dafür ein kurzlebiges Zertifikat ausstellen, zeichnet die Signatur dort auf, wo sie später geprüft werden kann, und verwirft dann den Schlüssel. Jeder dieser Schritte ist ein Austausch mit einem laufenden Dienst. Diese Bedingung meldet, dass die Identität, von der der Ablauf ausgeht, nicht verfügbar war, sodass der Ablauf zurückgewiesen wird, statt begonnen und auf halbem Weg abgebrochen zu werden.
Zwei Formen melden sie: Gar nichts ist konfiguriert, um eine Identität zu liefern, und etwas ist konfiguriert, das nichts geliefert hat.
Ein Offline-Workspace meldet sie anders, unter der Zurückweisung, die jeden Netzwerkschritt abdeckt, weil die Zurückweisung erfolgt, bevor überhaupt eine Identität angefordert wird.
Ausgegebene Meldungen. Keine Identitätsquelle:
signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (signing: schlüssellose Signierung erfordert einen aktiven Identitätsanbieter, Fulcio und Rekor: eine Quelle für Identitätstoken ist erforderlich)
und eine Quelle, die nichts geliefert hat:
signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (signing: schlüssellose Signierung erfordert einen aktiven Identitätsanbieter, Fulcio und Rekor: ein Identitätstoken ist erforderlich)
So beheben Sie es: Die Behebung liegt beim Operator, in der Art, wie die Veröffentlichung ausgeführt wird. In einer automatisierten Pipeline stammt die Identität aus den eigenen Anmeldedaten der Pipeline, sodass dies meist bedeutet, dass dem Job die Berechtigung, die sie ausstellt, nicht erteilt wurde. Bei interaktiver Ausführung stammt die Identität aus der Anmeldung, zu der der Befehl Sie auffordert. Wo Sie überhaupt keine aktive Identität wollen, signieren Sie stattdessen mit einem eigenen Schlüssel — dieser Weg braucht keinen dieser Dienste und ist der richtige in einer Umgebung, die sie nicht erreichen kann.
An unsigned publish targets a registry or a policy that requires a signature (Eine unsignierte Veröffentlichung zielt auf eine Registry oder eine Richtlinie, die eine Signatur verlangt)
Eine Zurückweisung beim Veröffentlichen, nicht bei einem Build. Wo eine Signatur verlangt wird, wird unsignierter Inhalt nicht veröffentlicht. Die Prüfung läuft, bevor irgendwelche Bytes hochgeladen werden, sodass nichts Unvollständiges die Registry erreicht.
Zwei Bedingungen, weil eine Anforderung zwei Quellen hat und sich die Abhilfen unterscheiden. Die eine ist die eigene Haltung der Ziel-Registry, die für alles gilt, was dort veröffentlicht wird. Die andere ist die Signaturrichtlinie des Workspace, die eine Menge von Artefakttypen abdeckt, wo immer sie veröffentlicht werden. Gelten beide, wird die der Registry gemeldet, weil die Nennung des Ziels die nützlichere der beiden ist.
Es gibt hier kein Flag, das unsignierten Inhalt veröffentlicht. Das Signieren ausdrücklich abzuschalten, lockert die Zurückweisung nicht — es ändert nur den Standard für Artefakte, bei denen das Signieren optional ist.
Die Signatur wird vor dem Hochladen erzeugt statt danach, sodass auch ein Fehlschlag beim Signieren hier landet und nichts veröffentlicht wird.
Ausgegebene Meldungen. Die eigene Anforderung der Registry:
aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content (aggrega push: die angegebene Registry verlangt Signaturen; führen Sie den Vorgang erneut aus und signieren Sie dabei das Artefakt (hier gibt es kein Flag, um unsignierten Inhalt zu pushen): signing: Registry verlangt Signaturen; das Pushen unsignierten Inhalts wird verweigert)
die der Workspace-Richtlinie, die den Typ nennt, der das Artefakt in ihren Geltungsbereich gebracht hat:
aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content (aggrega push: die Signaturrichtlinie verlangt eine Signatur für den angegebenen Typ; führen Sie den Vorgang erneut aus und signieren Sie dabei das Artefakt (hier gibt es kein Flag, um unsignierten Inhalt zu pushen): signing: Signaturrichtlinie verlangt eine Signatur für diesen Artefakttyp; das Pushen unsignierten Inhalts wird verweigert)
und eine Signatur, die nicht erzeugt werden konnte, was unter der Bedingung der Registry gemeldet wird und den zugrunde liegenden Fehlschlag zitiert:
aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: Signieren der angegebenen Version: der angegebene zugrunde liegende Fehlschlag: signing: Registry verlangt Signaturen; das Pushen unsignierten Inhalts wird verweigert)
Eine Form des Fehlschlags beim Signieren wird eigens benannt, weil eine allgemeine Zurückweisung Menschen dazu bringt, sich erneut einen Berechtigungsnachweis zu beschaffen, der nicht helfen kann:
aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: Signieren der angegebenen Version: das Identitätstoken enthält keinen verifizierten E-Mail- oder Subject-Claim — der OIDC-Ablauf/-Client hat keine Identität mit E-Mail-Geltungsbereich zurückgegeben (das Token erneut zu exportieren oder erneut zu beschaffen, hilft nicht); konfigurieren Sie Identitätsanbieter/Client/Geltungsbereich so, dass eine zurückgegeben wird: der angegebene zugrunde liegende Fehlschlag: signing: Registry verlangt Signaturen; das Pushen unsignierten Inhalts wird verweigert)
So beheben Sie es: Die Behebung liegt beim Operator. Signieren Sie das Artefakt und veröffentlichen Sie erneut — entweder mit einem eigenen Schlüssel oder auf dem schlüssellosen Weg, je nachdem, wofür der Workspace eingerichtet ist. Wo Sie nicht erwartet haben, dass eine Signatur verlangt wird, sagt die Meldung, welche Quelle sie verlangt hat: Die eigene Haltung einer Registry steht im Eintrag dieser Registry in .aggrega-config.yaml, und die typbezogene Anforderung steht in der workspaceweiten Signaturrichtlinie. Eine von beiden zu lockern, ist eine Entscheidung darüber, was Sie unsigniert zu veröffentlichen bereit sind, daher ist es meist besser, den Geltungsbereich der Richtlinie einzuschränken, als sie abzuschalten.
References signed together need different signing credentials (Gemeinsam signierte Referenzen benötigen unterschiedliche Berechtigungsnachweise zum Signieren)
Eine Zurückweisung beim Signieren, nicht bei einem Build. aggrega sign mit mehreren Referenzen und aggrega deprecate --from mit einer Batch-Datei signieren alles, was sie erhalten, mit einem einzigen Berechtigungsnachweis: einem einzigen eigenen Schlüssel oder einer einzigen schlüssellosen Identität. Welchen Berechtigungsnachweis eine Referenz benötigt, entscheidet die Konfiguration ihrer Registry — ein signing.key_path, der für diese Registry gilt, wählt den Schlüssel, den er nennt, und wo keiner gilt, wird die Referenz schlüssellos signiert. Würden die gemeinsam genannten Referenzen unterschiedliche Berechtigungsnachweise benötigen — einen Schlüssel für eine Registry und keinen für eine andere, oder zwei verschiedene Schlüssel —, wird nichts signiert, und die Meldung nennt die Registries auf jeder Seite.
Die Prüfung läuft, bevor eine Identität angefordert und bevor irgendeine Registry gelesen wird, sodass nichts signiert oder angehängt wird und niemand für einen Lauf, der nicht stattfindet, zu einer Eingabe aufgefordert wird. Eine Signatur kann von niemandem zurückgeholt werden, der sie abgerufen hat; deshalb wird der Lauf zurückgewiesen, statt mit dem Berechtigungsnachweis signiert zu werden, den gerade eine der Referenzen benötigt.
Ein mit --key übergebener Schlüssel entscheidet für jede Referenz. Er gilt für jede genannte Referenz, unabhängig davon, was die Konfiguration für die einzelne Registry sagt, sodass ein solcher Lauf hier nie zurückgewiesen wird.
Man trifft überall darauf, wo ein Batch signiert wird: aggrega sign, aggrega deprecate --from, die Anfragen aggrega/signArtifacts und aggrega/deprecateArtifact von aggrega serve, deren Fehlermeldung den Kurzcode vor dem Satz trägt, und die Werkzeuge sign-artifacts und deprecate-artifact von aggrega mcp. Ein Werkzeugaufruf, der einen Server über einen Listener erreicht, verwendet nie einen Schlüssel, den die Konfiguration nennt, sodass dort jede Referenz mit der Identität signiert wird, die der Aufruf sendet, und der Aufruf hier nicht zurückgewiesen wird.
Ausgegebene Meldung. Der eigene Satz der Bedingung eröffnet sie, jeder Berechtigungsnachweis folgt mit den Registries, für die er signieren würde, und die Abhilfe kommt zuletzt:
aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own (aggrega sign: signing: die gemeinsam genannten Referenzen benötigen unterschiedliche Berechtigungsnachweise zum Signieren, daher wurde nichts signiert (die angegebene Registry signiert mit dem eigenen Schlüssel, den signing.key_path nennt, die angegebene Registry signiert schlüssellos: kein signing.key_path gilt). Abhilfe: Signieren Sie sie in getrennten Läufen, einem pro Berechtigungsnachweis: die Referenzen auf der angegebenen Registry, dann die Referenzen auf der angegebenen Registry; jeder Lauf signiert so, wie er es für sich allein täte)
und, wo eine Registry im Batch Signaturen verlangt, mit ihrer Nennung am Ende der Abhilfe:
aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done (aggrega sign: signing: die gemeinsam genannten Referenzen benötigen unterschiedliche Berechtigungsnachweise zum Signieren, daher wurde nichts signiert (die angegebene Registry signiert mit dem eigenen Schlüssel, den signing.key_path nennt, die angegebene Registry signiert schlüssellos: kein signing.key_path gilt). Abhilfe: Signieren Sie sie in getrennten Läufen, einem pro Berechtigungsnachweis: die Referenzen auf der angegebenen Registry, dann die Referenzen auf der angegebenen Registry; jeder Lauf signiert so, wie er es für sich allein täte, und die angegebene Registry verlangt Signaturen, daher hält diese Zurückweisung ein Signieren zurück, das sonst stattgefunden hätte, und nicht eines, das unmöglich ist)
Eine zweite Registry mit einem eigenen Schlüssel wird als signierend „with a different held key (mit einem anderen eigenen Schlüssel)“ genannt. Der Pfad eines Schlüssels wird nie ausgegeben: Die Meldung nennt die Einstellung, und die ist es, die Sie ändern können.
So beheben Sie es: Teilen Sie die Referenzen nach dem Berechtigungsnachweis auf, den ihre Registries benötigen, und führen Sie einen Lauf pro Berechtigungsnachweis aus — ein aggrega sign, das die Referenzen auf den mit einem Schlüssel signierten Registries nennt, ein weiteres, das den Rest nennt; für aggrega deprecate --from eine Batch-Datei pro Berechtigungsnachweis. Jeder Lauf signiert dann so, wie er es für sich allein getan hätte. Um stattdessen jede Referenz in einem einzigen Lauf mit einem Schlüssel zu signieren, übergeben Sie diesen Schlüssel mit --key.
A detached signature does not verify against the key supplied (Eine abgetrennte Signatur lässt sich mit dem angegebenen Schlüssel nicht verifizieren)
Das negative Ergebnis der Prüfung einer bloßen Signatur über eine Payload gegen einen öffentlichen Schlüssel, vollständig offline: Die Payload weicht von dem ab, was signiert wurde, die Signatur wurde verändert, oder der Schlüssel ist nicht der, der sie erzeugt hat.
Nichts in der ausgelieferten Toolchain erreicht sie. Die Prüfung, zu der sie gehört, hat außerhalb ihrer eigenen Tests keinen Aufrufer, sodass kein Befehl, den ein Benutzer ausführt — Build, Pull oder Veröffentlichung —, sie meldet. Sie ist hier katalogisiert, damit der Code zu etwas aufgelöst wird, nicht weil ein Build sie ausgeben kann. Die Verifizierung, die ein Pull tatsächlich durchführt, erfolgt über ein vollständiges Signatur-Bundle und wird gesondert gemeldet.
Ausgegebene Meldung, die zitiert, was der Verifizierer gemeldet hat:
signing: signature does not verify: <what the verifier reported> (signing: Signatur lässt sich nicht verifizieren, gefolgt von dem, was der Verifizierer gemeldet hat)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und nichts, was Sie in einen Katalog oder einen Workspace schreiben können, beseitigt es. Wenn Sie das veröffentlichte Befehlszeilenwerkzeug ausführen, ist dies keine Bedingung, die Sie erreichen können, und ein Signaturproblem, das Sie tatsächlich vor sich haben, wird stattdessen von einer der oben beschriebenen Bedingungen der Bundle-Verifizierung gemeldet. Wenn Sie das Signierpaket direkt aus eigener Software verwenden, müssen Payload, Signatur und Schlüssel die drei sein, die zusammengehören — eine zwischen Signieren und Verifizieren neu serialisierte Payload ist die übliche Ursache, da sich die Bytes dann unterscheiden, auch wenn der Inhalt gleich aussieht.
A resolved artifact is not a documentation bundle (Ein aufgelöstes Artefakt ist kein Dokumentations-Bundle)
Eine Referenz, die zu einem Artefakt einer anderen Art aufgelöst wird — einer Katalogentität, einem Plugin —, wird zurückgewiesen, statt als Dokumentation zwischengespeichert zu werden, sodass eine falsch ausgerichtete Referenz dort scheitert, wo sie ausgerichtet wird, und nicht später als ein Bundle, das nicht gelesen werden kann.
Wo sie auftritt. Das Dokumentations-Bundle wird in den Cache beschafft, den alle Projekte auf dem Rechner teilen, aus der konfigurierten Registry des Workspace unter dem reservierten Namespace docs: vom Server für Assistenten einmal, beim Start und bevor er irgendetwas beantwortet, von aggrega explain und von der Erklärung eines Codes in einem Editor, wenn eines von beiden es zum ersten Mal braucht, und von aggrega scaffold --example — jeweils nur dort, wo der Rechner keine Kopie hält, die die Signaturprüfung des Workspace zulässt. Dies ist die Prüfung, die jede Beschaffung auf das anwendet, was zurückkam.
Sie hält nie eine Sitzung an. Die Beschaffung meldet ihr Ergebnis auf dem Log-Stream des Servers, und die Verbindung läuft in jedem Fall weiter; was ein zurückgewiesenes Artefakt kostet, sind die Dokumentationsressourcen, die dann für diese Sitzung mit „nicht gefunden“ antworten. aggrega scaffold --example hat ohne das Bundle nichts zu schreiben, sodass es dort die Zurückweisung des Befehls ist, und nichts wird geschrieben.
Ausgegebene Meldung, die die Referenz und beide Medientypen nennt:
docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (docscache: die angegebene Referenz in der angegebenen Version hat den gefundenen Medientyp, erwartet wird der eines Dokumentations-Bundles: docscache: Artefakt ist kein Dokumentations-Bundle)
So beheben Sie es: Nichts in Ihren Entitätsdateien verursacht dies, und keine Änderung beim Authoring beseitigt es. Die Referenz, die die Beschaffung verwendet hat, zeigt auf etwas, das kein Dokumentations-Bundle ist — prüfen Sie die konfigurierte Registry des Workspace, da die Bundle-Referenz aus ihr abgeleitet wird, und eine Referenz, die wohlgeformt ist und auf ein anderes Artefakt zeigt, wird erfolgreich aufgelöst und scheitert erst hier.
A page is absent from a documentation bundle (Eine Seite fehlt in einem Dokumentations-Bundle)
Ein Dokumentations-Bundle wurde zwischengespeichert und sein Inhalt verifiziert, und die angeforderte Seite — oder, bei aggrega scaffold --example, das Verzeichnis des Beispiels — ist nicht darin. Das ist etwas anderes, als gar kein Bundle zu haben: Das Bundle ist vorhanden und intakt, und der Eintrag fehlt darin.
Sie erreicht keinen Build. Die Oberfläche, die einem Editor oder einem Assistenten Dokumentationsseiten bereitstellt, macht daraus eine gewöhnliche Antwort „nicht gefunden“ für die angeforderte Ressource. aggrega scaffold --example meldet sie als Zurückweisung, die das Beispiel und das Bundle nennt, gefolgt von einem Verweis auf aggrega scaffold --example --list, das die Beispiele ausgibt, die das Bundle tatsächlich enthält, und schreibt nichts.
Welche der beiden Antworten „nicht gefunden“ Sie erhalten, lohnt sich zu unterscheiden, auch wenn die Oberfläche sie gleich darstellt. Diese bedeutet, dass das Bundle zwischengespeichert und intakt ist und die Seite nicht darin ist. Die andere — kein Bundle, das der Workspace lesen darf, weil keines zwischengespeichert ist oder die einzige Kopie eine ist, die die Signaturprüfung des Workspace zurückweist — bedeutet, dass die Beschaffung nicht abgeschlossen wurde, und der Log-Stream des Servers sagt, warum.
Ausgegebene Meldung, die die Seite und das Bundle nennt, in dem sie gesucht wurde:
page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (die angegebene Seite in der angegebenen Referenz und Version: docscache: Seite im Dokumentations-Bundle nicht gefunden)
So beheben Sie es: In Ihren Dateien ist nichts kaputt. Eine Seite, die im Bundle fehlt, fehlt, weil das Bundle älter ist als sie oder weil der angeforderte Pfad nicht der Pfad ist, unter dem sie veröffentlicht ist — das Bundle wird in der Version beschafft, die der Server als seine eigene meldet, sodass eine nach dieser Version hinzugefügte Seite nicht darin ist. Wo die Seite nie existiert hat, hat die Anfrage einen Pfad genannt, den die Dokumentation nicht verwendet, und die veröffentlichte Dokumentation ist der Ort, an dem Sie den finden, den sie verwendet.
An edit would produce a document its schema refuses (Eine Bearbeitung würde ein Dokument erzeugen, das sein Schema zurückweist)
Eine Zurückweisung bei einer Dokumentbearbeitung, nicht bei einem Build. Eine strukturierte Bearbeitung — eine Komponente hinzufügen, ein Feature anbinden, eine Kante verdrahten oder einen Wert setzen — wird zusammengesetzt und in das Dokument eingefügt, und das Ergebnis wird dann gegen das Schema des Dokumenttyps geprüft, den es hat. Wo diese Prüfung Einwände erhebt, wird die Bearbeitung zurückgewiesen und nichts geschrieben. Sie gehört zu aggrega edit-document und zu derselben Fähigkeit, die ein Editor über aggrega serve oder ein Assistent erreicht; beides sind schlanke Einstiegspunkte in eine einzige Implementierung.
Der Typ wird vom Dokument abgelesen, nie vom Aufrufer angegeben. Ein Aufrufer, der den Typ nennt, könnte den falschen nennen, und das Ergebnis würde dann gegen ein Schema geprüft, nach dem das Dokument nicht geschrieben ist — was genau die Bearbeitung zulassen würde, die diese Prüfung zurückweisen soll.
Die Datei bleibt Byte für Byte, wie sie war, und das Schreiben ist atomar, sodass eine zurückgewiesene Bearbeitung nicht von einer nie versuchten zu unterscheiden ist und eine korrigierte Anfrage gegen das Dokument wiederholt werden kann, mit dem Sie begonnen haben.
Ihr Gegenstand ist eine Anfrage, die wohlgeformt war. Die Anfrage nannte eine Bearbeitung, die diese Fähigkeit anwendet, und das Dokument, das sie erzeugt hätte, ist eines, das das Authoring-Schema zurückgewiesen hätte, hätten Sie es von Hand eingegeben — weshalb dafür keine Authoring-Regel wiederholt wird: Ein Release aufzufordern, einen Entwicklerwert zu tragen, wird so oder so vom selben Schema zurückgewiesen. Eine Anfrage, die nie eine Bearbeitung adressiert hat — ein Knotenpfad, der nichts im Dokument erreicht, ein Wert, der als Mapping geschrieben ist, wo ein Skalar verlangt wird, ein bereits vorhandener Eintrag, der etwas anderes trägt —, wird aus eigenen Gründen zurückgewiesen, und jede Oberfläche meldet das in ihrem eigenen Kanal.
Auch ein Dokument, das bereits ungültig war, meldet sie. Die Prüfung läuft auch dort, wo die Bearbeitung nichts geändert hat, sodass eine Bearbeitung an einem Dokument, das das Produkt nicht lesen würde, dies sagt, statt Erfolg zu melden.
Die Prüfung ist dieselbe, die jedes Lesen des Dokuments anwendet, sodass sie auch ein Recipe oder FeatureRecipe zurückweist, dessen Pipeline eine Schritt-ID zweimal deklariert, eine Regel, die kein Schema ausdrücken kann; der Einwand nach dem Satz beginnt dann mit dem eigenen Satz und Rat dieser Bedingung, wie unter A pipeline declares one step id twice (Eine Pipeline deklariert eine Schritt-ID zweimal) beschrieben.
Ausgegebene Meldung, die den eigenen Einwand des Schemas nach dem Satz trägt — den Dokumenttyp und die Datei, dann die Position, den fehlerhaften Schlüssel und das, was das Schema dort gesagt hat — und mit dem Rat schließt:
the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema (die Bearbeitung wurde zurückgewiesen, weil das resultierende Dokument nicht gültig wäre, und nichts wurde geschrieben: Validierung der Dokumenthülle fehlgeschlagen (der angegebene Typ, unter dem angegebenen Pfad); die angegebene Zeile und Spalte: der angegebene Feldpfad: … gefolgt vom eigenen Einwand des Schemas. Korrigieren Sie das Dokument so, dass es dem Schema seines Typs entspricht)
So beheben Sie es: Öffnen Sie das Dokument an der Position, die die Meldung zitiert, und lesen Sie den Einwand, der sagt, was das Schema an diesem Schlüssel erwartet hat. Die vorzunehmende Änderung betrifft meist die Anfrage statt das Dokument — fordern Sie einen Eintrag an, den das Schema an dieser Stelle zulässt, und dieselbe Anfrage wird sauber angewendet. Ist der Schlüssel einer, den der Typ dieses Dokuments überhaupt nicht tragen darf, gehört er auf die Authoring-Oberfläche, die ihn tragen darf, und die Entitätsseite des Typs nennt die Felder, die er deklariert. Was semantisch zulässig ist, wird an dieser Stelle nicht entschieden — etwa ob ein Abhängigkeits-Socket einer ist, den der Produzent deklariert —, daher geht es bei dieser Zurückweisung immer um die Form des Dokuments, nie darum, was über eine Verbindung hinweg konsumiert werden darf.
An annotation key uses a prefix the platform reserves (Ein Annotationsschlüssel verwendet ein Präfix, das die Plattform reserviert)
Eine Zurückweisung beim Prüfen einer Entität gegen die Veröffentlichungskonventionen, nicht bei einem Build. Das Präfix aggrega.ai/ sowie feature.aggrega.ai/ außerhalb eines Feature gehören der Plattform: Ein darunter geschriebener Schlüssel trägt eine Bedeutung, die die Plattform zuweist, sodass eine eigene Entität, die dort schreibt, einen Namensraum beansprucht, der ihr nicht gehört.
Sie gibt beim Verfassen einen Hinweis und weist am Veröffentlichungs-Gate zurück, und beide Lesarten nennen diese eine Bedingung. Was gefunden wurde, ist in beiden Fällen dasselbe; nur die Folge unterscheidet sich. Diese Aufteilung beschreibt, wie sich die meisten der hier katalogisierten Regeln der Veröffentlichungskonventionen verhalten, daher wird sie einmal genannt und in den folgenden Einträgen, die nichts anderes sagen, vorausgesetzt — die beiden, die mit einer bereits veröffentlichten Version vergleichen, sagen dies in ihren eigenen Einträgen, weil sie überhaupt nicht über lokale Inhalte laufen können.
Seine Meldung beginnt so:
an annotation key on the entity uses a prefix the platform reserves (ein Annotationsschlüssel der Entität verwendet ein Präfix, das die Plattform reserviert)
So beheben Sie es: Verschieben Sie den Schlüssel unter ein Präfix, das Ihrer eigenen Organisation gehört. Hat ein Workspace dennoch einen Grund, unter dem reservierten Präfix zu schreiben, gehört diese Regel zu denen mit einem Opt-out, die unter „Die Disziplinregeln“ in aggrega-lint.md beschrieben sind.
An entity’s name does not follow the shape its kind expects (Der Name einer Entität folgt nicht der Form, die ihr Typ erwartet)
Eine Zurückweisung beim Prüfen einer Entität gegen die Veröffentlichungskonventionen, nicht bei einem Build. Jeder Entitätstyp hat eine Konvention für die Form des Namens — die Anzahl der Segmente bei den Cloud-native-Typen, PascalCase bei den Bibliothekstypen —, und der Name, den diese Entität deklariert, entspricht nicht dem, den ihr Typ erwartet.
Seine Meldung beginnt so:
the entity’s name does not follow the documented name shape for its kind (der Name der Entität folgt nicht der dokumentierten Namensform für ihren Typ)
So beheben Sie es: Benennen Sie die Entität in die Form um, die ihr Typ erwartet; die Konventionen je Typ sind unter „Die Disziplinregeln“ in aggrega-lint.md aufgeführt, zusammen mit dem Opt-out für einen Katalog, der Entitäten bewusst auf seine eigene Weise benennt.
A schema uses a dynamic reference that cannot be resolved ahead of time (Ein Schema verwendet eine dynamische Referenz, die sich nicht vorab auflösen lässt)
Eine Zurückweisung beim Prüfen einer Entität gegen die Veröffentlichungskonventionen, nicht bei einem Build. Ein Schema, das die Entität mitbringt, verwendet ein dynamisches Referenzkonstrukt, dessen Ziel gewählt wird, während ein Dokument validiert wird, statt festgelegt zu werden, wenn das Schema geschrieben wird. Referenzen werden hier vorab expandiert, sodass es keine laufende Validierung gibt, gegen die ein solches Konstrukt aufgelöst werden könnte.
Seine Meldung beginnt so:
a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (ein Schema in der Entität verwendet ein dynamisches Referenzkonstrukt, dem die dokumentübergreifende Referenzauflösung nicht folgen kann)
So beheben Sie es: Ersetzen Sie das dynamische Konstrukt durch eine einfache Referenz, die das Ziel direkt nennt. Braucht das Schema das Konstrukt wirklich und wird es nicht dokumentübergreifend referenziert, hat die Regel ein Opt-out, das unter „Die Disziplinregeln“ in aggrega-lint.md beschrieben ist.
A schema declares an identifier the platform owns (Ein Schema deklariert einen Bezeichner, der der Plattform gehört)
Eine Zurückweisung beim Prüfen einer Entität gegen die Veröffentlichungskonventionen, nicht bei einem Build. Ein Schema, das die Entität mitbringt, deklariert einen eigenen Bezeichner, wo der kanonische Bezeichner aus der Identität der Entität abgeleitet wird. Der deklarierte verdrängt den abgeleiteten, sodass eine Referenz, die gegen den kanonischen Bezeichner geschrieben ist, nicht mehr aufgelöst wird.
Seine Meldung beginnt so:
a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (ein Schema in der Entität deklariert einen eigenen Bezeichner, wo die Identität dieses Schemas der Plattform gehört)
So beheben Sie es: Entfernen Sie den deklarierten Bezeichner und lassen Sie ihn ableiten. Das Opt-out für ein Schema, das bewusst unter einem eigenen Bezeichner veröffentlicht wird, ist unter „Die Disziplinregeln“ in aggrega-lint.md beschrieben.
A Component’s category label and its directory name different categories (Das Kategorie-Label einer Component und ihr Verzeichnis nennen unterschiedliche Kategorien)
Eine Zurückweisung beim Prüfen einer Entität gegen die Veröffentlichungskonventionen, nicht bei einem Build. Eine Component trägt ein Kategorie-Label und ist unter einem Kategorieverzeichnis abgelegt; die Konvention ist, dass beide dieselbe Kategorie nennen, damit das Verzeichnis, das ein Leser durchsucht, und das Label, mit dem ein Selektor abgleicht, nicht voneinander abweichen können.
Seine Meldung beginnt so:
the entity’s category label does not match the category directory the entity is filed under (das Kategorie-Label der Entität stimmt nicht mit dem Kategorieverzeichnis überein, unter dem die Entität abgelegt ist)
So beheben Sie es: Ändern Sie das der beiden, das falsch ist, sodass sie übereinstimmen — verschieben Sie die Datei unter das Verzeichnis, das ihr Label nennt, oder korrigieren Sie das Label auf die Kategorie, die das Verzeichnis nennt. Die geschlossene Menge der Kategorien und das Opt-out stehen unter „Die Disziplinregeln“ in aggrega-lint.md.
A schema extension is written directly into schema content (Eine Schemaerweiterung wird direkt in den Schemainhalt geschrieben)
Eine Zurückweisung beim Prüfen einer Entität gegen die Veröffentlichungskonventionen, nicht bei einem Build. Eine Component oder ein Feature schreibt eine Aggrega-Schemaerweiterung direkt in den eigenen Schemainhalt, wo die Entität eine erstklassige Oberfläche hat, um dasselbe zu deklarieren. Die direkt verfasste Form funktioniert, und die Konvention bevorzugt die deklarierte Oberfläche, weil die Entitätsseiten diese lehren und die Werkzeuge diese lesen.
Dies ist die einzige Regel der Gruppe, die auch ein Build meldet, als Hinweis, der den Build nicht anhält. Die Prüfung der Entität gegen die Veröffentlichungskonventionen am Veröffentlichungs-Gate macht aus demselben Befund eine Zurückweisung.
Seine Meldung beginnt so:
the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (die Entität schreibt eine Aggrega-Schemaerweiterung direkt in den Schemainhalt, statt sie im Socket-Schema oder im Anbindungs-Schema zu deklarieren)
So beheben Sie es: Verschieben Sie die Erweiterung auf die eigene Socket- oder Anbindungsoberfläche der Entität, wo die Entitätsseiten für component.md und feature.md sie deklarieren. Das Opt-out steht unter „Die Disziplinregeln“ in aggrega-lint.md.
A Plugin pins neither runtime cap, so the platform’s own apply (Ein Plugin pinnt keines der beiden Laufzeitlimits, daher gelten die der Plattform)
Ein Hinweis, der ausgelöst wird, wenn eine Entität gegen die Veröffentlichungskonventionen geprüft wird, beim Verfassen ebenso wie am Veröffentlichungs-Gate; er hält nie etwas an, und ein Build löst ihn nicht aus. Ein Plugin deklariert die Speicherobergrenze und das Zeitlimit, die der Host anwendet, wenn er das Plugin lädt und ausführt. Eines, das keines von beiden deklariert, läuft mit den Standardwerten der Plattform, was ein unterstütztes Ergebnis und kein Fehler ist — gemeldet wird also, dass die Standardwerte gelten und dass es möglich ist, sie ausdrücklich zu pinnen.
Seine Meldung beginnt so:
the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (die Plugin-Entität deklariert kein eigenes Laufzeit-Ressourcenlimit, daher gelten die Standardwerte der Plattform)
So beheben Sie es: Pinnen Sie die Limits, die das Plugin tatsächlich braucht, oder lassen Sie die Standardwerte bewusst bestehen. Die Regel hat keine Opt-out-Einstellung, und der Grund ist, dass sie eine Tatsache über die Entität meldet und kein Urteil über sie: Es gibt nichts zu lockern. Die Felder sind auf plugin.md beschrieben.
An attachment slot admits only secret material without saying it handles it (Ein Anbindungs-Slot lässt nur geheimes Material zu, ohne anzugeben, dass er es verarbeitet)
Ein Hinweis, der ausgelöst wird, wenn eine Entität gegen die Veröffentlichungskonventionen geprüft wird, beim Verfassen ebenso wie am Veröffentlichungs-Gate; er hält nie etwas an, und ein Build löst ihn nicht aus. Ein Anbindungs-Slot kann über seinen Selektor festlegen, dass nur ein Feature, das Secrets trägt, ihn füllen darf, und er kann separat festhalten, dass alles, was ihn füllt, geheimes Material verarbeitet. Der Selektor legt fest, welche Füllungen zulässig sind; der Eintrag legt die Verarbeitung fest. Ein Slot, der das Erste festlegt und das Zweite weglässt, sorgt dafür, dass die Verarbeitung aus dem Selektor erschlossen werden muss, statt am Slot abgelesen zu werden. Jeder Slot, den eine Entität deklariert, wird geprüft: die ihres eigenen Anbindungsblocks und, bei einer Component, die, die ein Abhängigkeits-Socket für jede darüber verdrahtete Verbindung deklariert — der Befund zum Slot eines Sockets nennt den Socket neben dem Slot.
Seine Meldung beginnt so:
an attachment slot admits only secret material and does not declare that it handles it (ein Anbindungs-Slot lässt nur geheimes Material zu und deklariert nicht, dass er es verarbeitet)
So beheben Sie es: Deklarieren Sie die Verarbeitung am Slot, neben dem Selektor, der das Zugelassene festlegt. Die Regel hat keine Opt-out-Einstellung, aus demselben Grund, aus dem die Regel zu den Plugin-Limits keine hat: Sie meldet eine Tatsache über die Entität und überlässt Ihnen die Entscheidung.
A Recipe publishes a provides key its Component does not declare, checked at publication (Ein Recipe veröffentlicht einen Schlüssel, den seine Component nicht deklariert, geprüft bei der Veröffentlichung)
Ein Hinweis, der ausgelöst wird, wenn eine Entität gegen die Veröffentlichungskonventionen geprüft wird, beim Verfassen ebenso wie am Veröffentlichungs-Gate; er hält nie etwas an, und ein Build löst ihn nicht aus. Ein Recipe veröffentlicht einen Schlüssel unter provides:, und die Component, die das Recipe implementiert, deklariert diesen Schlüssel nicht in der Säule provides ihres Schemas. Ein Konsument, der über eine Verbindung verdrahtet, liest den deklarierten Vertrag der Component statt dessen, was das Recipe ausgibt, sodass der Schlüssel erzeugt und dann dort zurückgewiesen wird, wo etwas versucht, ihn zu konsumieren.
🔴 Zwei Bedingungen beschreiben dies, und sie sind nicht dieselbe. Der Hinweis, den ein Build meldet, ist oben unter „A Recipe publishes a provides key its Component does not declare (Ein Recipe veröffentlicht einen Schlüssel, den seine Component nicht deklariert)“ dokumentiert; dieser wird ausgelöst, wenn die Entität gegen die Veröffentlichungskonventionen geprüft wird, und trägt einen eigenen Code. Der Befund ist dieselbe Tatsache, auf zwei Oberflächen angetroffen — lesen Sie den Code in der Diagnose, um zu erkennen, welchen Sie vor sich haben.
Seine Meldung beginnt so:
the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (das Recipe veröffentlicht einen provides-Schlüssel, den die Component, die es implementiert, nicht deklariert, sodass ein Konsument, der diesen Schlüssel verdrahtet, zurückgewiesen wird)
So beheben Sie es: Deklarieren Sie den Schlüssel an der Component, damit der Vertrag, den ein Konsument liest, das enthält, was das Recipe ausgibt — oder hören Sie auf, ihn aus dem Recipe zu veröffentlichen, wo nichts ihn konsumieren soll. Das Opt-out steht unter „Die Disziplinregeln“ in aggrega-lint.md.
A Component’s metrics annotation and its provides key disagree (Die Metrik-Annotation einer Component und ihr provides-Schlüssel widersprechen sich)
Ein Hinweis, der ausgelöst wird, wenn eine Entität gegen die Veröffentlichungskonventionen geprüft wird, beim Verfassen ebenso wie am Veröffentlichungs-Gate; er hält nie etwas an, und ein Build löst ihn nicht aus. Eine Component kann in ihrer Annotation observability.aggrega.ai/metrics-credential angeben, wie sich die Metriken ihres Produkts authentifizieren — none, target-key oder separate-token —, und sie kann den provides-Schlüssel metrics_credential_required deklarieren, den jedes ihrer Recipes veröffentlicht, um anzugeben, ob die Metriken einer Instanz Zugangsdaten benötigen. Beides ist eine Tatsache über das Produkt, von zwei Seiten gesehen, sodass eine Component, die angibt, dass ihre Metriken keine Zugangsdaten benötigen, keinen solchen Schlüssel deklariert, und eine, die angibt, dass sie Zugangsdaten benötigen, ihn deklariert. Diese Bedingung meldet eine Component, bei der sich beide widersprechen, und nennt die Component, den Wert der Annotation und den Schlüssel, der überzählig ist oder fehlt.
Seine Meldung beginnt so:
a Component’s annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance’s metrics need a credential (die Annotation einer Component, die angibt, wie sich ihre Metriken authentifizieren, widerspricht dem, ob sie den provides-Schlüssel deklariert, der angibt, dass die Metriken einer Instanz Zugangsdaten benötigen)
So beheben Sie es: Korrigieren Sie das der beiden, das falsch ist — deklarieren Sie metrics_credential_required in der Säule provides und veröffentlichen Sie ihn aus jedem Recipe, wo die Metriken Zugangsdaten benötigen; entfernen Sie ihn, wo sie keine benötigen; oder ändern Sie die Annotation auf den Wert, der das Produkt beschreibt. Die Regel hat keine Opt-out-Einstellung, aus demselben Grund, aus dem die Regel zu den Plugin-Limits keine hat; welche Werte sie liest und welche Components sie ungelesen lässt, steht unter „Die Disziplinregeln“ in aggrega-lint.md.
A connection and the target it reaches do not name one key (Eine Verbindung und das Ziel, das sie erreicht, nennen nicht denselben Schlüssel)
Ein Hinweis, der ausgelöst wird, wenn ein Release gegen die Veröffentlichungskonventionen geprüft wird; er hält nie etwas an, und ein Build löst ihn nicht aus. Ein Server, der einen Schlüssel prüft, hält den Schlüssel, den er verifiziert, in einem eigenen Slot, und ein Aufrufer legt einen Schlüssel auf der Verbindung vor, über die er diesen Server erreicht. Keines der beiden Enden sieht den des anderen, sodass beide nur deshalb ein Schlüssel sind, weil ihre Autoren an beiden Enden denselben Locator schreiben. Diese Bedingung meldet eine Verbindung, deren Ziel den Slot für den Schlüssel deklariert, den es von seinen Aufrufern verlangt, wo sie nicht derselbe Schlüssel sind: Die Verbindung trägt Zugangsdaten und der Schlüssel-Slot des Ziels ist nicht gefüllt, der Schlüssel-Slot des Ziels ist gefüllt und die Verbindung trägt keine Zugangsdaten, oder beide sind gefüllt und die beiden schreiben ihre Locators unterschiedlich.
Anders als die Regeln davor liest diese ein ganzes Release statt einer einzelnen Entität, daher trifft man sie nur an, wenn ein Release geprüft wird, und nie am Veröffentlichungs-Gate, das eine einzelne Entität für sich prüft; wo immer sie gemeldet wird, ist sie ein Rat. Der Befund nennt die Komponente, die Verbindung, das Ziel und die beiden Slots und zitiert nie einen der beiden Locators. Ein Scrape — eine Verbindung am Socket scrape_target — wird danach beurteilt, was sein Ziel über seine Metriken angibt: gar nicht, wo die Annotation observability.aggrega.ai/metrics-credential des Ziels none sagt, nie gegen den Schlüssel des Ziels, wo sie separate-token sagt, und ansonsten wie jede andere Verbindung; eine Verbindung an einem anderen Socket wird beurteilt, gleich was das Ziel angibt.
Seine Meldung beginnt so:
a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one (eine Verbindung und das Ziel, das sie erreicht, nennen nicht denselben Schlüssel: Sie schreiben unterschiedliche Locators dafür, oder nur eines von beiden nennt einen)
So beheben Sie es: Lassen Sie beide Enden einen einzigen Parameter lesen — das Feld credential der Verbindung und das Feld api_key des Ziels —, damit der Schlüssel, den der Aufrufer vorlegt, und der Schlüssel, den der Server verifiziert, nicht auseinander geschrieben werden können; oder nehmen Sie, wo eine Verbindung keinen Schlüssel vorlegen soll, die Zugangsdaten von ihr. Welche Slots gelesen werden, was verglichen wird und das Opt-out stehen unter „Die Disziplinregeln“ in aggrega-lint.md.
The change being published breaks what the evolution rubric allows (Die zu veröffentlichende Änderung verletzt, was das Evolutionsraster erlaubt)
Eine Zurückweisung bei der Prüfung, die der Veröffentlichung vorausgeht, nicht bei einem Build. Die zu veröffentlichende Version wird mit der zuvor bereits veröffentlichten Version verglichen, und der Unterschied zwischen beiden wird anhand eines dokumentierten Rasters klassifiziert. Diese Bedingung meldet, dass der Unterschied einer ist, gegen den das Raster Einwände erhebt.
Sie braucht einen veröffentlichten Vorgänger zum Vergleich, daher sind sie und die Prüfung der Versionserhöhung unten die beiden Regeln dieser Gruppe, die nicht allein über lokale Inhalte laufen können: Ohne Abfrage einer Registry gibt es nichts zu vergleichen, und die Prüfung wird übersprungen statt bestanden.
Seine Meldung beginnt so:
the version being published changes the published predecessor in a way the documented evolution rubric objects to (die zu veröffentlichende Version ändert den veröffentlichten Vorgänger auf eine Weise, gegen die das dokumentierte Evolutionsraster Einwände erhebt)
So beheben Sie es: Lesen Sie die Klassifizierung in der Diagnose, die nennt, wogegen an der Änderung das Raster Einwände erhob, und machen Sie die Änderung entweder kompatibel oder veröffentlichen Sie sie unter einer Version, die sie zulässt. Das Raster ist unter „Das Raster für Versionserhöhungen“ in aggrega-lint.md dargelegt.
The version offered is a smaller bump than the change requires (Die angebotene Version ist eine kleinere Erhöhung, als die Änderung verlangt)
Eine Zurückweisung bei der Prüfung, die der Veröffentlichung vorausgeht, nicht bei einem Build. Die zu veröffentlichende Änderung wird anhand des Evolutionsrasters klassifiziert, und die dafür angebotene Version ist ein kleinerer Schritt, als diese Klassifizierung verlangt — etwa eine Entfernung oder eine Einschränkung, die als Patch angeboten wird. Eine zu große Erhöhung wird immer akzeptiert; eine zu kleine Erhöhung ist es, die hier anhält.
Anders als die Regeln davor wird diese hier entschieden statt vom Konventions-Plugin. Welche Erhöhung angeboten wurde, ist erst im Moment der Veröffentlichung bekannt, und dann läuft keine Kompilierung, daher wird der Vergleich zwischen der Klassifizierung und der angebotenen Version an diesem Punkt vorgenommen.
Seine Meldung beginnt so:
the version bump being published is smaller than the evolution check’s classification of the change requires (die zu veröffentlichende Versionserhöhung ist kleiner, als die Klassifizierung der Änderung durch die Evolutionsprüfung verlangt)
So beheben Sie es: Veröffentlichen Sie unter der Version, die die Klassifizierung verlangt; die Diagnose nennt, welche das ist. Sind Sie der Meinung, dass die Änderung kleiner ist, als sie klassifiziert wurde, sagt das Raster unter „Das Raster für Versionserhöhungen“ in aggrega-lint.md, was eine Änderung in die jeweilige Klasse einordnet. Die erste Veröffentlichung einer Entität hat keinen Vorgänger, daher wird der Vergleich übersprungen und als nicht durchgeführt statt als bestanden gemeldet.
An import stopped partway through translating a source (Ein Import wurde mitten in der Übersetzung einer Quelle angehalten)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Der Importer hat eine Diagnose gemeldet, die schwer genug ist, um die Übersetzung anzuhalten, daher ist das, was er erzeugt hat, unvollständig: Ein Teil der Quelle wurde zu Entwürfen von Authoring-Dateien und ein Teil nicht.
Das unvollständige Ergebnis ist beabsichtigt und kein Trümmerhaufen. Es benennt das Ergebnis und nicht die Ursache — was nicht übersetzt werden konnte, wird in den Diagnosen daneben gemeldet, eine pro Konstrukt, das der Importer nicht übertragen konnte, in den eigenen Worten des Importers. Diese Bedingung ermöglicht es einem Aufrufer, „der Import hat angehalten und einen Teil einer Antwort erzeugt“ von „der Import ist vollständig fehlgeschlagen“ zu unterscheiden, was unterschiedliche Situationen mit unterschiedlichen nächsten Schritten sind.
Seine Meldung beginnt so:
the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (der Importer hat eine Diagnose gemeldet, die den Import anhält, daher wurde die Quelle nicht vollständig in Entwürfe von Authoring-Dateien überführt)
So beheben Sie es: Lesen Sie die daneben gemeldeten Diagnosen — jede nennt ein Konstrukt in der Quelle, das der Importer nicht übersetzen konnte. Die Behebung liegt in der Quelle, die Sie übergeben haben, oder darin, den Entwurf von Hand fertigzustellen: Ein Import erzeugt einen Ausgangspunkt zum Bearbeiten, daher ist ein Konstrukt, das die Übersetzung nicht überstanden hat, direkt auf der Aggrega-Seite zu verfassen. aggrega-import.md beschreibt, was der Befehl erzeugt und wohin er schreibt.
More than one importer recognises the source (Mehr als ein Importer erkennt die Quelle)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Der Import hat kein Format genannt, daher wurde das Format anhand der Signaturen erkannt, die die Importer deklarieren — die im Katalog des Workspace ebenso wie die Core-Importer des Compilers, von denen jeder die Syntax nennt, in der eine Quelle gelesen wird, die Dateinamen, für die er gilt, und die Pfade, die sein geparster Baum enthalten muss oder nicht enthalten darf —, und Signaturen von Importern, die mehr als ein Format bedienen, passten auf die Quelle. Der Import wählt nicht zwischen ihnen: In welchem Format eine Quelle vorliegt, ist die Aussage der Importer, nicht die des Compilers, und eine Wahl wäre eine Vermutung, die die Quelle einem Importer übergibt, für den sie womöglich nicht bestimmt ist.
Dies ist nicht dasselbe wie ein Format, das von mehr als einem Importer ausgewiesen wird, beschrieben unter „A parse or import format is advertised by more than one plugin (Ein Parse- oder Importformat wird von mehr als einem Plugin ausgewiesen)“ weiter oben. Dort steht das Format fest und die Importer, die es bedienen, konkurrieren, sodass ein Eintrag plugins.importer unter ihnen wählt; hier unterscheiden sich die Formate selbst, sodass keine Anbindung die Sache entscheidet, wohl aber das Nennen des Formats. Ein Importer, der eine Quelle erkennt, erkennt sie als jedes Format, das er ausweist, daher wird auch ein Importer, der mehr als ein Format ausweist und von dessen Signaturen eine passt, hier zurückgewiesen.
Seine Meldung beginnt so:
more than one importer recognises the source (mehr als ein Importer erkennt die Quelle)
Der Rest der Meldung nennt die Quelle und jedes Format, als das sie erkannt wurde, in der Reihenfolge der Identitäten und Versionen der Importer, dann die Abhilfe:
more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>) (mehr als ein Importer erkennt die Quelle (angegebene Quelle, erkannt als die angegebenen Formate). Übergeben Sie —format, um das Format zu nennen, als das sie gelesen werden soll (zum Beispiel —format gefolgt von einem der Formate))
So beheben Sie es: Nennen Sie das Format — --format bei aggrega import oder format beim Import-Werkzeug des Assistenten und bei der Methode aggrega/import der Sitzung. Wo einer der Importer eine solche Quelle nie erkennen sollte, ist die Änderung an den Signaturen dieses Importers vorzunehmen, die sein Autor in seiner Selbstauskunft describe() deklariert und die seine Plugin-Entität festhält, wenn sie erzeugt wird; oder, wo es einer ist, den der Katalog des Workspace enthält, lassen Sie ihn aus dem Katalog heraus, den der Workspace liest — ein Core-Importer ist immer unter denen, die ausprobiert werden, daher wird eine Quelle, die einer von ihnen neben einem anderen Importer erkennt, durch das Nennen des Formats entschieden. aggrega-import.md beschreibt, wie ein Format erkannt wird.
No importer recognises the source (Kein Importer erkennt die Quelle)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Der Import hat kein Format genannt, daher wurde das Format anhand der Signaturen erkannt, die die Importer deklarieren — die im Katalog des Workspace ebenso wie die Core-Importer des Compilers —, und die Signaturen keines Formats passten auf die Quelle. Der Import rät nicht: Die Quelle einem Importer zu übergeben, der nie deklariert hat, dass er diese Form liest, würde einen Entwurf aus einer Quelle erstellen, für die er womöglich nicht bestimmt ist.
Dies ist das Gegenstück zu „More than one importer recognises the source (Mehr als ein Importer erkennt die Quelle)“ weiter oben. Dort beanspruchen mehrere Formate die Quelle; hier tut es keines. In beiden Fällen entscheidet das Nennen des Formats die Sache, und nichts wird geschrieben, bis es genannt ist.
Seine Meldung beginnt so:
no importer recognises the source (kein Importer erkennt die Quelle)
Der Rest der Meldung nennt die Quelle, dann die Abhilfe und jedes Format, das die Importer des Katalogs ausweisen, in der Reihenfolge, in der sie gelesen wurden:
no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (kein Importer erkennt die Quelle (angegebene Quelle). Übergeben Sie —format, um es ausdrücklich zu nennen (zum Beispiel —format gefolgt von einem der ausgewiesenen Formate))
Wo kein Importer überhaupt ein Format ausweist, sagt die Abhilfe dies anstelle der Beispiele.
Einem Verzeichnis wird eine andere Abhilfe angeboten, weil das Nennen irgendeines Formats ihm nicht helfen kann. Ein Verzeichnis wird nur über die Dateimuster gelesen, die sein Importer deklariert, und eine Signatur, die kein Dateimuster deklariert, gilt für keine der Dateien eines Verzeichnisses — daher wird ein Verzeichnis, das etwa einen einzigen Langflow-Export enthält, von keiner Signatur erkannt, und das Nennen des Formats langflow würde seinerseits unter An importer that declares no file patterns is handed a directory (Ein Importer, der keine Dateimuster deklariert, erhält ein Verzeichnis) zurückgewiesen. Die Zurückweisung eines Verzeichnisses benennt es deshalb als Verzeichnis und bietet an, eine seiner Dateien einzeln zu importieren oder ein Format zu nennen, dessen Importer Dateimuster deklariert — nur diese Formate, aus den eigenen Deklarationen der Importer abgelesen:
no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>) (kein Importer erkennt die Quelle (Verzeichnis). Importieren Sie eine der Dateien des Verzeichnisses einzeln, oder übergeben Sie —format mit einem Format, dessen Importer ein Verzeichnis über die von ihm deklarierten Dateimuster liest (zum Beispiel —format oder —format))
Wo kein Importer ein Dateimuster deklariert, bietet die Zurückweisung an, eine der Dateien des Verzeichnisses einzeln zu importieren, und gibt an, dass kein Importer im Katalog die Dateimuster deklariert, über die ein Verzeichnis gelesen wird.
So beheben Sie es: Nennen Sie das Format — --format bei aggrega import oder format beim Import-Werkzeug des Assistenten und bei der Methode aggrega/import der Sitzung, die die Zurückweisung jeweils um das Feld herum formulieren, das sie annehmen, und sie mit dem Kurzcode dieser Bedingung eröffnen; die Antwort der Sitzung trägt außerdem beide Codes der Bedingung in ihren Daten. Importieren Sie bei einem Verzeichnis die eine Datei, die Sie gemeint haben, einzeln — eine Signatur, die keine Datei nennt, gilt für eine einzeln importierte Datei, wie auch immer sie heißt — oder nennen Sie eines der Formate, die die Zurückweisung auflistet. Wo die Quelle hätte erkannt werden sollen, ist die Änderung an den Signaturen des Importers vorzunehmen, der ihr Format bedient, die sein Autor in seiner Selbstauskunft describe() deklariert und die seine Plugin-Entität festhält, wenn sie erzeugt wird. aggrega-import.md beschreibt, wie ein Format erkannt wird.
An importer that declares no file patterns is handed a directory (Einem Importer, der keine Dateimuster deklariert, wird ein Verzeichnis übergeben)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Die genannte Quelle ist ein Verzeichnis, und ein Verzeichnis wird seinem Importer genau als die Dateien übergeben, die die deklarierten Dateimuster des Importers auswählen — welche Dateien eines Verzeichnisses ein Importer liest, ist also die eigene Aussage des Importers. Der Importer, der das Format der Quelle bedient, deklariert keine Dateimuster: Er liest eine einzelne Datei und sagt nichts darüber, welche Dateien eines Verzeichnisses seine sind.
Nichts wird geöffnet. Der Import hält an, sobald der Importer aufgelöst ist und bevor irgendeine Datei des Verzeichnisses gelesen wird, statt dem Importer jede Datei zu übergeben, die das Verzeichnis enthält.
Seine Meldung beginnt so:
the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (der Importer, der das Format der Quelle bedient, deklariert keine Dateimuster, daher liest er eine einzelne Datei und kann kein Verzeichnis lesen)
Der Rest der Meldung nennt das Format, den Importer und das Verzeichnis so, wie Sie es genannt haben, dann die Abhilfe:
the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by (der Importer, der das Format der Quelle bedient, deklariert keine Dateimuster, daher liest er eine einzelne Datei und kann kein Verzeichnis lesen (angegebenes Format, angegebener Importer und angegebenes Verzeichnis). Importieren Sie stattdessen eine der Dateien des Verzeichnisses für sich allein; der Importer liest ein Verzeichnis, sobald er die Dateimuster deklariert, nach denen seine Dateien benannt sind)
So beheben Sie es: Importieren Sie eine Datei des Formats für sich allein. Damit ein Importer Verzeichnisse seines Formats liest, deklariert sein Autor die Muster, nach denen seine Dateien benannt sind — das Feld files einer Erkennungssignatur in seiner Selbstauskunft describe(), die seine Plugin-Entität festhält, wenn sie erzeugt wird. aggrega-import.md beschreibt, was ein Import eines Verzeichnisses liest.
No file in the directory matches the importer’s file patterns (Keine Datei im Verzeichnis passt auf die Dateimuster des Importers)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Die genannte Quelle ist ein Verzeichnis, das Format steht fest, und der Importer, der es bedient, deklariert Dateimuster — aber keine Datei, die das Verzeichnis enthält, passt in irgendeiner Tiefe auf eines davon. Dem Importer gar keine Quelle zu übergeben, würde ihn an einer leeren scheitern lassen, mit Worten über den Inhalt statt darüber, welche Dateien gelesen wurden, daher hält der Import hier an, ohne etwas gelesen zu haben.
Wo das Format erkannt statt genannt wurde, passte der Importer, dessen Signatur das Verzeichnis erkannt hat, auf eine seiner Dateien, daher trifft man diese Bedingung nur dort an, wo der ausgeführte Importer nicht dieser ist — ein anderer Importer desselben Formats, den ein Eintrag plugins.importer auswählt, oder eine andere Version davon.
Seine Meldung beginnt so:
no file in the directory matches the file patterns the importer serving the source’s format declares (keine Datei im Verzeichnis passt auf die Dateimuster, die der Importer deklariert, der das Format der Quelle bedient)
Der Rest der Meldung nennt das Format, den Importer, das Verzeichnis so, wie Sie es genannt haben, und jedes Muster, das der Importer deklariert, dann die Abhilfe:
no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds (keine Datei im Verzeichnis passt auf die Dateimuster, die der Importer deklariert, der das Format der Quelle bedient (angegebenes Format, angegebener Importer, angegebenes Verzeichnis und angegebene Dateimuster). Nennen Sie ein Verzeichnis, das eine Datei enthält, auf die eines dieser Muster passt, oder das Format eines Importers, dessen Muster auf die Dateien passen, die dieses Verzeichnis enthält)
So beheben Sie es: Importieren Sie das Verzeichnis, das die Dateien des Formats enthält — ein Muster wird gegen das Ende des Pfads einer Datei innerhalb des Verzeichnisses abgeglichen, daher zählt eine Datei in jeder Tiefe — oder nennen Sie das Format, in dem die Dateien des Verzeichnisses vorliegen. aggrega-import.md beschreibt, was ein Import eines Verzeichnisses liest.
A file read from the directory and a file named in the importer’s with.sources have the same name (Eine aus dem Verzeichnis gelesene Datei und eine in den Quellen des Importers genannte Datei haben denselben Namen)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Die genannte Quelle ist ein Verzeichnis, und seine Dateien erreichen den Importer als benannte Quellen, jede unter ihrem Pfad innerhalb des Verzeichnisses. Der Eintrag plugins.importer, der den Importer anbindet, nennt unter with.sources eigene Dateien, die ihn ebenfalls als benannte Quellen erreichen, jede unter ihrem Basisnamen — und ein Name wird von beiden getragen. Ein Name ist das, woran ein Importer eine Quelle von einer anderen unterscheidet, daher würde die Übergabe beider dazu führen, dass eine die andere verdeckt, ohne dass etwas sagt, welche; der Import hält stattdessen an, ohne etwas zu übergeben.
Seine Meldung beginnt so:
a file read from the directory and a file named in the importer’s with.sources have the same name (eine aus dem Verzeichnis gelesene Datei und eine in den Quellen des Importers genannte Datei haben denselben Namen)
Der Rest der Meldung nennt den Namen und die Datei aus with.sources, dann die Abhilfe:
a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources (eine aus dem Verzeichnis gelesene Datei und eine in den Quellen des Importers genannte Datei haben denselben Namen (angegebener Name, angegebene with.sources-Datei). Jede Quelle erreicht den Importer unter einem einzigen Namen, daher benennen Sie eine der beiden Dateien um oder lassen Sie die Datei aus den with.sources des Importers heraus)
So beheben Sie es: Benennen Sie eine der beiden Dateien um, oder nehmen Sie die Datei aus dem Feld with.sources des Eintrags heraus, wo das Verzeichnis sie bereits enthält. Eine Datei aus with.sources behält ihren Basisnamen, daher trifft sie auf eine gleichnamige Datei auf der obersten Ebene des Verzeichnisses; eine Datei in einem darunterliegenden Verzeichnis trägt dieses Verzeichnis in ihrem Namen. Welcher Importer eine Quelle in Entwürfe überführt beschreibt das Feld with.sources eines Eintrags.
An import’s target names a capability no Recipe in the catalog binds to (Das Ziel eines Imports nennt eine Fähigkeit, an die sich kein Recipe im Katalog bindet)
Eine Zurückweisung bei der Überführung einer fremden Quellbeschreibung in Entwürfe von Authoring-Dateien, nicht bei einem Build. Dem Import wurde ein Ziel übergeben — --target bei aggrega import oder target beim Import-Werkzeug des Assistenten und bei der Methode aggrega/import der Sitzung —, damit er ein Manifest entwirft, das jeden entworfenen Komponententyp auf ein Recipe dieses Providers abbildet. Das Ziel ist eine Provider-Fähigkeit, die mit dem spec.capability abgeglichen wird, an das sich jedes Recipe im Katalog des Workspace bindet, und kein Recipe dort bindet sich an die angegebene. Ein dafür entworfenes Manifest würde gar nichts abbilden, und jeder Komponententyp würde dann als im Katalog fehlend erscheinen, obwohl das, was falsch ist, die Option selbst ist — meist ein Tippfehler.
Nichts läuft, und nichts wird geschrieben. Der Import hält an, sobald der Katalog geladen ist, bevor das Format der Quelle erkannt wird und bevor der Importer läuft, daher wird kein Entwurf erzeugt und keine Datei geschrieben, auch nicht bei einem Probelauf.
Seine Meldung beginnt so:
no Recipe in the workspace’s catalog binds to the capability the import’s target names (kein Recipe im Katalog des Workspace bindet sich an die Fähigkeit, die das Ziel des Imports nennt)
Der Rest der Meldung nennt das Ziel genau so, wie es angegeben wurde, und die Fähigkeiten, an die sich die Recipes des Katalogs tatsächlich binden, jede einmal und sortiert, dann die Abhilfe:
no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written (kein Recipe im Katalog des Workspace bindet sich an die Fähigkeit, die das Ziel des Imports nennt (angegebenes Ziel, Fähigkeiten, an die sich die Recipes des Katalogs binden). Nennen Sie eine dieser Fähigkeiten als Ziel, oder lassen Sie das Ziel weg, dann wird kein Manifest entworfen; nichts wurde entworfen oder geschrieben)
Wo der Katalog überhaupt kein Recipe enthält, sagt die Meldung dies anstelle der Liste, und die Abhilfe besteht darin, dem Katalog ein Recipe des Providers hinzuzufügen.
So beheben Sie es: Nennen Sie eine der Fähigkeiten, die die Meldung auflistet — etwa compose oder helm, wie das spec.capability eines Recipe sie schreibt — oder lassen Sie das Ziel weg, wodurch kein Manifest entworfen wird. Wo der Provider, den Sie meinten, einer ist, für den der Katalog noch kein Recipe enthält, fügen Sie seine Recipes einem Katalogordner hinzu, den der Workspace zuerst liest. aggrega-import.md beschreibt, was ein Import entwirft, dem ein Ziel übergeben wurde.
A child Release inherits a boundary directory that resolves where its parent writes (Ein Kind-Release erbt ein Boundary-Verzeichnis, das dorthin aufgelöst wird, wohin sein Eltern-Release schreibt)
Ein Hinweis. Ein Release erweitert ein anderes und erbt von ihm das Ausgabeverzeichnis einer Boundary, und dieses Verzeichnis enthält keine Template-Variable — daher wird es für beide zu demselben Pfad aufgelöst, und der Build des Kindes schreibt dorthin, wohin der Build des Elternteils schreibt.
Das Verzeichnis zu erben ist die unterstützte Form und kein Fehler. Ein Verzeichnis ist ein Template, daher schreibt ein Elternteil es einmal, und ein Kind, das einen Parameter erfüllt, löst es anderswohin auf, ohne dass etwas dupliziert wird; genau deshalb muss ein Kind die Boundary-Topologie seines Elternteils nicht wiederholen. Eng und real ist der Restfall, den dies benennt: Ohne Variable darin bleibt nichts übrig, das anders aufgelöst werden könnte.
Er kann nicht anhalten, und das ist eine Eigenschaft der Regel und keine Vorsicht ihr gegenüber. In denselben aufgelösten Pfad zu schreiben, ist etwas, das ein Autor legitimerweise beabsichtigen kann — ein Kind, das nur die rendernden Recipes austauscht, um deren Ausgabe zu vergleichen, oder das nur die Dimensionierung ändert —, daher würde eine Regel, die auf diese Schlussfolgerung hin anhält, zulässige Eingaben auf eine Vermutung hin zurückweisen.
Seine Meldung beginnt so:
inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to (das geerbte Boundary-Verzeichnis enthält keine Template-Variable, daher wird es zu dem Pfad aufgelöst, in den das erweiterte Release schreibt)
So beheben Sie es: Wo die beiden an verschiedene Orte schreiben sollten, setzen Sie eine Parameterreferenz in das Verzeichnis und lassen Sie jedes Release sie erfüllen. Wo das Schreiben in einen einzigen Pfad das ist, was Sie meinten, muss nichts geändert werden — der Hinweis hat Ihnen gesagt, was er tun wird, und der Build erzeugt seine Ausgabe so oder so.
Einen Abbruch anhand des Kurzcodes finden, den der Build ausgegeben hat
Der Kopf in eckigen Klammern einer anhaltenden Diagnose nennt die Kategorie, der der Fehler zuzuordnen ist, und, wo der Fehler eine der hier katalogisierten Bedingungen nennt, den Kurzcode dieser Bedingung — den Buchstaben E und vier Ziffern, wie in [CATALOG_ERROR E0209]. Eine Nummer wird einmal vergeben und bleibt dann fest, daher nennt ein Kurzcode, den Sie in einen Bericht oder eine Suche einfügen, immer noch die Bedingung, die er nannte, als Sie ihn festgehalten haben. Die beiden anderen Bezeichner, die eine Bedingung trägt, und welchen der drei man wann verwendet, werden in sentinels.md erklärt.
Die eigene Meldungszeile der Bedingung beginnt mit einem festen Satz, der die Bedingung angibt. Alles nach diesem Satz variiert mit dem Auftreten — das fehlerhafte Dokument, der verfasste Schlüssel, der betroffene Wert und der Rat für dieses Auftreten —, und die Einträge oben zitieren die gesamte Form für die Bedingung, die jeder von ihnen dokumentiert. Der feste Satz ist der Teil, der jedes Mal gleich ist, und genau das macht ihn zu dem Teil, auf den man abgleicht.
Die folgende Tabelle stellt beides gegenüber, beschränkt auf diese Seite: für jede hier katalogisierte Bedingung den Kurzcode, den ein Build ausgibt, und den Satz, mit dem ihre Meldungszeile beginnt, neben dem Eintrag oben, der die Behebung beim Verfassen erklärt. Die Überschriften der Einträge werden exakt zitiert, sodass die Suche nach einer davon auf dieser Seite zu ihrem Eintrag führt. Die Tabelle aller Bedingungen löst einen Kurzcode über jede Bedingung auf, die der Compiler deklariert, einschließlich derer, die kein Eintrag hier abdeckt.
Wo ein Eintrag neben zwei Kurzcodes erscheint, deckt er zwei verschiedene Bedingungen ab, und jede registriert ihren eigenen Satz; lesen Sie die Sätze statt der gemeinsamen Überschrift, um zu erkennen, welche ein Build gemeldet hat.
aggrega explain <code> führt diese Suche für Sie im Terminal durch, nimmt einen der beiden Codes der Bedingung entgegen und gibt die Bedingung zusammen mit dem Eintrag oben aus, der sie dokumentiert. Es wird in aggrega explain beschrieben.
Kurzcode
Beginnt mit
Dokumentiert unter
E0001
cliplugin: no plugin resolver configured
A command-line plugin runner was built without a way to find plugins (Ein Befehlszeilen-Plugin-Runner wurde ohne eine Möglichkeit gebaut, Plugins zu finden)
annotation contribution overridden by an explicit value
An explicit value displaced one an annotation supplied (Ein expliziter Wert hat einen von einer Annotation gelieferten verdrängt)
E0005
policy violation
A governance plugin rejected the build (Ein Governance-Plugin hat den Build abgelehnt)
E0006
required attachment slot unfilled
Required attachment slot not bound (Erforderlicher Anbindungs-Slot nicht gebunden)
E0007
selector violation
Cross-node type safety violation via selector: (Verletzung der knotenübergreifenden Typsicherheit über selector)
E0008
attachment slot selector unsatisfied
The Feature filling an attachment slot does not satisfy the slot’s selector (Das Feature, das einen Anbindungs-Slot füllt, erfüllt den Selektor des Slots nicht)
E0009
pipeline step typed-I/O contract violation
A pipeline step’s typed input or output does not satisfy its declared contract (Die typisierte Eingabe oder Ausgabe eines Pipeline-Schritts erfüllt ihren deklarierten Vertrag nicht)
E0010
pipeline step failed
A pipeline step failed (Ein Pipeline-Schritt ist fehlgeschlagen)
E0011
pipeline patch targets a document not present in the set
A pipeline patch addresses a document the set does not hold, or one with no tree to address (Ein Pipeline-Patch adressiert ein Dokument, das die Menge nicht enthält, oder eines ohne adressierbaren Baum)
E0012
pipeline patch targets an opaque (non-structured) unit
A pipeline patch addresses a document the set does not hold, or one with no tree to address (Ein Pipeline-Patch adressiert ein Dokument, das die Menge nicht enthält, oder eines ohne adressierbaren Baum)
E0013
feature type mismatch between Aggregate and Release
Feature type mismatch between Aggregate and Release (Nichtübereinstimmung des Feature-Typs zwischen Aggregate und Release)
E0014
inject entry carries both `value:` and `from:`; schema requires exactly one
An inject: entry carries both a literal and a source key (Ein Inject-Eintrag trägt sowohl ein Literal als auch einen Quellschlüssel)
E0015
uses-edge inject dictates a delivery mechanism the socket does not permit
uses edge dictates delivery on a socket that allowlists none (Eine Kante gibt die Zustellung an einem Socket vor, der keinen Mechanismus zulässt); uses edge dictates a delivery mechanism outside the socket’s allowlist (Eine Kante gibt einen Zustellungsmechanismus außerhalb der Allowlist des Sockets vor)
E0016
jsonpatch: test operation failed
A patch’s test operation did not match the document (Die Testoperation eines Patches stimmte nicht mit dem Dokument überein)
E0017
annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys
An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Ein annotation-transform-Plugin nennt eine Komponente, die es nicht erhalten hat, oder injiziert einen Wert, den keine Annotation annimmt)
E0018
policy attachment settings do not satisfy the plugin's declared settings schema
A governance attachment’s settings do not match the plugin’s declared schema (Die Einstellungen einer Governance-Anbindung entsprechen nicht dem deklarierten Schema des Plugins)
E0019
endpoint requires form: reference
A workload: form and the fields beside it do not agree (Die Form einer Workload und die Felder daneben stimmen nicht überein)
E0020
schedule is not a valid cron expression
A workload schedule: is not an expression the check accepts (Der Zeitplan einer Workload ist kein Ausdruck, den die Prüfung akzeptiert)
E0021
persistentTemplate volume requires form: stateful
A workload: form and the fields beside it do not agree (Die Form einer Workload und die Felder daneben stimmen nicht überein)
E0022
pipeline PATCH target is not parseable structured YAML/JSON
A pipeline step addresses documents the node does not have (Ein Pipeline-Schritt adressiert Dokumente, die der Knoten nicht hat)
E0023
form: reference requires an endpoint
A workload: form and the fields beside it do not agree (Die Form einer Workload und die Felder daneben stimmen nicht überein)
E0024
schedule requires form: scheduled
A workload: form and the fields beside it do not agree (Die Form einer Workload und die Felder daneben stimmen nicht überein)
E0025
form: scheduled requires a schedule
A workload: form and the fields beside it do not agree (Die Form einer Workload und die Felder daneben stimmen nicht überein)
E0026
imported artifact content does not match the digest recorded for it in entity.lock
An imported artifact no longer matches the digest recorded beside its Recipe (Ein importiertes Artefakt stimmt nicht mehr mit dem neben seinem Recipe erfassten Digest überein)
E0027
artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)
A library $import: is not written in the bare-name form (Ein Bibliotheksimport ist nicht in der Form mit bloßem Namen geschrieben)
E0028
artifacts output filename collision: two artifact outputs carry the same filename
Two artifact outputs of one Recipe carry the same filename (Zwei Artefaktausgaben eines Recipe tragen denselben Dateinamen)
E0029
artifact template references a pillar the Recipe does not declare
An artifacts: template reads a pillar the Recipe does not declare (Ein artifacts-Template liest eine Säule, die das Recipe nicht deklariert)
E0030
artifact-library import references a bundle not present in the ArtifactLibrary
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
E0031
artifact-library import references an ArtifactLibrary not present in the catalog
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
E0032
assembled output collision: two contributors write the same output path
Two contributors write the same output path (Zwei Beitragende schreiben denselben Ausgabepfad)
E0033
assertion failed
An assertion stopped the build (Eine Assertion hat den Build angehalten)
E0034
duplicate delivery key across attachment-inject and another inject source
An attachment delivers a key another inject source already claimed (Eine Anbindung stellt einen Schlüssel zu, den eine andere Inject-Quelle bereits beansprucht hat)
E0035
provider expected to assemble its dispatch group provides no boundary assembler
The plugin serving a provider cannot assemble what that provider combines (Das Plugin, das einen Provider bedient, kann nicht assemblieren, was dieser Provider kombiniert)
E0036
merged-path assembly has conflicting assembly-name annotation values
Chart-name mismatch on a merged helm-chart umbrella (Abweichender Chart-Name bei einem zusammengeführten helm-chart-Umbrella-Chart)
E0037
cross-boundary link between endpoints rendered by different providers is not supported
A connection crosses between two different providers’ assembled outputs (Eine Verbindung verläuft zwischen den assemblierten Ausgaben zweier verschiedener Provider)
E0038
derived name collision: one name is derived more than once in one key space
The same name is derived more than once inside the output (Derselbe Name wird innerhalb der Ausgabe mehr als einmal abgeleitet)
E0039
FeatureRecipe template references a per-component-only field with executionScope: boundary
FeatureRecipe template references a field outside its scope’s allowlist (Das FeatureRecipe-Template verweist auf ein Feld außerhalb der Allowlist seines Geltungsbereichs)
E0040
library $import: carries a registry host; reference the library by bare-name identity
A library $import: addresses its library by registry location (Ein Bibliotheksimport adressiert seine Bibliothek über ihren Registry-Ort)
E0041
multiple contributors share an instance ID at the same dispatch path
Instance-ID collision across boundaries assembling to the same path (Instanz-ID-Kollision zwischen Boundaries, die am selben Pfad assemblieren)
E0042
locals entry references a sibling defined later in the same block
locals: entry references a sibling defined later in the same block (Ein locals-Eintrag verweist auf einen Geschwistereintrag, der später im selben Block definiert ist)
E0043
template references a key the locals block does not declare
locals: key does not exist (Der locals-Schlüssel existiert nicht)
E0044
mapping-library import references an entry not present in the MappingLibrary
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
E0045
valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)
A library $import: is not written in the bare-name form (Ein Bibliotheksimport ist nicht in der Form mit bloßem Namen geschrieben)
E0046
mapping-library import references a MappingLibrary not present in the catalog
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
E0047
assembled output retains an unresolved cross-boundary link placeholder
Assembled output still carries a cross-boundary placeholder (Die assemblierte Ausgabe trägt noch einen Boundary-übergreifenden Platzhalter)
E0048
dispatch path produced multiple provider outputs
Path collision: two contributors emit at incompatible paths (Pfadkollision: Zwei Beitragende geben an inkompatiblen Pfaden aus)
E0049
path template references a field not in the documented allowlist
Path-template references a variable outside the allowlist (Das Pfad-Template verweist auf eine Variable außerhalb der Allowlist)
E0050
pipeline /host operation from a step with no host component
A pipeline step addresses documents the node does not have (Ein Pipeline-Schritt adressiert Dokumente, die der Knoten nicht hat)
E0051
pipeline PATCH targets an assembler provider's pre-assembly fragments
A pipeline patch addresses output that has not been assembled yet (Ein Pipeline-Patch adressiert Ausgabe, die noch nicht assembliert wurde)
E0052
pipeline PATCH targets a document the node did not emit
A pipeline step addresses documents the node does not have (Ein Pipeline-Schritt adressiert Dokumente, die der Knoten nicht hat)
E0053
pipeline plugin is not compatible with the rendering provider
A pipeline step’s plugin does not claim the provider rendering what it addresses (Das Plugin eines Pipeline-Schritts beansprucht nicht den Provider, der rendert, was der Schritt adressiert)
E0054
provider rejected node input
A provider refused a node’s input (Ein Provider hat die Eingabe eines Knotens abgelehnt)
E0055
Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares
A Recipe or FeatureRecipe does not publish a provides key its contract declares (Ein Recipe oder FeatureRecipe veröffentlicht keinen provides-Schlüssel, den sein Vertrag deklariert)
E0056
provides template evaluation failed
A provides: template could not be evaluated (Ein provides-Template kann nicht ausgewertet werden)
E0057
provides block references a root outside the self-contained set
provides: template references a non-self-contained root (Das provides-Template verweist auf eine nicht in sich geschlossene Wurzel)
E0058
provider render is not deterministic
A provider rendered the same input twice and produced different output (Ein Provider hat dieselbe Eingabe zweimal gerendert und unterschiedliche Ausgaben erzeugt)
E0059
duplicate delivery key across self-inject and uses-inject
Duplicate delivery key across inject sources (Doppelter Zustellungsschlüssel über Inject-Quellen hinweg)
E0060
template references a root the render context does not define
Template references a root the render context does not define (Das Template verweist auf eine Wurzel, die der Render-Kontext nicht definiert); Self-inject value template references cross-node data (Das Werte-Template des Self-Inject verweist auf knotenübergreifende Daten)
E0061
unknown provider
Unknown provider (Unbekannter Provider)
E0062
custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping
A component declares an inject mechanism the attached Feature maps nothing to (Eine Komponente deklariert einen Inject-Mechanismus, auf den das angebundene Feature nichts abbildet)
E0063
workload-library import references an entry not present in the WorkloadLibrary
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
E0064
workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)
A library $import: is not written in the bare-name form (Ein Bibliotheksimport ist nicht in der Form mit bloßem Namen geschrieben)
E0065
workload-library import references a WorkloadLibrary not present in the catalog
A library $import: names a library or an entry the catalog does not hold (Ein Bibliotheksimport nennt eine Bibliothek oder einen Eintrag, die der Katalog nicht enthält)
E0066
uses edge target does not exist
Dangling uses target (Hängendes Kantenziel)
E0067
active toggle did not resolve to a boolean
An active: toggle does not resolve to true or false (Ein Schalter wird nicht zu true oder false aufgelöst)
E0068
max sub-aggregate nesting depth exceeded
Sub-aggregate nesting depth exceeded (Verschachtelungstiefe von Sub-Aggregaten überschritten)
E0069
mutator patch rejected
A label-transform plugin’s patch reaches outside node labels (Der Patch eines label-transform-Plugins reicht über die Knoten-Labels hinaus)
E0070
re-exported component alias forms a cycle
A re-published component alias points back at itself (Ein erneut veröffentlichter Komponenten-Alias verweist auf sich selbst)
E0071
release edge retargets a developer-declared edge
Release retargets a developer-declared edge (Das Release ändert das Ziel einer vom Entwickler deklarierten Kante)
E0072
sub-aggregate load failed
A module a composition imports cannot be loaded, or imports itself (Ein Modul, das eine Komposition importiert, kann nicht geladen werden oder importiert sich selbst)
E0073
flattened node ID collision: rename one of the colliding instances so their flattened IDs differ
Two instances flatten to one identifier (Zwei Instanzen werden zu einem einzigen Bezeichner abgeflacht)
E0074
release per-edge configuration has no edge to apply to
Release per-edge configuration has no edge to apply to (Die kantenbezogene Konfiguration des Release hat keine Kante, auf die sie angewendet werden kann)
An Aggregate reached graph building without being normalised (Ein Aggregate hat den Graphaufbau erreicht, ohne normalisiert worden zu sein)
E0076
sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`
A sub-module’s components are placed in no boundary (Die Komponenten eines Untermoduls sind in keiner Boundary platziert)
E0077
uses edge target was pruned because its active toggle resolved to false
A uses edge targets a component an active: toggle removed (Eine Kante zielt auf eine Komponente, die ein Schalter entfernt hat)
E0078
producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call
A plugin asks the host to parse a source while a parse is already running for it (Ein Plugin bittet den Host, eine Quelle zu parsen, während für es bereits ein Parse-Vorgang läuft)
E0079
wasm: recorded command mirror does not match plugin describe()
A Plugin entity’s recorded command set does not match the plugin (Die erfasste Befehlsmenge einer Plugin-Entität stimmt nicht mit dem Plugin überein)
E0080
wasm: entity contract claim does not match plugin describe()
A Plugin entity’s claims disagree with the plugin’s own self-report (Die Angaben einer Plugin-Entität widersprechen der eigenen Plugin-Selbstauskunft)
E0081
wasm: guest plugin returned a diagnostic whose severity the contract does not declare
A plugin returned a diagnostic at a severity that is not declared (Ein Plugin hat eine Diagnose mit einem nicht deklarierten Schweregrad zurückgegeben)
E0082
wasm: guest plugin reported an error
A plugin failed while it was running (Ein Plugin ist während der Ausführung fehlgeschlagen)
E0083
wasm: guest plugin panicked during call
A plugin failed while it was running (Ein Plugin ist während der Ausführung fehlgeschlagen)
E0084
wasm: stamped host-function record does not match .wasm imports
A Plugin entity’s recorded host functions do not match the binary (Die erfassten Host-Funktionen einer Plugin-Entität stimmen nicht mit der Binärdatei überein)
E0085
wasm: plugin rejected by the sandbox
The sandbox refused a plugin (Die Sandbox hat ein Plugin zurückgewiesen)
E0086
wasm: plugin invoked proc_exit
A plugin failed while it was running (Ein Plugin ist während der Ausführung fehlgeschlagen)
E0087
wasm: declared plugin type does not match plugin describe()
A plugin is not the kind of plugin the socket expects (Ein Plugin ist nicht die Art von Plugin, die der Socket erwartet)
E0088
wasm: entity metadata.version does not match plugin describe()
A Plugin entity’s recorded version does not match the plugin (Die erfasste Version einer Plugin-Entität stimmt nicht mit dem Plugin überein)
E0089
every published version this reference could select has been withdrawn
Every version a reference could select has been withdrawn (Jede Version, die eine Referenz auswählen könnte, wurde zurückgezogen)
E0090
format is advertised by more than one importer plugin
A parse or import format is advertised by more than one plugin (Ein Parse- oder Importformat wird von mehr als einem Plugin ausgewiesen)
E0091
format is advertised by more than one parser plugin
A parse or import format is advertised by more than one plugin (Ein Parse- oder Importformat wird von mehr als einem Plugin ausgewiesen)
E0092
capability is served by more than one provider plugin; add a plugins.providers entry to select one
A capability is served by more than one provider plugin (Eine Fähigkeit wird von mehr als einem Provider-Plugin bedient)
E0093
manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous
A Manifest maps two version-distinct keys onto one type (Ein Manifest bildet zwei versionsverschiedene Schlüssel auf einen einzigen Typ ab)
E0094
duplicate entity identity within a single catalog directory
Two catalog entities in one directory share an identity (Zwei Katalogentitäten in einem Verzeichnis teilen sich eine Identität)
E0095
malformed recipe reference in a Manifest mapping value
Manifest mapping value is not a shape a recipe reference accepts (Der Mapping-Wert im Manifest hat keine Struktur, die eine Rezeptreferenz akzeptiert)
E0096
manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key
Recipe implements does not match the mapped component type (Die Implementierungsangabe des Recipe passt nicht zum zugeordneten Komponententyp)
E0097
no importer plugin advertises the requested format
No plugin advertises a requested parse or import format (Kein Plugin weist ein angefordertes Parse- oder Importformat aus)
E0098
no parser plugin advertises the requested format
No plugin advertises a requested parse or import format (Kein Plugin weist ein angefordertes Parse- oder Importformat aus)
E0099
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type
No Recipe is mapped for a component or feature instance (Für eine Komponenten- oder Feature-Instanz ist kein Recipe zugeordnet)
E0100
plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches
A plugins.providers binding names a plugin that does not serve the capability (Eine Bindung benennt ein Plugin, das die Fähigkeit nicht bedient)
E0101
no provider-rendering plugin version satisfies the recipe's provider version pin
No provider plugin version satisfies a Recipe’s provider pin (Keine Provider-Plugin-Version erfüllt den Provider-Pin eines Recipe)
E0102
wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path
A plugin reference carries a registry host or an artifact path (Eine Plugin-Referenz enthält einen Registry-Host oder einen Artefaktpfad)
E0103
no catalog version satisfies the referenced version constraint
No catalog version satisfies a version constraint (Keine Katalogversion erfüllt eine Versionseinschränkung)
E0104
wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location
A plugin or recipe reference carries no scope (Eine Plugin- oder Rezept-Referenz hat keinen Geltungsbereich)
E0105
recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location
A plugin or recipe reference carries no scope (Eine Plugin- oder Rezept-Referenz hat keinen Geltungsbereich)
E0106
resolve: invalid library reference URI
A library reference is not written in the identity form (Eine Bibliotheksreferenz ist nicht in der Identitätsform geschrieben)
E0107
resolve: minimal version selection conflict — incompatible library version requirements
Two consumers of one library require incompatible versions (Zwei Konsumenten einer Bibliothek verlangen inkompatible Versionen)
The catalog view a build was given cannot load the bodies pinning needs (Die Katalogsicht, die ein Build erhalten hat, kann die Inhalte nicht laden, die das Pinning benötigt)
E0109
resolve: catalog lookup cannot load resolved recipe and plugin bodies
The catalog view a build was given cannot load the bodies pinning needs (Die Katalogsicht, die ein Build erhalten hat, kann die Inhalte nicht laden, die das Pinning benötigt)
E0110
resolve: source-template evaluation failure at lock time
Resolving a source: coordinate registers a narrower function set (Das Auflösen einer source-Koordinate registriert eine engere Funktionsmenge)
E0111
resolve: source-template parse error
Resolving a source: coordinate registers a narrower function set (Das Auflösen einer source-Koordinate registriert eine engere Funktionsmenge)
Resolving a source: coordinate registers a narrower function set (Das Auflösen einer source-Koordinate registriert eine engere Funktionsmenge)
E0113
resolve: sub-aggregate inclusion depth exceeded
The chain of module imports is deeper than the pin walk descends (Die Kette der Modulimporte ist tiefer, als der Pinning-Durchlauf hinabsteigt)
E0114
resolve: no entity in the catalog matches this URI
A reference names no entity the catalog holds (Eine Referenz benennt keine Entität, die der Katalog enthält)
E0115
compactform: ambiguous dispatch — $mode required
A compact-form schema declares a field literally named type (Ein Schema in Kompaktform deklariert ein Feld, das buchstäblich so heißt)
E0116
compactform: constraint not valid for declared type
A compact-form constraint does not apply to the type it was written on (Eine Einschränkung in Kompaktform gilt nicht für den Typ, an dem sie geschrieben wurde)
E0117
compactform: $jsonschema content invalid
A $jsonschema: escape carries content that is not a schema (Ein Escape enthält Inhalt, der kein Schema ist)
E0118
compactform: cross-document $ref carries a registry host; reference the library by identity
A $ref: addresses a library by registry location (Ein Verweis adressiert eine Bibliothek über ihren Registry-Ort)
E0119
compactform: $ref unresolvable
A $ref: is not written in a form the compiler can resolve (Ein Verweis ist nicht in einer Form geschrieben, die der Compiler auflösen kann)
E0120
compactform: unknown keyword
A compact-form schema uses a keyword the compact form does not know (Ein Schema in Kompaktform verwendet ein Schlüsselwort, das die Kompaktform nicht kennt)
E0121
compactform: cross-document $ref target not found
A $ref: is not written in a form the compiler can resolve (Ein Verweis ist nicht in einer Form geschrieben, die der Compiler auflösen kann)
E0122
deprecation: build consumes a deprecated entity
The build consumes an artifact its publisher has deprecated (Der Build verwendet ein Artefakt, das sein Herausgeber als veraltet markiert hat)
E0123
docscache: artifact is not a documentation bundle
A resolved artifact is not a documentation bundle (Ein aufgelöstes Artefakt ist kein Dokumentations-Bundle)
E0124
docscache: page not found in documentation bundle
A page is absent from a documentation bundle (Eine Seite fehlt in einem Dokumentations-Bundle)
E0125
egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache
The workspace is offline and the step needs the network (Der Workspace ist offline, und der Schritt benötigt das Netzwerk)
E0126
externalinputs: acquisition is disabled for unpinned inputs
A render requests an external input the lockfile does not pin (Ein Rendering fordert eine externe Eingabe an, die das Lockfile nicht pinnt)
E0127
externalinputs: fetched bytes mismatch the pinned digest
Fetched bytes do not match a pinned digest (Abgerufene Bytes stimmen nicht mit einem gepinnten Digest überein)
E0128
externalinputs: URL scheme is not allowed
An external input’s URL uses a scheme that is not allowed (Die URL einer externen Eingabe verwendet ein nicht zulässiges Schema)
E0129
externalinputs: store blob mismatches its pinned record
A stored external input no longer matches its record (Eine gespeicherte externe Eingabe stimmt nicht mehr mit ihrem Eintrag überein)
E0130
lockfile: out of date; it no longer matches what its Release resolves to
The lockfile no longer matches what the release resolves to (Das Lockfile stimmt nicht mehr mit dem überein, worauf das Release aufgelöst wird)
E0131
lockfile: file failed schema validation
The lockfile does not satisfy its schema (Das Lockfile erfüllt sein Schema nicht)
E0132
oci: manifest has multiple layers of the expected content media type
A manifest carries no layer of the expected kind, or more than one (Ein Manifest enthält keinen Layer des erwarteten Typs oder mehr als einen)
E0133
oci: cached manifest digest mismatch
Fetched or cached bytes do not match the digest committed for them (Abgerufene oder zwischengespeicherte Bytes stimmen nicht mit dem für sie festgeschriebenen Digest überein)
E0135
oci: content digest mismatch
Fetched or cached bytes do not match the digest committed for them (Abgerufene oder zwischengespeicherte Bytes stimmen nicht mit dem für sie festgeschriebenen Digest überein)
E0136
oci: network unreachable
The registry could not be reached (Die Registry ist nicht erreichbar)
E0137
oci: artifact not found at remote source
An artifact is not at the source the build was told to find it (Ein Artefakt befindet sich nicht an der Quelle, an der der Build es finden sollte)
E0138
oci: authentication required or failed
The registry will not serve an artifact without credentials it accepts (Die Registry liefert ein Artefakt nicht ohne Anmeldedaten aus, die sie akzeptiert)
E0139
oci: tag already published with different content
A tag is already published with different content (Ein Tag ist bereits mit anderem Inhalt veröffentlicht)
E0140
oci: manifest has no layer of the expected content media type
A manifest carries no layer of the expected kind, or more than one (Ein Manifest enthält keinen Layer des erwarteten Typs oder mehr als einen)
E0141
oci: distinct catalog identities map to the same OCI repository location
Two catalog identities publish to one repository location (Zwei Katalogidentitäten veröffentlichen an denselben Repository-Speicherort)
E0142
oci: referrer discovery could not be completed
The registry could not answer what is attached to an artifact (Die Registry konnte nicht beantworten, was an ein Artefakt angebunden ist)
E0143
oci: unknown entity kind for mediatype dispatch
An entity kind has no artifact media type (Ein Entitätstyp hat keinen Artefakt-Medientyp)
E0144
cached signature bundle does not match its recorded digest
A cached signature bundle does not match the digest recorded for it (Ein zwischengespeichertes Signatur-Bundle stimmt nicht mit dem dafür erfassten Digest überein)
E0145
plugin reference is not a Plugin entity
A plugin reference is not a Plugin entity (Ein Plugin-Verweis ist keine Plugin-Entität)
E0146
circular reference expansion
A library reference expands into itself (Eine Bibliotheksreferenz expandiert in sich selbst)
E0147
registrytrust: advertised trust config is malformed
A registry serves a trust document that cannot be read as one (Eine Registry liefert ein Vertrauensdokument, das nicht als solches gelesen werden kann)
E0148
registrytrust: registry advertises no trust config
A registry publishes no trust document (Eine Registry veröffentlicht kein Vertrauensdokument)
E0149
attachment name is a near miss for a declared slot
An attachment name is one edit from a declared slot (Ein Anbindungsname ist eine Bearbeitung von einem deklarierten Slot entfernt)
E0150
attachment does not conform to its declared slot shape
Attachment does not conform to its declared slot shape (Anbindung entspricht nicht der deklarierten Form ihres Slots)
E0151
component declared in more than one boundary: declare each component in exactly one boundary
A component is placed in more than one boundary (Eine Komponente ist in mehr als einer Boundary platziert)
E0152
duplicate Aggregate/Manifest identity (metadata.name) in the Release directory
The Release directory declares one Aggregate or Manifest twice (Das Release-Verzeichnis deklariert ein Aggregate oder ein Manifest zweimal)
E0153
feature merge conflict: reconcile the Aggregate and Release declarations for the feature
A feature attached by both the Aggregate and the Release cannot be merged (Ein sowohl vom Aggregate als auch vom Release angebundenes Feature kann nicht zusammengeführt werden)
E0154
the compiler's own views of the catalog disagree
A guard needs a catalog entity the build resolved and cannot see (Ein Guard benötigt eine Katalogentität, die der Build aufgelöst hat und nicht sehen kann)
E0155
duplicate delivery key across inject sources
Duplicate delivery key across inject sources (Doppelter Zustellungsschlüssel über Inject-Quellen hinweg)
E0156
invalid inject key: the from-key must name a provides key its source publishes
Inject from key is not in the target’s provides (Der Inject-Schlüssel ist nicht unter dem, was das Ziel bereitstellt)
E0158
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template
A {{ .parameters.* }} reference cannot be interpolated (Ein Parameterverweis kann nicht interpoliert werden)
E0160
manifest annotation bindings collide on same Feature path+pillar
Two Manifest annotation bindings compete for one routing slot (Zwei Annotationsbindungen eines Manifest konkurrieren um einen Routing-Slot)
E0161
manifest annotation binding uses reserved prefix
A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Eine Annotationsbindung eines Manifest beansprucht das reservierte Präfix)
E0162
missing required feature: attach a Feature of the required type to the component
Required feature not attached (Erforderliches Feature nicht angebunden)
E0163
required uses socket not populated
Required uses: socket not populated (Erforderlicher Socket nicht belegt)
E0164
parameter contract violated
Parameter type mismatch / contract violation (Parametertyp stimmt nicht überein / Vertragsverletzung)
E0165
required parameter not supplied
Parameter type mismatch / contract violation (Parametertyp stimmt nicht überein / Vertragsverletzung)
E0167
Recipe publishes a provides key its Component does not declare
A Recipe publishes a provides key its Component does not declare (Ein Recipe veröffentlicht einen Schlüssel, den seine Component nicht deklariert)
E0168
authored pillar does not conform to its declared schema
Authored values or infra do not conform to the declared schema (Verfasste values oder infra entsprechen nicht dem deklarierten Schema)
E0169
self-inject on component without spec.inject allowlist
Self-inject on a component without an allowlist (Self-inject an einer Komponente ohne Allowlist); Self-inject mechanism not in the component’s allowlist (Self-inject-Mechanismus nicht in der Allowlist der Komponente)
E0170
aggregate/manifest reference unresolvable
A Release’s aggregate: or manifest: reference resolves to nothing (Die Referenz eines Release lässt sich zu nichts auflösen)
E0171
unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare
uses: socket not declared in the owning entity’s usesSchema (Socket nicht im Socket-Schema der besitzenden Entität deklariert)
A Release reached resolution without passing through the load path (Ein Release hat die Auflösung erreicht, ohne den Ladepfad zu durchlaufen)
E0173
declared parameter is read by no reference in the Aggregate
A declared parameter is read by nothing (Ein deklarierter Parameter wird von nichts gelesen)
E0174
uses socket name is a near miss for a declared socket
A uses: socket name is one edit from a declared socket (Ein Socket-Name ist eine Bearbeitung von einem deklarierten Socket entfernt)
E0175
file load failed: the file could not be read, or its bytes did not parse
A file cannot be read, or its bytes do not parse (Eine Datei kann nicht gelesen werden, oder ihre Bytes lassen sich nicht parsen)
E0176
signing: keyless signing requires a live identity provider, Fulcio, and Rekor
Keyless signing was asked for without the services it needs (Schlüssellose Signierung wurde ohne die Dienste angefordert, die sie benötigt)
E0177
signing: no signature found for an artifact that requires one
An artifact that must be signed carries no signature (Ein Artefakt, das signiert sein muss, trägt keine Signatur)
E0178
signing: keyless verification requires at least one trusted identity
A keyless trust policy names no acceptable signer (Eine schlüssellose Vertrauensrichtlinie nennt keinen akzeptablen Signierer)
E0179
signing: signature does not verify
A detached signature does not verify against the key supplied (Eine abgetrennte Signatur lässt sich mit dem angegebenen Schlüssel nicht verifizieren)
E0180
signing: signature bundle does not verify
A signature does not verify (Eine Signatur lässt sich nicht verifizieren)
E0181
signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content
An unsigned publish targets a registry or a policy that requires a signature (Eine unsignierte Veröffentlichung zielt auf eine Registry oder eine Richtlinie, die eine Signatur verlangt)
E0182
signing: cannot load pinned trust root
The pinned trust root cannot be read (Die gepinnte Vertrauenswurzel kann nicht gelesen werden)
E0183
signing: registry requires signatures; refusing to push unsigned content
An unsigned publish targets a registry or a policy that requires a signature (Eine unsignierte Veröffentlichung zielt auf eine Registry oder eine Richtlinie, die eine Signatur verlangt)
E0184
signing: unsupported held-key type
A pinned verification key is not the key profile the verifier accepts (Ein gepinnter Verifizierungsschlüssel entspricht nicht dem Schlüsselprofil, das der Verifizierer akzeptiert)
E0185
signing: signature identity is not trusted for this registry
A signature verifies but its signer is not one the registry trusts (Eine Signatur lässt sich verifizieren, aber ihr Signierer ist keiner, dem die Registry vertraut)
E0186
no source adapter serves the source kind
A Recipe’s source: names a kind nothing knows how to acquire (Die Quelle eines Recipe benennt einen Typ, den nichts zu beschaffen weiß)
E0187
cacheslot: empty workspaceRoot
A source artifact is cached without a workspace root to anchor it (Ein Quellartefakt wird ohne ein Stammverzeichnis des Workspace zwischengespeichert, an dem es verankert ist)
E0188
artifacts entry: shape must be a string scalar or {$import: <local-path>}
An inline-or-import field is written in neither shape (Ein Inline-oder-Import-Feld ist in keiner der beiden Formen geschrieben)
E0189
artifactlibrary: entry must be a mapping of filename to a string body
A library entry’s body is not the shape that library holds (Der Inhalt eines Bibliothekseintrags hat nicht die Form, die diese Bibliothek enthält)
E0190
schemalibrary: forbidden JSON Schema keyword
A schema uses a JSON Schema keyword the library does not admit (Ein Schema verwendet ein Schlüsselwort von JSON Schema, das die Bibliothek nicht zulässt)
E0191
mappinglibrary: entry body must be a string scalar
A library entry’s body is not the shape that library holds (Der Inhalt eines Bibliothekseintrags hat nicht die Form, die diese Bibliothek enthält)
E0192
a document nests too many levels deep
A document nests deeper than the reader will descend (Ein Dokument ist tiefer verschachtelt, als der Leser absteigt)
E0193
parameters: shape must be an inline object or {$import: <local-path>}
A Release’s parameters: block is written in neither of its two shapes (Der Parameter-Block eines Release ist in keiner seiner beiden Formen geschrieben)
E0194
schemalibrary: template not found
A $instantiate: reference cannot be resolved (Eine Referenz kann nicht aufgelöst werden)
E0195
schemalibrary: template parameter missing
A $instantiate: reference cannot be resolved (Eine Referenz kann nicht aufgelöst werden)
E0196
schemalibrary: template parameter type mismatch
A $instantiate: reference cannot be resolved (Eine Referenz kann nicht aufgelöst werden)
E0197
valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}
An inline-or-import field is written in neither shape (Ein Inline-oder-Import-Feld ist in keiner der beiden Formen geschrieben)
E0198
wellKnownAnnotations: a key is declared at a scope the provider's contract does not render
A provider declares a well-known annotation at a scope it does not render (Ein Provider deklariert eine Well-known-Annotation in einem Geltungsbereich, den er nicht rendert)
E0199
workloadlibrary: entry body must be a string scalar
A library entry’s body is not the shape that library holds (Der Inhalt eines Bibliothekseintrags hat nicht die Form, die diese Bibliothek enthält)
E0200
workload: shape must be a string scalar or {$import: <path-or-library-identity>}
An inline-or-import field is written in neither shape (Ein Inline-oder-Import-Feld ist in keiner der beiden Formen geschrieben)
E0201
assertion name declared twice across the extends chain
An assertion name is declared twice along an extends: chain (Ein Assertion-Name wird entlang einer Erweiterungskette zweimal deklariert)
E0202
cyclic extends chain
Cyclic extends chain (Zyklische extends-Kette); Cyclic extends on Components or Features (Zyklisches extends bei Components oder Features)
E0204
FeatureRecipe: valuesMapping requires source
A FeatureRecipe’s valuesMapping requires source (Die Werte-Zuordnung eines FeatureRecipe erfordert eine Quelle)
E0205
inheritance merge failed
An extends: chain cannot be assembled (Eine Erweiterungskette kann nicht zusammengesetzt werden)
E0207
recipe output-component-labels constraint: key is also declared in outputLabels
A promoted component label is also declared literally (Ein übertragenes Label der Komponente ist auch literal deklariert)
E0208
recipe output-labels constraint: key uses a reserved namespace
An output-label key uses a reserved namespace (Ein Ausgabe-Label-Schlüssel verwendet einen reservierten Namespace)
E0209
Recipe: valuesMapping requires source
valuesMapping requires source (Werte-Mapping erfordert eine Quelle)
E0210
Recipe: at least one input kind required
At least one input kind must be present (Mindestens ein Eingabetyp muss vorhanden sein)
E0211
filename collision across input kinds: two input-kind blocks produced a file under one output name
Emission-time filename collision across input kinds (Dateinamenskollision zur Ausgabezeit zwischen Eingabetypen)
E0212
workload attachment slot is not referenceable
A Workload references a slot whose fill publishes no locator (Eine Workload verweist auf einen Slot, dessen Befüllung keinen Lokator veröffentlicht)
E0213
workload featuresSchema cross-check failed
A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Eine Workload-Anbindung nennt einen Slot, den die Entität nicht deklariert, oder eine Bereitstellung, die der Slot verbietet)
E0214
workload validation failed
A Workload does not satisfy the Workload schema (Eine Workload erfüllt das Workload-Schema nicht)
E0215
document envelope validation failed
YAML anchor aliased inside its own content (YAML-Anker, der innerhalb seines eigenen Inhalts per Alias referenziert wird); Divergent Release (extends + aggregate pointer) (Divergentes Release (extends + aggregate-Zeiger))
An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Ein Prädikat kann nicht ausgewertet werden)
E0218
validator/jsonschema: schema resolution failed
A declared schema cannot be resolved (Ein deklariertes Schema kann nicht aufgelöst werden)
E0220
extends chain exceeds maximum depth
An extends: chain runs past the depth bound (Eine Erweiterungskette überschreitet die Tiefengrenze)
E0221
merger: invalid merge input
The schema-merge step’s own input guard (Der eigene Eingabeschutz des Schritts zur Schemazusammenführung)
E0222
registry alias matches more than one host
A registry alias matches more than one host (Ein Registry-Alias passt auf mehr als einen Host)
E0223
a cross-cutting socket is bound by capability but attaches by uri
A plugin binding sets a key the socket it attaches to does not read (Eine Plugin-Bindung setzt einen Schlüssel, den der Socket, an den sie angebunden ist, nicht liest)
E0224
workspace configuration is invalid
The workspace configuration is invalid (Die Workspace-Konfiguration ist ungültig)
E0225
capability is bound to more than one provider plugin
A capability is bound to more than one provider plugin (Eine Fähigkeit ist an mehr als ein Provider-Plugin gebunden)
E0226
registry alias is already used by another host
A registry alias is already bound to another host (Ein Registry-Alias ist bereits an einen anderen Host gebunden)
E0227
a governance attachment declares no role or an unknown role
A governance attachment declares no role, or one that is not a known role (Eine Governance-Anbindung deklariert keine Rolle oder eine, die keine bekannte Rolle ist)
E0228
a provider socket binding sets a field with no referent on that socket
A plugin binding sets a key the socket it attaches to does not read (Eine Plugin-Bindung setzt einen Schlüssel, den der Socket, an den sie angebunden ist, nicht liest)
E0229
position out of range
An editor position falls outside the document (Eine Editor-Position liegt außerhalb des Dokuments)
E0246
the digest recorded as trusted for this plugin does not match the digest its cached manifest reports
A trusted plugin’s recorded digest disagrees with the cached artifact (Der erfasste Digest zu einem vertrauenswürdigen Plugin stimmt nicht mit dem zwischengespeicherten Artefakt überein)
E0247
a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role
A plugin recorded as a trusted gate is no longer attached (Ein als vertrauenswürdiges Gate erfasstes Plugin ist nicht mehr angebunden)
E0248
wasm: guest plugin returned an output that is not the shape the socket reads
A plugin returned something that is not the shape the socket reads (Ein Plugin hat etwas zurückgegeben, das nicht die Gestalt hat, die der Socket liest)
E0250
provider named a directory for each contributor's own sub-directory that is not a single directory name
A provider named a directory for a contributor that is not one directory (Ein Provider hat für einen Beitragenden ein Verzeichnis benannt, das kein einzelnes Verzeichnis ist)
E0251
recipe source is an empty string, which names neither sourceless mode nor sourced mode
Recipe source: is an empty string (Das Feld source des Recipe ist ein leerer String)
E0252
artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under
An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Eine Bundle-Datei einer ArtifactLibrary benennt keine eigene Datei unter dem Schlüssel, unter dem sie importiert wurde)
E0253
annotation binding does not resolve against its target Feature
Annotation binding does not resolve against its target Feature (Annotationsbindung lässt sich nicht gegen ihr Ziel-Feature auflösen)
E0254
annotation subkey does not conform to the target Feature's schema at the routed pillar
A bound annotation value does not conform to the target Feature’s schema (Ein gebundener Annotationswert entspricht nicht dem Schema des Ziel-Features)
E0255
annotation routes through a pillar its authoring side may not use
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)
E0256
annotation binding declares one path in both pillar lists
An annotation binding declares one path in both pillar lists (Eine Annotationsbindung deklariert einen Pfad in beiden Säulenlisten)
E0257
declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation
A declared schema contract cannot be read as a schema (Ein deklarierter Schema-Vertrag kann nicht als Schema gelesen werden)
E0259
attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it
A boundary-scope Feature is attached only to a component (Ein Feature mit Boundary-Geltungsbereich ist nur an eine Komponente angebunden)
E0260
component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`
A component the composition holds is placed in no boundary (Eine Komponente, die die Komposition enthält, ist in keiner Boundary platziert)
E0261
boundary names a component the composition does not hold: correct the name, or remove the entry
A boundary names a component the composition does not hold (Eine Boundary nennt eine Komponente, die die Komposition nicht enthält)
E0262
component identity cannot be the name its emitted resources are stamped with: rename the component
Component identity cannot be stamped on what it emits (Die Identität der Component kann dem, was sie ausgibt, nicht aufgeprägt werden)
E0263
the target will not accept a name derived from this component's authored identity: rename the component
The target will not accept a name derived from an authored identity (Das Ziel akzeptiert keinen von einer verfassten Identität abgeleiteten Namen)
E0264
provider guest never accepted a component identity the compiler composed for it
A provider never accepted a name the compiler composed (Ein Provider hat nie einen Namen akzeptiert, den der Compiler zusammengesetzt hat)
E0265
provider does not support the node's input kind
workload: requires a provider that can synthesize (erfordert einen Provider, der synthetisieren kann)
E0266
a schema `$import:` could not be applied
A schema $import: cannot be applied (Ein Schemaimport kann nicht angewendet werden)
E0267
a schema block declares a key that names no data pillar
A schema block names a key that is not a data pillar (Ein Schemablock nennt einen Schlüssel, der keine Datensäule ist)
E0268
reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens
A provider’s reassembly is handed a unit its own carve never produced (Die Reassemblierung eines Providers erhält eine Einheit, die seine eigene Zerlegung nie erzeugt hat)
E0269
provider guest returned two output files under one path; a conforming guest returns each output path at most once
A provider returned two output files under one path (Ein Provider hat zwei Ausgabedateien unter einem Pfad zurückgegeben)
E0270
link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returned
A provider’s link wiring names an output file that was never emitted (Die Verknüpfungsverdrahtung eines Providers nennt eine Ausgabedatei, die nie ausgegeben wurde)
E0271
emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content
A pipeline step’s file emission carries no file (Die Dateiausgabe eines Pipeline-Schritts trägt keine Datei)
E0272
side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd
A pipeline step declares an emission kind the contract does not define (Ein Pipeline-Schritt deklariert eine Ausgabeart, die der Vertrag nicht definiert)
E0273
template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider supplies
A template reads a rendered name the node’s provider does not report (Ein Template liest einen gerenderten Namen, den der Provider des Knotens nicht meldet)
E0274
the plugin identity recorded as trusted no longer matches what this resolution reports
A gate recorded as trusted resolves to a different identity (Ein als vertrauenswürdig erfasstes Gate wird zu einer anderen Identität aufgelöst)
E0275
the edit was refused because the resulting document would not be valid, and nothing was written
An edit would produce a document its schema refuses (Eine Bearbeitung würde ein Dokument erzeugen, das sein Schema zurückweist)
E0276
the version being published changes the published predecessor in a way the documented evolution rubric objects to
The change being published breaks what the evolution rubric allows (Die zu veröffentlichende Änderung verletzt, was das Evolutionsraster erlaubt)
E0277
an annotation key on the entity uses a prefix the platform reserves
An annotation key uses a prefix the platform reserves (Ein Annotationsschlüssel verwendet ein Präfix, das die Plattform reserviert)
E0278
the entity's name does not follow the documented name shape for its kind
An entity’s name does not follow the shape its kind expects (Der Name einer Entität folgt nicht der Form, die ihr Typ erwartet)
E0279
a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow
A schema uses a dynamic reference that cannot be resolved ahead of time (Ein Schema verwendet eine dynamische Referenz, die sich nicht vorab auflösen lässt)
E0280
a schema in the entity declares an identifier of its own, where the platform owns that schema's identity
A schema declares an identifier the platform owns (Ein Schema deklariert einen Bezeichner, der der Plattform gehört)
E0281
the entity's category label does not match the category directory the entity is filed under
A Component’s category label and its directory name different categories (Das Kategorie-Label einer Component und ihr Verzeichnis nennen unterschiedliche Kategorien)
E0282
the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema
A schema extension is written directly into schema content (Eine Schemaerweiterung wird direkt in den Schemainhalt geschrieben)
E0283
the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply
A Plugin pins neither runtime cap, so the platform’s own apply (Ein Plugin pinnt keines der beiden Laufzeitlimits, daher gelten die der Plattform)
E0284
an attachment slot admits only secret material and does not declare that it handles it
An attachment slot admits only secret material without saying it handles it (Ein Anbindungs-Slot lässt nur geheimes Material zu, ohne anzugeben, dass er es verarbeitet)
E0285
the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused
A Recipe publishes a provides key its Component does not declare, checked at publication (Ein Recipe veröffentlicht einen Schlüssel, den seine Component nicht deklariert, geprüft bei der Veröffentlichung)
E0286
the version bump being published is smaller than the evolution check's classification of the change requires
The version offered is a smaller bump than the change requires (Die angebotene Version ist eine kleinere Erhöhung, als die Änderung verlangt)
E0287
the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files
An import stopped partway through translating a source (Ein Import wurde mitten in der Übersetzung einer Quelle angehalten)
E0288
a plugin has no expression for a construct this build declares
A workload declares a form compose cannot express (Eine Workload deklariert eine Form, die compose nicht ausdrücken kann); A container declares a field compose has no primitive for (Ein Container deklariert ein Feld, für das compose kein Primitiv hat); An omits entry names a kind or a namespace a compose file does not have (Ein omits-Eintrag nennt einen Kind oder einen Namespace, den eine Compose-Datei nicht hat); An omits entry names a namespace a CloudFormation template does not have (Ein omits-Eintrag nennt einen Namespace, den ein CloudFormation-Template nicht hat); A rule reads a bound CloudFormation parameter by name (Eine Regel liest einen gebundenen CloudFormation-Parameter über seinen Namen); The assembled CloudFormation stack cannot carry a transform (Der assemblierte CloudFormation-Stack kann keine Transformation tragen)
E0289
a plugin could not resolve something it requires to exactly one value
A health probe cannot be turned into a compose healthcheck (Eine Health-Probe kann nicht in einen Compose-Healthcheck umgewandelt werden); A configmap volume has no file behind it (Hinter einem configmap-Volume steht keine Datei); What an omits entry left out is still named by the compose file (Was ein omits-Eintrag weggelassen hat, wird von der Compose-Datei noch genannt); What an omits entry left out is still named by a CloudFormation template (Was ein omits-Eintrag weggelassen hat, wird von einem CloudFormation-Template noch genannt); A valuesMapping key names no parameter of a sourced CloudFormation template (Ein valuesMapping-Schlüssel nennt keinen Parameter eines als Quelle verwendeten CloudFormation-Templates); Another component references a CloudFormation parameter a sourced template’s binding filled (Eine andere Komponente referenziert einen CloudFormation-Parameter, den die Bindung eines als Quelle verwendeten Templates befüllt hat); Two components order one pair of transforms oppositely (Zwei Komponenten ordnen dasselbe Paar von Transformationen entgegengesetzt an); A cross-boundary reference has no consuming stack to be written into (Eine Boundary-übergreifende Referenz hat keinen konsumierenden Stack, in den sie geschrieben werden kann); A synthesized StatefulSet has no single service to govern it (Ein synthetisiertes StatefulSet hat keinen einzelnen Dienst, der es steuert)
E0290
two things a plugin produced occupy one name in its output
An authored export name is one the build derives for a cross-stack reference (Ein verfasster Exportname ist einer, den der Build für eine stackübergreifende Referenz ableitet); The output a cross-stack reference publishes on already carries an Export (Der Stack-Output, auf dem eine stackübergreifende Referenz veröffentlicht, trägt bereits ein Export); Two entries reach one stack output name (Zwei Einträge erreichen denselben Stack-Output-Namen); A CloudFormation fragment writes one key twice (Ein CloudFormation-Fragment schreibt einen Schlüssel zweimal); Two rendered resources land at one output file (Zwei gerenderte Ressourcen landen in derselben Ausgabedatei)
E0291
a plugin has no representation for a value it was given
A published port declares a transport compose cannot spell (Ein veröffentlichter Port deklariert einen Transport, den compose nicht schreiben kann); A resources quantity cannot be converted to a compose value (Eine Ressourcenmenge kann nicht in einen Compose-Wert umgewandelt werden); A resource quantity the helm provider emits is not a quantity (Eine Ressourcenmenge, die der helm-Provider ausgibt, ist keine Mengenangabe); A service type the helm provider cannot render (Ein Service-Typ, den der helm-Provider nicht rendern kann); A Kubernetes version the helm provider cannot render a chart for (Eine Kubernetes-Version, für die der helm-Provider kein Chart rendern kann); A value bound to a CloudFormation parameter cannot take the parameter’s type (Ein an einen CloudFormation-Parameter gebundener Wert kann den Typ des Parameters nicht annehmen); A value bound to a CloudFormation parameter is one its constraints refuse (Ein an einen CloudFormation-Parameter gebundener Wert ist einer, den seine Einschränkungen zurückweisen); A secret bound to a CloudFormation parameter would be written into the template (Ein an einen CloudFormation-Parameter gebundenes Geheimnis würde in das Template geschrieben); A dynamic reference is bound where CloudFormation does not resolve it (Eine dynamische Referenz ist dort gebunden, wo CloudFormation sie nicht auflöst); A cross-boundary reference was spliced into a longer string (Eine Boundary-übergreifende Referenz wurde in einen längeren String eingefügt)
E0292
a plugin reported a failure that none of the declared kinds names
A plugin reported a failure it did not classify (Ein Plugin hat einen Fehlschlag gemeldet, den es nicht klassifiziert hat)
E0293
wasm: guest plugin named a condition the socket does not declare
A plugin named a condition the socket does not declare (Ein Plugin hat eine Bedingung genannt, die der Socket nicht deklariert)
E0294
components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity
Two subsystems declare a component under one name (Zwei Subsysteme deklarieren eine Komponente unter einem einzigen Namen)
E0295
library reference: a reference to a library entry carries no whitespace or line break
A reference to a library entry carries whitespace (Ein Verweis auf einen Bibliothekseintrag enthält Leerraum)
E0296
release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both
A Release chain’s links disagree about the routing shape (Die Glieder einer Release-Kette sind sich über die Routing-Struktur uneinig)
E0297
inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to
A child Release inherits a boundary directory that resolves where its parent writes (Ein Kind-Release erbt ein Boundary-Verzeichnis, das dorthin aufgelöst wird, wohin sein Eltern-Release schreibt)
E0298
oci: published bundle carries no entity document
A published bundle holds no entity, or holds two (Ein veröffentlichtes Bundle enthält keine Entität oder zwei)
E0299
oci: published bundle carries more than one entity document
A published bundle holds no entity, or holds two (Ein veröffentlichtes Bundle enthält keine Entität oder zwei)
E0300
oci: published bundle cannot be unpacked
A published artifact cannot be read as an entity (Ein veröffentlichtes Artefakt kann nicht als Entität gelesen werden)
E0301
oci: published artifact is not an entity document
A published artifact cannot be read as an entity (Ein veröffentlichtes Artefakt kann nicht als Entität gelesen werden)
E0302
an input the entity reads has no pin recorded for it in the entity.lock beside it
An entity reads an input the lock beside it records no pin for (Eine Entität liest eine Eingabe, für die das Lock neben ihr keine Fixierung erfasst)
E0303
the entity shares its directory with another entity, and an entity of its kind has a directory of its own
An entity shares its directory with another entity (Eine Entität teilt ihr Verzeichnis mit einer anderen Entität)
E0304
a path names content outside the entity's own directory
A path names content outside the entity’s own directory (Ein Pfad benennt Inhalte außerhalb des eigenen Verzeichnisses der Entität)
E0305
the files of the entity's local source do not match the pins recorded for them in entity.lock
A local source no longer matches the pins recorded beside its Recipe (Eine lokale Quelle stimmt nicht mehr mit den neben ihrem Recipe erfassten Fixierungen überein)
E0306
plugin artifact not found on this machine
A plugin’s .wasm is not on this machine (Die Wasm-Datei zu einem Plugin ist nicht auf diesem Rechner)
E0307
a value a cache location is built from would place cached files outside the place it names in the cache
A value would place a cached file outside the cache (Ein Wert würde eine zwischengespeicherte Datei außerhalb des Cache ablegen)
E0308
a Feature reaches a component alongside a Feature it declares a conflict with
Two Features declared to conflict reach one component (Zwei als widersprüchlich deklarierte Features erreichen eine Komponente)
E0309
a symbolic link sits among the files an entity carries
A symbolic link sits among the files an entity carries (Ein symbolischer Link befindet sich unter den Dateien, die eine Entität mitführt)
E0310
a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`
A registry is added offline with no trust policy to pin (Eine Registry wird offline ohne eine zu pinnende Vertrauensrichtlinie hinzugefügt)
E0311
reference carries a malformed version pin
A version pin is none of the forms a pin takes (Ein Versions-Pin hat keine der Formen, die ein Pin annimmt)
E0312
a provider socket binding names a capability containing a colon, which no Recipe can select
A provider binding names a capability containing a colon (Eine Provider-Bindung benennt eine Fähigkeit, die einen Doppelpunkt enthält)
E0313
plugins.providers entry names a capability no provider-rendering plugin the build reads serves
A provider binding names a capability no plugin the build reads serves (Eine Provider-Bindung benennt eine Fähigkeit, die kein vom Build gelesenes Plugin bedient)
E0314
plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports
A plugin was built from a working tree with uncommitted changes (Ein Plugin wurde aus einem Arbeitsverzeichnis mit nicht committeten Änderungen gebaut)
E0315
a connection carries an attachment under a name its socket declares no slot for
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)
E0316
a Release attachment takes the name of an attachment one of a component's connections carries
A Release attachment takes the name of a connection’s attachment (Eine Anbindung des Release übernimmt den Namen der Anbindung einer Verbindung)
E0317
a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes
A Release connection attachment names no Feature type (Eine Verbindungsanbindung des Release nennt keinen Feature-Typ)
E0318
duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered
Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Zwei angebundene Features stellen einen Schlüssel zu, das spätere über das injectMapping seines FeatureRecipe)
E0319
connection alias is already used by another connection of the same component
Two connections of one component under one alias (Zwei Verbindungen einer Komponente unter einem Alias)
E0320
a path this operation writes or deletes leads through a link out of the directory it must stay inside
A path the operation writes leads through a link out of the directory it must stay inside (Ein Pfad, den der Vorgang schreibt, führt über einen Link aus dem Verzeichnis hinaus, in dem er bleiben muss)
E0321
a file this operation reads leads through a link out of the directory it must stay inside
A file the operation reads leads through a link out of the directory it must stay inside (Eine Datei, die der Vorgang liest, führt über einen Link aus dem Verzeichnis hinaus, in dem sie bleiben muss)
E0323
template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts
A template reads its callers’ render facts without declaring it (Ein Template liest die Render-Fakten seiner Aufrufer, ohne es zu deklarieren)
E0324
a reference a document makes to another file leads out of the directory it must stay inside
A reference to another file leads out of the directory it must stay inside (Ein Verweis auf eine andere Datei führt aus dem Verzeichnis hinaus, innerhalb dessen er bleiben muss)
E0325
provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entry
A provider reported a render fact whose value is not a list (Ein Provider hat einen Render-Fakt gemeldet, dessen Wert keine Liste ist)
E0326
pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render facts
A pipeline step reads its callers’ render facts (Ein Pipeline-Schritt liest die Render-Fakten seiner Aufrufer)
E0327
template indexes a map with a key the map does not hold
A template indexes a map with a key the map does not hold (Ein Template indiziert eine Map mit einem Schlüssel, den die Map nicht enthält)
E0328
attachment written under a name no slot declares fits a slot its component leaves empty
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)
E0329
a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one
A connection and the target it reaches do not name one key (Eine Verbindung und das Ziel, das sie erreicht, nennen nicht denselben Schlüssel)
E0330
signing: the references named together need different signing credentials, so nothing was signed
References signed together need different signing credentials (Gemeinsam signierte Referenzen benötigen unterschiedliche Berechtigungsnachweise zum Signieren)
E0331
signing: no verified signature is recorded for an artifact that requires one
No verified signature is recorded for an artifact that requires one (Für ein Artefakt, das eine Signatur erfordert, ist keine verifizierte Signatur erfasst)
E0332
signing: the recorded signature was made for a different artifact
A recorded signature was made for a different artifact (Eine erfasste Signatur wurde für ein anderes Artefakt erstellt)
E0333
signing: a recorded signature is not the one a pull would record
A recorded signature is not the one a pull would record (Eine erfasste Signatur ist nicht die, die ein Pull erfassen würde)
E0334
an omits entry left out nothing the source rendered
An omits entry left out nothing the source rendered (Ein omits-Eintrag hat nichts von dem weggelassen, was die Quelle gerendert hat)
E0335
provider does not support omits
The provider does not support omits (Der Provider unterstützt omits nicht)
E0336
a provider's omitted counts do not match the omits entries it was handed
A provider’s omitted counts do not match the omits entries it was handed (Die Auslassungszahlen eines Providers stimmen nicht mit den omits-Einträgen überein, die ihm übergeben wurden)
E0337
no importer plugin version satisfies the plugins.importer entry's version pin
A plugins.importer entry pins a version of its importer the catalog does not hold (Ein Eintrag pinnt eine Version seines Importers, die der Katalog nicht enthält)
E0338
importer is attached by more than one plugins.importer entry
An importer is attached by more than one plugins.importer entry (Ein Importer ist durch mehr als einen Eintrag angebunden)
E0339
more than one importer recognises the source
More than one importer recognises the source (Mehr als ein Importer erkennt die Quelle)
E0340
a name this operation writes holds a path segment Windows cannot hold as written
A name the operation writes holds a part Windows cannot hold (Ein Name, den der Vorgang schreibt, enthält einen Teil, den Windows nicht aufnehmen kann)
E0341
the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory
An importer that declares no file patterns is handed a directory (Einem Importer, der keine Dateimuster deklariert, wird ein Verzeichnis übergeben)
E0342
no file in the directory matches the file patterns the importer serving the source's format declares
No file in the directory matches the importer’s file patterns (Keine Datei im Verzeichnis passt auf die Dateimuster des Importers)
E0343
a file read from the directory and a file named in the importer's `with.sources` have the same name
A file read from the directory and a file named in the importer’s with.sources have the same name (Eine aus dem Verzeichnis gelesene Datei und eine in den Quellen des Importers genannte Datei haben denselben Namen)
E0344
an entry this publication carries cannot be used on Windows
A published archive carries an entry Windows cannot use (Ein veröffentlichtes Archiv enthält einen Eintrag, den Windows nicht verwenden kann)
E0345
a container declares one environment variable twice
A container gives one environment variable two values (Ein Container gibt einer Umgebungsvariable zwei Werte)
E0346
a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credential
A Component’s metrics annotation and its provides key disagree (Die Metrik-Annotation einer Component und ihr provides-Schlüssel widersprechen sich)
E0347
template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts
A template reads its targets’ render facts without declaring it (Ein Template liest die Render-Fakten seiner Ziele, ohne es zu deklarieren)
E0348
pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render facts
A pipeline step reads its targets’ render facts (Ein Pipeline-Schritt liest die Render-Fakten seiner Ziele)
E0349
no Recipe in the workspace's catalog binds to the capability the import's target names
An import’s target names a capability no Recipe in the catalog binds to (Das Ziel eines Imports nennt eine Fähigkeit, an die sich kein Recipe im Katalog bindet)
E0350
no importer recognises the source
No importer recognises the source (Kein Importer erkennt die Quelle)
E0351
provider does not support boundary artifacts
The provider does not support boundary artifacts (Der Provider unterstützt keine Boundary-Artefakte)
E0352
boundary output directory does not name a directory beneath the output root
A boundary’s output directory is not a directory beneath the output root (Das Ausgabeverzeichnis einer Boundary ist kein Verzeichnis unterhalb der Ausgabewurzel)
E0353
boundary-level Feature instance name is not a directory name
A boundary-level Feature is named . or .. (Ein Feature auf Boundary-Ebene heißt . oder ..)
E0354
a template does more than copy a value it reads off a cross-boundary link
A template did more than copy a value it read off a cross-boundary link (Ein Template hat mehr getan, als einen Wert zu kopieren, den es von einer Boundary-übergreifenden Verknüpfung gelesen hat)
E0355
inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`
An inject: delivery is not a list of entries (Eine Inject-Zustellung ist keine Liste von Einträgen)
E0356
suspend requires form: scheduled
A workload suspend: is set on a form other than scheduled (Die Aussetzung einer Workload ist bei einer anderen Form als der geplanten gesetzt)
E0357
a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing
A Manifest name mapping names nothing in the build (Ein Namens-Mapping im Manifest benennt nichts im Build)
E0358
uses edge target names a component its module does not export
A uses target names a module’s component the module does not export (Ein Kantenziel nennt eine Komponente eines Moduls, die das Modul nicht exportiert)
E0359
no source adapter is registered in this program for the source kind
No source adapter is registered in this program for a source kind (In diesem Programm ist für einen Quelltyp kein Quelladapter registriert)
E0360
the netrc file could not be read
The netrc file cannot be read (Die netrc-Datei kann nicht gelesen werden)
E0361
the source URL carries a credential
A source URL carries a credential (Eine Quell-URL enthält Zugangsdaten)
E0362
inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`
An inject: entry on a connection carries a literal (Ein Inject-Eintrag an einer Verbindung trägt ein Literal)
E0363
annotation subkey is not routed by the annotation's binding
An annotation subkey is not routed by its binding (Ein Annotations-Unterschlüssel wird von seiner Bindung nicht geroutet)
E0364
a value template failed while it ran
A value template failed while it ran (Ein Werte-Template ist während der Ausführung fehlgeschlagen)
E0365
boundary-level Feature's output is routed to a dispatch path nothing assembles
A boundary-level Feature’s output reaches no assembled file (Die Ausgabe eines Feature auf Boundary-Ebene erreicht keine assemblierte Datei)
E0366
FeatureRecipe injectMapping output could not be read as a dictionary of deliveries
An attached Feature’s injectMapping output cannot be read (Die injectMapping-Ausgabe eines angebundenen Feature kann nicht gelesen werden)
E0367
a scalar annotation value does not route to exactly one path of its binding
A bare annotation value does not route to exactly one path of its binding (Ein einfacher Annotationswert wird nicht an genau einen Pfad seiner Bindung geroutet)
E0368
FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads
An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Die injectMapping-Ausgabe eines angebundenen Feature schreibt Auslieferungen unter einen Schlüssel, den nichts ausliefert)
E0369
template reads a path as a value and iterates it, and the data holds nothing at that path
A template reads and iterates a path that holds nothing (Ein Template liest und iteriert einen Pfad, der nichts enthält)
E0370
a pipeline declares one step id twice
A pipeline declares one step id twice (Eine Pipeline deklariert eine Schritt-ID zweimal)
E0371
catalog document declares a kind a catalog does not hold
A catalog document declares a kind a catalog does not hold (Ein Katalogdokument deklariert einen Typ, den ein Katalog nicht enthält)
E0372
inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block
An inject: entry on an attached Feature carries a literal (Ein Injektionseintrag an einem angebundenen Feature enthält ein Literal)
E0373
a document declares an API version this compiler no longer reads
A document declares an API version this compiler no longer reads (Ein Dokument deklariert eine API-Version, die dieser Compiler nicht mehr liest)
E0374
a plugin declares a plugin ABI version this compiler no longer speaks
A plugin declares a plugin ABI version this compiler no longer speaks (Ein Plugin deklariert eine Plugin-ABI-Version, die dieser Compiler nicht mehr unterstützt)
E0375
oci: artifact carries a media type this compiler no longer reads
An artifact carries a media type this compiler no longer reads (Ein Artefakt trägt einen Medientyp, den dieser Compiler nicht mehr liest)
E0376
egress: the server did not answer in time
A server did not answer in time (Ein Server hat nicht rechtzeitig geantwortet)
E0377
registry: the repository listing did not end in time
A registry’s repository listing did not end in time (Die Repository-Liste einer Registry endete nicht rechtzeitig)
E0378
oci: the registry kept asking to slow down
A registry kept asking to slow down (Eine Registry bat wiederholt um Verlangsamung)
Die Linter-Domäne (nicht fatal)
Der Compiler ist strikt meinungslos in Bezug auf die Ausführung. Er bricht den Build nie wegen Mustern ab, die lediglich verdächtig sind — ungenutzte Werte, verwaiste Secrets, nicht verbundene Ziele. Ein solches Muster zieht höchstens einen Hinweis nach sich — den des Builds selbst, für die wenigen, die oben unter „Bedingungen, die einen Build nicht abbrechen“ katalogisiert sind, etwa ein deklarierter Parameter, den nichts liest —, und der Rest gehört in die Linter-Domäne, in der sich Unternehmen bewusst für Wasm-Plugins entscheiden, die ihre eigenen Konventionen durchsetzen.
Verwaiste Zugangsdaten
Ein Zugangsdaten-Feature, das ohne einen inject:-Zustellungsvertrag angebunden ist, ist kein Kompilierfehler. Der Kern-Compiler bewahrt die Deklaration im IR-Graphen und gibt keine Warnung aus. Linter-Plugins von Unternehmen können dieses Muster erkennen und davor warnen; Renderer von Unternehmen können auch entscheiden, verwaiste Secrets implizit nach ihren eigenen Black-Box-Konventionen einzubinden. Da beide Auslegungen gültig sind, ergreift der Kern-Compiler für keine von beiden Partei.