User Setup

Install pulpcore

Follow the installation instructions provided with pulpcore.

Install plugin

This document assumes that you have installed pulpcore into a the virtual environment pulpvenv.

Users should install from either PyPI or source.

From PyPI

sudo -u pulp -i
source ~/pulpvenv/bin/activate
pip install pulp-container

Install pulp_container from source

sudo -u pulp -i
source ~/pulpvenv/bin/activate
cd pulp_container
pip install -e .

Make and Run Migrations

django-admin migrate container

Configure Required Settings

The plugin expects to have defined additional settings. These settings are required if a user wants to use the token authentication while serving content, see Registry Token Authentication.

Run Services

django-admin runserver 24817
gunicorn pulpcore.content:server --bind 'localhost:24816' --worker-class 'aiohttp.GunicornWebWorker' -w 2
sudo systemctl restart pulpcore-resource-manager
sudo systemctl restart pulpcore-worker@1
sudo systemctl restart pulpcore-worker@2

Enable OCI Container Image building

Pulp container plugin can be used to build an OCI format image from a Containerfile. The plugin uses buildah to build the container image. Buildah 1.14+ must be installed on the same machine that is running pulpcore-worker processes.

The pulpcore-worker processes needs to have /usr/bin/ in its PATH. The user that is running pulpcore-worker process needs to be able to manage subordinate user ids and group ids. The range of subordinate user ids is specified in /etc/subuid and the range of subordinate group ids is specified in /etc/subgid. More details can be found in buildah documentation.