Commit 0b4ef7f1 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Copyedit documentation for gitlab:packages:migrate task

parent dae75d5e
...@@ -7,14 +7,14 @@ in GitLab 11.3. To learn how to use ...@@ -7,14 +7,14 @@ in GitLab 11.3. To learn how to use
When the GitLab Maven Repository is enabled, every project in GitLab will have When the GitLab Maven Repository is enabled, every project in GitLab will have
its own space to store [Maven](https://maven.apache.org/) packages. its own space to store [Maven](https://maven.apache.org/) packages.
To learn how to use it, see the [user documentation](../user/project/packages/maven.md). To learn how to use it, see the [user documentation](../user/project/packages/maven_repository.md).
## Enabling the Maven Repository ## Enabling the Maven Repository
NOTE: **Note:** NOTE: **Note:**
Once enabled, newly created projects will have the Packages feature enabled by Once enabled, newly created projects will have the Packages feature enabled by
default. Existing projects will need to default. Existing projects will need to
[explicitly enabled it](../user/project/packages/maven.md#enabling-the-packages-repository). [explicitly enabled it](../user/project/packages/maven_repository.md#enabling-the-packages-repository).
To enable the Maven repository: To enable the Maven repository:
...@@ -146,5 +146,23 @@ upload the maven packages: ...@@ -146,5 +146,23 @@ upload the maven packages:
1. [Restart GitLab] for the changes to take effect. 1. [Restart GitLab] for the changes to take effect.
### Migrating local packages to object storage
After [configuring the object storage](#using-object-storage), you may use the
following task to migrate existing packages from the local storage to the remote one.
The processing will be done in a background worker and requires **no downtime**.
For Omnibus GitLab:
```sh
sudo gitlab-rake "gitlab:packages:migrate"
```
For installations from source:
```bash
RAILS_ENV=production sudo -u git -H bundle exec rake gitlab:packages:migrate
```
[reconfigure gitlab]: restart_gitlab.md#omnibus-gitlab-reconfigure "How to reconfigure Omnibus GitLab" [reconfigure gitlab]: restart_gitlab.md#omnibus-gitlab-reconfigure "How to reconfigure Omnibus GitLab"
[restart gitlab]: restart_gitlab.md#omnibus-gitlab-reconfigure "How to reconfigure Omnibus GitLab" [restart gitlab]: restart_gitlab.md#omnibus-gitlab-reconfigure "How to reconfigure Omnibus GitLab"
# Packages Migrate Rake Task
## Migrate to Object Storage
After [configuring the object storage](../../maven_repository.md#using-object-storage) for GitLab's packages, you may use this task to migrate existing packages from the local storage to the remote storage.
>**Note:**
All of the processing will be done in a background worker and requires **no downtime**.
### All-in-one rake task
GitLab provides a rake task that migrates all uploaded packages to object storage.
**Omnibus Installation**
```bash
gitlab-rake "gitlab:packages:migrate"
```
**Source Installation**
```bash
sudo RAILS_ENV=production -u git -H bundle exec rake gitlab:packages:migrate
```
...@@ -15,4 +15,3 @@ comments: false ...@@ -15,4 +15,3 @@ comments: false
- [Import](import.md) of git repositories in bulk - [Import](import.md) of git repositories in bulk
- [Rebuild authorized_keys file](http://docs.gitlab.com/ce/raketasks/maintenance.html#rebuild-authorized_keys-file) task for administrators - [Rebuild authorized_keys file](http://docs.gitlab.com/ce/raketasks/maintenance.html#rebuild-authorized_keys-file) task for administrators
- [Migrate Uploads](../administration/raketasks/uploads/migrate.md) - [Migrate Uploads](../administration/raketasks/uploads/migrate.md)
- [Migrate Packages](../administration/raketasks/packages/migrate.md)
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment