Hızlı Başlangıç: Çok kiracılı Azure Logic Apps ve Visual Studio Code ile mantıksal uygulama iş akışı tanımları oluşturma ve yönetme

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

Bu hızlı başlangıçta, çok kiracılı Azure Logic Apps ve Visual Studio Code kullanarak uygulamaları, verileri, sistemleri ve hizmetleri kuruluşlar ve kuruluşlar arasında tümleştirmenize yardımcı olan görev ve işlemleri otomatikleştirmenize yardımcı olan mantıksal uygulama iş akışlarının nasıl oluşturulacağı ve yönetildiği gösterilmektedir. Kod tabanlı bir deneyim aracılığıyla mantıksal uygulamalar için JavaScript Nesne Gösterimi (JSON) kullanan temel iş akışı tanımlarını oluşturabilir ve düzenleyebilirsiniz. Azure'a zaten dağıtılmış olan mevcut mantıksal uygulamalar üzerinde de çalışabilirsiniz. Çok kiracılı ve tek kiracılı model hakkında daha fazla bilgi için Azure Logic Apps'te tek kiracılı ve çok kiracılı karşılaştırmasını gözden geçirin.

Azure portalında ve Visual Studio'da aynı görevleri gerçekleştirebilmenize rağmen, mantıksal uygulama tanımlarını zaten biliyor ve doğrudan kodda çalışmak istediğinizde Visual Studio Code'a daha hızlı başlayabilirsiniz. Örneğin, önceden oluşturulmuş mantıksal uygulamaları devre dışı bırakabilir, etkinleştirebilir, silebilir ve yenileyebilirsiniz. Ayrıca, Linux, Windows ve Mac gibi Visual Studio Code'un çalıştığı herhangi bir geliştirme platformundan mantıksal uygulamalar ve tümleştirme hesapları üzerinde çalışabilirsiniz.

Bu makale için, temel kavramlara daha fazla odaklanan bu hızlı başlangıçtan aynı mantıksal uygulamayı oluşturabilirsiniz. Örnek uygulamayı Visual Studio'da oluşturmayı ve Azure CLI aracılığıyla uygulama oluşturmayı ve yönetmeyi de öğrenebilirsiniz. Visual Studio Code'da mantıksal uygulama şu örneğe benzer:

Önkoşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• Azure hesabınız ve aboneliğiniz yoksa ücretsiz bir Azure hesabına kaydolun.

• JSON ile açıklandığı gibi mantıksal uygulama iş akışı tanımları ve bunların yapısı hakkında temel bilgiler

  Azure Logic Apps'te yeniyseniz, Azure portalında ilk mantıksal uygulama iş akışınızı oluşturan ve temel kavramlara daha fazla odaklanan bu hızlı başlangıcı deneyin.

• Azure'da ve Azure aboneliğinizde oturum açmak için web'e erişim

• Henüz yoksa şu araçları indirip yükleyin:

  • Visual Studio Code sürüm 1.25.1 veya üzeri, ücretsiz

  • Azure Logic Apps için Visual Studio Code uzantısı

    Bu uzantıyı Visual Studio Market'ten veya doğrudan Visual Studio Code'un içinden indirip yükleyebilirsiniz. Yükledikten sonra Visual Studio Code'u yeniden yüklediğinizden emin olun.

    

    Uzantının doğru yüklenip yüklenmediğini denetlemek için Visual Studio Code araç çubuğunuzda görünen Azure simgesini seçin.

    

    Daha fazla bilgi için bkz . Uzantı Marketi. Bu uzantının açık kaynak sürümüne katkıda bulunmak için GitHub'da Visual Studio Code için Azure Logic Apps uzantısını ziyaret edin.

• Mantıksal uygulamanızın trafiği belirli IP adresleriyle sınırlayan bir güvenlik duvarı üzerinden iletişim kurması gerekiyorsa, bu güvenlik duvarının mantıksal uygulamanızın bulunduğu Azure bölgesinde Azure Logic Apps veya çalışma zamanı tarafından kullanılan gelen ve giden IP adreslerine erişime izin sağlaması gerekir. Mantıksal uygulamanız office 365 Outlook bağlayıcısı veya SQL bağlayıcısı gibi yönetilen bağlayıcılar da kullanıyorsa veya özel bağlayıcılar kullanıyorsa, güvenlik duvarının mantıksal uygulamanızın Azure bölgesindeki tüm yönetilen bağlayıcı giden IP adreslerine erişim izni de sağlaması gerekir.

Visual Studio Code'dan Azure'a erişme

1. Visual Studio Code'u açın. Visual Studio Code araç çubuğunda Azure simgesini seçin.

   

2. Azure penceresindeki Logic Apps'in altında Azure'da oturum aç'ı seçin. Microsoft oturum açma sayfası sizden istendiğinde Azure hesabınızla oturum açın.

   

   1. Oturum açma işlemi normalden uzun sürüyorsa, Visual Studio Code size bir cihaz kodu sağlayarak microsoft kimlik doğrulama web sitesi üzerinden oturum açmanızı ister. Bunun yerine kodla oturum açmak için Cihaz Kodunu Kullan'ı seçin.

      

   2. Kodu kopyalamak için Kopyala ve Aç'ı seçin.

      

   3. Yeni bir tarayıcı penceresi açmak ve kimlik doğrulama web sitesine devam etmek için Bağlantıyı Aç'ı seçin.

      

   4. Hesabınızda oturum açın sayfasında kimlik doğrulama kodunuzu girin ve İleri'yi seçin.

      

3. Azure hesabınızı seçin. Oturum açtığınızda tarayıcınızı kapatabilir ve Visual Studio Code'a dönebilirsiniz.

   Azure bölmesinde Logic Apps ve Tümleştirme Hesapları bölümleri artık hesabınızla ilişkili Azure aboneliklerini gösterir. Ancak beklediğiniz abonelikleri görmüyorsanız veya bölümlerde çok fazla abonelik varsa şu adımları izleyin:

   1. İşaretçinizi Logic Apps etiketinin üzerine getirin. Araç çubuğu göründüğünde Abonelikleri Seç 'i (filtre simgesi) seçin.

      

   2. Görüntülenen listeden, görünmesini istediğiniz abonelikleri seçin.

4. Logic Apps'in altında istediğiniz aboneliği seçin. Abonelik düğümü genişletir ve bu abonelikte bulunan tüm mantıksal uygulamaları gösterir.

   

   İpucu

   Tümleştirme Hesapları'nın altında, aboneliğinizi seçtiğinizde bu abonelikte var olan tümleştirme hesapları gösterilir.

Yeni mantıksal uygulama oluşturma

1. Henüz Visual Studio Code'un içinden Azure hesabınızda ve aboneliğinizde oturum açmadıysanız, şimdi oturum açmak için önceki adımları izleyin.

2. Visual Studio Code'da Logic Apps'in altında aboneliğinizin kısayol menüsünü açın ve Mantıksal Uygulama Oluştur'u seçin.

   

   Bir liste görünür ve aboneliğinizdeki tüm Azure kaynak gruplarını gösterir.

3. Kaynak grubu listesinden Yeni kaynak grubu oluştur'u veya mevcut bir kaynak grubunu seçin. Bu örnek için yeni bir kaynak grubu oluşturun.

   

4. Azure kaynak grubunuz için bir ad girin ve ENTER tuşuna basın.

   

5. Mantıksal uygulamanızın meta verilerini kaydetmek istediğiniz Azure bölgesini seçin.

   

