Creare parametri tra ambienti per gli input del flusso di lavoro in App per la logica di Azure

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

In App per la logica di Azure è possibile astrarre valori che potrebbero cambiare nei flussi di lavoro tra ambienti di sviluppo, test e produzione definendo i parametri. Quando si usano parametri anziché variabili specifiche dell'ambiente, è inizialmente possibile concentrarsi più sulla progettazione dei flussi di lavoro e inserire le variabili specifiche dell'ambiente in un secondo momento.

Questo articolo illustra come creare, usare e modificare i parametri per i flussi di lavoro dell'app per la logica a consumo multi-tenant e per i flussi di lavoro dell'app per la logica standard a tenant singolo. Si apprenderà anche come gestire le variabili di ambiente.

Per altre informazioni su App per la logica di Azure multi-tenant e single-tenant, vedere Single-tenant rispetto all'ambiente del servizio di integrazione e multi-tenant per App per la logica di Azure.

Prerequisiti

• Un account e una sottoscrizione di Azure. Se non si ha una sottoscrizione, è possibile iscriversi per creare un account Azure gratuito.

• Flusso di lavoro dell'app per la logica consumo o standard

  Se non si dispone ancora di un flusso di lavoro dell'app per portale di Azure la logica per la logica, vedere Creare un flusso di lavoro dell'app per la logica di esempio usando il portale di Azure.

  Nota

  Attualmente è possibile creare parametri solo per i flussi di lavoro dell'app per la logica di consumo usando il portale di Azure. È possibile creare parametri solo per i flussi di lavoro dell'app per la logica Standard usando il portale di Azure o Visual Studio Code.

Parametri per i flussi di lavoro dell'app per la logica standard rispetto ai flussi di lavoro dell'app per la logica standard

Per i flussi di lavoro delle app per la logica Consumo e Standard, è possibile definire i parametri usando la finestra di progettazione. Dopo aver definito il parametro, è possibile fare riferimento a tale parametro da qualsiasi flusso di lavoro o connessione nella stessa risorsa dell'app per la logica.

Nei flussi di lavoro dell'app per la logica a consumo multi-tenant, dopo aver creato e usato parametri nella finestra di progettazione, definire e impostare le variabili di ambiente nel modello di Azure Resource Manager (modello ARM) e i file di parametri del modello. In questo scenario è necessario definire e impostare i parametri in fase di distribuzione, ovvero anche se è necessario modificare una variabile, è necessario ridistribuire il modello arm dell'app per la logica.

Nei flussi di lavoro dell'app per la logica Standard a tenant singolo è possibile usare variabili di ambiente sia in fase di esecuzione che in distribuzione usando parametri e impostazioni dell'app. Le impostazioni dell'app contengono opzioni di configurazione globali per tutti i flussi di lavoro nella stessa risorsa dell'app per la logica. Per altre informazioni, vedere Modificare le impostazioni host e app per le app basate su singolo tenant.

Nota

Nei flussi di lavoro dell'app per la logica Standard, i tipi di dati sicuri, ad esempio securestring e , secureobjectnon sono supportati. Tuttavia, come opzione alternativa, è possibile usare le impostazioni dell'app con Azure Key Vault. È quindi possibile fare riferimento direttamente a stringhe sicure, ad esempio stringhe di connessione e chiavi. Analogamente ai modelli di Resource Manager, in cui è possibile definire le variabili di ambiente in fase di distribuzione, è possibile definire 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 altro ancora.

Tuttavia, le impostazioni dell'app hanno limiti di dimensioni e non possono essere riferimenti a determinate aree in App per la logica di Azure. I parametri offrono un'ampia gamma di casi d'uso rispetto alle impostazioni dell'app, ad esempio il supporto per dimensioni di valori di grandi dimensioni e oggetti complessi.

Ad esempio, se si usa Visual Studio Code come strumento di sviluppo locale per eseguire flussi di lavoro in locale, nel progetto dell'app per la logica è possibile definire i parametri usando il file parameters.json . È quindi possibile fare riferimento a qualsiasi parametro in questo file di parametri da qualsiasi flusso di lavoro nel file workflow.json del progetto o da qualsiasi oggetto di connessione nel file connections.json del progetto. L'elenco seguente descrive alcuni casi d'uso comuni:

• Disporre di un file di parametri di test che include tutti i valori usati durante il test. In fase di distribuzione è possibile sostituire il file dei parametri di test con il file di parametri di produzione.

• Parametrizzare parti diverse del file connections.json . È quindi possibile controllare il file connections.json nel controllo del codice sorgente e quindi gestire le connessioni tramite il file parameters.json .

