Skip to content

v2.0.0

Choose a tag to compare

@wy65701436 wy65701436 released this 13 May 10:48
· 207 commits to release-2.0.0 since this release

New Features

  • OCI compliant cloud native artifact support

Harbor v2.0.0 is an OCI compatible registry which means it now supports OCI images and OCI image indexes (https://github.com/opencontainers/image-spec/blob/master/image-index.md). An OCI image index is a higher level manifest which points to a list of image manifests, ideal for one or more platforms. For ex., Docker manifest list is a popular implementation of the OCI image index. This also means Harbor now fully supports multi-arch images.

With this release, users can manage images, manifest lists, Helm charts, CNABs, OPAs among others which all adhere to the OCI image specification. It also allows for pulling, pushing, deleting, tagging, replicating, and scanning such kinds of artifacts. Signing images and manifest list are also possible now.

  • Additional Features
    • Enable Trivy to be the default vulnerability scanner which simplifies the configuration of Trivy scanner.
    • Enable TLS between Harbor components which makes intra-components traffic more secure.
    • Webhook enhancements including supporting interaction with Slack, selectable event list, multiple endpoints, new events, etc.
    • Enhance the robot account to allow users to set individual expiration time for each robot
    • Refactor the error handling framework for better troubleshooting.
    • View untagged images in UI and include / exclude these from GC and tag retention jobs
    • Selectively delete tags from an image without deleting the image digest or other associated tags

Resolved Issues

Notes

  • The 1.3.x helm chart does not work with this build currently, there will be a new release of helm chart that works with 2.0.x images, please stay tuned.
  • Break change in API: Most of the REST APIs now has the prefix /api/v2.0 in the URI, instead of /api. For details please refer to the following API docs:
  • Change in installation and upgrade process:
    • For installation based on docker-compose, the default configuration file in the installation package is renamed to harbor.yml.tmpl. You must set the values, rename it to harbor.yml before running the installation script.
    • The migrator image is removed and now the migrate is a sub-command of prepare. More details please refer to: https://goharbor.io/docs/2.0.0/administration/upgrade/
  • Project Quota based on number of images has been removed permanently.
  • As from v2.0.0, any of artifact stored in the distribution storage is tagless. To prevent these untagged artifacts are not removed by Garbage Collection, Harbor disables the delete untag option when to run GC in v2.0.0. This leads to the existing untagged artifact in your environment cannot be GCed after upgrade to v2.0.0. To avoid this, it's recommended to run GC before doing upgradation.
  • CRON schedule now follows UTC timezone to scheudle tasks comparing to the previous server local timezone.