Mengimpor dan mengekspor VM Anda

Dengan fitur impor dan ekspor Migrate to Virtual Machines, Anda dapat membuat, mengekspor, dan merevisi migrasi VM menggunakan file CSV.

Prasyarat migrasi

Sebelum menggunakan fitur impor dan ekspor, Anda harus meninjau prasyarat untuk memigrasikan satu VM atau grup VM. Prasyarat yang sama berlaku saat mengelola migrasi dengan CSV.

Untuk mengetahui informasi selengkapnya tentang migrasi, lihat dokumentasi Migrate to Virtual Machines tentang:

• Memigrasikan VM satu per satu
• Memigrasikan grup VM

Ringkasan impor dan ekspor

Anda dapat menggunakan fitur ekspor untuk menghasilkan file CSV yang memerinci VM sumber atau VM Anda saat ini beserta detail targetnya, mengeditnya secara eksternal, lalu mengupload CSV ke Migrate to Virtual Machines untuk menentukan migrasi Anda.

Saat mengedit dan mengimpor file CSV, Anda harus mengingat status akhir migrasi. Dengan kata lain, Anda dapat menentukan setelan dalam file CSV. Proses impor akan membuat migrasi dan grup, mengubah keanggotaan grup, serta memperbarui detail target agar sesuai dengan status file CSV yang diimpor.

Untuk menentukan file CSV proses impor, Anda memiliki beberapa opsi:

• Mengekspor detail migrasi yang ada sebagai file CSV untuk pengeditan massal dan upload grup
• Mengekspor VM sumber dari inventaris sumber sebagai file CSV
• Mendownload dan mengedit file CSV template

Jika file CSV Anda tidak diformat dengan benar atau detail migrasi tertentu tidak valid, Anda akan menerima error saat menguploadnya ke Migrate to Virtual Machines.

Catatan: Anda tidak dapat menghapus grup atau VM yang bermigrasi menggunakan fitur impor dan ekspor.

Format file CSV

Sebelum melakukan tindakan apa pun, file CSV yang diimpor akan diuraikan dan divalidasi berdasarkan kriteria berikut:

• Migrasi dan VM sumber akan diidentifikasi sebagai kombinasi nama sumber, region sumber, dan nama tampilan VM sumber atau ID VM sumber.
• Migrasi atau VM sumber yang sama tidak dapat muncul di lebih dari satu baris.
• Tidak lebih dari 100 migrasi atau VM sumber dapat diproses dalam satu file.
• Jika migrasi tidak ada untuk VM sumber, keberadaan VM sumber akan divalidasi dan migrasi baru akan dibuat untuk VM sumber tersebut.
• Fitur migrasi impor dan ekspor memvalidasi kolom detail target berdasarkan jenis dan batasan penamaan resource. Anda harus memvalidasi keberadaan resource secara manual dalam project target untuk menghindari kegagalan.
• Kolom yang tidak ada dalam file CSV akan diabaikan dan migrasi tidak akan diperbarui di kolom tersebut. Namun, nilai kosong akan memperbarui setiap migrasi dan menghapus data dari migrasi tersebut.
• Kolom dapat berisi beberapa nilai per VM (seperti tag atau label jaringan), yang dipisahkan oleh jeda baris. Lihat Mengekspor file template untuk mengetahui contohnya.

Beberapa error validasi akan memblokir kelanjutan impor. Misalnya, baris header yang tidak valid atau file dengan terlalu banyak baris akan memunculkan error validasi.

Catatan: Peringatan tingkat baris dapat diabaikan sesuai dengan kebijaksanaan Anda. Pilih Lewati error dan lanjutkan di halaman impor untuk melanjutkan.

Kolom file CSV

Baris header diharapkan dan harus berisi kolom berikut yang mengidentifikasi migrasi atau VM sumber. Kolom lain bersifat opsional dan hanya akan diperbarui saat diimpor jika ada. Kolom header yang tidak diketahui akan diabaikan.

Kolom wajib untuk file CSV Anda meliputi:

• Nama sumber
• Region
• Nama Tampilan VM sumber atau ID VM sumber

Untuk informasi selengkapnya tentang kolom opsional, lihat mengonfigurasi target untuk VM yang dimigrasikan.

Catatan: Nilai metadata dapat sangat panjang dan berisi rem baris. Proses ekspor dan impor hanya mendukung nilai satu baris yang sederhana. Jika migrasi Anda berisi nilai metadata yang tidak didukung, file CSV Anda akan disamarkan saat diekspor. Mengimpor ulang file CSV yang sama akan mengabaikan kolom metadata yang disamarkan.

