Schema di definizione di Servizi cloud di Azure (supporto "Extended") (file csdef)

  • Articolo

Il file di definizione del servizio definisce il modello di servizio per un'applicazione. Il file contiene le definizioni per i ruoli disponibili per un servizio cloud, specifica gli endpoint di servizio e stabilisce le impostazioni di configurazione per il servizio. I valori delle impostazioni di configurazione vengono impostati nel file di configurazione del servizio, come descritto in Schema di configurazione di Servizi cloud (supporto "Extended").

Per impostazione predefinita, il file dello schema di configurazione di Diagnostica di Azure viene installato nella directory C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Sostituire <version> con la versione installata di Azure SDK.

L'estensione predefinita per il file di definizione del servizio è csdef.

Schema di definizione del servizio di base

Il file di definizione del servizio deve contenere un elemento ServiceDefinition. La definizione del servizio deve contenere almeno un elemento ruolo (WebRole o WorkerRole). Può contenere fino a 25 ruoli definiti in una singola definizione ed è possibile combinare i tipi di ruolo. La definizione del servizio contiene inoltre l'elemento facoltativo NetworkTrafficRules che limita i ruoli che possono comunicare con endpoint interni specificati. La definizione del servizio contiene inoltre l'elemento facoltativo LoadBalancerProbes che contiene i probe di integrità degli endpoint definiti dal cliente.

Il formato di base del file di definizione del servizio è il seguente.

<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion="<version>">
  
  <LoadBalancerProbes>
         …
  </LoadBalancerProbes>
  
  <WebRole …>
         …
  </WebRole>
  
  <WorkerRole …>
         …
  </WorkerRole>
  
  <NetworkTrafficRules>
         …
  </NetworkTrafficRules>

</ServiceDefinition>

Definizioni dello schema

Gli argomenti seguenti descrivono lo schema:

Elemento ServiceDefinition

L'elemento ServiceDefinition è l'elemento di livello superiore del file di definizione del servizio.

La tabella seguente descrive gli attributi dell'elemento ServiceDefinition.

Attributo Descrizione
name Obbligatorio. Il nome del servizio. Il nome deve essere univoco all'interno dell'account del servizio.
topologyChangeDiscovery Facoltativo. Specifica il tipo di notifica di modifica della topologia. I valori possibili sono:

- Blast - Invia l'aggiornamento appena possibile a tutte le istanze del ruolo. Se si sceglie l'opzione, il ruolo deve essere in grado di gestire l'aggiornamento della topologia senza necessità di riavvio.
- UpgradeDomainWalk - Invia l'aggiornamento a ogni istanza del ruolo in modo sequenziale dopo che l'istanza precedente ha accettato correttamente l'aggiornamento.
schemaVersion Facoltativo. Specifica la versione dello schema di definizione del servizio. La versione dello schema consente a Visual Studio di selezionare gli strumenti SDK corretti da usare per la convalida dello schema se più di una versione dell'SDK è installata side-by-side.
upgradeDomainCount Facoltativo. Specifica il numero di domini di aggiornamento in cui vengono allocati i ruoli nel servizio. Le istanze del ruolo vengono allocate a un dominio di aggiornamento quando viene distribuito il servizio. Per altre informazioni, vedere Aggiornare un ruolo o una distribuzione di Servizi cloud e Gestire la disponibilità delle macchine virtuali. È possibile specificare fino a 20 domini di aggiornamento. Il numero predefinito di domini di aggiornamento è 5.

Vedi anche

Schema di configurazione di Servizi cloud di Azure (supporto "Extended") (file cscfg).