Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Installing the automation services catalog worker

Red Hat Ansible Automation Platform 2.1

Extend your Red Hat Ansible Automation Platform to connect with automation services catalog on cloud.redhat.com using the Ansible Automation Platform 2.0 Setup or Setup Bundle Installers

Red Hat Customer Content Services

Abstract

Providing Feedback:
If you have a suggestion to improve this documentation, or find an error, please contact technical support at https://access.redhat.com to create an issue on the Ansible Automation Platform Jira project using the Docs component.

Preface
Copy link

You can extend Red Hat Ansible Automation Platform to connect with automation services catalog on cloud.redhat.com using the Ansible Automation Platform setup or setup bundle installer.

This is a Day 2 activity and requires setup of a service account that has write permissions on all basic resources/objects in automation controller: organizations, users, projects, job templates and inventories.

The Catalog worker requires a set of variables assigned to hosts in your Red Hat Ansible Automation Platform network. Running the Catalog worker will create an application and an application token, install the necessary packages, and start the service.

Making open source more inclusive
Copy link

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.

You can use the following instructions to extend your Red Hat Ansible Automation Platform to connect to {Catalog} hosted service on cloud.redhat.com.

1.1. Prerequisites
Copy link

  • Automation controller and any instance group nodes associated with an organization service account specified in /inventory must be running on a RHEL 8.4 virtual machine.
  • You have registered the RHEL 8.4 virtual machine with Red Hat Subscription Manager. Installation generates a certificate used to authenticate with cloud.redhat.com.
  • You have attached the Ansible Automation Platform SKU to the Catalog Worker node.
  • You have enabled SSH on the RHEL 8.4 virtual machine running the automation services catalog worker.
  • Automation controller with at least one organization configured, including inventories, projects and job templates.
  • A service account is created for each organization that has write permissions on all objects mentioned above. Application token is created when the installer is run and not required as a prerequisite.

1.2. Adding host variables to the installer
Copy link

Installing the automation services catalog worker requires adding host vars in the Red Hat Ansible Automation Platform installer used for installation parameters. The 'host_vars' files store parameter information for each host you specify. Refer to the parameters table below for all available and required parameters.

Expand
Table 1.1. Available host_vars parameters
ParameterRequired

servicescatalog_controller_hostname

 

servicescatalog_controller_name

 

servicescatalog_controller_user

Yes

servicescatalog_controller_password

Yes

servicescatalog_controller_validate_certs

 

servicescatalog_http_proxy

 

servicescatalog_https_proxy

 

servicescatalog_no_proxy

 

Procedure

  1. Navigate to the Ansible Automation Platform setup or setup bundle installer directory. 

    # cd ansible-automation-platform-setup-<latest>
    Copy to Clipboard Toggle word wrap

  2. Create a new directory called host_vars: 

    # mkdir host_vars
    Copy to Clipboard Toggle word wrap

  3. Create a file for each required host. Examples with parameters for two hosts are included below.

    1. Service account on localhost: 

      # touch finance
      Copy to Clipboard Toggle word wrap 
      ansible_connection: local

servicescatalog_controller_name: Finance

servicescatalog_controller_user: finance_sa
servicescatalog_controller_password: <password>
      Copy to Clipboard Toggle word wrap

    2. Service account on an additional host: 

      # touch marketing
      Copy to Clipboard Toggle word wrap 
      ansible_host: IP address
ansible_user: [User should have sudo access to install packages and write to system-level configuration files]
ansible_become: true

servicescatalog_controller_name: Marketing

servicescatalog_controller_user: marketing_sa
servicescatalog_controller_password: password
      Copy to Clipboard Toggle word wrap
  4. Save each file.

  5. Open the inventory file in the Ansible Automation Platform installer: 

    # vi inventory
    Copy to Clipboard Toggle word wrap

  6. Add the host_vars for each host under [servicescatalog_workers]: 

    [servicescatalog_workers]
finance
marketing
    Copy to Clipboard Toggle word wrap
  7. Save the inventory file.

1.3. Running the installer
Copy link

You can now proceed to run the installer.

  • Run the Ansible Automation Platform setup script: 

    # ./setup.sh
    Copy to Clipboard Toggle word wrap

Running the automation services catalog worker will create an application and an application token, install the necessary packages, connect to cloud.redhat.com, and start the service.

Verification

You can verify that the automation services catalog worker installed and connected to your automation service catalog, and that jobs ordered in automation service catalog run on automation controller.

Prerequisites

You are a Catalog Administrator and can create portfolios and add products to them.

  1. Log in to cloud.redhat.com
  2. Navigate to Ansible Automation Platform → Automation Services Catalog.
  3. Click Platforms.
  4. Locate the platforms associated with the hosts you created for your host_vars.
  5. Click on a platform.
  6. Verify that inventory and templates from your automation controller are included.

Legal Notice
Copy link

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.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat