|
|
|
@ -15,6 +15,8 @@ Distributing collections involves three major steps:
|
|
|
|
|
:local:
|
|
|
|
|
:depth: 2
|
|
|
|
|
|
|
|
|
|
.. _config_distribution_server:
|
|
|
|
|
|
|
|
|
|
Configuring your distribution server or servers
|
|
|
|
|
================================================
|
|
|
|
|
|
|
|
|
@ -22,6 +24,8 @@ Configuring your distribution server or servers
|
|
|
|
|
2. Get an API token for each distribution server you want to use.
|
|
|
|
|
3. Specify the API token for each distribution server you want to use.
|
|
|
|
|
|
|
|
|
|
.. _get_namespace:
|
|
|
|
|
|
|
|
|
|
Getting a namespace
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
@ -42,6 +46,8 @@ To get your API token:
|
|
|
|
|
* For Galaxy, go to the `Galaxy profile preferences <https://galaxy.ansible.com/me/preferences>`_ page and click :guilabel:`API Key`.
|
|
|
|
|
* For Automation Hub, go to `the token page <https://cloud.redhat.com/ansible/automation-hub/token/>`_ and click :guilabel:`Load token`.
|
|
|
|
|
|
|
|
|
|
.. _galaxy_specify_token:
|
|
|
|
|
|
|
|
|
|
Specifying your API token
|
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
|
@ -50,6 +56,8 @@ Once you have retrieved your API token, you can specify the correct token for ea
|
|
|
|
|
* Pass the token to the ``ansible-galaxy`` command using the ``--token``.
|
|
|
|
|
* Configure the token within a Galaxy server list in your :file:`ansible.cfg` file.
|
|
|
|
|
|
|
|
|
|
.. _galaxy_use_token_arg:
|
|
|
|
|
|
|
|
|
|
Specifying your API token with the ``--token`` argument
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
@ -59,6 +67,8 @@ You can use the ``--token`` argument with the ``ansible-galaxy`` command (in con
|
|
|
|
|
|
|
|
|
|
ansible-galaxy collection publish ./geerlingguy-collection-1.2.3.tar.gz --token=<key goes here>
|
|
|
|
|
|
|
|
|
|
.. _galaxy_token_ansible_cfg:
|
|
|
|
|
|
|
|
|
|
Specifying your API token with a Galaxy server list
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
@ -189,6 +199,8 @@ You can also test a version of your collection in development by installing it f
|
|
|
|
|
|
|
|
|
|
.. include:: ../shared_snippets/installing_collections_git_repo.txt
|
|
|
|
|
|
|
|
|
|
.. _publish_collection:
|
|
|
|
|
|
|
|
|
|
Publishing a collection
|
|
|
|
|
=======================
|
|
|
|
|
|
|
|
|
@ -198,6 +210,8 @@ Each time you add features or make changes to your collection, you must create a
|
|
|
|
|
|
|
|
|
|
.. _upload_collection_ansible_galaxy:
|
|
|
|
|
|
|
|
|
|
.. _publish_collection_galaxy_cmd:
|
|
|
|
|
|
|
|
|
|
Publish a collection using ``ansible-galaxy``
|
|
|
|
|
---------------------------------------------
|
|
|
|
|
|
|
|
|
|