• Parametrizzare oggetti complessi, ad esempio l'oggetto authentication JSON. Ad esempio, è possibile sostituire il valore dell'oggetto authentication con una stringa che contiene un'espressione di parametri singoli, ad esempio @parameters('api-auth').

• Esaminare e modificare le impostazioni dell'app nel file local.settings.json del progetto. È quindi possibile fare riferimento a queste impostazioni dell'app nei parametri.

Nota

Come raccomandazione generale, prendere in considerazione l'uso dei parametri come modo predefinito per parametrizzare i valori, non le impostazioni dell'app. In questo modo, quando è necessario archiviare chiavi o stringhe sicure, è possibile seguire la raccomandazione per fare riferimento alle impostazioni dell'app dai parametri. Se vuoi, puoi usare entrambe le opzioni nella soluzione usando i parametri per fare riferimento alle impostazioni dell'app.

Definire, usare e modificare i parametri

Consumo

Portale di Azure

1. Nella portale di Azure aprire il flusso di lavoro dell'app per la logica. In Flussi di lavoro selezionare e aprire il flusso di lavoro nella finestra di progettazione.

2. Nella barra degli strumenti della finestra di progettazione selezionare Parametri.

   

3. Nel riquadro Parametri selezionare Aggiungi parametro.

4. Specificare le informazioni seguenti sul parametro da creare:

   Proprietà	Obbligatoria	Descrizione
   Nome	Sì	Nome del parametro da creare.
   Tipo	Sì	Tipo di dati per il parametro, ad esempio Array, Bool, Float, Int, Object, Secure Object, Secure String e String.
   Valore predefinito	Sì	Valore predefinito del parametro. È necessario specificare il valore predefinito del parametro perché la logica del flusso di lavoro, le informazioni di connessione e i valori dei parametri non esistono in una singola posizione. La finestra di progettazione deve essere in grado di risolvere i valori dei parametri prima del caricamento. Importante: per i tipi di dati Secure Object e Secure String , evitare di impostare un valore predefinito perché il valore viene archiviato come testo normale.
   Valore effettivo	No	Valore effettivo per il parametro.

   Nell'esempio seguente viene illustrata una definizione per un parametro stringa:

   

5. Se sono disponibili altri parametri da aggiungere, selezionare Aggiungi parametro. In caso contrario, chiudere il riquadro dei parametri, ma assicurarsi di salvare il flusso di lavoro per salvare la nuova definizione di parametro.

6. Per fare riferimento al parametro da un trigger o un'azione nello stesso flusso di lavoro, seguire questa procedura:

   1. Nella finestra di progettazione aprire il flusso di lavoro desiderato e espandere il trigger o l'azione.

   2. Nella proprietà in cui si vuole usare il parametro fare clic all'interno della casella di modifica della proprietà.

   3. Nell'elenco contenuto dinamico aperto in Parametri selezionare il parametro creato in precedenza, ad esempio:

      

7. Per visualizzare o modificare i parametri in un flusso di lavoro dell'app per la logica, seguire questa procedura:

   1. Aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione. Nella barra degli strumenti della finestra di progettazione selezionare Parametri.

      Il riquadro Parametri viene aperto e visualizza tutti i parametri definiti per tale flusso di lavoro.

   2. Modificare, chiudere il riquadro dei parametri e salvare il flusso di lavoro dell'app per la logica.

Standard

Portale di Azure

1. Nella portale di Azure aprire la risorsa dell'app per la logica. In Flussi di lavoro aprire il flusso di lavoro nella finestra di progettazione.

2. Nella barra degli strumenti della finestra di progettazione selezionare Parametri.

   

3. Nel riquadro Parametri selezionare Crea parametro.

4. Specificare le informazioni seguenti sul parametro da creare:

   Proprietà	Obbligatoria	Descrizione
   Nome	Sì	Nome del parametro da creare.
   Tipo	Sì	Tipo di dati per il parametro, ad esempio Array, Bool, Float, Int, Object e String. Nota: nei flussi di lavoro dell'app per la logica Standard, i tipi di dati sicuri, ad esempio securestring e , secureobjectnon sono supportati.
   Valore	Sì	Valore del parametro. Nei flussi di lavoro dell'app per la logica Standard è necessario specificare il valore del parametro perché la logica del flusso di lavoro, le informazioni di connessione e i valori dei parametri non esistono in una singola posizione. La finestra di progettazione deve essere in grado di risolvere i valori dei parametri prima del caricamento.

   Nell'esempio seguente viene illustrata una definizione per un parametro stringa:

   

5. Al termine, chiudere il riquadro Parametri , ma assicurarsi di salvare il flusso di lavoro per salvare la nuova definizione di parametro.

