cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

adding a collection local try section (#61626)

Browse source
This commit is contained in:
anshulbehl 2019-09-03 11:33:32 -04:00 committed by Sandra McCann
parent a10606484c
commit bfaa29303b
1 changed files with 17 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
docs/docsite/rst/dev_guide/collections_tech_preview.rst
View file

@ -238,6 +238,21 @@ a tarball of the built collection in the current directory which can be uploaded
This tarball is mainly intended to upload to Galaxy
as a distribution method, but you can use it directly to install the collection on target systems.
.. _trying_collection_locally:
Trying collection locally
-------------------------
You can try your collection locally by installing it from the tarball.
.. code-block:: bash
ansible-galaxy collection install my_namespace-my_collection-1.0.0.tar.gz -p ./collections/ansible_collections
You should use one of the values configured in :ref:`COLLECTIONS_PATHS` for your path. This is also where Ansible itself will expect to find collections when attempting to use them.
Then try to use the local collection inside a playbook, for more details see :ref:`Using collections <using_collections>`
.. _publishing_collections:
Publishing collections
@ -470,6 +485,8 @@ For operations where only one Galaxy server is used, i.e. ``publish``, ``info``,
collection. The install process will not search for a collection requirement in a different Galaxy instance.
.. _using_collections:
Using collections
=================