Mengotomatiskan build dan penyebaran untuk alur kerja aplikasi logika Standar dengan Azure DevOps

Untuk alur kerja aplikasi logika Standar yang berjalan di Azure Logic Apps penyewa tunggal, Anda dapat menggunakan Visual Studio Code dengan ekstensi Azure Logic Apps (Standar) untuk mengembangkan, menguji, dan menyimpan proyek aplikasi logika Anda secara lokal menggunakan sistem kontrol sumber apa pun. Namun, untuk mendapatkan manfaat penuh dari penyebaran alur kerja Anda dengan mudah dan konsisten di berbagai lingkungan dan platform, Anda juga harus mengotomatiskan proses build dan penyebaran Anda.

Ekstensi Azure Logic Apps (Standar) menyediakan alat bagi Anda untuk membuat dan memelihara proses build dan penyebaran otomatis menggunakan Azure DevOps. Namun, sebelum Anda memulai otomatisasi ini, pertimbangkan elemen berikut:

• Sumber daya aplikasi logika Azure tempat Anda membuat alur kerja

• Koneksi yang dihosting Azure yang digunakan alur kerja dan dibuat dari konektor yang dikelola Microsoft.

  Koneksi ini berbeda dari koneksi yang berjalan secara langsung dan asli dengan runtime Azure Logic Apps.

• Pengaturan dan parameter tertentu untuk lingkungan yang berbeda tempat Anda ingin menyebarkan

Ekstensi ini membantu Anda menyelesaikan tugas yang diperlukan berikut untuk mengotomatiskan build dan penyebaran:

• Parameterisasi referensi koneksi pada waktu desain. Tugas ini menyederhanakan proses pembaruan referensi di lingkungan yang berbeda tanpa merusak fungsionalitas pengembangan lokal.

• Hasilkan skrip yang mengotomatiskan penyebaran untuk sumber daya aplikasi logika Standar Anda, termasuk semua sumber daya dependen.

• Buat skrip yang mengotomatiskan penyebaran untuk koneksi yang dihosting Azure.

• Siapkan parameter khusus lingkungan yang dapat Anda suntikkan ke dalam paket Azure Logic Apps selama proses build tanpa merusak fungsionalitas pengembangan lokal.

• Hasilkan alur sesuai permintaan menggunakan Azure DevOps untuk mendukung penyebaran infrastruktur bersama dengan proses build dan rilis.

Panduan ini memperlihatkan cara menyelesaikan tugas berikut:

1. Buat ruang kerja dan proyek aplikasi logika di Visual Studio Code yang menyertakan file yang membuat alur untuk penyebaran infrastruktur, integrasi berkelanjutan (CI), dan penyebaran berkelanjutan (CD).

2. Buat koneksi antara ruang kerja Anda dan repositori Git di Azure DevOps.

3. Membuat alur di Azure DevOps.

Untuk informasi selengkapnya, lihat dokumentasi berikut:

• Apa itu Azure DevOps?
• Apa itu Azure Pipelines?

Masalah dan batasan yang diketahui

• Kemampuan ini hanya mendukung proyek aplikasi logika Standar. Jika ruang kerja Visual Studio Code Anda berisi proyek aplikasi logika Standar dan proyek kode kustom Functions, keduanya memiliki skrip penyebaran yang dihasilkan, tetapi proyek kode kustom saat ini diabaikan. Kemampuan untuk membuat alur build untuk kode kustom ada di peta jalan.

• Ekstensi ini membuat alur untuk penyebaran infrastruktur, integrasi berkelanjutan (CI), dan penyebaran berkelanjutan (CD). Namun, Anda bertanggung jawab untuk menghubungkan alur ke Azure DevOps dan membuat pemicu yang relevan.

• Saat ini, ekstensi hanya mendukung templat Azure Resource Management (templat ARM) untuk skrip penyebaran infrastruktur. Templat lain sedang dalam perencanaan.

Prasyarat

• Akun dan langganan Azure. Jika Anda tidak memiliki langganan, daftar untuk mendapatkan akun Azure secara gratis.

• Visual Studio Code dengan ekstensi Azure Logic Apps (Standar). Untuk memenuhi persyaratan ini, lihat prasyarat untuk Membuat alur kerja Standar dengan Visual Studio Code.

• Tugas Build dan Rilis Azure Logic Apps (Standar) untuk Tugas Azure DevOps. Anda dapat menemukan tugas-tugas ini di Azure DevOps Marketplace.

• Repositori Git yang ada di Azure DevOps tempat Anda dapat menyimpan proyek aplikasi logika Anda.

• Koneksi layanan Azure Resource Manager dengan perwakilan layanan yang ada.

• Grup sumber daya Azure yang sudah ada tempat Anda ingin menyebarkan aplikasi logika Anda.

Membuat ruang kerja, proyek, dan alur kerja aplikasi logika

1. Di Visual Studio Code, pada bilah Aktivitas, pilih ikon Azure.

2. Di jendela Azure , pada toolbar Ruang Kerja, buka menu Azure Logic Apps , dan pilih Buat ruang kerja aplikasi logika baru.

   

3. Ikuti perintah untuk menyelesaikan tugas berikut:

   1. Pilih folder untuk membuat ruang kerja Anda.

   2. Masukkan nama ruang kerja Anda.

   3. Pilih jenis proyek: Aplikasi logika

   4. Masukkan nama proyek aplikasi logika Anda.

   5. Pilih templat alur kerja. Masukkan nama alur kerja Anda.

   6. Pilih apakah akan membuka ruang kerja Anda di jendela Visual Studio Code saat ini atau jendela baru.

      Visual Studio Code menampilkan ruang kerja dan proyek aplikasi logika baru Anda.

4. Ikuti langkah-langkah ini untuk membuka perancang alur kerja:

   1. Di proyek aplikasi logika Anda, perluas folder dengan nama alur kerja Anda.

   2. Jika belum dibuka, buka file workflow.json , buka menu pintasan file, dan pilih Buka Perancang.

   3. Saat Anda diminta untuk mengizinkan parameterisasi untuk koneksi saat proyek Anda dimuat, pilih Ya.

      Pilihan ini memungkinkan proyek Anda menggunakan parameter dalam definisi koneksi sehingga Anda dapat mengotomatiskan build dan penyebaran untuk lingkungan yang berbeda.

   4. Ikuti perintah untuk memilih item ini:

      • Menggunakan konektor dari Azure

        Catatan

        Jika Anda melewati langkah ini, Anda hanya dapat menggunakan konektor bawaan yang dihosting runtime. Untuk mengaktifkan konektor yang dikelola Microsoft yang dihosting Azure di lain waktu, ikuti langkah-langkah berikut:

        1. Buka menu pintasan untuk file workflow.json , dan pilih Gunakan Konektor dari Azure.

        2. Pilih grup sumber daya Azure yang sudah ada yang ingin Anda gunakan untuk aplikasi logika Anda.

        3. Muat ulang perancang alur kerja.

      • Grup sumber daya Azure yang sudah ada yang ingin Anda gunakan untuk aplikasi logika Anda

5. Setelah selesai, muat ulang perancang alur kerja. Jika diminta, masuk ke Azure.

   

Sekarang Anda dapat mengedit alur kerja dengan cara apa pun yang Anda inginkan dan menguji alur kerja Anda secara lokal di sepanjang jalan. Untuk membuat dan menguji alur kerja sampel, lihat Membuat alur kerja Standar dengan Visual Studio Code.

Membuat skrip penyebaran

Setelah Anda membuat dan menguji alur kerja secara lokal, buat skrip penyebaran Anda.

1. Dari area kosong di bawah semua file proyek Anda, buka menu pintasan proyek Anda, dan pilih Hasilkan skrip penyebaran.

   

