Skip to main content

File plugin for the Pulp Project

Project description

This is the pulp_file Plugin for Pulp Project 3.0+. This plugin replaces the ISO support in the pulp_rpm plugin for Pulp 2. This plugin uses the ChangeSet API to add and remove content from a repository.

All REST API examples bellow use httpie to perform the requests. The httpie commands below assume that the user executing the commands has a .netrc file in the home directory. The .netrc should have the following configuration:

machine localhost
login admin
password admin

If you configured the admin user with a different password, adjust the configuration accordingly. If you prefer to specify the username and password with each request, please see httpie documentation on how to do that.

This documentation makes use of the jq library to parse the json received from requests, in order to get the unique urls generated when objects are created. To follow this documentation as-is please install the jq library with:

$ sudo dnf install jq

Install pulpcore

Follow the installation instructions provided with pulpcore.

Users should install from either PyPI or source.

Install pulp-file from source

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

Install pulp-file From PyPI

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

Make and Run Migrations

pulp-manager makemigrations pulp_file
pulp-manager migrate pulp_file

Run Services

pulp-manager runserver
sudo systemctl restart pulp_resource_manager
sudo systemctl restart pulp_worker@1
sudo systemctl restart pulp_worker@2

Create a repository foo

$ http POST http://localhost:8000/pulp/api/v3/repositories/ name=foo

    "_href": "/pulp/api/v3/repositories/1/",

$ export REPO_HREF=$(http :8000/pulp/api/v3/repositories/ | jq -r '.results[] | select(.name == "foo") | ._href')

Create a new remote bar

$ http POST http://localhost:8000/pulp/api/v3/remotes/file/ name='bar' url=''

    "_href": "/pulp/api/v3/remotes/file/1/",

$ export REMOTE_HREF=$(http :8000/pulp/api/v3/remotes/file/ | jq -r '.results[] | select(.name == "bar") | ._href')

Sync repository foo using remote bar

$ http POST ':8000'$REMOTE_HREF'sync/' repository=$REPO_HREF mirror=True

Look at the new Repository Version created

$ http GET ':8000'$REPO_HREF'versions/1/'

    "_added_href": "/pulp/api/v3/repositories/1/versions/1/added_content/",
    "_content_href": "/pulp/api/v3/repositories/1/versions/1/content/",
    "_href": "/pulp/api/v3/repositories/1/versions/1/",
    "_removed_href": "/pulp/api/v3/repositories/1/versions/1/removed_content/",
    "content_summary": {
        "file": 3
    "created": "2018-02-23T20:29:54.499055Z",
    "number": 1

Upload foo.tar.gz to Pulp

Create an Artifact by uploading the file to Pulp.

$ http --form POST http://localhost:8000/pulp/api/v3/artifacts/ file@./foo.tar.gz

    "_href": "/pulp/api/v3/artifacts/1/",

Create file content from an Artifact

Create a content unit and point it to your artifact

$ http POST http://localhost:8000/pulp/api/v3/content/file/files/ relative_path=foo.tar.gz artifact="/pulp/api/v3/artifacts/1/"

    "_href": "/pulp/api/v3/content/file/files/1/",
    "artifact": "/pulp/api/v3/artifacts/1/",
    "relative_path": "foo.tar.gz",
    "type": "file"

$ export CONTENT_HREF=$(http :8000/pulp/api/v3/content/file/files/ | jq -r '.results[] | select(.relative_path == "foo.tar.gz") | ._href')

Add content to repository foo

$ http POST ':8000'$REPO_HREF'versions/' add_content_units:="[\"$CONTENT_HREF\"]"

Create a file Publisher

$ http POST http://localhost:8000/pulp/api/v3/publishers/file/ name=bar

    "_href": "/pulp/api/v3/publishers/file/1/",

$ export PUBLISHER_HREF=$(http :8000/pulp/api/v3/publishers/file/ | jq -r '.results[] | select(.name == "bar") | ._href')

Use the bar Publisher to create a Publication

$ http POST ':8000'$PUBLISHER_HREF'publish/' repository=$REPO_HREF

    "task": "/pulp/api/v3/tasks/fd4cbecd-6c6a-4197-9cbe-4e45b0516309/"

$ export PUBLICATION_HREF=$(http :8000/pulp/api/v3/publications/ | jq -r --arg PUBLISHER_HREF "$PUBLISHER_HREF" '.results[] | select(.publisher==$PUBLISHER_HREF) | ._href')

Create a Distribution for the Publication

$ http POST http://localhost:8000/pulp/api/v3/distributions/ name='baz' base_path='foo' publication=$PUBLICATION_HREF

    "_href": "/pulp/api/v3/distributions/1/",

Download test.iso from Pulp

$ http GET http://localhost:8000/pulp/content/foo/test.iso

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pulp_file-0.0.1b6-py3-none-any.whl (22.3 kB) Copy SHA256 hash SHA256 Wheel py3
pulp-file-0.0.1b6.tar.gz (22.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page