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.11+ must be installed on the same machine that is running pulpcore-worker processes.

The systemd unit file for pulpcore-worker processes needs to add /usr/bin/ to the PATH. The user which pulpcore-worker runs as needs to be able to sudo without a password.