Hızlı Başlangıç: Visual Studio Code kullanarak çok kiracılı Azure Logic Apps'te Tüketim iş akışları oluşturma

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

Bir tümleştirme geliştiricisi olarak genellikle altyapıyı yönetmeden SaaS uygulamaları, kurumsal sistemler ve veri kaynakları genelinde iş süreçlerini otomatikleştirmeniz gerekir. Ayrıca iş akışları oluşturmak için kod öncelikli bir yönteme ihtiyacınız vardır; böylece tanımları sürüm olarak oluşturabilir, güncelleştirmeler yapabilir ve değişiklikleri verimli bir şekilde gözden geçirebilirsiniz.

Bu hızlı başlangıçta, Visual Studio Code'daki yerel, kod öncelikli araçları kullanarak çok kiracılı Azure Logic Apps'te Tüketim iş akışları oluşturma ve yönetme adımları gösterilmektedir. Tüketim iş akışları, olay odaklı ve zamanlanmış iş akışları için sunucusuz bir tümleştirme modeli sağlar; böylece hizmetlere bağlanabilir ve yalnızca çalışan eylemler için ödeme yaparken işlemleri otomatikleştirebilirsiniz.

Visual Studio Code'da kod düzenleyicisini kullanarak JavaScript Nesne Gösterimi'nde (JSON) iş akışı tanımlarını düzenleyebilir, gerektiğinde görsel tasarımcıyı kullanabilir ve Azure'da dağıtılan iş akışlarını yönetebilirsiniz. Linux, Windows ve macOS gibi Visual Studio Code'un çalıştığı herhangi bir geliştirme platformundan iş akışları ve tümleştirme hesapları üzerinde de çalışabilirsiniz.

Aşağıdaki ekran görüntüsünde örnek bir Tüketim iş akışı tanımının nasıl görünebileceği gösterilmektedir:

Daha fazla bilgi için bakınız:

• Azure Logic Apps nedir?
• Azure Logic Apps'te tek kiracılı ve çok kiracılı.

Önkoşullar

• Bir Azure hesabı ve aboneliği Ücretsiz bir Azure hesabı edinin.

• Mantıksal uygulama iş akışı tanımları ve bunların JSON biçimindeki yapısı hakkında temel bilgiler.

  Bu makaledeki örnek, temel kavramlara daha fazla odaklanan bu hızlı başlangıçtakiyle aynı mantıksal uygulama iş akışını oluşturur. Azure CLI aracılığıyla iş akışları oluşturmayı ve yönetmeyi de öğrenebilirsiniz.

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

• Henüz sahip değilseniz aşağıdaki araçları indirin ve yükleyin:

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

  • Azure Logic Apps için Visual Studio Code uzantısı (Tüketim).

    1. Bu uzantıyı Visual Studio Market'ten veya doğrudan Visual Studio Code'un içinden yükleyin.

       

    2. Yükledikten sonra Visual Studio Code'u yeniden yükleyin.

    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 uygulama iş akışınızın trafiği belirli IP adresleriyle sınırlayan bir güvenlik duvarı üzerinden iletişim kurması gerekiyorsa, güvenlik duvarının Hem Azure Logic Apps tarafından kullanılan gelenhem degiden IP adreslerine veya mantıksal uygulama iş akışınızın bulunduğu Azure bölgesindeki çalışma zamanına erişime izin vermesi gerekir.

  Mantıksal uygulama iş akışını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ı mantıksal uygulamanızın Azure bölgesindeki tümyönetilen bağlayıcı giden IP adreslerine erişim izni vermelidir.

Visual Studio Code'dan Azure'a erişme

1. Visual Studio Code'da Azure hesabınızda oturum açın.

   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 kodu kullanarak oturum açmak için şu adımları izleyin:

   1. Cihaz Kodunu Kullan'ı ve ardından Kopyala ve Aç'ı seçin.

   2. Bağlantıyı Aç'ı seçerek yeni bir tarayıcı penceresi açın ve kimlik doğrulama web sitesine geçin.

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

2. Etkinlik çubuğunda Azure simgesini seçin.

   

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

   1. Logic Apps (Tüketim) bölümünde Abonelikleri Seç'i seçin.

      

   2. Abonelikler listesinden kullanmak istediğiniz abonelikleri seçin.

3. Logic Apps (Tüketim) bölümünde aboneliğinizi genişleterek bu abonelikte dağıtılan mantıksal uygulamaları görüntüleyin.

   

Mantıksal uygulama oluşturma

1. Visual Studio Code'daki Logic Apps (Tüketim) bölümünde, abonelik kısayol menüsünden 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.

2. Kaynak grubu listesinden Yeni kaynak grubu oluştur'u veya var olan bir kaynak grubunu seçin.

   Bu örnek için Yeni kaynak grubu oluştur'u seçin, örneğin:

   

3. Azure kaynak grubunuz için bir ad girin.

   

4. Mantıksal uygulama meta verilerinin kaydedileceği Azure bölgesini seçin.

   

5. Mantıksal uygulamanız için bir ad girin.

   

   Azure penceresinde, Azure aboneliğinizin altında yeni mantıksal uygulamanız ve boş iş akışınız görüntülenir. Visual Studio Code ayrıca çatı iş akışı tanımını içeren bir JSON (.logicapp.json) dosyası açar, örneğin:

   

   Artık iş akışı tanımınızı bu JSON dosyasında el ile yazmaya başlayabilirsiniz. İş 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ı.

   Aşağıdaki örnek mantıksal uygulama iş akışı tanımı bir RSS tetikleyicisi ve Office 365 Outlook eylemiyle başlar. Genellikle, JSON öğeleri her bölümde alfabetik olarak görünür. Ancak bu örnek, bu öğeleri kabaca iş akışı işlemlerinin tasarımcıda görünme sırasına göre gösterir.

   {
      "$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": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "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": {}
   }
   

   Önemli

   Bu örnek iş akışı tanımını yeniden kullanmak için bir kurumsal iş veya okul hesabına (örneğin, @fabrikam.com) ihtiyacı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, Send_an_email_action sağlanan benzer bir eylemle değiştirin.

   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.

6. bitirdiğinizde iş akışı tanımını kaydedin. (Dosya>Kaydet veya Ctrl+S tuşlarına bas).

7. Mantıksal uygulama iş akışı tanımınızı Azure aboneliğinize yüklemeniz istendiğinde Karşıya Yükle'yi seçin.

   Bu adım Visual Studio Code'daki mantıksal uygulama iş akışı tanımınızı Azure portalında yayımlayarak iş akışının Azure'da çalışmasını sağlar.

   

Tasarımcıda iş akışını görüntüleme

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

Azure penceresindeki Logic Apps (Tüketim) bölümünde mantıksal uygulama kısayol menüsünde Tasarımcıda Aç'ı seçin.

Salt okunur tasarım aracı ayrı bir sekmede açılır ve mantık uygulaması iş akışını gösterir; örneğin:

Azure portalında iş akışını görüntüleme

Azure portalında mantıksal uygulama iş akışı tanımınızı gözden geçirmek için şu adımları izleyin:

1. Azure portalında mantıksal uygulamanızla ilişkilendirilmiş aynı Azure hesabını ve aboneliğini kullanarak oturum açın.

2. Azure portalı arama kutusuna mantıksal uygulama adını girin. Sonuçlar listesinden mantıksal uygulamayı seçin.

   

3. Mantıksal uygulama kenar çubuğundaki Geliştirme Araçları'nın altında iş akışını tasarımcıda veya kod görünümünde açın.

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

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

Önemli

Üretimde etkin olarak çalışan bir mantıksal uygulama iş akışını düzenlemeden önce kesintiyi en aza indirin ve önce mantıksal uygulama kaynağınızı devre dışı bırakarak iş akışını bozma riskini önleyebilirsiniz.

1. Visual Studio Code'da Etkinlik çubuğunda Azure simgesini seçin.

2. Azure penceresindeki Logic Apps (Tüketim) bölümünde Azure aboneliğinizi genişletin ve istediğiniz mantıksal uygulamayı seçin.

3. Mantıksal uygulama kısayol menüsünde Düzenleyicide Aç'ı seçin. İsterseniz mantıksal uygulama adının yanındaki düzenle simgesini de seçebilirsiniz.

   

   Visual Studio Code, 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. İş akışı tanımı dosyasında değişikliklerinizi yapın.

5. bitirdiğinizde, değişikliklerinizi kaydedin (Dosya>Kaydet veya Ctrl+S tuşlarına basın).

6. Değişikliklerinizi karşıya yüklemeniz ve Azure portalında mevcut mantıksal uygulama iş akışını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 uygulama kaynağınızda yayımlar.

   

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

