Docker Registry

Ce guide connecte la Docker Registry open source (distribution) à RustFS comme backend de stockage S3. Vous allez exécuter un registre qui stocke toutes les couches et tous les manifestes dans un compartiment (bucket) RustFS, puis pousser une image et la tirer (pull). Le flux a été validé avec registry:2 et rustfs/rustfs-x86-musl:v2.3.1.

Vous avez besoin de Docker sur l’hôte du registre.

Schéma d’architectureCopy Anchor Link

Le registre stocke chaque blob (couches et configurations) et chaque manifeste comme objets sous docker/registry/v2/ dans le compartiment. Le conteneur lui-même est sans état, de sorte que les nœuds du registre peuvent être mis à l’échelle horizontalement face au même compartiment.

docker run -d --name registry --network oo-rustfs_default -p 5000:5000 \
  -e REGISTRY_STORAGE=s3 \
  -e REGISTRY_STORAGE_S3_ACCESSKEY=<your-access-key> \
  -e REGISTRY_STORAGE_S3_SECRETKEY=<your-secret-key> \
  -e REGISTRY_STORAGE_S3_REGION=us-east-1 \
  -e REGISTRY_STORAGE_S3_BUCKET=registry-demo \
  -e REGISTRY_STORAGE_S3_REGIONENDPOINT=http://<your-rustfs-endpoint>:9000 \
  registry:2

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5000/v2/

200

docker pull alpine:3.20
docker tag alpine:3.20 localhost:5000/rustfs-demo/alpine:3.20
docker push localhost:5000/rustfs-demo/alpine:3.20

3.20: digest: sha256:c64c687cbea9300178b30c95835354e34c4e4febc4badfe27102879de0483b5e

rc ls rustfs/registry-demo/docker/registry/v2/repositories/rustfs-demo/alpine/ -r | head -4

_repositories/rustfs-demo/alpine/_layers/sha256/25f1d6b1.../link
_repositories/rustfs-demo/alpine/_manifests/revisions/sha256/c64c687c.../link
_repositories/rustfs-demo/alpine/_manifests/tags/3.20/current/link

docker rmi localhost:5000/rustfs-demo/alpine:3.20
docker pull localhost:5000/rustfs-demo/alpine:3.20

3.20: Pulling from rustfs-demo/alpine
Digest: sha256:c64c687cbea9300178b30c95835354e34c4e4febc4badfe27102879de0483b5e
Status: Downloaded newer image for localhost:5000/rustfs-demo/alpine:3.20

docker rm -f registry
rc rm rustfs/registry-demo/ --recursive --force

DépannageCopy Anchor Link

Le push échoue avec unknown ou un digest videCopy Anchor Link

Vérifiez que REGISTRY_STORAGE_S3_REGIONENDPOINT est défini — sans cela, le registre envoie les requêtes vers le véritable AWS. Vérifiez aussi que le compartiment existe.

InvalidAccessKeyId au moment du pushCopy Anchor Link

La clé d’accès et la clé secrète doivent être transmises avec REGISTRY_STORAGE_S3_ACCESSKEY / SECRETKEY ; le registre ne lit pas la chaîne d’identifiants de l’environnement AWS dans ce pilote.

La récupération renvoie manifest unknown après le redémarrage du registreCopy Anchor Link

Les manifestes et les blobs résident dans le compartiment, un redémarrage ne peut donc pas les perdre. Vérifiez que les deux instances du registre pointent vers le même REGISTRY_STORAGE_S3_BUCKET et le même REGIONENDPOINT.

Étapes suivantesCopy Anchor Link

• Comparez avec le guide Harbor lorsque vous avez besoin d’une interface, du RBAC ou de la réplication sur le même compartiment.
• Créez des identifiants de production dédiés avec la gestion des clés d’accès.
• Suivez la documentation distribution pour le réglage du pilote de stockage et les configurations de cache proxy.