Kontainerisasi aplikasi ASP.NET dan migrasi ke Azure App Service

Dalam artikel ini, Anda akan mempelajari cara melakukan kontainerisasi aplikasi ASP.NET dan memigrasikannya ke Azure App Service dengan menggunakan alat Kontainerisasi Aplikasi Azure Migrate. Proses kontainerisasi tidak memerlukan akses ke codebase atau basis kode Anda dan menyediakan cara mudah untuk melakukan kontainerisasi aplikasi yang sudah ada. Alat ini bekerja dengan menggunakan status aplikasi yang berjalan di server untuk menentukan komponen aplikasi. Kemudian, alat ini akan membantu Anda mengemasnya dalam citra kontainer. Sehingga Anda dapat menyebarkan aplikasi dalam kontainer di Azure App Service.

Saat ini, alat Azure Migrate App Containerization mendukung:

• Menampung aplikasi ASP.NET dan menyebarkannya di kontainer Windows di App Service.
• Melakukan kontainerisasi aplikasi ASP.NET dan menyebarkannya di kontainer Windows di Azure Kubernetes Service (AKS). Pelajari selengkapnya tentang skenario kontainerisasi ini.
• Mengkontainerisasi aplikasi web Java web di Apache Tomcat (pada server Linux) dan menyebarkannya di kontainer Linux pada AKS. Pelajari selengkapnya tentang skenario kontainerisasi ini.
• Menampung aplikasi web Java di Apache Tomcat (di server Linux) dan menyebarkannya di kontainer Linux pada App Service. Pelajari selengkapnya tentang skenario kontainerisasi ini.

Alat Kontainerisasi Aplikasi membantu Anda:

• Menemukan komponen aplikasi Anda. Alat ini tersambung secara jarak jauh ke server aplikasi yang menjalankan aplikasi ASP.NET Anda dan menemukan komponen aplikasinya. Alat ini membuat Dockerfile yang dapat digunakan untuk membuat citra kontainer untuk aplikasi.
• Bangun gambar kontainer. Anda dapat memeriksa dan menyesuaikan Dockerfile lebih lanjut sesuai pada persyaratan aplikasi Anda dan menggunakannya untuk membangun citra kontainer aplikasi Anda. Citra kontainer aplikasi akan didorong ke registri kontainer Azure yang Anda tentukan.
• Menyebarkan ke Azure App Service. Alat ini kemudian menghasilkan file penyebaran yang diperlukan untuk menyebarkan aplikasi yang telah dikontainerisasi ke Azure App Service.

Catatan

Alat Azure Migrate App Containerization membantu Anda dalam menemukan jenis aplikasi tertentu (aplikasi web ASP.NET dan Java di Apache Tomcat) dan komponennya di server aplikasi. Untuk menemukan server dan inventaris aplikasi, peran, dan fitur yang berjalan di komputer lokal, gunakan Alat penemuan dan penilaian Azure Migrate.

Tidak semua aplikasi akan mendapat keuntungan dari pergantian secara langsung ke kontainer tanpa proses perancangan ulang yang signifikan. Berikut beberapa keuntungan dari perpindahan aplikasi yang sudah ada ke kontainer tanpa penulisan ulang:

• Peningkatan pemanfaatan infrastruktur. Saat Anda menggunakan kontainer, beberapa aplikasi dapat berbagi sumber daya dan dihosting di infrastruktur yang sama. Hal ini dapat membantu Anda mengonsolidasikan infrastruktur dan meningkatkan pemanfaatan.
• Manajemen yang disederhanakan. Anda dapat menyederhanakan praktik manajemen Anda dengan meng-host aplikasi Anda di platform modern terkelola, seperti AKS dan App Service. Anda dapat melakukannya dengan menghentikan atau mengurangi proses pemeliharaan dan manajemen infrastruktur yang biasanya Anda lakukan dengan infrastruktur yang telah dimiliki.
• Portabilitas aplikasi. Portabilitas aplikasi tidak lagi jadi masalah ketika format dan platform spesifikasi kontainer ditingkatkan adopsi dan standarnya.
• Mengadopsi manajemen modern menggunakan DevOps. Menggunakan kontainer membantu Anda dalam mengadopsi dan melakukan standarisasi praktik modern untuk manajemen dan keamanan serta transisi ke DevOps.

