Metadata-Version: 2.4
Name: pulp-ansible
Version: 0.28.0
Summary: Pulp plugin to manage Ansible content, e.g. roles
Author-email: Pulp Ansible Plugin Project Developers <pulp-dev@redhat.com>
Project-URL: Homepage, https://pulpproject.org
Project-URL: Documentation, https://pulpproject.org/pulp_ansible/
Project-URL: Repository, https://github.com/pulp/pulp_ansible
Project-URL: Bug Tracker, https://github.com/pulp/pulp_ansible/issues
Project-URL: Changelog, https://pulpproject.org/pulp_ansible/changes/
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
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: galaxy_importer<0.5,>=0.4.27
Requires-Dist: GitPython<3.2,>=3.1.24
Requires-Dist: jsonschema<4.26,>=4.9
Requires-Dist: Pillow<11.4,>=10.3
Requires-Dist: pulpcore<3.100,>=3.63.0
Requires-Dist: PyYAML<7.0,>=6.0.2
Requires-Dist: semantic_version<2.11,>=2.9
Dynamic: license-file

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

.. figure:: https://github.com/pulp/pulp_ansible/actions/workflows/nightly.yml/badge.svg?branch=main
   :alt: Ansible Nightly CI/CD

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

For more information, please see the `documentation <https://docs.pulpproject.org/pulp_ansible/>`_.


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"


How to File an Issue
--------------------

`New pulp_ansible issue <https://github.com/pulp/pulp_ansible/issues/new>`_.

.. warning::
  Is this security related? If so, please follow the `Security Disclosures <https://docs.pulpproject.org/pulpcore/bugs-features.html#security-bugs>`_ procedure.
