From 43b2bce6b1bd7081e5f6381a448472c5a90f759a Mon Sep 17 00:00:00 2001 From: Haining Henry Zhang Date: Mon, 7 Aug 2017 14:38:10 +0800 Subject: [PATCH] update docs for 1.2 (#2974) * update change log * update documents * update documents * update AUTHORS * update README * update harbor.cfg * remove unused files * updated TOC of docs * update REAME * update README * udpate docs for 1.2 * udpate authors * updated installation guide * updated migration guide * updated migration guide --- AUTHORS | 16 ++++++++++++++-- README.md | 4 ++-- docs/installation_guide.md | 2 +- docs/migration_guide.md | 16 +++++++++------- 4 files changed, 26 insertions(+), 12 deletions(-) diff --git a/AUTHORS b/AUTHORS index 7a86407e2..77b4b51b4 100644 --- a/AUTHORS +++ b/AUTHORS @@ -5,15 +5,20 @@ Alexey Erkak Allen Heavey Amanda Zhang Andre Cruz -Aron Parsons +Aron Parsons Benniu Ji Bin Liu +BhEaN Bobby Zhang Brian Christner Chaofeng Wu +Casey Peel < > Daniel Jiang Deshi Xiao +Dmitry Lazurkin +Fangyuan Li Feileng Cui +Fuhui Peng Guangping Fu Haining Henry Zhang Hao Xia @@ -21,19 +26,23 @@ Haoyuan Jack Liu Jessy Zhang Jianye Li -Kira +Kira Kun Wang Mahesh Paolini-Subramanya Maxwell <710028463 at qq.com> Meng Wei +Mizukoshi Masataka Nagarjun G Peng Zhao Penghao Cen Phillip Gomez Robin Naundorf +Samuel Archambault Shan Zhu Steven Zou +Ricardo Katz Robin Yue +Tim Chen Xiaoyu <837829664 at qq.com> Tobe Chen Victoria Zheng Wenkai Yin @@ -41,4 +50,7 @@ Xiaoxiao Zhou Xinkun Xu Yahao He Yan Wang +Yixing Jia Yong Hua +Yufei Ma + diff --git a/README.md b/README.md index 12f5cc208..a77495755 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,8 @@ Project Harbor is an enterprise-class registry server that stores and distribute ### Features * **Role based access control**: Users and repositories are organized via 'projects' and a user can have different permission for images under a project. -* **Policy based image replication**: Images can be replicated (synchronized) between multiple registry instances. Great for load balancing, high availability, multi-datacenter, hybrid and multi-cloud scenarios. +* **Policy based image replication**: Images can be replicated (synchronized) between multiple registry instances, with auto-retry on errors. Great for load balancing, high availability, multi-datacenter, hybrid and multi-cloud scenarios. +* **Vulnerability Scanning**: Harbor scans images regularly and warns users of vulerabilities. * **LDAP/AD support**: Harbor integrates with existing enterprise LDAP/AD for user authentication and management. * **Image deletion & garbage collection**: Images can be deleted and their space can be recycled. * **Notary**: Image authenticity can be ensured. @@ -34,7 +35,6 @@ Refer to **[User Guide](docs/user_guide.md)** for more details on how to use Har ### Community **Slack:** Join Harbor's community here: [VMware {code}](https://code.vmware.com/join/), Channel: #harbor. **Email:** harbor@ vmware.com . -**WeChat Group:** Add WeChat id *connect1688* to join WeChat discussion group. More info on [partners and users](partners.md). ### Contribution diff --git a/docs/installation_guide.md b/docs/installation_guide.md index e9df3ab06..0b44f2c33 100644 --- a/docs/installation_guide.md +++ b/docs/installation_guide.md @@ -122,7 +122,7 @@ _NOTE: For detailed information on storage backend of a registry, refer to [Regi Once **harbor.cfg** and storage backend (optional) are configured, install and start Harbor using the ```install.sh``` script. Note that it may take some time for the online installer to download Harbor images from Docker hub. ##### Default installation (without Notary/Clair) -After version 1.1.0, Harbor has integrated with Notary and Clair (for vulnerability scanning), but by default the installation does not include Notary or Clair service. +Harbor has integrated with Notary and Clair (for vulnerability scanning). However, the default installation does not include Notary or Clair service. ```sh $ sudo ./install.sh diff --git a/docs/migration_guide.md b/docs/migration_guide.md index 45a45caae..33b87a520 100644 --- a/docs/migration_guide.md +++ b/docs/migration_guide.md @@ -1,12 +1,13 @@ # Harbor upgrade and database migration guide -When upgrading your existing Habor instance to a newer version, you may need to migrate the data in your database. Refer to [change log](../migration/changelog.md) to find out whether there is any change in the database. If there is, you should go through the database migration process. Since the migration may alter the database schema, you should **always** back up your data before any migration. +When upgrading your existing Habor instance to a newer version, you may need to migrate the data in your database. Refer to [change log](../tools/migration/changelog.md) to find out whether there is any change in the database. If there is, you should go through the database migration process. Since the migration may alter the database schema, you should **always** back up your data before any migration. *If your install Harbor for the first time, or the database version is the same as that of the lastest version, you do not need any database migration.* -**NOTE:** From 1.2, you need to use release version as the tag of migrator image. 'latest' is no longer used for new release. +**NOTE:** +- From v1.2 on, you need to use the release version as the tag of the migrator image. 'latest' is no longer used for new release. -**NOTE:** You must backup your data before any data migration. +- You must back up your data before any data migration. ### Upgrading Harbor and migrating data @@ -20,13 +21,13 @@ When upgrading your existing Habor instance to a newer version, you may need to 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 /tmp/harbor + mv harbor /my_backup_dir/harbor ``` 3. Get the lastest Harbor release package from Github: https://github.com/vmware/harbor/releases -4. Before upgrading Harbor, perform database migration first. The migration tool is delivered as a docker image, so you should pull the image from docker hub: +4. Before upgrading Harbor, perform database 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. 1.2) in the below command: ``` docker pull vmware/harbor-db-migrator:[tag] @@ -62,7 +63,7 @@ you must make sure **auth_mode** is set to **ldap_auth** in `harbor.cfg` before ``` **NOTE:** After running the script, make sure you go through `harbor.cfg` to verify all the settings are correct. You can make changes to `harbor.cfg` as needed. -8. Under the directory `./harbor`, run the `./install.sh` script to install the new Harbor instance. +8. Under the directory `./harbor`, run the `./install.sh` script to install the new Harbor instance. If your choose to install Harbor with components like Notary and/or Clair, refer to [Installation & Configuration Guide](../docs/installation_guide.md) for more information. ### Roll back from an upgrade For any reason, if you want to roll back to the previous version of Harbor, follow the below steps: @@ -86,7 +87,7 @@ For any reason, if you want to roll back to the previous version of Harbor, foll 4. Restore the older version package of Harbor. ```sh - mv /tmp/harbor harbor + mv /my_backup_dir/harbor harbor ``` 5. Restart Harbor service using the previous configuration. @@ -95,6 +96,7 @@ For any reason, if you want to roll back to the previous version of Harbor, foll cd harbor ./install.sh ``` + **Note:** If your choose to install Harbor with components like Notary and/or Clair, refer to [Installation & Configuration Guide](../docs/installation_guide.md) for more information. If your previous version of Harbor was installed from source code: ```sh