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

Il file di configurazione del servizio specifica il numero di istanze del ruolo da distribuire per ogni ruolo nel servizio, i valori delle impostazioni di configurazione e le identificazioni personali per i certificati associati a un ruolo. Se il servizio fa parte di una networking virtuale, le informazioni di configurazione della rete devono essere specificate nel file di configurazione del servizio e nel file di configurazione del networking virtuale. L'estensione predefinita per il file di configurazione del servizio è cscfg.

Il modello del servizio viene descritto dallo schema di definizione 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.

Per altre informazioni sulla configurazione dei ruoli in un servizio, vedere Cos'è il modello del servizio cloud.

Schema di configurazione del servizio Basic

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

XML

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definizioni dello schema

Gli articoli seguenti descrivono lo schema per l'elemento ServiceConfiguration:

• Schema del ruolo
• Schema NetworkConfiguration

Spazio dei nomi di configurazione del servizio

Lo spazio dei nomi XML per il file di configurazione del servizio è: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

Elemento ServiceConfiguration

ServiceConfiguration è l'elemento di livello superiore del file di configurazione del servizio.

La tabella seguente descrive gli attributi dell'elemento ServiceConfiguration. Tutti i valori degli attributi sono di tipo stringa.

Attributo	Descrizione
serviceName	Obbligatorio. Il nome del servizio cloud. Il nome assegnato qui deve corrispondere al nome specificato nel file di definizione del servizio.
osFamily	Facoltativo. Specifica il sistema operativo guest che viene eseguito sulle istanze del ruolo nel servizio cloud. Per informazioni sulle versioni del sistema operativo guest supportate, vedere Versioni del sistema operativo guest di Azure e matrice di compatibilità SDK. Se non si include un valore osFamily e non si è impostato l'attributo osVersion su una versione specifica del sistema operativo guest, viene usato il valore predefinito 1.
osVersion	Facoltativo. Specifica la versione del sistema operativo guest che viene eseguito sulle istanze del ruolo nel servizio cloud. Per altre informazioni sulle versioni del sistema operativo guest, vedere Versioni del sistema operativo guest di Azure e matrice di compatibilità SDK. È possibile specificare che il sistema operativo guest deve essere automaticamente aggiornato alla versione più recente. A questo scopo, impostare il valore dell'attributo osVersion su *. Quando viene impostato su *, le istanze del ruolo vengono distribuite usando la versione più recente del sistema operativo guest per la famiglia di sistemi operativi specificata e sono automaticamente aggiornate quando sono rilasciate nuove versioni del sistema operativo guest. Per specificare manualmente una determinata versione, usare Configuration String della tabella della sezione Versioni future, correnti e di transizione del sistema operativo guest di Versioni del sistema operativo guest di Azure e matrice di compatibilità SDK. Il valore predefinito per l'attributo osVersion è *.
schemaVersion	Facoltativo. Specifica la versione dello schema di configurazione 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. Per altre informazioni sullo schema e sulla compatibilità delle versioni, vedere Versioni del sistema operativo guest di Azure e matrice di compatibilità SDK

Il file di configurazione del servizio deve contenere un elemento ServiceConfiguration. L'elemento ServiceConfiguration può includere un numero qualsiasi di elementi Role e zero o 1 elemento NetworkConfiguration.

Vedi anche

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