Dalam tutorial ini, Anda akan mempelajari cara:

• Menyiapkan akun Azure.
• Memasang alat Kontainerisasi Aplikasi Azure Migrate.
• Menemukan aplikasi ASP.NET Anda.
• Bangun gambar kontainer.
• Menyebarkan aplikasi dalam kontainer di App Service.

Catatan

Tutorial menunjukkan jalur penyebaran paling sederhana untuk sebuah skenario sehingga Anda dapat menyiapkan bukti konsep dengan cepat. Tutorial menggunakan opsi default jika memungkinkan dan tidak menampilkan semua pengaturan dan jalur yang ada.

Prasyarat

Sebelum Anda memulai tutorial ini, Anda harus sudah:

Syarat	Rincian
Mengidentifikasi komputer untuk menginstal alat	Anda membutuhkan komputer Windows untuk memasang dan menjalankan alat Kontainerisasi Aplikasi Azure Migrate. Komputer Windows dapat menjalankan sistem operasi server (Windows Server 2016 atau yang lebih baru) atau klien (Windows 10). (Alat ini dapat berjalan di desktop Anda.) Komputer Windows yang menjalankan alat ini harus memiliki konektivitas jaringan ke server atau mesin virtual yang menghosting aplikasi ASP.NET yang akan dikontainerisasi. Pastikan ada ruang sebesar 6 GB yang tersedia di komputer Windows yang akan menjalankan alat Kontainerisasi Aplikasi Azure Migrate. Ruang ini digunakan untuk menyimpan artefak aplikasi. Mesin Windows harus memiliki akses internet, langsung atau melalui proxy. Pasang alat Microsoft Web Deployment di komputer yang menjalankan alat Kontainerisasi Aplikasi dan server aplikasinya jika belum terpasang. Anda dapat mengunduh alat ini.
Server aplikasi	Aktifkan PowerShell Remoting di server aplikasi: masuk ke server aplikasi dan ikuti instruksi ini untuk mengaktifkan PowerShell Remoting. Pastikan bahwa PowerShell versi 5.1 atau lebih baru terinstal di server aplikasi. Ikuti instruksi di Menginstal dan Mengonfigurasi WMF 5.1 di server aplikasi. Pasang alat Microsoft Web Deployment di komputer yang menjalankan alat Kontainerisasi Aplikasi dan server aplikasinya jika belum terpasang. Anda dapat mengunduh alat ini.
aplikasi ASP.NET	Alat ini saat ini mendukung: Aplikasi ASP.NET yang menggunakan .NET Framework 3.5 atau yang lebih baru. Server aplikasi yang menjalankan Windows Server 2012 R2 atau yang lebih baru. (Server aplikasi harus menjalankan PowerShell 5.1.) Aplikasi yang berjalan pada Internet Information Services 7.5 atau yang lebih baru. Alat ini saat ini tidak mendukung: Aplikasi yang memerlukan autentikasi Windows. (AKS saat ini tidak mendukung gMSA.) Aplikasi yang bergantung pada layanan Windows lainnya yang dihosting di luar Internet Information Services.

Menyiapkan akun pengguna Azure

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum memulai.

Setelah langganan Anda disiapkan, Anda akan memerlukan akun pengguna Azure dengan:

• Izin pemilik pada langganan Azure.
• Izin untuk mendaftarkan aplikasi Microsoft Entra.

