Atlassian Migration API: Überblick und Vorteile

Letzte Woche hat Atlassian die allgemeine Verfügbarkeit der Migrations API (MAPI) angekündigt. Das ist ein guter Anlass, die Funktionen dieser API genauer zu betrachten, ihre Vor- und Nachteile zu analysieren und Möglichkeiten aufzuzeigen, wie sich ihr Potenzial nutzen lässt.

Mit MAPI möchte Atlassian Partner und Power-User bei Cloud-Migrationen unterstützen. Die API soll wiederkehrende Aufgaben bei der Planung und Durchführung von Migrationen automatisieren. Derzeit werden nur Jira und Confluence unterstützt.

Die Verfügbarkeit dieser API ist zwar grundsätzlich ein Gewinn für Cloud-Migrationen, doch der geringe Funktionsumfang ist einer ihrer größten Nachteile. Schauen wir genauer hin!

Was kann MAPI?

Mit MAPI können wir Migrationsjobs erstellen, verknüpfen und abrufen, Migrationsaufgaben erstellen und abrufen sowie den Status einer bestimmten Migrationsaufgabe abfragen.

Ein Migrationsjob ist im Wesentlichen der Migrationsplan. Er enthält die Definition der Migration, die wir durchführen möchten. Er ist an einen „Flow“ beziehungsweise Migrationstyp für Jira oder Confluence gebunden und enthält alle Informationen, die für die Migration erforderlich sind: Quell- und Zielinstanzen sowie den Umfang der Migration, etwa Apps, Benutzer und Gruppen, Projekte oder Bereiche, produktspezifische Funktionen und mehr.

Nach der Erstellung muss ein Migrationsjob mit einer On-Premises-Instanz verknüpft werden, die zuvor für Cloud-Migrationen vorbereitet wurde. Damit bestätigen wir im Grunde, dass wir auf das System zugreifen dürfen und berechtigt sind, dessen Daten zu migrieren.

Bevor MAPI genutzt wird, muss der Migrationsverantwortliche alle Bewertungen vor der Migration abschließen. Diese tragen in den meisten Fällen zu einer erfolgreichen Migration bei. Eine vollständige Übersicht der erforderlichen Vorbereitungsschritte findet ihr in der Checkliste vor der Migration für den Jira Cloud Migration Assistant oder der Checkliste vor der Migration für Confluence.

Sobald ein Migrationsjob erstellt und verknüpft wurde, können wir Migrationsaufgaben dafür erstellen und ausführen. Derzeit stehen nur zwei Arten von Aufgaben zur Verfügung: Prüfungen vor der Migration und die Migration selbst. Der Status jeder Aufgabe kann jederzeit abgerufen werden.

Dabei sind zwei wichtige Aspekte zu beachten: Rate Limiting und Datenaufbewahrung. Das Rate Limiting betrifft vor allem die Erstellung von Migrationsjobs und -aufgaben und erlaubt nur fünf Anfragen pro Minute. Außerdem erlauben die Richtlinien zur Datenaufbewahrung der API eine Speicherung von Informationen für maximal 30 Tage.

Das Gute, das Schlechte und das Hässliche

Das Gute: MAPI ist ein weiteres Werkzeug im Werkzeugkasten eines Migrationsverantwortlichen. Damit lassen sich komplexe Migrationspläne mit Hunderten von Projekten einfacher erstellen, validieren und ausführen. Diese müssten sonst manuell ausgewählt werden. Die Abläufe werden wiederholbar, der Aufwand sinkt und das Fehlerrisiko wird reduziert.

Das Schlechte: Die Achillesferse von MAPI ist der geringe Funktionsumfang. Eine Migration kann erst geplant und durchgeführt werden, nachdem eine Instanz vollständig vorbereitet wurde. Es wäre hilfreich, wenn Benutzer bestimmte Aspekte der Instanz vorbereiten könnten, etwa Apps, Benutzer, Gruppen und Domains. Diese Schritte müssen weiterhin manuell durchgeführt werden, obwohl hier noch Automatisierungspotenzial besteht.

Darüber hinaus sollte Atlassian die Möglichkeit vorsehen, einen bestehenden Migrationsjob vor seiner Ausführung zu bearbeiten oder zu löschen. Leider gibt es noch keine öffentliche Roadmap, sodass sich schwer sagen lässt, ob diese Funktionen künftig verfügbar sein werden.

Das Hässliche: Der Prozess zum Verknüpfen eines Migrationsjobs könnte deutlich verbessert werden. Wie bereits erläutert, benötigen wir Zugriff auf die Cloud- und die On-Premises-Instanz, um einen mit MAPI erstellten Migrationsjob zu verknüpfen.

Bei der Vorbereitung der On-Premises-Instanz muss ein Administrator den Cloud Migration Assistant (CMA) immer mit der Ziel-Cloud-Instanz verbinden. Das bedeutet, dass die Sicherheitstoken bereits ausgetauscht wurden. Daher sollte es nicht notwendig sein, Anfragen direkt an die On-Premises-Instanz zu senden, da MAPI und CMA sicher miteinander kommunizieren und diese Informationen austauschen können.

Außerdem wäre es sehr hilfreich, wenn MAPI Suchendpunkte für bereits verknüpfte On-Premises-Instanzen bereitstellen würde. So könnte beispielsweise eine Liste von Projekten oder Bereichen abgerufen werden, die zu einer bestimmten Kategorie gehören und später zur Definition des Umfangs eines Migrationsjobs verwendet werden können.

Wie profitieren wir von Atlassians MAPI?

Einige unserer Kollegen haben bereits Skripte entwickelt, um den oben beschriebenen gesamten Prozess zu automatisieren. Das beschleunigt die Erstellung von Plänen während Testphasen von Migrationen mit mehreren Durchläufen. Vor MAPI mussten Hunderte von Projekten oder Bereichen manuell ausgewählt werden.

Ein weiterer möglicher Anwendungsfall für MAPI ist ein Migrationsorchestrator, der die Remote-Konfiguration und -Ausführung von Migrationen über eine vereinfachte Oberfläche ermöglicht. Angesichts der aktuellen Einschränkungen eignet sich ein solcher Orchestrator möglicherweise am besten für kleine oder schrittweise Migrationen mit geringer Komplexität und Cloud-kompatiblen Apps. Die Integration mit Jira Service Management könnte Serviceanfragen vereinfachen: Kunden könnten Projekte oder Bereiche für eine schrittweise Migration auswählen, der Prozess würde effizienter und Kunden nach Abschluss benachrichtigt.

Fazit

Die Migration API befindet sich noch in einem frühen Stadium und es fehlen einige gewünschte Funktionen. Dennoch gibt es konkrete Szenarien, in denen ihr Einsatz gegenüber dem Cloud Migration Assistant Vorteile bietet.

Vorteile

• Ein wertvolles Tool für erfahrene Migrationsverantwortliche mit Programmierkenntnissen

• Potenziell geringerer Aufwand bei großen oder komplexen Migrationen

Nachteile

• Der API-Anbindungsprozess könnte einfacher sein

• Begrenzter Funktionsumfang

• Keine öffentliche Roadmap