Modificare le impostazioni dell'host e dell'app per le app per la logica Standard in App per la logica di Azure a tenant singolo

Si applica: App per la logica di Azure (Standard)

In App per la logica di Azure a tenant singolo, le impostazioni dell'app per un'app per la logica Standard specificano le opzioni di configurazione globali che influiscono su tutti i flussi di lavoro in tale app per la logica. Tuttavia, queste impostazioni si applicano solo quando questi flussi di lavoro vengono eseguiti nell'ambiente di sviluppo locale. I flussi di lavoro in esecuzione in locale possono accedere a queste impostazioni dell'app come variabili di ambiente locali, usate dagli strumenti di sviluppo locali per i valori che spesso possono cambiare tra gli ambienti. Ad esempio, questi valori possono contenere stringhe di connessione. Quando si esegue la distribuzione in Azure, le impostazioni dell'app vengono ignorate e non sono incluse nella distribuzione.

L'app per la logica include anche impostazioni host, che specificano le impostazioni di configurazione e i valori di runtime applicabili a tutti i flussi di lavoro in tale app per la logica, ad esempio valori predefiniti per velocità effettiva, capacità, dimensioni dei dati e così via, sia che vengano eseguiti in locale o in Azure.

Impostazioni, parametri e distribuzione dell'app

Nelle App per la logica di Azure multi-tenant, la distribuzione dipende dai modelli di Azure Resource Manager (modelli ARM), che combinano e gestiscono il provisioning delle risorse sia per le app per la logica sia per l'infrastruttura. Questa progettazione rappresenta una sfida quando è necessario gestire le variabili di ambiente per le app per la logica in vari ambienti di sviluppo, test e produzione. Tutti gli elementi in un modello di Resource Manager sono definiti in fase di distribuzione. Se è necessario modificare solo una singola variabile, è necessario ridistribuire tutto.

Nelle App per la logica di Azure a tenant singolo, la distribuzione diventa più semplice perché è possibile separare il provisioning delle risorse tra app e infrastruttura. È possibile usare parametri per astrarre i valori che potrebbero cambiare tra gli ambienti. Definendo i parametri da usare nei flussi di lavoro, è prima possibile concentrarsi sulla progettazione dei flussi di lavoro e quindi inserire le variabili specifiche dell'ambiente in un secondo momento. È possibile chiamare e fare riferimento alle variabili di ambiente in fase di esecuzione usando le impostazioni e i parametri dell'app. In questo modo, non è necessario ridistribuire come spesso.

Le Impostazioni dell'app si integrano con Azure Key Vault. È possibile fare riferimento direttamente a stringhe sicure, ad esempio stringhe di connessione e chiavi. Analogamente ai modelli di Azure Resource Manager (ARM), in cui è possibile definire le variabili di ambiente in fase di distribuzione, è possibile indicare le impostazioni dell'app all'interno della definizione del flusso di lavoro dell'app per la logica. È quindi possibile acquisire valori di infrastruttura generati dinamicamente, ad esempio endpoint di connessione, stringhe di archiviazione e altri. Tuttavia, le impostazioni dell'app hanno limitazioni di dimensioni e non è possibile farvi riferimento da determinate aree in App per la logica di Azure.

Per altre informazioni sulla configurazione delle app per la logica per distribuzioni, vedere la documentazione seguente:

• Creare parametri per i valori che cambiano nei flussi di lavoro tra ambienti per App per la logica di Azure a tenant singolo
• Panoramica delle distribuzioni DevOps per app per la logica basate su singolo tenant
• Configurare la distribuzione DevOps per app per la logica basate su singolo tenant

Struttura del progetto di Visual Studio Code

In Visual Studio Code il progetto di app per la logica ha uno dei tipi seguenti:

• Basato su bundle di estensioni (Node.js), ovvero il tipo predefinito
• Basato su pacchetti NuGet (.NET), che è possibile convertire dal tipo predefinito

In base a questi tipi, il progetto include cartelle e file leggermente diversi. Un progetto basato su NuGet include una cartella .bin che contiene pacchetti e altri file di libreria. Un progetto basato su bundle non include la cartella .bin e altri file. Alcuni scenari richiedono l'esecuzione di un progetto basato su NuGet per l'app, ad esempio quando si vogliono sviluppare ed eseguire operazioni predefinite personalizzate. Per altre informazioni sulla conversione del progetto per l'uso di NuGet, vedere Abilitare la creazione di connettori predefiniti.

Per il progetto predefinito basato su bundle, il progetto ha una cartella e una struttura di file simile all'esempio seguente:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

