You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: content/migrations/importing-source-code/using-github-importer/about-github-importer.md
+14-16
Original file line number
Diff line number
Diff line change
@@ -1,36 +1,34 @@
1
1
---
2
2
title: About GitHub Importer
3
-
intro: "If your source code is stored on a code hosting service using Git, Subversion, Mercurial, or Team Foundation Version Control (TFVC) and is accessible from the public internet, you can move the code to {% data variables.product.prodname_dotcom %} using {% data variables.product.prodname_importer %}."
3
+
intro: "If your source code is stored on another Git-based hosting service, you can move the code to {% data variables.product.prodname_dotcom %} using {% data variables.product.prodname_importer %}."
## About {% data variables.product.prodname_importer %}
15
20
16
-
{% data variables.product.prodname_importer %} is a tool that quickly imports source code repositories, including commits and revision history, to {% data variables.product.prodname_dotcom_the_website %} for you.
21
+
{% data variables.product.prodname_importer %} is a tool that quickly imports Git repositories from other hosting services to {% data variables.product.prodname_dotcom %}.
17
22
18
-
During an import, depending on the version control system you're importing from, you can authenticate with your remote repository, update commit author attribution, and either import repositories with large files or, if you don't want to use {% data variables.large_files.product_name_long %}, remove large files.
23
+
To get started with {% data variables.product.prodname_importer %}, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/importing-a-repository-with-github-importer#importing-a-repository-with-github-importer)."
19
24
20
-
## Supported functionality by version control system
25
+
## Capabilities and limitations of {% data variables.product.prodname_importer %}
21
26
22
-
{% data reusables.migrations.github-importer-non-git-deprecation %}
| Move large files to [Git Large File Storage](/repositories/working-with-files/managing-large-files/about-git-large-file-storage)| {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} |
31
-
| Remove large files from your repository | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} |
32
-
33
-
{% endrowheaders %}
27
+
- {% data variables.product.prodname_importer %} imports the source code and commit history of a repository. It does not import other associated data from the hosting service, such as issues and pull requests.
28
+
- During an import, you can authenticate with your remote repository. The repository must be accessible from the public internet. If the repository is hosted on a private network, {% data variables.product.prodname_importer %} won't be able to access it.
29
+
- {% data variables.product.prodname_importer %} does not support repositories that use version control systems other than Git, such as Mercurial, Subversion, or Team Foundation Version Control (TFVC). For more information about alternatives to {% data variables.product.prodname_importer %}, see "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/about-source-code-imports-using-the-command-line)."
30
+
- Repositories and individual files on {% data variables.product.prodname_dotcom %} are subject to size limits. For more information, see "[AUTOTITLE](/repositories/working-with-files/managing-large-files/about-large-files-on-github)."
31
+
- {% data variables.product.prodname_importer %} does not move Git Large File Storage (LFS) objects from the source repository to the target repository. If you use Git LFS, you will need to either convert the Git LFS objects to regular files tracked by Git before running the migration, or move the Git LFS objects to the new repository separately after running the migration.
title: Importing a repository with GitHub Importer
3
-
intro: 'If you have a project hosted on another version control system, you can automatically import it to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool.'
3
+
intro: 'If you have a project hosted on another Git-based hosting service, you can quickly import it to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool.'
@@ -15,15 +15,9 @@ shortTitle: Import a repository
15
15
16
16
## About repository imports with {% data variables.product.prodname_importer %}
17
17
18
-
{% data variables.product.prodname_importer %} is not suitable for all imports. For example, if your existing code is hosted on a private network, our tool won't be able to access it. In these cases, we recommend [importing using the command line](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line) for Git repositories or an external [source code migration tool](/migrations/importing-source-code/using-the-command-line-to-import-source-code) for projects imported from other version control systems.
18
+
{% data variables.product.prodname_importer %} imports the source code and commit history of Git repositories hosted on external hosting services. For more information about the capabilities and limitations of {% data variables.product.prodname_importer %}, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer#capabilities-and-limitations-of-github-importer)."
19
19
20
-
{% data reusables.migrations.github-importer-non-git-deprecation %}
21
-
22
-
If you'd like to match the commits in your repository to the authors' {% data variables.product.prodname_dotcom %} personal accounts during the import, make sure every contributor to your repository has a {% data variables.product.prodname_dotcom %} account before you begin the import.
23
-
24
-
{% data reusables.repositories.repo-size-limit %}
25
-
26
-
For more information about migration paths to {% data variables.product.prodname_dotcom %} from other products, or between {% data variables.product.prodname_dotcom %} products, see "[AUTOTITLE](/migrations/overview/migration-paths-to-github)."
20
+
{% data variables.product.product_name %} uses the email address in the commit header to link a commit to a {% data variables.product.prodname_dotcom %} user. To correctly attribute commits in an imported repository, users will need to add the email address associated with their commits to their account on {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account)."
27
21
28
22
## Importing a repository with {% data variables.product.prodname_importer %}
29
23
@@ -33,14 +27,10 @@ When you import a repository using the {% data variables.product.prodname_import
33
27
34
28
35
29
36
-
1. Under "Your old repository's clone URL", type the URL of the project you want to import.
37
-
1. Under "Owner", select the dropdown menu and click your personal account or an organization to own the repository
38
-
1. Under "Name", type a name for the repository on {% data variables.product.prodname_dotcom %}.
39
-
1. Under "Privacy", select a visibility for the repository. For more information, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility)."
40
-
1. Review the information you entered, then click **Begin import**.
41
-
1. If your old project requires credentials, type your login information for that project. If SAML SSO or 2FA are enabled for your user account on the old project, enter a {% data variables.product.pat_generic %} with repository read permissions in the "Password" field instead of your password.
42
-
1. Click **Submit**.
43
-
1. If there are multiple projects hosted at your old project's clone URL, select the project you'd like to import, then click **Submit**.
44
-
1. If you're moving from a version control system other than Git and your project contains files larger than 100 MB, select whether to import the large files using [Git Large File Storage](/repositories/working-with-files/managing-large-files), then click **Continue**.
45
-
46
-
You'll receive an email when the repository has been completely imported.
30
+
1. On the "Import your project to {% data variables.product.prodname_dotcom %}" page, enter the URL for the remote repository hosted on another platform.
31
+
1. If the source repository is private, enter credentials for authentication. {% data variables.product.prodname_importer %} will use the credentials to perform a `git clone` operation on the source repository.
32
+
1. Choose an owner and a name for the new repository on {% data variables.product.prodname_dotcom %}.
33
+
1. Choose the visibility of the new repository. For more information, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)."
34
+
1. Click **Begin import**.
35
+
36
+
You'll be redirected to a "Preparing your new repository" page, where you can track the status of your import. You'll receive an email when the repository has been completely imported.
Copy file name to clipboardexpand all lines: content/migrations/importing-source-code/using-github-importer/updating-commit-author-attribution-with-github-importer.md
Copy file name to clipboardexpand all lines: content/migrations/overview/programmatically-importing-repositories.md
-6
Original file line number
Diff line number
Diff line change
@@ -15,12 +15,6 @@ To learn more about "source and history" and other types of migrations, see "[AU
15
15
16
16
The term "source repository" refers to the repository you're importing, and "imported repository" refers to the new repository you're creating.
17
17
18
-
### About the deprecation of the Source imports REST API
19
-
20
-
The REST API endpoints to manage source imports allowed the programmatic import of a repositories that are accessible over the internet to {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[AUTOTITLE](/rest/migrations/source-imports)."
21
-
22
-
On April 12, 2024, {% data variables.product.company_short %} will deprecate all of the endpoints listed within "[AUTOTITLE](/rest/migrations/source-imports)." If you currently use these operations, you'll need to make changes to your code or your application will stop working on April 12, 2024.
23
-
24
18
## Using forks
25
19
26
20
If the source repository is on {% data variables.product.prodname_dotcom_the_website %}, you may be able to use a fork instead of importing the repository. {% data reusables.repositories.about-forks %} For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)."
Copy file name to clipboardexpand all lines: content/repositories/creating-and-managing-repositories/duplicating-a-repository.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ topics:
17
17
18
18
{% note %}
19
19
20
-
**Note:** If you have a project hosted on another version control system, you can automatically import your project to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer)."
20
+
**Note:** If you have a project hosted on another Git-based hosting service, you can automatically import your project to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer)."
Copy file name to clipboardexpand all lines: content/rest/migrations/source-imports.md
+2-3
Original file line number
Diff line number
Diff line change
@@ -3,8 +3,7 @@ title: REST API endpoints for source imports
3
3
shortTitle: Source endpoints
4
4
allowTitleToDifferFromFilename: true
5
5
intro: >-
6
-
Use the REST API to start an import from a Git, Subversion, Mercurial, or Team
7
-
Foundation Version Control source repository.
6
+
Use the REST API to start an import from a Git source repository.
8
7
versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
9
8
fpt: '*'
10
9
ghec: '*'
@@ -17,7 +16,7 @@ autogenerated: rest
17
16
18
17
{% warning %}
19
18
20
-
**Warning**: Due to very low levels of usage and available alternatives, the Source Imports API is deprecated and will no longer be available from 00:00 UTC on April 12, 2024. For more details and alternatives, see the [changelog](https://gh.io/source-imports-api-deprecation).
19
+
**Warning**: Due to very low levels of usage and available alternatives, the Source Imports API has been deprecated and is no longer available as of April 12, 2024. For more details and alternatives, see the [changelog](https://gh.io/source-imports-api-deprecation).
Copy file name to clipboardexpand all lines: data/variables/migrations.yml
+1-2
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,6 @@ user_migrations_intro: >-
3
3
organization_migrations_intro: >-
4
4
You can use these endpoints to export one or more repositories so you can move them to a{% ifversion ghes %}nother{% endif %} {% data variables.product.prodname_ghe_server %} instance. For more information, see "[AUTOTITLE](/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom)."
5
5
source_imports_intro: >-
6
-
You can use these endpoints to start an import from a Git, Subversion,
7
-
Mercurial, or Team Foundation Version Control source repository. This is the same
6
+
You can use these endpoints to start an import from a Git repository hosted with another service. This is the same
8
7
functionality as the {% data variables.product.prodname_dotcom %}
9
8
Importer. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/importing-a-repository-with-github-importer)."
0 commit comments