summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/dev_guide/developing_collections.rst
blob: d3fb4f7fcad8159b0cd55e9270655e6a0e65f6ca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
.. _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
   developing_collections_documenting

.. 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
   :ref:`communication_irc`
       How to join Ansible chat channels