Azure Citadel
  • Blogs

  • ARM
  • Azure Arc
    • Overview
    • Azure Arc-enabled Servers
      • Prereqs
      • Scenario
      • Hack Overview
      • Azure Landing Zone
      • Arc Pilot resource group
      • Azure Monitoring Agent
      • Additional policy assignments
      • Access your on prem VMs
      • Create onboarding scripts
      • Onboarding using scripts
      • Inventory
      • Monitoring
      • SSH
      • Windows Admin Center
      • Governance
      • Custom Script Extension
      • Key Vault Extension
      • Managed Identity
    • Azure Arc-enabled Kubernetes
      • Prereqs
      • Background
      • Deploy Cluster
      • Connect to Arc
      • Enable GitOps
      • Deploy Application
      • Enable Azure AD
      • Enforce Policy
      • Enable Monitoring
      • Enable Azure Defender
      • Enable Data Services
      • Enable Application Delivery
    • Useful Links
  • Azure CLI
    • Install
    • Get started
    • JMESPATH queries
    • Integrate with Bash
  • Azure Landing Zones
    • Prereqs
    • Day 1
      • Azure Baristas
      • Day 1 Challenge
    • Day 2
      • Example
      • Day 2 Challenge
    • Day 3
      • Day 3 Challenge
    • Useful Links
  • Azure Policy
    • Azure Policy Basics
      • Policy Basics in the Azure Portal
      • Creating Policy via the CLI
      • Deploy If Not Exists
      • Management Groups and Initiatives
    • Creating Custom Policies
      • Customer scenario
      • Policy Aliases
      • Determine the logic
      • Create the custom policy
      • Define, assign and test
  • Azure Stack HCI
    • Overview
    • Useful Links
    • Updates from Microsoft Ignite 2022
  • Marketplace
    • Introduction
      • Terminology
      • Offer Types
    • Partner Center
    • Offer Type
    • Publish a VM Offer HOL
      • Getting Started
      • Create VM Image
      • Test VM Image
      • VM Offer with SIG
      • VM Offer with SAS
      • Publish Offer
    • Other VM Resources
    • Publish a Solution Template HOL
      • Getting Started
      • Create ARM Template
      • Validate ARM Template
      • Create UI Definition
      • Package Assets
      • Publish Offer
    • Publish a Managed App HOL
      • Getting Started
      • Create ARM Template
      • Validate ARM Template
      • Create UI Definition
      • Package Assets
      • Publish Offer
    • Managed Apps with AKS HOL
    • Other Managed App Resources
    • SaaS Offer HOLs
    • SaaS Offer Video Series
      • Video 1 - SaaS Offer Overview
      • Video 2 - Purchasing a SaaS Offer
      • Video 3 - Purchasing a Private SaaS Plan
      • Video 4 - Publishing a SaaS Offer
      • Video 5 - Publishing a Private SaaS Plan
      • Video 6 - SaaS Offer Technical Overview
      • Video 7 - Azure AD Application Registrations
      • Video 8 - Using the SaaS Offer REST Fulfillment API
      • Video 9 - The SaaS Client Library for .NET
      • Video 10 - Building a Simple SaaS Landing Page in .NET
      • Video 11 - Building a Simple SaaS Publisher Portal in .NET
      • Video 12 - SaaS Webhook Overview
      • Video 13 - Implementing a Simple SaaS Webhook in .NET
      • Video 14 - Securing a Simple SaaS Webhook in .NET
      • Video 15 - SaaS Metered Billing Overview
      • Video 16 - The SaaS Metered Billing API with REST
  • Microsoft Fabric
    • Theory
    • Prereqs
    • Fabric Capacity
    • Set up a Remote State
    • Create a repo from a GitHub template
    • Configure an app reg for development
    • Initial Terraform workflow
    • Expanding your config
    • Configure a workload identity
    • GitHub Actions for Microsoft Fabric
    • GitLab pipeline for Microsoft Fabric
  • Packer & Ansible
    • Packer
    • Ansible
    • Dynamic Inventories
    • Playbooks & Roles
    • Custom Roles
    • Shared Image Gallery
  • Partner
    • Lighthouse and Partner Admin Link
      • Microsoft Cloud Partner Program
      • Combining Lighthouse and PAL
      • Minimal Lighthouse definition
      • Using service principals
      • Privileged Identity Management
    • Useful Links
  • REST API
    • REST API theory
    • Using az rest
  • Setup
  • Terraform
    • Fundamentals
      • Initialise
      • Format
      • Validate
      • Plan
      • Apply
      • Adding resources
      • Locals and outputs
      • Managing state
      • Importing resources
      • Destroy
    • Working Environments for Terraform
      • Cloud Shell
      • macOS
      • Windows with PowerShell
      • Windows with Ubuntu in WSL2
    • Using AzAPI
      • Using the REST API
      • azapi_resource
      • Removing azapi_resource
      • azapi_update_resource
      • Data sources and outputs
      • Removing azapi_update_resource
  • Virtual Machines
    • Azure Bastion with native tools & AAD
    • Managed Identities

  • About
  • Archive
  1. Home
  2. Marketplace
  3. Publish a Solution Template HOL
  4. Create ARM Template

