Kontainerisasi dan migrasi aplikasi web Java ke Azure Kubernetes Service

Perhatian

Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan perencanaan Anda yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.

Dalam artikel ini, Anda akan mempelajari cara mengkontainerisasi aplikasi web Java (berjalan di Apache Tomcat) dan memigrasikannya ke Azure Kubernetes Service (AKS) menggunakan Azure Migrate: Alat Kontainerisasi Aplikasi. Proses penampungan tidak memerlukan akses ke basis kode Anda dan menyediakan cara mudah untuk menampung aplikasi yang ada. Alat ini bekerja dengan menggunakan status aplikasi yang berjalan di server untuk menentukan komponen aplikasi dan membantu Anda mengemasnya dalam image kontainer. Aplikasi yang ditampung dapat disebarkan di Azure Kubernetes Service (AKS).

Azure Migrate: Alat Penampungan Aplikasi saat ini mendukung -

• Menampung Java Web Apps di Apache Tomcat (di server Linux) dan menyebarkannya di kontainer Linux di AKS.
• Mengontainerisasi Aplikasi Web Java di Apache Tomcat (pada server Linux) dan menyebarkannya di kontainer Linux pada App Service. Pelajari lebih lanjut
• Mengkontainerisasi aplikasi ASP.NET dan menyebarkannya pada kontainer Windows di AKS. Pelajari lebih lanjut
• Menampung aplikasi ASP.NET dan menyebarkannya di kontainer Windows di App Service. Pelajari lebih lanjut

Azure Migrate: alat Penampungan Aplikasi membantu Anda untuk -

• Menemukan aplikasi Anda: Alat ini terhubung dari jarak jauh ke server aplikasi yang menjalankan aplikasi web Java Anda (berjalan di Apache Tomcat) dan menemukan komponen aplikasi. Alat ini membuat Dockerfile yang dapat digunakan guna membuat gambar kontainer untuk aplikasi.
• Membangun image kontainer: Anda dapat memeriksa dan menyesuaikan Dockerfile lebih lanjut sesuai persyaratan aplikasi Anda dan menggunakannya untuk membangun image kontainer aplikasi Anda. Image kontainer aplikasi didorong ke Azure Container Registry yang Anda tentukan.
• Menyebarkan ke Azure Kubernetes Service: Alat ini kemudian membuat file YAML definisi sumber daya Kubernetes yang diperlukan untuk menyebarkan aplikasi dalam kontainer ke kluster Azure Kubernetes Service Anda. Anda dapat menyesuaikan file YAML dan menggunakannya untuk menyebarkan aplikasi di AKS.

Catatan

• Azure Migrate: alat Penampungan Aplikasi membantu Anda 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 Azure Migrate: Kemampuan penemuan dan penilaian. Pelajari lebih lanjut
• Alat Kontainerisasi Aplikasi melewati penemuan beberapa aplikasi web Tomcat default, seperti "docs", "examples", "host-manager", "manager" dan "ROOT".

Meskipun semua aplikasi tidak akan mendapat manfaat dari perpindahan langsung ke kontainer tanpa perancangan ulang yang signifikan, beberapa manfaat memindahkan aplikasi yang ada ke kontainer tanpa menulis ulang meliputi:

• Pemanfaatan infrastruktur yang ditingkatkan: Dengan kontainer, beberapa aplikasi dapat berbagi sumber daya dan dihost di infrastruktur yang sama. Hal ini dapat membantu Anda mengonsolidasikan infrastruktur dan meningkatkan pemanfaatan.
• Manajemen yang disederhanakan: Dengan menghosting aplikasi Anda di platform terkelola modern seperti AKS dan App Service, praktik manajemen Anda dapat disederhanakan. Anda dapat mencapainya dengan menghentikan atau mengurangi proses pemeliharaan dan manajemen infrastruktur yang biasanya Anda lakukan dengan infrastruktur yang dimiliki.
• Portabilitas aplikasi: Dengan peningkatan adopsi dan standardisasi format dan platform spesifikasi kontainer, portabilitas aplikasi tidak lagi menjadi perhatian.
• Mengadopsi manajemen modern dengan DevOps: Membantu Anda mengadopsi dan menstandarkan praktik modern untuk manajemen dan keamanan serta transisi ke DevOps.

