Metadata-Version: 2.1
Name: pulp-ansible
Version: 0.2.0b10
Summary: Pulp plugin to manage Ansible content, e.g. roles
Home-page: https://github.com/pulp/pulp_ansible
Author: Pulp Ansible Plugin Project Developers
Author-email: pulp-dev@redhat.com
License: GPLv2+
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: galaxy-importer
Requires-Dist: packaging
Requires-Dist: pulpcore (<3.3,>=3.0)
Requires-Dist: PyYAML
Requires-Dist: semantic-version
Provides-Extra: test
Requires-Dist: coverage ; extra == 'test'
Requires-Dist: flake8 ; extra == 'test'
Requires-Dist: flake8-docstrings ; extra == 'test'
Requires-Dist: flake8-quotes ; extra == 'test'
Requires-Dist: flake8-tuple ; extra == 'test'
Requires-Dist: mock ; extra == 'test'
Requires-Dist: orionutils ; extra == 'test'
Requires-Dist: pulp-smash ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'

pulp_ansible
============

.. image:: https://api.travis-ci.org/pulp/pulp_ansible.svg
   :target: https://travis-ci.org/pulp/pulp_ansible

A Pulp plugin to support hosting ``Role`` and ``Collection`` Ansible content.

For more information, please see the `documentation <https://pulp-ansible.readthedocs.io/en/latest/>`_.


Collection Support
------------------

.. warning::

    The 'Collection' content type is currently in tech-preview. Breaking changes could be introduced
    in the future.

pulp_ansible can manage the `multi-role repository content <https://galaxy.ansible.com/docs/using/
installing.html#multi-role-repositories>`_ referred to as a `Collection`. The following features are
supported:

* `ansible-galaxy collection publish` - Upload a Collection to pulp_ansible for association with one or more
  repositories.
* `ansible-galaxy collection install` - Install a Collection from pulp_ansible.


Configuring Collection Support
------------------------------

You'll have to specify the protocol and hostname the pulp_ansible REST API is being served on. For
pulp_ansible to interact with `ansible-galaxy` correctly it needs the entire hostname. This is done
using the `ANSIBLE_HOSTNAME` setting in Pulp. For example if its serving with http on localhost it
would be::

    export PULP_ANSIBLE_API_HOSTNAME='http://localhost:24817'
    export PULP_ANSIBLE_CONTENT_HOSTNAME='http://localhost:24816/pulp/content'

or in your systemd environment::

    Environment="PULP_ANSIBLE_API_HOSTNAME=http://localhost:24817"
    Environment="PULP_ANSIBLE_CONTENT_HOSTNAME=http://localhost:24816/pulp/content"


