Schema WebRole di definizione di Servizi cloud di Azure (versione classica)

  • Articolo

Importante

Servizi cloud (versione classica) è ora deprecato per i nuovi clienti e verrà ritirato il 31 agosto 2024 per tutti i clienti. Le nuove distribuzioni devono usare il nuovo modello di distribuzione basato su Azure Resource Manager, Servizi cloud di Azure (supporto "Extended").

Il ruolo Web di Azure è un ruolo che viene personalizzato per la programmazione di applicazioni Web supportata da IIS 7, ad esempio ASP.NET, PHP, Windows Communication Foundation e FastCGI.

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

Schema di definizione del servizio di base per un ruolo Web

Il formato di base di un file di definizione del servizio contenente un ruolo Web è il seguente.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>

Elementi dello schema

Il file di definizione del servizio include questi elementi, descritti in dettaglio nelle sezioni successive di questo argomento:

WebRole

ConfigurationSettings

Impostazione

LocalResources

LocalStorage

Endpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Attestati

Certificate

Importazioni

Importa

Runtime

Ambiente

Variabile

RoleInstanceValue

NetFxEntryPoint

Siti

Sito

VirtualApplication

VirtualApplication

Bindings

Binding

Startup

Attività

Contents

Contenuto

SourceDirectory

WebRole

L'elemento WebRole descrive un ruolo che viene personalizzato per la programmazione di applicazioni Web, supportata da IIS 7 e ASP.NET. Un servizio può contenere zero o più ruoli Web.

La tabella seguente descrive gli attributi dell'elemento WebRole.

Attributo Tipo Descrizione
name string Obbligatorio. Nome del ruolo Web. Il nome del ruolo deve essere univoco.
enableNativeCodeExecution boolean Facoltativo. Il valore predefinito è true. L'esecuzione del codice nativo e l'attendibilità totale sono abilitate per impostazione predefinita. Impostare questo attributo su false per disabilitare l'esecuzione del codice nativo per il ruolo Web e usare invece l'attendibilità parziale di Azure.
vmsize string Facoltativo. Impostare questo valore per modificare le dimensioni della macchina virtuale assegnata al ruolo. Il valore predefinito è Small. Per altre informazioni, vedere Dimensioni delle macchine virtuali per i servizi cloud.

ConfigurationSettings

L'elemento ConfigurationSettings descrive la raccolta delle impostazioni di configurazione per un ruolo Web. Questo è l'elemento padre dell'elemento Setting.

Impostazione

L'elemento Setting descrive una coppia di nome e valore che specifica un'impostazione di configurazione per un'istanza di un ruolo.

La tabella seguente descrive gli attributi dell'elemento Setting.

Attributo Tipo Descrizione
name string Obbligatorio. Nome univoco dell'impostazione di configurazione.

Le impostazioni di configurazione per un ruolo sono coppie di nome e valore dichiarate nel file di definizione del servizio e impostate nel file di configurazione del servizio.

LocalResources

L'elemento LocalResources descrive la raccolta delle risorse di archiviazione locali per un ruolo Web. Questo è l'elemento padre dell'elemento LocalStorage.

LocalStorage

L'elemento LocalStorage identifica una risorsa di archiviazione locale che fornisce lo spazio del file system per il servizio in fase di esecuzione. Un ruolo può definire zero o più risorse di archiviazione locali.

Nota

L'elemento LocalStorage può essere visualizzato come figlio dell'elemento WebRole per supportare la compatibilità con le versioni precedenti di Azure SDK.

La tabella seguente descrive gli attributi dell'elemento LocalStorage.

Attributo Tipo Descrizione
name string Obbligatorio. Nome univoco per l'archivio locale.
cleanOnRoleRecycle boolean Facoltativo. Indica se l'archivio locale deve essere pulito quando il ruolo viene riavviato. Il valore predefinito è true.
sizeInMb int Facoltativo. Quantità desiderata di spazio di archiviazione da allocare per l'archivio locale, in MB. Se non specificato, lo spazio di archiviazione predefinito allocato è 100 MB. La quantità minima di spazio di archiviazione che può essere allocato è 1 MB.

Le dimensioni massime delle risorse locali dipendono dalle dimensioni della macchina virtuale. Per altre informazioni, vedere Dimensioni delle macchine virtuali per i servizi cloud.

Il nome della directory allocata alla risorsa di archiviazione locale corrisponde al valore specificato per l'attributo name.

Endpoint

L'elemento Endpoints descrive la raccolta degli endpoint di input (esterni), interni e di input dell'istanza per un ruolo. Questo è l'elemento padre degli elementi InputEndpoint, InternalEndpoint e InstanceInputEndpoint.

Gli endpoint di input e interni vengono allocati separatamente. Un servizio può avere un totale di 25 endpoint di input, interni e di input dell'istanza che possono essere allocati nei 25 ruoli consentiti in un servizio. Con 5 ruoli, ad esempio, è possibile allocare 5 endpoint di input per ruolo, 25 endpoint di input a un singolo ruolo oppure 1 endpoint di input a ognuno dei 25 ruoli.

Nota

Ogni ruolo distribuito richiede un'istanza per ruolo. Il provisioning predefinito per una sottoscrizione è limitato a 20 core e quindi a 20 istanze di un ruolo. Se l'applicazione richiede più istanze di quelle fornite dal provisioning predefinito, vedere Supporto per fatturazione, gestione della sottoscrizione e quota per altre informazioni sull'aumento della quota.

InputEndpoint

L'elemento InputEndpoint descrive un endpoint esterno per un ruolo Web.

È possibile definire più endpoint come combinazione di endpoint HTTP, HTTPS, UDP e TCP. È possibile specificare qualsiasi numero di porta scelto per un endpoint di input, ma i numeri di porta specificati per ogni ruolo nel servizio devono essere univoci. Se ad esempio si specifica che un ruolo Web deve usare la porta 80 per HTTP e la porta 443 per HTTPS, è possibile specificare che un secondo ruolo Web deve usare la porta 8080 per HTTP e la porta 8043 per HTTPS.

La tabella seguente descrive gli attributi dell'elemento InputEndpoint.

Attributo Tipo Descrizione
name string Obbligatorio. Nome univoco per l'endpoint esterno.
protocollo string Obbligatorio. Protocollo di trasporto per l'endpoint esterno. Per un ruolo Web, i possibili valori sono HTTP, HTTPS, UDP o TCP.
port int Obbligatorio. Porta per l'endpoint esterno. È possibile specificare qualsiasi numero di porta scelto, ma i numeri di porta specificati per ogni ruolo nel servizio devono essere univoci.

I possibili valori sono compresi tra 1 e 65535 inclusi (Azure SDK versione 1.7 o successiva).
certificato string Obbligatorio per un endpoint HTTPS. Nome di un certificato definito da un elemento Certificate.
localPort int Facoltativo. Specifica una porta usata per le connessioni interne nell'endpoint. L'attributo localPort esegue il mapping della porta esterna nell'endpoint a una porta interna in un ruolo. È utile negli scenari in cui un ruolo deve comunicare con un componente interno su una porta diversa da quella esposta esternamente.

Se non specificato, il valore di localPort è lo stesso dell'attributo port. Impostare il valore di localPort su "*" per assegnare automaticamente una porta non allocata individuabile usando l'API di runtime.

I possibili valori sono compresi tra 1 e 65535 inclusi (Azure SDK versione 1.7 o successiva).

L'attributo localPort è disponibile solo se si usa Azure SDK versione 1.3 o successiva.
ignoreRoleInstanceStatus boolean Facoltativo. Quando il valore di questo attributo è impostato su true, lo stato di un servizio viene ignorato e l'endpoint non verrà rimosso dal servizio di bilanciamento del carico. Impostare questo valore su true è utile per il eseguire il debug delle istanze occupate di un servizio. Il valore predefinito è false. Nota: un endpoint può continuare a ricevere traffico anche quando il ruolo non è pronto.
loadBalancerProbe string Facoltativo. Nome del probe di bilanciamento del carico associato all'endpoint di input. Per altre informazioni, vedere Schema LoadBalancerProbe.

InternalEndpoint

L'elemento InternalEndpoint descrive un endpoint interno per un ruolo Web. Un endpoint interno è disponibile solo per le altre istanze del ruolo in esecuzione nel servizio. Non è disponibile per i client esterni al servizio. I ruoli Web che non includono l'elemento Sites possono avere un solo endpoint interno HTTP, UDP o TCP.

La tabella seguente descrive gli attributi dell'elemento InternalEndpoint.

Attributo Tipo Descrizione
name string Obbligatorio. Nome univoco per l'endpoint interno.
protocollo string Obbligatorio. Protocollo di trasporto per l'endpoint interno. I possibili valori sono HTTP, TCP, UDP o ANY.

Il valore ANY specifica che sono consentiti tutti i protocolli e tutte le porte.
port int Facoltativo. Porta usata per le connessioni interne con bilanciamento del carico nell'endpoint. Un endpoint con bilanciamento del carico usa due porte. la porta usata per l'indirizzo IP pubblico e la porta usata per l'indirizzo IP privato, che in genere sono impostate sullo stesso valore, ma è possibile scegliere di usare porte diverse.

I possibili valori sono compresi tra 1 e 65535 inclusi (Azure SDK versione 1.7 o successiva).

L'attributo Port è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

InstanceInputEndpoint

L'elemento InstanceInputEndpoint descrive un endpoint di input dell'istanza per un ruolo Web. Un endpoint di input dell'istanza viene associato a un'istanza del ruolo specifica usando il port forwarding nel servizio di bilanciamento del carico. Per ogni endpoint di input dell'istanza viene eseguito il mapping a una porta specifica compresa in un intervallo di porte possibili. Questo è l'elemento padre dell'elemento AllocatePublicPortFrom.

L'elemento InstanceInputEndpoint è disponibile solo se si usa Azure SDK versione 1.7 o successiva.

La tabella seguente descrive gli attributi dell'elemento InstanceInputEndpoint.

Attributo Tipo Descrizione
name string Obbligatorio. Nome univoco per l'endpoint.
localPort int Obbligatorio. Specifica la porta interna su cui tutte le istanze del ruolo saranno in ascolto per ricevere il traffico in ingresso inoltrato dal servizio di bilanciamento del carico. I possibili valori sono compresi tra 1 e 65535 inclusi.
protocollo string Obbligatorio. Protocollo di trasporto per l'endpoint interno. I possibili valori sono udp o tcp. Usare tcp per il traffico basato su http/https.

AllocatePublicPortFrom

L'elemento AllocatePublicPortFrom descrive l'intervallo di porte pubbliche che può essere usato dai clienti esterni per accedere a ogni endpoint di input dell'istanza. Il numero di porta pubblica (indirizzo VIP) viene allocato da questo intervallo e assegnato a ogni singolo endpoint di istanza del ruolo durante la distribuzione e l'aggiornamento del tenant. Questo è l'elemento padre dell'elemento FixedPortRange.

L'elemento AllocatePublicPortFrom è disponibile solo se si usa Azure SDK versione 1.7 o successiva.

FixedPort

L'elemento FixedPort specifica la porta per l'endpoint interno, che abilita le connessioni con bilanciamento del carico sull'endpoint.

L'elemento FixedPort è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento FixedPort.

Attributo Tipo Descrizione
port int Obbligatorio. Porta per l'endpoint interno. Se si impostano i valori minimo e massimo di FixedPortRange sulla stessa porta, si ottiene lo stesso risultato.

I possibili valori sono compresi tra 1 e 65535 inclusi (Azure SDK versione 1.7 o successiva).

FixedPortRange

L'elemento FixedPortRange specifica l'intervallo di porte assegnate all'endpoint interno o all'endpoint di input dell'istanza e imposta la porta usata per le connessioni con bilanciamento del carico sull'endpoint.

Nota

Il funzionamento dell'elemento FixedPortRange è diverso a seconda dell'elemento in cui si trova. Quando l'elemento FixedPortRange è nell'elemento InternalEndpoint, apre tutte le porte nel servizio di bilanciamento del carico comprese nell'intervallo degli attributi min e max per tutte le macchine virtuali in cui il ruolo viene eseguito. Quando l'elemento FixedPortRange è nell'elemento InstanceInputEndpoint, apre una sola porta compresa nell'intervallo degli attributi min e max in ogni macchina virtuale che esegue il ruolo.

L'elemento FixedPortRange è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento FixedPortRange.

Attributo Tipo Descrizione
min int Obbligatorio. Numero di porta minimo nell'intervallo. I possibili valori sono compresi tra 1 e 65535 inclusi (Azure SDK versione 1.7 o successiva).
max string Obbligatorio. Numero di porta massimo nell'intervallo. I possibili valori sono compresi tra 1 e 65535 inclusi (Azure SDK versione 1.7 o successiva).

Certificati

L'elemento Certificates descrive la raccolta dei certificati per un ruolo Web. Questo è l'elemento padre dell'elemento Certificate. A un ruolo può essere associato un numero qualsiasi di certificati. Per altre informazioni sull'uso dell'elemento certificates, vedere Modificare il file di definizione del servizio con un certificato.

Certificate

L'elemento Certificate descrive un certificato associato a un ruolo Web.

La tabella seguente descrive gli attributi dell'elemento Certificate.

Attributo Tipo Descrizione
name string Obbligatorio. Nome di questo certificato, usato per farvi riferimento quando viene associato a un elemento InputEndpoint HTTPS.
storeLocation string Obbligatorio. Posizione dell'archivio certificati in cui si può trovare questo certificato sul computer locale. I valori possibili sono CurrentUser e LocalMachine.
storeName string Obbligatorio. Nome dell'archivio certificati in cui si trova questo certificato sul computer locale. I possibili valori includono i nomi di archivio predefiniti My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook o i nomi di archivio personalizzati. Se viene specificato un nome di archivio personalizzato, l'archivio viene creato automaticamente.
permissionLevel string Facoltativo. Specifica le autorizzazioni di accesso concesse ai processi di ruolo. Per consentire solo ai processi con privilegi elevati di accedere alla chiave privata, specificare l'autorizzazione elevated. L'autorizzazione limitedOrElevated consente a tutti i processi di ruolo di accedere alla chiave privata. I possibili valori sono limitedOrElevated o elevated. Il valore predefinito è limitedOrElevated.

Importazioni

L'elemento Imports descrive una raccolta dei moduli di importazione per un ruolo Web, che aggiungono componenti al sistema operativo guest. Questo è l'elemento padre dell'elemento Import. Questo elemento è facoltativo e un ruolo può avere un solo blocco di importazioni.

L'elemento Imports è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

Import

L'elemento Import specifica un modulo da aggiungere al sistema operativo guest.

L'elemento Import è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento Import.

Attributo Tipo Descrizione
moduleName string Obbligatorio. Nome del modulo da importare. I moduli di importazione validi sono:

- RemoteAccess
- RemoteForwarder
- Diagnostics

I moduli RemoteAccess e RemoteForwarder consentono di configurare l'istanza del ruolo per le connessioni desktop remote. Per altre informazioni, vedere Abilitare una connessione Desktop remoto.

Il modulo Diagnostics consente di raccogliere dati di diagnostica per un'istanza del ruolo.

esecuzione

L'elemento Runtime descrive una raccolta di impostazioni di variabile di ambiente per un ruolo Web, che controllano l'ambiente di runtime del processo host di Azure. Questo è l'elemento padre dell'elemento Environment. Questo elemento è facoltativo e un ruolo può avere un solo blocco di runtime.

L'elemento Runtime è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento Runtime:

Attributo Tipo Descrizione
executionContext string Facoltativo. Specifica il contesto in cui viene avviato il processo del ruolo. Il contesto predefinito è limited.

- limited: il processo viene avviato senza privilegi di amministratore.
- elevated: il processo viene avviato con privilegi di amministratore.

Ambiente

L'elemento Environment descrive una raccolta delle impostazioni di variabile di ambiente per un ruolo Web. Questo è l'elemento padre dell'elemento Variable. Un ruolo può avere un numero qualsiasi di variabili di ambiente impostate.

Variabile

L'elemento Variable specifica una variabile di ambiente da impostare nel sistema operativo guest.

L'elemento Variable è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento Variable:

Attributo Tipo Descrizione
name string Obbligatorio. Nome della variabile di ambiente da impostare.
value string Facoltativo. Valore da impostare per la variabile di ambiente. È necessario includere un attributo value o un elemento RoleInstanceValue.

RoleInstanceValue

L'elemento RoleInstanceValue specifica un XPath da cui recuperare il valore della variabile.

La tabella seguente descrive gli attributi dell'elemento RoleInstanceValue.

Attributo Tipo Descrizione
xpath string Facoltativo. Percorso delle impostazioni di distribuzione per l'istanza. Per altre informazioni, vedere Variabili di configurazione con XPath.

È necessario includere un attributo value o un elemento RoleInstanceValue.

EntryPoint

L'elemento EntryPoint specifica il punto di ingresso per un ruolo. Questo è l'elemento padre degli elementi NetFxEntryPoint. Questi elementi consentono di specificare un'applicazione diversa da quella predefinita WaWorkerHost.exe, che deve fungere da punto di ingresso di un ruolo.