Jika Anda baru saja membuat akun Azure gratis, Anda adalah pemilik langganan Anda. Jika Anda bukan pemilik langganan, bekerja samalah dengan pemilik untuk menetapkan izin sebagai berikut:

1. Di portal Microsoft Azure, cari "langganan." Di bawah Layanan, pilih Langganan:

   

2. Pada halaman Langganan , pilih langganan tempat Anda ingin membuat proyek Azure Migrate.

3. Di langganan, di panel kiri, pilih Kontrol akses (IAM).

4. Pada tab Periksa akses , cari akun pengguna yang relevan.

5. Di bawah Tambahkan penetapan peran, pilih Tambahkan:

   

6. Pada halaman Tambahkan penetapan peran , pilih peran Pemilik , lalu pilih akun (azmigrateuser dalam contoh kami). Lalu pilih Simpan.

   

   Akun Azure Anda juga memerlukan izin untuk mendaftarkan aplikasi Microsoft Entra.

7. Di portal Azure, pergi ke Microsoft Entra ID>Pengguna>Pengaturan Pengguna.

8. Di Pengaturan pengguna, verifikasi bahwa pengguna Microsoft Entra dapat mendaftarkan aplikasi. (Opsi ini diatur ke Ya secara default.)

   

   Penting

   Microsoft menyarankan agar Anda menggunakan peran dengan izin terkecil. Ini membantu meningkatkan keamanan untuk organisasi Anda. Administrator Global adalah peran yang sangat istimewa yang harus dibatasi pada skenario darurat ketika Anda tidak dapat menggunakan peran yang ada.

9. Jika opsi Pendaftaran aplikasi diatur ke Tidak, minta admin penyewa/global untuk menetapkan izin yang diperlukan. Atau, admin penyewa/global dapat menetapkan peran Pengembang aplikasi ke akun untuk memungkinkan pendaftaran aplikasi Microsoft Entra. Untuk informasi selengkapnya, lihat Menetapkan peran kepada pengguna.

Mengunduh dan memasang alat Kontainerisasi Aplikasi Azure Migrate

1. Unduh alat penginstal Kontainerisasi Aplikasi Azure Migrate di komputer Windows.

2. Buka PowerShell dalam mode admin dan ubah direktori PowerShell ke folder yang berisi alat penginstal.

3. Jalankan skrip penginstalan dengan menggunakan perintah ini:

   .\AppContainerizationInstaller.ps1
   

Catatan

Untuk Windows Server 2022, edit baris 135 dan hapus PowerShell-ISE dari daftar fitur, karena tidak lagi didukung.

Membuka alat Kontainerisasi Aplikasi

1. Buka browser di komputer apa pun yang dapat tersambung ke komputer Windows yang menjalankan alat Kontainerisasi Aplikasi. Pergi ke URL alat: https://nama mesin atau alamat IP: 44369.

   Sebagai laternatif, Anda dapat membuka aplikasi dari desktop dengan mengklik pintasan aplikasi.

2. Jika Anda melihat peringatan yang mengatakan koneksi Anda tidak privat, pilih Tingkat Lanjut dan lanjutkan ke situs web. Peringatan ini muncul karena antarmuka web menggunakan sertifikat TLS/SSL yang ditandatangani sendiri.

3. Di layar rincian masuk, gunakan akun administrator lokal pada komputer untuk masuk.

4. Pilih ASP.NET aplikasi web sebagai jenis aplikasi yang ingin Anda kontainerisasi.

5. Di daftar Layanan Azure Target , pilih Kontainer di Azure App Service:

   

Melengkapi prasyarat alat

