Halaman ini diterjemahkan oleh Cloud Translation API.

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 membuat 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 container GKE menggunakan ekstensi Cloud Code di IDE Anda di mesin Linux.

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

Sebelum memulai

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.

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

Go to project selector

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

Enable the Google Kubernetes Engine API.

Enable the API

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

Go to project selector

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

Enable the Google Kubernetes Engine API.

Enable the API

Instal ekstensi Cloud Code jika Anda belum melakukannya.
Buat dan konfigurasi cluster GKE.
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.
Siapkan mesin sumber dan lokal untuk modernisasi. Cloud Code hanya mendukung Linux untuk modernisasi.

Menambahkan sumber platform ulang

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 platform ulang dengan mengikuti langkah-langkah berikut:

Di panel aktivitas IDE, klik Cloud Code, lalu luaskan explorer Replatform Apps.
Jika ini pertama kalinya Anda menggunakan Migrate to Containers di Cloud Code, Anda harus menginstal CLI mcdc dan alat Migrate to Containers lainnya di mesin lokal dengan mengklik Install tools. Jika tidak, lanjutkan ke langkah berikutnya.
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.
Untuk melihat sumber muncul di penjelajah Replatform Apps, arahkan kursor ke penjelajah Replatform Apps dan klik tombol Muat ulang sumber yang di-cache yang muncul.

Opsional: Membuat Penilaian Kesesuaian

Sebelum mencoba memindahkan platform aplikasi ke penampung, sebaiknya buat Penilaian Kecocokan sumber Anda, yang akan memberi tahu Anda jika sumber Anda dapat memindahkan platform penampung.

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

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

Jika sumber Anda dilaporkan sebagai Cocok, berarti Anda siap memindahkan platform aplikasi.

Memindahkan platform aplikasi Anda

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 Buat tanpa menjalankan tugas Salin dan Analisis terlebih dahulu, tugas Buat akan otomatis menjalankan tugas Salin dan Analisis sebelum membuat artefak.

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

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

Membuat ruang kerja platform baru

Sebelum membuat ruang kerja platform ulang yang baru, Anda harus mengetahui parameter migrasi yang akan dipilih untuk jenis migrasi Anda. Untuk mengetahui 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:

Di penjelajah Replatform Apps, klik kanan sumber yang ingin Anda replatform, lalu klik Replatform.
Dari daftar opsi yang muncul di menu, pilih perjalanan platform ulang.
Pilih direktori ruang kerja baru untuk memindahkan platform aplikasi Anda, klik OK, lalu klik Buat ruang kerja replatform.
Pilih parameter migrasi untuk jenis migrasi Anda.
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 Anda di jendela baru IDE Anda.

Menyalin file dari VM ke ruang kerja Anda

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

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.
Buka palet perintah dengan menekan Ctrl+Shift+P.
Telusuri dan pilih Tasks: Run Task, lalu pilih m2c: Copy. 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:

Buka palet perintah dengan menekan Ctrl+Shift+P.
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 menyertai parameter.

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 Anda dibuat.

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

Buat artefak

Untuk membuat artefak, Anda perlu menjalankan tugas Generate di IDE. Jika Anda belum menjalankan tugas Salin dan Analisis di bagian sebelumnya, tugas Buat akan otomatis menjalankan keduanya sebelum membuat artefak.

Untuk membuat artefak, lakukan langkah-langkah berikut:

Buka palet perintah dengan menekan Ctrl+Shift+P.
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 yang berbeda, tetapi semua jenis migrasi biasanya membuat satu atau beberapa dockerfile dan spesifikasi deployment GKE yang dirujuk oleh skaffold.yaml.

Setelah pembuatan artefak selesai, Anda telah selesai melakukan replatforming aplikasi.
Opsional: Jika Anda ingin mengubah rencana migrasi, edit file config.yaml Anda dan jalankan ulang tugas m2c: Generate.

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

Menjalankan aplikasi di container GKE

Di bagian ini, Anda akan menjalankan aplikasi yang di-platform ulang di container GKE, melihat log aplikasi yang sedang 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 Anda

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

Untuk menjalankan aplikasi, ikuti langkah-langkah berikut:

Di status bar Cloud Code, klik nama project aktif.
Di menu Pilih Cepat yang muncul, pilih Jalankan di Kubernetes.
Konfirmasi apakah akan menggunakan konteks cluster saat ini atau beralih ke konteks cluster lain.
Jika diminta, pilih registry gambar untuk mengirimkan gambar. 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 memantau progres aplikasi yang sedang berjalan. Anda juga akan melihat livestream log dari pod yang sedang berjalan di output terminal.
Setelah aplikasi Anda berjalan di Kubernetes, jendela output akan menampilkan alamat IP. Untuk menggunakan alamat IP tertaut ini guna mengakses aplikasi Anda, tekan Ctrl dan klik alamat tersebut.

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

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 dihapus secara otomatis.

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

Untuk menghapus cluster:

Klik Cloud Code, lalu luaskan explorer Kubernetes.
Arahkan kursor ke nama cluster Anda, lalu klik open_in_new Open in Google Cloud console.
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 beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
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 replatform:

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