Using Ansible plug-ins for Red Hat Developer Hub

Procedure:

1. Log in to your Red Hat Developer Hub UI.
2. Click the Ansible A icon in the Red Hat Developer Hub navigation panel.
3. Navigate to the Overview page.
4. Click Create.
5. Click Create Ansible Git Project. The Available Templates page opens.
6. Click Create Ansible Playbook project.

7. In the Create Ansible Playbook Project page, enter information for your new project in the form.

   You can see sample values for this form in the Example project.

   Field	Description
   Source code repository organization name or username	The name of your source code repository username or organization name
   Playbook repository name	The name of your new Git repository
   Playbook description (Optional)	A description of the new playbook project
   Playbook project’s collection namespace	The new playbook Git project creates an example collection folder for you. Enter a value for the collection namespace.
   Playbook project’s collection name	The name of the collection
   Catalog Owner Name	The name of the Developer Hub catalog item owner. This is a Red Hat Developer Hub field.
   Source code repository organization name or username	The name of your source code repository username or organization name
   Playbook repository name	The name of your new Git repository
   Playbook description (Optional)	A description of the new playbook project
   System (Optional)	This is a Red Hat Developer Hub field

   Note

   Collection namespaces must follow Python module naming conventions. Collections must have short, all lowercase names. You can use underscores in the collection name if it improves readability.

   For more information, see the Ansible Collection naming conventions documentation.

8. Click Review.

Procedure

1. The Ansible plug-ins provide a link to Ansible Automation Platform.
2. Log in to your Red Hat Developer Hub UI.
3. Click the Ansible A icon in the Red Hat Developer Hub navigation panel.

4. Click Operate to display a link to your Ansible Automation Platform instance.

   If automation controller was not included in your plug-in installation, a link to the product feature page is displayed.

5. Click Go to Ansible Automation Platform to open your platform instance in a new browser tab.

   Alternatively, if your platform instance was not configured during the Ansible plug-in installation, navigate to your automation controller instance in a browser and log in.

6. Log in to automation controller.
7. Create a project in Ansible Automation Platform for the GitHub repository where you stored your playbook project. Refer to the Projects chapter of the Automation controller user guide.
8. Create a job template that uses a playbook from the project that you created. Refer to the Job Templates chapter of the Automation controller user guide.

1. Click the Ansible A icon in the Red Hat Developer Hub navigation panel.
2. Click Learn and select the Getting Started with Ansible Playbooks learning path. This redirects you to the Red Hat Developer website.
3. If you are prompted to log in, create a Red Hat Developer account, or enter your details.
4. Complete the learning path.

1. Click on the Ansible A icon in the Red Hat Developer Hub navigation panel.
2. Click Discover existing collections.

3. Click Go to Automation Hub.

   • If private automation hub has been configured in the Ansible plug-ins, you are redirected to your PrivateHubName instance.
   • If private automation hub has not been configured in the Ansible plug-ins installation configuration, you will be redirected to the Red Hat Hybrid Console (RHCC) automation hub.

   In this example, you are redirected to the RHCC automation hub.

4. If you are prompted to log in, provide your Red Hat Customer Portal credentials.

5. Filter the collections with the rhel firewall keywords.

   The search returns the rhel_system_roles collection.

1. Click the Ansible A icon in the Red Hat Developer Hub navigation panel.
2. From the Create dropdown menu on the landing page, select Create Ansible Git Project.
3. Click Choose in the Create Ansible Playbook Project software template.
4. Fill in the following information in the Create Ansible Playbook Project page:

5. Click Review.
6. Click Create to provision your new playbook project.
7. Click Open in catalog to view your project.

1. In your Dev Spaces instance, click File → New File.
2. Enter firewall.yml for the filename and click OK to save it in the root directory.

3. Add the following lines to your firewall.yml file:

   ---
   - name: Open HTTPS and SSH on firewall
     hosts: rhel
     become: true
     tasks:
       - name: Use rhel system roles to allow https and ssh traffic
         vars:
           firewall:
             - service: https
               state: enabled
               permanent: true
               immediate: true
               zone: public
             - service: ssh
               state: enabled
               permanent: true
               immediate: true
               zone: public
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.firewall