Clarify recommended migration tools for each migration path to GitHub (#41812)

Co-authored-by: Matt Pollard <mattpollard@users.noreply.github.com>
This commit is contained in:
Tim Rogers 2023-09-15 14:10:19 +01:00 коммит произвёл GitHub
Родитель 2fef6791f8
Коммит 1f675f4112
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
9 изменённых файлов: 272 добавлений и 83 удалений

Просмотреть файл

@ -9,5 +9,6 @@ versions:
children:
- /about-githubs-migration-tooling
- /planning-your-migration-to-github
- /migration-paths-to-github
- /about-locked-repositories
---

Просмотреть файл

@ -0,0 +1,262 @@
---
title: Migration paths to GitHub
shortTitle: Migration paths
intro: '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.'
versions:
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 %}](https://github.com/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 %}](#github-enterprise-server-341-or-newer-to-githubcom)
- [{% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.product.prodname_dotcom_the_website %}](#github-enterprise-server-340-or-older-to-githubcom)
- [{% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_dotcom_the_website %}](#githubcom-to-githubcom)
- [Azure DevOps Services (Azure DevOps Cloud) to {% data variables.product.prodname_dotcom_the_website %}](#azure-devops-services-azure-devops-cloud-to-githubcom)
- [Azure DevOps Server to {% data variables.product.prodname_dotcom_the_website %}](#azure-devops-server-to-githubcom)
- [Bitbucket Cloud (Bitbucket.org-to-githubcom) to {% data variables.product.prodname_dotcom_the_website %}](#bitbucket-cloud-bitbucketorg-to-githubcom)
- [Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_dotcom_the_website %}](#bitbucket-server-or-bitbucket-data-center-to-githubcom)
- [GitLab to {% data variables.product.prodname_dotcom_the_website %}](#gitlab-to-githubcom)
- [Any Git repository to {% data variables.product.prodname_dotcom_the_website %}](#any-git-repository-to-githubcom)
- [Any Mercurial repository to {% data variables.product.prodname_dotcom_the_website %}](#any-mercurial-repository-to-githubcom)
- [Any Subversion (SVN) repository to {% data variables.product.prodname_dotcom_the_website %}](#any-subversion-svn-repository-to-githubcom)
- [Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_dotcom_the_website %}](#any-team-foundation-version-control-tfvc-repository-to-githubcom)
- [Any Perforce repository to {% data variables.product.prodname_dotcom_the_website %}](#any-perforce-repository-to-githubcom)
- [Any other repository to {% data variables.product.prodname_dotcom_the_website %}](#any-other-repository-to-githubcom)
### {% 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**:
- "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
- [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **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**:
- "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
- [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **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**:
- "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
- [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **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 %}
- **Scope**: Source, history, and metadata
- **Tooling**: Migration to Azure DevOps Services, then {% data variables.product.prodname_importer_proper_name %}
- **More information**:
- [Migrate data from Azure DevOps Server to Azure DevOps Services](https://learn.microsoft.com/en-us/azure/devops/migrate/migration-overview?view=azure-devops) in the Microsoft Docs
- "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
- **Caveats**: If you can't migrate to Azure DevOps Services first, you must perform a "source and history" migration instead. For more information, "[Migrations from any Git repository to {% data variables.product.prodname_dotcom_the_website %}](#migrations-from-any-git-repository)."
### 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](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
- "[AUTOTITLE]({% ifversion ghes or ghae %}/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 %}
{% data reusables.enterprise-migration-tool.bbs-release-phase %}
- **Scope**: Source, history, and metadata
- **Tooling**: {% data variables.product.prodname_importer_proper_name %} (public beta)
- **More information**:
- "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
- [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **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 %}](https://github.com/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](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
- "[AUTOTITLE]({% ifversion ghes or ghae %}/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](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-mercurial-repository)"
### Any Subversion (SVN) repository to {% data variables.product.prodname_dotcom_the_website %}
- **Scope**: Source and history
- **Tooling**: Subversion and Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-subversion-repository)"
### 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](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-team-foundation-version-control-repository)"
### Any Perforce repository to {% data variables.product.prodname_dotcom_the_website %}
- **Scope**: Source and history
- **Tooling**: `git-p4`, then Git CLI
- **More information**:
- [git-p4](https://git-scm.com/docs/git-p4) in the Git documentation
- "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#importing-a-git-repository-with-the-command-line)"
### 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/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github)"
## 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 %}](#githubcom-to-github-enterprise-server)
- [{% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_server %}](#github-enterprise-server-to-github-enterprise-server)
- [Azure DevOps to {% data variables.product.prodname_ghe_server %}](#azure-devops-to-github-enterprise-server)
- [Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_ghe_server %}](#bitbucket-cloud-bitbucketorg-to-github-enterprise-server)
- [Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_ghe_server %}](#bitbucket-server-or-bitbucket-data-center-to-github-enterprise-server)
- [GitLab to {% data variables.product.prodname_ghe_server %}](#gitlab-to-github-enterprise-server)
- [Any Git repository to {% data variables.product.prodname_ghe_server %}](#any-git-repository-to-github-enterprise-server)
- [Any Mercurial repository to {% data variables.product.prodname_ghe_server %}](#any-mercurial-repository-to-github-enterprise-server)
- [Any Subversion (SVN) repository to {% data variables.product.prodname_ghe_server %}](#any-subversion-svn-repository-to-github-enterprise-server)
- [Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_ghe_server %}](#any-team-foundation-version-control-tfvc-repository-to-github-enterprise-server)
- [Any Perforce repository to {% data variables.product.prodname_ghe_server %}](#any-perforce-repository-to-github-enterprise-server)
- [Any other repository to {% data variables.product.prodname_ghe_server %}](#any-other-repository-to-github-enterprise-server)
### {% 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**:
- "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom)"
- "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"
### {% 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**:
- "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server)"
- "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"
### Azure DevOps to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source and history
- **Tooling**: Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
### Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source and history
- **Tooling**: Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
### Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source, history, and metadata
- **Tooling**: `bbs-exporter` (expert-led migrations only), then `ghe-migrator`
- **More information**:
- [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"
- **Caveats**: {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghes %}
### GitLab to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source, history, and metadata
- **Tooling**: `gl-exporter` (expert-led migrations only), then `ghe-migrator`
- **More information**:
- [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"
- **Caveats**: {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghes %}
### Any Git repository to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source and history
- **Tooling**: Git CLI
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
### Any Mercurial repository to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source and history
- **Tooling**: Mercurial, Git CLI, and Python
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-mercurial-repository)"
### Any Subversion (SVN) repository to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source and history
- **Tooling**: Subversion and Git CLI
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-subversion-repository)"
### 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](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-team-foundation-version-control-repository)"
### Any Perforce repository to {% data variables.product.prodname_ghe_server %}
- **Scope**: Source and history
- **Tooling**: `git-p4`, then Git CLI
- **More information**:
- [git-p4](https://git-scm.com/docs/git-p4) in the Git documentation
- "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#importing-a-git-repository-with-the-command-line)"
### 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](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github)"

Просмотреть файл

@ -141,88 +141,7 @@ To learn more about expert-led migrations, contact your account representative o
## Deciding what tools to use
Next, determine the best migration tooling for your desired migration fidelity.
### Source, history, and metadata migrations
For some migration paths, we offer specialist tools that allow you to migrate source, history, and metadata. The appropriate tool depends on your migration path.
<table>
<tr>
<th></th>
<th scope="colgroup" colspan="2" style="text-align: center"><b>Destination</b></th>
</tr>
<tr>
<th scope="col"><b>Origin</b></th>
<th scope="col"><b>{% data variables.product.prodname_dotcom_the_website %}, including {% data variables.product.prodname_ghe_cloud %}</b></th>
<th scope="col"><b>{% data variables.product.prodname_ghe_server %}</b></th>
</tr>
<tr>
<th scope="row"><b>Azure DevOps (Cloud only)</b></th>
<td>{% data variables.product.prodname_importer_proper_name %}</td>
<td>None</td>
</tr>
<tr>
<th scope="row"><b>Bitbucket Server</b></th>
<td><ul><li><code>bbs-exporter</code> (expert-led migrations only)</li><li>{% data variables.product.prodname_importer_proper_name %} (public beta)</li></ul></td>
<td><code>bbs-exporter</code> (expert-led migrations only)</td>
</tr>
<tr>
<th scope="row"><b>GitLab (self-managed or SaaS)</b></th>
<td><code>gl-exporter</code> (expert-led migrations only)</td>
<td><code>gl-exporter</code> (expert-led migrations only)</td>
</tr>
<tr>
<th scope="row"><b>{% data variables.product.prodname_dotcom_the_website %}, including {% data variables.product.prodname_ghe_cloud %}</b></th>
<td><ul><li>{% data variables.product.prodname_importer_proper_name %}</li><li>Enterprise Cloud Importer (expert-led migrations only)</li></ul></td>
<td>ghe-migrator</td>
</tr>
<tr>
<th scope="row"><b>{% data variables.product.prodname_ghe_server %}</b></th>
<td><ul><li>{% data variables.product.prodname_importer_proper_name %}</li><li>Enterprise Cloud Importer (expert-led migrations only)</li></ul></td>
<td>ghe-migrator</td>
</tr>
</table>
{% data reusables.enterprise-migration-tool.bbs-release-phase %}
If your migration path is not included in the table, then we dont offer any specialist tools to migrate source, history and metadata. As an alternative, you could run a "source snapshot" or "source and history" migration.
You can learn more about each tool and its use, review the tool's documentation or contact your expert:
- "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
- "[AUTOTITLE]({% ifversion ghae %}/enterprise-server@latest{% endif %}/migrations/using-ghe-migrator)"
- For tools that are only available with expert-led migrations, contact your account representative or [Expert Services](https://github.com/services/).
### Limitations of specialist tools
Each of our specialist tools has different limitations to consider.
Pay particular attention to restrictions on the repository size. If you need to migrate large repositories, you may need to use a different tool than the one we normally recommend for your migration path.
{% rowheaders %}
| | Tooling available with expert-led migrations | {% data variables.product.prodname_importer_proper_name %} | ghe-migrator |
|---|---|---|---|
Supported sources | <ul><li>Bitbucket Server</li><li>GitLab (self-managed and SaaS)</li></ul> | <ul><li>Azure DevOps</li><li>Bitbucket Server (private beta)</li><li>{% data variables.product.company_short %} products (all)</li></ul> | <ul><li>{% data variables.product.prodname_ghe_cloud %}</li><li>{% data variables.product.prodname_ghe_server %}</li></ul>
Supported targets | {% data variables.product.company_short %} products (all) | {% data variables.product.prodname_dotcom_the_website %}, including {% data variables.product.prodname_ghe_cloud %} | {% data variables.product.prodname_ghe_server %} |
Availability | Only when working with Expert Services or a {% data variables.product.prodname_dotcom %} Partner | Open to all | Open to all
Support | Provided by your Expert Services team member or {% data variables.product.prodname_dotcom %} Partner | Open to all | Open to all
Repository size | < 30GB |< 10GB | Unlimited, but subject to your servers resources
Data migrated | <ul><li>For Bitbucket, see the [`bbs-exporter`](https://github.github.com/enterprise-migrations/#/./2.2.3.0-export-from-bitbucket-features) documentation</li><li>For GitLab, see the [`gl-exporter`](https://github.github.com/enterprise-migrations/#/./2.2.2.0-export-from-gitlab-features) documentation</li><li>For {% data variables.product.product_name %}, see "[AUTOTITLE]({% ifversion ghae %}/enterprise-server@latest{% endif %}/migrations/using-ghe-migrator/about-ghe-migrator#migrated-data)"</li></ul> | See "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migration-support-for-github-enterprise-importer)" | See "[AUTOTITLE]({% ifversion ghae %}/enterprise-server@latest{% endif %}/migrations/using-ghe-migrator/about-ghe-migrator#migrated-data)"
{% endrowheaders %}
### Source code and history migrations
If your migration path isnt listed above, then you wont be able to complete a source, history, and metadata migration. Instead, youll be limited to a source snapshot migration or a source and history migration.
- If your repository is hosted on a code hosting service using Git, Subversion (SVN), Mercurial, or Team Foundation Version Control (TFVC/TFS) and is accessible from the public internet, you can use {% data variables.product.company_short %}-provided tools to migrate your source and history.
- If you're migrating to {% data variables.product.prodname_dotcom_the_website %}, use {% data variables.product.prodname_dotcom %} Importer. For more information, see "[AUTOTITLE]({% ifversion ghes or ghae %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer)."
- If you're migrating to {% data variables.product.prodname_ghe_server %}, use the administrative shell. For more information, see "[AUTOTITLE]({% ifversion not ghes %}/enterprise-server@latest{% endif %}/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-from-other-version-control-systems-with-the-administrative-shell)."
- If your repository uses SVN for version control and is not accessible from the public internet, you can use the `git svn` command to convert your repository to Git, then push the repository to {% data variables.product.prodname_dotcom %}. For more information, see [Migrating to Git](https://git-scm.com/book/en/v2/Git-and-Other-Systems-Migrating-to-Git) in the "Pro Git" book.
- If your repository uses Mercurial for version control and is not accessible from the public internet, you can use `hg-fast-export` to convert your repository to Git, then push the repository to {% data variables.product.prodname_dotcom %}. For more information, see [Migrating to Git](https://git-scm.com/book/en/v2/Git-and-Other-Systems-Migrating-to-Git) in the "Pro Git" book.
- If your repository uses Team Foundation Version Control (TFVC) for version control and is not accessible from the public internet, you can use `git-tfs` to convert your repository to Git, then push the repository to {% data variables.product.prodname_dotcom %}. For more information, see the [git-tfs/git-tfs](https://github.com/git-tfs/git-tfs) repository.
{% data reusables.migrations.about-migration-paths %} For more information, see "[AUTOTITLE](/migrations/overview/migration-paths-to-github)."
## Designing your organization structure for the migration destination

Просмотреть файл

@ -0,0 +1 @@
To plan for your migration, consider the destination and source. These considerations determine the path for your migration.

Просмотреть файл

@ -1 +1 @@
If youre moving between {% data variables.product.company_short %} products, such as from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}, or from another code hosting platform, such as Bitbucket Server or GitLab, to {% data variables.product.company_short %}, youll want to bring your work with you: your code, the code's history, and all of your past conversations and collaboration.
If you're moving between {% data variables.product.company_short %} products, such as from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}, or from another code hosting platform, such as Bitbucket Server or GitLab, to {% data variables.product.company_short %}, you'll want to bring your work with you: your code, the code's history, and all of your past conversations and collaboration.

Просмотреть файл

@ -0,0 +1 @@
For complex repositories larger than around 5 GB, you may need to use `ghe-migrator` and Enterprise Cloud Importer instead. Enterprise Cloud Importer is only available for expert-led migrations.

Просмотреть файл

@ -0,0 +1 @@
If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see "[Any Git repository to {% data variables.product.prodname_ghe_server %}](#any-git-repository-to-github-enterprise-server)."

Просмотреть файл

@ -0,0 +1 @@
If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see "[Migrations from any Git repository to {% data variables.product.prodname_dotcom_the_website %}](#any-git-repository-to-githubcom)."

Просмотреть файл

@ -60,6 +60,9 @@ prodname_student_leader_program_singular: 'GitHub Campus Expert'
prodname_octernships: 'GitHub Octernships'
prodname_octernship_singular: 'GitHub Octernship'
# GitHub Expert Services
prodname_expert_services: 'GitHub Expert Services'
# GitHub CLI
prodname_cli: 'GitHub CLI'