Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

doc/spec, registry: immutable manifest reference support #211

Merged
merged 2 commits into from
Mar 6, 2015
Merged

doc/spec, registry: immutable manifest reference support #211

merged 2 commits into from
Mar 6, 2015

Commits on Mar 5, 2015

  1. spec: fetch manifests by tag or digest 

    Manifests are now fetched by a field called "reference", which may be a tag or
a digest. When using digests to reference a manifest, the data is immutable.
The routes and specification have been updated to allow this.

There are a few caveats to this approach:

1. It may be problematic to rely on data format to differentiate between a tag
   and a digest. Currently, they are disjoint but there may modifications on
   either side that break this guarantee.
2. The caching characteristics of returned content are very different for
   digest versus tag-based references. Digest urls can be cached forever while tag
   urls cannot.

Both of these are minimal caveats that we can live with in the future.

Signed-off-by: Stephen J Day <stephen.day@docker.com>
    @stevvooe
    stevvooe committed Mar 5, 2015
    2 Configuration menu
    Copy the full SHA
    f536633 View commit details
    Browse the repository at this point in the history

  2. Implement immutable manifest reference support 

    This changeset implements immutable manifest references via the HTTP API. Most
of the changes follow from modifications to ManifestService. Once updates were
made across the repo to implement these changes, the http handlers were change
accordingly. The new methods on ManifestService will be broken out into a
tagging service in a later PR.

Unfortunately, due to complexities around managing the manifest tag index in an
eventually consistent manner, direct deletes of manifests have been disabled.

Signed-off-by: Stephen J Day <stephen.day@docker.com>
    @stevvooe
    stevvooe committed Mar 5, 2015
    Configuration menu
    Copy the full SHA
    40273b1 View commit details
    Browse the repository at this point in the history