Create an Ansible Repository

To install or publish Ansible collections, creation of an Ansible repository is required. Check out Nexus Repository Management and Repository Types to learn more.

Ansible Proxy Repository

Use Nexus proxy repository when you want to download packages and centralize package caching of external dependencies. To learn more, check Proxy Repositories.

To create a new Ansible proxy repository, take the following steps:

1. Navigate to Settings → Repository → Repositories.
2. Select the Create repository button.
3. From the list of Recipes, select ansiblegalaxy (proxy).
4. In the form that appears, complete the required fields.
   • Repository Name, for example ansible-proxy
   • Remote storage URL, for example https://galaxy.ansible.com
   • Blob store
5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.
6. Select Create repository.

Ansible Hosted Repository

Use Nexus hosted repository when you want to publish and store your own internal artifacts and third party components, so they can be consumed via Nexus. To learn more, check Hosted Repositories.

To create a new Ansible hosted repository, take the following steps:

1. Navigate to Settings → Repository → Repositories.
2. Select the Create repository button.
3. From the list of Recipes, select ansiblegalaxy (hosted).
4. In the form that appears, complete the required fields.
   • Repository Name, for example ansible-hosted
   • Blob store
5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.
6. Select Create repository.

Tip

To upload packages using the UI, see Uploading Components.

Ansible Group Repository

Use Nexus group repository when you want to combine multiple other repositories (proxy, hosted, and other groups) and expose them through a single URL. To learn more, check Group Repositories.

To create a new Ansible group repository, take the following steps:

1. Navigate to Settings → Repository → Repositories.
2. Select the Create repository button.
3. From the list of Recipes, select ansiblegalaxy (group).
4. In the form that appears, complete the required fields.
   • Repository Name, for example ansible-group
   • Blob store
   • Member repositories in the desired order
5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.
6. Select Create repository.