Dokumentation

Einstellungen exportieren und importieren

Organisationskonfiguration zwischen Arbeitsbereichen als portables Paket überführen – ohne Geheimnisse zu migrieren.

Die Organisationseinstellungen können als portables Paket exportiert und auf eine andere Organisation angewendet werden. Sie finden es unter Einstellungen → Daten → Einstellungen exportieren.

Dies ist für drei Szenarien nützlich: das Einrichten einer zweiten Organisation, die der ersten entsprechen soll, das Übernehmen einer Konfiguration aus einem Test-Arbeitsbereich in einen produktiven Bereich sowie das Aufbewahren eines nachvollziehbaren Nachweises über die Konfiguration eines Arbeitsbereichs.

Was mittransportiert wird

Das Paket umfasst die Einstellungen auf Organisationsebene:

BereichEnthalten
Richtlinien und QualitätOrganisationsrichtlinie, Qualitätsrichtlinien, Projekt-Gates, Lebenszyklus-Richtlinien, Review-Regeln
LieferungAufträge: wofür die autonome Arbeit bestimmt ist (Ziel, Prioritäten, Umfang, Budget pro Zeitfenster, Abbruchbedingungen, Review-Termin, Drift-Regel, Verantwortliche Rolle). Baselines sind Messwerte und bleiben erhalten; ein Import erstellt Entwürfe, die eine Person veröffentlichen kann.
Agenten und ModelleAI-Profile, Anbieter-Schlüssel Referenzen
AutomatisierungHooks, Zeitpläne
VerbindungenIntegrationen zur Quellcode-Verwaltung, Kanal-Brücken, MCP-Server
ZugriffKonfiguration der Unternehmensidentität, Dienstkonten sowie ob jedes Konto automatisch qualifizierte Arbeit startet.
DatenEinstellungen zur Aufbewahrung, Speicherkonfiguration, Audit-Ziele

Ein Import erstellt keine Dienstkonten. Ein bereits unter demselben Namen existierendes Konto übernimmt die im Paket festgelegte Einstellung, ob seine qualifizierte Arbeit automatisch startet.

Was nicht mittransportiert wird

Geheime Daten verlassen das Paket niemals. Anbieter-Schlüssel, Tokens und Anmeldeinformationen werden als Platzhalter exportiert. Das Paket protokolliert dass ein Schlüssel existiert und welche Komponenten ihn nutzen – niemals seinen Wert; Sie müssen die geheimen Daten nach dem Import erneut eingeben.

Auch ausgeschlossen: alles, was zur Identität des Arbeitsbereichs gehört statt zur Konfiguration – der Organisationsname, seine Mitglieder, seine Abrechnungsbeziehung – sowie operative Historie wie Aufgaben, Ausführungen und Audit-Ereignisse.

Die Regel lautet: Ein Paket beschreibt, wie ein Arbeitsbereich konfiguriertist, nicht, was darin geschehen ist.

Ein Paket anwenden

Das Portal exportiert Pakete, aber importiert sie nicht. Um eines anzuwenden, verbinden Sie einen Agenten wie Hermes mit dem MCP-Server von Coroid. Der Agent zeigt das Paket vor und wendet es anschließend an. Er kann auch eine Organisation anhand von Screenshots, Dateien oder Beschreibungen konfigurieren, indem er diese zuerst in ein Paket schreibt.

Zum Anwenden ist eine Verbindung erforderlich, die einem Inhaber gehört, und ein Inhaber oder Administrator muss jede Anwendung genehmigen. Auf coroid.ai sind diese Administrationswerkzeuge noch nicht aktiviert. Siehe Organisationseinstellungen über MCP.

Vorschau vor dem Anwenden

Beim Anwenden eines Pakets wird zuerst eine Vorschau angezeigt, die zeigt, was jeder Abschnitt bewirken würde:

StatusBedeutung
appliedDie Einstellung wird erstellt oder aktualisiert.
unchangedEntspricht bereits; nichts zu tun.
needsRebindHängt von etwas ab, das lokal neu zugewiesen werden muss.
failedKann nicht angewendet werden; der Grund wird angegeben.

Lesen Sie die Vorschau sorgfältig durch. needsRebind ist am wichtigsten – es markiert Einstellungen, die auf etwas verweisen, das im Ziel nicht identisch existiert, typischerweise eine Repository-Verbindung oder ein geheimes Element. Diese benötigen Aufmerksamkeit, bevor die Konfiguration tatsächlich gleichwertig ist.

Einstellungs-Bundle

  • Richtlinien und Qualität
  • AI-Profile
  • Hooks und Zeitpläne
  • Verbindungen

••••••Geheimnisse werden zu Platzhaltern

In der Zielorganisation vorschauen

  • AI-ProfileWerden erstellt oder aktualisiertapplied
  • QualitätsrichtlinienStimmt bereits übereinunchanged
  • Integration der VersionsverwaltungAuf eine lokale Verbindung umleiten und den Schlüssel erneut eingebenneedsRebind
  • HooksKann nicht angewendet werden; der Grund wird angezeigt.failed
Beispielhafte Vorschau. Ein Bundle enthält Konfigurationen mit Platzhaltern für Geheimnisse, und die Vorschau zeigt an, welche Auswirkungen jeder Abschnitt hätte, bevor etwas angewendet wird.

Pakete in der Versionsverwaltung aufbewahren

Ein exportiertes Paket ist eine Datei, sodass es in einem Repository gespeichert, diff’ed und überprüft werden kann. Für Teams, die Konfiguration als Code betrachten, liegt der Wert darin: Eine Änderung an der Organisationsrichtlinie wird zu einem überprüfbaren Diff statt zu einem Klick durch jemanden.

Da geheime Daten als Platzhalter vorliegen, ist ein Paket zum Committen sicher – aber prüfen Sie vor der Veröffentlichung, ob nichts Identifizierendes in Ihrer eigenen Konfiguration enthalten ist.