A livello radice del progetto, è possibile trovare i file e le cartelle seguenti con altri elementi:

Informazioni di riferimento sulle impostazioni dell'app - local.settings.json

In Visual Studio Code, a livello radice del progetto dell'app per la logica, il file local.settings.json contiene opzioni di configurazione globali che influiscono su tutti i flussi di lavoro in tale app per la logica durante l'esecuzione nell'ambiente di sviluppo locale. Quando i flussi di lavoro vengono eseguiti in locale, queste impostazioni sono accessibili come variabili di ambiente locali e i relativi valori possono spesso variare tra i vari ambienti in cui vengono eseguiti i flussi di lavoro. Per visualizzare e gestire queste impostazioni, vedere Gestire le impostazioni dell'app - local.settings.json.

Le Impostazioni delle app in App per la logica di Azure funzionano in modo analogo alle impostazioni dell'app in Funzioni di Azure o in App Web di Azure. Se in precedenza hai usato questi altri servizi, potresti avere già familiarità con le impostazioni dell'app. Per altre informazioni, vedere Informazioni di riferimento sulle impostazioni dell'app per Funzioni di Azure e Usare Azure Functions Core Tools - file delle impostazioni locali.

Affinché il flusso di lavoro venga eseguito correttamente, sono necessarie alcune impostazioni dell'app.

Gestire le impostazioni dell'app - local.settings.json

Per aggiungere, aggiornare o eliminare impostazioni dell'app, selezionare e rivedere le sezioni seguenti per Portale di Azure, Visual Studio Code, interfaccia della riga di comando di Azure o modello ARM (Bicep). Per impostazioni dell'app specifiche per le app per la logica, vedere la guida di riferimento per le impostazioni dell'app disponibili - local.settings.json.

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Informazioni di riferimento per le impostazioni host - host.json

In Visual Studio Code, a livello radice del progetto dell'app per la logica, il file di metadati host.json contiene le impostazioni di runtime e i valori predefiniti che si applicano a tutti i flussi di lavoro in una risorsa dell'app per la logica usano durante l'esecuzione, in locale o in Azure. Per visualizzare e gestire queste impostazioni, vedere Gestire le impostazioni host - host.json. È anche possibile trovare informazioni sui limiti correlati nella documentazione Limiti e configurazione per App per la logica di Azure.

Velocità effettiva dell'orchestrazione dei processi

Queste impostazioni influiscono sulla velocità effettiva e sulla capacità per app per la logica di Azure a tenant singolo per eseguire operazioni del flusso di lavoro.

Entrambe le impostazioni seguenti vengono usate per arrestare manualmente ed eliminare immediatamente i flussi di lavoro specificati nell'app per la logica Standard.

Nell'esempio seguente viene illustrata la sintassi per queste impostazioni in cui ogni ID del flusso di lavoro è seguito da due punti (:) e separati da un punto e virgola (;):

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

Trigger basati su ricorrenza

Concorrenza di trigger

Le impostazioni seguenti funzionano solo per i flussi di lavoro che iniziano con un trigger basato su ricorrenza per i connettori predefiniti basati su provider di servizi. Per un flusso di lavoro che inizia con un trigger basato su funzione, è possibile provare a configurare l'invio in batch, se supportato. Tuttavia, l'invio in batch non è sempre la soluzione corretta. Ad esempio, con i trigger del bus di servizio di Azure, un batch potrebbe contenere messaggi oltre la durata del blocco. Di conseguenza, qualsiasi azione, ad esempio completa o abbandonata, ha esito negativo su tali messaggi.

Durata dell'esecuzione e conservazione della cronologia

Esegui azioni

Input e output

Impaginazione

Suddivisione in blocchi

Archiviare il contenuto inline o usare BLOB

Per ogni ciclo

Fino a cicli

Variabili

Operazioni HTTP predefinite

Operazioni webhook HTTP predefinite

Operazioni predefinite di Archiviazione di Azure

Archiviazione BLOB

Archiviazione di tabelle e code

Condivisione file

Operazioni predefinite di Funzioni di Azure

Operazioni predefinite del bus di servizio di Azure

Operazioni SFTP predefinite

Operazioni del connettore gestito

Criteri di ripetizione dei tentativi per tutte le altre operazioni

Limiti

• Dimensioni massime del contenuto

  Per impostazione predefinita, i trigger predefiniti, ad esempio HTTP o Request, sono limitati alle dimensioni del messaggio descritte in Limiti e informazioni di riferimento sulla configurazione - Messaggi. Per gestire i file superiori al limite, provare a caricare il contenuto come BLOB in Archiviazione BLOB di Azure e quindi ottenere il contenuto usando il connettore BLOB di Azure.

Gestire le impostazioni host - host.json

È possibile aggiungere, aggiornare o eliminare le impostazioni host, che specificano le impostazioni e i valori di configurazione del runtime che si applicano a tutti i flussi di lavoro nell'app per la logica, ad esempio i valori predefiniti per velocità effettiva, capacità, dimensioni dei dati e così via, sia che vengano eseguiti in locale o in Azure. Per le impostazioni host specifiche delle app per la logica, vedere la guida di riferimento per le impostazioni di runtime e distribuzione disponibili - host.json.

Portale di Azure - host.json

Per esaminare le impostazioni host per l'app per la logica basata su tenant singolo nel portale di Azure, seguire questa procedura:

1. Nella casella di ricerca Portale di Azure trovare e aprire l'app per la logica.

2. Nel menù dell'app per la logica, in Strumenti di sviluppo selezionare Strumenti avanzati.

3. Nel riquadro Strumenti avanzati selezionare Vaiper aprire l'ambiente Kudu per l'app per la logica.

4. Sulla barra degli strumenti Kudu scegliere CMD nel menu Console di debug.

5. Nel portale di Azure arrestare l'app per la logica.

   1. Selezionare Panoramica dal menu dell'app per la logica.

   2. Sulla barra degli strumenti del riquadro Panoramica selezionare Arresta.

6. Nel menù dell'app per la logica, in Strumenti di sviluppo selezionare Strumenti avanzati.

7. Nel riquadro Strumenti avanzati selezionare Vaiper aprire l'ambiente Kudu per l'app per la logica.

8. Sulla barra degli strumenti Kudu, aprire il menù Console di debug e selezionare CMD.

   Si apre una finestra della console, che permette di passare alla cartella wwwroot usando il prompt dei comandi. In alternativa, è possibile esplorare la struttura di directory visualizzata sopra la finestra della console.

9. Esplorare il percorso seguente per la cartella wwwroot: ...\home\site\wwwroot.

10. Sopra la finestra della console, nella tabella della directory, accanto al file host.json, selezionare Modifica.

11. Dopo l'apertura del file host.json, esaminare le impostazioni host aggiunte in precedenza per l'app per la logica.

    Per altre informazioni sulle impostazioni dell'host, vedere la guida di riferimento per le impostazioni dell'host disponibili - host.json.

Per aggiungere un'impostazione, seguire questi passaggi:

1. Prima di aggiungere o modificare le impostazioni, arrestare l'app per la logica nel portale di Azure.

   1. Selezionare Panoramica dal menu dell'app per la logica.
   2. Sulla barra degli strumenti del riquadro Panoramica selezionare Arresta.

2. Tornare al file host.json. Nell'oggetto extensionBundle aggiungere l'oggetto extensions, che include gli oggetti workflow e settings, ad esempio:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

3. Nell'oggetto settings aggiungere un elenco semplice con le impostazioni dell'host che si desidera usare per tutti i flussi di lavoro nell'app per la logica, ad esempio se questi flussi di lavoro vengono eseguiti in locale o in Azure:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

4. Al termine, ricordarsi di selezionare Salva.

5. A questo momento, riavviare l'app per la logica. Tornare alla pagina Panoramica dell'app per la logica e selezionareRiavvia.

Visual Studio Code - host.json

Per esaminare le impostazioni host per l'app per la logica in Visual Studio Code, seguire questa procedura:

1. Nel progetto dell'app per la logica, a livello di progetto radice, trovare e aprire il file host.json.

2. Nell'oggetto extensions, in workflows e settings, esaminare le impostazioni host aggiunte in precedenza per l'app per la logica. In caso contrario, l'oggetto extensions non verrà visualizzato nel file.

   Per altre informazioni sulle impostazioni dell'host, vedere la guida di riferimento per le impostazioni dell'host disponibili - host.json.

Per aggiungere un'impostazione host, seguire questi passaggi:

1. Nel file host.json, all'interno dell'oggetto extensionBundle, aggiungere l'oggetto extensions, che include gli oggetti workflow e settings, ad esempio:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. Nell'oggetto settings aggiungere un elenco semplice con le impostazioni dell'host che si desidera usare per tutti i flussi di lavoro nell'app per la logica, ad esempio se questi flussi di lavoro vengono eseguiti in locale o in Azure:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

Passaggi successivi

• Creare parametri per i valori che cambiano nei flussi di lavoro tra ambienti per App per la logica di Azure a tenant singolo
• Configurare la distribuzione da DevOps per le applicazioni di App per la logica di Azure a tenant singolo