Informationen zu Migrationen von Butbucket Server zu GitHub Enterprise Cloud

Erfahren Sie, welche Daten GitHub Enterprise Importer migrieren kann.

In diesem Artikel

Informationen zum Migrieren von Bitbucket Server

Du kannst GitHub Enterprise Importer verwenden, um Repositorys von Bitbucket Server zu GitHub Enterprise Cloud (GitHub.com oder GHE.com) zu migrieren. Die Migration von Bitbucket Server wird nur für Bitbucket Server oder Bitbucket Data Center ab Version 5.14 unterstützt.

Migrierte Daten

Derzeit wird nur die Migration der folgenden Repositorydaten von Bitbucket Server zu GitHub Enterprise Cloud unterstützt.

  • Git-Quelle (einschließlich Commitverlauf)

  • Pull Requests (Kommentare, Pull Request-Reviews, Pull Request-Reviewkommentare auf Datei- und Zeilenebene, erforderliche Reviewer und Anlagen eingeschlossen)

    Hinweis

    Benutzer erhalten möglicherweise einen Fehler 500 beim Versuch, einen Pull Request anzuzeigen, wenn der Pull Request zusammengeführt wurde und der Head-Branch vor der Migration auf Bitbucket Server gelöscht wurde. Bitbucket Server entfernt bestimmte Git-Verweise auf Objekte für solche Pull Requests, und folglich können diese Git-Objekte, die dem Pull Request zugeordnet sind, nicht migriert werden.

Nicht migrierte Daten

Derzeit werden die folgenden Daten nicht migriert.

  • Persönliche Repositorys im Besitz von Benutzern
  • Branchberechtigungen
  • Commit-Kommentare
  • Repositoryeinstellungen
  • CI-Pipelines

Einschränkungen bei migrierten Daten

Es gelten Einschränkungen dafür, was GitHub Enterprise Importer migrieren kann. Einige sind auf Einschränkungen von GitHub zurückzuführen, während andere Einschränkungen durch GitHub Enterprise Importer selbst verursacht werden.

Grenzwerte auf GitHub

  • Größenbeschränkung von 2 GB für einen einzelnen Git-Commit: Kein einzelner Commit in deinem Git-Repository darf größer als 2 GB sein. Wenn einer deiner Commits größer als 2 GB ist, musst du den Commit in kleinere Commits aufteilen, die jeweils 2 GB oder kleiner sind.
  • Grenzwert von 255 Byte für Git-Verweise: Kein einzelner Git-Verweis (allgemein als „Ref“ bezeichnet) darf einen Namen haben, der größer als 255 Byte ist. In der Regel bedeutet dies, dass deine Verweise nicht mehr als 255 Zeichen lang sein dürfen, aber Nicht-ASCII-Zeichen wie z. B. Emojis können mehr als ein Byte groß sein. Wenn einer deiner Git-Verweise zu groß ist, wird eine eindeutige Fehlermeldung zurückgegeben.
  • Grenzwert von 100 MB für die Dateigröße: Nach Abschluss der Migration darf keine einzelne Datei in deinem Git-Repository größer als 100 MB sein. Während der Repositorymigration wird dieser Grenzwert auf 400 MB erhöht. Erwäge die Verwendung von Git LFS zum Speichern großer Dateien. Weitere Informationen finden Sie unter Große Dateien verwalten.

Einschränkungen von GitHub Enterprise Importer

  • Größenbeschränkung von 40 GB für Repositoryarchive (public preview): Der Importer kann Repositorys mit mehr als 40 GB kombinierten Git-Daten und -Metadaten im Repositoryarchiv nicht migrieren.
  • 400 MB file size limit: When migrating a repository with GitHub Enterprise Importer, no single file in your Git repository can be larger than 400 MB. Consider using Git LFS for storing large files. For more information, see Große Dateien verwalten.
  • Git LFS objects not migrated: The Importer can migrate repositories that use Git LFS, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see Ein Repository duplizieren.
  • Follow-up tasks required: When migrating between GitHub products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see Übersicht über die Migration zwischen GitHub-Produkten.
  • Delayed code search functionality: Re-indexing the search index can take a few hours after a repository is migrated, and code searches may return unexpected results until re-indexing is complete.
  • Rulesets configured for your organization can cause migrations to fail: For example, if you configured a rule that requires email addresses for commit authors to end with @monalisa.cat, and the repository you're migrating contains commits that don't comply with this rule, your migration will fail. For more information about rulesets, see Informationen zu Regelsätzen.
  • Mannequin content might not be searchable: Mannequins are placeholder users to which imported content (such as issues, pull requests, comments, etc.) is associated. When you search for content associated with a mannequin, such as assigned issues, the issues may not be found. Once a mannequin is reclaimed, the content should be found via the new owner. For more information, see Freigeben von Mannequins für GitHub Enterprise Importer.

Erste Schritte

Bevor Sie von Bitbucket Server migrieren, sollten Sie die Art der Ausführung der Migration planen. Bevor Sie Daten migrieren, müssen Sie eine Person auswählen, die die Migration ausführen soll. Sie müssen dieser Person den erforderlichen Zugriff sowohl auf die Quelle als auch auf das Ziel der Migration gewähren. Außerdem empfehlen wir, zuerst eine Testmigration vorzunehmen.

Eine Übersicht über den Migrationsprozess von Anfang bis Ende findest du unter Übersicht über die Migration von Butbucket Server zu GitHub Enterprise Cloud.