Vytvoření parametrů mezi prostředími pro vstupy pracovního postupu v Azure Logic Apps

Platí pro: Azure Logic Apps (Consumption + Standard)

V Azure Logic Apps můžete abstrahovat hodnoty, které se můžou měnit v pracovních postupech napříč vývojovými, testovacími a produkčními prostředími definováním parametrů. Pokud místo proměnných specifických pro prostředí používáte parametry, můžete se nejprve zaměřit na navrhování pracovních postupů a později vložit proměnné specifické pro prostředí.

Tento článek popisuje, jak vytvářet, používat a upravovat parametry pro pracovní postupy víceklientských aplikací logiky Consumption a pro pracovní postupy standardní aplikace logiky s jedním tenantem. Dozvíte se také, jak spravovat proměnné prostředí.

Další informace o víceklientských a jednoklientských Azure Logic Apps najdete v Azure Logic Apps v jednom tenantovi a víceklientovi.

Požadavky

• Účet a předplatné Azure. Pokud předplatné nemáte, zaregistrujte si bezplatný účet Azure.

• Pracovní postup aplikace logiky Consumption nebo Standard

  Pokud ještě nemáte pracovní postup aplikace logiky, přečtěte si téma Vytvoření ukázkového pracovního postupu aplikace logiky Consumption pomocí webu Azure Portal nebo Vytvoření ukázkového pracovního postupu standardní aplikace logiky pomocí webu Azure Portal.

  Poznámka:

  V současné době můžete vytvářet parametry pro pracovní postupy aplikace logiky Consumption pouze pomocí webu Azure Portal. Parametry pro pracovní postupy standardní aplikace logiky můžete vytvářet jenom pomocí webu Azure Portal nebo editoru Visual Studio Code.

Parametry pro pracovní postupy aplikace logiky Consumption a Standard

Pro pracovní postupy aplikace logiky Consumption i Standard můžete definovat parametry pomocí návrháře. Po definování parametru můžete na tento parametr odkazovat z libovolného pracovního postupu nebo připojení, které je ve stejném prostředku aplikace logiky.

V pracovních postupech víceklientské aplikace logiky Consumption po vytvoření a použití parametrů v návrháři definujete a nastavíte proměnné prostředí v šabloně Azure Resource Manageru (šablona ARM) a souborech parametrů šablony. V tomto scénáři musíte definovat a nastavit parametry při nasazení, což znamená, že i když potřebujete změnit jenom jednu proměnnou, musíte znovu nasadit šablonu ARM aplikace logiky.

V pracovních postupech aplikace logiky úrovně Standard s jedním tenantem můžete pracovat s proměnnými prostředí za běhu i nasazením pomocí parametrů a nastavení aplikace. Nastavení aplikace obsahuje globální možnosti konfigurace pro všechny pracovní postupy ve stejném prostředku aplikace logiky . Další informace najdete v tématu Úprava nastavení hostitele a aplikace pro aplikace logiky založené na jednom tenantovi.

Důležité

Pokud máte citlivé informace, například připojovací řetězec, které obsahují uživatelská jména a hesla, ujistěte se, že používáte nejbezpečnější dostupný tok ověřování. Například v pracovních postupech standardní aplikace logiky nejsou podporované zabezpečené datové typy, například securestring a secureobject. Microsoft doporučuje ověřit přístup k prostředkům Azure pomocí spravované identity , pokud je to možné, a přiřadit roli, která má minimální potřebná oprávnění.

Pokud tato funkce není dostupná, nezapomeňte zabezpečit připojovací řetězec prostřednictvím jiných měr, jako je Azure Key Vault, které můžete použít s nastavením aplikace. Pak můžete přímo odkazovat na zabezpečené řetězce, jako jsou připojovací řetězec a klíče. Podobně jako šablony ARM, kde můžete definovat proměnné prostředí v době nasazení, můžete definovat nastavení aplikace v definici pracovního postupu aplikace logiky. Pak můžete zaznamenávat dynamicky generované hodnoty infrastruktury, jako jsou koncové body připojení, řetězce úložiště a další. Další informace najdete v tématu Typy aplikací pro platformu Microsoft Identity Platform.

Nastavení aplikace ale mají omezení velikosti a nejde na to odkazovat z určitých oblastí v Azure Logic Apps. Parametry nabízejí širší škálu případů použití než nastavení aplikace, jako je podpora velkých velikostí hodnot a složitých objektů.

Pokud například jako místní vývojový nástroj používáte Visual Studio Code ke spouštění pracovních postupů místně, můžete v projektu aplikace logiky definovat parametry pomocí souboru parameters.json . Pak můžete odkazovat na libovolný parametr v tomto souboru parametrů z libovolného pracovního postupu v souboru workflow.json projektu nebo z jakéhokoli objektu připojení v souboru connections.json projektu. Následující seznam popisuje několik běžných případů použití:

• Mít soubor parametrů testu, který obsahuje všechny hodnoty, které používáte během testování. V nasazení můžete soubor testovacích parametrů nahradit souborem produkčních parametrů.

• Parametrizujte různé části souboru connections.json . Potom můžete zkontrolovat connections.json soubor do správy zdrojového kódu a pak spravovat všechna připojení prostřednictvím parameters.json souboru.

• Parametrizovat složité objekty, jako authentication je například objekt JSON. Hodnotu objektu authentication můžete například nahradit řetězcem, který obsahuje jeden výraz parametrů, například @parameters('api-auth').

• Zkontrolujte a upravte nastavení aplikace v souboru local.settings.json projektu. Na tato nastavení aplikace pak můžete odkazovat ve svých parametrech.

Poznámka:

Obecně doporučujeme použít parametry jako výchozí způsob parametrizace hodnot, nikoli nastavení aplikace. Když tedy potřebujete ukládat zabezpečené klíče nebo řetězce, můžete podle doporučení odkazovat na nastavení aplikace z vašich parametrů. Pokud chcete, můžete v řešení použít obě možnosti pomocí parametrů pro odkaz na nastavení aplikace.

Definování, použití a úprava parametrů

Využití

portál Azure

1. Na webu Azure Portal otevřete pracovní postup aplikace logiky. V části Pracovní postupy vyberte a otevřete pracovní postup v návrháři.

2. Na panelu nástrojů návrháře vyberte Parametry.

   

3. V podokně Parametry vyberte Přidat parametr.

4. Zadejte následující informace o parametru, který chcete vytvořit:

   Vlastnost	Požadováno	Popis
   Jméno	Ano	Název parametru, který se má vytvořit.
   Typ	Ano	Datový typ pro parametr, například Array, Bool, Float, Int, Object, Secure Object, Secure String a String.
   Výchozí hodnota	Ano	Výchozí hodnota parametru. Je nutné zadat výchozí hodnotu parametru, protože logika pracovního postupu, informace o připojení a hodnoty parametrů neexistují v jednom umístění. Návrhář musí být schopen před načtením přeložit hodnoty parametrů. Důležité: Pro datové typy Secure Object a Secure String nepoužívejte nastavení výchozí hodnoty, protože hodnota je uložena jako prostý text.
   Skutečná hodnota	No	Skutečná hodnota parametru.

   Následující příklad ukazuje definici parametru řetězce:

   

5. Pokud máte další parametry, které chcete přidat, vyberte Přidat parametr. V opačném případě zavřete podokno parametrů, ale nezapomeňte uložit pracovní postup a uložit novou definici parametru.

6. Pokud chcete odkazovat na parametr z triggeru nebo akce, která je ve stejném pracovním postupu, postupujte takto:

   1. V návrháři otevřete požadovaný pracovní postup a rozbalte trigger nebo akci.

   2. Ve vlastnosti, ve které chcete použít parametr, klikněte do textového pole této vlastnosti.

   3. V seznamu dynamického obsahu, který se otevře v části Parametry, vyberte dříve vytvořený parametr, například:

      

7. Pokud chcete zobrazit nebo upravit parametry v pracovním postupu aplikace logiky, postupujte takto:

   1. Otevřete pracovní postup aplikace logiky v návrháři. Na panelu nástrojů návrháře vyberte Parametry.

      Otevře se podokno Parametry a zobrazí se všechny parametry, které jste definovali pro tento pracovní postup.

   2. Proveďte úpravy, zavřete podokno parametrů a uložte pracovní postup aplikace logiky.

Standard

portál Azure

1. Na webu Azure Portal otevřete prostředek aplikace logiky. V části Pracovní postupy otevřete pracovní postup v návrháři.

2. Na panelu nástrojů návrháře vyberte Parametry.

   

3. V podokně Parametry vyberte Vytvořit parametr.

4. Zadejte následující informace o parametru, který chcete vytvořit:

   Vlastnost	Požadováno	Popis
   Jméno	Ano	Název parametru, který se má vytvořit.
   Typ	Ano	Datový typ pro parametr, například Array, Bool, Float, Int, Object a String. Poznámka: V pracovních postupech standardní aplikace logiky nejsou podporované zabezpečené datové typy, například securestring a secureobject.
   Hodnota	Ano	Hodnota parametru. V pracovních postupech standardní aplikace logiky musíte zadat hodnotu parametru, protože logika pracovního postupu, informace o připojení a hodnoty parametrů neexistují v jednom umístění. Návrhář musí být schopen před načtením přeložit hodnoty parametrů.

   Následující příklad ukazuje definici parametru řetězce:

   

5. Až budete hotovi, zavřete podokno Parametry , ale nezapomeňte uložit pracovní postup a uložit novou definici parametru.

6. Pokud chcete odkazovat na parametr z triggeru nebo akce, která je v jakémkoli pracovním postupu ve stejné aplikaci logiky, postupujte takto:

   1. V návrháři otevřete požadovaný pracovní postup a rozbalte trigger nebo akci.

   2. Ve vlastnosti, ve které chcete použít parametr, klikněte do textového pole této vlastnosti.

   3. V seznamu dynamického obsahu, který se otevře v části Parametry, vyberte dříve vytvořený parametr, například:

      

7. Pokud chcete zobrazit nebo upravit parametry ve stejné aplikaci logiky, postupujte následovně:

   • Otevřete libovolný pracovní postup v této aplikaci logiky. V nabídce pracovního postupu vyberte Návrhář. Na panelu nástrojů návrháře vyberte Parametry.

     Otevře se podokno Parametry a zobrazí se všechny parametry, které jste definovali z pracovních postupů v této aplikaci logiky.

   • Pokud chcete zobrazit nebo upravit hromadně JSON, vyberte v hlavní nabídce aplikace logiky parametry.

     Otevře se zobrazení JSON parametrů a zobrazí se všechny parametry, které jste definovali z pracovních postupů v této aplikaci logiky.

Visual Studio Code

1. V souboru JSON kořenové úrovně projektu s názvem parameters.json definujte všechny parametry a jejich hodnoty. Tento soubor obsahuje objekt, který obsahuje páry klíč-hodnota . Každý klíč je název každého parametru, zatímco každá hodnota je struktura každého parametru. Každá struktura musí obsahovat jak definici type value , tak i deklaraci.

   Důležité

   Soubor parameters.json musí definovat a obsahovat všechny parametry a jejich hodnoty, na které odkazujete nebo používáte jinde v projektu, například v definicích pracovního postupu nebo připojení.

   Následující příklad ukazuje základní soubor parametrů:

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

   Poznámka:

   V souboru @appsetting parameters.json je jediným platným typem výrazu.

2. Pokud chcete odkazovat na parametry ve vstupech triggeru nebo akce, použijte výraz @parameters('<parameter-name>').

Parametrizace souboru připojení

Chcete-li parametrizovat connections.json soubor, nahraďte hodnoty literálů, například ConnectionRuntimeUrl, jedním parameters() výrazem, @parameters('api-runtimeUrl')například . V souboru connections.json jsou jediné platné typy výrazů a @parameters @appsetting.

Důležité

Pokud parametrizujete soubor connections.json během vývoje, prostředí návrháře se omezí místně i na webu Azure Portal. Pokud potřebujete použít návrháře pro vývoj, použijte místo toho neparametrizovaný soubor connections.json . Potom v kanálech nasazení nahraďte parametrizovaným souborem. Modul runtime stále funguje s parametrizací. Vylepšení návrháře jsou ve vývoji.

Následující příklad ukazuje parametrizovaný soubor connections.json , který používá nastavení aplikace i parametry. I když chcete použít parametry tam, kde je to možné, je tento scénář výjimkou nebo hraničním případem, kdy byste použili nastavení aplikace pro parametry, protože nastavení aplikace se generují během nasazování a dají se dynamicky naplnit ve vývojovém kanálu. Tento ukázkový soubor používá parametr pro komplexní blob_auth objekt ověřování a nastavení aplikace pro ostatní hodnoty. V tomto případě můžete pro objekt ověřování použít parametr, protože pravděpodobně nebudete odkazovat na parametr v pracovním postupu:

{
   "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')"
      }
   }
}

Poznámka:

Pokud máte výraz, který je vložený s prostým textem, nezapomeňte pro tento výraz použít interpolovaný formát uzavřením výrazu se složenými složenými závorkami ({}). Tento formát pomáhá předcházet problémům při analýze.

Pokud máte "<text>/@<function-name>('<parameter-name>')/<text>"například , použijte místo toho následující verzi: "<text>/@{<function-name>('<parameter-name>')}/<text>".

Další informace najdete v tématu Důležité informace o používání funkcí.

Správa souborů parametrů

Obvykle potřebujete spravovat více verzí souborů parametrů. Můžete mít cílové hodnoty pro různá prostředí nasazení, jako je vývoj, testování a produkční prostředí. Správa těchto souborů parametrů často funguje jako správa souborů parametrů šablony ARM. Když nasadíte do konkrétního prostředí, zvýšíte úroveň odpovídajícího souboru parametrů, obvykle prostřednictvím kanálu pro DevOps.

Pokud chcete soubory parametrů dynamicky nahradit pomocí Azure CLI, spusťte následující příkaz:

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

Pokud máte projekt aplikace logiky založený na NuGetu, musíte aktualizovat soubor projektu (<logic-app-name.csproj>) tak, aby zahrnoval soubor parametrů ve výstupu sestavení, například:

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

Poznámka:

V současné době není možnost dynamicky nahrazovat soubory parametrů na webu Azure Portal nebo v návrháři pracovního postupu k dispozici.

Další informace o nastavení aplikací logiky pro nasazení DevOps najdete v následující dokumentaci:

• Přehled nasazení DevOps pro aplikace logiky založené na jednom tenantovi
• Nastavení nasazení DevOps pro aplikace logiky založené na jednom tenantovi

Správa nastavení aplikace

V Azure Logic Apps s jedním tenantem obsahují nastavení aplikace globální možnosti konfigurace pro všechny pracovní postupy ve stejné aplikaci logiky . Při místním spouštění pracovních postupů v editoru Visual Studio Code můžete k těmto nastavením aplikace přistupovat jako k místním proměnným prostředí v souboru local.settings.json . Na tato nastavení aplikace pak můžete odkazovat ve svých parametrech.

Pokud chcete přidat, aktualizovat nebo odstranit nastavení aplikace, vyberte a projděte si následující části šablony editoru Visual Studio Code, webu Azure Portal, Azure CLI nebo ARM (Bicep).

portál Azure

Pokud chcete zkontrolovat nastavení aplikace pro prostředek aplikace logiky na webu Azure Portal, postupujte takto:

1. Na webu Azure Portal otevřete prostředek aplikace logiky.

2. V nabídce aplikace logiky v části Nastavení vyberte Konfigurace.

3. Na stránce Konfigurace na kartě Nastavení aplikace zkontrolujte nastavení aplikace pro vaši aplikaci logiky.

4. Pokud chcete zobrazit všechny hodnoty, vyberte Zobrazit hodnoty. Pokud chcete zobrazit jednu hodnotu, vyberte tuto hodnotu.

Pokud chcete přidat nové nastavení, postupujte takto:

1. Na kartě Nastavení aplikace v části Nastavení aplikace vyberte Nové nastavení aplikace.

2. Do pole Název zadejte klíč nebo název nového nastavení.

3. Do pole Hodnota zadejte hodnotu nového nastavení.

4. Až budete připraveni vytvořit nový pár klíč-hodnota , vyberte OK.

   

5. Až budete hotovi, na panelu nástrojů Konfigurace vyberte Uložit.

Azure CLI

Pokud chcete zkontrolovat aktuální nastavení aplikace pomocí Azure CLI, spusťte příkaz az logicapp config appsettings list. Ujistěte se, že váš příkaz obsahuje parametry --name -n , --resource-group -g například:

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

Pokud chcete přidat nebo aktualizovat nastavení aplikace pomocí Azure CLI, spusťte příkaz az logicapp config appsettings set. Ujistěte se, že váš příkaz obsahuje parametry --name n a --resource-group -g parametry. Například následující příkaz vytvoří nastavení s klíčem pojmenovaným CUSTOM_LOGIC_APP_SETTING s hodnotou 12345:

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

Šablona Resource Manageru nebo Bicep

Pokud chcete zkontrolovat a definovat nastavení aplikace v šabloně ARM nebo v šabloně Bicep, vyhledejte definici prostředku aplikace logiky a aktualizujte appSettings objekt JSON. Úplnou definici prostředku najdete v referenčních informacích k šabloně ARM.

Tento příklad ukazuje nastavení souborů pro šablony ARM nebo šablony Bicep:

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

Související obsah

• Jednoklient a víceklient v Azure Logic Apps