Azure Marketplace Solution UI Test

29 Nov


A quick note for all DevOps under us:

Currently I am doing an investigation on how to publish a solution to the Azure marketplace. You have 2 ways to do this. A Virtual Machine offer or a Solution template offer.

A Virtual Machine offer will be a sysprep’d VM that will contain all your pre-installed software and just will be deployed as a new virtual machine. So you will have to prepare a VM and sysprep/generalize it and upload it to Azure.

A Solution template offer is somehow more advanced. Here you don’t have to configure a sysprep’d VM image but you just use an ARM template to rollout a brand new VM and then use a script extension resource to deploy your artifacts (aka your software to install). The cool part is that you can also change the UI interface on the Azure portal when configuring the deployment. This is done with the createUiDefinition.json file that has to be a part of the solution zip file you upload to azure.

An example of this can be found here:

So when you have created all your ARM templates and put it into a Solution zip file (aka just zip all the ARM templates in one file) you will upload it using the portal and make a staged publish. (aka test rollout/publish)

Now you have to wait for a couple of hours before it will be ready to test it out. And this is the part that is annoying. There is no way to test the custom UI interface without having to do a staged publish and wait for a couple of hours a again……

Or is there …. ??

Yes there is! Thanks to this link I was able to test my custom deployment UI.

All you will have to do is:

  1. Create using the Azure storage explorer a new public container. (so set the public access level). For example named : “test”
  2. Copy the file “createUiDefinition.json” to this container.
  3. Check if you can open the file using the “copy Url” in a new browser.
  4. Now you will have to encode this URL , you can use for this.
  5. The URL looks like this now:
  6. Now replace the URL in the text below: (note: if you see ” replace it by the normal double quotes , this is a WordPress issue){“initialData”:{},”providerConfig”:{“createUiDefinition”:”URL from step 5“}}


  7. The end result could look like this:{“initialData”:{},”providerConfig”:{“createUiDefinition”:”“}}


  8. Open a new browser and paste in the URL from step 7. And the result will be ….


Super handy and cool!


Happy scomming azuring

Michel Kamp




3 Responses to “Azure Marketplace Solution UI Test”

  1. baris January 4, 2017 at 16:22 #

    Hi Michel I have a question about the createUiDefinition.json file. now I have an azuredeploy.json file bot there is no createUiDefinition.json file.How can I create this file from scratch according to my azuredeploy.json file ? Thank you

    • Michel Kamp January 4, 2017 at 16:30 #

      Hi ,

      This depends on what parameters you have specified in de deploy file. If you search for uidefinition or createuidefinition on github you will find a couple of examples.


      Get Outlook for iOS


      • baris January 5, 2017 at 16:45 #

        Can I use just basic and output section without using steps section?

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: