Skip to main content
Version: Release 23.3

Run Release Remote Runner on Kubernetes cluster

Install Remote Runners using XL Kube​

Register Remote Runners​

It's important to note that during installation of Release Remote Runner using Helm, it's necessary to have Personal Access Token from the Release in order that it can register, to execute container-based tasks or scripts. To do this, you can use a personal access token (PAT) in Release to connect the Remote runners to Release. Make sure that you have generated PATs with the required permissions to register the runners and that they are stored securely.

Once installed and registered, the Remote runners should be visible on the Connections page in Release.

By registering Remote runners, you can ensure that your container-based tasks are properly managed and executed, and that you can easily monitor the number of registered and available runners through the Release UI.

Configure Release Remote Runner in Digital.ai Release​

You can view the configurations of Remote runner, by clicking Connections > Remote Job Runner.

By clicking edit button Release Remote Runner configuration screen is opened.

You can review or modify runner configuration:

  1. A title for the configuration in the Title field.
  2. The Runner name and version are auto-populated at a point the runner is registered. Fields Runner Name and Version are read-only.
  3. Select Enabled checkbox, to enable or disable the Release Remote Runner. By disabling Release Remote Runner, all processing on runner is paused until runner is enabled again.
  4. Enter the tags in the Capabilities field to tag the runners. This field is auto-populated. You can control which tasks a runner can run by defining specific tags. To add tags, enter the tag name and click the Add button.

Note: When a capability is added to a container task, that specific task is only sent to the Remote runner with the matching capability. For example, if the Remote runner has a capability called remote, then the similar capability called remote should be added in the container task for the task to be executed by the runner. Note: Capability remote-script is one that enables remote runner to run scripts besides Release tasks.

  1. The value in the Capacity field indicated the number of parallel job executors the remote- runner can run.
  2. Eviction Time indicates number of seconds after a idle job container will be evicted and slot would be emptied for a new executor. In case you don't want to plugin runners to be reused but only run once you should use eviction time set to 0. In case eviction time is greater than 0, plugin runner will wait for amount of seconds for next task (adequate for execution depending on capabilities and defined tasks on plugin).
  3. Select Encrypt Job Data checkbox, to encrypt the job data between the Digital.ai Release instance and the Remote runner. This is used to encrypt sensitive information.
  4. Public Key field is auto-populated during remote runner registration. Public key is used for encryption of the runner task and script data.
  5. Idle TTL in field Idle Time To Live is number of seconds before runner is removed from the Release configuration if it doesn't confirm aliveness (using SSE Ping). If you enter 0 runner will never be removed

Note: If Remote Runner is removed from release configuration and it re-registers no data is lost and processing would continue normally, because remote runner instance hold the reference to the original configuration (like name, version, key...)

  1. Available switch is automatic switch which indicates if the runner is sending alive confirmations or not.
  2. Click Save to save the changes.