diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
commit | 8a754e0858d922e955e71b253c139e071ecec432 (patch) | |
tree | 527d16e74bfd1840c85efd675fdecad056c54107 /docs/docsite/rst/dev_guide/developing_collections.rst | |
parent | Initial commit. (diff) | |
download | ansible-core-upstream/2.14.3.tar.xz ansible-core-upstream/2.14.3.zip |
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | docs/docsite/rst/dev_guide/developing_collections.rst | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/docsite/rst/dev_guide/developing_collections.rst b/docs/docsite/rst/dev_guide/developing_collections.rst new file mode 100644 index 0000000..d3fb4f7 --- /dev/null +++ b/docs/docsite/rst/dev_guide/developing_collections.rst @@ -0,0 +1,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 |