6. Per fare riferimento al parametro da un trigger o un'azione in qualsiasi flusso di lavoro all'interno della stessa app per la logica, seguire questa procedura:

   1. Nella finestra di progettazione aprire il flusso di lavoro desiderato e espandere il trigger o l'azione.

   2. Nella proprietà in cui si vuole usare il parametro fare clic all'interno della casella di modifica della proprietà.

   3. Nell'elenco contenuto dinamico aperto in Parametri selezionare il parametro creato in precedenza, ad esempio:

      

7. Per visualizzare o modificare i parametri nella stessa app per la logica, seguire questo passaggio:

   • Aprire qualsiasi flusso di lavoro in tale app per la logica. Nel menu del flusso di lavoro selezionare Progettazione. Nella barra degli strumenti della finestra di progettazione selezionare Parametri.

     Il riquadro Parametri viene aperto e visualizza tutti i parametri definiti dai flussi di lavoro in tale app per la logica.

   • Per visualizzare o modificare in blocco JSON, nel menu principale dell'app per la logica selezionare Parametri.

     La visualizzazione JSON Parametri apre e visualizza tutti i parametri definiti dai flussi di lavoro in tale app per la logica.

Visual Studio Code

1. In un file JSON a livello di progetto denominato parameters.json definire tutti i parametri e i relativi valori. Questo file include un oggetto che include coppie chiave-valore . Ogni chiave è il nome per ogni parametro, mentre ogni valore è la struttura per ogni parametro. Ogni struttura deve includere sia una dichiarazione che value unatype.

   Importante

   Il file parameters.json deve definire e includere tutti i parametri e i relativi valori a cui si fa riferimento o usare altrove nel progetto, ad esempio nelle definizioni o nelle connessioni del flusso di lavoro.

   Nell'esempio seguente viene illustrato un file di parametri di base:

   {
       "responseString": { 
           "type": "string", 
           "value": "hello" 
       },
       "functionAuth": { 
           "type": "object", 
           "value": { 
               "type": "QueryString", 
               "name": "Code", 
               "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
           }
       }
    }
   

   Nota

   Nel file @appsettingparameters.json è l'unico tipo di espressione valido.

2. Per fare riferimento ai parametri negli input del trigger o dell'azione, usare l'espressione @parameters('<parameter-name>').

Parametrizzare il file di connessioni

Per parametrizzare il file connections.json , sostituire i valori per i valori letterali, ad ConnectionRuntimeUrlesempio , con una singola parameters() espressione, ad esempio @parameters('api-runtimeUrl'). Nel file connections.json gli unici tipi di espressione validi sono @parameters e @appsetting.

Importante

Se si parametrizza il file connections.json durante lo sviluppo, l'esperienza di progettazione diventa limitata, sia in locale che nella portale di Azure. Se è necessario usare la finestra di progettazione per lo sviluppo, usare invece un file connections.json non con parametri. Quindi, nelle pipeline di distribuzione sostituire con il file con parametri. Il runtime funziona ancora con la parametrizzazione. I miglioramenti apportati alla finestra di progettazione sono in fase di sviluppo.

Nell'esempio seguente viene illustrato un file connections.json con parametri che usa sia le impostazioni dell'app che i parametri. Anche se si desidera usare i parametri se possibile, questo scenario è un'eccezione o un caso perimetrale in cui si userà le impostazioni dell'app sui parametri perché le impostazioni dell'app vengono generate durante la distribuzione e sono più facili da popolare dinamicamente in una pipeline di sviluppo. Questo file di esempio usa un parametro per l'oggetto di autenticazione complesso blob_auth e le impostazioni dell'app per gli altri valori. In questo caso, è possibile usare un parametro per l'oggetto di autenticazione perché è improbabile fare riferimento al parametro nel flusso di lavoro:

{
   "serviceProviderConnections": {
      "serviceBus": {
         "parameterValues": {
            "connectionString": "@appsetting('serviceBus_connectionString')"
        },
        "serviceProvider": {
           "id": "/serviceProviders/serviceBus"
        },
        "displayName": "servicebus"
     }
   },
   "managedApiConnections": {
      "azureblob": {
         "api": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/providers/Microsoft.Web/locations/@{appsetting('WORKFLOWS_LOCATION_NAME')}/managedApis/azureblob"
         },
         "connection": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/resourceGroups/@{appsetting('WORKFLOWS_RESOURCE_GROUP_NAME')}/providers/Microsoft.Web/connections/azureblob"
         },
         "connectionRuntimeUrl": "@appsetting('BLOB_CONNECTION_RUNTIMEURL')",
         "authentication": "@parameters('blob_auth')"
      }
   }
}

Nota

Quando si dispone di un'espressione inline con testo normale, assicurarsi di usare il formato interpolato per tale espressione racchiudendo tale espressione con parentesi graffe ({}). Questo formato consente di evitare l'analisi dei problemi.

