Melakukan replatforming aplikasi Linux ke penampung

Integrasi Migrate to Containers dengan Cloud Code memberi Anda kemampuan untuk memodernisasi komponen aplikasi Linux yang berjalan di virtual machine (VM), dan menghasilkan artefak yang dapat di-deploy ke Google Kubernetes Engine dan Cloud Run, langsung di IDE Anda, menggunakan mesin Linux.

Dalam panduan ini, Anda akan mempelajari cara memindahkan platform aplikasi yang ada ke penampung GKE menggunakan ekstensi Cloud Code di IDE pada komputer Linux.

Panduan ini ditujukan untuk developer di komputer Linux yang memiliki pengetahuan tentang VS Code, memahami Google Cloud, dan memiliki VM yang menjalankan komponen aplikasi mereka.

Catatan: Untuk melakukan langkah-langkah dalam panduan ini, Anda harus menggunakan mesin Linux. Cloud Code tidak mendukung replatforming aplikasi ke penampung menggunakan Windows atau macOS.

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Google Kubernetes Engine API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Google Kubernetes Engine API.

   Enable the API

8. Instal ekstensi Cloud Code jika Anda belum melakukannya.
9. Buat dan konfigurasikan cluster GKE.
10. Pastikan Anda mengetahui jenis migrasi yang ingin dilakukan. Untuk mengetahui informasi selengkapnya tentang workload yang didukung, lihat Meninjau OS, workload, dan versi Kubernetes yang kompatibel.
11. Siapkan mesin sumber dan lokal untuk modernisasi. Cloud Code hanya mendukung Linux untuk modernisasi.

Menambahkan sumber replatform

Di bagian ini, Anda akan menginstal CLI klien penemuan Migration Center (mcdc) dan alat Migrate to Containers lainnya di komputer lokal, jika belum melakukannya, dan menambahkan sumber replatform dengan mengikuti langkah-langkah berikut:

1. Di panel aktivitas IDE, klik Cloud Code, lalu luaskan explorer Replatform Apps.

2. Jika ini pertama kalinya Anda menggunakan Migrate to Containers di Cloud Code, Anda harus menginstal mcdc CLI dan alat Migrate to Containers lainnya di komputer lokal dengan mengklik Instal alat. Jika tidak, lanjutkan ke langkah berikutnya.

3. Klik Edit Sumber. Tindakan ini akan membuka file mcdc-sources.json kosong. Tambahkan sumber Anda dalam format berikut:

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

   Catatan: Anda dapat menggunakan variabel host, user, dan identityFile yang sama dalam perintah SSH.

4. Untuk melihat sumber yang muncul di penjelajah Replatform Apps, arahkan kursor ke penjelajah Replatform Apps, lalu klik tombol Reload sources cached yang muncul.

Opsional: Membuat Penilaian Kesesuaian

Sebelum mencoba mem-replatform aplikasi ke penampung, sebaiknya buat Penilaian Kesesuaian sumber, yang akan memberi tahu Anda jika sumber Anda dapat mem-replatform penampung.

Untuk membuat Penilaian Kesesuaian sumber, klik kanan sumber, lalu pilih Assess source. Tindakan ini akan membuka terminal di IDE dan menampilkan log penilaian sumber Anda.

Setelah penilaian selesai, mcdc akan membuat Laporan Penilaian Kesesuaian di IDE Anda.

Jika sumber Anda dilaporkan sebagai Cocok, berarti Anda siap untuk melakukan replatforming aplikasi.

Melakukan replatforming aplikasi

Cloud Code membuat ruang kerja khusus untuk setiap replatform dan memungkinkan Anda menjalankan tugas Salin, Analisis, dan Buat di ruang kerja untuk mengotomatiskan langkah-langkah replatform. Jika Anda menjalankan tugas Generate tanpa menjalankan tugas Copy dan Analyze terlebih dahulu, tugas tersebut akan otomatis dijalankan sebelum membuat artefak.

