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

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

Azure Logic Apps'te parametreleri 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 parametreleri 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 Azure Logic Apps için tek kiracılı ve çok kiracılı ve tümleştirme hizmeti ortamını gözden geçirin.

Ö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 kullanarak örnek tüketim mantıksal uygulaması iş akışı oluşturma veya Azure portal kullanarak örnek bir Standart mantıksal uygulama iş akışı oluşturma.

  Not

  Şu anda Yalnızca Azure portal kullanarak Tüketim mantıksal uygulaması iş akışları için parametreler oluşturabilirsiniz. Standart mantıksal uygulama iş akışları için parametreleri yalnızca Azure portal veya Visual Studio Code kullanarak 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çeneklerini içerir. Daha fazla bilgi için Tek kiracı tabanlı mantıksal uygulamalar için konak ve uygulama ayarlarını düzenleme bölümünü gözden geçirin.

Not

Standart mantıksal uygulama iş akışlarında ve secureobjectgibi securestring güvenli veri türleri desteklenmez. Ancak, alternatif bir seçenek olarak Uygulama ayarlarını Azure Key Vault ile kullanabilirsiniz. Daha sonra bağlantı dizeleri ve anahtarlar gibi güvenli dizelere doğrudan başvurabilirsiniz. Dağıtım zamanında ortam değişkenlerini tanımlayabileceğ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.

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 örneği yelpazesi sunar.

Örneğin, iş akışlarını yerel olarak çalıştırmak için yerel geliştirme aracı olarak Visual Studio Code kullanırsanız, mantıksal uygulama projenizde parameters.json dosyasını kullanarak parametreler tanımlayabilirsiniz. Daha sonra bu parametre dosyasındaki herhangi bir parametreye projenizin workflow.json dosyasındaki herhangi bir iş akışından veya projenizin connections.json dosyasındaki herhangi bir bağlantı nesnesinden 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ı bulun. 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. Ardından connections.json dosyanızı kaynak denetimine denetleyebilirsiniz ve ardından 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 tutan 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, uygulama ayarlarını değil değerleri parametreleştirmenin varsayılan yolu olarak parametreleri 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

Azure portal

1. Azure portal 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.

2. Tasarımcı araç çubuğundan Parametreler'i seçin.

   

3. Parametreler bölmesinde Parametre ekle'yi seçin.

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

   Özellik	Gerekli	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	No	Parametresinin gerçek değeri.

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

   

5. 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.

6. 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:

      

7. Mantıksal uygulama iş akışındaki 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.

Standart

Azure portal

1. Azure portal mantıksal uygulama kaynağınızı açın. İş Akışları'nın altında iş akışınızı tasarımcıda açın.

2. Tasarımcı araç çubuğundan Parametreler'i seçin.

   

3. Parametreler bölmesinde Parametre oluştur'u seçin.

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

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

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

   

5. İş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.

6. 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:

      

7. 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

1. parameters.json adlı proje kök düzeyi JSON dosyasında tüm parametreleri ve değerlerini tanımlayın. Bu dosya anahtar-değer çiftleri içeren bir nesnesine sahiptir. Her anahtar her parametrenin adıyken, her değer her parametrenin yapısıdır. Her yapının hem a typevalue 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 değerlerini tanımlamalı ve içermelidir.

   Aşağıdaki örnekte temel bir 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.

2. 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 kısıtlanır. Geliştirme için tasarımcıyı kullanmanız gerekiyorsa, bunun yerine parametreli olmayan 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ştiriliyor.

Aşağıdaki örnekte hem uygulama ayarlarını hem de parametreleri kullanan parametreli connections.json dosyası gösterilmektedir. Mümkün olduğunca parametreleri kullanmak istemenize rağmen, uygulama ayarları dağıtım sırasında oluşturulduğundan ve geliştirme işlem hattında dinamik olarak doldurulabildiğinden, bu senaryo parametreler üzerinde 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ızdaki 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 varsa, bu ifadeyi küme ayraçları ({} ) 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 kullanma konusunda dikkat edilmesi gerekenler.

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 değerleri hedeflemiş olabilirsiniz. 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 parametre 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ı bir mantıksal uygulama projeniz varsa, proje dosyanızı (<logic-app-name.csproj>) derleme çıktısı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 veya iş akışı tasarımcısında mevcut değildir.

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:

• Tek kiracılı mantıksal uygulamalar için DevOps dağıtımına genel bakış
• Tek kiracılı mantıksal uygulamalar için DevOps dağıtımı ayarlama

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çenekleri içerir. İş akışlarını Visual Studio Code 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 mantıksal uygulama kaynağınızın uygulama ayarlarını gözden geçirmek için şu adımları izleyin:

1. Azure portal mantıksal uygulama kaynağınızı açın.

2. Mantıksal uygulama menünüzün Ayarlar'ın altında Yapılandırma'yı seçin.

3. Yapılandırma sayfasındaki Uygulama ayarları sekmesinde mantıksal uygulamanızın uygulama ayarlarını gözden geçirin.

4. 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:

1. Uygulama ayarları sekmesindeki Uygulama ayarları'nın altında Yeni uygulama ayarı'nı seçin.

2. Ad alanına yeni ayarınızın anahtarını veya adını girin.

3. Değer alanına yeni ayarınızın değerini girin.

4. Yeni anahtar-değer çiftinizi oluşturmaya hazır olduğunuzda Tamam'ı seçin.

   

5. İş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. Komutunuzda ve --resource-group -g parametrelerinin bulunduğundan --name n emin olun. Örneğin, aşağıdaki komut adlı bir anahtar CUSTOM_LOGIC_APP_SETTING ile değeriyle 12345bir 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 . Tam kaynak tanımı için bkz. ARM şablonu başvurusu.

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

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

Sonraki adımlar

• Azure Logic Apps için tek kiracılı ve çok kiracılı ve tümleştirme hizmeti ortamı karşılaştırması