1. Terima syarat lisensi dan baca informasi pihak ketiga.
2. Di aplikasi web alat Siapkan prasyarat, selesaikan langkah-langkah berikut:

   • Konektivitas. Alat ini memeriksa apakah komputer Windows memiliki akses internet. Jika komputer menggunakan proksi:

     1. Pilih Siapkan proksi untuk menentukan alamat proksi (dalam bentuk alamat IP atau FQDN) dan port yang digunakan.

     2. Tentukan kredensial jika proksi memerlukan autentikasi.

     3. Jika Anda telah menambahkan detail proksi atau menonaktifkan proksi atau autentikasi, pilih Simpan untuk memicu pemeriksaan konektivitas lagi.

     Hanya proksi HTTP yang didukung.

   • Instal pembaruan. Alat ini memeriksa pembaruan terbaru dan memasangnya secara otomatis. Anda juga dapat menginstal alat versi terbaru secara manual.

   • Memasang alat Microsoft Web Deploy. Alat ini akan memeriksa apakah alat Penyebaran Microsoft Web telah dipasang di komputer Windows yang menjalankan alat Kontainerisasi Aplikasi Azure Migrate.

   • Mengaktifkan PowerShell jarak jauh. Alat ini akan memberikan perintah kepada Anda untuk memastikan bahwa PowerShell remoting diaktifkan di server aplikasi yang menjalankan aplikasi ASP.NET yang ingin Anda jadikan kontainer.

Masuk ke Azure

1. Pilih Masuk untuk masuk ke akun Azure Anda.

   Anda memerlukan kode perangkat untuk mengautentikasi dengan Azure. Memilih Masuk akan membuka jendela yang berisi kode perangkat. Jika jendela tidak muncul, pastikan bahwa Anda telah menonaktifkan pemblokir pop-up di browser.

2. Pilih Salin kode dan Masuk untuk menyalin kode perangkat dan buka perintah masuk Azure di tab browser baru:

   

3. Pada tab baru, tempelkan kode perangkat dan selesaikan proses masuk dengan menggunakan informasi masuk akun Azure Anda. Setelah berhasil masuk, Anda dapat menutup tab browser dan kembali ke antarmuka web alat Kontainerisasi Aplikasi.

4. Pilih tenant Azure yang ingin Anda gunakan.

5. Tentukan langganan Azure yang ingin Anda gunakan.

Menemukan aplikasi ASP.NET

Alat Kontainerisasi Aplikasi menyambungkan dari jarak jauh ke server aplikasi dengan menggunakan informasi masuk yang telah disediakan dan mencoba untuk menemukan aplikasi ASP.NET yang dihosting di server aplikasi.

1. Tentukan Alamat IP Server /FQDN dan kredensial server yang menjalankan aplikasi ASP.NET yang harus digunakan untuk terhubung dari jarak jauh ke server untuk penemuan aplikasi.

   • Mandat yang disediakan harus untuk administrator lokal (Windows) pada server aplikasi.
   • Untuk akun domain (pengguna harus menjadi administrator di server aplikasi), awali nama pengguna dengan nama domain dalam format ini: <domain\nama> pengguna.
   • Untuk akun lokal (pengguna harus menjadi administrator di server aplikasi), awali nama pengguna dengan nama host dalam format ini: <nama host\nama> pengguna.
   • Anda dapat menjalankan penemuan aplikasi hingga lima server sekaligus.

2. Pilih Validasi untuk memverifikasi bahwa server aplikasi dapat dijangkau dari mesin yang menjalankan alat dan bahwa kredensial valid. Setelah validasi berhasil, kolom Status akan menampilkan status sebagai Dipetakan:

   

3. Pilih Lanjutkan untuk memulai penemuan aplikasi pada server aplikasi yang dipilih.

4. Setelah penemuan aplikasi selesai, pilih aplikasi yang ingin Anda kontainerisasi:

   

5. Tentukan nama untuk kontainer target di setiap aplikasi yang dipilih. Tentukan nama kontainer sebagai <, di mana > digunakan untuk gambar kontainer. Misalnya, Anda dapat menentukan nama kontainer target sebagai appname:v1.

Membuat parameter konfigurasi aplikasi

