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

Globale Flags

Flags, die bei jedem aggrega-Unterbefehl verfügbar sind.

--workspace-root <path>

Verwendet <path> als Workspace-Stamm und überspringt die Erkennung vollständig. Wird das Flag weggelassen, ermittelt aggrega den Stamm, indem es vom aktuellen Verzeichnis aufwärts wandert — oder, wo diese Suche nichts findet und der Befehl sein Release oder Dokument mit einem absoluten Pfad nennt, indem es stattdessen vom Ordner dieser Datei aufwärts wandert; siehe Konfiguration dazu, was einen Stamm verankert, in welcher Reihenfolge und welche Befehle eine solche Datei nennen.

AGGREGA_WORKSPACE_ROOT ist das Gegenstück in der Umgebung: Wenn --workspace-root nicht angegeben ist, liefert die Variable den Stamm. Das Flag gewinnt, wenn es gesetzt ist.

Der Stamm ist der Stamm, wo auch immer er angegeben wird, die Server eingeschlossen: Eine Anfrage an aggrega mcp, die keinen eigenen Workspace nennt, wird in ihm beantwortet, ohne dass darüber etwas durchsucht wird. Ein Stamm, der kein existierender Ordner ist — ein Pfad, der nichts oder eine Datei nennt —, wird von jedem Befehl abgewiesen, der seinen Workspace liest, bevor der Befehl irgendetwas anderes tut; aggrega serve und ein aggrega mcp-Listener verweigern damit den Start, und aggrega mcp über Standardein- und -ausgabe startet trotzdem und beantwortet jeden Aufruf, der in diesem Workspace handelt, mit der Abweisung. Die Abweisung nennt, welcher der beiden ihn geliefert hat, --workspace-root oder AGGREGA_WORKSPACE_ROOT, mit dem Wert genau so, wie er angegeben wurde. Ein Befehl, der keinen Workspace liest, etwa aggrega version, liest auch den Stamm nicht und wird seinetwegen nicht abgewiesen.

Wo keines von beiden angegeben ist und die Erkennung nichts verankert, ist der Ordner, in dem der Befehl läuft, der Stamm, und ein Befehl, der seinen Workspace liest, meldet dies in einer Zeile auf der Standardfehlerausgabe und nennt diesen Ordner und dieses Flag; siehe Konfiguration, wo auch erklärt wird, warum in einem solchen Ordner nichts in einen Artefakt-Cache geschrieben wird.

Globale Konfigurationsdatei

--config <path> nennt die globale Konfigurationsdatei explizit für einen Aufruf. Es hat Vorrang vor der Umgebungsvariable AGGREGA_CONFIG, die wiederum Vorrang vor dem Standardort hat — und weil beide bewusst eine Datei nennen, ist ein nicht existierender Pfad ein deutlicher Fehler statt eines stillen Rückfalls. Anders als die AGGREGA_*-Einstellungsvariablen übersteuert keines von beiden eine einzelne Einstellung; sie bestimmen, welche Datei gilt. Welche Datei auch aufgelöst wird, die eigenen Konfigurationsdateien des Projekts legen sich weiterhin darüber. Konfiguration beschreibt die Auflösungsreihenfolge und was in diese Datei gehört.

--config und die Umgebungsvariable AGGREGA_CONFIG bestimmen das Schreibziel ebenso wie die Lesequelle: Ein mit --config <path> ausgeführter Befehl liest seine Konfiguration aus dieser Datei und wendet seine Änderung auf dieselbe Datei an, sodass das, was ein Befehl schreibt, das ist, was der nächste Befehl mit derselben Aufrufform zurückliest.

Konfigurationsändernde Befehle wählen die Datei, in die sie schreiben, nach der Art der Einstellung: Rechnerweite Werkzeugkonfiguration (eine Registry) geht standardmäßig in die globale Datei, während am Build beteiligte Konfiguration (eine Provider-Bindung oder eine Governance-/Linter-/Importer-Socket-Anbindung) standardmäßig in die committete Projektdatei geht. Übergeben Sie --global oder --workspace, um dies zu übersteuern, und der Befehl gibt aus, wohin er geschrieben hat.

Um auf einem neuen Rechner eine globale Konfiguration anzulegen — eine Registry und ihre Signatur-Vertrauensrichtlinie zu registrieren, damit signierte Artefakte ohne manuelles Bearbeiten von YAML gepullt und geprüft werden —, führen Sie aggrega config init aus. Um zu sehen, was gerade gilt, und mit --origin, welche Ebene jede Einstellung entschieden hat, führen Sie aggrega config show aus.

--offline

Jeden Netzwerkzugriff für diese eine Ausführung verweigern.

Offline ist eine Haltung des Workspace statt ein Modus eines einzelnen Befehls, und sie ist von drei Stellen aus erreichbar: diesem Flag, AGGREGA_OFFLINE und dem Schlüssel offline auf oberster Ebene in einer Konfigurationsdatei. Sie bedeuten dasselbe und stehen in der üblichen Reihenfolge — das Flag hat Vorrang vor der Variable, die Vorrang vor der Datei hat.

Die Ausschaltrichtung ist ebenso Aufgabe des Flags wie die Einschaltrichtung. --offline=false erlaubt das Netzwerk für einen Befehl, wo eine committete Konfigurationsdatei oder eine exportierte Variable die Haltung eingeschaltet hat. Das ist wichtig, wenn die Datei nicht Ihnen zur Bearbeitung zusteht: Ein Projekt, dessen .aggrega-config.yaml offline: true enthält, verweigert eine Veröffentlichung für jeden, der es klont, und --offline=false zu übergeben ist die einzige Antwort, die weder einen Commit noch eine exportierte Variable braucht.

