Azure DevOps ile Standart mantıksal uygulama iş akışları için derleme ve dağıtımı otomatikleştirme

Tek kiracılı Azure Logic Apps'te çalışan Standart mantıksal uygulama iş akışları için, herhangi bir kaynak denetim sistemini kullanarak mantıksal uygulama projenizi yerel olarak geliştirmek, test etmek ve depolamak için Azure Logic Apps (Standart) uzantısıyla Visual Studio Code'u kullanabilirsiniz. Bununla birlikte, iş akışlarınızı farklı ortamlara ve platformlara kolayca ve tutarlı bir şekilde dağıtmanın tüm avantajlarından yararlanmak için, derleme ve dağıtım sürecinizi de otomatikleştirmeniz gerekir.

Azure Logic Apps (Standart) uzantısı, Azure DevOps kullanarak otomatik derleme ve dağıtım işlemleri oluşturmanıza ve sürdürmenize yönelik araçlar sağlar. Ancak, bu otomasyona başlamadan önce aşağıdaki öğeleri göz önünde bulundurun:

• İş akışlarınızı oluşturduğunuz Azure mantıksal uygulama kaynağı

• İş akışlarının kullandığı ve Microsoft tarafından yönetilen bağlayıcılardan oluşturulan Azure tarafından barındırılan bağlantılar.

  Bu bağlantılar, Azure Logic Apps çalışma zamanıyla doğrudan ve yerel olarak çalışan bağlantılardan farklıdır.

• Dağıtmak istediğiniz farklı ortamlar için belirli ayarlar ve parametreler

Uzantı, derleme ve dağıtımı otomatikleştirmek için aşağıdaki gerekli görevleri tamamlamanıza yardımcı olur:

• Bağlantı başvurularını tasarım zamanında parametreleştirin. Bu görev, yerel geliştirme işlevselliğini bozmadan farklı ortamlardaki başvuruları güncelleştirme işlemini basitleştirir.

• Tüm bağımlı kaynaklar dahil olmak üzere Standart mantıksal uygulama kaynağınız için dağıtımı otomatik hale getiren betikler oluşturun.

• Azure tarafından barındırılan bağlantılar için dağıtımı otomatik hale getiren betikler oluşturun.

• Yerel geliştirme işlevselliğini bozmadan derleme işlemi sırasında Azure Logic Apps paketine ekleyebileceğiniz ortama özgü parametreleri hazırlayın.

• Derleme ve yayın işlemlerinin yanı sıra altyapı dağıtımını desteklemek için Azure DevOps kullanarak isteğe bağlı işlem hatları oluşturun.

Bu kılavuzda aşağıdaki görevlerin nasıl tamamlayacağı gösterilmektedir:

1. Visual Studio Code'da altyapı dağıtımı, sürekli tümleştirme (CI) ve sürekli dağıtım (CD) için işlem hatları oluşturan dosyaları içeren bir mantıksal uygulama çalışma alanı ve projesi oluşturun.

2. Azure DevOps'ta çalışma alanınızla Git deposu arasında bir bağlantı oluşturun.

3. Azure DevOps'ta işlem hatları oluşturma.

Daha fazla bilgi için, aşağıdaki belgelere bakın:

• Azure DevOps nedir?
• Azure Pipelines nedir?

Bilinen sorunlar ve sınırlamalar

• Bu özellik yalnızca Standart mantıksal uygulama projelerini destekler. Visual Studio Code çalışma alanınız hem Standart mantıksal uygulama projesi hem de İşlevler özel kod projesi içeriyorsa, her ikisinde de dağıtım betikleri oluşturulur, ancak özel kod projeleri şu anda yoksayılır. Özel kod için derleme işlem hatları oluşturma özelliği yol haritasındadır.

• Uzantı, altyapı dağıtımı, sürekli tümleştirme (CI) ve sürekli dağıtım (CD) için işlem hatları oluşturur. Ancak işlem hatlarını Azure DevOps'a bağlamak ve ilgili tetikleyicileri oluşturmak sizin sorumluluğundadır.

• Şu anda uzantı, altyapı dağıtım betikleri için yalnızca Azure Kaynak Yönetimi şablonlarını (ARM şablonları) destekler. Diğer şablonlar planlamadadır.

Önkoşullar

• Bir Azure hesabı ve aboneliği Aboneliğiniz yoksa, ücretsiz bir Azure hesabı için kaydolun.

• Azure Logic Apps (Standart) uzantısına sahip Visual Studio Code. Bu gereksinimleri karşılamak için Visual Studio Code ile Standart iş akışları oluşturma önkoşullarına bakın.

