Azure Logic Apps'te iş akışı girişleri için ortamlar arası parametreler oluşturma

Makale
08/06/2024

Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)

Azure Logic Apps'te parametreler tanımlayarak geliştirme, test ve üretim ortamlarında iş akışlarında değişebilecek değerleri soyutlayabilirsiniz. Ortama özgü değişkenler yerine parametreler kullandığınızda, başlangıçta iş akışlarınızı tasarlamaya daha fazla odaklanabilir ve ortama özgü değişkenleri daha sonra ekleyebilirsiniz.

Bu makalede, çok kiracılı Tüketim mantıksal uygulaması iş akışları ve tek kiracılı Standart mantıksal uygulama iş akışları için parametrelerin nasıl oluşturulacağı, kullanılacağı ve düzenleyebileceğiniz anlatlanmaktadır. Ayrıca ortam değişkenlerini yönetmeyi de öğreneceksiniz.

Çok kiracılı ve tek kiracılı Azure Logic Apps hakkında daha fazla bilgi için Bkz . Azure Logic Apps'te tek kiracılı ve çok kiracılı.

Önkoşullar

Bir Azure hesabı ve aboneliği Aboneliğiniz yoksa, ücretsiz bir Azure hesabı için kaydolun.
Tüketim veya Standart mantıksal uygulama iş akışı

Henüz bir mantıksal uygulama iş akışınız yoksa bkz. Azure portalını kullanarak örnek bir Tüketim mantıksal uygulaması iş akışı oluşturma veya Azure portalını kullanarak örnek bir Standart mantıksal uygulama iş akışı oluşturma.

Not

Şu anda Yalnızca Azure portalını kullanarak Tüketim mantıksal uygulaması iş akışları için parametreler oluşturabilirsiniz. Standart mantıksal uygulama iş akışları için yalnızca Azure portalını veya Visual Studio Code'u kullanarak parametreler oluşturabilirsiniz.

Tüketim ve Standart mantıksal uygulama iş akışları için parametreler

Hem Tüketim hem de Standart mantıksal uygulama iş akışları için tasarımcıyı kullanarak parametreler tanımlayabilirsiniz. Parametresini tanımladıktan sonra, aynı mantıksal uygulama kaynağındaki herhangi bir iş akışından veya bağlantıdan bu parametreye başvurabilirsiniz.

Çok kiracılı Tüketim mantıksal uygulaması iş akışlarında, tasarımcıda parametreleri oluşturup kullandıktan sonra, Azure Resource Manager şablonunuzda (ARM şablonu) ve şablon parametre dosyalarınızda ortam değişkenlerini tanımlar ve ayarlarsınız. Bu senaryoda, dağıtımda parametreleri tanımlamanız ve ayarlamanız gerekir; başka bir deyişle yalnızca bir değişkeni değiştirmeniz gerekse bile mantıksal uygulamanızın ARM şablonunu yeniden dağıtmanız gerekir.

Tek kiracılı Standart mantıksal uygulama iş akışlarında, parametreleri ve uygulama ayarlarını kullanarak hem çalışma zamanında hem de dağıtımda ortam değişkenleriyle çalışabilirsiniz. Uygulama ayarları, aynı mantıksal uygulama kaynağındaki tüm iş akışları için genel yapılandırma seçenekleri içerir. Daha fazla bilgi için Tek kiracı tabanlı mantıksal uygulamalar için konak ve uygulama ayarlarını düzenleme'yi gözden geçirin.

Önemli

Kullanıcı adları ve parolalar içeren bağlantı dizesi gibi hassas bilgileriniz varsa, kullanılabilir en güvenli kimlik doğrulama akışını kullandığınızdan emin olun. Örneğin, Standart mantıksal uygulama iş akışlarında ve secureobjectgibi securestring güvenli veri türleri desteklenmez. Microsoft, mümkün olduğunda yönetilen kimlikle Azure kaynaklarına erişimin kimliğini doğrulamanızı ve gerekli en düşük ayrıcalığı olan bir rol atamanızı önerir.

Bu özellik kullanılamıyorsa, uygulama ayarlarıyla kullanabileceğiniz Azure Key Vault gibi diğer ölçüler aracılığıyla bağlantı dizesi güvenliğini sağlamayı unutmayın. Daha sonra bağlantı dizesi ve anahtarlar gibi güvenli dizelere doğrudan başvurabilirsiniz. Dağıtım zamanında ortam değişkenlerini tanımlayabildiğiniz ARM şablonlarına benzer şekilde, mantıksal uygulama iş akışı tanımınızda uygulama ayarlarını tanımlayabilirsiniz. Daha sonra bağlantı uç noktaları, depolama dizeleri ve daha fazlası gibi dinamik olarak oluşturulan altyapı değerlerini yakalayabilirsiniz. Daha fazla bilgi için bkz. Microsoft kimlik platformu için uygulama türleri.

Ancak uygulama ayarlarının boyut sınırları vardır ve Azure Logic Apps'teki belirli alanlardan başvurulamazsınız. Parametreler, büyük değer boyutları ve karmaşık nesneler için destek gibi uygulama ayarlarından daha geniş bir kullanım örnekleri yelpazesi sunar.

Örneğin, iş akışlarını yerel olarak çalıştırmak için yerel geliştirme aracı olarak Visual Studio Code kullanıyorsanız, mantıksal uygulama projenizde parameters.json dosyasını kullanarak parametreler tanımlayabilirsiniz. Daha sonra projenizin workflow.json dosyasındaki herhangi bir iş akışından veya projenizin connections.json dosyasındaki herhangi bir bağlantı nesnesinden bu parametre dosyasındaki herhangi bir parametreye başvurabilirsiniz. Aşağıdaki listede birkaç yaygın kullanım örneği açıklanmaktadır:

Test sırasında kullandığınız tüm değerleri içeren bir test parametreleri dosyasına sahip olun. Dağıtım sırasında test parametreleri dosyanızı üretim parametreleri dosyanızla değiştirebilirsiniz.
connections.json dosyanızın farklı bölümlerini parametreleştirin. Daha sonra connections.json dosyanızı kaynak denetimine denetledikten sonra parameters.json dosyanız aracılığıyla tüm bağlantıları yönetebilirsiniz.
JSON nesnesi gibi karmaşık nesneleri parametreleştirin authentication . Örneğin, nesne değerini gibi @parameters('api-auth')tek bir parametre ifadesini barındıran bir dizeyle değiştirebilirsinizauthentication.
Projenizin local.settings.json dosyasındaki uygulama ayarlarını gözden geçirin ve düzenleyin. Ardından parametrelerinizde bu uygulama ayarlarına başvurabilirsiniz.

Not

Genel bir öneri olarak, parametreleri uygulama ayarlarını değil, değerleri parametreleştirmenin varsayılan yolu olarak kullanmayı göz önünde bulundurun. Bu şekilde, güvenli anahtarları veya dizeleri depolamanız gerektiğinde, parametrelerinizden uygulama ayarlarına başvurmak için öneriyi izleyebilirsiniz. İsterseniz, uygulama ayarlarına başvurmak için parametreleri kullanarak çözümünüzdeki her iki seçeneği de kullanabilirsiniz.

Parametreleri tanımlama, kullanma ve düzenleme

Tüketim
Standart

Azure portal

Azure portalında mantıksal uygulama iş akışınızı açın. İş Akışları'nın altında iş akışınızı seçin ve tasarımcıda açın.
Tasarımcı araç çubuğundan Parametreler'i seçin.
Parametreler bölmesinde Parametre ekle'yi seçin.

Oluşturulacak parametre hakkında aşağıdaki bilgileri sağlayın:

Özellik	Zorunlu	Açıklama
Adı	Yes	Oluşturulacak parametrenin adı.
Tür	Yes	Array, Bool, Float, Int, Object, Secure Object, Secure String ve String gibi parametrenin veri türü.
Varsayılan Değer	Yes	parametresi için varsayılan değer. İş akışı mantığı, bağlantı bilgileri ve parametre değerleri tek bir konumda bulunmadığından varsayılan parametre değerini belirtmeniz gerekir. Tasarımcının yüklemeden önce parametre değerlerini çözümleyebilmesi gerekir. Önemli: Güvenli Nesne ve Güvenli Dize veri türleri için, değer düz metin olarak depolandığından varsayılan değer ayarlamaktan kaçının.
Gerçek Değer	Hayır	Parametresinin gerçek değeri.

Aşağıdaki örnekte bir dize parametresinin tanımı gösterilmektedir:

Örnek parametre tanımıyla Birlikte Azure portalı, Tüketim iş akışı tasarımcısı ve

Ekleyeceğiniz daha fazla parametre varsa Parametre Ekle'yi seçin. Aksi takdirde parametreler bölmesini kapatın, ancak yeni parametre tanımınızı kaydetmek için iş akışınızı kaydettiğinizden emin olun.
Aynı iş akışındaki bir tetikleyiciden veya eylemden parametreye başvurmak için şu adımları izleyin:
1. Tasarımcıda, istediğiniz iş akışını açın ve tetikleyiciyi veya eylemi genişletin.
2. parametresini kullanmak istediğiniz özellikte, bu özelliğin düzenleme kutusunun içine tıklayın.
3. Açılan dinamik içerik listesinden Parametreler'in altında daha önce oluşturduğunuz parametreyi seçin, örneğin:
Mantıksal uygulama iş akışında parametreleri görüntülemek veya düzenlemek için şu adımları izleyin:
1. Mantıksal uygulama iş akışını tasarımcıda açın. Tasarımcı araç çubuğunda Parametreler'i seçin.
  
  Parametreler bölmesi açılır ve bu iş akışı için tanımladığınız tüm parametreleri görüntüler.
2. Düzenlemelerinizi yapın, parametreler bölmesini kapatın ve mantıksal uygulama iş akışınızı kaydedin.

Azure portal

Azure portalında mantıksal uygulama kaynağınızı açın. İş Akışları'nın altında iş akışınızı tasarımcıda açın.
Tasarımcı araç çubuğundan Parametreler'i seçin.
Parametreler bölmesinde Parametre oluştur'u seçin.

Oluşturulacak parametre hakkında aşağıdaki bilgileri sağlayın:

Özellik	Zorunlu	Açıklama
Adı	Yes	Oluşturulacak parametrenin adı.
Tür	Yes	Array, Bool, Float, Int, Object ve String gibi parametrenin veri türü. Not: Standart mantıksal uygulama iş akışlarında ve `secureobject`gibi `securestring` güvenli veri türleri desteklenmez.
Value	Yes	parametresinin değeri. Standart mantıksal uygulama iş akışlarında, iş akışı mantığı, bağlantı bilgileri ve parametre değerleri tek bir konumda bulunmadığından parametre değerini belirtmeniz gerekir. Tasarımcının yüklemeden önce parametre değerlerini çözümleyebilmesi gerekir.

Aşağıdaki örnekte bir dize parametresinin tanımı gösterilmektedir:

Örnek parametre tanımıyla Azure portalını, Standart iş akışı tasarımcısını ve

İşiniz bittiğinde Parametreler bölmesini kapatın, ancak yeni parametre tanımınızı kaydetmek için iş akışınızı kaydettiğinizden emin olun.
Aynı mantıksal uygulama içindeki herhangi bir iş akışında bulunan bir tetikleyiciden veya eylemden parametreye başvurmak için şu adımları izleyin:
1. Tasarımcıda, istediğiniz iş akışını açın ve tetikleyiciyi veya eylemi genişletin.
2. parametresini kullanmak istediğiniz özellikte, bu özelliğin düzenleme kutusunun içine tıklayın.
3. Açılan dinamik içerik listesinden Parametreler'in altında daha önce oluşturduğunuz parametreyi seçin, örneğin:
Parametreleri aynı mantıksal uygulamada görüntülemek veya düzenlemek için aşağıdaki adımlardan birini izleyin:
- Bu mantıksal uygulamada herhangi bir iş akışını açın. İş akışı menüsünde Tasarımcı'yı seçin. Tasarımcı araç çubuğunda Parametreler'i seçin.
  
  Parametreler bölmesi açılır ve bu mantıksal uygulamadaki iş akışlarından tanımladığınız tüm parametreleri görüntüler.
- Toplu JSON'da görüntülemek veya düzenlemek için mantıksal uygulamanızın ana menüsünde Parametreler'i seçin.
  
  Parametreler JSON görünümü açılır ve bu mantıksal uygulamadaki iş akışlarından tanımladığınız tüm parametreleri görüntüler.

Visual Studio Code

