Skip to main content

Configuring Enterprise Runners to access remote Nodes

Configuring Enterprise Runners to access remote Nodes

Available in PagerDuty Process Automation Commercial products.

Enterprise Runnersopen in new window are a recent addition to the PagerDuty Process Automation and Runbook Automation architecture. They are primarily used as a method for orchestrating automation in secure, remote environments where direct access to infrastructure and services is restricted. This is accomplished by using a "reverse proxy" architecture: Runners regularly query (outbound only) the Process Automation Cluster (or Runbook Automation instance) for tasks. Runners are assigned to one or more Projects, and then Jobsopen in new window within those Projects can use the Runner to dispatch the Job steps to be executed through the Runner in the remote environment.

Example showing Runner architecture (Each remote Runner could be a Runner set)
When Runners are enabled for a job, the execution of Job steps will be delegated to a specific Runner for management. This model offers resiliency as multiple Runners could be enabled for a particular Project so that each Job can be assigned to a specific Runner during high usage windows.
To utilize Runners, there are a few steps to carry out:

System Configuration

  1. Enable Runners at the system levelopen in new window
    Though Runners will primarily be used and managed in the context of projects, a system admin does need to enable them initially.
  2. Create new Runners at the system levelopen in new window
    For each Runner, you will be prompted for three things:
    * A name
    Using clear naming can help with Runner management as the number of Runners increases.
    * Define one or more tags
    Tags determine which Runner set will execute which Jobs.
    * Associate Runners with Projects
    Each Runner must be associated with at least one Project in order to be used.

Runner Installation

  1. Install Runner software in remote networks for each Runner that has been createdopen in new window.
    Though Runners have been defined by this point, it is still necessary to install software in each of the remote locations.

Configure Jobs for Runners

  1. Add Runner tags to Jobsopen in new window
    New jobs will prompt authors to choose tags which represent Runners or Runner sets by tags. It is important to review existing Jobs to ensure that they have appropriate tags selected as well.
    Jobs are assigned to remote Runners based on tags. Jobs on nodes in the cluster’s local network can be handled through the Local Runner.


Advanced Runner Setup Optionsopen in new window
Runner Custom Loggingopen in new window
Runner FAQopen in new window