File template

Anda dapat mengekspor file template untuk membantu menentukan file CSV Anda. File CSV template kosong, kecuali untuk baris header yang menjelaskan kolom wajib dan opsional serta baris contoh yang memberikan contoh cara memformat setiap kolom. Dalam template, detail target direpresentasikan oleh kolom file CSV.

Catatan: Baris header seperti yang disediakan oleh template diperlukan agar impor berhasil.

Mengekspor file CSV yang telah diisi sebelumnya

Untuk membuat migrasi berdasarkan VM sumber atau melakukan perubahan pada migrasi atau grup migrasi yang ada, Anda harus terlebih dahulu mengekspor file CSV yang mewakili status migrasi Anda saat ini.

Untuk mengekspor file CSV yang telah diisi sebelumnya, ikuti langkah-langkah berikut:

1. Buka halaman Migrate to Virtual Machines di Konsol Google Cloud.

2. Untuk mengekspor daftar VM sumber:

   1. Pilih tab Sumber.
   2. Pilih VM sumber yang ingin diekspor dari inventaris.
   3. Klik Export untuk mendownload file CSV.

3. Untuk mengekspor grup migrasi yang ada:

   1. Pilih tab Grup.
   2. Pilih grup yang ingin diekspor dari daftar grup.
   3. Klik Export untuk mendownload file CSV.

Impor file CSV Anda

Saat Anda mengupload file CSV, file tersebut akan divalidasi. Jika terdapat error pada beberapa baris dalam file, error tersebut akan muncul dan Anda dapat memilih untuk melewati baris ini dan mengimpor sisanya.

Setelah mengupload file CSV yang divalidasi, rencana impor akan ditampilkan untuk disetujui. File Anda akan diimpor setelah disetujui.

Untuk mengimpor file CSV, ikuti langkah-langkah berikut:

1. Buka halaman Migrate to Virtual Machines di Konsol Google Cloud.
2. Pilih tab Grup, lalu pilih Impor.

3. Cari file impor Anda. Harus berupa file CSV dan berukuran maksimal 100 kB.

   Tips: Anda tidak dapat mengupload file CSV saat impor lainnya sedang berlangsung.

4. Pilih Upload.

   Jika ada error, error tersebut akan ditampilkan kepada Anda pada langkah ini. Anda dapat memilih Lewati error dan lanjutkan.

5. Kemudian, Anda akan melihat paket impor. Ini akan menjelaskan tindakan mana yang dipanggil dan resource mana yang direferensikan.

6. Pilih Mulai impor untuk menyetujui rencana impor dan memulai impor Anda. Rencana impor akan diperbarui dengan progres setiap langkah.

7. Jika impor gagal diselesaikan, tinjau pesan error seperti yang diberikan. Kegagalan salah satu langkah akan menghentikan seluruh urutan.

8. Setelah impor berhasil, pilih Buka grup untuk kembali ke halaman Grup dan meninjau referensi yang diperbarui.

   Catatan: Jika gagal, Anda dapat mencoba mengimpor file CSV yang sama lagi. Mengingat sifat proses impornya (yang mana file CSV mewakili status ideal migrasi Anda), proses migrasi impor dan ekspor akan melewati tindakan yang telah selesai dan berlanjut dari proses yang sebelumnya gagal.

Meninjau rencana impor

Rencana impor adalah daftar tindakan yang dihasilkan sesuai dengan perubahan yang terdeteksi dalam file impor Anda. Jenis pesan berikut mungkin dicantumkan:

• Membuat migrasi.
• Buat grup.
• Menghapus migrasi dari grup.
• Tambahkan migrasi ke grup.
• Perbarui detail target untuk migrasi.

Setelah menyetujui rencana impor, status setiap item akan diperbarui seiring berjalannya impor. Dalam laporan, Anda dapat melihat statusnya, seperti Tertunda, Berjalan, Selesai, dan Gagal karena status tersebut berkaitan dengan setiap item.

Mengekspor file template migrasi

Anda dapat mengekspor file template migrasi untuk mengetahui detail tentang cara memformat file CSV dengan benar.

Untuk mengekspor file template migrasi, ikuti langkah-langkah berikut:

1. Buka halaman Migrate to Virtual Machines di Konsol Google Cloud.
2. Pilih tab Grup.
3. Pilih Impor
4. Pilih Export template dan Anda akan diminta untuk mendownload file Template.csv.