Configurazione del progetto di Azure in Visual Studio per l'uso di più configurazioni del servizio

Nota

Questo articolo si applica ad Azure Servizi cloud di Azure (supporto esteso). I servizi cloud (versione classica) sono stati ritirati a partire dal 31 agosto 2024. Per ulteriori informazioni, vedere il modello di distribuzione (versione classica) dei servizi cloud sarà ritirato il 31 agosto 2024. Per un nuovo sviluppo, è consigliabile usare un tipo di servizio più recente progettato per scopi specifici, ad esempio servizio app di Azure, Funzioni di Azureo app contenitore di Azure. Per l'elenco più recente dei servizi disponibili, vedere Directory dei prodotti Azure.

Un progetto di Servizi cloud di Azure (supporto esteso) in Visual Studio include tre file di configurazione: ServiceDefinition.csdef, ServiceConfiguration.Local.cscfge ServiceConfiguration.Cloud.cscfg:

• ServiceDefinition.csdef viene distribuito in Azure per descrivere i requisiti del servizio cloud e i relativi ruoli e per fornire le impostazioni applicabili a tutte le istanze. Le impostazioni possono essere lette in fase di esecuzione usando l'API runtime di hosting del servizio di Azure. Questo file può essere aggiornato in Azure solo quando il servizio cloud viene arrestato.
• ServiceConfiguration.Local.cscfg e ServiceConfiguration.Cloud.cscfg forniscono valori per le impostazioni nel file di definizione e specificano il numero di istanze da eseguire per ogni ruolo. Il file "Local" contiene i valori usati nel debug locale; Il file "Cloud" viene distribuito in Azure come ServiceConfiguration.cscfg e fornisce le impostazioni per l'ambiente server. Questo file può essere aggiornato mentre il servizio cloud è in esecuzione in Azure.

Le impostazioni di configurazione vengono gestite e modificate in Visual Studio usando le pagine delle proprietà per il ruolo applicabile (fare clic con il pulsante destro del mouse sul ruolo e selezionare Proprietàoppure fare doppio clic sul ruolo). L'ambito delle modifiche può essere determinato in base alla configurazione scelta nell'elenco a discesa Configurazione del Servizio. Le proprietà per i ruoli Web e di lavoratore sono simili, tranne dove descritto nelle sezioni seguenti.

Per informazioni sugli schemi sottostanti per i file di definizione del servizio e di configurazione del servizio, vedere gli articoli XML Schema .csdef e XML Schema .cscfg. Per altre informazioni sulla configurazione del servizio, vedere Come configurare i servizi cloud.

Pagina di configurazione

Configurazione del servizio

Seleziona il file ServiceConfiguration.*.cscfg interessato dalle modifiche. Per impostazione predefinita, sono disponibili varianti locali e cloud ed è possibile usare il comando Gestisci... per copiare, rinominare e rimuovere i file di configurazione. Questi file vengono aggiunti al progetto di servizio cloud e vengono visualizzati in Esplora soluzioni. Tuttavia, la ridenominazione o la rimozione delle configurazioni può essere eseguita solo da questo controllo.

Esempi

Impostare la proprietà instance count sul numero di istanze che il servizio deve eseguire per questo ruolo.

Azione di avvio (solo ruolo Web)

Impostare questa proprietà per specificare che Visual Studio deve avviare un Web browser per gli endpoint HTTP o gli endpoint HTTPS oppure entrambi quando si avvia il debug.

L'opzione endpoint HTTPS è disponibile solo se hai già definito un endpoint HTTPS per il tuo ruolo. È possibile definire un endpoint HTTPS nella pagina delle proprietà Endpoint.

Se è già stato aggiunto un endpoint HTTPS, l'opzione endpoint HTTPS è abilitata per impostazione predefinita e Visual Studio avvia un browser per questo endpoint quando si avvia il debug, oltre a un browser per l'endpoint HTTP, presupponendo che entrambe le opzioni di avvio siano abilitate.

Pagina Impostazioni

Nella pagina Impostazioni è possibile aggiungere impostazioni a una configurazione come coppie nome-valore. Il codice in esecuzione nel ruolo può leggere i valori delle impostazioni di configurazione in fase di esecuzione usando le classi fornite dal libreria gestita di Azure, in particolare, il metodo GetConfigurationSettingValue.

Configurazione di una stringa di connessione per un account di archiviazione

Una stringa di connessione è un'impostazione che fornisce informazioni di connessione e autenticazione per l'emulatore di archiviazione o per un account di archiviazione di Azure. Ogni volta che il codice in un ruolo accede a Azure Storage (blob, code o tabelle), è necessaria una stringa di connessione.

Nota

Una stringa di connessione per l'account di archiviazione di Azure deve usare un formato definito (vedere Configurare le stringhe di connessione di Archiviazione di Azure).

È possibile impostare la stringa di connessione per usare l'archiviazione locale in base alle esigenze, quindi passare a un account di archiviazione di Azure quando si distribuisce l'applicazione al servizio cloud. Se non si imposta correttamente la stringa di connessione, la funzione potrebbe non avviarsi o potrebbe iniziare a passare ciclicamente attraverso gli stati di inizializzazione, occupato e arresto.

