From 9ee145967dea51011a58a11691408dd88d5d6617 Mon Sep 17 00:00:00 2001 From: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Date: Wed, 13 Dec 2023 10:09:06 +0000 Subject: [PATCH] [GEI 1a] Create path-specific map topics in GitHub Enterprise Importer docs (#47406) --- content/migrations/index.md | 5 +++-- .../planning-your-migration-to-github.md | 4 ++-- .../using-github-enterprise-importer/index.md | 5 +++-- .../index.md | 15 ++++++++++++++ ...om-githubcom-to-github-enterprise-cloud.md | 4 +++- ...prise-server-to-github-enterprise-cloud.md | 3 ++- ...om-githubcom-to-github-enterprise-cloud.md | 3 ++- ...of-a-migration-between-github-products.md} | 7 ++++--- .../index.md | 13 ++++++++++++ ...azure-devops-to-github-enterprise-cloud.md | 3 ++- ...zure-devops-to-github-enterprise-cloud.md} | 9 +++++---- .../index.md | 13 ++++++++++++ ...ucket-server-to-github-enterprise-cloud.md | 3 ++- ...cket-server-to-github-enterprise-cloud.md} | 9 +++++---- .../index.md | 13 ------------ .../index.md | 20 ------------------- .../about-github-enterprise-importer.md | 7 ++++--- .../index.md | 4 +--- ...-support-for-github-enterprise-importer.md | 8 ++++---- 19 files changed, 83 insertions(+), 65 deletions(-) create mode 100644 content/migrations/using-github-enterprise-importer/migrating-between-github-products/index.md rename content/migrations/using-github-enterprise-importer/{migrating-organizations-with-github-enterprise-importer => migrating-between-github-products}/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md (96%) rename content/migrations/using-github-enterprise-importer/{migrating-repositories-with-github-enterprise-importer => migrating-between-github-products}/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md (99%) rename content/migrations/using-github-enterprise-importer/{migrating-repositories-with-github-enterprise-importer => migrating-between-github-products}/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md (96%) rename content/migrations/using-github-enterprise-importer/{understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer.md => migrating-between-github-products/overview-of-a-migration-between-github-products.md} (98%) create mode 100644 content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/index.md rename content/migrations/using-github-enterprise-importer/{migrating-repositories-with-github-enterprise-importer => migrating-from-azure-devops-to-github-enterprise-cloud}/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md (97%) rename content/migrations/using-github-enterprise-importer/{understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer.md => migrating-from-azure-devops-to-github-enterprise-cloud/overview-of-a-migration-from-azure-devops-to-github-enterprise-cloud.md} (95%) create mode 100644 content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/index.md rename content/migrations/using-github-enterprise-importer/{migrating-repositories-with-github-enterprise-importer => migrating-from-bitbucket-server-to-github-enterprise-cloud}/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md (98%) rename content/migrations/using-github-enterprise-importer/{understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer.md => migrating-from-bitbucket-server-to-github-enterprise-cloud/overview-of-a-migration-from-bitbucket-server-to-github-enterprise-cloud.md} (94%) delete mode 100644 content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/index.md delete mode 100644 content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/index.md diff --git a/content/migrations/index.md b/content/migrations/index.md index 9b9f70ecb998..8b0259699a82 100644 --- a/content/migrations/index.md +++ b/content/migrations/index.md @@ -1,7 +1,7 @@ --- title: Migrations documentation shortTitle: Migrations -intro: "If you're moving to {% data variables.product.prodname_dotcom %} from another code hosting platform or moving between {% data variables.product.prodname_dotcom %} products, learn how to use our migration tooling to bring your work with you." +intro: 'If you''re moving to {% data variables.product.prodname_dotcom %} from another code hosting platform or moving between {% data variables.product.prodname_dotcom %} products, learn how to use our migration tooling to bring your work with you.' introLinks: overview: /migrations/overview/about-githubs-migration-tooling plan_your_migration: /migrations/overview/planning-your-migration-to-github @@ -13,7 +13,7 @@ featuredLinks: popular: - /migrations/importing-source-code/using-github-importer/importing-a-repository-with-github-importer - /migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github - - /migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud guideCards: - /migrations/using-github-enterprise-importer/preparing-to-migrate-with-github-enterprise-importer/managing-access-for-github-enterprise-importer - /migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/reclaiming-mannequins-for-github-enterprise-importer @@ -36,3 +36,4 @@ children: - /using-github-enterprise-importer - /using-ghe-migrator --- + diff --git a/content/migrations/overview/planning-your-migration-to-github.md b/content/migrations/overview/planning-your-migration-to-github.md index 18d861aec0ef..e0caacec3e97 100644 --- a/content/migrations/overview/planning-your-migration-to-github.md +++ b/content/migrations/overview/planning-your-migration-to-github.md @@ -64,9 +64,9 @@ If you’re migrating from {% data variables.product.prodname_ghe_cloud %} or {% {% endnote %} -If you’re migrating from Azure DevOps, we recommend the `inventory-report` command in the {% data variables.product.prodname_ado2gh_cli %}. The `inventory-report` command will connect with the Azure DevOps API, then build a simple CSV with some of the fields suggested above. For more information about how to install the {% data variables.product.prodname_ado2gh_cli %}, see "[AUTOTITLE]({% ifversion ghae %}/enterprise-cloud@latest{% endif %}/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud)." +If you’re migrating from Azure DevOps, we recommend the `inventory-report` command in the {% data variables.product.prodname_ado2gh_cli %}. The `inventory-report` command will connect with the Azure DevOps API, then build a simple CSV with some of the fields suggested above. For more information about how to install the {% data variables.product.prodname_ado2gh_cli %}, see "[AUTOTITLE]({% ifversion ghae %}/enterprise-cloud@latest{% endif %}/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/migrating-repositories-from-azure-devops-to-github-enterprise-cloud)." -If you’re migrating from Bitbucket Server or Bitbucket Data Center, we recommend the `inventory-report` command in the {% data variables.product.prodname_bbs2gh_cli %}. The `inventory-report` command will use your Bitbucket instance's API to build a simple CSV. For more information about how to install the {% data variables.product.prodname_bbs2gh_cli %}, see "[AUTOTITLE]({% ifversion ghae %}/enterprise-cloud@latest{% endif %}/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud)." +If you’re migrating from Bitbucket Server or Bitbucket Data Center, we recommend the `inventory-report` command in the {% data variables.product.prodname_bbs2gh_cli %}. The `inventory-report` command will use your Bitbucket instance's API to build a simple CSV. For more information about how to install the {% data variables.product.prodname_bbs2gh_cli %}, see "[AUTOTITLE]({% ifversion ghae %}/enterprise-cloud@latest{% endif %}/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud)." For other migration origins, create your migration inventory yourself. You could build the spreadsheet using the origin’s reporting tools, if available, or API, or you could create the inventory manually. diff --git a/content/migrations/using-github-enterprise-importer/index.md b/content/migrations/using-github-enterprise-importer/index.md index bf42ac4402ce..03fcb3a94950 100644 --- a/content/migrations/using-github-enterprise-importer/index.md +++ b/content/migrations/using-github-enterprise-importer/index.md @@ -9,8 +9,9 @@ versions: children: - /understanding-github-enterprise-importer - /preparing-to-migrate-with-github-enterprise-importer - - /migrating-organizations-with-github-enterprise-importer - - /migrating-repositories-with-github-enterprise-importer + - /migrating-from-azure-devops-to-github-enterprise-cloud + - /migrating-from-bitbucket-server-to-github-enterprise-cloud + - /migrating-between-github-products - /completing-your-migration-with-github-enterprise-importer redirect_from: - /early-access/github/migrating-with-github-enterprise-importer diff --git a/content/migrations/using-github-enterprise-importer/migrating-between-github-products/index.md b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/index.md new file mode 100644 index 000000000000..aef20ff510ee --- /dev/null +++ b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/index.md @@ -0,0 +1,15 @@ +--- +title: Migrating between GitHub products +shortTitle: Migrate between GitHub products +intro: 'With {% data variables.product.prodname_importer_proper_name %}, you can migrate from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}, or migrate between accounts on {% data variables.product.prodname_ghe_cloud %}.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - /overview-of-a-migration-between-github-products + - /migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud + - /migrating-repositories-from-githubcom-to-github-enterprise-cloud + - /migrating-organizations-from-githubcom-to-github-enterprise-cloud +--- + diff --git a/content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md similarity index 96% rename from content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md rename to content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md index 45063f222eaf..0302ee6ddc9a 100644 --- a/content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md +++ b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-organizations-from-githubcom-to-github-enterprise-cloud.md @@ -1,6 +1,6 @@ --- title: Migrating organizations from GitHub.com to GitHub Enterprise Cloud -shortTitle: GitHub.com to Enterprise Cloud +shortTitle: Migrate organizations on GitHub.com intro: 'You can migrate organizations from {% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_ghe_cloud %}, using the {% data variables.product.prodname_cli %} or the GraphQL API.' versions: fpt: '*' @@ -9,6 +9,8 @@ versions: defaultTool: cli redirect_from: - /early-access/enterprise-importer/migrating-organizations-with-github-enterprise-importer/migrating-organizations-from-githubcom-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/migrating-organizations-from-githubcom-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer --- ## About organization migrations with {% data variables.product.prodname_importer_proper_name %} diff --git a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md similarity index 99% rename from content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md rename to content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md index d6efd6c0a9f6..2f6e8b5b44e7 100644 --- a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md +++ b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud.md @@ -1,6 +1,6 @@ --- title: Migrating repositories from GitHub Enterprise Server to GitHub Enterprise Cloud -shortTitle: Enterprise Server to Enterprise Cloud +shortTitle: Migrate from Enterprise Server intro: 'You can migrate repositories from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}, using the {% data variables.product.prodname_cli %} or API.' versions: fpt: '*' @@ -10,6 +10,7 @@ defaultTool: cli redirect_from: - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-to-github-enterprise-cloud/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud --- ## About repository migrations with {% data variables.product.prodname_importer_proper_name %} diff --git a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md similarity index 96% rename from content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md rename to content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md index 138ea23d9a9b..d4fda4e1a3cc 100644 --- a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md +++ b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/migrating-repositories-from-githubcom-to-github-enterprise-cloud.md @@ -1,6 +1,6 @@ --- title: Migrating repositories from GitHub.com to GitHub Enterprise Cloud -shortTitle: GitHub.com to Enterprise Cloud +shortTitle: Migrate repositories on GitHub.com intro: 'You can migrate repositories from {% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_ghe_cloud %}, using the {% data variables.product.prodname_cli %} or the GraphQL API.' versions: fpt: '*' @@ -10,6 +10,7 @@ defaultTool: cli redirect_from: - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-to-github-enterprise-cloud/migrating-repositories-from-githubcom-to-github-enterprise-cloud - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-githubcom-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-githubcom-to-github-enterprise-cloud --- ## About repository migrations with {% data variables.product.prodname_importer_proper_name %} diff --git a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer.md b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products.md similarity index 98% rename from content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer.md rename to content/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products.md index 7b076f5776b3..507248e8dfc6 100644 --- a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer.md +++ b/content/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products.md @@ -1,7 +1,7 @@ --- -title: Migrating between GitHub products with GitHub Enterprise Importer -shortTitle: Migrate between GitHub products -intro: 'Learn how to complete the entire process of migrating from one {% data variables.product.company_short %} product to another, from planning to implementation to completing follow-up tasks.' +title: Overview of a migration between GitHub products +shortTitle: Overview +intro: 'Learn how to complete the entire process of migrating from one {% data variables.product.company_short %} product to another with {% data variables.product.prodname_importer_proper_name %}, from planning to implementation to completing follow-up tasks.' versions: fpt: '*' ghes: '*' @@ -9,6 +9,7 @@ versions: redirect_from: - /early-access/github/migrating-with-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer - /early-access/enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer + - /migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer --- ## About migrations between {% data variables.product.company_short %} products diff --git a/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/index.md b/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/index.md new file mode 100644 index 000000000000..5ce83495577c --- /dev/null +++ b/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/index.md @@ -0,0 +1,13 @@ +--- +title: Migrating from Azure DevOps to GitHub Enterprise Cloud +shortTitle: Migrate from Azure DevOps +intro: 'You can migrate repositories to {% data variables.product.prodname_dotcom %} with {% data variables.product.prodname_importer_proper_name %}.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - /overview-of-a-migration-from-azure-devops-to-github-enterprise-cloud + - /migrating-repositories-from-azure-devops-to-github-enterprise-cloud +--- + diff --git a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md b/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md similarity index 97% rename from content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md rename to content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md index 733448bd0b7d..04110deb59f0 100644 --- a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md +++ b/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/migrating-repositories-from-azure-devops-to-github-enterprise-cloud.md @@ -1,6 +1,6 @@ --- title: Migrating repositories from Azure DevOps to GitHub Enterprise Cloud -shortTitle: ADO to Enterprise Cloud +shortTitle: Migrate repositories intro: 'You can migrate repositories from Azure DevOps to {% data variables.product.prodname_ghe_cloud %}, using the {% data variables.product.prodname_cli %} or the GraphQL API.' versions: fpt: '*' @@ -10,6 +10,7 @@ defaultTool: cli redirect_from: - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-to-github-enterprise-cloud/migrating-repositories-from-azure-devops-to-github-enterprise-cloud - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud --- ## About repository migrations with {% data variables.product.prodname_importer_proper_name %} diff --git a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer.md b/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/overview-of-a-migration-from-azure-devops-to-github-enterprise-cloud.md similarity index 95% rename from content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer.md rename to content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/overview-of-a-migration-from-azure-devops-to-github-enterprise-cloud.md index b946302e2810..54c4aa6aa984 100644 --- a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer.md +++ b/content/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/overview-of-a-migration-from-azure-devops-to-github-enterprise-cloud.md @@ -1,7 +1,7 @@ --- -title: Migrating from Azure DevOps with GitHub Enterprise Importer -shortTitle: Migrate from Azure DevOps -intro: 'Learn how to complete the entire process of migrating from Azure DevOps to {% data variables.product.prodname_dotcom %}, from planning to implementation to completing follow-up tasks.' +title: Overview of a migration from Azure DevOps to GitHub Enterprise Cloud +shortTitle: Overview +intro: 'Learn how to complete the entire process of migrating from Azure DevOps to {% data variables.product.prodname_dotcom %} with {% data variables.product.prodname_importer_proper_name %}, from planning to implementation to completing follow-up tasks.' versions: fpt: '*' ghes: '*' @@ -9,6 +9,7 @@ versions: redirect_from: - /early-access/github/migrating-with-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer - /early-access/enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer + - /migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer --- ## About migrations from Azure DevOps @@ -96,7 +97,7 @@ We recommend creating a test organization to use as a destination for your trial 1. Create a test organization for your trial migrations. {% data reusables.enterprise-migration-tool.trial-migrations-tasks %} {% data reusables.enterprise-migration-tool.configure-destination-ip-allow-list %} -1. Run your production migrations. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-azure-devops-to-github-enterprise-cloud)." +1. Run your production migrations. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/migrating-repositories-from-azure-devops-to-github-enterprise-cloud)." {% data reusables.enterprise-migration-tool.delete-test-organization %} ## Completing follow-up tasks diff --git a/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/index.md b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/index.md new file mode 100644 index 000000000000..e9646fce7f73 --- /dev/null +++ b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/index.md @@ -0,0 +1,13 @@ +--- +title: Migrating from Bitbucket Server to GitHub Enterprise Cloud +shortTitle: Migrate from Bitbucket Server +intro: 'You can migrate repositories to {% data variables.product.prodname_dotcom %} with {% data variables.product.prodname_importer_proper_name %}.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - /overview-of-a-migration-from-bitbucket-server-to-github-enterprise-cloud + - /migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud +--- + diff --git a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md similarity index 98% rename from content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md rename to content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md index 8babd36e92ff..f06be3171010 100644 --- a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md +++ b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud.md @@ -1,6 +1,6 @@ --- title: Migrating repositories from Bitbucket Server to GitHub Enterprise Cloud -shortTitle: Bitbucket Server to Enterprise Cloud +shortTitle: Migrate repositories intro: 'You can migrate repositories from Bitbucket Server to {% data variables.product.prodname_ghe_cloud %} using the {% data variables.product.prodname_cli %}.' versions: fpt: '*' @@ -9,6 +9,7 @@ versions: defaultTool: cli redirect_from: - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud + - /migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud --- ## About repository migrations with {% data variables.product.prodname_importer_proper_name %} diff --git a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer.md b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/overview-of-a-migration-from-bitbucket-server-to-github-enterprise-cloud.md similarity index 94% rename from content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer.md rename to content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/overview-of-a-migration-from-bitbucket-server-to-github-enterprise-cloud.md index ab9505c83373..fd55d56052b4 100644 --- a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer.md +++ b/content/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/overview-of-a-migration-from-bitbucket-server-to-github-enterprise-cloud.md @@ -1,13 +1,14 @@ --- -title: Migrating from Bitbucket Server with GitHub Enterprise Importer -shortTitle: Migrate from Bitbucket Server -intro: 'Learn about the process of migrating from Bitbucket Server to {% data variables.product.prodname_dotcom %}, from planning to implementation to completing follow-up tasks.' +title: Overview of a migration from Bitbucket Server to GitHub Enterprise Cloud +shortTitle: Overview +intro: 'Learn about the process of migrating from Bitbucket Server to {% data variables.product.prodname_dotcom %} with {% data variables.product.prodname_importer_proper_name %}, from planning to implementation to completing follow-up tasks.' versions: fpt: '*' ghes: '*' ghec: '*' redirect_from: - /early-access/enterprise-importer/understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer + - /migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer --- ## About migrations from Bitbucket Server @@ -89,7 +90,7 @@ We recommend creating a test organization to use as a destination for your trial 1. Create a test organization for your trial migrations. {% data reusables.enterprise-migration-tool.trial-migrations-tasks %} {% data reusables.enterprise-migration-tool.configure-destination-ip-allow-list %} -1. Run your production migrations. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud)." +1. Run your production migrations. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud)." {% data reusables.enterprise-migration-tool.delete-test-organization %} ## Completing follow-up tasks diff --git a/content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/index.md b/content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/index.md deleted file mode 100644 index b72b23ced9f1..000000000000 --- a/content/migrations/using-github-enterprise-importer/migrating-organizations-with-github-enterprise-importer/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Migrating organizations with GitHub Enterprise Importer -shortTitle: Migrate organizations -intro: 'You can migrate organizations to {% data variables.product.prodname_dotcom %} with {% data variables.product.prodname_importer_proper_name %}.' -versions: - fpt: '*' - ghes: '*' - ghec: '*' -children: - - /migrating-organizations-from-githubcom-to-github-enterprise-cloud -redirect_from: - - /early-access/enterprise-importer/migrating-organizations-with-github-enterprise-importer ---- diff --git a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/index.md b/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/index.md deleted file mode 100644 index 62fedaba82b7..000000000000 --- a/content/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Migrating repositories with GitHub Enterprise Importer -shortTitle: Migrate repositories -intro: 'You can migrate repositories to {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_importer_proper_name %}.' -versions: - fpt: '*' - ghes: '*' - ghec: '*' -children: - - /migrating-repositories-from-azure-devops-to-github-enterprise-cloud - - /migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud - - /migrating-repositories-from-githubcom-to-github-enterprise-cloud - - /migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud -redirect_from: - - /early-access/github/migrating-with-github-enterprise-importer/running-a-migration-with-github-enterprise-importer - - /early-access/github/migrating-with-github-enterprise-importer/migrating-to-github-enterprise-cloud-with-the-importer - - /early-access/github/migrating-with-github-enterprise-importer/running-a-migration-with-github-enterprise-importer/running-a-migration-to-github-enterprise-cloud - - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-to-github-enterprise-cloud - - /early-access/enterprise-importer/migrating-repositories-with-github-enterprise-importer ---- diff --git a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer.md b/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer.md index 2ef6c1db7112..9608e503e533 100644 --- a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer.md +++ b/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer.md @@ -9,6 +9,7 @@ redirect_from: - /early-access/github/migrating-with-github-enterprise-importer/about-github-enterprise-importer - /early-access/github/migrating-with-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer - /early-access/enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer + - /migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer --- ## About {% data variables.product.prodname_importer_proper_name %} @@ -36,6 +37,6 @@ For more information about which data is migrated for each source, see "[AUTOTIT To get started with {% data variables.product.prodname_importer_proper_name %}, read the guide for your migration source. Each guide includes all the information you need to plan and implement a migration from that source, as well as follow-up tasks to complete after your migration. -- "[AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-azure-devops-with-github-enterprise-importer)" -- "[AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-from-bitbucket-server-with-github-enterprise-importer)" -- "[AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer)" +- "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-from-azure-devops-to-github-enterprise-cloud/overview-of-a-migration-from-azure-devops-to-github-enterprise-cloud)" +- "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/overview-of-a-migration-from-bitbucket-server-to-github-enterprise-cloud)" +- "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products)" diff --git a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/index.md b/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/index.md index e2a924f07383..8d9f6ed0f42d 100644 --- a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/index.md +++ b/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/index.md @@ -9,10 +9,8 @@ versions: children: - /about-github-enterprise-importer - /migration-support-for-github-enterprise-importer - - /migrating-between-github-products-with-github-enterprise-importer - - /migrating-from-azure-devops-with-github-enterprise-importer - - /migrating-from-bitbucket-server-with-github-enterprise-importer redirect_from: - /early-access/github/migrating-with-github-enterprise-importer/understanding-github-enterprise-importer - /early-access/enterprise-importer/understanding-github-enterprise-importer --- + diff --git a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migration-support-for-github-enterprise-importer.md b/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migration-support-for-github-enterprise-importer.md index b492a8512797..8701f54c7517 100644 --- a/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migration-support-for-github-enterprise-importer.md +++ b/content/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migration-support-for-github-enterprise-importer.md @@ -64,12 +64,12 @@ When you migrate an organization, a new organization is created within the desti - Repositories - Team access to repositories - Member privileges -- Organization-level webhooks (must be re-enabled after your migration, see "[Enabling webhooks](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer#enabling-webhooks)") +- Organization-level webhooks (must be re-enabled after your migration, see "[Enabling webhooks](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#enabling-webhooks)") - Default branch name for new repositories created in the organization All repositories are migrated with private visibility. If you want to set a repository's visibility to public or internal, you can do this after the migration using the UI or API. -Team membership is **not** migrated. After the migration, you'll need to add members to migrated teams. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer#recreating-teams)." +Team membership is **not** migrated. After the migration, you'll need to add members to migrated teams. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#recreating-teams)." {% note %} @@ -87,7 +87,7 @@ When you migrate a repository, either directly or as part of an organization mig - Projects (classic) at the repository level - {% data variables.product.prodname_actions %} workflows - Commit comments -- Active webhooks (must be re-enabled after your migration, see "[Enabling webhooks](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer#enabling-webhooks)") +- Active webhooks (must be re-enabled after your migration, see "[Enabling webhooks](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#enabling-webhooks)") - Repository topics - Repository settings - Branch protections (see "[Branch protections](#branch-protections)" for more details) @@ -175,6 +175,6 @@ There are limits to what {% data variables.product.prodname_importer_proper_name - **10 GB size limit for a Git repository:** This limit only applies to the source code. To inspect the size of your repository, use the [git-sizer](https://github.com/github/git-sizer) tool and check the total size of blobs. - **10 GB limit for metadata**: The {% data variables.product.prodname_importer_secondary_name %} cannot migrate repositories with more than 10 GB of metadata. Metadata includes issues, pull requests, releases, and attachments. In most cases, large metadata is caused by binary assets attached to releases. You can exclude releases from the migration with the `migrate-repo` command's `--skip-releases` flag, and then move your releases manually after the migration. - **{% data variables.large_files.product_name_short %} objects not migrated**: The {% data variables.product.prodname_importer_secondary_name %} can migrate repositories that use {% data variables.large_files.product_name_short %}, 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 "[AUTOTITLE](/repositories/creating-and-managing-repositories/duplicating-a-repository#mirroring-a-repository-that-contains-git-large-file-storage-objects)." -- **Follow-up tasks required:** When migrating between {% data variables.product.prodname_dotcom %} 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 "[AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/migrating-between-github-products-with-github-enterprise-importer#completing-follow-up-tasks)." +- **Follow-up tasks required:** When migrating between {% data variables.product.prodname_dotcom %} 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 "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#completing-follow-up-tasks)." - **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 "[AUTOTITLE](/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets)."