Vytváření parametrů mezi prostředími pro vstupy pracovních postupů v Azure Logic Apps

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

V Azure Logic Apps můžete definováním parametrů abstrahovat hodnoty, které se můžou měnit v pracovních postupech v různých vývojových, testovacích a produkčních prostředích. Když místo proměnných specifických pro prostředí použijete parametry, můžete se zpočátku více zaměřit na návrh pracovních postupů a později vložit proměnné specifické pro prostředí.

V tomto článku se dozvíte, jak vytvářet, používat a upravovat parametry pro pracovní postupy aplikací logiky Consumption s více tenanty a pro pracovní postupy standardních aplikací logiky pro jednoho tenanta. Dozvíte se také, jak spravovat proměnné prostředí.

Další informace o službě Azure Logic Apps pro více tenantů a jednom tenantovi najdete v tématu Věnovaném porovnání prostředí služby Azure Logic Apps pro jednoho tenanta a prostředí více tenantů a integračních služeb.

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í Azure Portal nebo Vytvoření ukázkového pracovního postupu standardní aplikace logiky pomocí Azure Portal.

  Poznámka

  V současné době můžete vytvářet parametry pro pracovní postupy aplikace logiky Consumption pouze pomocí Azure Portal. Parametry pro standardní pracovní postupy aplikací logiky můžete vytvářet pouze pomocí 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 aplikace logiky Consumption s více tenanty po vytvoření a použití parametrů v návrháři definujete a nastavíte proměnné prostředí v šabloně Azure Resource Manager (š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 šablonu ARM aplikace logiky nasadit znovu.

V pracovních postupech standardních aplikací logiky s jedním tenantem můžete pracovat s proměnnými prostředí za běhu i nasazení pomocí parametrů a nastavení aplikace. Nastavení aplikace obsahují možnosti globální 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.

Poznámka

Ve standardních pracovních postupech aplikace logiky se zabezpečené datové typy, jako securestring jsou a secureobject, nepodporují. Jako alternativní možnost ale můžete použít nastavení aplikace s Azure Key Vault. Pak můžete přímo odkazovat na zabezpečené řetězce, jako jsou připojovací řetězce a klíče. Podobně jako u šablon ARM, kde můžete definovat proměnné prostředí v době nasazení, můžete definovat nastavení aplikace v rámci definice pracovního postupu aplikace logiky. Potom můžete zachytit dynamicky generované hodnoty infrastruktury, jako jsou koncové body připojení, řetězce úložiště a další.

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

Pokud například používáte Visual Studio Code jako místní vývojový nástroj pro místní spouštění pracovních postupů v projektu aplikace logiky, můžete definovat parametry pomocí souboru parameters.json . Potom můžete odkazovat na libovolný parametr v tomto souboru parametrů z libovolného pracovního postupu v souboru workflow.json vašeho projektu nebo z libovolného objektu připojení v souboru connections.json vašeho 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žijete během testování. Při nasazení můžete soubor testovacích parametrů nahradit souborem produkčních parametrů.

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

• Parametrizace složitých objektů, 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 vašeho projektu. Na tato nastavení aplikace pak můžete odkazovat v parametrech.

Poznámka

Jako obecné doporučení zvažte použití parametrů jako výchozího způsobu parametrizace hodnot, nikoli nastavení aplikace. Když pak potřebujete ukládat zabezpečené klíče nebo řetězce, můžete postupovat podle doporučení a odkazovat na nastavení aplikace z parametrů. Pokud chcete, můžete ve svém řešení použít obě možnosti pomocí parametrů, které odkazují na nastavení aplikace.

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

Využití

portál Azure

1. V 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	Povinné	Popis
   Název	Ano	Název parametru, který se má vytvořit.
   Typ	Ano	Datový typ parametru, například Array, Bool, Float, Int, Object, Secure Object, Secure String a String.
   Výchozí hodnota	Ano	Výchozí hodnota parametru. Musíte 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 rozpoznat hodnoty parametrů před načtením. Důležité: U datových typů Secure Object (Zabezpečený objekt ) a Secure String (Zabezpečený řetězec ) nenastavujte výchozí hodnotu, protože hodnota je uložená jako prostý text.
   Skutečná hodnota	No	Skutečná hodnota parametru

   Následující příklad ukazuje definici řetězcového parametru:

   

5. Pokud chcete přidat více parametrů, vyberte Přidat parametr. V opačném případě zavřete podokno parametrů, ale nezapomeňte uložit pracovní postup, aby se nová definice parametru uložila.

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, vyberte v části Parametry 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 pro tento pracovní postup definovali.

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

Standard

portál Azure

1. V 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	Povinné	Popis
   Název	Yes	Název parametru, který se má vytvořit.
   Typ	Yes	Datový typ parametru, například Array, Bool, Float, Int, Object a String. Poznámka: V pracovních postupech standardních aplikací logiky se zabezpečené datové typy, jako securestring jsou a secureobject, nepodporují.
   Hodnota	Yes	Hodnota parametru. Ve standardních pracovních postupech 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 rozpoznat hodnoty parametrů před načtením.

   Následující příklad ukazuje definici řetězcového parametru:

   

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 libovolném pracovním postupu v rámci stejné aplikace 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, vyberte v části Parametry 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 dané aplikaci logiky.

   • Pokud chcete zobrazit nebo upravit v hromadném formátu JSON, v hlavní nabídce aplikace logiky vyberte Parametry.

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

Visual Studio Code

1. V kořenovém souboru JSON 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 pro každý parametr. Každá struktura musí obsahovat deklaraci i typevalue .

   Důležité

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

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

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

   Poznámka

   V souboru @appsettingparameters.json je jediný platný typ výrazu.

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

Parametrizace souboru připojení

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

Důležité

Pokud během vývoje parametrizujete soubor connections.json, prostředí návrháře se omezí místně i v Azure Portal. Pokud potřebujete pro vývoj použít návrháře, použijte místo toho soubor connections.json bez parametru. Pak v kanálech nasazení nahraďte parametrizovaným souborem. Modul runtime stále pracuje 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é, jedná se o výjimku nebo hraniční případ, kdy byste použili nastavení aplikace místo parametrů, protože nastavení aplikace se generují během nasazení a snadněji se dynamicky naplňují ve vývojovém kanálu. Tento ukázkový soubor používá parametr pro komplexní blob_auth ověřovací objekt a nastavení aplikace pro ostatní hodnoty. V takovém případě můžete pro objekt ověřování použít parametr, protože je nepravděpodobné, že na tento parametr v pracovním postupu nebudete odkazovat:

{
   "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ý do prostého textu, nezapomeňte pro tento výraz použít interpolovaný formát tím, že ho uzavřete do složených závorek ({}). 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ílené 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 podobně jako správa souborů parametrů šablony ARM. Při nasazení do konkrétního prostředí zvýšíte úroveň odpovídajícího souboru parametrů, obecně prostřednictvím kanálu pro DevOps.

Pokud chcete dynamicky nahradit soubory parametrů 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 soubor projektu (<název_aplikace.csproj>) aktualizovat tak, aby zahrnoval soubor parametrů do výstupu sestavení, například:

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

Poznámka

V současné době není schopnost dynamicky nahrazovat soubory parametrů v Azure Portal nebo 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. Když spouštíte pracovní postupy místně 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 v parametrech.

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

portál Azure

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

1. V 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. Nebo pokud chcete zobrazit jednu hodnotu, vyberte ji.

Chcete-li 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 příkaz obsahuje --name -n parametry a --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 příkaz obsahuje --name n parametry a --resource-group -g . Například následující příkaz vytvoří nastavení s klíčem s názvem 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 Manager nebo Bicep

Pokud chcete zkontrolovat a definovat nastavení aplikace v šabloně ARM nebo š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"
    },
    <...>
], 

Další kroky

• Porovnání prostředí s jedním tenantem a více tenantů a prostředí integrační služby pro Azure Logic Apps