Die Migration eines Enterprise-Kontos von der klassischen Umgebungseinrichtung zur deklarativen Konfiguration ist eine weitreichende Änderung. Auf der Seite „Rollout“ können Enterprise-Admins diesen Übergang detailliert steuern. Sie können Blueprints für einige Pilot-Orgs aktivieren, die Einführung in Ihrem eigenen Tempo ausweiten und bei Problemen sofort zurückrollen.Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
Rollout-Status im Enterprise
| Status | Bedeutung | Auswirkung auf Organisationen |
|---|---|---|
| Nicht aktiviert | Deklarative Umgebungen wurden für das Enterprise noch nicht aktiviert | Keine Orgs sehen die Umgebungsseiten. Alle Orgs verwenden das klassische Setup. Wenden Sie sich zum Aktivieren an Ihren Cognition-Administrator. |
| Testbetrieb | Nur manuell aktivierte Organisationen verwenden deklarative Umgebungen | Ein Enterprise-Administrator aktiviert einzelne Orgs auf der Rollout-Seite. Alle anderen Orgs bleiben beim klassischen Setup und sehen keine Änderungen. |
| Verfügbar | Org-Administratoren sehen eine Migrationsaufforderung und können selbst umstellen | Org-Administratoren im klassischen Setup sehen auf ihrer Seite „Machine Configuration“ einen Migrationshinweis. Sie können ohne Eingreifen eines Enterprise-Administrators eigenständig migrieren. |
| Standardmäßig aktiviert | Neue Organisationen verwenden standardmäßig deklarative Umgebungen | Alle neuen Orgs starten mit Blueprints. Bestehende Orgs, die im klassischen Setup mit Repos arbeiten, erhalten automatisch klassische Überschreibungen. |
Details zu „Testing mode“
Details zum Modus „Available“
Überschreibungen pro Organisation
- In den Modi „Testing“ oder „Available“: Bestimmte Organisationen für Blueprints aktivieren. Diese Organisationen wechseln sofort vom klassischen Setup zur deklarativen Konfiguration.
- Im Modus „Enabled by default“: Bestimmte Organisationen wieder auf das klassische Setup zurücksetzen. Diese Organisationen verwenden weiterhin ihre klassische Konfiguration.
Automatische klassische Überschreibungen
Empfohlenes Migrations-Playbook
Phase 1: Isoliert aufsetzen und verifizieren (Testing)
- Aktivieren Sie deklarative Umgebungen für das Enterprise. Ihr Cognition-Administrator aktiviert die Funktion, wodurch das Enterprise in den Modus Testing versetzt wird.
- Erstellen Sie eine dedizierte Test-Org zum Testen der Umgebungskonfiguration. Diese Org dient ausschließlich dazu, Ihre Blueprints zu validieren.
- Aktivieren Sie die deklarative Konfiguration nur für diese Test-Org (über den org-spezifischen Override auf der Rollout-Seite).
- Konfigurieren Sie Ihren Enterprise-Blueprint: Installieren Sie alle gemeinsam genutzten Sprach-Runtimes, Sicherheitstools, Unternehmenszertifikate, internen CLIs, Proxy-Einstellungen und die Registry-Authentifizierung. Das ist Ihre Basisschicht, die jede Org übernimmt.
- Konfigurieren Sie einen Org-Blueprint für die Test-Org mit allen Tools auf Org-Ebene oder der Registry-Konfiguration.
- Fügen Sie Repository-Blueprints hinzu für eine repräsentative Auswahl an Repositorys. Wählen Sie Repos aus, die Ihre gängigsten Tech-Stacks abdecken.
- Prüfen Sie alles Ende-zu-Ende: Starten Sie Devin-Sitzungen in diesen Repos und bestätigen Sie, dass alles funktioniert. Die Repos sollten geklont, Abhängigkeiten installiert und Lint-/Test-/Build-Befehle korrekt ausgeführt werden; außerdem sollten alle Tools in den erwarteten Versionen vorliegen.
Phase 2: Opt-in für Org-Admins aktivieren (Verfügbar)
- Intern kommunizieren Sie gegenüber den Org-Admins, dass die deklarative Konfiguration verfügbar und einsatzbereit ist.
- In den Modus Available wechseln: Ändern Sie das Dropdown „Rollout mode“ von Testing auf Available. Org-Admins im klassischen Setup sehen jetzt einen Migrationshinweis, der sie zur Migration ermutigt.
- Org-Admins können jetzt migrieren ihre eigenen Organisationen. Da der Enterprise-Blueprint bereits die Basisschicht (Laufzeitumgebungen, Tools, Zertifikate, Registries) bereitstellt, müssen Org-Admins nur noch das konfigurieren, was für ihr Team und ihre Repos spezifisch ist.
Phase 3: Ausweiten und aufräumen (Enabled by default)
- Enabled by default aktivieren, sobald die meisten Orgs Blueprints verwenden. Dies ist eine dauerhafte Aktion — Orgs, die das klassische Setup mit Repos genutzt haben, erhalten automatisch klassische Überschreibungen, sodass sich für sie nichts ändert.
- Neue Orgs, die ab diesem Zeitpunkt erstellt werden, starten standardmäßig mit Blueprints.
- Die Rollout-Seite überwachen, um den Build-Status aller Orgs im Blick zu behalten. Nach „Classic“ filtern, um zu sehen, wer noch nicht migriert ist.
- Mit den verbleibenden Org-Admins zusammenarbeiten, um die letzten Nachzügler zu migrieren. Der Migrationsassistent macht das einfach.
- Klassische Überschreibungen entfernen, sobald alle Orgs auf Blueprints bestätigt sind.
Die klassische Konfiguration bleibt immer erhalten. Beim Wechsel einer Org zu Blueprints wird nichts gelöscht. Falls etwas schiefgeht, können Enterprise-Admins jede Org über die Rollout-Seite mithilfe von org-spezifischen Überschreibungen wieder auf das klassische Setup zurücksetzen.
Beschleunigte Migrationsstrategie
- Im Testing-Modus beginnen (damit jede Organisation einzeln aktiviert werden kann).
- Zuerst den Enterprise-Blueprint konfigurieren. Lassen Sie Admins den Enterprise-Blueprint mit gemeinsam genutzten Runtimes, Tools, Zertifikaten und der Registry-Konfiguration einrichten. Das ist die Basisschicht, die alle Organisationen übernehmen.
- In den Modus „Available“ wechseln. Dadurch wird der Migrationshinweis aktiviert, sodass Organisations-Admins auf ihrer Seite „Machine Configuration“ einen Hinweis sehen und die Migration selbst durchführen können.
- Dokumentation breit streuen über die vorhandenen internen Channels (Slack, E-Mail, Wiki) und Organisations-Admins dazu ermutigen, sich selbst zu aktivieren. Der Migrationsassistent ermöglicht diesen Selbstservice für Organisations-Admins.
- Für Organisationen mit 0 aktuell konfigurierten Repositorys automatisch aktivieren. Diese Organisationen haben nichts zu migrieren — der Wechsel zu Blueprints ist risikolos, da sie kein bestehendes klassisches Setup haben, das erhalten werden muss.
- Die verbleibenden Organisationen schrittweise nacheinander migrieren. Wenn der Enterprise-Blueprint bereits konfiguriert ist, muss bei jeder Organisationsmigration nur noch organisationsspezifische und repo-spezifische Konfiguration ergänzt werden. Das ist deutlich einfacher, als von Grund auf zu migrieren.
- „Enabled by default“ aktivieren, sobald die meisten Organisationen migriert wurden. Neue Organisationen, die nach diesem Zeitpunkt erstellt werden, starten mit aktivierten Blueprints.
Rollback
Rollback pro Org
- Die Org kehrt sofort zu ihrem Snapshot des klassischen Setups zurück.
- Die klassische Konfiguration bleibt erhalten. Wenn eine Org zu Blueprints wechselt, geht nichts verloren, daher ist ein Zurückwechseln sicher.
- Aktive Sitzungen sind nicht betroffen. Die Änderung wird in der nächsten Sitzung wirksam.
Modus-Rollback
Ein Rollback löscht weder Blueprints noch klassische Konfigurationen. Beide bleiben erhalten, unabhängig davon, welcher Modus aktiv ist, sodass Sie ohne Arbeitsverlust zwischen Testing und Available wechseln können.
Überwachung des Rollout-Status
KPI-Zeile
- Blueprint-Organisationen: Anzahl der Organisationen, die derzeit Blueprints nutzen
- Rollout-Prozentsatz: Prozentsatz der Organisationen mit Blueprints an der Gesamtzahl
- Build-Status: Aggregierter Build-Status über alle Blueprint-Organisationen hinweg
Tabelle pro Org
| Column | Description |
|---|---|
| Organization | Name der Org |
| State | Aktueller Modus: Blueprints oder Classic |
| Override | Ob der Status der Org explizit überschrieben wird oder dem Enterprise-Standard entspricht |
| Classic repos | Anzahl der Repos mit klassischer Setup-Konfiguration |
| Blueprint repos | Anzahl der Repos mit Blueprints |
| Latest build | Status des letzten Builds (erfolgreich, teilweise, fehlgeschlagen usw.) |
Filtern
- Alle: Alle Orgs im Enterprise
- Blueprints: Orgs, die derzeit Blueprints nutzen
- Classic: Orgs, die derzeit das klassische Setup nutzen
- Überschreibungen: Orgs mit expliziten Statusüberschreibungen (in beide Richtungen)
Sicherheit bei gleichzeitigen Änderungen
Audit-Protokollierung
- Änderungen am Enterprise-Modus (Testing → Verfügbar, Aktivierung von „Standardmäßig aktiviert“ usw.)
- Änderungen an org-spezifischen Überschreibungen (org hat sich angemeldet, org hat sich abgemeldet, Überschreibung entfernt)
- Welcher Admin die Änderung vorgenommen hat und wann
