Run Command

This job provisions/updates a script on a VM and immediately begins to execute it.

Orchestra supports the following actions on Azure VMs:

• provisioning and executing a script on a running VM in Azure

  • Windows and Linux platforms both supported

  • x64 and ARM64 architectures both supported (Azure VM only supports x64 for the Windows platform)

There are important cases to consider:

• scripts running on ARM64 architectures have a maximum running time of 90 minutes, and only one script can be executing on one machine at any given time. They also contain a delay of 20 seconds before beginning their execution

• any STDERR logs from a script running on a ARM64 machine will result in the Orchestra Task failing

• VMs must be in running state - Orchestra does not start and stop the VM

• the output from the script is not shown in the Orchestra UI or stored in our system

Each script can be configured with optional parameters. These must be a list of JSON objects such as:

[
  {
    "name": "foo",
    "value": "bar",
  },
  ...
]

These parameters will automatically be enriched with a further object that is added by Orchestra:

{
  "name": "ORCHESTRA_TASK_RUN_ID"
  "value": "<random_uuid>"
}

Parameters and setup

Name	Data type	Restrictions	Example
Resource group	String	N.A.	company-resource-group
Virtual machine name	String	N.A.	company-vm
Virtual machine architecture	String	One of x64 or ARM64	x64
Operating system	String	One of Linux or Windows	Linux
Script	String	N.A.	python3 /home/azureuser/script.py
Location	String	Must be a valid location in Azure	West Europe
Script timeout (seconds)	Integer	Optional - only used when the virtual machine architecture is x64	300
Parameters	list(JSON)	Optional - must be a list of JSON objects	[ { "name": "foo", "value": "bar", }, ... ]
Subscription ID	UUID	Optional - will override the default Subscription ID configured on the connection being used.	<random_uuid>