Project

Profile

Help

Story #968

closed

As a user, I can sync from a v2 registry

Added by mhrivnak almost 9 years ago. Updated about 5 years ago.

Status:
CLOSED - CURRENTRELEASE
Priority:
High
Assignee:
Start date:
Due date:
% Done:

100%

Estimated time:
Platform Release:
Target Release - Docker:
2.0.0
Groomed:
Yes
Sprint Candidate:
Yes
Tags:
Pulp 2
Sprint:
Quarter:

Description

The sync process should start by trying with the v2 API and fall back to the v1 API.

Details of the v2 API: https://github.com/docker/distribution/blob/release/2.0/docs/spec/api.md

For now, we can assume that we only get the manifest's digest from the header Docker-Content-Digest, which is theoretically optional. The upstream docker registry does provide it. In the future, we can add logic to the sync and upload workflows that calculates the digest if it's not available.

As of this writing, the docker hub does not yet implement the v2 API. The only available implementation is the upstream registry, which you can run locally with

docker run -p 5000:5000 registry:2

Then you can push a repository to it with a docker client.

Deliverables:

  • sync works with the v2 API
  • sync creates both manifest and image units
  • sync falls back to the v1 API
  • Documentation / recipes

Related issues

Related to Docker Support - Task #1163: Dockerment all of the Docker v2 workCLOSED - CURRENTRELEASErbarlow

Actions
Blocked by Docker Support - Task #967: Create a "manifest" modelCLOSED - CURRENTRELEASErbarlow

Actions
Blocks Docker Support - Story #969: As a user, I can sync from static files in the v2 API layoutCLOSED - CURRENTRELEASErbarlow

Actions
Blocks Docker Support - Task #1048: Tracker for Docker v2 API and Manifest workCLOSED - CURRENTRELEASErbarlow

Actions
Blocks Docker Support - Story #1144: As a user, I can sync from a v2 registry that requires RFC7235 authorization headersCLOSED - CURRENTRELEASEamacdona@redhat.com

Actions
Blocks Docker Support - Story #1145: As a user, I am assured that Pulp is downloading the correct manifestsCLOSED - CURRENTRELEASE

Actions

Also available in: Atom PDF