Skip to content

spec/manifest: clarify relationship between urls and foreign layers#1932

Merged
aaronlehmann merged 1 commit intodistribution:masterfrom
stevvooe:manifest-urls-fix
Aug 30, 2016
Merged

spec/manifest: clarify relationship between urls and foreign layers#1932
aaronlehmann merged 1 commit intodistribution:masterfrom
stevvooe:manifest-urls-fix

Conversation

@stevvooe
Copy link
Collaborator

Previously, the specificiation incorrectly bound the fates of urls and
foreign layers. These are complementary but unrelated features, in that
the urls field may be populated for layers that aren't foreign. The
type of the layer only dictates the push behavior of the layer, rather
than involving where it came from.

For example, one may pull a foreign layer from a registry, but they may
not push it back to another registry. Conversely, a layer that has no
restrictions on push/pull behavior may be fetched via urls entries.

Signed-off-by: Stephen J Day stephen.day@docker.com

Closes #1931

@dmcgowan
Copy link
Collaborator

LGTM

@codecov-io
Copy link

codecov-io commented Aug 30, 2016

Current coverage is 51.29% (diff: 100%)

Merging #1932 into master will decrease coverage by 10.25%

@@             master      #1932   diff @@
==========================================
  Files           123        123           
  Lines         10936      10936           
  Methods           0          0           
  Messages          0          0           
  Branches          0          0           
==========================================
- Hits           6732       5610   -1122   
- Misses         3324       4584   +1260   
+ Partials        880        742    -138   

Sunburst

Powered by Codecov. Last update b1b100c...6bcdb38

contains a non-empty list of URLs from which this object can be
downloaded.
Provides a list of URLs from which the content may be fetched. Content
should be verified against the `digest` and `size`.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this point out that urls is optional and will generally be absent?

Previously, the specificiation incorrectly bound the fates of `urls` and
foreign layers. These are complementary but unrelated features, in that
the `urls` field may be populated for layers that aren't foreign. The
type of the layer only dictates the push behavior of the layer, rather
than involving where it came from.

For example, one may pull a foreign layer from a registry, but they may
not push it back to another registry. Conversely, a layer that has no
restrictions on push/pull behavior may be fetched via `urls` entries.

Signed-off-by: Stephen J Day <stephen.day@docker.com>
@aaronlehmann
Copy link

LGTM

@aaronlehmann aaronlehmann merged commit 2f16e6e into distribution:master Aug 30, 2016
@stevvooe stevvooe deleted the manifest-urls-fix branch August 30, 2016 01:46
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.

5 participants