parameters.json adlı proje kök düzeyi JSON dosyasında tüm parametreleri ve değerlerini tanımlayın. Bu dosyada anahtar-değer çiftleri içeren bir nesnesi var. Her anahtar her parametrenin adıdır, her değer ise her parametrenin yapısıdır. Her yapının hem bir type value hem de bildirimi içermesi gerekir.

Önemli

parameters.json dosyanız, iş akışı tanımları veya bağlantılar gibi projenizin başka bir yerinde başvurduğunuz veya kullandığınız tüm parametreleri ve bunların değerlerini tanımlamalı ve içermelidir.

Aşağıdaki örnekte temel parametre dosyası gösterilmektedir:
```
{
    "responseString": { 
        "type": "string", 
        "value": "hello" 
    },
    "functionAuth": { 
        "type": "object", 
        "value": { 
            "type": "QueryString", 
            "name": "Code", 
            "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
        }
    }
 }
```
Not

parameters.json dosyasındaki @appsetting tek geçerli ifade türüdür.
Tetikleyici veya eylem girişlerinizdeki parametrelere başvurmak için ifadesini @parameters('<parameter-name>')kullanın.

Bağlantı dosyasını parametreleştirme

connections.json dosyanızı parametreleştirmek için, gibi ConnectionRuntimeUrlsabit değerlerin değerlerini tek parameters() bir ifadeyle (örneğin, @parameters('api-runtimeUrl')) değiştirin. connections.json dosyasında yalnızca ve @appsettinggeçerli ifade türleri bulunur@parameters.

Önemli

Geliştirme sırasında connections.json dosyasını parametreleştirirseniz tasarımcı deneyimi hem yerel olarak hem de Azure portalında kısıtlanır. Geliştirme için tasarımcıyı kullanmanız gerekiyorsa, bunun yerine parametrelenmemiş bir connections.json dosyası kullanın. Ardından, dağıtım işlem hatlarınızda değerini parametreli dosyayla değiştirin. Çalışma zamanı parametreleştirme ile çalışmaya devam ediyor. Tasarımcı geliştirmeleri geliştirme aşamasındadır.

Aşağıdaki örnekte hem uygulama ayarlarını hem de parametreleri kullanan parametreli connections.json dosyası gösterilmektedir. Parametreleri mümkün olduğunca kullanmak isteseniz de, bu senaryo, uygulama ayarları dağıtım sırasında oluşturulduğundan ve geliştirme işlem hattında dinamik olarak doldurulabildiğinden parametreler üzerinden uygulama ayarlarını kullanacağınız bir özel durum veya uç durumdur. Bu örnek dosya, karmaşık blob_auth kimlik doğrulama nesnesi için bir parametre ve diğer değerler için uygulama ayarları kullanır. Bu durumda, iş akışınızda parametreye başvurma olasılığınız düşük olduğundan kimlik doğrulama nesnesi için bir parametre kullanabilirsiniz:

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

Not

Düz metinle satır içi bir ifadeniz olduğunda, bu ifadeyi küme ayracı ({} ) içine alarak bu ifade için ilişkilendirilmiş biçimi kullandığınızdan emin olun. Bu biçim ayrıştırma sorunlarını önlemeye yardımcı olur.

Örneğin, varsa "<text>/@<function-name>('<parameter-name>')/<text>", bunun yerine aşağıdaki sürümü kullanın: "<text>/@{<function-name>('<parameter-name>')}/<text>".

Daha fazla bilgi için bkz . İşlevleri kullanmayla ilgili önemli noktalar.

Parametre dosyalarını yönetme

Genellikle parametre dosyalarının birden çok sürümünü yönetmeniz gerekir. Geliştirme, test ve üretim gibi farklı dağıtım ortamları için hedeflenen değerleriniz olabilir. Bu parametre dosyalarını yönetmek genellikle ARM şablonu parametre dosyalarını yönetmek gibi çalışır. Belirli bir ortama dağıttığınızda, genellikle DevOps için bir işlem hattı aracılığıyla ilgili parametreler dosyasını yükseltebilirsiniz.

Parametre dosyalarını Azure CLI kullanarak dinamik olarak değiştirmek için aşağıdaki komutu çalıştırın:

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

NuGet tabanlı mantıksal uygulama projeniz varsa, proje dosyanızı (<logic-app-name.csproj>) derleme çıkışına parametre dosyasını içerecek şekilde güncelleştirmeniz gerekir, örneğin:

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

Not

