Tutorial: Menerapkan aplikasi dengan CI/CD ke kluster Service Fabric
Tutorial ini adalah bagian empat dari seri tutorial dan menjelaskan cara menyiapkan integrasi dan penyebaran berkelanjutan untuk aplikasi Azure Service Fabric menggunakan Alur Pipa Azure. Aplikasi Service Fabric yang ada diperlukan, aplikasi yang dibuat di Bangun aplikasi .NET digunakan sebagai contoh.
Di bagian ketiga seri ini, Anda 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
Dalam tutorial ini, Anda akan belajar 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 menggunakan Azure Pipelines
- Menyiapkan pemantauan dan diagnostik untuk aplikasi
Prasyarat
Sebelum Anda memulai tutorial ini:
- Jika Anda tidak memiliki langganan Azure, buatlah akun gratis
- Pasang Visual Studio 2019 Versi 16.1 atau yang lebih baru dengan beban kerja pengembangan Azure dan pengembangan ASP.NET dan web.
- Instal Service Fabric SDK
- Buat kluster Windows Service Fabric di Azure, misalnya dengan mengikuti tutorial ini
- Membuat organisasi Azure DevOps. Ini memungkinkan Anda membuat proyek di Azure DevOps dan menggunakan Alur Pipa Azure.
Unduh aplikasi sampel Voting
Jika Anda tidak membangun aplikasi sampel Voting di bagian satu dari seri tutorial 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 telah 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 telah Anda buat sebelumnya. Mulai Visual Studio dan buka proyek aplikasi Service Fabric yang ada. Di Solution Explorer, klik kanan aplikasi dan pilih Terbitkan....
Pilih profil target dalam proyek aplikasi Anda untuk digunakan pada alur kerja integrasi berkelanjutan Anda, misalnya Cloud. Tentukan titik akhir koneksi kluster. Centang kotak Tingkatkan Aplikasi sehingga aplikasi Anda ditingkatkan untuk setiap penerapan di Azure DevOps. Klik hyperlink Simpan untuk menyimpan pengaturan ke profil penerbitan, lalu klik Batalkan untuk menutup kotak 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.
Buat repositori Git lokal baru untuk proyek Anda dengan memilih Tambahkan Kontrol Sumber ->Git pada bilah status di sudut kanan bawah Visual Studio.
Dalam tampilan Pendorongan di Team Explorer, pilih tombol Terbitkan Git Repo di bawah Pendorongan ke Azure DevOps.
Verifikasi email Anda dan pilih akun Anda di drop-down Domain Azure DevOps. Masukkan nama repositori Anda dan pilih Terbitkan repositori.
Menerbitkan repo membuat proyek baru di akun Anda dengan nama yang sama dengan repo lokal. Untuk membuat repo di proyek yang sudah ada, klik Tingkat Lanjut di samping Nama repositori dan pilih proyek. Anda dapat melihat kode Anda di web dengan memilih Lihat di web.
Mengonfigurasi Pengiriman Berkelanjutan dengan Alur Pipa Azure
Alur kerja build Alur Pipa Azure menjelaskan alur kerja yang terdiri atas serangkaian langkah build yang dijalankan secara berurutan. Buat alur build yang menghasilkan paket aplikasi Service Fabric, dan artefak lainnya, untuk digunakan ke kluster Service Fabric. 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 yang dimulai dengan file sumber untuk diakhiri dengan aplikasi yang sedang berjalan di kluster Anda. Pelajari selengkapnya tentang Alur rilis Alur Pipa Azure.
Membuat alur build
Buka browser web dan navigasi ke proyek baru Anda di: https://<myaccount>.visualstudio.com/Voting/Voting%20Team/_git/Voting.
Pilih tab Alur Pipa, lalu Bangun, lalu klik Alur Pipa Baru.
Pilih Azure Repos Git sebagai sumber, proyek Tim Voting, Repositori Voting, dan cabang Default master untuk build manual dan terjadwal. Lalu klik Lanjutkan.
Di Pilih templat, pilih templat aplikasi Azure Service Fabric dan klik Terapkan.
Dalam Tugas, masukkan "Hosted VS2017" sebagai kumpulan Agen.
Di bawah Pemicu, aktifkan integrasi berkelanjutan dengan memeriksa Aktifkan integrasi berkelanjutan. Dalam filter Cabang, default spesifikasi Cabang ke master. Pilih Simpan dan antre untuk memulai build secara manual.
Build juga memicu saat mendorong atau check-in. Untuk memeriksa kemajuan build, beralihlah ke 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 pipa, lalu Rilis, lalu +Alur pipa baru. Di Pilih templat, pilih templat Penyebaran Service Fabric Azure dari daftar, lalu Terapkan.
Pilih Tugas->Lingkungan 1 lalu +Baru untuk menambahkan koneksi kluster baru.
Dalam tampilan Tambahkan Koneksi ion Service Fabric baru pilih Autentikasi Berbasis Sertifikat atau ID Microsoft Entra. Tentukan nama koneksi "mysftestcluster" dan titik akhir kluster "tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000" (atau titik akhir kluster tempat Anda menyebarkan).
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 sembulan bantuan di bidang tersebut untuk informasi tentang cara mendapatkan representasi sertifikat yang dikodekan basis-64. Selain itu, tambahkan Kata sandi untuk sertifikat. Anda dapat menggunakan sertifikat kluster atau server jika Anda tidak memiliki sertifikat klien terpisah.
Untuk kredensial Microsoft Entra, tambahkan thumbprint sertifikat Server dari sertifikat server yang digunakan untuk membuat kluster dan kredensial yang ingin Anda gunakan untuk menyambungkan ke kluster di bidang Nama Pengguna dan Kata Sandi.
Klik Tambahkan untuk menyimpan koneksi kluster.
Selanjutnya, tambahkan artefak build ke alur pipa sehingga alur piparilis dapat menemukan output dari build. Pilih Alur dan Artefak->+Tambahkan. Di Sumber (Definisi build), pilih alur pipa build yang Anda buat sebelumnya. Klik Tambahkan untuk menyimpan artefak build.
Aktifkan pemicu penyebaran berkelanjutan sehingga rilis dibuat secara otomatis saat build selesai. Klik ikon kilat di artefak, aktifkan pemicu, dan klik Simpan untuk menyimpan alur pipa rilis.
Pilih + Rilis ->Buat Rilis ->Buat untuk membuat rilis secara manual. Anda dapat memantau kemajuan rilis di tab Rilis.
Verifikasi bahwa penyebaran berhasil dan aplikasi berjalan di kluster. Buka browser web dan navigasi ke http://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Perhatikan versi aplikasi, dalam contoh ini adalah "1.0.0.20170616.3".
Perubahan penerapan dan pendorongan, memicu rilis
Untuk memverifikasi bahwa saluran integrasi berkelanjutan berfungsi dengan memeriksa beberapa perubahan kode pada Azure DevOps.
Saat Anda menulis kode, perubahan Anda secara otomatis dilacak oleh Visual Studio. Terapkan perubahan pada repositori Git lokal Anda dengan memilih ikon perubahan tertunda (
) dari bilah status di kanan bawah.
Pada tampilan Perubahan di Team Explorer, tambahkan pesan yang menjelaskan pembaruan Anda dan terapkan perubahan Anda.
Pilih ikon bilah status perubahan yang tidak diterbitkan (
) atau tampilan Sinkronkan di Team Explorer. Pilih Pendorongan untuk memperbarui kode Anda di Alur Pipa Azure.
Mendorong perubahan ke Alur Pipa Azure secara otomatis memicu build. Ketika alur pipa build berhasil diselesaikan, rilis secara otomatis dibuat dan mulai meningkatkan aplikasi pada kluster.
Untuk memeriksa kemajuan build, beralihlah ke tab Build di Team Explorer di Visual Studio. Setelah Anda memverifikasi bahwa build berhasil dijalankan, tentukan alur pipa rilis yang menyebarkan aplikasi Anda ke kluster.
Verifikasi bahwa penyebaran berhasil dan aplikasi berjalan di kluster. Buka browser web dan navigasi ke http://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Perhatikan versi aplikasi, dalam contoh ini adalah "1.0.0.20170815.3".
Memperbarui aplikasi
Buat perubahan kode dalam aplikasi. Simpan dan terapkan perubahan, dengan mengikuti langkah-langkah sebelumnya.
Setelah peningkatan aplikasi dimulai, Anda dapat menyaksikan kemajuan peningkatan di Service Fabric Explorer:
Peningkatan aplikasi mungkin memerlukan waktu beberapa menit. Ketika peningkatan selesai, aplikasi akan menjalankan versi berikutnya. Dalam contoh ini "1.0.0.20170815.4".
Langkah berikutnya
Dalam tutorial ini, Anda mempelajari cara:
- Menambahkan kontrol sumber ke proyek Anda
- Membuat alur build
- Membuat alur pipa rilis
- Menerapkan dan meningkatkan aplikasi secara otomatis
Melanjutkan ke tutorial berikutnya: