Pulp Container Plugin¶
The pulp_container
plugin extends pulpcore to support
hosting container images and container metadata, supporting pull
and push
operations.
If you are just getting started, we recommend getting to know the basic workflows.
Features¶
- Synchronize container image repositories hosted on Docker-hub, Google Container Registry, Quay.io, etc., in mirror or additive mode
- Create Versioned Repositories so every operation is a restorable snapshot
- Download content on-demand when requested by clients to reduce disk space
- Perform docker/podman pull from a container distribution served by Pulp
- Perform docker/podman push to the Pulp Registry
- Curate container images by filtering what is mirrored from an external repository
- Curate container images by creating repository versions with a specific set of images
- Build an OCI format image from a Containerfile and make it available from the Pulp Registry
- Host content either locally or on S3
- De-duplication of all saved content
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:
- Workflows shows the major features of the container plugin, with links to reference docs.
- The REST API Docs are automatically generated and provide more detailed information for each minor feature, including all fields and options.