Bagian berikut akan memandu Anda melakukan setiap tugas ini dan memindahkan platform aplikasi ke penampung menggunakan Cloud Code.

Untuk mempelajari siklus proses migrasi lebih lanjut, lihat Arsitektur Migrate to Containers CLI.

Membuat ruang kerja replatform baru

Sebelum membuat ruang kerja replatform baru, Anda harus mengetahui parameter migrasi mana yang akan dipilih untuk jenis migrasi Anda. Untuk informasi selengkapnya tentang parameter untuk setiap jenis migrasi, lihat Membuat rencana migrasi.

Untuk membuat ruang kerja replatform baru dengan artefak di IDE, ikuti langkah-langkah berikut:

1. Di penjelajah Replatform Apps, klik kanan sumber yang ingin Anda replatform, lalu klik Replatform.

2. Dari daftar opsi yang muncul di menu, pilih perjalanan replatforming.

3. Pilih direktori ruang kerja baru untuk melakukan replatforming aplikasi Anda, klik OK, lalu klik Create replatform workspace.

4. Pilih parameter migrasi untuk jenis migrasi Anda.

5. Opsional: Jika Anda memilih jenis migrasi WebSphere dan ingin menggunakan pemindai biner, pilih file binaryAppScanner.jar.

   Pembuatan ruang kerja memerlukan waktu beberapa detik. Tindakan ini akan membuka direktori ruang kerja baru di jendela baru IDE.

Menyalin file dari VM ke ruang kerja

Untuk menyalin file dari VM ke ruang kerja di IDE, lakukan langkah-langkah berikut:

1. Opsional: CLI mcdc menerapkan filter untuk mengurangi ukuran salinan, tetapi Anda dapat mengubah file filters.txt untuk lebih mengurangi ukuran salinan. Untuk mempelajari cara mengurangi ukuran salinan, lihat Mengurangi ukuran sistem file yang disalin.

2. Buka palet perintah dengan menekan Ctrl+Shift+P.

3. Telusuri dan pilih Tasks: Run Task, lalu pilih m2c: Copy. Proses penyalinan file mungkin memerlukan waktu beberapa menit.

Menganalisis sistem file VM dan membuat rencana migrasi

Untuk menganalisis sistem file VM dan membuat rencana migrasi, lakukan langkah-langkah berikut:

1. Buka palet perintah dengan menekan Ctrl+Shift+P.

2. Telusuri dan pilih Tasks: Run Task, lalu pilih m2c: Analyze.

   Jika tugas analisis gagal, Anda perlu mengubah parameter migrasi melalui file analyze-args.ini. File ini memiliki satu baris per parameter dengan dokumentasi yang menyertainya tentang parameter tersebut.

   Jika analisis berhasil, Cloud Code akan membuat direktori bernama migration-plan yang berisi hasil analisis dalam bentuk file config.yaml. Anda dapat mengedit file ini untuk mengubah cara artefak dibuat.

   Struktur file config.yaml berbeda-beda berdasarkan jenis migrasi Anda. Untuk mengetahui informasi selengkapnya tentang jenis migrasi yang didukung, lihat halaman berikut:

   • VM Linux
   • Server Tomcat
   • Workload WebSphere
   • Server JBoss
   • Server Apache
   • Situs WordPress

Buat artefak

Untuk membuat artefak, Anda harus menjalankan tugas Generate di IDE. Jika Anda belum menjalankan tugas Copy dan Analyze di bagian sebelumnya, tugas Generate akan otomatis menjalankan keduanya sebelum membuat artefak.

Untuk membuat artefak, lakukan langkah-langkah berikut:

1. Buka palet perintah dengan menekan Ctrl+Shift+P.