• Azure DevOps Görevleri için Azure Logic Apps (Standart) Derleme ve Yayın görevleri. Bu görevleri Azure DevOps Market'te bulabilirsiniz.

• Azure DevOps'ta mantıksal uygulama projenizi depolayabileceğiniz mevcut bir Git deposu.

• Mevcut bir hizmet sorumlusuyla Azure Resource Manager hizmet bağlantısı.

• Mantıksal uygulamanızı dağıtmak istediğiniz mevcut bir Azure kaynak grubu .

Mantıksal uygulama çalışma alanı, proje ve iş akışı oluşturma

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

2. Azure penceresinde, Çalışma Alanı araç çubuğunda Azure Logic Apps menüsünü açın ve Yeni mantıksal uygulama çalışma alanı oluştur'u seçin.

   

3. Aşağıdaki görevleri tamamlamak için istemleri izleyin:

   1. Çalışma alanınızı oluşturmak için klasörü seçin.

   2. Çalışma alanı adınızı girin.

   3. Proje türünü seçin: Mantıksal uygulama

   4. Mantıksal uygulama projenizin adını girin.

   5. İş akışı şablonunu seçin. İş akışı adınızı girin.

   6. Çalışma alanınızı geçerli Visual Studio Code penceresinde mi yoksa yeni bir pencerede mi açmayacağınızı seçin.

      Visual Studio Code yeni çalışma alanınızı ve mantıksal uygulama projenizi gösterir.

4. İş akışı tasarımcısını açmak için şu adımları izleyin:

   1. Mantıksal uygulama projenizde, iş akışı adınızı içeren klasörü genişletin.

   2. Henüz açılmadıysa workflow.json dosyasını açın, dosyanın kısayol menüsünü açın ve Tasarımcıyı Aç'ı seçin.

   3. Projeniz yüklendiğinde bağlantılar için parametreleştirmelere izin vermeniz istendiğinde Evet'i seçin.

      Bu seçim, projenizin farklı ortamlar için derleme ve dağıtımı otomatikleştirebilmeniz için bağlantı tanımlarında parametreleri kullanmasına olanak tanır.

   4. Şu öğeleri seçmek için istemleri izleyin:

      • Azure'dan bağlayıcıları kullanma

        Not

        Bu adımı atlarsanız, yalnızca çalışma zamanı tarafından barındırılan yerleşik bağlayıcıları kullanabilirsiniz. Microsoft tarafından yönetilen, Azure tarafından barındırılan bağlayıcıları daha sonra etkinleştirmek için şu adımları izleyin:

        1. workflow.json dosyasının kısayol menüsünü açın ve Azure'dan Bağlayıcıları Kullan'ı seçin.

        2. Mantıksal uygulamanız için kullanmak istediğiniz mevcut bir Azure kaynak grubunu seçin.

        3. İş akışı tasarımcısını yeniden yükleyin.

      • Mantıksal uygulamanız için kullanmak istediğiniz mevcut Azure kaynak grubu

5. İşiniz bittiğinde iş akışı tasarımcısını yeniden yükleyin. İstenirse Azure'da oturum açın.

   

Artık iş akışını istediğiniz şekilde düzenleyebilir ve yol boyunca iş akışınızı yerel olarak test edebilirsiniz. Örnek iş akışı oluşturmak ve test etmek için bkz . Visual Studio Code ile Standart iş akışları oluşturma.

Dağıtım betikleri oluşturma

İş akışınızı oluşturup yerel olarak test ettikten sonra dağıtım betiklerinizi oluşturun.

1. Tüm proje dosyalarınızın altındaki boş alandan projenizin kısayol menüsünü açın ve Dağıtım betikleri oluştur'a tıklayın.

   

2. Şu adımları tamamlamak için istemleri izleyin:

   1. Mantıksal uygulamanız için kullanılacak mevcut Azure kaynak grubunu seçin.

   2. Mantıksal uygulama kaynağınız için benzersiz bir ad girin.

   3. Depolama hesabı kaynağınız için benzersiz bir ad girin.

   4. App Service Planınız için kullanılacak benzersiz bir ad girin.

   5. Dosyaları oluşturmak istediğiniz çalışma alanı klasörünü seçin.

      Dağıtım klasörü konumu	Açıklama
      Yeni dağıtım klasörü (Varsayılan)	Geçerli çalışma alanında yeni bir klasör oluşturun.
      Farklı bir klasör seçin	Geçerli çalışma alanında farklı bir klasör seçin.

   İşiniz bittiğinde Visual Studio Code, çalışma alanınızın kökünde deployment/{logic-app-name} adlı bir klasör oluşturur. Bu klasör, bu adımlarda sağladığınız mantıksal uygulama adını kullanır.

   Not

   Aşağıdaki dosyalardaki değişkenlerin, uygulama ayarlarının ve parametrelerin değerleri, bu adımlarda sağladığınız girişe göre önceden doldurulur. Farklı bir ortamı hedeflediğinizde, oluşturulan parametreler ve değişken dosyaları için değerleri güncelleştirdiğinizden emin olun.

   

   {logic-app-name} klasörünün altında aşağıdaki yapıya sahipsiniz:

   Klasör adı	Dosya adı ve açıklaması
   ADOPipelineScripts	- CD-pipeline.yml: Mantıksal uygulama kodunu Azure'daki mantıksal uygulama kaynağına dağıtma yönergelerini içeren sürekli teslim işlem hattı. - CD-pipeline-variables.yml: CD-pipeline.yml dosyası tarafından kullanılan değişkenleri içeren bir YAML dosyası. - CI-pipeline.yml: Mantıksal uygulama kaynağını Azure'a dağıtmak için gereken yapıtları oluşturma ve oluşturma yönergelerini içeren sürekli tümleştirme işlem hattı. - CI-pipeline-variables.yml: CI-pipeline.yml dosyası tarafından kullanılan değişkenleri içeren bir YAML dosyası. - infrastructure-pipeline.yml: Tüm ARM şablonlarını Azure'a yükleme ve infrastructure-pipeline-template.yml dosyasındaki adımları yürütme yönergelerini içeren bir YAML "Kod Olarak Altyapı" işlem hattı. - infrastructure-pipeline-template.yml: Mantıksal uygulama kaynağını gerekli tüm bağımlılıklarla dağıtma ve kaynak kodun gerektirdiği her yönetilen bağlantıyı dağıtma adımlarını içeren bir YAML işlem hattı dosyası. - infrastructure-pipeline-variables.yml: infrastructure-pipeline-template.yml dosyasındaki adımları yürütmek için gereken tüm değişkenleri içeren bir YAML işlem hattı.
   ArmTemplates	- {connection-type}.parameters.json: {connection-type} adlı Azure tarafından barındırılan bir bağlantıyı Azure'a dağıtmak için gereken parametreleri içeren bir Resource Manager parametre dosyası. Bu dosya iş akışınızdaki azure tarafından barındırılan her bağlantı için var. - {connection-type}.template.json: {connection-reference} adlı Azure tarafından barındırılan bir bağlantıyı temsil eden ve ilgili bağlantı kaynağını Azure'a dağıtmak için kullanılan bilgileri içeren bir Resource Manager şablon dosyası. Bu dosya iş akışınızdaki azure tarafından barındırılan her bağlantı için var. - {logic-app-name}.parameters.json: Tüm bağımlılıklar dahil olmak üzere {logic-app-name} adlı Standart mantıksal uygulama kaynağını Azure'a dağıtmak için gereken parametreleri içeren bir Resource Manager parametre dosyası. - {logic-app-name}.template.json: {logic-app-name} adlı Standart mantıksal uygulama kaynağını temsil eden ve mantıksal uygulama kaynağını Azure'a dağıtmak için kullanılan bilgileri içeren bir Resource Manager şablon dosyası.
   WorkflowParameters	parameters.json: Bu JSON dosyası yerel parametreler dosyasının bir kopyasıdır ve azure tarafından barındırılan bağlantıları parametreleştirmek için uzantı tarafından oluşturulan tüm parametrelerin bulut sürümünün yanı sıra kullanıcı tanımlı tüm parametrelerin bir kopyasını içerir. Bu dosya, Azure'a dağıtan paketi oluşturmak için kullanılır.

Çalışma alanınızı Git deponuza bağlama

1. Deponuzu başlatmak için şu adımları izleyin:

   1. Visual Studio Code'da, Etkinlik çubuğunda Kaynak Denetimi simgesini seçin.

   2. Kaynak Denetimi penceresinde Depoyu Başlat'ı seçin.

   3. İstem menüsünde Klasör Seç'i seçin. Çalışma alanı kök klasörünü ve ardından Depoyu Başlat'ı seçin.

      

   4. Kaynak Denetimi penceresinde Depoyu Aç'ı seçin.

   5. İstem menüsünden, yeni oluşturduğunuz depoyu seçin.

   Daha fazla bilgi için bkz . Visual Studio Code - Yerel klasörde depo başlatma.