Dalam tutorial ini, Anda akan mempelajari cara:

• Menyiapkan akun Azure.
• Menginstal Azure Migrate: alat Penampungan Aplikasi.
• Temukan aplikasi web Java Anda.
• Build image kontainer.
• Menyebarkan aplikasi yang ditampung di AKS.

Catatan

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

Prasyarat

Sebelum memulai tutorial ini, Anda harus:

Persyaratan	Rincian
Mengidentifikasi komputer untuk menginstal alat	Anda membutuhkan komputer Windows untuk menginstal dan menjalankan Azure Migrate: Alat Kontainerisasi Aplikasi. Komputer Windows dapat berupa server dengan sistem operasi (Windows Server 2016 atau yang lebih baru) atau klien (Windows 10), yang berarti bahwa alat tersebut dapat berjalan di desktop atau laptop Anda juga. Komputer Windows yang menjalankan alat tersebut harus memiliki konektivitas jaringan ke server/komputer virtual yang menghosting aplikasi web Java untuk dikontainerisasi. Pastikan terdapat ruang 6 GB yang tersedia di komputer Windows untuk menjalankan Azure Migrate: Alat Kontainerisasi Aplikasi untuk menyimpan artefak aplikasi. Mesin Windows harus memiliki akses internet, langsung atau melalui proxy.
Server aplikasi	- Aktifkan koneksi Secure Shell (SSH) pada port 22 di server yang menjalankan aplikasi Java untuk dikontainerisasi.
Aplikasi web Java	Alat ini saat ini mendukung - Aplikasi yang berjalan di Tomcat 8 atau Tomcat 9. - Server aplikasi di Linux Ubuntu 16.04/18.04/20.04, Debian 7/8, CentOS 6/7, Red Hat Enterprise Linux 5/6/7. - Aplikasi yang menggunakan Java 7 atau Java 8. Jika Anda memiliki versi di luar ini, temukan gambar yang mendukung versi yang diperlukan dan ubah dockerfile untuk mengganti gambar Alat ini saat ini tidak mendukung - Server aplikasi yang menjalankan beberapa instans Tomcat

Menyiapkan akun pengguna Azure

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

Setelah langganan 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", dan di bagian Layanan, pilih Langganan.

   

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

3. Pilih Kontrol akses (IAM).

4. Pilih Tambahkan>Tambahkan penetapan peran untuk membuka halaman Tambahkan penetapan peran.

5. Tetapkan peran berikut. Untuk langkah-langkah mendetail, lihat Menetapkan peran Azure menggunakan portal Azure.

   Pengaturan	Nilai
   Peran	Pemilik
   Tetapkan akses ke	Pengguna
   Anggota	azmigrateuser (dalam contoh ini)

   

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

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

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

   

9. Jika pengaturan 'Pendaftaran aplikasi' ditetapkan ke 'Tidak', minta admin penyewa/global untuk menetapkan izin yang diperlukan. Secara bergantian, admin penyewa/global dapat menetapkan peran Pengembang Aplikasi ke akun untuk memungkinkan pendaftaran Aplikasi Microsoft Entra. Pelajari selengkapnya.

Mengunduh dan menginstal Azure Migrate: alat Penampungan Aplikasi

1. Unduh Azure Migrate: Alat penginstal Kontainerisasi Aplikasi di komputer Windows.

2. Jalankan PowerShell dalam mode administrator dan ubah direktori PowerShell ke folder yang berisi alat penginstal.

