Pulp plugin to manage Ansible content, e.g. roles
Project description
This is the pulp_ansible repository which provides Pulp with the ability to manage Ansible content e.g. Roles.
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 adminIf 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 for pulpcore.
Install pulp-ansible from source
sudo -u pulp -i
source ~/pulpvenv/bin/activate
git clone https://github.com/pulp/pulp_ansible.git
cd pulp_ansible
pip install -e .Install pulp-ansible From PyPI
sudo -u pulp -i
source ~/pulpvenv/bin/activate
pip install pulp-ansibleMake and Run Migrations
pulp-manager makemigrations pulp_ansible
pulp-manager migrate pulp_ansibleRun Services
pulp-manager runserver
sudo systemctl restart pulp_resource_manager
sudo systemctl restart pulp_worker@1
sudo systemctl restart pulp_worker@2Create a repository foo
$ http POST http://localhost:8000/pulp/api/v3/repositories/ name=foo
{
"_href": "http://localhost:8000/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 :8000/pulp/api/v3/remotes/ansible/ name=bar url='https://galaxy.ansible.com/api/v1/roles/?namespace__name=elastic'
{
"_href": "http://localhost:8000/pulp/api/v3/remotes/ansible/1/",
...
}$ export REMOTE_HREF=$(http :8000/pulp/api/v3/remotes/ansible/ | jq -r '.results[] | select(.name == "bar") | ._href')
Sync repository foo using remote bar
$ http POST ':8000'$REMOTE_HREF'sync/' repository=$REPO_HREF
Look at the new Repository Version created
$ http GET ':8000'$REPO_HREF'versions/1/'
{
"_added_href": "http://localhost:8000/pulp/api/v3/repositories/1/versions/1/added_content/",
"_content_href": "http://localhost:8000/pulp/api/v3/repositories/1/versions/1/content/",
"_href": "http://localhost:8000/pulp/api/v3/repositories/1/versions/1/",
"_removed_href": "http://localhost:8000/pulp/api/v3/repositories/1/versions/1/removed_content/",
"content_summary": {
"ansible": 11
},
"created": "2018-03-12T19:23:31.000923Z",
"number": 1
}Upload a Role to Pulp
Download a role version.
curl -L https://github.com/pulp/ansible-pulp3/archive/master.tar.gz -o pulp.tar.gz
Create an Artifact by uploading the role version tarball to Pulp.
$ export ARTIFACT_HREF=$(http --form POST http://localhost:8000/pulp/api/v3/artifacts/ file@pulp.tar.gz | jq -r '._href')
Create a Role content unit
Create an Ansible role in Pulp.
$ export ROLE_HREF=$(http http://localhost:8000/pulp/api/v3/content/ansible/roles/ namespace=pulp name=pulp | jq -r '._href')
Create a role version from the Role and Artifact
Create a content unit and point it to your Artifact and Role
$ export CONTENT_HREF=$(http POST ':8000'${ROLE_HREF}versions/ version=0.0.1 artifact=$ARTIFACT_HREF | jq -r '._href')
Add content to repository foo
$ http POST ':8000'$REPO_HREF'versions/' add_content_units:="[\"$CONTENT_HREF\"]"
Create an Ansible publisher
$ http POST http://localhost:8000/pulp/api/v3/publishers/ansible/ name=bar
{
"_href": "http://localhost:8000/pulp/api/v3/publishers/ansible/bar/",
...
}$ export PUBLISHER_HREF=$(http :8000/pulp/api/v3/publishers/ansible/ | jq -r '.results[] | select(.name == "bar") | ._href')
Use the bar Publisher to create a Publication
$ http POST ':8000'$PUBLISHER_HREF'publish/' repository=$REPO_HREF
{
"_href": "http://localhost:8000/pulp/api/v3/tasks/fd4cbecd-6c6a-4197-9cbe-4e45b0516309/",
"task_id": "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='dev' publication=$PUBLICATION_HREF
{
"_href": "http://localhost:8000/pulp/api/v3/distributions/1/",
...
}Install the ansible kubernetes Role
Using a direct path
To install your role using a link to the direct tarball, do the following:
$ ansible-galaxy install http://localhost:8000/pulp/content/dev/elastic/elasticsearch/6.2.4.tar.gz,,elastic.elasticsearch
Using the Pulp Galaxy API
Alternatively, Pulp offers a built-in Galaxy API. To use this, set up your distribution in your ansible config (e.g. ~/.ansible.cfg or /etc/ansible/ansible.cfg):
[galaxy]
server: http://localhost:8000/pulp_ansible/galaxy/devThen install your role using namespace and name:
$ ansible-galaxy install elastic.elasticsearch
- downloading role 'elasticsearch', owned by elastic
- downloading role from http://localhost:8000/pulp/content/dev/elastic/elasticsearch/6.2.4.tar.gz
- extracting elastic.elasticsearch to /home/vagrant/.ansible/roles/elastic.elasticsearch
- elastic.elasticsearch (6.2.4) was installed successfullyRelease history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pulp-ansible-0.1.0rc1.tar.gz.
File metadata
- Download URL: pulp-ansible-0.1.0rc1.tar.gz
- Upload date:
- Size: 13.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ea845bbc5f60d89a820aa955cb10029ae4c1c3553e1d2fced5b2b1016f5b94bb |
|
| MD5 | d783637c8d12e7307d3c51cbb3bc239a |
|
| BLAKE2b-256 | 80a29b9e0873e5e5827f8773719ca9cae613ddd0b8f114222c9521bfa8d3f86f |
File details
Details for the file pulp_ansible-0.1.0rc1-py3-none-any.whl.
File metadata
- Download URL: pulp_ansible-0.1.0rc1-py3-none-any.whl
- Upload date:
- Size: 7.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c9cdeb331a410fd9bac4313ee38e2a68f93cc9f5377969c371be985ec0985850 |
|
| MD5 | 58a77d21e92081312dd20cba5d1b6597 |
|
| BLAKE2b-256 | b31c62afe2b2a442d7864509218ac37a38cf374476828c0940e313a367fcf9dc |
