mirror of
https://github.com/goharbor/harbor.git
synced 2024-11-25 19:56:09 +01:00
doc(readme):update readme to fix broken content
- add architecture section - update API section - remove additional tools section - update compatibility list section - update the relevant compatibility list document - add OCI confirmance testing report link - update broken image paths in readme Signed-off-by: Steven Zou <szou@vmware.com>
This commit is contained in:
parent
8a944e0181
commit
8af243d8b2
44
README.md
44
README.md
@ -6,10 +6,10 @@
|
|||||||
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2095/badge)](https://bestpractices.coreinfrastructure.org/projects/2095)
|
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2095/badge)](https://bestpractices.coreinfrastructure.org/projects/2095)
|
||||||
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/c8d726c9cfd047ffaf681449d673f246)](https://www.codacy.com/app/goharbor/harbor?utm_source=github.com&utm_medium=referral&utm_content=goharbor/harbor&utm_campaign=Badge_Grade)
|
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/c8d726c9cfd047ffaf681449d673f246)](https://www.codacy.com/app/goharbor/harbor?utm_source=github.com&utm_medium=referral&utm_content=goharbor/harbor&utm_campaign=Badge_Grade)
|
||||||
[![Nightly Status](https://us-central1-eminent-nation-87317.cloudfunctions.net/harbor-nightly-result)](https://www.googleapis.com/storage/v1/b/harbor-nightly/o)
|
[![Nightly Status](https://us-central1-eminent-nation-87317.cloudfunctions.net/harbor-nightly-result)](https://www.googleapis.com/storage/v1/b/harbor-nightly/o)
|
||||||
[![Conformance Status](https://github.com/goharbor/harbor/workflows/conformance_test/badge.svg)](https://github.com/goharbor/harbor/actions?query=workflow%3ACONFORMANCE_TEST)
|
![CONFORMANCE_TEST](https://github.com/goharbor/harbor/workflows/CONFORMANCE_TEST/badge.svg)
|
||||||
</br>
|
</br>
|
||||||
|
|
||||||
|![notification](docs/img/bell-outline-badged.svg)Community Meeting|
|
|![notification](docs/img/readme/bell-outline-badged.svg)Community Meeting|
|
||||||
|------------------|
|
|------------------|
|
||||||
|The Harbor Project holds bi-weekly community calls in two different timezones. To join the community calls or to watch previous meeting notes and recordings, please visit the [meeting schedule](https://github.com/goharbor/community/blob/master/MEETING_SCHEDULE.md).|
|
|The Harbor Project holds bi-weekly community calls in two different timezones. To join the community calls or to watch previous meeting notes and recordings, please visit the [meeting schedule](https://github.com/goharbor/community/blob/master/MEETING_SCHEDULE.md).|
|
||||||
|
|
||||||
@ -18,7 +18,7 @@
|
|||||||
**Note**: The `master` branch may be in an *unstable or even broken state* during development.
|
**Note**: The `master` branch may be in an *unstable or even broken state* during development.
|
||||||
Please use [releases](https://github.com/vmware/harbor/releases) instead of the `master` branch in order to get a stable set of binaries.
|
Please use [releases](https://github.com/vmware/harbor/releases) instead of the `master` branch in order to get a stable set of binaries.
|
||||||
|
|
||||||
<img alt="Harbor" src="docs/img/harbor_logo.png">
|
<img alt="Harbor" src="docs/img/readme/harbor_logo.png">
|
||||||
|
|
||||||
Harbor is an open source trusted cloud native registry project that stores, signs, and scans content. Harbor extends the open source Docker Distribution by adding the functionalities usually required by users such as security, identity and management. Having a registry closer to the build and run environment can improve the image transfer efficiency. Harbor supports replication of images between registries, and also offers advanced security features such as user management, access control and activity auditing.
|
Harbor is an open source trusted cloud native registry project that stores, signs, and scans content. Harbor extends the open source Docker Distribution by adding the functionalities usually required by users such as security, identity and management. Having a registry closer to the build and run environment can improve the image transfer efficiency. Harbor supports replication of images between registries, and also offers advanced security features such as user management, access control and activity auditing.
|
||||||
|
|
||||||
@ -40,18 +40,15 @@ Harbor is hosted by the [Cloud Native Computing Foundation](https://cncf.io) (CN
|
|||||||
* **RESTful API**: RESTful APIs are provided to facilitate administrative operations, and are easy to use for integration with external systems. An embedded Swagger UI is available for exploring and testing the API.
|
* **RESTful API**: RESTful APIs are provided to facilitate administrative operations, and are easy to use for integration with external systems. An embedded Swagger UI is available for exploring and testing the API.
|
||||||
* **Easy deployment**: Harbor can be deployed via Docker compose as well Helm Chart. A Harbor Operator was added recently as well - https://goharbor.io/docs/1.10/build-customize-contribute/e2e_api_python_based_scripting_guide/
|
* **Easy deployment**: Harbor can be deployed via Docker compose as well Helm Chart. A Harbor Operator was added recently as well - https://goharbor.io/docs/1.10/build-customize-contribute/e2e_api_python_based_scripting_guide/
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
For learning the architecture design of Harbor, check the document [Architecture Overview of Harbor](https://github.com/goharbor/harbor/wiki/Architecture-Overview-of-Harbor).
|
||||||
|
|
||||||
## API
|
## API
|
||||||
|
|
||||||
* [Harbor RESTful API](https://editor.swagger.io/?url=https://raw.githubusercontent.com/goharbor/harbor/master/api/v2.0/swagger.yaml): The APIs for most administrative operations of Harbor and can be used to perform integrations with Harbor programmatically.
|
* Harbor RESTful API: The APIs for most administrative operations of Harbor and can be used to perform integrations with Harbor programmatically.
|
||||||
- Spec validation status: <img src="http://validator.swagger.io/validator?url=https://raw.githubusercontent.com/goharbor/harbor/master/api/harbor/swagger.yaml">
|
* Part 1: [New or changed APIs](https://editor.swagger.io/?url=https://raw.githubusercontent.com/goharbor/harbor/master/api/v2.0/swagger.yaml)
|
||||||
|
* Part 2: [Legacy APIs](https://editor.swagger.io/?url=https://raw.githubusercontent.com/goharbor/harbor/master/api/v2.0/legacy_swagger.yaml)
|
||||||
## Compatibility
|
|
||||||
|
|
||||||
The [compatibility list](./docs/harbor_compatibility_list.md) document provides compatibility information for the Harbor components.
|
|
||||||
|
|
||||||
- [Replication adapters](./docs/harbor_compatibility_list.md#Replication-Adapters)
|
|
||||||
- [OIDC adapters](./docs/harbor_compatibility_list.md#OIDC-Adapters)
|
|
||||||
- [Scanner adapters](./docs/harbor_compatibility_list.md#Scanner-Adapters)
|
|
||||||
|
|
||||||
## Install & Run
|
## Install & Run
|
||||||
|
|
||||||
@ -65,6 +62,18 @@ If you want to deploy Harbor on Kubernetes, please use the **[Harbor chart](http
|
|||||||
|
|
||||||
Refer to **[User Guide](docs/user_guide.md)** for more details on how to use Harbor.
|
Refer to **[User Guide](docs/user_guide.md)** for more details on how to use Harbor.
|
||||||
|
|
||||||
|
## OCI Distribution Conformance Tests
|
||||||
|
|
||||||
|
Check the OCI distribution conformance tests [report](https://storage.googleapis.com/harbor-conformance-test/report.html) of Harbor.
|
||||||
|
|
||||||
|
## Compatibility
|
||||||
|
|
||||||
|
The [compatibility list](./docs/install-config/harbor-compatibility-list.md) document provides compatibility information for the Harbor components.
|
||||||
|
|
||||||
|
* [Replication adapters](./docs/install-config/harbor-compatibility-list.md#Replication-Adapters)
|
||||||
|
* [OIDC adapters](./docs/install-config/harbor-compatibility-list.md#OIDC-Adapters)
|
||||||
|
* [Scanner adapters](./docs/install-config/harbor-compatibility-list.md#Scanner-Adapters)
|
||||||
|
|
||||||
## Community
|
## Community
|
||||||
|
|
||||||
* **Twitter:** [@project_harbor](https://twitter.com/project_harbor)
|
* **Twitter:** [@project_harbor](https://twitter.com/project_harbor)
|
||||||
@ -72,14 +81,6 @@ Refer to **[User Guide](docs/user_guide.md)** for more details on how to use Har
|
|||||||
* **Developer Group:** Join Harbor developer group: [harbor-dev@lists.cncf.io](https://lists.cncf.io/g/harbor-dev) for discussion on Harbor development and contribution.
|
* **Developer Group:** Join Harbor developer group: [harbor-dev@lists.cncf.io](https://lists.cncf.io/g/harbor-dev) for discussion on Harbor development and contribution.
|
||||||
* **Slack:** Join Harbor's community for discussion and ask questions: [Cloud Native Computing Foundation](https://slack.cncf.io/), channel: [#harbor](https://cloud-native.slack.com/messages/harbor/) and [#harbor-dev](https://cloud-native.slack.com/messages/harbor-dev/)
|
* **Slack:** Join Harbor's community for discussion and ask questions: [Cloud Native Computing Foundation](https://slack.cncf.io/), channel: [#harbor](https://cloud-native.slack.com/messages/harbor/) and [#harbor-dev](https://cloud-native.slack.com/messages/harbor-dev/)
|
||||||
|
|
||||||
## Additional Tools
|
|
||||||
|
|
||||||
Tools layered on top of Harbor and contributed by community.
|
|
||||||
|
|
||||||
* **[Harbor.Tagd](https://github.com/HylandSoftware/Harbor.Tagd)**
|
|
||||||
- Automates the process of cleaning up old tags from your Harbor container registries.
|
|
||||||
- Lead by [@nlowe](https://github.com/nlowe) from HylandSoftware.
|
|
||||||
|
|
||||||
## Demos
|
## Demos
|
||||||
|
|
||||||
* **[Live Demo](https://demo.goharbor.io)** - A demo environment with the latest Harbor stable build installed. For additional information please refer to [this page](docs/demo_server.md).
|
* **[Live Demo](https://demo.goharbor.io)** - A demo environment with the latest Harbor stable build installed. For additional information please refer to [this page](docs/demo_server.md).
|
||||||
@ -103,7 +104,6 @@ positively or negatively.
|
|||||||
|
|
||||||
For further details please see our complete [security release process](SECURITY.md).
|
For further details please see our complete [security release process](SECURITY.md).
|
||||||
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
Harbor is available under the [Apache 2 license](LICENSE).
|
Harbor is available under the [Apache 2 license](LICENSE).
|
||||||
|
5
docs/img/readme/bell-outline-badged.svg
Normal file
5
docs/img/readme/bell-outline-badged.svg
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
<svg version="1.1" width="36" height="36" viewBox="0 0 36 36" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||||
|
<title>bell-outline-badged</title>
|
||||||
|
<path class="clr-i-outline--badged clr-i-outline-path-1--badged" d="M18,34.28A2.67,2.67,0,0,0,20.58,32H15.32A2.67,2.67,0,0,0,18,34.28Z"></path><path class="clr-i-outline--badged clr-i-outline-path-2--badged" d="M32.51,27.83A14.4,14.4,0,0,1,30,24.9a12.63,12.63,0,0,1-1.35-4.81V15.15a10.92,10.92,0,0,0-.16-1.79,7.44,7.44,0,0,1-2.24-.84,8.89,8.89,0,0,1,.4,2.64v4.94a14.24,14.24,0,0,0,1.65,5.85,16.17,16.17,0,0,0,2.44,3H5.13a16.17,16.17,0,0,0,2.44-3,14.24,14.24,0,0,0,1.65-5.85V15.15A8.8,8.8,0,0,1,18,6.31a8.61,8.61,0,0,1,4.76,1.44A7.49,7.49,0,0,1,22.5,6c0-.21,0-.42,0-.63a10.58,10.58,0,0,0-3.32-1V3.11a1.33,1.33,0,1,0-2.67,0V4.42A10.81,10.81,0,0,0,7.21,15.15v4.94A12.63,12.63,0,0,1,5.86,24.9a14.4,14.4,0,0,1-2.47,2.93,1,1,0,0,0-.34.75v1.36a1,1,0,0,0,1,1h27.8a1,1,0,0,0,1-1V28.58A1,1,0,0,0,32.51,27.83Z"></path><circle class="clr-i-outline--badged clr-i-outline-path-1--badged clr-i-badge" cx="30" cy="6" r="5"></circle>
|
||||||
|
<rect x="0" y="0" width="36" height="36" fill-opacity="0"/>
|
||||||
|
</svg>
|
After Width: | Height: | Size: 1.2 KiB |
BIN
docs/img/readme/harbor_logo.png
Normal file
BIN
docs/img/readme/harbor_logo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 89 KiB |
@ -43,9 +43,9 @@ This document provides compatibility information for all Harbor components.
|
|||||||
|---|----------|-----------|-----------|------------|--------------------|
|
|---|----------|-----------|-----------|------------|--------------------|
|
||||||
| [Clair](https://github.com/goharbor/harbor-scanner-clair) |![Clair](../../img/scanners/clair.png)| CentOS |![Y](../../img/replication-adapters/right.png)|![Y](../../img/replication-adapters/right.png)| v1.10 |
|
| [Clair](https://github.com/goharbor/harbor-scanner-clair) |![Clair](../../img/scanners/clair.png)| CentOS |![Y](../../img/replication-adapters/right.png)|![Y](../../img/replication-adapters/right.png)| v1.10 |
|
||||||
| [Anchore](https://github.com/anchore/harbor-scanner-adapter) |![Anchore](../../img/scanners/anchore.png) | Anchore |![Y](../../img/replication-adapters/right.png)| N | v1.10 |
|
| [Anchore](https://github.com/anchore/harbor-scanner-adapter) |![Anchore](../../img/scanners/anchore.png) | Anchore |![Y](../../img/replication-adapters/right.png)| N | v1.10 |
|
||||||
| [Trivy](https://github.com/aquasecurity/harbor-scanner-trivy)|![Trivy](../../img/scanners/trivy.png)| Aqua |![Y](../../img/replication-adapters/right.png)| N | v1.10 |
|
| [Trivy](https://github.com/aquasecurity/harbor-scanner-trivy)|![Trivy](../../img/scanners/trivy.png)| Aqua |![Y](../../img/replication-adapters/right.png)| ![Y](../../img/replication-adapters/right.png) | v1.10 |
|
||||||
| [CSP](https://github.com/aquasecurity/harbor-scanner-aqua) |![Aqua](../../img/scanners/aqua.png)| Aqua | N | N | v1.10 |
|
| [CSP](https://github.com/aquasecurity/harbor-scanner-aqua) |![Aqua](../../img/scanners/aqua.png)| Aqua | ![Y](../../img/replication-adapters/right.png) | N | v1.10 |
|
||||||
| [DoSec](https://github.com/dosec-cn/harbor-scanner/blob/master/README_en.md)|![DoSec](../../img/scanners/dosec.png) | DoSec | N | N | v1.10 |
|
| [DoSec](https://github.com/dosec-cn/harbor-scanner/blob/master/README_en.md)|![DoSec](../../img/scanners/dosec.png) | DoSec | ![Y](../../img/replication-adapters/right.png) | N | v1.10 |
|
||||||
|
|
||||||
{{< note >}}
|
{{< note >}}
|
||||||
* `Evaluated` means that the scanner implementation has been officially tested and verified.
|
* `Evaluated` means that the scanner implementation has been officially tested and verified.
|
||||||
|
Loading…
Reference in New Issue
Block a user