Table of Contents

  • Introduction
  • Review the ARM Template
  • Test the ARM Template
    • Test using the Azure portal (Option 1)
    • Test using the CLI (Option 2)
  • Resources

Create ARM Template

Create an ARM template for publishing to the commercial marketplace.

Introduction

We will use a simple ARM template to demonstrate the principles. As described in Azure Apps Offer a solution template offer is not directly transactable in the commercial marketplace. It can however deploy transactable VM Offer(s). These offers can be hidden such that they can only be deployed by other offers (such as a solution template or managed application).

We will not follow this approach here but the principles are the same. Instead we will deploy a simple Azure function app.

Review the ARM Template

The template we will deploy can be found here. Take some time to familiarise yourself with the template. It will deploy a Linux Azure Function App on the serverless / consumption plan. This requires three services to be deployed:

  • a Storage account
  • an App Service Plan
  • the Function App itself.

Test the ARM Template

The first thing we will do is test that the ARM template works and deploys the services we expect. We can do this using the Azure portal or the CLI.

Test using the Azure portal (Option 1)

  1. Sign in to the Azure portal.

  2. On the home page, select Create a resource, search for “Template Deployment”, and select Create.

  3. Choose “Build your own template in the editor”.

    Create VM from ARM Template

  4. Replace the contents of the editor with the JSON from the ARM template file and hit Save

  5. Select the Subcription and Resource Group as required.

  6. All the parameters in the template have default values - we can leave them as is.

  7. Agree to the terms and conditions and hit “Purchase”.

  8. Navigate to the resource group and confirm the services deploy as expected.

Test using the CLI (Option 2)

  1. If you have cloned this repo, navigate to the folder containing the mainTemplate.json file. Something like /azurecitadel/content/marketplace/_scripts.

  2. Otherwise, create a file called mainTemplate.json and paste the contents of the mainTemplate.json file. Save the file.

  3. Create a new resource group using the Azure CLI:

    RG='arm-template-test'
    LOC='westeurope'
    az group create --name "$RG"--location "$LOC"
    

    Example output

       {
          "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/arm-template-test",
          "location": "westeurope",
          "managedBy": null,
          "name": "arm-template-test",
          "properties": {
             "provisioningState": "Succeeded"
          },
          "tags": null,
          "type": "Microsoft.Resources/resourceGroups"
       }
    
  4. Deploy the ARM template

    az deployment group create \
       --name "test-deployment" \
       --resource-group "$RG" \
       --template-file "./mainTemplate.json"
    

    Example output

       {
          "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/arm-template-test/providers/Microsoft.Resources/deployments/test-deployment",
          "location": null,
          "name": "test-deployment",
          "properties": {
             "correlationId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
             "debugSetting": null,
             "dependencies": [
                {
                "dependsOn": [
                   {
                      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/arm-template-test/providers/Microsoft.Web/serverfarms/hpn-arm-template-test",
                      "resourceGroup": "arm-template-test",
                      "resourceName": "hpn-arm-template-test",
                      "resourceType": "Microsoft.Web/serverfarms"
                   },
                   {
          ...
          ...
          ...
       }
    
  5. Navigate to the resource group in the Azure portal and confirm the services deploy as expected.

Resources

  • What are ARM Templates?

Getting Started Create ARM Template Validate ARM Template