Skip to main content
You can download and modify the Azure ARM/ACI template used to create the Streaming runner container instance. The template is a collection of parameters in JSON format, following the standard ARM template specification. Read Understand the structure and syntax of ARM templates in the Azure documentation for further details. The parameters held in the template correspond exactly to the fields that you can edit on the Custom deployment screen, as described in Streaming runner installation on Azure. Although modifying the template introduces an additional step to the container instance creation process and requires some additional technical knowledge, you may find this method advantageous for a number of reasons. For example, you can reuse the modified template to create additional agents that you know will have a consistent configuration.

Download and edit the template

  1. In Maia, follow the steps to create a new Streaming runner, with Azure as the cloud provider.
  2. On the Runner details screen, click the Download button in the Install using ARM section. This will download the ARM/ACI template to your browser’s default download location, as a file named arm-template.json.
  3. Edit the template using your preferred text editor.
Entering invalid parameters, or deviating from the expected format of the JSON file, will likely cause your template installation to fail. Be sure you understand the implications of your edits before proceeding.
Once your edits are finished, you can use the edited template in Azure to deploy the agent, as described in the following section.

Deploy the agent from the template

  1. On the Runner details screen, click the Launch button in the Install using ARM section. This will open the Azure portal at the Custom deployment screen, in a new browser tab.
  2. Click Edit template.
  3. Copy the text from the downloaded template file you have edited, and paste it into the Edit template screen, overwriting the JSON data already there.
  4. This will populate the Custom deployment screen with values from your edited template. You can modify these further if you wish, though this shouldn’t be necessary if you have made all the required changes in your template.
  5. Click Review & Create.