Pulp Docker images

Pulp installation consists of 4 containers:

• pulp-api
• pulp-content
• pulp-resource-manager
• pulp-worker

All of these images use pulp-core as a base image.

Configuration

To run and configure Pulp, you have 2 options:

1. Export PULP_SETTINGS to location with your configuration file and manage it as host path od Kubernetes configmap. Pulp is using Dynaconf so you can use various formats.
2. Use environment variables entirely to configure Pulp, we are going to use this option.

Configuration options

• PULP_SECRET_KEY

  import random
  
  chars = 'abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(-_=+)'
  print(''.join(random.choice(chars) for i in range(50)))
  

• PULP_DATABASES__default__ENGINE (defaults to django.db.backends.postgresql_psycopg2)

• PULP_DATABASES__default__USER (defaults to pulp)

• PULP_DATABASES__default__PASSWORD

• PULP_DATABASES__default__NAME (defaults to pulp)

• PULP_DATABASES__default__HOST

• PULP_REDIS_URL (eg. redis://redis.pulp.svc.cluster.local:6379/1)

• PULP_ADMIN_PASSWORD

• CONTENT_ORIGIN - pointer to content service (eg. https://pulp.example.com:24816)

• CONTENT_PATH_PREFIX - defaults to /pulp/content/

Installation

Volumes

You need to provide /var/lib/pulp or at least /var/lib/pulp/artifacts as a persistent shared volume across all pulp containers.

Don't forget to ensure correct permissions (chown 995:995).

If you don't want to use shared volume, use alternative backend to django-storages, eg. AWS S3 or Azure Blob Storage.

First run

pulp-api entrypoint will automatically handle database upgrades by running

django-admin migrate --noinput

However you should set admin password on your own by exec in pulp-api container and running following command. Or set PULP_ADMIN_PASSWORD variable.

django-admin reset-admin-password --password <yoursecretpassword>

Development

To deploy pulp locally for development and testing purposes, use docker-compose:

mkdir -p .volume/pulp && chown 995:995 .volume/pulp
make images
PULP_TEST=1 docker-compose up

Then you can access Pulp on http://localhost:24817/pulp/api/v3/