Mengonfigurasi parameter menjadikannya tersedia sebagai parameter saat penerapan. Pembuatan parameter ini memungkinkan Anda untuk mengonfigurasi pengaturan saat Anda menyebarkan aplikasi, bukan membuatnya dikodekan secara permanen ke nilai tertentu dalam citra kontainer. Misalnya, opsi ini berguna untuk parameter seperti string koneksi database.

1. Pilih konfigurasi aplikasi untuk meninjau konfigurasi yang terdeteksi.

2. Pilih parameter yang ingin Anda parameterisasi, lalu pilih Terapkan:

   

Eksternalisasi dependensi sistem file

Anda dapat menambahkan folder lain yang digunakan aplikasi Anda. Tentukan apakah citra kontainer tersebut harus menjadi bagian dari kontainer atau dieksternalisasi ke penyimpanan persisten melalui Azure File Share. Menggunakan penyimpanan persisten eksternal sangat bagus untuk aplikasi berkondisi yang menyimpan status di luar kontainer atau memiliki konten statis lainnya yang disimpan di sistem file.

1. Pilih Edit di bawah Folder aplikasi untuk meninjau folder aplikasi yang terdeteksi. Folder tersebut telah diidentifikasi sebagai artefak wajib yang diperlukan oleh aplikasi. Mereka akan disalin ke dalam citra kontainer.

2. Pilih Tambahkan folder dan tentukan jalur folder yang ingin Anda tambahkan.

3. Untuk menambahkan beberapa folder ke volume yang sama, pisahkan nilai dengan koma.

4. Pilih Berbagi file Azure sebagai opsi penyimpanan jika Anda ingin folder disimpan di luar kontainer pada penyimpanan persisten.

5. Pilih Simpan setelah Anda meninjau folder aplikasi:

   

6. Pilih Lanjutkan untuk melanjutkan ke fase build gambar kontainer.

Menyusun gambar kontainer

1. Di daftar dropdown, pilih registri kontainer Azure yang akan digunakan untuk membangun dan menyimpan gambar kontainer untuk aplikasi. Anda dapat menggunakan registri kontainer Azure yang sudah ada atau membuat yang baru dengan memilih Buat registri baru:

   

   Catatan

   Hanya registri kontainer Azure dengan pengguna admin yang telah diaktifkan saja yang ditampilkan. Akun admin saat ini diperlukan untuk menyebarkan citra dari registri kontainer Azure ke Azure App Service. Untuk informasi selengkapnya, lihat Mengautentikasi dengan registri kontainer Azure.

2. Dockerfile yang diperlukan dalam membuat citra kontainer untuk setiap aplikasi yang dipilih telah dibuat di awal langkah build. Pilih Tinjau untuk meninjau Dockerfile. Anda juga dapat menambahkan kustomisasi yang diperlukan di Dockerfile di langkah peninjauan dan menyimpan perubahan sebelum memulai proses build.

3. Pilih aplikasi yang ingin Anda buat gambarnya, lalu pilih Bangun. Memilih Build akan memulai build gambar kontainer untuk setiap aplikasi. Alat ini memantau status build dan memungkinkan Anda untuk melanjutkan ke langkah selanjutnya setelah proses build selesai.

4. Anda dapat memantau kemajuan build dengan memilih Build dalam Proses di bawah kolom status. Tautan akan menjadi aktif beberapa menit setelah Anda memicu proses build.

5. Setelah build selesai, pilih Lanjutkan untuk menentukan pengaturan penyebaran:

   

Menyebarkan aplikasi yang dikontainerisasi di Azure App Service

Setelah gambar kontainer dibuat, langkah selanjutnya adalah menyebarkan aplikasi sebagai kontainer di Azure App Service.

1. Pilih paket Azure App Service yang harus digunakan aplikasi tersebut.

   Jika Anda tidak memiliki paket App Service atau ingin membuat paket App Service baru untuk digunakan, Anda dapat membuatnya dengan memilih Buat paket App Service baru.

