Die Organisationskonfiguration kann 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 mit einer bestehenden übereinstimmen soll, das Überführen einer Konfiguration aus einem Test-Arbeitsbereich in einen produktiven sowie das Behalten eines nachvollziehbaren Nachweises darüber, wie ein Arbeitsbereich konfiguriert ist.
Was wird überführt?
Das Paket umfasst die Konfiguration auf Organisationsebene:
| Bereich | Enthalten |
|---|---|
| Richtlinien und Qualität | Organisationsrichtlinien, Qualitätsrichtlinien, Projektschranken, Lebenszyklus-Richtlinien, Review-Regeln |
| Agenten und Modelle | AI-Profile, Anbieter-Schlüssel Referenzen |
| Automatisierung | Hooks, Zeitpläne |
| Verbindungen | Integrationen zur Quellcode-Verwaltung, Kanalbrücken, MCP-Server |
| Zugriff | Konfiguration der Unternehmensidentität, Dienstkonten |
| Daten | Einstellungen zur Datenaufbewahrung, Speicherkonfiguration, Audit-Ziele |
Was wird nicht überführt?
Geheimnisse verlassen das Paket niemals. Anbieter-Schlüssel, Token und Anmeldeinformationen werden als Platzhalter exportiert. Das Paket protokolliert dass ein Schlüssel existiert und von welchen Komponenten er genutzt wird – niemals seinen Wert. Sie müssen die Geheimnisse nach dem Import erneut eingeben.
Außerdem ausgeschlossen: alles, was zur Identität des Arbeitsbereichs statt zur Konfiguration gehört – der Organisationsname, seine Mitglieder, die 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.
Vorschau vor der Anwendung
Beim Anwenden eines Pakets erfolgt zunächst eine Vorschau, die zeigt, was jeder Abschnitt bewirken würde:
| Status | Bedeutung |
|---|---|
applied | Die Einstellung wird erstellt oder aktualisiert. |
unchanged | Passt bereits; nichts zu tun. |
needsRebind | Hängt von etwas ab, das lokal neu zugewiesen werden muss. |
failed | Kann nicht angewendet werden; der Grund wird angegeben. |
Lesen Sie die Vorschau sorgfältig durch. needsRebind ist am wichtigsten – er kennzeichnet Einstellungen, die auf etwas verweisen, das im Ziel-Arbeitsbereich nicht identisch existiert, typischerweise eine Repository-Verbindung oder ein Geheimnis. Diese benötigen vor der tatsächlichen Gleichwertigkeit der Konfiguration Ihre Aufmerksamkeit.
Pakete in der Versionsverwaltung speichern
Ein exportiertes Paket ist eine Datei und kann somit in einem Repository gespeichert, differenziert und überprüft werden. 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 eine Person.
Da Geheimnisse als Platzhalter vorliegen, ist ein Paket zum Committen sicher – überprüfen Sie jedoch vor der Veröffentlichung, ob keine identifizierenden Angaben aus Ihrer eigenen Konfiguration enthalten sind.