Per creare una stringa di connessione, selezionare Aggiungi Impostazioni e impostare Tipo su "Stringa di connessione".

Per le stringhe di connessione nuove o esistenti, selezionare ...* nel campo Valore a destra del per aprire la finestra di dialogo Crea stringa di connessione di archiviazione.

1. In Connetti usando, scegliere l'opzione Il tuo abbonamento per selezionare un account di archiviazione dall'abbonamento. Visual Studio ottiene quindi automaticamente le credenziali dell'account di archiviazione dal file di .publishsettings.
2. Selezionando Credenziali immesse manualmente consente di specificare il nome e la chiave dell'account direttamente usando le informazioni del portale di Azure. Per copiare la chiave dell'account:
   1. Passare all'account di archiviazione nel portale di Azure e selezionare Gestisci chiavi.
   2. Per copiare la chiave dell'account, passare all'account di archiviazione nel portale di Azure, selezionare Impostazioni > Chiavi di accesso, quindi usare il pulsante copia per copiare la chiave di accesso primaria negli Appunti.
3. Selezionare una delle opzioni di connessione. Specificare endpoint personalizzati richiede di specificare URL specifici per BLOB, tabelle e code. Gli endpoint personalizzati consentono di usare domini personalizzati e controllare più esattamente l'accesso. Consulta Configurare le Stringhe di Connessione di Archiviazione di Azure.
4. Selezionare OK, quindi File > Salva per aggiornare la configurazione con la nuova stringa di connessione.

Anche in questo caso, quando si pubblica l'applicazione in Azure, scegliere la configurazione del servizio che contiene l'account di archiviazione di Azure per la stringa di connessione. Dopo la pubblicazione dell'applicazione, verificare che l'applicazione funzioni come previsto nei servizi di archiviazione di Azure.

Per altre informazioni su come aggiornare le configurazioni del servizio, vedere la sezione Gestire le stringhe di connessione per gli account di archiviazione.

Pagina degli Endpoints

Un ruolo Web ha in genere un singolo endpoint HTTP sulla porta 80. Un ruolo di lavoro, d'altra parte, può avere un numero qualsiasi di endpoint HTTP, HTTPS o TCP. Gli endpoint possono essere endpoint di input, disponibili per i client esterni o endpoint interni, disponibili per altri ruoli in esecuzione nel servizio.

• Per rendere disponibile un endpoint HTTP per client esterni e Web browser, modificare il tipo di endpoint in input e specificare un nome e un numero di porta pubblica.
• Per rendere disponibile un endpoint HTTPS per client esterni e Web browser, modificare il tipo di endpoint in inpute specificare un nome, un numero di porta pubblica e un nome del certificato di gestione. È inoltre necessario definire il certificato nella pagina delle proprietà Certificati prima di poter specificare un certificato di gestione.
• Per rendere disponibile un endpoint per l'accesso interno da altri ruoli nel servizio cloud, modificare il tipo di endpoint in interno e specificare un nome e le possibili porte private per questo endpoint.

Pagina di archiviazione locale

È possibile usare la pagina proprietà per riservare una o più risorse di archiviazione locale per un ruolo. Una risorsa di archiviazione locale è una directory riservata nel file system della macchina virtuale di Azure in cui è in esecuzione un'istanza di un ruolo.

Pagina Certificati

La pagina delle proprietà Certificati aggiunge informazioni sui tuoi certificati alla configurazione del servizio. Si noti che i certificati non vengono inseriti nel pacchetto con il servizio; è necessario caricare i certificati separatamente in Azure tramite il portale di Azure .

L'aggiunta di un certificato qui aggiunge informazioni sui certificati alla configurazione del servizio. I certificati non vengono inseriti nel pacchetto con il servizio; è necessario caricare i certificati separatamente tramite il portale di Azure.

Per associare un certificato al ruolo, specificare un nome per il certificato. Questo nome viene utilizzato per fare riferimento al certificato quando si configura un endpoint HTTPS nella pagina Endpoint. Specificare quindi se l'archivio certificati è computer locale o utente corrente e il nome dell'archivio. Immettere infine l'impronta digitale del certificato. Se il certificato si trova nell'archivio Current User\Personal (My), si può inserire l'impronta digitale del certificato selezionandolo da un elenco disponibile. Se si trova in qualsiasi altra posizione, immettere il valore dell'impronta digitale manualmente.

Quando si aggiunge un certificato dall'archivio certificati, tutti i certificati intermedi vengono aggiunti automaticamente alle impostazioni di configurazione. Inoltre, questi certificati intermedi devono essere caricati in Azure per configurare correttamente il servizio per SSL.

Tutti i certificati di gestione associati al servizio si applicano al servizio solo quando è in esecuzione nel cloud. Quando il servizio è in esecuzione nell'ambiente di sviluppo locale, usa un certificato standard gestito dall'emulatore di calcolo.