Chapter 5. Frequently asked questions about Red Hat Ansible Certified Content
The following is a list of Frequently Asked Questions for the Red Hat Ansible Automation Platform Certification Program. If you have any questions regarding the following items, email ansiblepartners@redhat.com.
5.1. Why certify Ansible collections?
The Ansible certification program enables a shared statement of support for Red Hat Ansible Certified Content between Red Hat and the ecosystem partner. An end customer, experiencing trouble with Ansible and certified partner content, can open a support ticket, for example, a request for information, or a problem with Red Hat, and expect the ticket to be resolved by Red Hat and the ecosystem partner.
Red Hat offers go-to-market benefits for Certified Partners to grow market awareness, demand generation and collaborative selling.
Red Hat Ansible Certified Content Collections are distributed through Ansible automation hub (subscription required), a centralized repository for jointly supported Ansible Content. As a certified partner, publishing collections to Ansible automation hub provides end customers the power to manage how trusted automation content is used in their production environment with a well-known support life cycle.
For more information about getting started with certifying a solution, see Red Hat Partner Connect.
5.2. How do I get a collection certified?
Refer to Red Hat Partner Connect for the Ansible certification policy guide to understand how to certify your collection.
5.3. What’s the difference between Ansible Galaxy and Ansible automation hub?
Collections published to Ansible Galaxy are the latest content published by the Ansible community and have no joint support claims associated. Ansible Galaxy is the recommended frontend directory for the Ansible community accessing all content.
Collections published to Ansible automation hub are targeted for joint customers of Red Hat and selected partners. Customers need an Ansible subscription to access and download collections on Ansible automation hub. A certified collection means that Red Hat and partners have a strategic relationship in place and are ready to support joint customers, and may have had additional testing and validation done against them.
5.4. How do I request a namespace on Ansible Galaxy?
After you request a namespace through an Ansible Galaxy GitHub issue, send an email to ansiblepartners@redhat.com You must provide us with the GitHub username that you used to sign up on Ansible Galaxy, and you must have logged in at least once for the system to validate. When users are added as administrators of the namespace, then additional administrators can be added by the self-serve process.
5.5. Are there any restrictions for Ansible Galaxy namespace naming?
Collection namespaces must follow python module name convention. This means collections should have short, all lowercase names. You can use underscores in the collection name if it improves readability.
5.6. Are there any recommendations for collection naming?
A general suggestion is to create a collection with company_name.product
format. This way multiple products may have different collections under the company namespace.
5.7. How do I get a namespace on Ansible automation hub?
By default namespaces used on Ansible Galaxy are also used on Ansible automation hub by the Ansible partner team. For any queries and clarifications contact ansiblepartners@redhat.com.
5.8. How do I run sanity tests on my collection?
Ansible sanity tests are made up of scripts and tools used to perform static code analysis. The primary purpose of these tests is to enforce Ansible coding standards and requirements. Ansible collections must be in a specific path, such as the following example:
{...}/ansible_collections/{namespace}/{collection}/
Ensure that your collection is in that specific path, and that you have three directories:
-
An empty directory named
ansible_collections
- A directory for the namespace
- A directory for the collection itself
5.9. Does Ansible Galaxy house the source code for my collection?
No, Ansible Galaxy does not house the source for the collections. The actual collection source must be housed outside of Ansible Galaxy, for example, in GitHub. Ansible Galaxy contains the collection build tarball to publish the collection. You can include the link to the source for community users in the galaxy.yml
file contained in the collection. This shows users where they should go if they want to contribute to the collection or even file issues against it.
5.10. Does Red Hat officially support collections downloaded and installed from Ansible Galaxy
No, collections downloaded from Galaxy do not have any support claims associated and are 100% community supported. Users and contributors of any such collection must contact the collection developers directly.
5.11. How does the joint support agreement on certified collections work?
If a customer raises an issue with the Red Hat support team about a certified collection, Red Hat support assesses the issue and checks whether the problem exists within Ansible or Ansible usage. They also check whether the issue is with a certified collection. If there is a problem with the certified collection, support teams transfer the issue to the vendor owner of the certified collection through an agreed upon tool such as TSANet.
5.12. Can I create and certify a collection containing only Ansible Roles?
You can create and certify collections that contain only roles. Current testing requirements are focused on collections containing modules, and additional resources are currently in progress for testing collections only containing roles. Please contact ansiblepartners@redhat.com for more information.