Hızlı Başlangıç: Azure Logic Apps'te Azure CLI ile iş akışları oluşturma ve yönetme

Makale
01/04/2024

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

Bu hızlı başlangıçta, Azure CLI Logic Apps uzantısını () kullanarak Azure Logic Apps'te çalışan otomatik iş akışlarının nasıl oluşturulacağı ve yönetileceğini gösterilmektediraz logic. Komut satırından, bir mantıksal uygulama iş akışı tanımı için JSON dosyasını kullanarak çok kiracılı Azure Logic Apps'te tüketim mantıksal uygulaması oluşturabilirsiniz. Daha sonra komut satırından , show (get), updateve delete gibi listişlemleri çalıştırarak mantıksal uygulamanızı yönetebilirsiniz.

Uyarı

Azure CLI Logic Apps uzantısı şu anda deneyseldir ve müşteri desteği kapsamında değildir. Özellikle uzantıyı üretim ortamlarında kullanmayı seçerseniz, bu CLI uzantısını dikkatli kullanın.

Bu hızlı başlangıç şu anda yalnızca çok kiracılı Azure Logic Apps'te çalışan Tüketim mantıksal uygulaması iş akışları için geçerlidir. Azure CLI şu anda tek kiracılı Azure Logic Apps'te çalışan Standart mantıksal uygulama iş akışları için kullanılamıyor. Daha fazla bilgi için Bkz. Azure Logic Apps'te kaynak türü ve konak farklılıkları.

Azure Logic Apps'i yeni kullanıyorsanız Azure portal, Visual Studio ve Visual Studio Code aracılığıyla ilk Tüketim mantıksal uygulaması iş akışınızı oluşturmayı öğrenin.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun.
Yerel bilgisayarınızda yüklü Olan Azure CLI .
Bilgisayarınızda yüklü Olan Azure Logic Apps CLI uzantısı . Bu uzantıyı yüklemek için şu komutu kullanın: az extension add --name logic
Mantıksal uygulamanızın oluşturulacağı bir Azure kaynak grubu .

Önkoşul denetimi

Başlamadan önce ortamınızı doğrulayın:

Azure portal oturum açın ve komutunu çalıştırarak az loginaboneliğinizin etkin olup olmadığını denetleyin.
komutunu çalıştırarak az --versionterminalde veya komut penceresinde Azure CLI sürümünüzü denetleyin. En son sürüm için en son sürüm notlarını inceleyin.

En son sürüme sahip değilseniz, işletim sisteminiz veya platformunuzun yükleme kılavuzunu izleyerek yüklemenizi güncelleştirin.

Örnek - Kaynak grubu oluşturma

Mantıksal uygulamanız için henüz bir kaynak grubunuz yoksa, komutunu az group createkullanarak grubu oluşturun. Örneğin, aşağıdaki komut konumunda westusadlı testResourceGroup bir kaynak grubu oluşturur.

az group create --name testResourceGroup --location westus

Çıkışta kaynak grubunuz başarıyla oluşturulduğunda olduğu gibi Succeeded gösterilirprovisioningState:

<...>
  "name": "testResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
<...>

İş akışı tanımı

Azure CLI kullanarak yeni bir mantıksal uygulama oluşturmadan veya mevcut bir mantıksal uygulamayı güncelleştirmeden önce mantıksal uygulamanız için bir iş akışı tanımına ihtiyacınız vardır. Azure portal, Tasarımcı görünümünden Kod görünümüne geçerek mantıksal uygulamanızın temel iş akışı tanımını JSON biçiminde görüntüleyebilirsiniz.

Mantıksal uygulamanızı oluşturmak veya güncelleştirmek için komutları çalıştırdığınızda, iş akışı tanımınız gerekli parametre ()--definition olarak karşıya yüklenir. İş akışı tanımınızı İş Akışı Tanım Dili şemasını izleyen bir JSON dosyası olarak oluşturmanız gerekir.

CLI'dan mantıksal uygulamalar oluşturma

Azure CLI'dan mantıksal uygulama iş akışı oluşturmak için komutunu az logic workflow create tanım için JSON dosyasıyla birlikte kullanın.

az logic workflow create --definition
                         --location
                         --name
                         --resource-group
                         [--access-control]
                         [--endpoints-configuration]
                         [--integration-account]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

Komutunuz aşağıdaki gerekli parametreleri içermelidir:

