diff --git a/docs/compile_guide.md b/docs/compile_guide.md index 77198909c..1453e0b7b 100644 --- a/docs/compile_guide.md +++ b/docs/compile_guide.md @@ -21,7 +21,7 @@ golang* | 1.7.3 + ## Step 2: Getting the source code ```sh - $ git clone https://github.com/vmware/harbor + $ git clone https://github.com/goharbor/harbor ``` ## Step 3: Building and installing Harbor @@ -50,19 +50,19 @@ You can compile the code by one of the three approaches: * Build, install and bring up Harbor without Notary: ```sh - $ make install GOBUILDIMAGE=golang:1.9.2 COMPILETAG=compile_golangimage CLARITYIMAGE=vmware/harbor-clarity-ui-builder:1.6.0 + $ make install GOBUILDIMAGE=golang:1.9.2 COMPILETAG=compile_golangimage CLARITYIMAGE=goharbor/harbor-clarity-ui-builder:1.6.0 ``` * Build, install and bring up Harbor with Notary: ```sh - $ make install GOBUILDIMAGE=golang:1.9.2 COMPILETAG=compile_golangimage CLARITYIMAGE=vmware/harbor-clarity-ui-builder:1.6.0 NOTARYFLAG=true + $ make install GOBUILDIMAGE=golang:1.9.2 COMPILETAG=compile_golangimage CLARITYIMAGE=goharbor/harbor-clarity-ui-builder:1.6.0 NOTARYFLAG=true ``` * Build, install and bring up Harbor with Clair: ```sh - $ make install GOBUILDIMAGE=golang:1.9.2 COMPILETAG=compile_golangimage CLARITYIMAGE=vmware/harbor-clarity-ui-builder:1.6.0 CLAIRFLAG=true + $ make install GOBUILDIMAGE=golang:1.9.2 COMPILETAG=compile_golangimage CLARITYIMAGE=goharbor/harbor-clarity-ui-builder:1.6.0 CLAIRFLAG=true ``` #### II. Compile code with your own Golang environment, then build Harbor @@ -70,22 +70,22 @@ You can compile the code by one of the three approaches: * Move source code to $GOPATH ```sh - $ mkdir $GOPATH/src/github.com/vmware/ + $ mkdir $GOPATH/src/github.com/goharbor/ $ cd .. - $ mv harbor $GOPATH/src/github.com/vmware/. + $ mv harbor $GOPATH/src/github.com/goharbor/. ``` * Build, install and run Harbor without Notary and Clair: ```sh - $ cd $GOPATH/src/github.com/vmware/harbor + $ cd $GOPATH/src/github.com/goharbor/harbor $ make install ``` * Build, install and run Harbor with Notary and Clair: ```sh - $ cd $GOPATH/src/github.com/vmware/harbor + $ cd $GOPATH/src/github.com/goharbor/harbor $ make install -e NOTARYFLAG=true CLAIRFLAG=true ``` diff --git a/docs/configure_swagger.md b/docs/configure_swagger.md index ef8a30e6f..2d07cc571 100644 --- a/docs/configure_swagger.md +++ b/docs/configure_swagger.md @@ -14,7 +14,7 @@ From time to time, you may need to mannually test Harbor REST API. You can deplo * Download _prepare-swagger.sh_ and _swagger.yaml_ under the _docs_ directory to your local Harbor directory, e.g. **~/harbor**. ```sh - wget https://raw.githubusercontent.com/vmware/harbor/master/docs/prepare-swagger.sh https://raw.githubusercontent.com/vmware/harbor/master/docs/swagger.yaml + wget https://raw.githubusercontent.com/goharbor/harbor/master/docs/prepare-swagger.sh https://raw.githubusercontent.com/goharbor/harbor/master/docs/swagger.yaml ``` * Edit the script file _prepare-swagger.sh_. ```sh diff --git a/docs/customize_look&feel_guide.md b/docs/customize_look&feel_guide.md index bb3b38465..914d64538 100644 --- a/docs/customize_look&feel_guide.md +++ b/docs/customize_look&feel_guide.md @@ -11,8 +11,8 @@ Open the `setting.json` file, you'll see the default content as shown below: "headerLogo": "", "loginBgImg": "", "product": { - "title": "VMware Harbor", - "company": "vmware", + "title": "Harbor", + "company": "goharbor", "name": "Harbor", "introductions": { "zh-cn": "", diff --git a/docs/customize_token_service.md b/docs/customize_token_service.md index e7344b26a..6d3400bc9 100644 --- a/docs/customize_token_service.md +++ b/docs/customize_token_service.md @@ -40,7 +40,7 @@ Email Address []: After you execute these two commands, you will see private_key.pem and root.crt in the **current directory**, just type "ls", you'll see them. -3.Refer to [Installation Guide](https://github.com/vmware/harbor/blob/master/docs/installation_guide.md) to install Harbor, After you execute ./prepare, Harbor generates several config files. We need to replace the original private key and certificate with your own key and certificate. +3.Refer to [Installation Guide](https://github.com/goharbor/harbor/blob/master/docs/installation_guide.md) to install Harbor, After you execute ./prepare, Harbor generates several config files. We need to replace the original private key and certificate with your own key and certificate. 4.Replace the default key and certificate. Assume that you key and certificate are in the directory /root/cert, following are what you should do: @@ -55,6 +55,6 @@ $ cp /root/cert/root.crt ../registry/root.crt $ docker-compose up -d ``` -6.Then you can push/pull images to see if your own certificate works. Please refer [User Guide](https://github.com/vmware/harbor/blob/master/docs/user_guide.md) for more info. +6.Then you can push/pull images to see if your own certificate works. Please refer [User Guide](https://github.com/goharbor/harbor/blob/master/docs/user_guide.md) for more info. diff --git a/docs/developer_guide_i18n.md b/docs/developer_guide_i18n.md index 0e90a75de..68f16f282 100644 --- a/docs/developer_guide_i18n.md +++ b/docs/developer_guide_i18n.md @@ -10,7 +10,7 @@ ``` { "APP_TITLE": { - "VMW_HARBOR": "VMware Harbor", + "VMW_HARBOR": "Harbor", "HARBOR": "Harbor", ... }, diff --git a/docs/installation_guide.md b/docs/installation_guide.md index 8939b5363..84c9d7d80 100644 --- a/docs/installation_guide.md +++ b/docs/installation_guide.md @@ -7,7 +7,7 @@ Harbor can be installed by one of three approaches: - **OVA installer:** Use this installer when user have a vCenter environment, Harbor is launched after OVA deployed. Detail information please refer **[Harbor OVA install guide](install_guide_ova.md)** -All installers can be downloaded from the **[official release](https://github.com/vmware/harbor/releases)** page. +All installers can be downloaded from the **[official release](https://github.com/goharbor/harbor/releases)** page. This guide describes the steps to install and configure Harbor by using the online or offline installer. The installation processes are almost the same. @@ -48,7 +48,7 @@ The installation steps boil down to the following #### Downloading the installer: -The binary of the installer can be downloaded from the [release](https://github.com/vmware/harbor/releases) page. Choose either online or offline installer. Use *tar* command to extract the package. +The binary of the installer can be downloaded from the [release](https://github.com/goharbor/harbor/releases) page. Choose either online or offline installer. Use *tar* command to extract the package. Online installer: ``` @@ -311,7 +311,7 @@ hostname = 192.168.0.2:8888 3.Re-deploy Harbor refering to previous section "Managing Harbor's lifecycle". ### For HTTPS protocol -1.Enable HTTPS in Harbor by following this [guide](https://github.com/vmware/harbor/blob/master/docs/configure_https.md). +1.Enable HTTPS in Harbor by following this [guide](https://github.com/goharbor/harbor/blob/master/docs/configure_https.md). 2.Modify docker-compose.yml Replace the first "443" to a customized port, e.g. 8888:443. diff --git a/docs/kubernetes_deployment.md b/docs/kubernetes_deployment.md index d9527d425..0ce596128 100644 --- a/docs/kubernetes_deployment.md +++ b/docs/kubernetes_deployment.md @@ -1,4 +1,4 @@ -**IMPORTANT** This guide is deprecated and not updated any more. We strongly recommend using [Harbor Helm Chart](https://github.com/vmware/harbor/tree/master/contrib/helm/harbor) to deploy latest Harbor release on Kubernetes. +**IMPORTANT** This guide is deprecated and not updated any more. We strongly recommend using [Harbor Helm Chart](https://github.com/goharbor/harbor/tree/master/contrib/helm/harbor) to deploy latest Harbor release on Kubernetes. ## Integration with Kubernetes This Document decribes how to deploy Harbor on Kubernetes. It has been verified on **Kubernetes v1.6.5** and **Harbor v1.2.0** @@ -7,7 +7,7 @@ This Document decribes how to deploy Harbor on Kubernetes. It has been verified * You should have domain knowledge about Kubernetes (Deployment, Service, Persistent Volume, Persistent Volume Claim, Config Map, Ingress). * **Optional**: Load the docker images onto woker nodes. *If you skip this step, worker node will pull images from Docker Hub when starting the pods.* - * Download the offline installer of Harbor v1.2.0 from the [release](https://github.com/vmware/harbor/releases) page. + * Download the offline installer of Harbor v1.2.0 from the [release](https://github.com/goharbor/harbor/releases) page. * Uncompress the offline installer and get the images tgz file harbor.*.tgz, transfer it to each of the worker nodes. * Load the images into docker: ``` diff --git a/docs/migration_guide.md b/docs/migration_guide.md index e129f3ab9..324ba2a63 100644 --- a/docs/migration_guide.md +++ b/docs/migration_guide.md @@ -31,32 +31,32 @@ When upgrading your existing Habor instance to a newer version, you may need to ``` 3. Get the lastest Harbor release package from Github: - https://github.com/vmware/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: - **NOTE:** Before harbor 1.5 , image name of the migration tool is `vmware/harbor-db-migrator:[tag]` + **NOTE:** Before harbor 1.5 , image name of the migration tool is `goharbor/harbor-db-migrator:[tag]` ``` - docker pull vmware/harbor-migrator:[tag] + docker pull goharbor/harbor-migrator:[tag] ``` 5. Back up database/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". - **NOTE:** Upgrade from harbor 1.2 or older to harbor 1.3 must use `vmware/harbor-db-migrator:1.2`. Because DB engine replaced by MariaDB in harbor 1.3 + **NOTE:** Upgrade from harbor 1.2 or older to harbor 1.3 must use `goharbor/harbor-db-migrator:1.2`. Because DB engine replaced by MariaDB in harbor 1.3 ``` - docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup vmware/harbor-migrator:[tag] backup + docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup goharbor/harbor-migrator:[tag] backup ``` **NOTE:** By default, the migrator handles the backup for DB or CFG. If you want to backup DB or CFG only, refer to the following commands. ``` - docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${backup_path}:/harbor-migration/backup vmware/harbor-migrator:[tag] --db backup + docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${backup_path}:/harbor-migration/backup goharbor/harbor-migrator:[tag] --db backup ``` ``` - docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup vmware/harbor-migrator:[tag] --cfg backup + docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup goharbor/harbor-migrator:[tag] --cfg backup ``` 6. Upgrade database schema, harbor.cfg and migrate data. @@ -64,29 +64,29 @@ When upgrading your existing Habor instance to a newer version, you may need to **NOTE:** In v1.6.0, you needs to DO three sequential steps to fully migrate Harbor, Notary and Clair's DB. The migration of Notary and Clair's DB depends on Harbor's DB, you need to first upgrade Harbor's DB, then upgrade Notary and Clair's DB. The following command handles the upgrade for Harbor DB and CFG, not include Notary and Clair DB. ``` - docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg vmware/harbor-migrator:[tag] up + docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:[tag] up ``` **NOTE:** You must run migration of Notary and Clair's DB before launch Harbor. If you want to upgrade Notary and Clair DB, refer to the following commands: ``` - docker run -it --rm -e DB_USR=root -v /data/notary-db/:/var/lib/mysql -v /data/database:/var/lib/postgresql/data vmware/harbor-migrator:${tag} --db up + docker run -it --rm -e DB_USR=root -v /data/notary-db/:/var/lib/mysql -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:${tag} --db up - docker run -it --rm -v /data/clair-db/:/clair-db -v /data/database:/var/lib/postgresql/data vmware/harbor-migrator:${tag} --db up + docker run -it --rm -v /data/clair-db/:/clair-db -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:${tag} --db up ``` **NOTE:** If you want to upgrade DB or CFG only, refer to the following commands: ``` - docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql vmware/harbor-migrator:[tag] --db up + docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql goharbor/harbor-migrator:[tag] --db up - docker run -it --rm -e DB_USR=root -v /data/notary-db/:/var/lib/mysql -v /data/database:/var/lib/postgresql/data vmware/harbor-migrator:${tag} --db up + docker run -it --rm -e DB_USR=root -v /data/notary-db/:/var/lib/mysql -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:${tag} --db up - docker run -it --rm -v /data/clair-db/:/clair-db -v /data/database:/var/lib/postgresql/data vmware/harbor-migrator:${tag} --db up + docker run -it --rm -v /data/clair-db/:/clair-db -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:${tag} --db up ``` ``` - docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg vmware/harbor-migrator:[tag] --cfg up + docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:[tag] --cfg up ``` **NOTE:** Some errors like @@ -120,21 +120,21 @@ For any reason, if you want to roll back to the previous version of Harbor, foll 2. Restore database from backup file in `/path/to/backup` . ``` - docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup vmware/harbor-migrator:[tag] restore + docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup goharbor/harbor-migrator:[tag] restore ``` **NOTE:** By default, the migrator handles the restore for DB and CFG. If you want to restore DB or CFG only, refer to the following commands: ``` - docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${backup_path}:/harbor-migration/backup vmware/harbor-migrator:[tag] --db restore + docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${backup_path}:/harbor-migration/backup goharbor/harbor-migrator:[tag] --db restore ``` ``` - docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup vmware/harbor-migrator:[tag] --cfg restore + docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg -v ${backup_path}:/harbor-migration/backup goharbor/harbor-migrator:[tag] --cfg restore ``` - **NOTE:** Rollback from harbor 1.3 to harbor 1.2 should delete `/data/database` directory first, then create new database directory `docker-compose up -d && docker-compose stop`. And must use `vmware/harbor-db-migrator:1.2` to restore. Because of DB engine change. + **NOTE:** Rollback from harbor 1.3 to harbor 1.2 should delete `/data/database` directory first, then create new database directory `docker-compose up -d && docker-compose stop`. And must use `goharbor/harbor-db-migrator:1.2` to restore. Because of DB engine change. 3. Remove current Harbor instance. ``` @@ -163,4 +163,4 @@ For any reason, if you want to roll back to the previous version of Harbor, foll ### Migration tool reference - Use `test` command to test mysql connection: - ```docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg vmware/harbor-migrator:[tag] test``` + ```docker run -it --rm -e DB_USR=root -e DB_PWD={db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:[tag] test``` diff --git a/docs/use_make.md b/docs/use_make.md index ec2506540..5b576b1a0 100644 --- a/docs/use_make.md +++ b/docs/use_make.md @@ -39,10 +39,10 @@ version | set harbor version #### EXAMPLE: #### Build and run harbor from source code. -make install GOBUILDIMAGE=golang:1.7.3 COMPILETAG=compile_golangimage CLARITYIMAGE=vmware/harbor-clarity-ui-builder:0.8.4 NOTARYFLAG=true HTTPPROXY= +make install GOBUILDIMAGE=golang:1.7.3 COMPILETAG=compile_golangimage CLARITYIMAGE=goharbor/harbor-clarity-ui-builder:1.6.0 NOTARYFLAG=true HTTPPROXY= ### Package offline installer -make package_offline GOBUILDIMAGE=golang:1.7.3 COMPILETAG=compile_golangimage CLARITYIMAGE=vmware/harbor-clarity-ui-builder:0.8.4 NOTARYFLAG=true HTTPPROXY= +make package_offline GOBUILDIMAGE=golang:1.7.3 COMPILETAG=compile_golangimage CLARITYIMAGE=goharbor/harbor-clarity-ui-builder:1.6.0 NOTARYFLAG=true HTTPPROXY= ### Start harbor with notary make -e NOTARYFLAG=true start diff --git a/docs/user_guide.md b/docs/user_guide.md index 0610e0b3d..f5e232323 100644 --- a/docs/user_guide.md +++ b/docs/user_guide.md @@ -327,7 +327,7 @@ Run the below commands on the host which Harbor is deployed on to preview what f ```sh $ docker-compose stop -$ docker run -it --name gc --rm --volumes-from registry vmware/registry:2.6.2-photon garbage-collect --dry-run /etc/registry/config.yml +$ docker run -it --name gc --rm --volumes-from registry goharbor/registry:2.6.2-photon garbage-collect --dry-run /etc/registry/config.yml ``` **NOTE:** The above option "--dry-run" will print the progress without removing any data. @@ -336,7 +336,7 @@ Verify the result of the above test, then use the below commands to perform garb ```sh -$ docker run -it --name gc --rm --volumes-from registry vmware/registry:2.6.2-photon garbage-collect /etc/registry/config.yml +$ docker run -it --name gc --rm --volumes-from registry goharbor/registry:2.6.2-photon garbage-collect /etc/registry/config.yml $ docker-compose start ```