Me-replatform aplikasi Linux ke container

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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 melakukan replatform aplikasi yang sudah ada ke container GKE menggunakan ekstensi Cloud Code di IDE Anda pada mesin Linux.

Panduan ini ditujukan bagi developer yang menggunakan mesin Linux yang memiliki pengetahuan tentang VS Code, memahami Google Cloud, dan memiliki VM yang menjalankan komponen aplikasinya.

Catatan: Untuk melakukan langkah-langkah dalam panduan ini, Anda harus menggunakan komputer Linux. Cloud Code tidak mendukung replatform aplikasi ke container 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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

4. Aktifkan API Google Kubernetes Engine.

   Mengaktifkan API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

7. Aktifkan API Google Kubernetes Engine.

   Mengaktifkan API

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

Menambahkan sumber replatform

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

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

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

3. Klik Edit Sumber. Tindakan ini akan membuka file mcdc-sources.json yang 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 muncul di penjelajah Replatform Apps, tahan pointer di atas penjelajah Replatform Apps, lalu klik tombol cache Reload sources yang muncul.

Opsional: Buat Penilaian Kesesuaian

Sebelum mencoba memindahkan platform aplikasi Anda ke penampung, sebaiknya buat Penilaian Kesesuaian terhadap sumber, yang akan memberi tahu apakah sumber Anda dapat memindahkan platform ke penampung.

Untuk membuat Penilaian Fit bagi sumber Anda, klik kanan sumber, lalu pilih Menilai sumber. Tindakan ini akan membuka terminal di IDE dan menampilkan log penilaian sumber Anda.

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

Jika sumber Anda dilaporkan sebagai Good Fit, berarti Anda siap melakukan replatform aplikasi.

Melakukan replatform aplikasi

Cloud Code membuat ruang kerja khusus untuk setiap replatform dan memungkinkan Anda menjalankan tugas Copy, Analyze, dan Generate 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 melakukan replatform aplikasi ke container menggunakan Cloud Code.

Untuk mempelajari lebih lanjut siklus proses migrasi, lihat Bermigrasi ke arsitektur CLI Container.

Membuat ruang kerja replatform baru

Sebelum membuat ruang kerja replatform baru, Anda perlu mengetahui parameter migrasi mana yang harus 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 Anda, ikuti langkah-langkah berikut:

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

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

3. Pilih direktori ruang kerja baru untuk memindahkan aplikasi Anda ke platform baru, 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 Anda.

Salin file dari VM ke ruang kerja Anda

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

1. Opsional: CLI mcdc menerapkan filter untuk mengurangi ukuran salinan, tetapi Anda dapat mengubah file filters.txt untuk mengurangi ukuran salinan lebih jauh. 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. Menyalin 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 berisi satu baris per parameter beserta dokumentasi yang menyertainya.

   Saat analisis berhasil, Cloud Code 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 berdasarkan jenis migrasi Anda. Untuk 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 perlu menjalankan tugas Generate di IDE Anda. 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 membangun dan men-deploy image container. Setiap jenis migrasi menghasilkan artefak berbeda, tetapi semua jenis migrasi biasanya membuat satu atau beberapa dockerfile dan spesifikasi deployment GKE yang dirujuk skaffold.yaml.

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

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

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

Menjalankan aplikasi Anda di container GKE

Di bagian ini, Anda akan menjalankan aplikasi yang telah di-replatforming dalam container GKE, melihat log aplikasi yang sedang berjalan, dan membersihkan resource.

Jika Anda belum membuat dan mengonfigurasi cluster GKE, ikuti petunjuk dalam artikel 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 Anda

Setelah siap, Anda dapat menjalankan aplikasi dan melihatnya secara langsung. Cloud Code mengawasi sistem file untuk memeriksa perubahan, sehingga Anda dapat mengedit dan menjalankan kembali aplikasi secara real time.

Untuk menjalankan aplikasi Anda, ikuti langkah-langkah berikut:

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

   

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

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

4. Jika diminta, pilih registry image untuk mengirim image. 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 livestream 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 yang ditautkan ini dalam mengakses aplikasi, tekan Ctrl dan klik alamat.

Setelah sesi proses debug Anda dimulai, panel Development session akan menampilkan tampilan logging terstruktur. Saat tugas dimulai, tugas akan muncul dengan progress_activity setengah lingkaran yang berputar.

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

Untuk melihat detail sebuah langkah, klik langkah tersebut di panel Development session. Panel Output menampilkan langkah dalam output logging.

Pembersihan

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

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

Untuk menghapus cluster:

1. Klik Cloud Code, lalu luaskan explorer Kubernetes.
2. Arahkan kursor ke nama cluster Anda, 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 apa pun):

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 berbagai arsitektur, tutorial, atau panduan memulai, menggunakan kembali project dapat membantu agar Anda tidak melampaui batas kuota project.

1. Di konsol Google Cloud, buka halaman Manage resource.

   Buka Manage resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Untuk menghapus semua file lokal yang dibuat selama proses replatform:

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