Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Die Ausgabe auf diesen Seiten lesen

Die meisten Seiten in diesem Abschnitt zeigen Ihnen neben der Eingabe auch Ausgabe: eine Datei, die der Build unter dist/ geschrieben hat, den Text, den der Build in Ihrem Terminal ausgegeben hat, oder was ein Werkzeug wie tofu ausgegeben hat, als Sie es auf dem ausgeführt haben, was der Build geschrieben hat.

Diese Blöcke sind aus einem echten Lauf kopiert, nicht von Hand geschrieben. Bauen Sie das Beispiel selbst, und Sie können Ihre eigene Ausgabe Zeile für Zeile mit der Seite vergleichen.

Dieser Vergleich ist der Grund, warum die Ausgabe überhaupt hier steht. Mehrere dieser Seiten bitten Sie, eine Zeile zu ändern und neu zu bauen oder eine gerenderte Datei zu löschen und das Werkzeug erneut auszuführen und dann den Unterschied zu lesen. Einer solchen Anweisung zu folgen lohnt sich nur, wenn der Block, mit dem Sie vergleichen, exakt ist — andernfalls haben Sie keine Möglichkeit, einen Unterschied, den Sie nach dem Willen der Seite finden sollten, von einem zu unterscheiden, den sie einfach nie erwähnt hat.

Ein Block, der Ausgabe zeigt, befindet sich daher immer in einem von zwei Zuständen und nie irgendwo dazwischen.

Vollständig

Der Block zeigt das Ganze dessen, was die Seite benannt hat. Wenn der einleitende Satz der Service web sagt, ist jede Zeile dieses Service vorhanden. Wenn er eine Datei benennt, ist die ganze Datei vorhanden.

Ein Auszug, an der Stelle der Auslassung markiert

Echte Ausgabe ist oft lang, und alles auszugeben würde die eine Zeile begraben, die eine Seite vermittelt. Wo Zeilen weggelassen werden, sagt der Block das, in einer eigenen Zeile, an der Stelle, an der sie weggelassen wurden:

[… omitted: what was left out]

So sieht das in der Praxis aus. Dies ist ein Plan für das Beispiel terraform-declared-sensitivity, bei dem es um ein einziges Attribut geht:

# module.store.terraform_data.reference will be created
+ resource "terraform_data" "reference" {
[… omitted: an id attribute, reported as known only after apply]
+ input = (sensitive value)
[… omitted: an output attribute, reported as known only after apply]
+ triggers_replace = [
+ "app-artifacts",
+ "AKIAEXAMPLE0001",
]
}

Ihr eigener Plan wird diese beiden Attribute enthalten. An der Markierung erkennen Sie, dass sie dorthin gehören — dass es Zeilen sind, die die Seite nicht noch einmal abdrucken wollte, und nicht etwas, das Ihr Build anders gemacht hat. Eine Markierung steht an jeder Stelle, an der Zeilen weggelassen wurden, sodass ihre Position ebenso lesbar ist wie ihr Fehlen.

Die Markierung sagt immer, was weggelassen wurde, nie nur, dass etwas weggelassen wurde. „Ein id-Attribut, erst nach dem Apply als bekannt gemeldet“ sagt Ihnen genug, um die Zeile wiederzuerkennen, wenn Sie ihr begegnen; bloße Auslassungspunkte täten das nicht.

Die eckigen Klammern sind beabsichtigt. Eine Zeile, die mit [… beginnt, ist kein gültiger Inhalt in YAML, HCL, JSON oder einem der anderen Formate, die diese Seiten ausgeben, und keines der hier gezeigten Werkzeuge gibt eine solche aus. Eine solche Zeile ist also immer die Seite, die spricht, nie etwas, das der Build erzeugt hat — sie kann weder mit Ausgabe verwechselt noch beim Überfliegen übersehen werden.

Was keine Auslassung ist

Vier Dinge verändern, wie ein Block aussieht, ohne etwas wegzulassen, und keines davon erhält eine Markierung:

  • Einen kleineren Umfang benennen. Eine Seite, die „der Service web“ sagt und dann diesen Service zeigt, hat nichts von dem weggelassen, was sie benannt hat. Der Rest der Datei liegt außerhalb des Umfangs, statt darin zu fehlen.
  • Einrückung. Ein Fragment, das aus einer tief verschachtelten Struktur herausgelöst wurde, wird meist ab dem linken Rand gezeigt, damit es für sich lesbar ist. Die Zeilen sind die ausgegebenen Zeilen; nur die führenden Leerzeichen haben sich geändert.
  • Eine Beschriftung oder eine Notiz. Eine Zeile mit #, die die Datei benennt, aus der die Zeilen stammen, oder eine kurze Notiz neben einem Wert ist erkennbar die Seite, die spricht, und nicht der Build.
  • Ein # in jeder Zeile einer zitierten Meldung. Wo eine Seite einen Befehl und die von ihm ausgegebene Meldung in einem Block zeigt, ist die Meldung auskommentiert, damit der ganze Block ausführbar bleibt. Eine einzelne lange ausgegebene Zeile kann über mehrere Zeilen mit # umbrochen sein, damit sie bei dieser Breite lesbar bleibt. So oder so sind die Wörter die ausgegebenen Wörter, in der ausgegebenen Reihenfolge.

Die Markierung gibt es für den einen Fall, den Sie sonst nicht erkennen könnten: Zeilen, die einfach nicht da sind.

Ein Block, der veranschaulicht statt wiederzugeben

Einige Seiten hier sind geschriebene Schritt-für-Schritt-Anleitungen statt Workspaces, die Sie bauen können, und ein oder zwei zeigen die Struktur einer Payload statt eines bestimmten Laufs davon. Ein solcher Block gibt kein Versprechen, gegen das Sie einen Diff machen können, daher sagt er das in den Worten um ihn herum — er tritt nie stillschweigend an die Stelle des Echten. Wenn ein Block das nicht sagt, wurde er aus einem Lauf kopiert, und die beiden oben genannten Zustände gelten für ihn.

Wenn Sie eine dieser Seiten anpassen

Behalten Sie dieselben zwei Zustände bei. Wenn sich die Ausgabe ändert — weil Sie das Beispiel geändert haben oder weil eine neuere Version sie anders rendert —, ersetzen Sie den Block aus einem echten Lauf, statt ihn von Hand zu bearbeiten, und markieren Sie alle Zeilen, die Sie weglassen. Ein Block, der so bearbeitet wurde, dass er richtig aussieht, ist genau das, was diese Konvention verhindern soll, denn er liest sich genau wie ein Block, der geprüft wurde.