summaryrefslogtreecommitdiff
path: root/data/deprecations/15-8-deprecate-import-bare-repositories-rake-task.yml
diff options
context:
space:
mode:
Diffstat (limited to 'data/deprecations/15-8-deprecate-import-bare-repositories-rake-task.yml')
-rw-r--r--data/deprecations/15-8-deprecate-import-bare-repositories-rake-task.yml28
1 files changed, 28 insertions, 0 deletions
diff --git a/data/deprecations/15-8-deprecate-import-bare-repositories-rake-task.yml b/data/deprecations/15-8-deprecate-import-bare-repositories-rake-task.yml
new file mode 100644
index 00000000000..5619a52ef34
--- /dev/null
+++ b/data/deprecations/15-8-deprecate-import-bare-repositories-rake-task.yml
@@ -0,0 +1,28 @@
+- title: 'Rake task for importing bare repositories'
+ announcement_milestone: '15.8'
+ announcement_date: '2023-01-22'
+ removal_milestone: '16.0'
+ removal_date: '2023-05-22'
+ breaking_change: false
+ body: |
+ The [Rake task for importing bare repositories](https://docs.gitlab.com/ee/raketasks/import.html) `gitlab:import:repos` is deprecated in GitLab 15.8 and will be removed in GitLab 16.0.
+
+ This Rake task imports a directory tree of repositories into a GitLab instance. These repositories must have been
+ managed by GitLab previously, because the Rake task relies on the specific directory structure or a specific custom Git setting in order to work (`gitlab.fullpath`).
+
+ Importing repositories using this Rake task has limitations. The Rake task:
+
+ - Only knows about project and project wiki repositories and doesn't support repositories for designs, group wikis, or snippets.
+ - Permits you to import non-hashed storage projects even though these aren't supported.
+ - Relies on having Git config `gitlab.fullpath` set. [Epic 8953](https://gitlab.com/groups/gitlab-org/-/epics/8953) proposes removing support for this setting.
+
+ Alternatives to using the `gitlab:import:repos` Rake task include:
+
+ - Migrating projects using either [an export file](https://docs.gitlab.com/ee/user/project/settings/import_export.html) or
+ [direct transfer](https://docs.gitlab.com/ee/user/group/import/#migrate-groups-by-direct-transfer-recommended) migrate repositories as well.
+ - Importing a [repository by URL](https://docs.gitlab.com/ee/user/project/import/repo_by_url.html).
+ - Importing a [repositories from a non-GitLab source](https://docs.gitlab.com/ee/user/project/import/).
+ stage: manage
+ tiers:
+ issue_url: https://gitlab.com/gitlab-com/Product/-/issues/5255
+ documentation_url: https://docs.gitlab.com/ee/raketasks/import.html