Chapter 15. Managing Ansible content

Procedure

1. In the Satellite web UI, navigate to Content > Products.
2. Select the required product name.
3. In the Products window, select the name of a product that you want to create a repository for.
4. Click the Repositories tab, and then click New Repository.

5. In the Name field, enter a name for the repository.

   The Label field is populated automatically based on the name.

6. From the Type list, select ansible collection.

7. In the Upstream URL field, enter the URL for the upstream collections repository.

   The URL can be any Ansible Galaxy endpoint. For example, https://console.redhat.com/api/automation-hub/.

8. Optional: In the Requirements.yml field, you can specify the list of collections you want to sync from the endpoint, as well as their versions.

   If you do not specify the list of collections, everything from the endpoint will be synced.

   ---
   collections:
   - name: my_namespace.my_collection
     version: 1.2.3

   Copy to Clipboard Toggle word wrap

   For more information, see Installing roles and collections from the same requirements.yml file in the Galaxy User Guide.

9. Optional: Deselect Sync Dependencies if you do not want Satellite to resolve and synchronize dependencies. By default, Satellite synchronizes all required dependencies.

10. Authenticate:

    1. To sync Ansible collections from Private Automation Hub, enter your token in the Auth Token field.
    2. To sync Ansible collections from console.redhat.com, enter your token in the Auth Token field and enter your SSO URL in the Auth URL field.
    3. To sync Ansible collections from Satellite, leave both authentication fields blank.
11. Click Save.
12. Navigate to the Ansible Collections repository.
13. From the Select Action menu, select Sync Now.

Procedure

1. On the host, configure the ansible-galaxy client to use Satellite Server or Capsule Server as the Galaxy server. Add the required sections to an ansible.cfg file, for example:

   [galaxy]
   server_list = My_Library_Server, My_Promoted_CV_Server
   
   [galaxy_server.My_Library_Server]
   url = https://server.example.com/pulp_ansible/galaxy/My_Organization_Label/Library/custom/My_Product_Label/My_Repository_Label/api/
   
   [galaxy_server.My_Promoted_CV_Server]
   url = https://server.example.com/pulp_ansible/galaxy/My_Organization_Label/My_Lifecycle_Environment_Label/My_Content_View_Label/custom/My_Product_Label/My_Repository_Label/api/

   Copy to Clipboard Toggle word wrap

   Replace server.example.com with the fully qualified domain name of your Satellite Server or Capsule Server.

2. Install an Ansible Collection from your Galaxy server. For example:

   # ansible-galaxy collection install My_Namespace.My_Collection \
   --server My_Library_Server

   Copy to Clipboard Toggle word wrap