2. Git deponuzun URL'sini almak için şu adımları izleyin; böylece uzak depo ekleyebilirsiniz:

   1. Azure DevOps'ta, Azure DevOps kuruluşunuz için takım projesini açın.

   2. Soldaki menüde Depolar'ı genişletin ve Dosyalar'ı seçin.

   3. Dosyalar bölmesi araç çubuğunda Kopyala'yı seçin.

      

   4. Depoyu Kopyala penceresinde, kopyanın URL'sinin HTTPS sürümünü kopyalayın.

      Daha fazla bilgi için bkz . Azure Repos'ta Git deponuzun kopya URL'sini alma.

3. Git deponuz için bir uzak sunucu eklemek için şu adımları izleyin:

   1. Visual Studio Code'a ve Kaynak Denetimi penceresine dönün.

   2. Kaynak Denetimi Depoları'nın altında, deponuzun araç çubuğundan üç nokta (...) menüsünü açın ve Uzak Uzak>Ekle'yi seçin.

      

4. İstemde, kopyalanan URL'nizi yapıştırın ve uzak url için genellikle kaynak olan bir ad girin.

   Artık Visual Studio Code ile deponuz arasında bir bağlantı oluşturdunuz.

5. Sonraki bölümde işlem hatlarınızı ayarlamadan önce CD-pipeline.yml dosyasını açın ve özniteliğindeki CI İşlem Hattı'nı source kullanmak istediğiniz CI işlem hattı adıyla eşleşecek şekilde yeniden adlandırın.

   

6. Kaynak Denetimi penceresinde değişikliklerinizi işleyin ve depoda yayımlayın.

   Daha fazla bilgi için bkz . Kod değişikliklerini hazırlama ve işleme.

Azure DevOps'ta işlem hatları oluşturma

Azure DevOps'ta CI ve CD işlem hatlarıyla birlikte altyapı oluşturmak için aşağıdaki işlem hattı dosyalarının her biri için aşağıdaki adımları yineleyin:

• "Kod Olarak Altyapı" işlem hattı için infrastructure-pipeline.yml.
• Sürekli Tümleştirme işlem hattı için CI-pipeline.yml.
• Sürekli Teslim işlem hattı için CD-pipeline.yml.

İşlem hattı ayarlama

1. Azure DevOps'ta ekip projenize ve Depo>Dosyaları bölmesine dönün.

2. Dosyalar bölmesinde Derlemeyi ayarla'yı seçin.

   

3. İşlem hattınızın envanterini oluşturun bölmesinde depo bilgilerini onaylayın ve İşlem hattını yapılandır'ı seçin.

   

4. İşlem hattınızı yapılandırın bölmesinde Mevcut Azure Pipelines YAML dosyası'nı seçin.

   

5. Mevcut bir YAML dosyası seçin bölmesinde, Infrastructure-pipeline.yml dosyanızı seçmek için şu adımları izleyin:

   1. Dal için değişikliklerinizi işlediğiniz dalı (ana dal veya yayın dalınız gibi) seçin.

   2. Yol için işlem hattınız için kullanılacak yolu seçin. Aşağıdaki yol varsayılan değerdir:

      deployment/{logic-app-name}/ADOPipelineScripts/{infrastructure-pipeline-name}.yml

   3. Hazır olduğunuzda Devam'ı seçin.

      

6. İşlem hattınızı yapılandırın bölmesinde İşlem hattını gözden geçir'i seçin.

7. İdare edilen işlem hattınızı gözden geçirin bölmesinde aşağıdaki bilgileri sağlayın:

   • İşlem Hattı Adı: İşlem hattı için bir ad girin.
   • İşlem hattı klasörü: ./deployment/{logic-app-name}/pipelines adlı işlem hattınızın kaydedileceği klasörü seçin.

8. Bitirdiğinizde, Kaydet'i seçin.

   

İşlem hattını görüntüleme ve çalıştırma

İşlem hattınızı bulmak ve çalıştırmak için şu adımları izleyin:

1. Ekip projenizin sol menüsünde İşlem Hatları'yı genişletin ve İşlem Hatları'yı seçin.

2. Kullanılabilir tüm işlem hatlarını görüntülemek için Tümü sekmesini seçin. İşlem hattınızı bulun ve seçin.

3. İşlem hattınızın araç çubuğunda İşlem hattını çalıştır'ı seçin.

   

Daha fazla bilgi için bkz . İlk işlem hattınızı oluşturma.

Ayrıca bkz.

• İşlem hattınızı özelleştirme

• Azure CLI ile işlem hattınızı yönetme

• Visual Studio Code'da Azure Pipelines ile sürekli tümleştirme