Parametre	Değer	Açıklama
İş akışı tanımı	`--definition`	Mantıksal uygulamanızın iş akışı tanımını içeren bir JSON dosyası.
Konum	`--location -l`	Mantıksal uygulamanızın bulunduğu Azure bölgesi.
Name	`--name -n`	Mantıksal uygulamanızın adı. Ad yalnızca harf, sayı, kısa çizgi (`-`), alt çizgi (`_`), parantez (`()`) ve nokta (`.`) içerebilir. Adın bölgeler arasında da benzersiz olması gerekir.
Kaynak grubu adı	`--resource-group -g`	Mantıksal uygulamanızı oluşturmak istediğiniz Azure kaynak grubu . Mantıksal uygulamanız için henüz bir kaynak grubunuz yoksa başlamadan önce bir kaynak grubu oluşturun.

Mantıksal uygulamanızın erişim denetimlerini, uç noktalarını, tümleştirme hesabını, tümleştirme hizmeti ortamını, durumunu ve kaynak etiketlerini yapılandırmak için ek isteğe bağlı parametreler de ekleyebilirsiniz.

Örnek - Mantıksal uygulama oluşturma

Bu örnekte konumundaki kaynak grubunda testResourceGroupwestusadlı testLogicApp bir iş akışı oluşturulur. JSON dosyası testDefinition.json iş akışı tanımını içerir.

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

İş akışınız başarıyla oluşturulduğunda CLI, yeni iş akışı tanımınızın JSON kodunu gösterir. İş akışı oluşturma işleminiz başarısız olursa olası hataların listesine bakın.

CLI'dan mantıksal uygulamaları güncelleştirme

Azure CLI'dan mantıksal uygulamanın iş akışını güncelleştirmek için komutunu az logic workflow createkullanın.

Komutunuz, mantıksal uygulama oluştururken kullandığınız gerekli parametreleri içermelidir. Mantıksal uygulama oluştururken kullandığınız isteğe bağlı parametreleri de ekleyebilirsiniz.

az logic workflow create --definition
                         --location
                         --name
                         --resource-group
                         [--access-control]
                         [--endpoints-configuration]
                         [--integration-account]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

Örnek - Mantıksal uygulamayı güncelleştirme

Bu örnekte, önceki bölümde oluşturulan örnek iş akışı , farklı bir JSON tanım dosyası newTestDefinition.jsonkullanacak ve iki kaynak etiketi testTag1 ekleyecek ve testTag2 açıklama değerleriyle güncelleştirildi.

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "newTestDefinition.json" --tags "testTag1=testTagValue1" "testTag2=testTagValue"

İş akışınız başarıyla güncelleştirildiğinde, CLI mantıksal uygulamanızın güncelleştirilmiş iş akışı tanımını gösterir. Güncelleştirmeniz başarısız olursa olası hataların listesine bakın.

CLI'dan mantıksal uygulamaları silme

Mantıksal uygulamanın iş akışını Azure CLI'dan silmek için komutunu az logic workflow deletekullanın.

Komutunuz aşağıdaki gerekli parametreleri içermelidir:

Parametre	Değer	Açıklama
Ad	`--name -n`	Mantıksal uygulamanızın adı.
Kaynak grubu adı	`-resource-group -g`	Mantıksal uygulamanızın bulunduğu kaynak grubu.

Onay istemlerini atlamak için isteğe bağlı bir parametre de ekleyebilirsiniz. --yes -y

az logic workflow delete --name
                         --resource-group
                         [--yes]

Ardından CLI, mantıksal uygulamanızın silinmesini onaylamanızı ister. komutuyla isteğe bağlı parametresini --yes -y kullanarak onay istemini atlayabilirsiniz.

Are you sure you want to perform this operation? (y/n):

Mantıksal uygulamanın silinmesini onaylamak için, mantıksal uygulamalarınızı CLI'da listeleyin veya mantıksal uygulamalarınızı Azure portal görüntüleyin.

Örnek - Mantıksal uygulamayı silme

Bu örnekte, önceki bölümde oluşturulan örnek iş akışı silinir.

az logic workflow delete --resource-group "testResourceGroup" --name "testLogicApp"

ile onay istemini yyanıtladıktan sonra mantıksal uygulama silinir.

Dikkat edilmesi gerekenler - Mantıksal uygulamayı silme

Mantıksal uygulamanın silinmesi, iş akışı örneklerini aşağıdaki yollarla etkiler:

Azure Logic Apps devam eden ve bekleyen çalıştırmaları iptal etmek için elinden geleni yapar.

Büyük bir birim veya kapsam olsa bile, çoğu çalıştırma tamamlanmadan veya başlatılmadan önce iptal edilir. Ancak iptal işleminin tamamlanması zaman alabilir. Bu arada, çalışma zamanı iptal işlemi boyunca çalışırken bazı çalıştırmalar yürütme için alınabilir.
Azure Logic Apps yeni iş akışı örnekleri oluşturmaz veya çalıştırmaz.
Bir iş akışını silip aynı iş akışını yeniden oluşturursanız, yeniden oluşturulmuş iş akışı silinen iş akışıyla aynı meta veriye sahip olmaz. Silinen iş akışını çağıran tüm iş akışlarını yeniden kaydetmeniz gerekir. Bu şekilde, çağıran yeniden oluşturulmuş iş akışı için doğru bilgileri alır. Aksi takdirde, yeniden oluşturulmuş iş akışına yapılan çağrılar bir Unauthorized hatayla başarısız olur. Bu davranış, tümleştirme hesaplarında yapıtları kullanan iş akışları ve Azure işlevlerini çağıran iş akışları için de geçerlidir.

CLI'da mantıksal uygulamaları gösterme

Belirli bir mantıksal uygulama iş akışını almak için komutunu az logic workflow showkullanın.

az logic workflow show --name
                       --resource-group

Komutunuz aşağıdaki gerekli parametreleri içermelidir

Parametre	Değer	Açıklama
Ad	`--name -n`	Mantıksal uygulamanızın adı.
Kaynak grubu adı	`--resource-group -g`	Mantıksal uygulamanızın bulunduğu kaynak grubunun adı.

Örnek - Mantıksal uygulama alma

Bu örnekte, kaynak grubundaki testResourceGroup mantıksal uygulama testLogicApp hata ayıklama için tam günlüklerle döndürülür.

az logic workflow show --resource-group "testResourceGroup" --name "testLogicApp" --debug

CLI'da mantıksal uygulamaları listeleme

Mantıksal uygulamalarınızı aboneliğe göre listelemek için komutunu az logic workflow listkullanın. Bu komut mantıksal uygulama iş akışlarınız için JSON kodunu döndürür.

Sonuçlarınızı aşağıdaki isteğe bağlı parametrelerle filtreleyebilirsiniz:

Parametre	Değer	Açıklama
Kaynak grubu adı	`--resource-group -g`	Sonuçlarınızı filtrelemek istediğiniz kaynak grubunun adı.
Öğe sayısı	`--top`	Sonuçlarınıza dahil edilen öğe sayısı.
Filtre	`--filter`	Listenizde kullandığınız filtre türü. Duruma (), tetikleyiciye (`StateTrigger`) ve başvuruda bulunan kaynağın tanımlayıcıya (`ReferencedResourceId` göre filtreleyebilirsiniz.

az logic workflow list [--filter]
                       [--resource-group]
                       [--top]

Örnek - Mantıksal uygulamaları listeleme

Bu örnekte, kaynak grubundaki testResourceGroup tüm etkin iş akışları ASCII tablo biçiminde döndürülür.

az logic workflow list --resource-group "testResourceGroup" --filter "(State eq 'Enabled')" --output "table"

Hatalar

Aşağıdaki hata, Azure Logic Apps CLI uzantısının yüklü olmadığını gösterir. Logic Apps uzantısını bilgisayarınıza yüklemek için önkoşullardaki adımları izleyin.

az: 'logic' is not in the 'az' command group. See 'az --help'. If the command is from an extension, please make sure the corresponding extension is installed. To learn more about extensions, please visit https://learn.microsoft.com/cli/azure/azure-cli-extensions-overview

Aşağıdaki hata, iş akışı tanımınızı karşıya yüklemek için dosya yolunun yanlış olduğunu gösterebilir.

Expecting value: line 1 column 1 (char 0)

Genel parametreler

Komutlarınızla aşağıdaki isteğe bağlı genel Azure CLI parametrelerini kullanabilirsiniz az logic :

Parametre	Değer	Açıklama
Çıkış biçimi	`--output -o`	Varsayılan JSON'dan çıkış biçimini değiştirin.
Yalnızca hataları göster	`--only-show-errors`	Uyarıları bastırır ve yalnızca hataları gösterir.
Ayrıntılı	`--verbose`	Ayrıntılı günlükleri göster.
Hata Ayıklama	`--debug`	Tüm hata ayıklama günlüklerini gösterir.
Yardım iletisi	`--help -h`	Yardım iletişim kutusunu göster.
Sorgu	`--query`	JSON çıkışı için bir JMESPath sorgu dizesi ayarlayın.

Sonraki adımlar

Azure CLI hakkında daha fazla bilgi için Bkz. Azure CLI belgeleri.

Ek Azure Logic Apps CLI betik örneklerini Microsoft'un kod örnekleri tarayıcısında bulabilirsiniz.

Ardından, örnek bir betik ve iş akışı tanımı kullanarak Azure CLI aracılığıyla örnek bir uygulama mantığı oluşturabilirsiniz.

Örnek betik kullanarak mantıksal uygulama oluşturun.