3. Menjalankan skrip penginstalan menggunakan perintah

   .\AppContainerizationInstaller.ps1
   

Catatan

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

Menjalankan alat Kontainerisasi Aplikasi

1. Buka browser di komputer apa pun yang dapat terhubung ke komputer Windows yang menjalankan alat Pemantauan Aplikasi, lalu buka URL alat https://nama komputer atau alamat IP: 44369.

   Sebagai alternatif, Anda dapat membuka aplikasi dari desktop dengan memilih pintasan aplikasi.

2. Jika Anda melihat peringatan yang menyatakan bahwa koneksi Anda tidak privat, klik Tingkat Lanjut dan pilih untuk melanjutkan ke situs web. Peringatan ini muncul saat antarmuka web menggunakan sertifikat TLS/SSL yang ditandatangani sendiri.

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

4. Pilih aplikasi web Java di Tomcat sebagai jenis aplikasi yang ingin Anda kontainerisasi.

5. Untuk menentukan target layanan Azure, pilih Kontainer pada AKS.

Prasyarat alat lengkap

1. Terima persyaratan lisensi, dan baca informasi pihak ketiga.
2. Di aplikasi >web alat Siapkan prasyarat, lakukan langkah-langkah berikut:
   • Konektivitas: Alat ini memeriksa apakah komputer Windows memiliki akses internet. Jika komputer menggunakan proksi:
     • Klik Siapkan proksi untuk menentukan alamat proksi (dalam alamat IP formulir atau FQDN) dan port mendengarkan.
     • Tentukan kredensial jika proksi memerlukan autentikasi.
     • Hanya proksi HTTP yang didukung.
     • Jika Anda telah menambahkan detail proksi atau menonaktifkan proksi dan/atau autentikasi, klik Simpan untuk memicu pemeriksaan konektivitas lagi.
   • Instal pembaruan: Alat ini akan secara otomatis memeriksa pembaruan terbaru dan menginstalnya. Anda juga dapat menginstal alat versi terbaru secara manual dari sini.
   • Aktifkan Secure Shell (SSH): Alat ini akan memberi tahu Anda untuk memastikan bahwa Secure Shell (SSH) diaktifkan pada server aplikasi yang menjalankan aplikasi web Java untuk dikontainerisasi.

Masuk ke Azure

Klik Masuk untuk masuk ke akun Azure Anda.

1. Anda memerlukan kode perangkat untuk mengautentikasi dengan Azure. Mengeklik masuk akan membuka modal dengan kode perangkat.

2. Klik Salin kode & masuk untuk menyalin kode perangkat dan membuka perintah masuk Azure di tab browser baru. Jika tidak muncul, pastikan Anda telah menonaktifkan pemblokir pop-up di browser.

   

