Crea offerta di applicazione gestita
🟣 Creazione dell'offerta: il pacchetto di distribuzione
Per creare un'offerta Managed Application, per prima cosa costruisce la sua soluzione in un formato di distribuzione ripetibile. Azure utilizza i template ARM per definire l'infrastruttura distribuita nell'ambiente del cliente.
Prepara un pacchetto di distribuzione — un file .zip contenente due file nella directory root:

Avviso:Il pacchetto di distribuzione non deve contenere file binari come immagini VM. Faccia invece riferimento a tutte le immagini da Marketplace.
🟣 mainTemplate.json
Un template ARM che definisce ogni risorsa Azure che compone la sua applicazione — macchine virtuali, account di archiviazione, database, rete e così via. Questo template viene eseguito nella sottoscrizione del cliente al momento della distribuzione.
- Le maiuscole/minuscole nel nome del file sono importanti. Il file deve essere denominato esattamente mainTemplate.json, nella directory root dello zip.
- Convalidi prima del caricamento. Esegua ARM Template Test Toolkit (ARM TTK) sul pacchetto. Verifica il template, i parametri e la definizione UI rispetto ai requisiti di Marketplace.
- Parta da esempi funzionanti. Esistono repository pubblici con centinaia di esempi: esempi di app gestite Azure su GitHub, l'indice dei progetti di esempio e i più ampi template quickstart di Azure.
🟣 createUiDefinition.json
Il file di definizione UI gestisce l'interfaccia che il cliente vede nel portale Azure durante la distribuzione. Consente di richiedere input di configurazione — nome dell'istanza, dimensionamento, credenziali amministratore, impostazioni opzionali — in una procedura guidata. Gli output di questo modulo corrispondono uno a uno ai parametri di mainTemplate.json.
- Le maiuscole/minuscole nel nome del file sono importanti. Il file deve essere denominato esattamente createUiDefinition.json, nella directory root dello zip.
- Visualizzi l'anteprima nella sandbox. Incolli il suo file nella Create UI Definition Sandbox per visualizzare in anteprima l'esatta esperienza del portale senza distribuire nulla. Guida: Testi l'interfaccia del suo portale.
- Documentazione di riferimento: panoramica di createUiDefinition con tutti gli elementi e le funzioni supportati.
Suggerimento: Il percorso gratuito di Microsoft Padroneggiare il Marketplace — Applicazioni gestite di Azure include laboratori pratici e video che coprono l'intero processo di creazione del pacchetto.
🟣 Esempio pratico
Il risultato finale dello sviluppo sono due file JSON, compressi insieme e caricati nel portale WeTransact. A seconda di ciò che distribuisce, questi file vanno da molto semplici a molto grandi. L'esempio seguente distribuisce un singolo account di archiviazione con un contenitore blob.
🟣 mainTemplate.json
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageAccountType": {
"type": "string",
"defaultValue": "Standard_LRS",
"allowedValues": [ "Standard_LRS", "Standard_GRS", "Premium_LRS" ]
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]"
},
"containerName": {
"type": "string",
"defaultValue": "demo"
}
},
"variables": {
"storageAccountName": "[concat('demo', uniqueString(resourceGroup().id))]"
},
"resources": [
{
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2025-06-01",
"name": "[variables('storageAccountName')]",
"location": "[parameters('location')]",
"sku": { "name": "[parameters('storageAccountType')]" },
"kind": "StorageV2",
"properties": {
"supportsHttpsTrafficOnly": true,
"minimumTlsVersion": "TLS1_2",
"allowBlobPublicAccess": false
}
},
{
"type": "Microsoft.Storage/storageAccounts/blobServices/containers",
"apiVersion": "2025-06-01",
"name": "[concat(variables('storageAccountName'), '/default/', parameters('containerName'))]",
"dependsOn": [
"[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
],
"properties": { "publicAccess": "None" }
}
],
"outputs": {
"storageAccountName": {
"type": "string",
"value": "[variables('storageAccountName')]"
}
}
}Questo template accetta tre parametri di input — posizione, storageAccountType e containerName. Il cliente li fornisce tramite l'interfaccia utente del portale Azure, definita in createUiDefinition.json. Si noti che gli output della definizione dell'interfaccia utente riportata di seguito corrispondono ai parametri del template riportato sopra.
🟣 createUiDefinition.json
{
"$schema": "https://schema.management.azure.com/schemas/0.1.2-preview/CreateUIDefinition.MultiVm.json#",
"handler": "Microsoft.Azure.CreateUIDef",
"version": "0.1.2-preview",
"parameters": {
"basics": [],
"steps": [
{
"name": "storageConfig",
"label": "Storage",
"elements": [
{
"name": "storageAccountType",
"type": "Microsoft.Common.DropDown",
"label": "Storage account type",
"defaultValue": "Standard_LRS",
"toolTip": "Redundancy/performance tier for the demo storage account.",
"constraints": {
"allowedValues": [
{ "label": "Standard_LRS", "value": "Standard_LRS" },
{ "label": "Standard_GRS", "value": "Standard_GRS" },
{ "label": "Premium_LRS", "value": "Premium_LRS" }
],
"required": true
}
},
{
"name": "containerName",
"type": "Microsoft.Common.TextBox",
"label": "Blob container name",
"defaultValue": "demo",
"toolTip": "Container created inside the storage account.",
"constraints": {
"required": true,
"regex": "^[a-z0-9]([a-z0-9-]{1,61}[a-z0-9])$",
"validationMessage": "3-63 chars, lowercase letters, numbers and hyphens; must start and end with a letter or number."
}
}
]
}
],
"outputs": {
"storageAccountType": "[steps('storageConfig').storageAccountType]",
"containerName": "[steps('storageConfig').containerName]",
"location": "[location()]"
}
Suggerimento: se non dispone della capacità ingegneristica interna per creare il pacchetto, il partner di WeTransact Cloudsoft crea, testa e implementa pacchetti Managed Application. Veda cloudsoft.io/partners/wetransact.
🟣 Caricamento e pubblicazione con WeTransact
- Nel portale WeTransact, crei l'inserzione Managed Application e completi la descrizione del prodotto, i contenuti multimediali e i piani — lo stesso flusso di qualsiasi altra inserzione.
- Carichi il pacchetto .zip nel piano, nel campo "File zip contenente i file mainTemplate.json e createUiDefinition.json"". [Screenshot: 02-portal-add-zip-file.png — il controllo Add ZIP file nella sezione Media dell'inserzione]

Quindi faccia clic su Validate.

Se tutto è corretto, la convalida avrà esito positivo. In caso contrario, verrà visualizzato un messaggio di errore:

Si consiglia di eseguire personalmente anche la convalida.
- Pubblicazione. La pubblicazione iniziale di un'offerta Managed Application richiede in genere fino a 24 ore per andare online, e la ripubblicazione di un aggiornamento richiede circa lo stesso tempo. Questo processo è più lento rispetto a SaaS perché Microsoft esegue un passaggio di certificazione manuale sui file del template.[DA CONFERMARE — il valore di 24 ore è un'esperienza osservata da WeTransact, non uno SLA Microsoft documentato.]
💬 Per maggiori informazioni, ci contatti all'indirizzo: [email protected]