Skip to content

Download and amend the Azure ARM template

Private preview

You can download and modify the Azure ARM 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 the Data Productivity Cloud, follow the steps to create a new agent, with Azure as the cloud provider.
  2. On the Agent details screen, click the Download button in the Install using ARM section. This will download the ARM template to your browser's default download location, as a file named arm-template.json.
  3. Edit the template using your preferred text editor.

Warning

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 Agent 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.