Merge branch 'bryan-may-master-patch-53357' into 'master'

Add congregate references to import docs

See merge request gitlab-org/gitlab!73203

doc/api/import.md

@@ -83,3 +83,8 @@ curl --request POST \
     "bitbucket_server_repo": "my-repo"
 }'
 ```
+
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](../user/project/import/index.md#automate-group-and-project-import).

doc/user/group/import/index.md

@@ -130,3 +130,8 @@ Migration importer page. The remote groups you have the Owner role for are liste
 1. After a group has been imported, select its GitLab path to open its GitLab URL.
 
 ![Group Importer page](img/bulk_imports_v14_1.png)
+
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](../../project/import/index.md#automate-group-and-project-import).

doc/user/group/settings/import_export.md

@@ -109,6 +109,11 @@ The Enterprise Edition retains some group data that isn't part of the Community
 
 Your newly imported group page appears after the operation completes.
 
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](../../project/import/index.md#automate-group-and-project-import).
+
 ## Version history
 
 ### 14.0+

doc/user/project/import/bitbucket_server.md

@@ -118,6 +118,11 @@ To import your Bitbucket repositories:
    You can filter projects by name and select the namespace
    each project will be imported for.
 
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](index.md#automate-group-and-project-import).
+
 ## Troubleshooting
 
 If the GUI-based import tool does not work, you can try to:

doc/user/project/import/github.md

@@ -241,3 +241,8 @@ To disable the feature, run this command:
 # Disable
 Feature.disable(:github_importer_lower_per_page_limit, group)
 ```
+
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](index.md#automate-group-and-project-import).

doc/user/project/import/gitlab_com.md

@@ -26,3 +26,8 @@ for permission to access your projects. After accepting, you are automatically r
 
 To import a project, click "Import". The importer imports your repository and issues.
 Once the importer is done, a new GitLab project is created with your imported data.
+
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](index.md#automate-group-and-project-import).

doc/user/project/import/index.md

@@ -102,3 +102,18 @@ After an administrator creates an alias for a project, you can use the alias to
 repository. For example, if an administrator creates the alias `gitlab` for the project
 `https://gitlab.com/gitlab-org/gitlab`, you can clone the project with
 `git clone git@gitlab.com:gitlab.git` instead of `git clone git@gitlab.com:gitlab-org/gitlab.git`.
+
+## Automate group and project import **(PREMIUM)**
+
+The GitLab Professional Services team uses [Congregate](https://gitlab.com/gitlab-org/professional-services-automation/tools/migration/congregate)
+to orchestrate user, group, and project import API calls. With Congregate, you can migrate data to
+GitLab from:
+
+- Other GitLab instances
+- GitHub Enterprise
+- GitHub.com
+- Bitbucket Server
+- Bitbucket Data Center
+
+See the [Quick Start Guide](https://gitlab.com/gitlab-org/professional-services-automation/tools/migration/congregate/-/blob/master/docs/using-congregate.md#quick-start)
+to learn how to use this approach for migrating users, groups, and projects at scale.

doc/user/project/import/repo_by_url.md

@@ -23,3 +23,8 @@ You can import your existing repositories by providing the Git URL:
 <!-- vale gitlab.SubstitutionWarning = YES -->
 
 ![Import project by repository URL](img/import_projects_from_repo_url.png)
+
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](index.md#automate-group-and-project-import).

doc/user/project/settings/import_export.md

@@ -226,6 +226,11 @@ To help avoid abuse, by default, users are rate limited to:
 
 GitLab.com may have [different settings](../../gitlab_com/index.md#importexport) from the defaults.
 
+## Automate group and project import **(PREMIUM)**
+
+For information on automating user, group, and project import API calls, see
+[Automate group and project import](../import/index.md#automate-group-and-project-import).
+
 ## Troubleshooting
 
 ### Project fails to import due to mismatch
@@ -235,7 +240,7 @@ does not match between the exported project, and the project import, the project
 Review [issue 276930](https://gitlab.com/gitlab-org/gitlab/-/issues/276930), and either:
 
 - Ensure shared runners are enabled in both the source and destination projects.
-- Disable shared runners on the parent group when you import the project. 
+- Disable shared runners on the parent group when you import the project.
 
 ### Import workarounds for large repositories