Rundeck

From Hornbill
Jump to navigation Jump to search

Home > Integration > Business Process Automation & Orchestration > Hornbill iBridge > Rundeck

Rundeck-logotype-512.png

Introduction

Rundeck is an IT operations management process automation platform.

Execute jobs on your Rundeck instance, and read back execution details to monitor the status of those jobs.

As Rundeck is an on-premise platform, your Rundeck instance will need to be accessible outside of your network for the Hornbill integrations to function.

Related Articles

KeySafe Configuration

Rundeck api key.png

In order to integrate with Rundeck, you will first need to configure, and securely store the authentication credentials for the Rundeck Account/s you want to use with the Hornbill App.

Configure your Rundeck account authentication in KeySafe in order to use the Rundeck options.

In the admin console > System > Security > KeySafe

  • Click on +
  • In the Type field, select API Key
  • Give the API Key a title (this is the name/identifier for the Rundeck account as you will see it when using the Integration Call node in your business process)
  • Optionally add a description
  • The API Key field should be populated with an API Token that was generated against a user profile on your Rundeck instance
  • The API Endpoint field should be populated with the internet-accessible API Endpoint URL of your Rundeck instance, including the port number (default of 4440)
  • Click Create Key to save

Managing Rundeck Configurations

  • Use KeySafe to create, store and enable integrations with multiple Rundeck accounts for use in your business processes

Business Process

Options (Methods)

Once you have your Rundeck account authorised, you're all set to use it with the Integration Call in your business processes. The following options are now available for you to use with Rundeck:

  • Run Job: This integration type takes a Job ID (mandatory) and an array of options (optional) as its inputs, and executes the job on your Rundeck instance, before returning:
    • The execution ID
    • The execution status
    • The URL of the execution record in your Rundeck instance
  • Get Job Execution Details: This in integration type takes an Execution ID (mandatory) as its input parameter, and returns various data about the execution, including its status and start & end date/times.

Read more about using the Integration Call from the Related Articles section, and learn how to work with input and output parameters for each of the Rundeck options.