Skip to main content
Agent Type:
Hybrid
Agent Platform:
Azure ✅
You can download and modify the Azure ARM/ACI template used to create the agent container app. 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 documentaton 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 Agent installation using an ARM template. Although modifying the template introduces an additional step to the container app 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 , follow the steps to create a new agent, with Azure as the cloud provider.
  2. On the Deployment tab of the Agent details page, click Download. 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.
Customizing the template to use pre-created managed identities and roles allows you to enforce strict permissions and rerun the template to create multiple agents in the same resource group. Note that each agent must be deployed into a separate subnet due to Azure limitations.
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 proceding.
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 Deployment tab of the Agent details page, click Launch. 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.