README.rst

pulp_gem Plugin

This is the pulp_gem Plugin for Pulp Project 3.0+. This plugin adds importers and distributors for rubygems.

All REST API examples below 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.

Install pulp-gem from source

1. sudo -u pulp -i
2. source ~/pulpvenv/bin/activate
3. git clone https://github.com/ATIX-AG/pulp_gem
4. cd pulp_gem
5. python setup.py develop
6. django-admin makemigrations pulp_gem
7. django-admin migrate pulp_gem
8. django-admin runserver 24817
9. gunicorn pulpcore.content:server --bind 'localhost:24816' --worker-class 'aiohttp.GunicornWebWorker' -w 2
10. sudo systemctl restart pulpcore-resource-manager
11. sudo systemctl restart pulpcore-worker@1
12. sudo systemctl restart pulpcore-worker@2

Install pulp-gem From PyPI

1. sudo -u pulp -i
2. source ~/pulpvenv/bin/activate
3. pip install pulp-gem
4. django-admin makemigrations pulp_gem
5. django-admin migrate pulp_gem
6. django-admin runserver 24817
7. gunicorn pulpcore.content:server --bind 'localhost:24816' --worker-class 'aiohttp.GunicornWebWorker' -w 2
8. sudo systemctl restart pulpcore-resource-manager
9. sudo systemctl restart pulpcore-worker@1
10. sudo systemctl restart pulpcore-worker@2

Create a repository foo

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

{
    "pulp_href": "/pulp/api/v3/repositories/1/",
    "...": "..."
}

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

Add a remote

$ http POST http://localhost:24817/pulp/api/v3/remotes/gem/ name='bar' url='https://rubygems.org/' policy='streamed'

{
    "pulp_href": "/pulp/api/v3/remotes/gem/1/",
    "..." : "..."
}

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

Sync repository foo using remote bar

$ http POST ':24817'${REMOTE_HREF}'sync/' repository=$REPO_HREF

Upload foo-0.0.1.gem to Pulp

Create an Artifact by uploading the gemfile to Pulp.

$ http --form POST http://localhost:24817/pulp/api/v3/artifacts/ file@./foo-0.0.1.gem

{
    "pulp_href": "/pulp/api/v3/artifacts/1/",
    "...": "..."
}

You need to upload the corresponding foo-0.0.1.gemspec.rz in the same way.

Create gem content from an Artifact

$ http POST http://localhost:24817/pulp/api/v3/content/gem/gems/ _artifact="/pulp/api/v3/artifacts/1/"

{
    "pulp_href": "/pulp/api/v3/content/gem/gems/1/",
    "_artifacts": {
        "gems/foo-0.0.1.gem":"/pulp/api/v3/artifacts/1/",
        "quick/Marshal.4.8/foo-0.0.1.gemspec.rz":"/pulp/api/v3/artifacts/2/"
    },
    "name": "foo",
    "notes": {},
    "type": "gem",
    "version": "0.0.1"
}

$ export CONTENT_HREF=$(http :24817/pulp/api/v3/content/gem/gems/ | jq -r '.results[] | select(.name == "foo") | .pulp_href')