Şu anda parametre dosyalarını dinamik olarak değiştirme özelliği henüz Azure portalında veya iş akışı tasarımcısında kullanılamamaktadır.

DevOps dağıtımları için mantıksal uygulamalarınızı ayarlama hakkında daha fazla bilgi için aşağıdaki belgeleri gözden geçirin:

Uygulama ayarlarını yönetme

Tek kiracılı Azure Logic Apps'te uygulama ayarları, aynı mantıksal uygulamadaki tüm iş akışları için genel yapılandırma seçeneklerini içerir. İş akışlarını Visual Studio Code'da yerel olarak çalıştırdığınızda, bu uygulama ayarlarına local.settings.json dosyasında yerel ortam değişkenleri olarak erişebilirsiniz. Ardından parametrelerinizde bu uygulama ayarlarına başvurabilirsiniz.

Uygulama ayarlarını eklemek, güncelleştirmek veya silmek için Visual Studio Code, Azure portalı, Azure CLI veya ARM (Bicep) şablonu için aşağıdaki bölümleri seçin ve gözden geçirin.

Azure portal

Azure portalında mantıksal uygulama kaynağınızın uygulama ayarlarını gözden geçirmek için şu adımları izleyin:

Azure portalında mantıksal uygulama kaynağınızı açın.
Mantıksal uygulama menünüzün Ayarlar'ın altında Yapılandırma'yı seçin.
Yapılandırma sayfasındaki Uygulama ayarları sekmesinde mantıksal uygulamanızın uygulama ayarlarını gözden geçirin.
Tüm değerleri görüntülemek için Değerleri Göster'i seçin. Ya da tek bir değeri görüntülemek için bu değeri seçin.

Yeni bir ayar eklemek için şu adımları izleyin:

Uygulama ayarları sekmesinde, Uygulama ayarları'nın altında Yeni uygulama ayarı'nı seçin.
Ad alanına yeni ayarınızın anahtarını veya adını girin.
Değer için yeni ayarınızın değerini girin.
Yeni anahtar-değer çiftinizi oluşturmaya hazır olduğunuzda Tamam'ı seçin.
İşiniz bittiğinde, Yapılandırma araç çubuğunda Kaydet'i seçin.

Azure CLI

Azure CLI kullanarak geçerli uygulama ayarlarınızı gözden geçirmek için komutunu az logicapp config appsettings listçalıştırın. Komutunuzda ve --resource-group -g parametrelerinin bulunduğundan --name -n emin olun, örneğin:

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

Azure CLI kullanarak bir uygulama ayarı eklemek veya güncelleştirmek için komutunu az logicapp config appsettings setçalıştırın. Komutunuz ve --resource-group -g parametrelerini içerdiğinden --name n emin olun. Örneğin, aşağıdaki komut değeriyle 12345adlı CUSTOM_LOGIC_APP_SETTING anahtarla bir ayar oluşturur:

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

Resource Manager veya Bicep şablonu

Uygulama ayarlarınızı BIR ARM şablonunda veya Bicep şablonunda gözden geçirmek ve tanımlamak için mantıksal uygulamanızın kaynak tanımını bulun ve JSON nesnesini güncelleştirin appSettings . Kaynak tanımının tamamı için ARM şablonu başvurusuna bakın.

Bu örnekte ARM şablonları veya Bicep şablonları için dosya ayarları gösterilmektedir:

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

Azure Logic Apps'te tek kiracılı ve çok kiracılı karşılaştırma

Aracılığıyla paylaş

Azure Logic Apps'te iş akışı girişleri için ortamlar arası parametreler oluşturma

Önkoşullar

Tüketim ve Standart mantıksal uygulama iş akışları için parametreler

Parametreleri tanımlama, kullanma ve düzenleme

Azure portal

Azure portal

Visual Studio Code

Bağlantı dosyasını parametreleştirme

Parametre dosyalarını yönetme

Uygulama ayarlarını yönetme

Azure portal

Azure CLI

Resource Manager veya Bicep şablonu

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Azure Logic Apps'te iş akışı girişleri için ortamlar arası parametreler oluşturma

Önkoşullar

Tüketim ve Standart mantıksal uygulama iş akışları için parametreler

Parametreleri tanımlama, kullanma ve düzenleme

Azure portal

İlgili içerik

Geri Bildirim

Ek kaynaklar