2. Telusuri dan pilih Tasks: Run Task, lalu pilih m2c: Generate. Tindakan ini akan menghasilkan artefak di direktori src, yang berisi file skaffold.yaml yang digunakan untuk mem-build dan men-deploy image container. Setiap jenis migrasi menghasilkan artefak yang berbeda, tetapi semua jenis migrasi biasanya membuat satu atau beberapa file docker dan spesifikasi deployment GKE yang dirujuk skaffold.yaml.

   Setelah pembuatan artefak selesai, Anda telah selesai melakukan replatforming aplikasi.

3. Opsional: Jika Anda ingin mengubah rencana migrasi, edit file config.yaml dan jalankan ulang tugas m2c: Generate.

   Jika tidak, jika Anda puas dengan hasil replatform, Anda dapat melanjutkan untuk menjalankan aplikasi di penampung GKE.

Menjalankan aplikasi di container GKE

Di bagian ini, Anda akan menjalankan aplikasi yang di-replatform di penampung GKE, melihat log aplikasi yang berjalan, dan membersihkan resource.

Jika Anda belum membuat dan mengonfigurasi cluster GKE, ikuti petunjuk di Membuat dan mengonfigurasi cluster GKE di Cloud Code untuk VS Code.

Untuk mempelajari lebih lanjut cara men-debug aplikasi GKE, lihat Men-debug aplikasi Kubernetes dengan Cloud Code untuk VS Code.

Menjalankan dan melihat aplikasi

Setelah semuanya siap, Anda dapat menjalankan aplikasi dan melihatnya secara langsung. Cloud Code memantau sistem file Anda untuk mendeteksi perubahan sehingga Anda dapat mengedit dan menjalankan ulang aplikasi secara real time.

Untuk menjalankan aplikasi, ikuti langkah-langkah berikut:

1. Di status bar Cloud Code, klik nama project yang aktif.

   

2. Di menu Pilih Cepat yang muncul, pilih Jalankan di Kubernetes.

3. Konfirmasi apakah akan menggunakan konteks cluster saat ini atau beralih ke konteks lain.

4. Jika diminta, pilih registry image tempat image akan di-push. Jika Anda membuat registry image baru menggunakan gcr.io/PROJECT_ID, pastikan registry image berada dalam project yang sama dengan cluster Anda.

   Jendela output akan muncul tempat Anda dapat melacak progres aplikasi yang sedang berjalan. Anda juga akan melihat live stream log dari pod yang berjalan di output terminal.

5. Setelah aplikasi Anda berjalan di Kubernetes, jendela output akan menampilkan alamat IP. Untuk menggunakan alamat IP tertaut ini guna mengakses aplikasi, tekan Ctrl dan klik alamat.

Setelah sesi proses debug dimulai, panel Sesi pengembangan akan menampilkan tampilan logging terstruktur. Saat tugas dimulai, tugas akan muncul dengan progress_activity setengah lingkaran berputar.

Jika tugas berhasil, tanda centang check_circle akan muncul di samping langkah.

Untuk melihat detail langkah, klik langkah di panel Sesi pengembangan. Panel Output menampilkan langkah dalam output logging.

Pembersihan

Setelah Anda menghentikan aplikasi, semua resource Kubernetes yang di-deploy selama proses berjalan akan otomatis dihapus.

Agar tidak menimbulkan biaya pada akun Anda untuk resource lain yang digunakan dalam panduan memulai ini, pastikan untuk menghapus project atau menghapus cluster yang Anda buat jika Anda ingin menggunakan kembali project tersebut.

Untuk menghapus cluster:

1. Klik Cloud Code, lalu luaskan explorer Kubernetes.
2. Arahkan kursor ke nama cluster, lalu klik open_in_new Buka di konsol Google Cloud.
3. Klik Delete, lalu klik Delete.

Untuk menghapus project Anda (dan resource terkait, termasuk cluster):

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Untuk menghapus semua file lokal yang dibuat selama proses replatforming:

1. Buka palet perintah (Ctrl+Shift+P).
2. Telusuri dan pilih Tasks: Run Task, lalu pilih m2c: Cleanup.