6. Mantıksal uygulamanız için bir ad girin ve Enter tuşuna basın.

   

   Azure penceresinde, Azure aboneliğinizin altında yeni ve boş mantıksal uygulamanız görüntülenir. Visual Studio Code ayrıca mantıksal uygulamanız için bir iskelet iş akışı tanımı içeren bir JSON (.logicapp.json) dosyası açar. Artık mantıksal uygulamanızın iş akışı tanımını bu JSON dosyasında el ile yazmaya başlayabilirsiniz. bir iş akışı tanımının yapısı ve söz dizimi hakkında teknik başvuru için bkz . Azure Logic Apps için İş Akışı Tanımı Dili şeması.

   

   Örneğin, rss tetikleyicisi ve Office 365 Outlook eylemiyle başlayan örnek bir mantıksal uygulama iş akışı tanımı aşağıda verilmiştir. Genellikle, JSON öğeleri her bölümde alfabetik olarak görünür. Ancak bu örnek, bu öğeleri kabaca mantıksal uygulamanın adımlarının tasarımcıda görünme sırasına göre gösterir.

   Önemli

   Bu örnek mantıksal uygulama tanımını yeniden kullanmak istiyorsanız, örneğin bir kuruluş hesabına @fabrikam.comihtiyacınız vardır. Kurgusal e-posta adresini kendi e-posta adresinizle değiştirdiğinizden emin olun. Outlook.com veya Gmail gibi farklı bir e-posta bağlayıcısı kullanmak için eylemi, Azure Logic Apps tarafından desteklenen bir e-posta bağlayıcısından sağlanan benzer bir eylemle değiştirinSend_an_email_action.

   Gmail bağlayıcısını kullanmak istiyorsanız bu bağlayıcıyı mantıksal uygulamalarda kısıtlama olmadan yalnızca G-Suite iş hesapları kullanabilir. Gmail tüketici hesabınız varsa bu bağlayıcıyı yalnızca belirli Google onaylı hizmetlerle kullanabilir veya Gmail bağlayıcınızla kimlik doğrulaması için kullanılacak bir Google istemci uygulaması oluşturabilirsiniz. Daha fazla bilgi için bkz . Azure Logic Apps'te Google bağlayıcıları için veri güvenliği ve gizlilik ilkeleri.

   {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
         "$connections": {
            "defaultValue": {},
            "type": "Object"
         }
      },
      "triggers": {
         "When_a_feed_item_is_published": {
            "recurrence": {
               "frequency": "Minute",
               "interval": 1
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "http://feeds.reuters.com/reuters/topNews"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

7. İşiniz bittiğinde mantıksal uygulamanızın iş akışı tanımını kaydedin. (Dosya menüsü > Kaydet veya Ctrl+S tuşlarına basın)

8. Mantıksal uygulamanızı Azure aboneliğinize yüklemeniz istendiğinde Karşıya Yükle'yi seçin.

   Bu adım mantıksal uygulamanızı Azure portalında yayımlar ve mantığınızı Azure'da canlı ve çalışır hale getirir.

   

Mantıksal uygulamayı tasarımcıda görüntüleme

Visual Studio Code'da mantıksal uygulamanızı salt okunur tasarım görünümünde açabilirsiniz. Mantıksal uygulamanızı tasarımcıda düzenleyemezsiniz ancak tasarımcı görünümünü kullanarak mantıksal uygulamanızın iş akışını görsel olarak de kontrol edebilirsiniz.

Azure penceresindeki Logic Apps'in altında mantıksal uygulamanızın kısayol menüsünü açın ve Tasarımcıda Aç'ı seçin.

Salt okunur tasarımcı ayrı bir pencerede açılır ve mantıksal uygulamanızın iş akışını gösterir, örneğin:

Azure portalında görüntüleme

Azure portalında mantıksal uygulamanızı gözden geçirmek için şu adımları izleyin:

1. Mantıksal uygulamanızla ilişkili azure hesabını ve aboneliğini kullanarak Azure portalında oturum açın.

2. Azure portalının arama kutusuna mantıksal uygulamalarınızın adını girin. Sonuçlar listesinden mantıksal uygulamanızı seçin.

   

Dağıtılan mantıksal uygulamayı düzenleme

Visual Studio Code'da, Azure'da zaten dağıtılmış bir mantıksal uygulamanın iş akışı tanımını açabilir ve düzenleyebilirsiniz.

Önemli

Üretimde etkin bir şekilde çalışan bir mantıksal uygulamayı düzenlemeden önce, bu mantıksal uygulamayı bozma riskini önleyip önce mantıksal uygulamanızı devre dışı bırakarak kesintiyi en aza indirin.

1. Henüz Visual Studio Code'un içinden Azure hesabınızda ve aboneliğinizde oturum açmadıysanız, şimdi oturum açmak için önceki adımları izleyin.

2. Azure penceresindeki Logic Apps'in altında Azure aboneliğinizi genişletin ve istediğiniz mantıksal uygulamayı seçin.

3. Mantıksal uygulama menünüzü açın ve Düzenleyicide Aç'ı seçin. İsterseniz mantıksal uygulamanızın adının yanındaki düzenle simgesini de seçebilirsiniz.

   

   Visual Studio Code, mantıksal uygulamanızın iş akışı tanımını görüntüleyebilmeniz için .logicapp.json dosyasını yerel geçici klasörünüzde açar.

   

4. Mantıksal uygulamanın iş akışı tanımında değişikliklerinizi yapın.

5. İşiniz bittiğinde yaptığınız değişiklikleri kaydedin. (Dosya menüsü > Kaydet veya Ctrl+S tuşlarına basın)

6. Değişikliklerinizi karşıya yüklemeniz ve Azure portalında mevcut mantıksal uygulamanızın üzerine yazmanız istendiğinde Karşıya Yükle'yi seçin.

   Bu adım güncelleştirmelerinizi Azure portalında mantıksal uygulamanızda yayımlar.

   

Diğer sürümleri görüntüleme veya yükseltme

Visual Studio Code'da mantıksal uygulamanızın önceki sürümlerini açabilir ve gözden geçirebilirsiniz. Ayrıca önceki bir sürümü geçerli sürüme yükseltebilirsiniz.

Önemli

Üretimde etkin olarak çalışan bir mantıksal uygulamayı değiştirmeden önce bu mantıksal uygulamayı bozma riskini önleyip önce mantıksal uygulamanızı devre dışı bırakarak kesintiyi en aza indirin.

1. Azure penceresindeki Logic Apps'in altında Azure aboneliğinizi genişleterek bu abonelikteki tüm mantıksal uygulamaları görüntüleyebilirsiniz.

2. Aboneliğinizin altında mantıksal uygulamanızı genişletin ve Sürümler'i genişletin.

   Sürümler listesi, varsa mantıksal uygulamanızın önceki sürümlerini gösterir.

   

3. Önceki bir sürümü görüntülemek için iki adımdan birini seçin:

   • JSON tanımını görüntülemek için Sürümler'in altında bu tanımın sürüm numarasını seçin. Alternatif olarak, bu sürümün kısayol menüsünü açın ve Düzenleyicide Aç'ı seçin.

     Yerel bilgisayarınızda yeni bir dosya açılır ve bu sürümün JSON tanımını gösterir.

   • Sürümü salt okunur tasarımcı görünümünde görüntülemek için bu sürümün kısayol menüsünü açın ve Tasarımcıda Aç'ı seçin.

4. Önceki bir sürümü geçerli sürüme yükseltmek için şu adımları izleyin:

   1. Sürümler'in altında önceki sürümün kısayol menüsünü açın ve Yükselt'i seçin.

      

   2. Visual Studio Code sizden onay istedikten sonra devam etmek için Evet'i seçin.

      

      Visual Studio Code seçili sürümü geçerli sürüme yükselterek yükseltilen sürüme yeni bir numara atar. Önceki geçerli sürüm artık yükseltilen sürüm altında görünür.

Mantıksal uygulamaları devre dışı bırakma veya etkinleştirme

Visual Studio Code'da, yayımlanmış bir mantıksal uygulamayı düzenler ve değişikliklerinizi kaydederseniz, zaten dağıtılmış uygulamanızın üzerine yazarsınız. Üretimde mantıksal uygulamanızın bozulmasını önlemek ve kesintiyi en aza indirmek için önce mantıksal uygulamanızı devre dışı bırakın. Mantıksal uygulamanızın hala çalıştığını onayladıktan sonra mantıksal uygulamanızı yeniden etkinleştirebilirsiniz.

• Azure Logic Apps, tamamlanana kadar devam eden ve bekleyen tüm çalıştırmalara devam eder. Birim veya kapsam temelinde bu işlemin tamamlanması zaman alabilir.

• Azure Logic Apps yeni iş akışı örnekleri oluşturmaz veya çalıştırmaz.

• Tetikleyici, koşulları karşılandığında tetiklenmez.

• Tetikleyici durumu, mantıksal uygulamanın durdurulduğu noktayı anımsar. Bu nedenle, mantıksal uygulamayı yeniden etkinleştirirseniz, tetikleyici son çalıştırmadan bu yana tüm işlenmemiş öğeler için tetiklenir.

  Tetikleyicinin son çalıştırmadan bu yana işlenmemiş öğelerde tetiklenmesini durdurmak için mantıksal uygulamayı yeniden etkinleştirmeden önce tetikleyicinin durumunu temizleyin:

  1. Mantıksal uygulamada iş akışının tetikleyicisinin herhangi bir bölümünü düzenleyin.
  2. Değişikliklerinizi kaydedin. Bu adım tetikleyicinizin geçerli durumunu sıfırlar.
  3. Mantıksal uygulamanızı yeniden etkinleştirin.

• Bir iş akışı devre dışı bırakıldığında çalıştırmaları yeniden gönderebilirsiniz.

1. Henüz Visual Studio Code'un içinden Azure hesabınızda ve aboneliğinizde oturum açmadıysanız, şimdi oturum açmak için önceki adımları izleyin.

2. Azure penceresindeki Logic Apps'in altında Azure aboneliğinizi genişleterek bu abonelikteki tüm mantıksal uygulamaları görüntüleyebilirsiniz.

   1. İstediğiniz mantıksal uygulamayı devre dışı bırakmak için mantıksal uygulama menüsünü açın ve Devre dışı bırak'ı seçin.

      

   2. Mantıksal uygulamanızı yeniden etkinleştirmeye hazır olduğunuzda mantıksal uygulama menüsünü açın ve Etkinleştir'i seçin.

      

Mantıksal uygulamaları 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 en iyi çabayı gösterir.

  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, hizmet iptal işlemi boyunca çalışırken bazı çalıştırmalar yürütme için teslim 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 iş akışlarını yeniden kaydetmeniz gerekir. Bu şekilde, arayan 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.

1. Henüz Visual Studio Code'un içinden Azure hesabınızda ve aboneliğinizde oturum açmadıysanız, şimdi oturum açmak için önceki adımları izleyin.

2. Azure penceresindeki Logic Apps'in altında Azure aboneliğinizi genişleterek bu abonelikteki tüm mantıksal uygulamaları görüntüleyebilirsiniz.

3. Silmek istediğiniz mantıksal uygulamayı bulun, mantıksal uygulama menüsünü açın ve Sil'i seçin.

   

Sonraki adımlar

Visual Studio Code'da tek kiracı tabanlı mantıksal uygulama iş akışları oluşturma