You can configure a SaltStack Config integration to access the SaltStack Config service and use SaltStack Config objects and actions in vRealize Automation.

With vRealize Automation SaltStack Config, you can provision, configure, and deploy software to your virtual machines at any scale using event-driven automation. You can also use SaltStack Config to define and enforce optimal, compliant software states across your entire environment.

You can only integrate vRealize Automation with an on-premises instance of SaltStack Config. Integrating vRealize Automation with SaltStack Config is unsupported

Installation

Before integrating SaltStack Config with vRealize Automation, you must first install it in your environment. See Installing and Configuring SaltStack Config for more information.

Considerations

Integrated SaltStack Config is available for vRealize Automation with the following conditions:

  • The SaltStack Config integration is associated to a specific host during installation.

  • Only one SaltStack Config integration is available per organization.

  • The vRealize Automation tenant can support many Salt masters. Salt masters can support multiple minions.

  • Before you can delete a SaltStack Config integration in vRealize Automation, you must delete any existing deployments that use the SaltStack Config integration.

Prerequisites

  • Verify that you have vRealize Automation administrator credentials and SaltStack Config administrator credentials (root level access).

    You need vRealize Automation administrator credentials and SaltStack Config administrator credentials (root level access) to create a SaltStack Config integration.

    You also need SaltStack Config administrator credentials to open and work in the SaltStack Config service itself.

    You use vRealize Automation credentials to access vRealize Automation and SaltStack Config credentials to access SaltStack Config.

    For information about SaltStack Config administrator credentials, see the Installing and Configuring SaltStack Config guide.

  • Verify that the Salt master you are using with the SaltStack Config integration contains the Master Plugin.

  • Verify that you have the SaltStack Config service administrator role in vRealize Automation. See What are the vRealize Automation user roles

  • Verify that you have the Cloud Assembly service administrator role in vRealize Automation. See Organization and service user roles in vRealize Automation.

Configure a SaltStack Config integration in vRealize Automation

After you install SaltStack Config for vRealize Automation, you can configure the integration in Cloud Assembly.

  1. In Cloud Assembly, select Infrastructure > Connections > Integrations, and click Add Integration.
  2. Select the SaltStack Config integration type.

    Integration types in Cloud Assembly

  3. Complete the form.

    Form to create a new integration in Cloud Assembly

    1. Enter a name for the integration.
    2. (Optional) Provide a description for the integration.
    3. Enter a hostname for the SaltStack Config server.
    4. Select the embedded-ABX-onprem running environment.
    5. Enter the SaltStack Config administrator user name and password used to access the specific host.
    6. Click Validate to confirm your administrator access to SaltStack Config.

      If validation fails, make sure you entered the correct hostname, user name, and password.

    7. Click Save.

Access your SaltStack Config integration

After you save your changes to the SaltStack Config integration point, you can open SaltStack Config.

  1. If you deployed SaltStack Config through vRealize Suite Lifecycle Manager, you can click the service tile from the vRealize Automation Service Console to open the integration and access the host.

    Note: If you do not see the service tile, ensure you have any Cloud Assembly service role assigned to you.
    SaltStack Config service tile

    If you did a stand-alone install of SaltStack Config, you can access the service using your SaltStack Config hostname.

  2. When prompted to log in to SaltStack Config, enter your SaltStack Config administrator user name and password.

If you need to make any changes to the integration, select Infrastructure > Connections > Integrations, select the available SaltStack Config integration tile, and click Open.

Note:

The hostname cannot be changed after you configure the integration. You can only edit the name, description, running environment, and credentials for the integration.

What's next

SaltStack Config is a stand-alone product that you can integrate with and use in vRealize Automation.