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

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

Pokud potřebujete 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, můžete definovat parametry pracovního postupu. Pokud tyto parametry použijete místo proměnných specifických pro prostředí, můžete se zaměřit spíše na návrh obchodní logiky pracovního postupu a později vložit proměnné specifické pro prostředí.

Tento článek ukazuje, 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. Naučíte se také spravovat proměnné prostředí.

Další informace o víceklientských a jednoklientských Azure Logic Apps najdete v tématu Jednoklient a víceklient v Azure Logic Apps.

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í pracovního postupu aplikace logiky Consumption nebo Vytvoření standardního pracovního postupu aplikace logiky.

  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 vytvořit 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 pracovního postupu. Po definování parametru můžete na tento parametr odkazovat z libovolného pracovního postupu nebo připojení ve stejném prostředku aplikace logiky.

V pracovních postupech víceklientské aplikace logiky Consumption vytvoříte a použijete parametry v návrháři. Pak 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í. Tento požadavek 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 používáte citlivé informace, jako jsou připojovací řetězce, 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ězce jinými prostředky, 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í a řetězce úložiště. Další informace najdete v tématu Typy aplikací pro platformu Microsoft Identity Platform.

Nastavení aplikace má omezení velikosti. Nemůžete na ně také 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 vývojový nástroj používáte Visual Studio Code ke spouštění pracovních postupů místně, můžete definovat parametry pomocí souboruparameters.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 běžné případy použití:

• Mít soubor parametrů testu, který obsahuje všechny hodnoty, které používáte během testování. Při nasazení nahraďte soubor testovacích parametrů 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 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. Pak na tato nastavení aplikace odkazujte ve svých parametrech.

Poznámka:

Zvažte použití parametrů jako výchozího způsobu parametrizace hodnot místo 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ů. Obě možnosti ve vašem řešení můžete použít pomocí parametrů pro odkazování na nastavení aplikace.

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

Postup popisuje, jak pracovat s parametry pro pracovní postupy logické aplikace typu Consumption nebo Standard v Azure portálu.

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

   • U standardních logických aplikací v nabídce bočního panelu prostředku, v části Pracovní postupy, vyberte Pracovní postupy.

     Na stránce Pracovní postupy vyberte prázdný pracovní postup a otevřete návrháře.

   • U aplikací logiky Consumption v nabídce bočního panelu prostředků v části Vývojové nástroje vyberte návrháře pro otevření pracovního postupu.

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 (standardní)	Ano	Hodnota parametru. V pracovních postupech standardní aplikace logiky zadejte hodnotu parametru. Logika pracovního postupu, informace o připojení a hodnoty parametrů neexistují v jednom umístění. Konstruktér musí být schopen vyřešit hodnoty parametrů před načtením pracovního postupu.
   Výchozí hodnota (spotřeba)	Ano	Výchozí hodnota parametru. Musíte zadat výchozí hodnotu parametru. Logika pracovního postupu, informace o připojení a hodnoty parametrů neexistují v jednom umístění. Konstruktér musí být schopen vyřešit hodnoty parametrů před načtením pracovního postupu. 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 (spotřeba)	Ne	Skutečná hodnota parametru.

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

   

5. Až budete hotovi, zavřete podokno Parametry . Nezapomeňte uložit pracovní postup, abyste uložili novou definici parametru.

Pokud chcete odkazovat na parametr z triggeru nebo akce v jakémkoli pracovním postupu pro stejnou aplikaci logiky, postupujte takto:

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

2. V okně informací na kartě Parametry ve vlastnosti, kde chcete použít parametr, vyberte uvnitř editačního pole této vlastnosti. Výběrem ikony blesku otevřete seznam dynamického obsahu.

3. V seznamu v části Parametry vyberte dříve vytvořený parametr.

   

Zobrazení nebo úprava parametrů ve stejné aplikaci logiky:

1. Otevřete pracovní postup v návrháři pracovního postupu. Vyberte Vývojové nástroje>Návrhář aplikací logiky aplikace logiky Fon Consumption. U standardních logických aplikací vyberte Pracovní postupy>, pak vyberte pracovní postup pro otevření návrháře.

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

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

• Pouze standardní pracovní postupy: Chcete-li zobrazit nebo upravit JSON hromadně, vyberte na bočním panelu nabídky prostředku Parametry. V podokně Parametry vyberte Upravit ve formátu JSON.

  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

Tento postup popisuje, jak pracovat s parametry pro pracovní postupy standardní aplikace logiky pomocí editoru 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. Každá hodnota je struktura parametru. Každá struktura musí obsahovat jak definici typevalue , 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. Tento požadavek zahrnuje definice pracovních postupů a 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 parameters.json je @appsetting 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ý souborconnections.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. Tento ukázkový soubor používá parametr pro komplexní blob_auth objekt ověřování a nastavení aplikace pro ostatní hodnoty.

Pokud je to možné, chcete použít parametry. Vzhledem k tomu, že se nastavení aplikace generují během nasazování a dynamicky se naplňují v kanálu vývoje, měli byste v takovémto případě použít nastavení aplikace. V tomto případě můžete použít parametr pro objekt ověřování, 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 přímou součástí prostého textu, nezapomeňte použít interpolovaný formát tak, že tento výraz 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ů. Cílové hodnoty můžete použít 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 dynamického nahrazení souborů parametrů dostupná na webu Azure Portal ani v návrháři pracovního postupu.

Další informace o nastavení aplikací logiky pro nasazení DevOps najdete v následujících článcích:

• 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 aplikacích logiky úrovně Standard 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.

Následující části popisují, jak přidat, aktualizovat nebo odstranit nastavení aplikace pro Visual Studio Code, azure portal, Azure CLI a šablonu ARM (Bicep).

Kontrola nastavení aplikace pomocí webu Azure Portal

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 postranního panelu zdroje v části Nastavení zvolte Proměnné prostředí.

3. Na stránce Proměnné prostředí 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. V části Nastavení aplikace vyberte + Přidat.

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

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

4. V případě potřeby vyberte nastavení slotu nasazení.

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

Kontrola nastavení aplikace pomocí 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 

Kontrola a definování nastavení aplikace v souboru typu Resource Manager nebo Bicep

Pokud chcete zkontrolovat a definovat nastavení aplikace v šabloně ARM nebo souboru Bicep, vyhledejte definici prostředku logické aplikace 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 soubory Bicep:

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

Související obsah

• Jednoklient a víceklient v Azure Logic Apps