2. Pilih Lanjutkan setelah Anda memilih paket App Service.

3. Jika Anda telah membuat parameter konfigurasi aplikasi, tentukan penyimpanan rahasia untuk digunakan aplikasi. Anda dapat memilih pengaturan aplikasi Azure Key Vault atau App Service untuk mengelola rahasia aplikasi Anda. Untuk informasi selengkapnya, lihat Mengonfigurasi string koneksi.

   • Jika Anda memilih pengaturan aplikasi App Service untuk mengelola rahasia Anda, pilih Lanjutkan.
   • Jika Anda ingin menggunakan Azure Key Vault untuk mengelola rahasia aplikasi Anda, tentukan brankas kunci yang ingin Anda gunakan.
     • Jika Anda tidak memiliki Azure Key Vault atau ingin membuat brankas kunci baru, Anda dapat membuatnya dengan memilih Buat Azure Key Vault baru.
     • Alat ini akan menetapkan izin yang diperlukan secara otomatis untuk mengelola rahasia melalui brankas kunci.

4. Jika Anda telah menambahkan lebih banyak folder dan memilih opsi berbagi file Azure sebagai penyimpanan persisten, tentukan berbagi file Azure yang akan digunakan oleh alat Kontainerisasi Aplikasi selama penyebaran. Alat ini akan menyalin folder aplikasi yang telah Anda dikonfigurasi untuk Azure Files dan memasangnya pada kontainer aplikasi selama penyebaran. 

   Jika Anda tidak memiliki berbagi file Azure atau ingin membuat berbagi file Azure baru, Anda dapat membuatnya dengan memilih Buat Akun Penyimpanan baru dan berbagi file.

5. Sekarang, Anda perlu menentukan konfigurasi penyebaran untuk aplikasi. Pilih Konfigurasikan untuk menyesuaikan penyebaran untuk aplikasi. Dalam langkah konfigurasi, Anda dapat menyediakan kustomisasi berikut:

   • Nama. Tentukan nama unik aplikasi untuk aplikasi. Nama ini akan digunakan untuk menghasilkan URL aplikasi. Nama ini juga akan digunakan sebagai awalan untuk sumber daya lain yang dibuat sebagai bagian dari penyebaran.
   • Konfigurasi aplikasi. Untuk konfigurasi aplikasi apa pun yang telah dibuat parameternya, berikan nilai yang digunakan untuk penyebaran saat ini.
   • Konfigurasi penyimpanan. Tinjau informasi untuk setiap folder aplikasi yang dikonfigurasi untuk penyimpanan tetap.

   

6. Setelah Anda menyimpan konfigurasi penyebaran untuk aplikasi, alat akan menghasilkan YAML penyebaran Kubernetes untuk aplikasi.

   • Pilih Tinjau untuk meninjau konfigurasi penyebaran untuk aplikasi.

   • Pilih aplikasi yang ingin Anda sebarkan.

   • Pilih Sebarkan untuk memulai penyebaran untuk aplikasi yang dipilih.

     

   • Setelah aplikasi disebarkan, Anda dapat memilih kolom Status penyebaran untuk melacak sumber daya yang disebarkan untuk aplikasi.

Memecahkan masalah

Untuk memecahkan masalah dengan alat Kontainerisasi Aplikasi, Anda dapat melihat file log di komputer Windows yang menjalankan alat tersebut. File log untuk alat ini terletak di C:\ProgramData\Microsoft Azure Migrate App Containerization\Logs.

Langkah berikutnya

• Kontainerisasi ASP.NET aplikasi web dan menyebarkannya pada kontainer Windows di AKS
• Kontainerisasi aplikasi web Java di Apache Tomcat (di server Linux) dan menyebarkannya di kontainer Linux di AKS
• Kontainerisasi aplikasi web Java di Apache Tomcat (di server Linux) dan menyebarkannya di kontainer Linux di App Service