Ad esempio, se è presente "<text>/@<function-name>('<parameter-name>')/<text>", usare invece la versione seguente: "<text>/@{<function-name>('<parameter-name>')}/<text>".

Per altre informazioni, vedere Considerazioni sull'uso di funzioni.

Gestire i file dei parametri

In genere, è necessario gestire più versioni dei file di parametri. È possibile che siano presenti valori di destinazione per ambienti di distribuzione diversi, ad esempio sviluppo, test e produzione. La gestione di questi file di parametri spesso funziona come la gestione dei file di parametri del modello di Resource Manager. Quando si distribuisce in un ambiente specifico, si promuove il file di parametri corrispondente, in genere tramite una pipeline per DevOps.

Per sostituire dinamicamente i file di parametri usando l'interfaccia della riga di comando di Azure, eseguire il comando seguente:

az functionapp deploy --resource-group MyResourceGroup --name MyLogicApp --src-path C:\parameters.json --type static --target-path parameters.json

Se si dispone di un progetto di app per la logica basata su NuGet, è necessario aggiornare il file di progetto (<logic-app-name.csproj>) per includere il file di parametri nell'output di compilazione, ad esempio:

<ItemGroup>
  <None Update="parameters.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

Nota

Attualmente, la funzionalità per sostituire dinamicamente i file di parametri non è ancora disponibile nella portale di Azure o nella finestra di progettazione del flusso di lavoro.

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

• Panoramica della distribuzione devOps per app per la logica basata su singolo tenant
• Configurare la distribuzione devOps per app per la logica basata su tenant singolo

Gestire le impostazioni delle app

In App per la logica di Azure a tenant singolo le impostazioni dell'app contengono opzioni di configurazione globali per tutti i flussi di lavoro nella stessa app per la logica. Quando si eseguono flussi di lavoro in locale in Visual Studio Code, è possibile accedere a queste impostazioni dell'app come variabili di ambiente locali nel file local.settings.json . È quindi possibile fare riferimento a queste impostazioni dell'app nei parametri.

Per aggiungere, aggiornare o eliminare le impostazioni dell'app, selezionare e esaminare le sezioni seguenti per Visual Studio Code, portale di Azure, interfaccia della riga di comando di Azure o modello arm (Bicep).

Portale di Azure

Per esaminare le impostazioni dell'app per la risorsa dell'app per la logica nel portale di Azure, seguire questa procedura:

1. Nella portale di Azure aprire la risorsa dell'app per la logica.

2. Nel menu dell'app per la logica selezionare Configurazione in Impostazioni.

3. Nella scheda Impostazioni applicazione della pagina Configurazione esaminare le impostazioni dell'app per l'app per l'app per la logica.

4. Per visualizzare tutti i valori, selezionare Mostra valori. In alternativa, per visualizzare un singolo valore, selezionare tale valore.

Per aggiungere una nuova impostazione, seguire questa procedura:

1. Nella scheda Impostazioni applicazione selezionare Nuova impostazione applicazione in Impostazioni applicazione.

2. Per Nome immettere la chiave o il nome per la nuova impostazione.

3. Per Valore immettere il valore per la nuova impostazione.

4. Quando si è pronti per creare la nuova coppia chiave-valore , selezionare OK.

   

5. Al termine, sulla barra degli strumenti configurazione selezionare Salva.

Interfaccia della riga di comando di Azure

Per esaminare le impostazioni correnti dell'app usando l'interfaccia della riga di comando di Azure, eseguire il comando . az logicapp config appsettings list Assicurarsi che il comando includa i --name -n parametri e --resource-group -g , ad esempio:

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

Per aggiungere o aggiornare un'impostazione dell'app usando l'interfaccia della riga di comando di Azure, eseguire il comando az logicapp config appsettings set. Assicurarsi che il comando includa i --name n parametri e --resource-group -g . Ad esempio, il comando seguente crea un'impostazione con una chiave denominata CUSTOM_LOGIC_APP_SETTING con un valore di 12345:

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

modello Resource Manager o Bicep

Per esaminare e definire le impostazioni dell'app in un modello arm o modello Bicep, trovare la definizione della risorsa dell'app per la logica e aggiornare l'oggetto appSettings JSON. Per la definizione completa della risorsa, vedere riferimento al modello di Resource Manager.

In questo esempio vengono visualizzate le impostazioni dei file per i modelli arm o i modelli Bicep:

"appSettings": [
    {
        "name": "string",
        "value": "string"
    },
    {
        "name": "string",
        "value": "string"
    },
    <...>
], 

Passaggi successivi

• Ambiente del servizio di integrazione e multi-tenant per App per la logica di Azure