Visual Studio Code'da mantıksal uygulama iş akışınız için önceki sürümleri 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 uygulama iş akışını değiştirmeden önce kesintiyi en aza indirin ve önce mantıksal uygulama kaynağınızı devre dışı bırakarak bu mantıksal uygulamayı bozma riskini önleyebilirsiniz.

1. Azure penceresindeki Logic Apps (Tüketim) bölümünde, ilişkili mantıksal uygulamaları görüntülemek için Azure aboneliğinizi genişletin.

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ın önceki sürümlerini gösterir.

   

3. Önceki bir sürümü görüntülemek için aşağıdaki adımlardan 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, sürüm kısayol menüsünde Düzenleyicide Aç'ı da seçebilirsiniz.

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

   • Salt okunur tasarımcıda sürümü görüntülemek için, sürümün kısayol menüsünde 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ünde 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 uygulama iş akışını düzenler ve değişikliklerinizi kaydederseniz, zaten dağıtılan mantıksal uygulamanızın üzerine yazarsınız . Üretimde mantıksal uygulama iş akışınızın bozulmasını önlemek ve kesintiyi en aza indirmek için önce mantıksal uygulama kaynağınızı devre dışı bırakın. İş akışının hala beklendiği gibi çalıştığını onayladıktan sonra mantıksal uygulama kaynağını yeniden etkinleştirebilirsiniz.

Mantıksal uygulama kaynağının devre dışı bırakılması veya etkinleştirilmesi, iş akışı örneklerini aşağıdaki yollarla etkiler:

• Azure Logic Apps, devam eden ve tamamlanana kadar bekleyen iş akışı çalıştırmalarını sürdürür. Hacim veya birikmiş işlere bağlı olarak bu işlemin tamamlanması zaman alabilir.

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

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

• Tetikleyici durumu, iş akışının durduğu noktayı anımsar. Bu nedenle Logic App'i yeniden etkinleştirirseniz, tetikleyici, son çalıştırmadan bu yana henüz işlenmemiş olan öğeler için tetiklenir.

  Tetikleyicinin bu işlenmemiş öğelerde tetiklenmesini durdurmak için mantıksal uygulama kaynağını yeniden etkinleştirmeden önce tetikleyici durumunu temizleyin:

  1. İş akışında tetikleyicinin 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 uygulama kaynağınızı yeniden etkinleştirin.

• Mantıksal uygulama kaynağı devre dışı bırakıldığında iş akışı çalıştırmalarını yeniden göndermeye devam edebilirsiniz.

Visual Studio Code'da mantıksal uygulama kaynağını devre dışı bırakmak veya etkinleştirmek için şu adımları izleyin:

1. Visual Studio Code'da Azure penceresini açın.

2. Logic Apps (Tüketim) bölümünde, ilişkili mantıksal uygulamaları görüntülemek için Azure aboneliğinizi genişletin.

3. Mantıksal uygulama kaynağını devre dışı bırakmak için mantıksal uygulama kısayol menüsünde Devre Dışı Bırak'ı seçin.

   

4. Mantıksal uygulama kaynağını yeniden etkinleştirmeye hazır olduğunuzda mantıksal uygulama kısayol menüsünde 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 iş akışı çalıştırmalarını iptal etmeye çalışır.

  Büyük bir hacim veya birikim olsa bile, çoğu işletim tamamlanmadan veya başlatılmadan önce iptal edilir. Ancak iptal işleminin tamamlanması zaman alabilir. Bu arada, hizmet iptal işlemi sırasında yürütme için bazı görevleri alabilir.

• 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ışının meta verileri farklıdır. Silinen iş akışını çağıran iş akışlarını yeniden kaydetmeniz gerekir. Yeniden kaydettiğinizde, çağrıyı yapan 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.

Visual Studio Code'dan bir mantıksal uygulama kaynağını silmek için şu adımları izleyin:

1. Visual Studio Code'da Azure penceresini açın.

2. Logic Apps (Tüketim) bölümünde, ilişkili mantıksal uygulama kaynaklarını görüntülemek için Azure aboneliğinizi genişletin. Silmek istediğiniz mantıksal uygulama kaynağını bulun.

3. Mantıksal uygulama kısayol menüsünde Sil'i seçin.

   

İlgili içerik

• Visual Studio Code kullanarak tek kiracılı Azure Logic Apps'te Standart iş akışları oluşturma