Mengimpor dan mengekspor VM Anda

Fitur impor dan ekspor Migrasi ke Virtual Machine memungkinkan Anda membuat, mengekspor, dan merevisi VM yang dimigrasikan 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 menurut CSV.

Untuk informasi selengkapnya tentang migrasi, lihat dokumentasi Migrasi ke Virtual Machines di:

• Memigrasikan masing-masing VM
• Memigrasikan grup VM

Ringkasan impor dan ekspor

Anda dapat menggunakan fitur ekspor untuk menghasilkan file CSV yang menjelaskan VM sumber atau VM saat ini dan detail targetnya, mengeditnya secara eksternal, lalu mengupload CSV ke Migrasi ke Virtual Machine untuk menentukan migrasi.

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

Untuk menentukan file CSV untuk 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 Migrasi ke Virtual Machine.

Catatan: Anda tidak dapat menghapus grup atau VM yang dimigrasikan 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 dari nama sumber, region sumber, dan nama tampilan VM sumber atau ID VM sumber.
• VM sumber atau migrasi 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 untuknya.
• Fitur migrasi impor dan ekspor memvalidasi kolom detail target berdasarkan jenis dan batasan penamaan resource. Anda harus memvalidasi keberadaan resource secara manual di 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 migrasi masing-masing dan menghapus data dari migrasi tersebut.
• Kolom dapat berisi beberapa nilai per VM (seperti tag atau label jaringan), yang dipisahkan dengan 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 menampilkan error validasi.

Catatan: Peringatan tingkat baris dapat diabaikan sesuai 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 VM migrasi atau sumber. Kolom lainnya bersifat opsional dan hanya akan diperbarui saat diimpor jika ada. Kolom header yang tidak dikenal akan diabaikan.

Kolom wajib untuk file CSV Anda mencakup:

• 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 jeda baris. Proses ekspor dan impor hanya mendukung nilai satu baris 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. File CSV template kosong kecuali untuk baris header yang menjelaskan kolom wajib dan opsional serta baris contoh yang memberikan contoh cara setiap kolom harus diformat. Dalam template, detail target diwakili 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 membuat perubahan pada migrasi atau grup migrasi yang ada, Anda harus mengekspor file CSV terlebih dahulu yang mewakili status migrasi 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 Ekspor 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 Ekspor untuk mendownload file CSV.

Mengimpor file CSV

Saat Anda mengupload file CSV, file tersebut akan divalidasi. Jika beberapa baris dalam file memiliki error, error ini akan ditampilkan dan Anda dapat memilih untuk melewati baris ini dan mengimpor baris lainnya.

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. File harus berupa CSV dan berukuran 100 KB atau kurang.

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

4. Pilih Upload.

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

5. Kemudian, Anda akan melihat rencana impor. Tindakan yang dipanggil dan resource yang direferensikan akan dijelaskan.

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

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

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

   Catatan: Jika terjadi kegagalan, Anda dapat mencoba lagi mengimpor file CSV yang sama. Mengingat sifat proses impor (saat file CSV mewakili status migrasi yang ideal), proses migrasi impor dan ekspor akan melewati tindakan yang sudah selesai dan melanjutkan dari tempat migrasi gagal.

Meninjau rencana impor

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

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

Setelah rencana impor disetujui, status setiap item akan diperbarui seiring progres impor. Dalam laporan, Anda akan dapat melihat status, seperti Tertunda, Berjalan, Selesai, dan Gagal karena status tersebut berkorelasi 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 Ekspor template dan Anda akan diminta untuk mendownload file Template.csv.