3. Pada {i>tabbrowserweb

4. Pilih penyewa Azure yang ingin Anda gunakan.

5. Tentukan langganan Azure yang ingin Anda gunakan.

Menemukan aplikasi web Java

Alat pembantu Kontainerisasi Aplikasi terhubung dari jarak jauh ke server aplikasi menggunakan kredensial yang disediakan dan berupaya untuk menemukan aplikasi web Java (berjalan di Apache Tomcat) yang dihosting di server aplikasi.

1. Tentukan alamat IP/FQDN dan kredensial server yang menjalankan aplikasi web Java yang harus digunakan untuk menghubungkan ke server dari jarak jauh untuk penemuan aplikasi.

   • Kredensial yang diberikan harus untuk akun root (Linux) di server aplikasi.
   • Untuk akun domain (pengguna harus menjadi administrator di server aplikasi), awali nama pengguna dengan nama domain dalam format <domain\nama> pengguna.
   • Anda dapat menjalankan penemuan aplikasi hingga lima server sekaligus.

2. Klik Validasi untuk memverifikasi bahwa server aplikasi dapat dijangkau dari komputer yang menjalankan alat dan kredensialnya valid. Setelah validasi berhasil, kolom status akan menampilkan status sebagai Dipetakan.

   

3. Klik Lanjutkan untuk memulai penemuan aplikasi di server aplikasi yang dipilih.

4. Setelah berhasil menyelesaikan penemuan aplikasi, Anda dapat memilih daftar aplikasi yang akan ditampung.

   

5. Gunakan kotak centang untuk memilih aplikasi yang akan ditampung.

6. Menentukan nama kontainer: Tentukan nama untuk kontainer target di setiap aplikasi yang dipilih. Nama kontainer harus ditetapkan sebagai <name:tag> tempat tag digunakan untuk gambar kontainer. Misalnya, Anda dapat menentukan nama kontainer target sebagai appname:v1.

Membuat parameter konfigurasi aplikasi

Membuat parameter konfigurasi membuatnya tersedia sebagai parameter waktu penyebaran. Hal ini memungkinkan Anda mengonfigurasi pengaturan ini saat menyebarkan aplikasi, bukan membuatnya dikodekan secara permanen ke nilai tertentu dalam image kontainer. Misalnya, opsi ini berguna untuk parameter seperti string koneksi database.

1. Klik konfigurasi aplikasi untuk meninjau konfigurasi yang terdeteksi.

2. Pilih kotak centang untuk membuat parameter konfigurasi aplikasi yang terdeteksi.

3. Klik Terapkan setelah memilih konfigurasi yang akan dibuat parameternya.

   

Eksternalisasi dependensi sistem file

Anda dapat menambahkan folder lain yang digunakan aplikasi Anda. Tentukan apakah folder tersebut harus menjadi bagian dari image kontainer atau akan dieksternalisasi melalui volume tetap di berbagi file Azure. Menggunakan volume tetap sangat bagus untuk aplikasi stateful yang menyimpan status di luar kontainer atau memiliki konten statis lainnya yang disimpan di sistem file. Pelajari lebih lanjut

1. Klik Edit di bagian Folder Aplikasi untuk meninjau folder aplikasi yang terdeteksi. Folder aplikasi yang terdeteksi telah diidentifikasi sebagai artefak wajib yang diperlukan oleh aplikasi dan akan disalin ke dalam image kontainer.

2. Klik Tambahkan folder dan tentukan jalur folder yang akan ditambahkan.

3. Untuk menambahkan beberapa folder ke volume yang sama, berikan nilai yang dipisahkan koma (,).

4. Pilih Volume Tetap sebagai opsi penyimpanan jika Anda ingin folder disimpan di luar kontainer di Volume Tetap.

5. Klik Simpan setelah meninjau folder aplikasi.

6. Klik Lanjutkan untuk melanjutkan ke fase build image kontainer.

Menyusun gambar kontainer

1. Memilih Azure Container Registry: Gunakan menu drop-down untuk memilih Azure Container Registry yang akan digunakan untuk membuat dan menyimpan image kontainer untuk aplikasi. Anda dapat menggunakan Azure Container Registry yang ada atau memilih untuk membuat yang baru menggunakan opsi Buat registri baru.

   

2. Meninjau Dockerfile: Dockerfile diperlukan guna membuat image kontainer untuk setiap aplikasi yang dipilih dibuat di awal langkah build. Klik Tinjau untuk meninjau Dockerfile. Anda juga dapat menambahkan penyesuaian yang diperlukan di Dockerfile di langkah peninjauan dan menyimpan perubahan sebelum memulai proses build.

3. Mengonfigurasi Application Insights: Anda dapat mengaktifkan pemantauan untuk aplikasi Java yang berjalan di App Service tanpa melengkapi kode Anda. Alat ini akan memasang agen mandiri Java sebagai bagian dari gambar kontainer. Setelah dikonfigurasi selama penyebaran, agen Java akan secara otomatis mengumpulkan banyak permintaan, dependensi, log, dan metrik untuk aplikasi Anda yang dapat digunakan untuk pemantauan dengan Application Insights. Opsi ini diaktifkan secara default untuk semua aplikasi Java.

4. Memicu proses build: Pilih aplikasi untuk membuat image dan klik Build. Mengeklik build akan memulai build image kontainer untuk setiap aplikasi. Alat ini terus memantau status build secara terus-menerus dan akan mengizinkan Anda melanjutkan ke langkah berikutnya setelah berhasil menyelesaikan build.

5. Melacak status build: Anda juga dapat memantau kemajuan langkah build dengan mengeklik tautan Build Sedang Dikerjakan di bagian kolom status. Tautan ini membutuhkan waktu beberapa menit untuk aktif setelah Anda memicu proses build.

6. Setelah build selesai, klik Lanjutkan untuk menentukan pengaturan penyebaran.

   

Menyebarkan aplikasi yang ditampung di AKS

Setelah gambar kontainer dibuat, langkah selanjutnya adalah menyebarkan aplikasi sebagai kontainer di Azure Kubernetes Service (AKS).

1. Memilih Kluster Azure Kubernetes Service: Tentukan kluster AKS tempat aplikasi tersebut disebarkan.

   • Kluster AKS yang dipilih harus memiliki kumpulan node Linux.
   • Kluster harus dikonfigurasi untuk memungkinkan pengambilan gambar dari Azure Container Registry yang dipilih untuk menyimpan gambar.
     • Jalankan perintah berikut di Azure CLI untuk melampirkan kluster AKS ke ACR.

       az aks update -n <cluster-name> -g <cluster-resource-group> --attach-acr <acr-name>
       

   • Jika Anda tidak memiliki kluster AKS atau ingin membuat kluster AKS baru untuk menyebarkan aplikasi, Anda dapat memilih untuk membuat dari alat dengan mengklik Buat kluster AKS baru.
     • Kluster AKS yang dibuat menggunakan alat ini akan dibuat dengan kumpulan node Linux. Kluster akan dikonfigurasi agar dapat menarik gambar dari Azure Container Registry yang dibuat sebelumnya (jika opsi registri baru dipilih).
   • Klik Lanjutkan setelah memilih kluster AKS.

2. Tentukan penyimpanan rahasia dan ruang kerja pemantauan: Jika Anda telah memilih untuk membuat parameter konfigurasi aplikasi, tentukan penyimpanan rahasia yang akan digunakan untuk aplikasi tersebut. Anda dapat memilih Azure Key Vault atau Kube Secrets untuk mengelola rahasia aplikasi.

   • Jika Anda telah memilih Kube secrets untuk mengelola rahasia, maka klik Lanjutkan.
   • Jika ingin menggunakan Azure Key Vault untuk mengelola rahasia aplikasi Anda, tentukan Azure Key Vault yang ingin digunakan.
     • Jika Anda tidak memiliki Azure Key Vault atau ingin membuat Key Vault baru, Anda dapat membuatnya dari alat dengan mengklik Buat Azure Key Vault baru.
     • Alat ini akan otomatis menetapkan izin yang diperlukan untuk mengelola rahasia melalui Azure Key Vault.
   • Ruang kerja pemantauan: Jika Anda memilih untuk mengaktifkan pemantauan dengan Application Insights, maka tentukan sumber daya Application Insights yang ingin Anda gunakan. Opsi ini tidak akan terlihat jika Anda telah menonaktifkan integrasi pemantauan.
     • Jika tidak memiliki Application Insights atau ingin membuat sumber daya baru, Anda dapat memilih untuk membuatnya dari alat dengan mengeklik Buat baru.

3. Menentukan berbagi file Azure: Jika Anda telah menambahkan lebih banyak folder dan memilih opsi Volume Tetap, tentukan berbagi file Azure yang harus digunakan oleh Azure Migrate: alat Penampungan Aplikasi selama proses penyebaran. Alat akan membuat direktori baru di berbagi file Azure ini untuk menyalin folder aplikasi yang dikonfigurasi untuk penyimpanan Volume Tetap. Setelah penyebaran aplikasi selesai, alat ini akan membersihkan berbagi file Azure dengan menghapus direktori yang telah dibuatnya.

   • Jika Anda tidak memiliki berbagi file Azure atau ingin membuat berbagi file Azure baru, Anda dapat memilih untuk membuat dari alat dengan mengeklik Buat Akun Penyimpanan dan berbagi file baru.

4. Konfigurasi penyebaran aplikasi: Setelah menyelesaikan langkah-langkah di atas, Anda harus menentukan konfigurasi penyebaran untuk aplikasi. Klik Konfigurasikan untuk menyesuaikan penyebaran aplikasi. Dalam langkah konfigurasi Anda dapat menyediakan penyesuaian berikut:

   • Untai awalan: Tentukan untai awalan untuk digunakan dalam nama untuk semua sumber daya yang dibuat untuk aplikasi yang dikontainerisasi di kluster AKS.
   • Set replika: Tentukan jumlah instans aplikasi (pod) yang harus berjalan di dalam kontainer.
   • Jenis penyeimbang muatan: Pilih Eksternal jika aplikasi yang ditampung harus dapat dijangkau dari jaringan publik.
   • Konfigurasi Aplikasi: Untuk konfigurasi aplikasi apa pun yang dibuat parameternya, berikan nilai yang digunakan untuk penyebaran saat ini.
   • Penyimpanan: Untuk folder aplikasi apa pun yang dikonfigurasi untuk penyimpanan Volume Tetap, tentukan apakah volume harus dibagikan di seluruh instans aplikasi atau harus dimulai satu per satu dengan setiap instans dalam kontainer. Secara default, semua folder aplikasi di Volume Tetap dikonfigurasi sebagai dibagikan.
   • Klik Terapkan untuk menyimpan konfigurasi penyebaran.
   • Klik Lanjutkan untuk menyebarkan aplikasi.

   

5. Menyebarkan aplikasi: Setelah konfigurasi penyebaran untuk aplikasi disimpan, alat akan menghasilkan YAML penyebaran Kube untuk aplikasi.

   • Klik Tinjau untuk meninjau dan menyesuaikan YAML penyebaran Kube untuk aplikasi.

   • Pilih aplikasi yang akan disebarkan.

   • Klik Sebarkan untuk memulai penyebaran aplikasi yang dipilih

     

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

Mengunduh artefak yang dihasilkan

Semua artefak yang digunakan untuk membuat dan menyebarkan aplikasi ke dalam AKS, termasuk file spesifikasi YAML Dockerfile dan Kubernetes, disimpan di komputer yang menjalankan alat. Artefak terletak di C:\ProgramData\Microsoft Azure Migrate App Containerization.

Satu folder dibuat untuk setiap server aplikasi. Anda dapat melihat dan mengunduh semua artefak menengah yang digunakan dalam proses penampungan dengan menavigasi ke folder ini. Folder, yang sesuai dengan server aplikasi, akan dibersihkan di awal setiap menjalankan alat untuk server tertentu.

Pemecahan masalah

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

Langkah berikutnya

• Menampung aplikasi web Java di Apache Tomcat (di server Linux) dan menyebarkannya di kontainer Linux pada App Service. Pelajari lebih lanjut
• Menampung aplikasi web ASP.NET dan menyebarkannya di kontainer Windows pada AKS. Pelajari lebih lanjut
• Menampung aplikasi web ASP.NET dan menyebarkannya di kontainer Windows pada Azure App Service. Pelajari lebih lanjut
• Apa saja solusi untuk menjalankan Oracle WebLogic Server di Azure Kubernetes Service? Pelajari lebih lanjut
• Buka Liberty dan WebSphere Liberty di AKS. Pelajari lebih lanjut