Was verweigert wird und was nicht

Die Grenze ist das, was die Arbeit braucht, nicht welcher Befehl eingegeben wurde.

Verweigert, weil es ohne Erreichen einer Registry nicht zutreffen kann:

  • --upgrade, wo auch immer es erscheint. Es löst jede Abhängigkeit neu auf und hebt jede auf die höchste Version an, die eine Registry derzeit anbietet, und „höchste verfügbare“ ist eine Aussage darüber, was eine Registry gerade jetzt bereitstellt. Es gegen einen gefüllten Cache auszuführen, würde pinnen, was zufällig gecacht war, und dabei melden, es sei auf die neueste angehoben worden, was schlimmer ist als ein Abbruch.
  • Die Befehle, deren eigene Arbeit ein Netzwerk-Roundtrip ist: aggrega push, aggrega push-artifact und aggrega registry update. Diese melden dies, bevor sie Ihre Entität lesen oder Ihre Repositorys durchlaufen, und die Abweisung nennt, welche der drei Stellen die Haltung gesetzt hat, damit jemand, der kein Flag eingegeben hat, weiß, wo er nachsehen muss.

Nicht verweigert, weil der Rechner es möglicherweise bereits erfüllen kann:

  • Ein gewöhnliches aggrega pull und aggrega build --auto-pull. Beide berücksichtigen die bereits verzeichneten Pins und lösen nur auf, was keinen hat, sodass ein Workspace, dessen Referenzen alle gecacht oder in einem catalog_dirs-Katalog vorhanden sind, ganz ohne Zugriff nach außen abschließt. Wo eine solche Ausführung tatsächlich etwas abrufen muss, wird sie an dieser Stelle abgewiesen und erfährt, welche Referenz sie nicht erfüllen konnte.
  • aggrega build mit einer gefüllten Lockdatei, das seinen gesamten Abschluss aus dem Cache liest. Der einzige Zugriff, den es hat, ist eine Reparatur: Wo die Kopie einer gepinnten externen Eingabe im Speicher verloren gegangen ist, wird diese Eingabe über den Digest erneut abgerufen, den die Lockdatei bereits verzeichnet. Unter der Haltung gibt es nicht einmal dafür einen Transport, sodass die fehlende Kopie stattdessen den Build abbricht und die Haltung nennt.
  • Eine Veröffentlichung mit --dry-run. Ihr gesamtes Verhalten besteht darin, zu melden, was sie veröffentlichen würde, und nichts aufzurufen, was sie zur offline-sicheren Form des Veröffentlichens macht statt zu einem Widerspruch zur Haltung.

Ein vom Netzwerk getrennter Rechner mit einer lokalen Kopie seines Katalogs und seiner Artefakte ist der Fall, für dessen Funktionieren diese Aufteilung existiert: Ein solcher Workspace ist offline, und fast alles, was er tut, ist weiterhin erfüllbar.

Rangfolge der Konfiguration

Ein Flag hat Vorrang vor allem: vor einer Umgebungsvariable, vor den Konfigurationsdateien und vor dem eingebauten Standard. Konfiguration beschreibt die vollständige Rangfolge und environment-variables.md die Liste der Variablen mit dem Präfix AGGREGA_.

aggrega config show --origin meldet, welche dieser Ebenen jede Einstellung entschieden hat, und ein von Ihnen eingegebenes Flag wird als Flag gemeldet — wenn also eine Abweisung eine Ebene nennt, die Sie nicht erwartet haben, bestätigen Sie es mit diesem Befehl.

Siehe auch

  • configuration.md — in welche Datei eine Einstellung gehört, und das vollständige Rangfolgemodell.
  • environment-variables.md — die vollständige Referenz der AGGREGA_*-Variablen.
  • aggrega-serve.md — der Daemon löst seinen Workspace über denselben Weg der Stammerkennung auf.
FlagStandardBeschreibung
--config—Pfad zur globalen Konfigurationsdatei, übersteuert die Umgebungsvariable AGGREGA_CONFIG und den Standardort. Konfigurationsdateien im Workspace-Baum legen sich weiterhin darüber
--no-colorfalseANSI-Farbe in jeder Ausgabe deaktivieren. Wird auch über die Umgebungsvariable NO_COLOR berücksichtigt
--offlinefalseJeden Netzwerkzugriff für diese eine Ausführung verweigern: die Offline-Haltung, eingeschaltet ohne Bearbeiten der Konfiguration. Übergeben Sie —offline=false, um sie für eine Ausführung auszuschalten, wo die Konfigurationsdatei oder AGGREGA_OFFLINE sie bereits einschaltet. Verweigert wird, was ohne Registry nicht zutreffen kann: —upgrade, dessen ganze Aufgabe es ist, jede Abhängigkeit auf die höchste Version anzuheben, die eine Registry derzeit anbietet, und die Befehle, deren eigene Arbeit ein Netzwerk-Roundtrip ist — push, push-artifact und registry update. Weiterhin läuft alles, was der Rechner bereits erfüllen kann: ein Build mit einer gefüllten Lockdatei, —auto-pull über Referenzen, die bereits gecacht oder in einem lokalen Katalog vorhanden sind, und ein Probelauf, der meldet, was er veröffentlichen würde, und nichts aufruft
--plainfalseBarrierefreier Modus: Farbe deaktivieren und schlichte, statische Fortschrittszeilen ohne Spinner-Animation oder Neuzeichnen des Cursors ausgeben, auch an einem Terminal. Gedacht für Screenreader
--workspace-root—absoluter Pfad, der als Workspace-Stamm verwendet wird (überspringt die Erkennung)