L'elemento EntryPoint è disponibile solo se si usa Azure SDK versione 1.5 o successiva.

NetFxEntryPoint

L'elemento NetFxEntryPoint specifica il programma da eseguire per un ruolo.

Nota

L'elemento NetFxEntryPoint è disponibile solo se si usa Azure SDK versione 1.5 o successiva.

La tabella seguente descrive gli attributi dell'elemento NetFxEntryPoint.

Attributo Tipo Descrizione
assemblyName string Obbligatorio. Percorso e nome file dell'assembly contenente il punto di ingresso. Il percorso è relativo alla cartella \%ROLEROOT%\Approot. Non specificare \%ROLEROOT%\Approot in commandLine perché è sottintesa. %ROLEROOT% è una variabile di ambiente gestita da Azure e rappresenta la posizione della cartella radice per il ruolo. La cartella \%ROLEROOT%\Approot rappresenta la cartella dell'applicazione per il ruolo.

Per i ruoli HWC il percorso è sempre relativo alla cartella \%ROLEROOT%\Approot\bin.

Per i ruoli Web IIS e IIS Express completi, se non è possibile trovare l'assembly relativo alla cartella \%ROLEROOT%\Approot, viene eseguita una ricerca per \%ROLEROOT%\Approot\bin.

Questo comportamento di fallback per IIS completo non è una procedura consigliata e potrebbe essere rimosso nelle versioni future.
targetFrameworkVersion string Obbligatorio. Versione di .NET Framework in cui è stato compilato l'assembly, Ad esempio, targetFrameworkVersion="v4.0".

Siti

L'elemento Sites descrive una raccolta dei siti Web e delle applicazioni Web ospitati in un ruolo Web. Questo è l'elemento padre dell'elemento Site. Se non si specifica un elemento Sites, il ruolo Web viene ospitato come ruolo Web legacy ed è possibile avere un solo sito Web ospitato nel ruolo Web. Questo elemento è facoltativo e un ruolo può avere un solo blocco di siti.

L'elemento Sites è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

Site

L'elemento Site specifica un sito Web o un'applicazione Web che fa parte del ruolo Web.

L'elemento Site è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento Site.

Attributo Tipo Descrizione
name string Obbligatorio. Nome del sito Web o dell'applicazione.
physicalDirectory string Posizione della directory del contenuto per la radice del sito. La posizione può essere specificata come percorso assoluto o relativo alla posizione del file con estensione csdef.

VirtualApplication

L'elemento VirtualApplication definisce un'applicazione in Internet Information Services (IIS) 7 ed è un raggruppamento di file che invia contenuto o fornisce servizi tramite protocolli, ad esempio HTTP. Quando si crea un'applicazione in IIS 7, il percorso dell'applicazione diventa parte dell'URL del sito.

L'elemento VirtualApplication è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento VirtualApplication.

Attributo Tipo Descrizione
name string Obbligatorio. Specifica un nome per identificare l'applicazione virtuale.
physicalDirectory string Obbligatorio. Specifica il percorso nel computer di sviluppo che contiene l'applicazione virtuale. Nell'emulatore di calcolo IIS è configurato per recuperare il contenuto da questa posizione. Quando si esegue la distribuzione in Azure, i contenuti della directory fisica vengono inseriti nel pacchetto con il resto del servizio. Quando il pacchetto servizio viene distribuito in Azure, IIS viene configurato con la posizione dei contenuti decompressi.

VirtualDirectory

L'elemento VirtualDirectory specifica un nome di directory (detto anche percorso) specificato in IIS ed esegue il mapping a una directory fisica su un server locale o remoto.

L'elemento VirtualDirectory è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento VirtualDirectory.

Attributo Tipo Descrizione
name string Obbligatorio. Specifica un nome per identificare la directory virtuale.
value physicalDirectory Obbligatorio. Specifica il percorso nel computer di sviluppo che include i contenuti del sito Web o della directory virtuale. Nell'emulatore di calcolo IIS è configurato per recuperare il contenuto da questa posizione. Quando si esegue la distribuzione in Azure, i contenuti della directory fisica vengono inseriti nel pacchetto con il resto del servizio. Quando il pacchetto servizio viene distribuito in Azure, IIS viene configurato con la posizione dei contenuti decompressi.

