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

  • Articolo

Si applica a: App per la logica di Azure (a consumo e standard)

In App per la logica di Azure è possibile astrarre i valori che possono cambiare nei flussi di lavoro in ambienti di sviluppo, test e produzione tramite la definizione di parametri. Quando si usano parametri anziché variabili specifiche dell'ambiente, inizialmente è possibile concentrarsi maggiormente 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 delle 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 sui App per la logica di Azure multi-tenant e a tenant singolo, vedere Single-tenant e multi-tenant in App per la logica di Azure.

Prerequisiti

Confronto tra parametri per i flussi di lavoro delle app per la logica A consumo e Standard

Per i flussi di lavoro delle app per la logica sia A consumo che Standard è possibile definire parametri tramite la finestra di progettazione. Dopo aver definito il parametro, è possibile fare riferimento a tale parametro da qualsiasi flusso di lavoro o connessione presente 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 i parametri nella finestra di progettazione, è possibile definire e impostare le variabili di ambiente nel modello di Azure Resource Manager e nei file dei parametri del modello di Azure Resource Manager. In questo scenario è necessario definire e impostare i parametri in fase di distribuzione, il che implica che anche se è necessario modificare una sola variabile, è necessario distribuire nuovamente il modello ARM dell'app per la logica.

Nei flussi di lavoro dell'app per la logica Standard a singolo tenant è possibile usare variabili di ambiente sia in fase di esecuzione che in fase di distribuzione usando i parametri e le 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 dell'host e dell'app per app per la logica basate su singolo tenant.

Importante

Quando si dispone di informazioni sensibili, ad esempio stringhe di connessione che includono nomi utente e password, assicurarsi di usare il flusso di autenticazione più sicuro disponibile. Ad esempio, nei flussi di lavoro dell'app per la logica Standard, i tipi di dati sicuri, ad esempio securestring e secureobject, non sono supportati. Microsoft consiglia di autenticare l'accesso alle risorse di Azure con un'identità gestita, quando possibile, e assegnare un ruolo con i privilegi minimi necessari.

Se questa funzionalità non è disponibile, assicurarsi di proteggere le stringhe di connessione tramite altre misure, ad esempio Azure Key Vault, che è possibile usare con le impostazioni dell'app. È quindi possibile fare riferimento direttamente a stringhe sicure, ad esempio stringhe di connessione e chiavi. Analogamente ai modelli 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. Per altre informazioni, vedere Tipi di applicazione per Microsoft Identity Platform.

Tuttavia, le impostazioni dell'app hanno limiti di dimensioni e non è possibile farvi riferimento da determinate aree in App per la logica di Azure. I parametri offrono una gamma più ampia 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 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 connessione nel file connections.json del progetto. L'elenco seguente descrive alcuni casi d'uso comuni:

  • Avere 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 dei 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 eventuali connessioni tramite il file parameters.json.

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

  • Rivedere 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 consiglio generale, considerare l'uso di parametri come modo predefinito per parametrizzare i valori, non le impostazioni dell'app. In questo modo, quando è necessario archiviare stringhe o chiavi sicure, è possibile seguire il consiglio di fare riferimento alle impostazioni dell'app dai parametri. Se si desidera, è possibile usare entrambe le opzioni nella propria soluzione usando i parametri per fare riferimento alle impostazioni dell'app.

Definire, usare e modificare parametri

Azure portal

  1. Nel 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. Dalla barra degli strumenti della finestra di progettazione, selezionare Parametri.

    Screenshot che mostra il portale di Azure, la finestra di progettazione per il flusso di lavoro A consumo e

  3. Nel riquadro Parametri, selezionare Aggiungi parametro.

  4. Specificare le informazioni seguenti sul parametro da creare:

    Proprietà Richiesto Descrizione
    Nome Sì Il nome del parametro da creare.
    Type Sì Il tipo di dati per il parametro, ad esempio Array, Bool, Float, Int, Object, Secure Object, Secure String e String.
    Valore predefinito Sì Il valore predefinito per il parametro. È necessario specificare il valore del parametro predefinito perché la logica del flusso di lavoro, le informazioni di connessione e i valori dei parametri non esistono in un'unica 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 Il valore effettivo per il parametro.

    L'esempio seguente illustra una definizione per un parametro stringa:

    Screenshot che mostra il portale di Azure, la finestra di progettazione per il flusso di lavoro A consumo e il riquadro

  5. Se è necessario aggiungere altri parametri, 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 che si trova nello stesso flusso di lavoro, seguire questi passaggi:

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

    2. Nella proprietà in cui si desidera utilizzare il parametro, fare clic all'interno della casella di modifica della proprietà.

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

      Screenshot che mostra la finestra di progettazione per il flusso di lavoro A consumo e l'azione di esempio con il cursore nella casella di modifica delle proprietà, l'elenco del contenuto dinamico espanso e il parametro creato in precedenza selezionato.

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

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

      Si apre il riquadro Parametri e vengono visualizzati tutti i parametri definiti per tale flusso di lavoro.

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

Contenuto correlato