ansible/docs/docsite/rst/dev_guide/developing_collections.rst

48 lines
1.8 KiB
ReStructuredText

.. _developing_collections:
**********************
Developing collections
**********************
Collections are a distribution format for Ansible content. You can package and distribute playbooks, roles, modules, and plugins using collections. A typical collection addresses a set of related use cases. For example, the ``cisco.ios`` collection automates management of Cisco IOS devices.
You can create a collection and publish it to `Ansible Galaxy <https://galaxy.ansible.com>`_ or to a private Automation Hub instance. You can publish certified collections to the Red Hat Automation Hub, part of the Red Hat Ansible Automation Platform.
.. toctree::
:maxdepth: 2
:caption: Developing new collections
developing_collections_creating
developing_collections_shared
developing_collections_testing
developing_collections_distributing
.. toctree::
:maxdepth: 2
:caption: Working with existing collections
developing_collections_migrating
developing_collections_contributing
developing_collections_changelogs
.. toctree::
:maxdepth: 2
:caption: Collections references
developing_collections_structure
collections_galaxy_meta
For instructions on developing modules, see :ref:`developing_modules_general`.
.. seealso::
:ref:`collections`
Learn how to install and use collections in playbooks and roles
:ref:`contributing_maintained_collections`
Guidelines for contributing to selected collections
`Ansible Collections Overview and FAQ <https://github.com/ansible-collections/overview/blob/main/README.rst>`_
Current development status of community collections and FAQ
`Mailing List <https://groups.google.com/group/ansible-devel>`_
The development mailing list
`irc.freenode.net <http://irc.freenode.net>`_
#ansible IRC chat channel