Uploading content to Red Hat Automation Hub

Red Hat Ansible Automation Platform 2.4

Manage your collections with Automation Hub

Red Hat Customer Content Services

Abstract

This guide shows how to upload and delete collections using the automation hub.

Preface

Automation hub distributes certified, supported collections from partners to customers. Each collection includes content such as modules, roles, plugins and documentation. The first time you upload a collection to automation hub, our Partner Engineering team will start reviewing it for certification.

You can manage your collections by uploading or deleting collections using the automation hub user interface or the ansible-galaxy client.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Providing feedback on Red Hat documentation

We appreciate your feedback on our technical content and encourage you to tell us what you think. If you’d like to add comments, provide insights, correct a typo, or even ask a question, you can do so directly in the documentation.

Note

You must have a Red Hat account and be logged in to the customer portal.

To submit documentation feedback from the customer portal, do the following:

  1. Select the Multi-page HTML format.
  2. Click the Feedback button at the top-right of the document.
  3. Highlight the section of text where you want to provide feedback.
  4. Click the Add Feedback dialog next to your highlighted text.
  5. Enter your feedback in the text box on the right of the page and then click Submit.

We automatically create a tracking issue each time you submit feedback. Open the link that is displayed after you click Submit and start watching the issue or add more comments.

Chapter 1. Uploading a collection to automation hub

Prerequisites

  • You have configured the ansible-galaxy client for Red Hat Automation Hub.
  • You have at least one namespace.
  • You have run all content through ansible-test sanity.
  • You are a Red Hat Connect Partner. Learn more at Red Hat Partner Connect.

Procedure

To upload your collection using the Automation Hub user interface:

  1. Log in to Red Hat Ansible Automation platform.
  2. Navigate to Automation Hub → My Namespaces.
  3. Click a namespace.
  4. Click Upload collection.
  5. In the New collection modal, click Select file. Locate the file on your system.
  6. Click Upload.

To upload a collection using the ansible-galaxy client, enter the following command: 

ansible-galaxy collection publish path/to/my_namespace-my_collection-1.0.0.tar.gz --api-key=SECRET

Once uploaded, your collections will enter the partner certification process. Our Partner Engineering team will contact you with the certification status of your collection.

Chapter 2. Deleting a collection on automation hub

You can further manage your collections by deleting unwanted collections, provided that the collection is not dependent on other collections. Click the Dependencies tab on a collection to see a list of other collections that uses the current collection.

Prerequisites

  • The collection being deleted does not have dependencies with other collections.
  • You have Delete Collections permissions

Procedure

  1. Log in to Red Hat Ansible Automation Platform.
  2. Navigate to Automation Hub → Collections.
  3. Click a collection to delete.

  4. Click the More Actions icon ⋮ then select an option:

    1. Delete entire collection to delete all versions in this collection.

    2. Delete version [number] to delete the current version of this collection. You can change versions using the Version dropdown menu.

      Note

      If the selected collection has any dependencies with other collections, these actions will be unavailable to you until you delete those dependencies. Click the Dependencies tab to see a list of dependencies to delete before you proceed.

  5. When the confirmation window appears, verify that the collection or version number is correct, then select Delete.

Legal Notice

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.