Test #4461

As a user i can configure download of the foreign layers

Added by bherring 11 months ago. Updated 19 days ago.

Platform Release:


Some images like windows base images, contain artifacts whose distribution is restricted by license.
When these images are pushed to a registry, restricted artifacts are skipped/not included by default.

These artifacts are called foreign layers and have "mediaType": "application/vnd.docker.image.rootfs.foreign.diff.tar.gzip"

Remote should have a Boolean "*allow_foreign_layers*" option which would control the download of the foreign layers.

Set to False (default):
Pulp will check the mediatype and simply will skip the foreign layers.
Case: do not sync content which is restricted by a license without explicit acknowledgment in the Remote config
From client side, it will follow the url specified in the details of the layer in the manifest.

Set to True:
Pulp will download the foreign layers by following the url.
Case: due to use case of registries with air gaped network, now it's possible to push to the registry foreign layers, by enabling -allow-nondistributable-artifacts daemon option. From client side, foreign layers are now pulled from the registry if possible, falling back to the URLs in the image manifest otherwise. As far as i know that's done in docker for Windows. Linux version is still ignoring foreign layers during pull.

Related issues

Copied from Container Support - Story #4171: As a user i can configure download of the foreign layers CLOSED - CURRENTRELEASE Actions


#1 Updated by bherring 11 months ago

  • Copied from Story #4171: As a user i can configure download of the foreign layers added

#2 Updated by bherring 11 months ago

Notes from Triage

some docker repos that contain forigen layers... failed before this.. now it works
Always skips foriegn layers ; has a docker repo

#3 Updated by bmbouter 9 months ago

  • Tags deleted (Pulp 3)

#4 Updated by 0888rihanmalik 9 months ago

Excellent article. I was wondering about this so I’m very happy I found your website.

#5 Updated by about 2 months ago

  • Project changed from Docker Support to Container Support

#6 Updated by veronicasegura about 2 months ago

Your site may be stunning and furthermore require incredible open on your blog bit of paper. Tolerable introduction keep inscription.I totally adored the manner in which you reviewed this put. The substance are written positively and every one of the wordings are straightforward. This blog is one in my top choice. Continue sharing extra supportive and instructive posts. Allude

#7 Updated by naveed066 about 1 month ago

I recently bought some paid software from

#8 Updated by edwardrosen 19 days ago

you can google your problem and find easily solutions. If you need any service related to animated video I,m here to help you just visit this site..

Please register to edit this issue

Also available in: Atom PDF