---
title: Crea offerta di applicazione gestita
slug: it/crea-offerta-di-applicazione-gestita
icon: {"faIcon":"fa-brands fa-wordpress"}
createdAt: 2026-09-07T12:48:39.836Z
---

### 🟣 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:

![](https://api.archbee.com/api/optimize/wlBoYP3-_D88k8I6lqBSW/vpH5Pkzi-QOKo8OZGGScd_01-zip-package-contents.png)

###

:::hint{type="danger"}
**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 <font color="#B91C1C">`mainTemplate.json`</font>, nella directory root dello zip.
- **Convalidi prima del caricamento.** Esegua [ARM Template Test Toolkit (ARM TTK)](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/test-toolkit) sul pacchetto. Verifica il template, i parametri e la definizione UI rispetto ai requisiti di Marketplace.
- **Parta da esempi funzionanti.&#x20;**&#x45;sistono repository pubblici con centinaia di esempi: [esempi di app gestite Azure su GitHub,](https://github.com/Azure/azure-managedapp-samples) l'[indice dei progetti di esempio](https://learn.microsoft.com/en-us/azure/azure-resource-manager/managed-applications/sample-projects) e i più ampi [template quickstart di Azure](https://azure.microsoft.com/resources/quickstart-templates/).

### 🟣 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 <font color="#B91C1C">**mainTemplate.json**</font>**.**

****

- **Le maiuscole/minuscole nel nome del file sono importanti.** Il file deve essere denominato esattamente <font color="#B91C1C">**createUiDefinition.json**</font>, nella directory root dello zip.
- **Visualizzi l'anteprima nella sandbox.** Incolli il suo file nella [Create UI Definition Sandbox](https://portal.azure.com/#blade/Microsoft_Azure_CreateUIDef/SandboxBlade) per visualizzare in anteprima l'esatta esperienza del portale senza distribuire nulla. Guida: [Testi l'interfaccia del suo portale.](https://learn.microsoft.com/en-us/azure/azure-resource-manager/managed-applications/test-createuidefinition)
- **Documentazione di riferimento:** [panoramica di createUiDefinition](https://learn.microsoft.com/en-us/azure/azure-resource-manager/managed-applications/create-uidefinition-overview) con tutti gli elementi e le funzioni supportati.



:::hint{type="success"}
**Suggerimento:** ***Il percorso gratuito di Microsoft [Padroneggiare il Marketplace — Applicazioni gestite di Azure ](https://microsoft.github.io/Mastering-the-Marketplace/azure-app/)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



```javascript
{
  "$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 — <font color="#B91C1C">**posizione**</font>, <font color="#B91C1C">**storageAccountType**</font> e <font color="#B91C1C">**containerName**</font>. Il cliente li fornisce tramite l'interfaccia utente del portale Azure, definita in <font color="#B91C1C">**createUiDefinition.json**</font>. Si noti che gli **output** della definizione dell'interfaccia utente riportata di seguito corrispondono ai **parametri** del template riportato sopra.

### 🟣 createUiDefinition.json



```javascript
{
  "$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()]"
    }
  
```

###

:::hint{type="success"}
***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 c[loudsoft.io/partners/wetransact.](https://cloudsoft.io/partners/wetransact)***
:::

### 🟣 Caricamento e pubblicazione con WeTransact

1. 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.
2. Carichi il pacchetto <font color="#B91C1C">**.zip**</font> 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]



![](https://api.archbee.com/api/optimize/wlBoYP3-_D88k8I6lqBSW/DHDfAbs6aC-KmB4ltGvLh_upload.png)



**Quindi faccia clic su Validate.**



![](https://api.archbee.com/api/optimize/wlBoYP3-_D88k8I6lqBSW/iishciFSCcqrl1klrcgrz_upload.png)



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



![](https://api.archbee.com/api/optimize/wlBoYP3-_D88k8I6lqBSW/s-vQCcfbt1pwnTYBxfbbe_upload.png)

**Si consiglia di eseguire personalmente anche la convalida.**



3. **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.]***

&#x20;***💬 Per maggiori informazioni, ci contatti all'indirizzo:&#x20;***
