harbor README

The project's README from github.com/goharbor/harbor. As one markdown file: README.md.

Harbor

CI Go Report Card Coverage Status CII Best Practices Codacy Badge Code scanning - action OCI Distribution Conformance Tests FOSSA Status Helm Chart on Artifact Hub OpenSSF Scorecard

notificationCommunity 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.



Note: The main branch may be in an unstable or even broken state during development. Please use releases instead of the main branch in order to get a stable set of binaries.

Harbor

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 hosted by the Cloud Native Computing Foundation (CNCF). If you are an organization that wants to help shape the evolution of cloud native technologies, consider joining the CNCF. For details about who is involved and how Harbor plays a role, read the CNCF announcement.

Features

Architecture

For learning the architecture design of Harbor, check the document Architecture Overview of Harbor.

API

Install & Run

System requirements:

On a Linux host: docker 20.10.10-ce+ and docker-compose 1.18.0+.

Download binaries of Harbor release and follow Installation & Configuration Guide to install Harbor.

If you want to deploy Harbor on Kubernetes, please use the Harbor chart.

Refer to the documentation for more details on how to use Harbor.

Verifying Release Signatures

Starting with v2.15.0, Harbor release artifacts are cryptographically signed using Cosign to ensure authenticity and integrity.

Download the installers and signature bundles from the Harbor releases page.

Quick Verification

# Install Cosign (v2.0+)
brew install sigstore/tap/cosign

# Verify signature
cosign verify-blob \
  --bundle harbor-offline-installer-v2.15.0.tgz.sigstore.json \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/goharbor/harbor/.github/workflows/publish_release.yml@refs/tags/v.*$' \
  harbor-offline-installer-v2.15.0.tgz

OCI Distribution Conformance Tests

Check the OCI distribution conformance tests report of Harbor.

Compatibility

The compatibility list document provides compatibility information for the Harbor components.

Community

Demos

Partners and Users

For a list of users, please refer to ADOPTERS.md.

Security

Security Audit

A third party security audit was performed by Cure53 in October 2019. You can see the full report here.

Reporting security vulnerabilities

If you've found a security related issue, a vulnerability, or a potential vulnerability in Harbor, do not file a public issue. Report it privately via GitHub private vulnerability reporting: open the Security tab and click Report a vulnerability. The Harbor Security Team will acknowledge your report, and will follow up in the advisory thread once we've identified the issue positively or negatively.

For further details please see our complete security release process.

License

Harbor is available under the Apache 2 license.

This project uses open source components which have additional licensing terms. The official docker images and licensing terms for these open source components can be found at the following locations:

Fossa Status

FOSSA Status

harbor (goharbor/harbor)

Searching Database…

29.6K ·GitHub
Harbor
Что это такое?Harbor — это open source-реестр (registry) для облачных приложений, которому можно доверять: он хранит, подписывает и сканирует контент — в основном образы контейнеров и Helm-чарты. Проект размещён под крылом CNCF.
Зачем мне свой собственный registry, если есть Docker Hub?Это реестр, который вы размещаете у себя: Harbor расширяет open source-проект Docker Distribution функциями безопасности, идентификации и управления. К тому же, если он работает рядом с вашей средой сборки и запуска, передача образов идёт быстрее.
Как его запустить?Скачайте бинарники релиза Harbor и следуйте Installation & Configuration Guide. Для Kubernetes есть Harbor chart; также поддерживаются Docker Compose и Harbor Operator.
Что нужно на самой машине?Хост с Linux и Docker 20.10.10-ce или новее, а также docker-compose 1.18.0 или новее.
Можно ли взять код из ветки main, или нужен релиз?Используйте релизы — ветка main во время разработки может быть нестабильной и даже сломанной, так что стабильных бинарников оттуда ждать не стоит.
Он хранит что-то ещё, кроме образов контейнеров?Да — Harbor также служит реестром для Helm-чартов, причём контроль доступа на основе проектов работает и для чартов, и для образов.
Можно попробовать его онлайн перед установкой?Да — в README есть ссылка на демо-среду с последней стабильной сборкой Harbor, а также постоянно обновляемые видеодемонстрации его возможностей.
Код когда-нибудь проверяли независимым аудитом?Да — в октябре 2019 года компания Cure53 провела сторонний аудит безопасности Harbor, полный отчёт доступен по ссылке из README.
Как убедиться, что скачанный релиз подлинный?Начиная с v2.15.0 артефакты релизов Harbor подписываются криптографически с помощью Cosign — скачайте пакет подписи со страницы релизов; при успешной проверке выводится 'Verified OK'.
What are similar projects?distribution, containerd, ingress-nginx, apowerb, charts, helm, AgentTeams, slim
Which topics is it in?helm-charts, container, devops-tools, helm, registry, cncf, containers, cloud-native, enterprise, authentication, kubernetes, docker-compose
Creator
goharbor
Size
261.1 MB
Stars
29.6K
Updated
CommitOct 16Releasev2.15.4Oct 09
Age
10y
Commits · 90 Days