Upstream/harbor
1
0
Fork 0
mirror of https://github.com/goharbor/harbor.git synced 2024-11-05 18:20:37 +01:00
Code Issues Projects Releases Wiki Activity

Merge pull request #6463 from reasonerjt/update-db-migration-doc

Browse Source 
Refine migration guide for 1.7
This commit is contained in:
Wenkai Yin 2018-12-06 10:19:49 +08:00 committed by GitHub
commit 11f0e10d36
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/migration_guide.md
View File

@ -26,19 +26,23 @@ or above it's not necessary to call the migrator tool to migrate the schema.
``` ```
2. Back up Harbor's current files so that you can roll back to the current version when it is necessary. 2. Back up Harbor's current files so that you can roll back to the current version when it is necessary.
```sh ```
cd ..
mv harbor /my_backup_dir/harbor mv harbor /my_backup_dir/harbor
``` ```
Back up database (by default in diretory `/data/database`)
```
cp -r /data/database /my_backup_dir/
```
3. Get the latest Harbor release package from Github: 3. Get the latest Harbor release package from Github:
https://github.com/goharbor/harbor/releases https://github.com/goharbor/harbor/releases
4. Before upgrading Harbor, perform migration first. The migration tool is delivered as a docker image, so you should pull the image from docker hub. Replace [tag] with the release version of Harbor (e.g. v1.5.0) in the below command: 4. Before upgrading Harbor, perform migration first. The migration tool is delivered as a docker image, so you should pull the image from docker hub. Replace [tag] with the release version of Harbor (e.g. v1.5.0) in the below command:
```
docker pull goharbor/harbor-migrator:[tag]
```
5. Back up database and `harbor.cfg` to a directory such as `/path/to/backup`. You need to create the directory if it does not exist. Also, note that the username and password to access the db are provided via environment variable "DB_USR" and "DB_PWD". 5. Upgrade `harbor.cfg`.
6. Upgrade `harbor.cfg`.
**NOTE:** The ${harbor_cfg} will be overwritten, you must move it to your installation directory after migration. **NOTE:** The ${harbor_cfg} will be overwritten, you must move it to your installation directory after migration.
``` ```
docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:[tag] --cfg up docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:[tag] --cfg up
@ -46,7 +50,7 @@ or above it's not necessary to call the migrator tool to migrate the schema.
**NOTE:** The schema upgrade and data migration of Database is performed by adminserver when Harbor starts, if the migration fails, **NOTE:** The schema upgrade and data migration of Database is performed by adminserver when Harbor starts, if the migration fails,
please check the log of adminserver to debug. please check the log of adminserver to debug.
7. Under the directory `./harbor`, run the `./install.sh` script to install the new Harbor instance. If you choose to install Harbor with components like Notary, Clair, and chartmuseum, refer to [Installation & Configuration Guide](../docs/installation_guide.md) for more information. 6. Under the directory `./harbor`, run the `./install.sh` script to install the new Harbor instance. If you choose to install Harbor with components like Notary, Clair, and chartmuseum, refer to [Installation & Configuration Guide](../docs/installation_guide.md) for more information.
### Roll back from an upgrade ### Roll back from an upgrade
@ -70,9 +74,7 @@ For any reason, if you want to roll back to the previous version of Harbor, foll
mv /my_backup_dir/harbor harbor mv /my_backup_dir/harbor harbor
``` ```
4. Restore database and `harbor.cfg` from backup files in `/path/to/backup/` 4. Restore database, copy the data files from backup directory to you data volume, by default `/data/database`.
To restore the data in database, simply copy the data files from backup directory to you data volume, by default `/data/database`.
For `harbor.cfg`, similarly, copy the backup file to the path where harbor is installed.
5. Restart Harbor service using the previous configuration. 5. Restart Harbor service using the previous configuration.
If previous version of Harbor was installed by a release build: If previous version of Harbor was installed by a release build: