Skip to content

docs(integration): add Harbor registry integration guide - #150

Merged
majinghe merged 1 commit into
rustfs:mainfrom
majinghe:docs/harbor-integration
Sep 20, 2026
Merged

majinghe merged 1 commit into
rustfs:mainfrom
majinghe:docs/harbor-integration

Conversation

@majinghe

Copy link
Copy Markdown
Collaborator

Summary

Adds a Harbor guide under a new Registry category in the Integration section, in all five locales (en, zh, de, fr, ja), following the established integration guide structure. Harbor's GitHub repository is linked in the product introduction.

  • Deploys RustFS with Docker Compose alongside goharbor/registry-photon — the registry component Harbor itself ships — configured with the distribution S3 storage driver pointed at the RustFS endpoint (regionendpoint: http://rustfs:9000, secure: false, skipverify: true, redirect.disable: true).
  • Pushes an image, pulls it back after deleting the local copy, and verifies the docker/registry/v2/ objects (_layers, _manifests) through rc ls and a Console screenshot (light theme, ≤300 KB; Chinese capture in zh, English captures in the other locales).
  • Maps the same settings to a full Harbor deployment: Helm chart persistence.imageChartStorage values and the storage_service.s3 keys behind harbor.yml.
  • Adds the new Registry category landing pages and wires them into every locale's integration/meta.json and Integration overview (description + bullet), on top of the current Data Analytics / Observability / Others categories.

Verification

Validated end to end on Ubuntu 24.04 against goharbor/registry-photon:v2.12.2 and rustfs/rustfs-x86-musl:v2.3.1:

  • curl http://localhost:5000/v2/_catalog → {"repositories":["demo/app"]}
  • docker push localhost:5000/demo/app:v1 → blobs stored in RustFS under docker/registry/v2/ (12 objects, 2.1 MiB in the bucket)
  • docker rmi + docker pull localhost:5000/demo/app:v1 → layers served from RustFS

npm run docs:check passes; npm run build passes (2595 pages); locale audit reports no findings for the new pages. Based on current main (includes #143, #148, #149).

Add a Harbor guide under a new registry category in the Integration
section, in all five locales (en, zh, de, fr, ja).

Harbor persists image layers, manifests, and OCI artifacts through
its embedded registry component, which implements the S3 storage
driver of the distribution project. The guide deploys RustFS with
Docker Compose alongside goharbor/registry-photon (the registry
component Harbor ships) with the S3 driver pointed at the RustFS
endpoint (regionendpoint, secure: false, path-style), pushes and
pulls an image, verifies the docker/registry/v2 objects through the
rc CLI and a Console screenshot, and maps the same settings to a
full Harbor deployment via the Helm chart values and harbor.yml.

Verified end to end against goharbor/registry-photon:v2.12.2 and
rustfs/rustfs-x86-musl:v2.3.1: pushed localhost:5000/demo/app:v1,
confirmed the _layers and _manifests objects in RustFS, and pulled
the image back after deleting the local copy.
@vercel

vercel Bot commented Sep 20, 2026

Copy link
Copy Markdown

@majinghe is attempting to deploy a commit to the overtrue's projects Team on Vercel.

A member of the Team first needs to authorize it.

@majinghe
majinghe merged commit 2e93e9a into rustfs:main Sep 20, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant