Tworzenie parametrów między środowiskami dla danych wejściowych przepływu pracy w usłudze Azure Logic Apps
Dotyczy: Azure Logic Apps (Zużycie + Standardowa)
W usłudze Azure Logic Apps możesz abstrakcyjne wartości, które mogą ulec zmianie w przepływach pracy w środowiskach deweloperskich, testowych i produkcyjnych, definiując parametry. Jeśli używasz parametrów, a nie zmiennych specyficznych dla środowiska, możesz początkowo skupić się bardziej na projektowaniu przepływów pracy i wstawić zmienne specyficzne dla środowiska później.
W tym artykule przedstawiono sposób tworzenia, używania i edytowania parametrów dla przepływów pracy aplikacji logiki z wieloma dzierżawami oraz przepływów pracy aplikacji logiki w warstwie Standardowa dla jednej dzierżawy. Dowiesz się również, jak zarządzać zmiennymi środowiskowymi.
Aby uzyskać więcej informacji na temat wielodostępnych i jednodostępnych usługi Azure Logic Apps, zapoznaj się z tematem Single-tenant versus multi-tenant and integration service environment for Azure Logic Apps (Jednodostępne i wielodostępne środowisko usług integracji dla usługi Azure Logic Apps).
Wymagania wstępne
Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.
Przepływ pracy aplikacji logiki Zużycie lub Standardowa
Jeśli nie masz jeszcze przepływu pracy aplikacji logiki, zobacz Tworzenie przykładowego przepływu pracy aplikacji logiki Zużycie przy użyciu Azure Portal lub Tworzenie przykładowego przepływu pracy aplikacji logiki w warstwie Standardowa przy użyciu Azure Portal.
Uwaga
Obecnie można tworzyć parametry dla przepływów pracy aplikacji logiki zużycie tylko przy użyciu Azure Portal. Parametry dla przepływów pracy aplikacji logiki w warstwie Standardowa można tworzyć tylko przy użyciu Azure Portal lub Visual Studio Code.
Parametry dla przepływów pracy aplikacji logiki w warstwie Standardowa i Zużycie
W przypadku przepływów pracy aplikacji logiki Zużycie i Standardowa można zdefiniować parametry przy użyciu projektanta. Po zdefiniowaniu parametru można odwoływać się do tego parametru z dowolnego przepływu pracy lub połączenia, które znajduje się w tym samym zasobie aplikacji logiki.
W przepływach pracy aplikacji logiki z wieloma dzierżawami po utworzeniu i użyciu parametrów w projektancie należy zdefiniować i ustawić zmienne środowiskowe w szablonie usługi Azure Resource Manager (szablon usługi ARM) i plikach parametrów szablonu. W tym scenariuszu musisz zdefiniować i ustawić parametry we wdrożeniu, co oznacza, że nawet jeśli trzeba zmienić tylko jedną zmienną, musisz ponownie wdrożyć szablon usługi ARM aplikacji logiki.
W przepływach pracy aplikacji logiki w warstwie Standardowa z jedną dzierżawą można pracować ze zmiennymi środowiskowymi zarówno w czasie wykonywania, jak i we wdrożeniu przy użyciu parametrów i ustawień aplikacji. Ustawienia aplikacji zawierają globalne opcje konfiguracji dla wszystkich przepływów pracy w tym samym zasobie aplikacji logiki. Aby uzyskać więcej informacji, zobacz Edytowanie ustawień hosta i aplikacji dla aplikacji logiki opartych na jednej dzierżawie.
Uwaga
W przepływach pracy aplikacji logiki w warstwie Standardowa bezpieczne typy danych, takie jak securestring
i secureobject
, nie są obsługiwane. Alternatywną opcją jest jednak użycie ustawień aplikacji w usłudze Azure Key Vault.
Następnie można bezpośrednio odwoływać się do bezpiecznych parametrów, takich jak parametry połączenia i klucze. Podobnie jak w przypadku szablonów usługi ARM, w których można zdefiniować zmienne środowiskowe w czasie wdrażania, można zdefiniować ustawienia aplikacji w definicji przepływu pracy aplikacji logiki. Następnie można przechwytywać dynamicznie generowane wartości infrastruktury, takie jak punkty końcowe połączenia, parametry magazynu i nie tylko.
Jednak ustawienia aplikacji mają limity rozmiaru i nie można odwoływać się do niektórych obszarów w usłudze Azure Logic Apps. Parametry oferują szerszy zakres przypadków użycia niż ustawienia aplikacji, takie jak obsługa dużych rozmiarów wartości i złożonych obiektów.
Jeśli na przykład używasz Visual Studio Code jako lokalnego narzędzia programistycznego do lokalnego uruchamiania przepływów pracy, w projekcie aplikacji logiki możesz zdefiniować parametry przy użyciu pliku parameters.json. Następnie możesz odwołać się do dowolnego parametru w tym pliku parametrów z dowolnego przepływu pracy w pliku workflow.json projektu lub z dowolnego obiektu połączenia w pliku connections.json projektu. Na poniższej liście opisano kilka typowych przypadków użycia:
Plik parametrów testu, który zawiera wszystkie wartości, które są używane podczas testowania. Podczas wdrażania możesz zastąpić plik parametrów testu plikiem parametrów produkcyjnych.
Sparametryzuj różne części pliku connections.json . Następnie możesz sprawdzić plik connections.json w kontroli źródła, a następnie zarządzać dowolnymi połączeniami za pośrednictwem pliku parameters.json .
Sparametryzuj złożone obiekty, takie jak
authentication
obiekt JSON. Można na przykład zastąpićauthentication
wartość obiektu ciągiem zawierającym jedno wyrażenie parametrów, takie jak@parameters('api-auth')
.Przejrzyj i edytuj ustawienia aplikacji w pliku local.settings.json projektu. Następnie możesz odwołać się do tych ustawień aplikacji w parametrach.
Uwaga
Ogólnie zaleca się użycie parametrów jako domyślnego sposobu sparametryzowania wartości, a nie ustawień aplikacji. W ten sposób, gdy musisz przechowywać bezpieczne klucze lub ciągi, możesz postępować zgodnie z zaleceniem, aby odwołać się do ustawień aplikacji z parametrów. Jeśli chcesz, możesz użyć obu opcji w rozwiązaniu, używając parametrów do odwołowania się do ustawień aplikacji.
Definiowanie, używanie i edytowanie parametrów
Azure Portal
W Azure Portal otwórz przepływ pracy aplikacji logiki. W obszarze Przepływy pracy wybierz i otwórz przepływ pracy w projektancie.
Na pasku narzędzi projektanta wybierz pozycję Parametry.
W okienku Parametry wybierz pozycję Dodaj parametr.
Podaj następujące informacje o parametrze do utworzenia:
Właściwość Wymagane Opis Nazwa Tak Nazwa parametru do utworzenia. Typ Tak Typ danych parametru, taki jak Array, Bool, Float, Int, Object, Secure Object, Secure Object, Secure String i String. Wartość domyślna Tak Wartość domyślna parametru. Należy określić domyślną wartość parametru, ponieważ logika przepływu pracy, informacje o połączeniu i wartości parametrów nie istnieją w jednej lokalizacji. Projektant musi mieć możliwość rozpoznania wartości parametrów przed załadowaniem.
Ważne: w przypadku typów danych Secure Object i Secure String unikaj ustawiania wartości domyślnej, ponieważ wartość jest przechowywana jako zwykły tekst.Wartość rzeczywista Nie Rzeczywista wartość parametru. W poniższym przykładzie przedstawiono definicję parametru ciągu:
Jeśli masz więcej parametrów do dodania, wybierz pozycję Dodaj parametr. W przeciwnym razie zamknij okienko parametrów, ale pamiętaj, aby zapisać przepływ pracy, aby zapisać nową definicję parametrów.
Aby odwołać się do parametru z wyzwalacza lub akcji, która znajduje się w tym samym przepływie pracy, wykonaj następujące kroki:
W projektancie otwórz żądany przepływ pracy i rozwiń wyzwalacz lub akcję.
W właściwości, w której chcesz użyć parametru, kliknij wewnątrz pola edycji tej właściwości.
Na liście zawartości dynamicznej, która zostanie otwarta w obszarze Parametry, wybierz wcześniej utworzony parametr, na przykład:
Aby wyświetlić lub edytować parametry w przepływie pracy aplikacji logiki, wykonaj następujące kroki:
Otwórz przepływ pracy aplikacji logiki w projektancie. Na pasku narzędzi projektanta wybierz pozycję Parametry.
Zostanie otwarte okienko Parametry i wyświetli wszystkie parametry zdefiniowane dla tego przepływu pracy.
Wprowadź zmiany, zamknij okienko parametrów i zapisz przepływ pracy aplikacji logiki.