diff --git a/docs/docsite/rst/dev_guide/developing_collections_distributing.rst b/docs/docsite/rst/dev_guide/developing_collections_distributing.rst index ba26b6d7a64..d36e8c012fb 100644 --- a/docs/docsite/rst/dev_guide/developing_collections_distributing.rst +++ b/docs/docsite/rst/dev_guide/developing_collections_distributing.rst @@ -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 `_ page and click :guilabel:`API Key`. * For Automation Hub, go to `the token page `_ 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= +.. _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`` ---------------------------------------------