Tutorial: Menyiapkan CI/CD untuk aplikasi Service Fabric dengan menggunakan Azure Pipelines
Tutorial ini adalah bagian empat dalam satu seri. Ini menunjukkan kepada Anda cara menyiapkan integrasi berkelanjutan dan penyebaran berkelanjutan (CI/CD) untuk aplikasi Azure Service Fabric dengan menggunakan Azure Pipelines. Untuk menyelesaikan tutorial, Anda harus memiliki aplikasi Service Fabric yang ada. Tutorial ini menggunakan aplikasi yang dijelaskan di bagian salah satu seri tutorial.
Dalam tutorial ini, Anda akan mempelajari cara:
- Menambahkan kontrol sumber ke proyek Anda
- Membuat alur bangun di Alur Pipa Azure
- Membuat alur rilis di Alur Pipa Azure
- Menerapkan dan meningkatkan aplikasi secara otomatis
Seri tutorial menunjukkan kepada Anda cara:
- Membangun aplikasi .NET Service Fabric
- Menyebarkan aplikasi ke kluster jarak jauh
- Menambahkan titik akhir HTTPS ke layanan front-end ASP.NET Core
- Mengonfigurasi CI/CD dengan menggunakan Azure Pipelines (tutorial ini)
- Menyiapkan pemantauan dan diagnostik untuk aplikasi
Prasyarat
Sebelum Anda memulai tutorial ini:
- Jika Anda tidak memiliki langganan Azure, buat akun gratis.
- Instal Visual Studio 2019, termasuk beban kerja pengembangan Azure dan beban kerja ASP.NET dan pengembangan web.
- Pasang Service Fabric SDK.
- Buat kluster Windows Service Fabric di Azure, misalnya, dengan mengikuti tutorial ini.
- Buat organisasi Azure DevOps sehingga Anda dapat membuat proyek di Azure DevOps dan menggunakan Azure Pipelines.
Unduh aplikasi sampel Voting
Jika Anda tidak membangun aplikasi sampel Voting di bagian salah satu seri ini, Anda dapat mengunduhnya. Di jendela perintah, jalankan perintah berikut untuk mengkloning repositori aplikasi sampel ke komputer lokal Anda.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Menyiapkan profil penerbitan
Sekarang setelah Anda membuat aplikasi dan menyebarkan aplikasi ke Azure, Anda siap untuk menyiapkan integrasi berkelanjutan. Pertama, siapkan profil penerbitan dalam aplikasi Anda untuk digunakan oleh proses penyebaran yang dijalankan dalam Alur Pipa Azure. Profil penerbitan harus dikonfigurasi untuk menargetkan kluster yang sebelumnya Anda buat. Mulai Visual Studio dan buka proyek aplikasi Service Fabric yang ada. Di Penjelajah Solusi, klik kanan aplikasi dan pilih Terbitkan.
Pilih profil target di proyek aplikasi Anda untuk digunakan untuk alur kerja integrasi berkelanjutan Anda, misalnya, Cloud. Tentukan titik akhir koneksi kluster. Pilih kotak centang Tingkatkan Aplikasi sehingga aplikasi Anda ditingkatkan untuk setiap penyebaran di Azure DevOps. Pilih tautan Simpan Profil untuk menyimpan pengaturan ke profil penerbitan, lalu pilih Batal untuk menutup dialog.
Membagikan solusi Visual Studio Anda ke repo Azure DevOps Git baru
Bagikan file sumber aplikasi Anda ke proyek di Azure DevOps sehingga Anda dapat membuat build.
Untuk membuat repositori GitHub baru dan repositori Azure DevOps di Visual Studio 2022, pilih Git>Create Git Repository pada menu Git.
Pilih akun Anda dan masukkan nama repositori Anda. Pilih Buat dan Dorong.
Menerbitkan repositori membuat proyek baru di akun Azure DevOps Services Anda yang memiliki nama yang sama dengan repositori lokal.
Untuk melihat repositori yang baru dibuat, buka https://dev.azure.com/><organizationname>. Arahkan mouse ke atas nama proyek Anda dan pilih ikon Repos .
Mengonfigurasi pengiriman berkelanjutan dengan menggunakan Azure Pipelines
Alur build Azure Pipelines menjelaskan alur kerja yang memiliki serangkaian langkah build yang dijalankan secara berurutan. Untuk menyebarkan ke kluster Service Fabric, buat alur build yang menghasilkan paket aplikasi Service Fabric dan artefak lainnya. Pelajari selengkapnya tentang Alur build Alur Pipa Azure.
Alur rilis Alur Pipa Azures menjelaskan alur kerja yang menggunakan paket aplikasi ke kluster. Saat digunakan bersama-sama, alur build dan alur rilis menjalankan seluruh alur kerja, dimulai dengan file sumber dan berakhir dengan aplikasi yang sedang berjalan di kluster Anda. Pelajari selengkapnya tentang Alur rilis Alur Pipa Azure.
Membuat alur build
Buka browser web dan buka proyek baru Anda di https://dev.azure.com/<organization-name>/VotingSample.
Pilih tab Alur , lalu pilih Buat Alur.
Pilih Gunakan editor klasik untuk membuat alur tanpa menggunakan YAML.
Untuk sumbernya, pilih Azure Repos Git. Untuk Proyek tim, pilih VotingSample. Untuk Repositori, pilih VotingApplication. Biarkan cabang default untuk build manual dan terjadwal. Lalu Pilih Lanjutkan.
Di Pilih templat, pilih templat aplikasi Azure Service Fabric, lalu pilih Terapkan.
Pada Tugas, untuk kumpulan Agen, masukkan Azure Pipelines. Untuk Spesifikasi Agen, masukkan windows-2022.
Di bawah Pemicu, pilih kotak centang Aktifkan integrasi berkelanjutan. Di Filter cabang, spesifikasi Cabang default untuk dikuasai. Pilih Simpan dan antre untuk memulai build secara manual.
Build juga memicu saat mendorong atau check-in. Untuk memeriksa kemajuan build Anda, pilih tab Build . Setelah Anda memverifikasi bahwa build berhasil dijalankan, tentukan alur rilis yang menyebarkan aplikasi Anda ke kluster.
Membuat alur pipa rilis
Pilih tab Alur, lalu pilih Rilis>Alur baru. Pada Pilih templat, pilih templat Penyebaran Azure Service Fabric, lalu pilih Terapkan.
Pilih Tugas>Baru untuk menambahkan koneksi kluster baru.
Pada Koneksi Service Fabric Baru, pilih Autentikasi kredensial Berbasis Sertifikat atau Microsoft Entra. Tentukan titik tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000 akhir kluster (atau titik akhir kluster yang Anda sebarkan).
Untuk autentikasi berbasis sertifikat, tambahkan thumbprint sertifikat server dari sertifikat server yang digunakan untuk membuat kluster. Dalam Sertifikat klien, tambahkan pengodean basis-64 dari file sertifikat klien. Lihat informasi bantuan untuk bidang tersebut untuk mempelajari cara mendapatkan representasi sertifikat yang dikodekan base-64 tersebut. Selain itu, tambahkan kata sandi untuk sertifikat. Anda dapat menggunakan sertifikat kluster atau sertifikat server jika Anda tidak memiliki sertifikat klien terpisah.
Untuk kredensial Microsoft Entra, tambahkan nilai untuk thumbprint sertifikat Server. Gunakan sertifikat server yang Anda gunakan untuk membuat kluster dan kredensial yang ingin Anda gunakan untuk menyambungkan ke kluster di Nama Pengguna dan Kata Sandi.
Pilih Simpan.
Selanjutnya, tambahkan artefak build ke alur sehingga alur rilis dapat menemukan output dari build. Pilih Tambahkan Artefak> Alur.> Di Sumber (Definisi build), pilih alur build yang Anda buat sebelumnya. Pilih Tambahkan untuk menyimpan artefak build.
Aktifkan pemicu penyebaran berkelanjutan sehingga rilis dibuat secara otomatis saat build selesai. Pilih ikon petir di artefak, aktifkan pemicu, dan pilih Simpan untuk menyimpan alur rilis.
Pilih Buat Rilis>Buat untuk membuat rilis secara manual. Untuk memantau kemajuan rilis, pilih tab Rilis .
Verifikasi bahwa penyebaran berhasil dan bahwa aplikasi berjalan di kluster. Buka browser web dan buka https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Perhatikan versi aplikasi. Contohnya, 1.0.0.20170616.3.
Menerapkan dan mendorong perubahan untuk memicu rilis
Untuk memverifikasi bahwa alur integrasi berkelanjutan berfungsi, periksa beberapa perubahan kode pada Azure DevOps.
Saat Anda menulis kode, Visual Studio melacak perubahan file pada proyek Anda di bagian Perubahan di panel Perubahan Git.
Pada Perubahan, masukkan pesan untuk menjelaskan pembaruan Anda, lalu terapkan perubahan Anda.
Pada Perubahan Git, pilih Dorong (panah atas) untuk memperbarui kode Anda di Azure Pipelines.
Mendorong perubahan ke Azure Pipelines memicu build. Untuk memeriksa kemajuan build Anda, pilih tab Alur di aplikasi di https://dev.azure.com/organizationname/VotingSample.
Setelah build selesai, rilis secara otomatis dibuat dan mulai meningkatkan aplikasi pada kluster.
Verifikasi bahwa penyebaran berhasil dan bahwa aplikasi berjalan di kluster. Buka browser web dan buka https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Perhatikan versi aplikasi. Contohnya, 1.0.0.20170815.3.
Memperbarui aplikasi
Buat perubahan kode dalam aplikasi. Simpan dan terapkan perubahan.
Ketika peningkatan aplikasi dimulai, Anda dapat melacak kemajuan peningkatan di Service Fabric Explorer:
Peningkatan aplikasi mungkin memakan waktu beberapa menit. Setelah peningkatan selesai, aplikasi menjalankan versi berikutnya. Dalam contoh ini, ia menjalankan versi 1.0.0.20170815.4.
Langkah selanjutnya
Melanjutkan ke tutorial berikutnya: