jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-19 18:10:59 -05:00
Code Issues Projects Releases Wiki Activity
Files
eb9571a80de8d2dee7ae53c4e7adef09ad84b871
docs/content/migrations/overview/migration-paths-to-github.md
Peter Bengtsson eb9571a80d Remove GHAE in Liquid and front matter (7) (#48772)
2024-01-23 13:12:04 +00:00

18 KiB
Raw Blame History

title, shortTitle, intro, versions
title shortTitle intro versions
Migration paths to GitHub Migration paths See an overview of the paths available for migration to {% data variables.product.prodname_dotcom %} from other products, or between {% data variables.product.prodname_dotcom %} products.
fpt ghes ghec ghae
* * * *

About migration paths to GitHub

{% data reusables.migrations.about-migrations %}

{% data reusables.migrations.about-migration-paths %} For some migration paths, we offer specialist tools that allow you to migrate source, history, and metadata. For others, you'll need to perform a simpler "source and history" or "source snapshot" migration.

Some migration paths require tools that are only available with expert-led migrations. For more information, contact your account manager on {% data variables.contact.contact_enterprise_sales %} or see the {% data variables.product.prodname_expert_services %} website.

In our recommendations, we'll assume that you want the highest level of fidelity if possible, which includes source, history, and metadata.

Migrations to {% data variables.product.prodname_dotcom_the_website %}

You can review the scope and tooling for your migration to {% data variables.product.prodname_dotcom_the_website %}, which includes migrations to {% data variables.product.prodname_ghe_cloud %}. You can also review any additional information or caveats.

{% data variables.product.prodname_ghe_server %} 3.4.1 or newer to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source, history, and metadata
  • Tooling: {% data variables.product.prodname_importer_proper_name %}
  • More information:
  • Caveats:
    • {% data reusables.migrations.large-repositories-require-expert-services %}
    • {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

{% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source, history, and metadata
  • Tooling: {% data variables.product.prodname_importer_proper_name %}
  • More information:
  • Caveats:
    • {% data reusables.migrations.large-repositories-require-expert-services %}
    • {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

{% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_dotcom_the_website %}

Migrations from {% data variables.product.prodname_dotcom_the_website %} include {% data variables.product.prodname_ghe_cloud %}. This path includes adoption of {% data variables.product.prodname_emus %} or a move between managed enterprises.

  • Scope: Source, history, and metadata
  • Tooling: {% data variables.product.prodname_importer_proper_name %} or {% data variables.product.prodname_expert_services %}
  • More information:
  • Caveats:
    • {% data reusables.migrations.large-repositories-require-expert-services %}
    • {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

Azure DevOps Services (Azure DevOps Cloud) to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source, history, and metadata
  • Tooling: {% data variables.product.prodname_importer_proper_name %}
  • More information: "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"

Azure DevOps Server to {% data variables.product.prodname_dotcom_the_website %}

Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source and history
  • Tooling: Git CLI or GitHub Importer
  • More information:
    • "AUTOTITLE"
    • "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)"

Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source, history, and metadata
  • Tooling: {% data variables.product.prodname_importer_proper_name %}
  • More information:
  • Caveats:
    • For complex repositories larger than around 5 GB, you may need to use bbs-exporter and Enterprise Cloud Importer instead. Enterprise Cloud Importer is only available for expert-led migrations.
    • {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

GitLab to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source, history, and metadata
  • Tooling: gl-exporter, then Enterprise Cloud Importer (expert-led migrations only)
  • More information: {% data variables.product.prodname_expert_services %} website
  • Caveats:
    • Enterprise Cloud Importer is only available for expert-led migrations.
    • {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

Any Git repository to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source and history
  • Tooling: Git CLI or GitHub Importer if the repository is accessible over the public internet
  • More information:
    • "AUTOTITLE"
    • "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)"

Any Mercurial repository to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source and history
  • Tooling: Mercurial, Git CLI, and Python
  • More information: "AUTOTITLE"

Any Subversion (SVN) repository to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source and history
  • Tooling: Subversion and Git CLI
  • More information: "AUTOTITLE"

Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source and history
  • Tooling: Azure Repos, then Git CLI
  • More information: "AUTOTITLE"

Any Perforce repository to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source and history
  • Tooling: git-p4, then Git CLI
  • More information:

Any other repository to {% data variables.product.prodname_dotcom_the_website %}

  • Scope: Source snapshot
  • Tooling: {% data variables.product.prodname_cli %} or Git CLI
  • More information: "AUTOTITLE"

Migrations to {% data variables.product.prodname_ghe_server %}

You can review the scope and tooling for your migration to {% data variables.product.prodname_ghe_server %}, including any additional information or caveats.

{% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_ghe_server %}

Migrations from {% data variables.product.prodname_dotcom_the_website %} include {% data variables.product.prodname_ghe_cloud %}.

  • Scope: Source, history, and metadata
  • Tooling: Organization migrations API, then ghe-migrator
  • More information:

{% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_server %}

  • Scope: Source, history, and metadata
  • Tooling: Organization migrations API, then ghe-migrator
  • More information:

Azure DevOps to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: Git CLI
  • More information: "AUTOTITLE"

Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: Git CLI
  • More information: "AUTOTITLE"

Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_ghe_server %}

GitLab to {% data variables.product.prodname_ghe_server %}

Any Git repository to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: Git CLI
  • More information: "AUTOTITLE"

Any Mercurial repository to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: Mercurial, Git CLI, and Python
  • More information: "AUTOTITLE"

Any Subversion (SVN) repository to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: Subversion and Git CLI
  • More information: "AUTOTITLE"

Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: Azure Repos, then Git CLI
  • More information: "AUTOTITLE"

Any Perforce repository to {% data variables.product.prodname_ghe_server %}

  • Scope: Source and history
  • Tooling: git-p4, then Git CLI
  • More information:

Any other repository to {% data variables.product.prodname_ghe_server %}

  • Scope: Source snapshot
  • Tooling: {% data variables.product.prodname_cli %} or Git CLI
  • More information: "AUTOTITLE"
Reference in New Issue View Git Blame Copy Permalink