Bindings

L'elemento Bindings descrive una raccolta di associazioni per un sito Web. Si tratta dell'elemento padre dell'elemento Binding. L'elemento è obbligatorio per ogni elemento Site. Per altre informazioni sulla configurazione degli endpoint, vedere Abilitare la comunicazione delle istanze del ruolo.

L'elemento Bindings è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

Binding

L'elemento Binding specifica le informazioni di configurazione necessarie per la comunicazione tra le richieste e un sito Web o un'applicazione Web.

L'elemento Binding è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

Attributo Tipo Descrizione
name string Obbligatorio. Specifica un nome per identificare l'associazione.
endpointName string Obbligatorio. Specifica il nome dell'endpoint con cui eseguire l'associazione.
hostHeader string Facoltativo. Specifica un nome host che consente di ospitare più siti, con nomi host diversi, in un'unica combinazione di indirizzo IP/ numero di porta.

Startup

L'elemento Startup descrive una raccolta di attività eseguite quando il ruolo viene avviato. Questo può essere l'elemento padre dell'elemento Variable. Per altre informazioni sull'uso delle attività di avvio del ruolo, vedere Come configurare attività di avvio. Questo elemento è facoltativo e un ruolo può avere un solo blocco di avvio.

La tabella seguente descrive l'attributo dell'elemento Startup.

Attributo Tipo Descrizione
priority int Solo per uso interno.

Attività

L'elemento Task specifica l'attività di avvio eseguita quando il ruolo viene avviato. Le attività di avvio possono essere usate per eseguire attività che preparano il ruolo a eseguire tali componenti software di installazione o altre applicazioni. Le attività vengono eseguite nell'ordine in cui sono visualizzate nel blocco dell'elemento Startup.

L'elemento Task è disponibile solo se si usa Azure SDK versione 1.3 o successiva.

La tabella seguente descrive gli attributi dell'elemento Task.

Attributo Tipo Descrizione
commandLine string Obbligatorio. Uno script, ad esempio un file CMD, contenente i comandi da eseguire. Il comando di avvio e i file batch devono essere salvati in formato ANSI. I formati di file che impostano un byte order mark all'inizio del file non verranno elaborati correttamente.
executionContext string Specifica il contesto in cui viene eseguito lo script.

- limited [impostazione predefinita]: viene eseguito con gli stessi privilegi del ruolo che ospita il processo.
- elevated: viene eseguito con privilegi di amministratore.
taskType string Specifica il comportamento di esecuzione del comando.

- simple [impostazione predefinita]: il sistema attende la fine dell'attività prima che vengano avviate altre attività.
- background: il sistema non attende la fine dell'attività.
- foreground: simile a background, ma il ruolo viene riavviato solo dopo la fine di tutte le attività in primo piano.

Contenuto

L'elemento Contents descrive la raccolta dei contenuti per un ruolo Web. Questo è l'elemento padre dell'elemento Content.

L'elemento Contents è disponibile solo se si usa Azure SDK versione 1.5 o successiva.

Sommario

L'elemento Content definisce la posizione di origine del contenuto da copiare nella macchina virtuale di Azure e il percorso di destinazione in cui viene copiato.

L'elemento Content è disponibile solo se si usa Azure SDK versione 1.5 o successiva.

La tabella seguente descrive gli attributi dell'elemento Content.

Attributo Tipo Descrizione
destination string Obbligatorio. Posizione della macchina virtuale Azure in cui viene inserito il contenuto. Questa posizione è relativa alla cartella %ROLEROOT%\Approot.

Questo è l'elemento padre dell'elemento SourceDirectory.

SourceDirectory

L'elemento SourceDirectory definisce la directory locale da cui il contenuto viene copiato. Usare questo elemento per specificare i contenuti locali da copiare nella macchina virtuale di Azure.

L'elemento SourceDirectory è disponibile solo se si usa Azure SDK versione 1.5 o successiva.

La tabella seguente descrive gli attributi dell'elemento SourceDirectory.

Attributo Tipo Descrizione
path string Obbligatorio. Percorso relativo o assoluto di una directory locale i cui contenuti verranno copiati nella macchina virtuale di Azure. L'espansione delle variabili di ambiente nel percorso della directory è supportata.

Vedi anche

Cloud Service (classic) Definition Schema (Schema di definizione di Servizi cloud - Versione classica)