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

README and AUTHORS

Browse Source
This commit is contained in:
Henry Zhang 2016-03-11 21:21:06 +08:00
parent 4e7356acf6
commit ffa1a3129e
2 changed files with 66 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
AUTHORS Normal file
View File

@ -0,0 +1,10 @@
# This file lists all individuals having contributed content to the repository.
Bobby Zhang <junzhang@vmware.com>
Daniel Jiang <jiangd@vmware.com>
Haining Henry Zhang <henryzhang@vmware.com>
Hao Xia <haox@vmware.com>
Kun Wang <kunw@vmware.com>
Shan Zhu <zhus@vmware.com>
Wenkai Yin <yinw@vmware.com>

107
README.md
View File

@ -1,51 +1,56 @@
# Harbor # Harbor
[![Build Status](https://travis-ci.org/vmware/harbor.svg?branch=master)](https://travis-ci.org/vmware/harbor) [![Build Status](https://travis-ci.org/vmware/harbor.svg?branch=master)](https://travis-ci.org/vmware/harbor)
![alg tag](https://cloud.githubusercontent.com/assets/2390463/13484557/088a1000-e13a-11e5-87d4-a64366365bef.png) ![alg tag](https://cloud.githubusercontent.com/assets/2390463/13484557/088a1000-e13a-11e5-87d4-a64366365bef.png)
Project Harbor is an enterprise-class registry server. It extends the open source Docker Registry server by adding more functionalities usually required by an enterprise. Harbor is designed to be deployed in a private environment of an organization. A private registry is important for organizations who care much about security. In addition, a private registry improves productivity by eliminating the need to download images from public network. This is very helpful to container users who do not have a good network to the Internet. For example, Harbor accelerates the progress of Chinese developers, because they no longer need to pull images from the Internet. Project Harbor is an enterprise-class registry server. It extends the open source Docker Registry server by adding more functionalities usually required by an enterprise. Harbor is designed to be deployed in a private environment of an organization. A private registry is important for organizations who care much about security. In addition, a private registry improves productivity by eliminating the need to download images from public network. This is very helpful to container users who do not have a good network to the Internet. For example, Harbor accelerates the progress of Chinese developers, because they no longer need to pull images from the Internet.
### Features ### Features
* **Role Based Access Control**: Users and docker repositories are organized via "projects", a user can have differernt permission for images under a namespace. * **Role Based Access Control**: Users and docker repositories are organized via "projects", a user can have differernt permission for images under a namespace.
* **Graphical user portal**: User can easily browse, search docker repositories, manage projects/namepaces. * **Graphical user portal**: User can easily browse, search docker repositories, manage projects/namepaces.
* **AD/LDAP support**: Harbor integrates with existing AD/LDAP of enterprise for user authentication and management. * **AD/LDAP support**: Harbor integrates with existing AD/LDAP of enterprise for user authentication and management.
* **Audting**: All the operations to the repositories are tracked and can be used for auditing purpose. * **Audting**: All the operations to the repositories are tracked and can be used for auditing purpose.
* **Internationalization**: Localized for English and Chinese languages. More languages can be added. * **Internationalization**: Localized for English and Chinese languages. More languages can be added.
* **RESTful API**: RESTful APIs are provided for most administrative operations of Harbor. The integration with other management software becomes easy. * **RESTful API**: RESTful APIs are provided for most administrative operations of Harbor. The integration with other management software becomes easy.
### Try it ### Try it
Harbor is self contained and can be easily deployed via docker-compose. Harbor is self-contained and can be easily deployed via docker-compose.
**System requirements:** Harbor only works with docker 1.8+ and docker-compose 1.6.0+ .
**System requirements:**
* Get the source code: Harbor only works with docker 1.8+ and docker-compose 1.6.0+ .
```sh The host must be connected to the Internet.
$ git clone https://github.com/vmware/harbor
``` 1. Get the source code:
```sh
* Edit the file Deploy/harbor.cfg, make necessary configuration changes such as host name, admin password and mail server. Refer to [Installation Guide](docs/installation_guide.md) for more info. $ git clone https://github.com/vmware/harbor
```
* Install Harbor by the following commands. It may take a while for the docker-compose process to finish.
```sh
$ cd Deploy 2. Edit the file **Deploy/harbor.cfg**, make necessary configuration changes such as host name, admin password and mail server. Refer to [Installation Guide](docs/installation_guide.md) for more info.
$ ./prepare
Generated configuration file: ./config/ui/env 3. Install Harbor by the following commands. It may take a while for the docker-compose process to finish.
Generated configuration file: ./config/ui/app.conf ```sh
Generated configuration file: ./config/registry/config.yml $ cd Deploy
Generated configuration file: ./config/db/env
$ ./prepare
$ docker-compose up Generated configuration file: ./config/ui/env
``` Generated configuration file: ./config/ui/app.conf
If everything works fine, you can open a browser to visit the admin portal at: http://yourhostname . The default administrator username and password is admin/Harbor12345 . Generated configuration file: ./config/registry/config.yml
Generated configuration file: ./config/db/env
**NOTE:**
*To simplify the installation process, a pre-built package of Harbor is provided so that you don't need to clone the source code. By using this package, you can even install Harbor onto a host that is not connected to the Internet. For details on how to download and use the installation package, please refer to* [Installation Guide](docs/installation_guide.md) . $ docker-compose up
```
*For information on how to use Harbor, please see* [User Guide](docs/user_guide.md) . If everything works fine, you can open a browser to visit the admin portal at: http://yourhostname . The default administrator username and password is admin/Harbor12345 .
### Contribution **NOTE:**
We welcome contributions from the community. If you wish to contribute code, we require that you first sign our [Contributor License Agreement](https://vmware.github.io/photon/assets/files/vmware_cla.pdf) and return a copy to osscontributions@vmware.com before we can merge your contribution. To simplify the installation process, a pre-built installation package of Harbor is provided so that you don't need to clone the source code. By using this package, you can even install Harbor onto a host that is not connected to the Internet. For details on how to download and use this installation package, please refer to [Installation Guide](docs/installation_guide.md) .
### License For information on how to use Harbor, please see [User Guide](docs/user_guide.md) .
Harbor is available under the [Apache 2 license](LICENSE).
### Contribution
We welcome contributions from the community. If you wish to contribute code, we require that you first sign our [Contributor License Agreement](https://vmware.github.io/photon/assets/files/vmware_cla.pdf) and return a copy to osscontributions@vmware.com before we can merge your contribution.
### License
Harbor is available under the [Apache 2 license](LICENSE).