2. Ikuti perintah untuk menyelesaikan langkah-langkah berikut:

   1. Pilih grup sumber daya Azure yang sudah ada untuk digunakan untuk aplikasi logika Anda.

   2. Masukkan nama unik untuk sumber daya aplikasi logika Anda.

   3. Masukkan nama unik untuk sumber daya akun penyimpanan Anda.

   4. Masukkan nama unik yang akan digunakan untuk Paket App Service Anda.

   5. Pilih folder ruang kerja tempat Anda ingin membuat file.

      Lokasi folder penyebaran	Deskripsi
      Folder penyebaran baru (Default)	Buat folder baru di ruang kerja saat ini.
      Pilih folder lain	Pilih folder lain di ruang kerja saat ini.

   Setelah selesai, Visual Studio Code membuat folder bernama deployment/{logic-app-name} di root ruang kerja Anda. Folder ini menggunakan nama aplikasi logika yang sama dengan yang Anda berikan dalam langkah-langkah ini.

   Catatan

   Nilai variabel, pengaturan aplikasi, dan parameter dalam file berikut telah diisi sebelumnya berdasarkan input yang Anda berikan dalam langkah-langkah ini. Saat Anda menargetkan lingkungan yang berbeda, pastikan Anda memperbarui nilai untuk parameter dan file variabel yang dibuat.

   

   Di bawah folder {logic-app-name}, Anda memiliki struktur berikut:

   Nama folder	Nama dan deskripsi file
   ADOPipelineScripts	- CD-pipeline.yml: Alur pengiriman berkelanjutan yang berisi instruksi untuk menyebarkan kode aplikasi logika ke sumber daya aplikasi logika di Azure. - CD-pipeline-variables.yml: File YAML yang berisi variabel yang digunakan oleh file CD-pipeline.yml. - CI-pipeline.yml: Alur integrasi berkelanjutan yang berisi instruksi untuk membangun dan menghasilkan artefak yang diperlukan untuk menyebarkan sumber daya aplikasi logika ke Azure. - CI-pipeline-variables.yml: File YAML yang berisi variabel yang digunakan oleh file CI-pipeline.yml. - infrastructure-pipeline.yml: Alur YAML "Infrastructure-as-Code" yang berisi instruksi untuk memuat semua templat ARM ke Azure dan untuk menjalankan langkah-langkah dalam file infrastructure-pipeline-template.yml. - infrastructure-pipeline-template.yml: File alur YAML yang berisi langkah-langkah untuk menyebarkan sumber daya aplikasi logika dengan semua dependensi yang diperlukan dan untuk menyebarkan setiap koneksi terkelola yang diperlukan oleh kode sumber. - infrastructure-pipeline-variables.yml: Alur YAML yang berisi semua variabel yang diperlukan untuk menjalankan langkah-langkah dalam file infrastructure-pipeline-template.yml.
   ArmTemplates	- {connection-type}.parameters.json: File parameter Resource Manager yang berisi parameter yang diperlukan untuk menyebarkan koneksi yang dihosting Azure bernama {connection-type} ke Azure. File ini ada untuk setiap koneksi yang dihosting Azure di alur kerja Anda. - {connection-type}.template.json: File templat Resource Manager yang mewakili koneksi yang dihosting Azure bernama {connection-reference} dan berisi informasi yang digunakan untuk menyebarkan sumber daya koneksi yang sesuai ke Azure. File ini ada untuk setiap koneksi yang dihosting Azure di alur kerja Anda. - {logic-app-name}.parameters.json: File parameter Resource Manager yang berisi parameter yang diperlukan untuk menyebarkan sumber daya aplikasi logika Standar bernama {logic-app-name} ke Azure, termasuk semua dependensi. - {logic-app-name}.template.json: File templat Resource Manager yang mewakili sumber daya aplikasi logika Standar bernama {logic-app-name} dan berisi informasi yang digunakan untuk menyebarkan sumber daya aplikasi logika ke Azure.
   WorkflowParameters	parameters.json: File JSON ini adalah salinan file parameter lokal dan berisi salinan semua parameter yang ditentukan pengguna ditambah versi cloud dari parameter apa pun yang dibuat oleh ekstensi untuk membuat parameter koneksi yang dihosting Azure. File ini digunakan untuk membangun paket yang disebarkan ke Azure.

Menyambungkan ruang kerja Anda ke repositori Git Anda

1. Ikuti langkah-langkah berikut untuk menginisialisasi repositori Anda:

   1. Di Visual Studio Code, pada bilah Aktivitas, pilih ikon Kontrol Sumber.

   2. Di jendela Kontrol Sumber, pilih Inisialisasi Repositori.

   3. Dari menu perintah, pilih Pilih Folder. Pilih folder akar ruang kerja, lalu pilih Inisialisasi Repositori.

      

   4. Di jendela Kontrol Sumber, pilih Buka Repositori.

   5. Dari menu perintah, pilih repositori yang baru saja Anda buat.

   Untuk informasi selengkapnya, lihat Visual Studio Code - Menginisialisasi repositori di folder lokal.

