Pulp Container Plugin

You can use the pulp_container plugin to extend Pulp so that you can host your container registry and distribute containers in an on-premises environment. You can synchronize from a range of Docker Registry HTTP API V2-compatible registries. Depending on your needs, you can perform whole or partial syncs from these remote repositories, blend content from different sources, and distribute them throughout your organization using Pulp. You can also build OCI-compatible images with Pulp Container and push them to a repository in Pulp so you can distribute private containers.

For information about why you might think about hosting your own container registry, see 5 reasons to host your container registry with Pulp. At the time of this article’s publication, there was no native way to perform import and exports to disconnected or air-gapped environments. This has since been introduced and is available.

If you’d like to watch a recent talk about Pulp Container and see it in action, check out Registry Native Delivery of Software Content.

If you are just getting started, we recommend getting to know the basic workflows.


Tech Preview

Some additional features are being supplied as a tech preview. There is a possibility that backwards incompatible changes will be introduced for these particular features. For a list of features currently being supplied as tech previews only, see the tech preview page.

How to use these docs

The documentation here should be considered the primary documentation for managing container related content. All relevent workflows are covered here, with references to some pulpcore supplemental docs. Users may also find pulpcore’s conceptual docs useful.

This documentation falls into two main categories:

  1. Workflows shows the major features of the container plugin, with links to reference docs.

  2. The REST API Docs are automatically generated and provide more detailed information for each minor feature, including all fields and options.

Container Workflows

Indices and tables