2. Ikuti langkah-langkah ini untuk mendapatkan URL untuk repositori Git Anda sehingga Anda dapat menambahkan jarak jauh:

   1. Di Azure DevOps, buka proyek tim untuk organisasi Azure DevOps Anda.

   2. Di menu sebelah kiri, perluas Repos, dan pilih File.

   3. Pada toolbar panel File , pilih Kloning.

      

   4. Di jendela Repositori Kloning, salin versi HTTPS URL kloning.

      Untuk informasi selengkapnya, lihat Mendapatkan URL kloning untuk repositori Git Anda di Azure Repos.

3. Ikuti langkah-langkah berikut untuk menambahkan remote untuk repositori Git Anda:

   1. Kembali ke Visual Studio Code dan ke jendela Kontrol Sumber.

   2. Di bawah Repositori Kontrol Sumber, dari toolbar repositori Anda, buka menu elipsis (...), dan pilih Tambahkan Jarak Jauh>.

      

4. Pada perintah, tempelkan URL yang disalin, dan masukkan nama untuk remote, yang biasanya berasal.

   Anda sekarang telah membuat koneksi antara Visual Studio Code dan repositori Anda.

5. Sebelum Anda menyiapkan alur di bagian berikutnya, buka file CD-pipeline.yml , dan ganti nama Alur CI di source atribut agar sesuai dengan nama alur CI yang ingin Anda gunakan.

   

6. Di jendela Kontrol Sumber, terapkan perubahan Anda, dan terbitkan ke repositori.

   Untuk informasi selengkapnya, lihat Tahapan dan penerapan perubahan kode.

Membuat alur di Azure DevOps

Untuk membuat infrastruktur bersama dengan alur CI dan CD di Azure DevOps, ulangi langkah-langkah berikut untuk setiap file alur berikut:

• infrastructure-pipeline.yml untuk alur "Infrastructure-as-Code".
• CI-pipeline.yml untuk alur Integrasi Berkelanjutan.
• CD-pipeline.yml untuk alur Pengiriman Berkelanjutan.

Menyiapkan alur

1. Di Azure DevOps, kembali ke proyek tim Anda dan ke panel Repos>Files.

2. Pada panel File , pilih Siapkan build.

   

3. Pada panel Inventori alur Anda, konfirmasikan informasi repositori, dan pilih Konfigurasikan alur.

   

4. Pada panel Konfigurasikan alur Anda, pilih File YAML Alur Azure yang Sudah Ada.

   

5. Pada panel Pilih file YAML yang sudah ada, ikuti langkah-langkah berikut untuk memilih file Infrastructure-pipeline.yml Anda:

   1. Untuk Cabang, pilih cabang tempat Anda melakukan perubahan, misalnya, utama atau cabang rilis Anda.

   2. Untuk Jalur, pilih jalur yang akan digunakan untuk alur Anda. Jalur berikut adalah nilai default:

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

   3. Setelah siap, pilih Lanjutkan.

      

6. Pada panel Konfigurasikan alur Anda, pilih Tinjau alur.

7. Pada panel Tinjau alur yang diatur, berikan informasi berikut ini:

   • Nama Alur: Masukkan nama untuk alur.
   • Folder alur: Pilih folder tempat menyimpan alur Anda, yang diberi nama ./deployment/{logic-app-name}/pipelines.

8. Jika sudah selesai, pilih Simpan.

   

Menampilkan dan menjalankan alur

Untuk menemukan dan menjalankan alur Anda, ikuti langkah-langkah berikut:

1. Di menu kiri proyek tim Anda, perluas Alur, dan pilih Alur.

2. Pilih tab Semua untuk melihat semua alur yang tersedia. Temukan dan pilih alur Anda.

3. Pada toolbar alur Anda, pilih Jalankan alur.

   

Untuk informasi selengkapnya, lihat Membuat alur pertama Anda.

Lihat juga

• Mengkustomisasi alur Anda

• Mengelola alur Anda dengan Azure CLI

• Integrasi berkelanjutan dengan Azure Pipelines di Visual Studio Code