Memindahkan instance VM antara zona atau region

Dokumen ini menjelaskan cara memindahkan instance mesin virtual (VM) antar-zona atau region.

Sebelum memulai

Persyaratan

Bagian ini mencantumkan persyaratan untuk memindahkan VM antar-zona dan region:

  • Kuota project. Project Anda harus memiliki cukup kuota untuk melakukan hal berikut:

    • Membuat snapshot baru.
    • Mempromosikan alamat IP eksternal sementara.

    • Membuat VM dan disk baru di region tujuan Anda.

      Misalnya, jika Anda memiliki tiga disk yang terpasang pada VM yang ingin dipindahkan, Anda memerlukan kuota yang cukup untuk membuat tiga snapshot persistent disk sementara dan tiga disk baru. Setelah membuat disk baru, Anda dapat menghapus snapshot sementara Anda.

    Periksa halaman Quotas untuk memastikan Anda memiliki kuota yang cukup untuk resource sebelumnya. Untuk informasi selengkapnya, lihat Memahami kuota.

  • Persistent disk. Persistent disk yang dipasang ke VM yang ingin Anda pindahkan tidak dipasang ke VM lain.

  • SSD lokal. SSD lokal dimaksudkan untuk penyimpanan sementara, dan data di SSD lokal tidak disimpan melalui penghentian VM manual. Jika Anda perlu mempertahankan data SSD lokal, buat replikanya dengan menggunakan opsi penyimpanan yang andal seperti persistent disk.

  • GPU. Jika VM Anda menyertakan GPU, pastikan GPU yang ingin Anda gunakan tersedia di zona tujuan VM. Untuk daftar GPU dan zona tempatnya tersedia, lihat GPU di Compute Engine.

  • Subnetwork. Jika Anda ingin memindahkan VM antar-region, seperti antara us-west1-a dan asia-south1-b, dan VM Anda termasuk dalam subnetwork, Anda harus memilih subnetwork baru untuk VM. Untuk mengetahui petunjuk cara membuat subnet, lihat Menambahkan subnet.

Batasan

Jika memindahkan VM ke berbagai region, Anda tidak dapat mempertahankan alamat IP internal atau eksternal sementara VM. Anda harus memilih alamat IP baru saat membuat ulang VM.

Properti resource

Untuk memindahkan VM, Anda harus mematikan VM, memindahkannya ke zona atau region tujuan, lalu memulai ulang VM. Setelah memindahkan VM, perbarui referensi apa pun yang Anda miliki ke resource asli, seperti VM target atau kumpulan target yang mengarah ke VM sebelumnya.

Selama perpindahan, beberapa properti yang dihasilkan server dari VM Anda dan disk berubah.

Properti yang berubah untuk VM

Tabel berikut menjelaskan properti yang berubah untuk VM:

Nama properti Perubahan
Alamat IP internal Alamat IP internal baru biasanya ditetapkan, tetapi VM mungkin menyimpan alamat IP internal aslinya.
Alamat IP eksternal Jika VM berpindah antar-zona di region yang sama, alamat IP eksternal akan tetap sama. Jika tidak, pilih alamat IP eksternal yang berbeda untuk instance VM.
CPU platform Bergantung pada platform CPU yang tersedia di zona tujuan Anda, VM Anda mungkin memiliki platform CPU yang berbeda setelah dipindahkan. Untuk mengetahui daftar lengkap platform CPU di setiap zona, lihat Region dan zona yang tersedia.
Jaringan/subjaringan Jika VM Anda termasuk dalam subnetwork dan Anda memindahkan VM ke berbagai region, Anda harus memilih subnetwork baru untuk VM. VM yang bergerak melintasi zona di region yang sama akan mempertahankan subnetwork yang sama.

Properti yang berubah untuk disk

Tabel berikut menjelaskan properti yang berubah untuk disk:

Nama properti Perubahan
Snapshot sumber Snapshot sumber disk baru ditetapkan ke snapshot sementara yang dibuat selama pemindahan.
ID snapshot sumber ID snapshot sumber ditetapkan ke ID snapshot sementara.
Image sumber Kolom image sumber kosong.
ID image ID image kosong.
Stempel waktu terakhir dilepaskan Stempel waktu terakhir yang dilepas kosong.
Stempel waktu terakhir terlampir Stempel waktu yang terakhir dipasang akan berubah menjadi stempel waktu saat disk baru dipasang ke instance baru.

Perubahan properti untuk VM dan disk

Tabel berikut menjelaskan properti yang berubah untuk VM dan disk:

Nama properti Perubahan
ID ID resource baru akan dibuat.
Stempel waktu pembuatan Stempel waktu pembuatan baru akan dibuat.
URL resource zona Semua URL resource zona berubah untuk mencerminkan zona tujuan. Daftar berikut menunjukkan URL resource yang berubah:
  • URL disk sumber VM
  • URL jenis mesin VM
  • URL link mandiri
  • URL zona
  • URL jenis disk
  • Setiap URL VM yang tercantum dalam daftar users[] disk

Memindahkan VM di seluruh zona atau region

Untuk memindahkan VM di seluruh zona atau region, Anda dapat melakukan hal berikut:

  1. Buat image mesin dari VM sumber Anda.
  2. Buat VM dari image mesin di zona atau region yang berbeda.

Contoh berikut menunjukkan cara memindahkan VM di seluruh zona.

gcloud

Dalam contoh ini, Anda memindahkan VM bernama myinstance yang memiliki dua persistent disk bernama mybootdisk dan mydatadisk, dari europe-west1-c ke us-west1-b.

  1. Identifikasi disk yang terkait dengan VM yang ingin Anda pindahkan:

    gcloud compute instances describe myinstance --format="list(name,status,disks)"

    Dalam contoh ini, Anda menemukan dua disk terkait berikut untuk VM myinstance:

    • Boot disk bernama mybootdisk
    • Disk data bernama mydatadisk

  2. Setel status hapus otomatis mybootdisk dan mydatadisk ke false untuk memastikan bahwa disk tidak otomatis dihapus saat VM dihapus.

    gcloud compute instances set-disk-auto-delete myinstance --zone europe-west1-c \
    --disk mybootdisk --no-auto-delete

    Jika status diupdate, gcloud compute akan menampilkan respons Updated [...]. Jika status hapus otomatis sudah ditetapkan ke salah (false), gcloud compute akan menampilkan:

    No change requested; skipping update for [myinstance].

  3. (Opsional) Simpan metadata VM Anda.

    Saat Anda menghapus VM, metadata VM juga akan dihapus. Anda dapat menyimpan informasi tersebut di file terpisah, lalu menerapkan kembali metadata VM ke VM baru.

    Jelaskan metadata VM Anda seperti berikut:

    gcloud compute instances describe myinstance --zone europe-west1-c

    Simpan konten ke file terpisah.

  4. Buat cadangan data Anda menggunakan snapshot persistent disk.

    Sebagai tindakan pencegahan, buat cadangan data Anda saat persistent disk masih terpasang ke VM menggunakan snapshot persistent disk. Sebelum mengambil snapshot, pastikan snapshot tersebut konsisten dengan status persistent disk dengan mematuhi praktik terbaik snapshot.

    Setelah Anda menghapus buffering disk, buat snapshot:

    gcloud compute disks snapshot mybootdisk mydatadisk \
    --snapshot-names backup-mybootsnapshot,backup-mydatasnapshot \
    --zone europe-west1-c

    Untuk memverifikasi bahwa snapshot sudah dibuat, jalankan gcloud compute snapshots list.

  5. (Opsional) Jika Anda memindahkan VM lintas zona dalam region yang sama, dan ingin mempertahankan alamat IP internal atau eksternal sementaranya, promosikan internal atau alamat IP eksternal ke alamat IP statis, yang dapat Anda gunakan kembali nanti.

  6. Hapus VM Anda

    Jika VM dihapus, VM akan mati dan semua persistent disk akan dilepas.

    gcloud compute instances delete myinstance --zone europe-west1-c

    gcloud akan meminta Anda untuk mengonfirmasi penghapusan:

    
The following VMs are deleted. Any attached disks configured to
be auto-deleted are deleted unless they are attached to any other
VMs or the `--keep-disks` flag is given and specifies them for keeping.
Deleting a disk is irreversible and any data on the disk is lost.
— [myinstance] in [europe-west1-c]

    Do you want to continue (Y/n)?

    Karena Anda menonaktifkan status hapus otomatis untuk disk di awal proses ini, masukkan Y untuk melanjutkan dan mengabaikan peringatan.

  7. Selanjutnya, buat snapshot lain dari boot disk dan disk data.

    gcloud compute disks snapshot mybootdisk mydatadisk \
    --snapshot-names mybootsnapshot,mydatasnapshot \
    --zone europe-west1-c 
    Created [.../mydatasnapshot].
Created [.../mybootsnapshot].

  8. (Opsional) Hapus persistent disk.

    Jika Anda berencana menggunakan kembali nama persistent disk untuk disk baru, Anda harus menghapus disk yang ada untuk merilis namanya. Menghapus disk Anda juga menghemat biaya penyimpanan persistent disk.

    Jika tidak berencana untuk menggunakan kembali nama disk yang sama, Anda tidak perlu menghapusnya.

    gcloud compute disks delete mybootdisk mydatadisk --zone europe-west1-c

  9. Buat persistent disk baru di us-west1-b dari snapshot yang Anda buat. Pertama-tama, buat boot disk.

    gcloud compute disks create mybootdiskb --source-snapshot mybootsnapshot \
    --zone us-west1-b
    Created [.../mybootdiskb].
NAME        ZONE           SIZE_GB TYPE        STATUS
mybootdiskb us-west1-b     100     pd-standard READY

    Kemudian buat disk data.

    gcloud compute disks create mydatadiskb --source-snapshot mydatasnapshot \
    --zone us-west1-b
    Created [.../mydatadiskb].
NAME        ZONE           SIZE_GB TYPE        STATUS
mydatadiskb us-west1-b 4000    pd-standard READY

  10. Buat ulang VM di us-west1-b.

    • Jika Anda memilih untuk menyimpan metadata VM dalam file, misalnya myinstance.describe, Anda dapat menggunakannya untuk menetapkan metadata yang sama pada VM.

    • Jika VM Anda memiliki alamat IP eksternal statis, Anda dapat menetapkan ulang alamat tersebut ke VM baru dengan menentukan opsi --address [ADDRESS]. Jika Anda memindahkan VM ke berbagai region, Anda harus memilih alamat IP eksternal yang berbeda untuk instance VM baru tersebut.

    • Jika VM Anda memiliki alamat IP internal statis, Anda dapat menetapkan ulang alamat tersebut ke VM baru dengan menentukan opsi --private-network-ip ADDRESS. Jika Anda memindahkan VM ke berbagai region, Anda harus memilih alamat IP internal yang berbeda untuk instance VM baru.

    • Jika VM Anda menyertakan GPU, tambahkan GPU ke VM menggunakan opsi --accelerator.

    • Jika VM menggunakan subnet tertentu, tambahkan flag --subnet [SUBNET_NAME].

    Untuk mengetahui daftar lengkap flag tambahan, lihat gcloud compute instances create.

    gcloud compute instances create myinstanceb --machine-type n1-standard-4 \
    --zone us-west1-b \
    --disk name=mybootdiskb,boot=yes,mode=rw \
    --disk name=mydatadiskb,mode=rw 
    Created [.../myinstanceb].
NAME        ZONE           MACHINE_TYPE  INTERNAL_IP    EXTERNAL_IP     STATUS
myinstanceb us-west1-b     n1-standard-4 10.240.173.229 146.148.112.106 RUNNING

  11. (Opsional) Hapus snapshot persistent disk.

    Setelah memastikan bahwa mesin virtual Anda sudah dipindahkan, hemat biaya penyimpanan dengan menghapus snapshot sementara yang Anda buat.

    gcloud compute snapshots delete mybootsnapshot mydatasnapshot

    Jika Anda tidak lagi memerlukan snapshot cadangan, hapus juga snapshot tersebut:

    gcloud compute snapshots delete backup-mybootsnapshot backup-mydatasnapshot

Go

  1. Dapatkan detail VM dan identifikasi disk yang terpasang ke VM.

    compute/get_instance.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// getInstance prints a name of a VM instance in the given zone in the specified project.
func getInstance(w io.Writer, projectID, zone, instanceName string) error {
	// projectID := "your_project_id"
	// zone := "europe-central2-b"
	// instanceName := "your_instance_name"

	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	reqInstance := &computepb.GetInstanceRequest{
		Project:  projectID,
		Zone:     zone,
		Instance: instanceName,
	}

	instance, err := instancesClient.Get(ctx, reqInstance)
	if err != nil {
		return fmt.Errorf("unable to get instance: %w", err)
	}

	fmt.Fprintf(w, "Instance: %s\n", instance.GetName())

	return nil
}

  2. Setel status hapus otomatis boot disk dan disk data ke false untuk memastikan bahwa disk tidak otomatis dihapus saat VM dihapus.

    compute/disks/set_disk_autodelete.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// setDiskAutodelete sets the autodelete flag of a disk to given value.
func setDiskAutoDelete(
	w io.Writer,
	projectID, zone, instanceName, diskName string, autoDelete bool,
) error {
	// projectID := "your_project_id"
	// zone := "us-west3-b"
	// instanceName := "your_instance_name"
	// diskName := "your_disk_name"
	// autoDelete := true

	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	getInstanceReq := &computepb.GetInstanceRequest{
		Project:  projectID,
		Zone:     zone,
		Instance: instanceName,
	}

	instance, err := instancesClient.Get(ctx, getInstanceReq)
	if err != nil {
		return fmt.Errorf("unable to get instance: %w", err)
	}

	diskExists := false

	for _, disk := range instance.GetDisks() {
		if disk.GetDeviceName() == diskName {
			diskExists = true
			break
		}
	}

	if !diskExists {
		return fmt.Errorf(
			"instance %s doesn't have a disk named %s attached",
			instanceName,
			diskName,
		)
	}

	req := &computepb.SetDiskAutoDeleteInstanceRequest{
		Project:    projectID,
		Zone:       zone,
		Instance:   instanceName,
		DeviceName: diskName,
		AutoDelete: autoDelete,
	}

	op, err := instancesClient.SetDiskAutoDelete(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to set disk autodelete field: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "disk autoDelete field updated.\n")

	return nil
}

  3. Buat cadangan data Anda menggunakan snapshot persistent disk.

    Sebagai tindakan pencegahan, buat cadangan data Anda saat persistent disk masih terpasang ke VM menggunakan snapshot persistent disk. Sebelum mengambil snapshot, pastikan snapshot tersebut konsisten dengan status persistent disk dengan mematuhi praktik terbaik snapshot.

    Setelah Anda menghapus buffering disk, buat snapshot:

    compute/snapshots/create_snapshot.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
	"google.golang.org/protobuf/proto"
)

// createSnapshot creates a snapshot of a disk.
func createSnapshot(
	w io.Writer,
	projectID, diskName, snapshotName, zone, region, location, diskProjectID string,
) error {
	// projectID := "your_project_id"
	// diskName := "your_disk_name"
	// snapshotName := "your_snapshot_name"
	// zone := "europe-central2-b"
	// region := "eupore-central2"
	// location = "eupore-central2"
	// diskProjectID = "YOUR_DISK_PROJECT_ID"

	ctx := context.Background()

	snapshotsClient, err := compute.NewSnapshotsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewSnapshotsRESTClient: %w", err)
	}
	defer snapshotsClient.Close()

	if zone == "" && region == "" {
		return fmt.Errorf("you need to specify `zone` or `region` for this function to work")
	}

	if zone != "" && region != "" {
		return fmt.Errorf("you can't set both `zone` and `region` parameters")
	}

	if diskProjectID == "" {
		diskProjectID = projectID
	}

	disk := &computepb.Disk{}
	locations := []string{}
	if location != "" {
		locations = append(locations, location)
	}

	if zone != "" {
		disksClient, err := compute.NewDisksRESTClient(ctx)
		if err != nil {
			return fmt.Errorf("NewDisksRESTClient: %w", err)
		}
		defer disksClient.Close()

		getDiskReq := &computepb.GetDiskRequest{
			Project: projectID,
			Zone:    zone,
			Disk:    diskName,
		}

		disk, err = disksClient.Get(ctx, getDiskReq)
		if err != nil {
			return fmt.Errorf("unable to get disk: %w", err)
		}
	} else {
		regionDisksClient, err := compute.NewRegionDisksRESTClient(ctx)
		if err != nil {
			return fmt.Errorf("NewRegionDisksRESTClient: %w", err)
		}
		defer regionDisksClient.Close()

		getDiskReq := &computepb.GetRegionDiskRequest{
			Project: projectID,
			Region:  region,
			Disk:    diskName,
		}

		disk, err = regionDisksClient.Get(ctx, getDiskReq)
		if err != nil {
			return fmt.Errorf("unable to get disk: %w", err)
		}
	}

	req := &computepb.InsertSnapshotRequest{
		Project: projectID,
		SnapshotResource: &computepb.Snapshot{
			Name:             proto.String(snapshotName),
			SourceDisk:       proto.String(disk.GetSelfLink()),
			StorageLocations: locations,
		},
	}

	op, err := snapshotsClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create snapshot: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Snapshot created\n")

	return nil
}

  4. Hapus VM Anda dari zona sumber.

    compute/delete_instance.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// deleteInstance sends a delete request to the Compute Engine API and waits for it to complete.
func deleteInstance(w io.Writer, projectID, zone, instanceName string) error {
	// projectID := "your_project_id"
	// zone := "europe-central2-b"
	// instanceName := "your_instance_name"
	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	req := &computepb.DeleteInstanceRequest{
		Project:  projectID,
		Zone:     zone,
		Instance: instanceName,
	}

	op, err := instancesClient.Delete(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to delete instance: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Instance deleted\n")

	return nil
}

  5. Selanjutnya, buat snapshot lain dari boot disk dan disk data.

    compute/snapshots/create_snapshot.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
	"google.golang.org/protobuf/proto"
)

// createSnapshot creates a snapshot of a disk.
func createSnapshot(
	w io.Writer,
	projectID, diskName, snapshotName, zone, region, location, diskProjectID string,
) error {
	// projectID := "your_project_id"
	// diskName := "your_disk_name"
	// snapshotName := "your_snapshot_name"
	// zone := "europe-central2-b"
	// region := "eupore-central2"
	// location = "eupore-central2"
	// diskProjectID = "YOUR_DISK_PROJECT_ID"

	ctx := context.Background()

	snapshotsClient, err := compute.NewSnapshotsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewSnapshotsRESTClient: %w", err)
	}
	defer snapshotsClient.Close()

	if zone == "" && region == "" {
		return fmt.Errorf("you need to specify `zone` or `region` for this function to work")
	}

	if zone != "" && region != "" {
		return fmt.Errorf("you can't set both `zone` and `region` parameters")
	}

	if diskProjectID == "" {
		diskProjectID = projectID
	}

	disk := &computepb.Disk{}
	locations := []string{}
	if location != "" {
		locations = append(locations, location)
	}

	if zone != "" {
		disksClient, err := compute.NewDisksRESTClient(ctx)
		if err != nil {
			return fmt.Errorf("NewDisksRESTClient: %w", err)
		}
		defer disksClient.Close()

		getDiskReq := &computepb.GetDiskRequest{
			Project: projectID,
			Zone:    zone,
			Disk:    diskName,
		}

		disk, err = disksClient.Get(ctx, getDiskReq)
		if err != nil {
			return fmt.Errorf("unable to get disk: %w", err)
		}
	} else {
		regionDisksClient, err := compute.NewRegionDisksRESTClient(ctx)
		if err != nil {
			return fmt.Errorf("NewRegionDisksRESTClient: %w", err)
		}
		defer regionDisksClient.Close()

		getDiskReq := &computepb.GetRegionDiskRequest{
			Project: projectID,
			Region:  region,
			Disk:    diskName,
		}

		disk, err = regionDisksClient.Get(ctx, getDiskReq)
		if err != nil {
			return fmt.Errorf("unable to get disk: %w", err)
		}
	}

	req := &computepb.InsertSnapshotRequest{
		Project: projectID,
		SnapshotResource: &computepb.Snapshot{
			Name:             proto.String(snapshotName),
			SourceDisk:       proto.String(disk.GetSelfLink()),
			StorageLocations: locations,
		},
	}

	op, err := snapshotsClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create snapshot: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Snapshot created\n")

	return nil
}

  6. (Opsional) Hapus persistent disk.

    Jika Anda berencana menggunakan kembali nama persistent disk untuk disk baru, Anda harus menghapus disk yang ada untuk merilis namanya. Menghapus disk Anda juga menghemat biaya penyimpanan persistent disk.

    Jika tidak berencana untuk menggunakan kembali nama disk yang sama, Anda tidak perlu menghapusnya.

    compute/disks/delete_disk.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// deleteDisk deletes a disk from a project.
func deleteDisk(w io.Writer, projectID, zone, diskName string) error {
	// projectID := "your_project_id"
	// zone := "us-west3-b"
	// diskName := "your_disk_name"

	ctx := context.Background()
	disksClient, err := compute.NewDisksRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewDisksRESTClient: %w", err)
	}
	defer disksClient.Close()

	req := &computepb.DeleteDiskRequest{
		Project: projectID,
		Zone:    zone,
		Disk:    diskName,
	}

	op, err := disksClient.Delete(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to delete disk: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Disk deleted\n")

	return nil
}

  7. Buat persistent disk baru di zona tujuan dari snapshot yang Anda buat. Buat boot disk terlebih dahulu, lalu disk data.

    compute/disks/create_disk_from_snapshot.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
	"google.golang.org/protobuf/proto"
)

// createDiskFromSnapshot creates a new disk in a project in given zone.
func createDiskFromSnapshot(
	w io.Writer,
	projectID, zone, diskName, diskType, snapshotLink string,
	diskSizeGb int64,
) error {
	// projectID := "your_project_id"
	// zone := "us-west3-b" // should match diskType below
	// diskName := "your_disk_name"
	// diskType := "zones/us-west3-b/diskTypes/pd-ssd"
	// snapshotLink := "projects/your_project_id/global/snapshots/snapshot_name"
	// diskSizeGb := 120

	ctx := context.Background()
	disksClient, err := compute.NewDisksRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewDisksRESTClient: %w", err)
	}
	defer disksClient.Close()

	req := &computepb.InsertDiskRequest{
		Project: projectID,
		Zone:    zone,
		DiskResource: &computepb.Disk{
			Name:           proto.String(diskName),
			Zone:           proto.String(zone),
			Type:           proto.String(diskType),
			SourceSnapshot: proto.String(snapshotLink),
			SizeGb:         proto.Int64(diskSizeGb),
		},
	}

	op, err := disksClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create disk: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Disk created\n")

	return nil
}

  8. Buat ulang VM dengan disk baru di zona tujuan.

    compute/instances/create-start-instance/create_instance_with_existing_disks.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
	"google.golang.org/protobuf/proto"
)

// createWithExistingDisks create a new VM instance using selected disks.
// The first disk in diskNames will be used as boot disk.
func createWithExistingDisks(
	w io.Writer,
	projectID, zone, instanceName string,
	diskNames []string,
) error {
	// projectID := "your_project_id"
	// zone := "europe-central2-b"
	// instanceName := "your_instance_name"
	// diskNames := []string{"boot_disk", "disk1", "disk2"}

	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	disksClient, err := compute.NewDisksRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewDisksRESTClient: %w", err)
	}
	defer disksClient.Close()

	disks := [](*computepb.Disk){}

	for _, diskName := range diskNames {
		reqDisk := &computepb.GetDiskRequest{
			Project: projectID,
			Zone:    zone,
			Disk:    diskName,
		}

		disk, err := disksClient.Get(ctx, reqDisk)
		if err != nil {
			return fmt.Errorf("unable to get disk: %w", err)
		}

		disks = append(disks, disk)
	}

	attachedDisks := [](*computepb.AttachedDisk){}

	for _, disk := range disks {
		attachedDisk := &computepb.AttachedDisk{
			Source: proto.String(disk.GetSelfLink()),
		}
		attachedDisks = append(attachedDisks, attachedDisk)
	}

	attachedDisks[0].Boot = proto.Bool(true)

	instanceResource := &computepb.Instance{
		Name:        proto.String(instanceName),
		Disks:       attachedDisks,
		MachineType: proto.String(fmt.Sprintf("zones/%s/machineTypes/n1-standard-1", zone)),
		NetworkInterfaces: []*computepb.NetworkInterface{
			{
				Name: proto.String("global/networks/default"),
			},
		},
	}

	req := &computepb.InsertInstanceRequest{
		Project:          projectID,
		Zone:             zone,
		InstanceResource: instanceResource,
	}

	op, err := instancesClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create instance: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Instance created\n")

	return nil
}

  9. (Opsional) Hapus snapshot disk sementara. Setelah Anda memastikan mesin virtual sudah dipindahkan, hemat biaya penyimpanan dengan menghapus snapshot sementara yang Anda buat.

    compute/snapshots/delete_snapshot.go 
    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// deleteSnapshot deletes a snapshot of a disk.
func deleteSnapshot(w io.Writer, projectID, snapshotName string) error {
	// projectID := "your_project_id"
	// snapshotName := "your_snapshot_name"

	ctx := context.Background()
	snapshotsClient, err := compute.NewSnapshotsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewSnapshotsRESTClient: %w", err)
	}
	defer snapshotsClient.Close()

	req := &computepb.DeleteSnapshotRequest{
		Project:  projectID,
		Snapshot: snapshotName,
	}

	op, err := snapshotsClient.Delete(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to delete snapshot: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Snapshot deleted\n")

	return nil
}

Java

  1. Dapatkan detail VM dan identifikasi disk yang terpasang ke VM.

    compute/cloud-client/src/main/java/compute/GetInstance.java 
    
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import java.io.IOException;

public class GetInstance {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.

    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the zone you want to use. For example: 'us-west3-b'.
    String zone = "europe-central2-b";

    // Name of the VM instance you want to query.
    String instanceName = "YOUR_INSTANCE_NAME";

    getInstance(projectId, zone, instanceName);
  }

  // Prints information about a VM instance in the given zone in the specified project.
  public static void getInstance(String projectId, String zone, String instanceName)
      throws IOException {

    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `instancesClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (InstancesClient instancesClient = InstancesClient.create()) {

      Instance instance = instancesClient.get(projectId, zone, instanceName);

      System.out.printf("Retrieved the instance %s", instance.toString());
    }
  }
}

  2. Setel status hapus otomatis boot disk dan disk data ke false untuk memastikan bahwa disk tidak otomatis dihapus saat VM dihapus.

    compute/cloud-client/src/main/java/compute/disks/SetDiskAutodelete.java 
    
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.SetDiskAutoDeleteInstanceRequest;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class SetDiskAutodelete {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.

    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // The zone of the disk that you want to modify.
    String zone = "europe-central2-b";

    // Name of the instance the disk is attached to.
    String instanceName = "YOUR_INSTANCE_NAME";

    // The name of the disk for which you want to modify the autodelete flag.
    String diskName = "YOUR_DISK_NAME";

    // The new value of the autodelete flag.
    boolean autoDelete = true;

    setDiskAutodelete(projectId, zone, instanceName, diskName, autoDelete);
  }

  // Sets the autodelete flag of a disk to given value.
  public static void setDiskAutodelete(String projectId, String zone, String instanceName,
      String diskName, boolean autoDelete)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {

    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `instancesClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (InstancesClient instancesClient = InstancesClient.create()) {

      // Retrieve the instance given by the instanceName.
      Instance instance = instancesClient.get(projectId, zone, instanceName);

      // Check if the instance contains a disk that matches the given diskName.
      boolean diskNameMatch = instance.getDisksList()
          .stream()
          .anyMatch(disk -> disk.getDeviceName().equals(diskName));

      if (!diskNameMatch) {
        throw new Error(
            String.format("Instance %s doesn't have a disk named %s attached", instanceName,
                diskName));
      }

      // Create the request object.
      SetDiskAutoDeleteInstanceRequest request = SetDiskAutoDeleteInstanceRequest.newBuilder()
          .setProject(projectId)
          .setZone(zone)
          .setInstance(instanceName)
          .setDeviceName(diskName)
          // Update the autodelete property.
          .setAutoDelete(autoDelete)
          .build();

      // Wait for the update instance operation to complete.
      Operation response = instancesClient.setDiskAutoDeleteAsync(request)
          .get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        System.out.println("Failed to update Disk autodelete field!" + response);
        return;
      }
      System.out.println(
          "Disk autodelete field updated. Operation Status: " + response.getStatus());
    }
  }
}

  3. Buat cadangan data Anda menggunakan snapshot persistent disk.

    Sebagai tindakan pencegahan, buat cadangan data Anda saat persistent disk masih terpasang ke VM menggunakan snapshot persistent disk. Sebelum mengambil snapshot, pastikan snapshot tersebut konsisten dengan status persistent disk dengan mematuhi praktik terbaik snapshot.

    Setelah Anda menghapus buffering disk, buat snapshot:

    compute/cloud-client/src/main/java/compute/disks/CreateSnapshot.java 
    
import com.google.cloud.compute.v1.Disk;
import com.google.cloud.compute.v1.DisksClient;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.RegionDisksClient;
import com.google.cloud.compute.v1.Snapshot;
import com.google.cloud.compute.v1.SnapshotsClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateSnapshot {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // You need to pass `zone` or `region` parameter relevant to the disk you want to
    // snapshot, but not both. Pass `zone` parameter for zonal disks and `region` for
    // regional disks.

    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the disk you want to create.
    String diskName = "YOUR_DISK_NAME";

    // Name of the snapshot that you want to create.
    String snapshotName = "YOUR_SNAPSHOT_NAME";

    // The zone of the source disk from which you create the snapshot (for zonal disks).
    String zone = "europe-central2-b";

    // The region of the source disk from which you create the snapshot (for regional disks).
    String region = "your-disk-region";

    // The Cloud Storage multi-region or the Cloud Storage region where you
    // want to store your snapshot.
    // You can specify only one storage location. Available locations:
    // https://cloud.google.com/storage/docs/locations#available-locations
    String location = "europe-central2";

    // Project ID or project number of the Cloud project that
    // hosts the disk you want to snapshot. If not provided, the value will be defaulted
    // to 'projectId' value.
    String diskProjectId = "YOUR_DISK_PROJECT_ID";

    createSnapshot(projectId, diskName, snapshotName, zone, region, location, diskProjectId);
  }

  // Creates a snapshot of a disk.
  public static void createSnapshot(String projectId, String diskName, String snapshotName,
      String zone, String region, String location, String diskProjectId)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {

    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `snapshotsClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (SnapshotsClient snapshotsClient = SnapshotsClient.create()) {

      if (zone.isEmpty() && region.isEmpty()) {
        throw new Error("You need to specify 'zone' or 'region' for this function to work");
      }

      if (!zone.isEmpty() && !region.isEmpty()) {
        throw new Error("You can't set both 'zone' and 'region' parameters");
      }

      // If Disk's project id is not specified, then the projectId parameter will be used.
      if (diskProjectId.isEmpty()) {
        diskProjectId = projectId;
      }

      // If zone is not empty, use the DisksClient to create a disk.
      // Else, use the RegionDisksClient.
      Disk disk;
      if (!zone.isEmpty()) {
        DisksClient disksClient = DisksClient.create();
        disk = disksClient.get(projectId, zone, diskName);
      } else {
        RegionDisksClient regionDisksClient = RegionDisksClient.create();
        disk = regionDisksClient.get(diskProjectId, region, diskName);
      }

      // Set the snapshot properties.
      Snapshot snapshotResource;
      if (!location.isEmpty()) {
        snapshotResource = Snapshot.newBuilder()
            .setName(snapshotName)
            .setSourceDisk(disk.getSelfLink())
            .addStorageLocations(location)
            .build();
      } else {
        snapshotResource = Snapshot.newBuilder()
            .setName(snapshotName)
            .setSourceDisk(disk.getSelfLink())
            .build();
      }

      // Wait for the operation to complete.
      Operation operation = snapshotsClient.insertAsync(projectId, snapshotResource)
          .get(3, TimeUnit.MINUTES);

      if (operation.hasError()) {
        System.out.println("Snapshot creation failed!" + operation);
        return;
      }

      // Retrieve the created snapshot.
      Snapshot snapshot = snapshotsClient.get(projectId, snapshotName);
      System.out.printf("Snapshot created: %s", snapshot.getName());

    }
  }
}

  4. Hapus VM Anda dari zona sumber.

    compute/cloud-client/src/main/java/compute/DeleteInstance.java 
    
import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.DeleteInstanceRequest;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteInstance {

  public static void main(String[] args)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    String project = "your-project-id";
    String zone = "zone-name";
    String instanceName = "instance-name";
    deleteInstance(project, zone, instanceName);
  }

  // Delete the instance specified by `instanceName`
  // if it's present in the given project and zone.
  public static void deleteInstance(String project, String zone, String instanceName)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `instancesClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (InstancesClient instancesClient = InstancesClient.create()) {

      System.out.printf("Deleting instance: %s ", instanceName);

      // Describe which instance is to be deleted.
      DeleteInstanceRequest deleteInstanceRequest = DeleteInstanceRequest.newBuilder()
          .setProject(project)
          .setZone(zone)
          .setInstance(instanceName).build();

      OperationFuture<Operation, Operation> operation = instancesClient.deleteAsync(
          deleteInstanceRequest);
      // Wait for the operation to complete.
      Operation response = operation.get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        System.out.println("Instance deletion failed ! ! " + response);
        return;
      }
      System.out.println("Operation Status: " + response.getStatus());
    }
  }
}

  5. Selanjutnya, buat snapshot lain dari boot disk dan disk data.

    compute/cloud-client/src/main/java/compute/disks/CreateSnapshot.java 
    
import com.google.cloud.compute.v1.Disk;
import com.google.cloud.compute.v1.DisksClient;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.RegionDisksClient;
import com.google.cloud.compute.v1.Snapshot;
import com.google.cloud.compute.v1.SnapshotsClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateSnapshot {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // You need to pass `zone` or `region` parameter relevant to the disk you want to
    // snapshot, but not both. Pass `zone` parameter for zonal disks and `region` for
    // regional disks.

    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the disk you want to create.
    String diskName = "YOUR_DISK_NAME";

    // Name of the snapshot that you want to create.
    String snapshotName = "YOUR_SNAPSHOT_NAME";

    // The zone of the source disk from which you create the snapshot (for zonal disks).
    String zone = "europe-central2-b";

    // The region of the source disk from which you create the snapshot (for regional disks).
    String region = "your-disk-region";

    // The Cloud Storage multi-region or the Cloud Storage region where you
    // want to store your snapshot.
    // You can specify only one storage location. Available locations:
    // https://cloud.google.com/storage/docs/locations#available-locations
    String location = "europe-central2";

    // Project ID or project number of the Cloud project that
    // hosts the disk you want to snapshot. If not provided, the value will be defaulted
    // to 'projectId' value.
    String diskProjectId = "YOUR_DISK_PROJECT_ID";

    createSnapshot(projectId, diskName, snapshotName, zone, region, location, diskProjectId);
  }

  // Creates a snapshot of a disk.
  public static void createSnapshot(String projectId, String diskName, String snapshotName,
      String zone, String region, String location, String diskProjectId)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {

    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `snapshotsClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (SnapshotsClient snapshotsClient = SnapshotsClient.create()) {

      if (zone.isEmpty() && region.isEmpty()) {
        throw new Error("You need to specify 'zone' or 'region' for this function to work");
      }

      if (!zone.isEmpty() && !region.isEmpty()) {
        throw new Error("You can't set both 'zone' and 'region' parameters");
      }

      // If Disk's project id is not specified, then the projectId parameter will be used.
      if (diskProjectId.isEmpty()) {
        diskProjectId = projectId;
      }

      // If zone is not empty, use the DisksClient to create a disk.
      // Else, use the RegionDisksClient.
      Disk disk;
      if (!zone.isEmpty()) {
        DisksClient disksClient = DisksClient.create();
        disk = disksClient.get(projectId, zone, diskName);
      } else {
        RegionDisksClient regionDisksClient = RegionDisksClient.create();
        disk = regionDisksClient.get(diskProjectId, region, diskName);
      }

      // Set the snapshot properties.
      Snapshot snapshotResource;
      if (!location.isEmpty()) {
        snapshotResource = Snapshot.newBuilder()
            .setName(snapshotName)
            .setSourceDisk(disk.getSelfLink())
            .addStorageLocations(location)
            .build();
      } else {
        snapshotResource = Snapshot.newBuilder()
            .setName(snapshotName)
            .setSourceDisk(disk.getSelfLink())
            .build();
      }

      // Wait for the operation to complete.
      Operation operation = snapshotsClient.insertAsync(projectId, snapshotResource)
          .get(3, TimeUnit.MINUTES);

      if (operation.hasError()) {
        System.out.println("Snapshot creation failed!" + operation);
        return;
      }

      // Retrieve the created snapshot.
      Snapshot snapshot = snapshotsClient.get(projectId, snapshotName);
      System.out.printf("Snapshot created: %s", snapshot.getName());

    }
  }
}

  6. (Opsional) Hapus persistent disk.

    Jika Anda berencana menggunakan kembali nama persistent disk untuk disk baru, Anda harus menghapus disk yang ada untuk merilis namanya. Menghapus disk Anda juga menghemat biaya penyimpanan persistent disk.

    Jika tidak berencana untuk menggunakan kembali nama disk yang sama, Anda tidak perlu menghapusnya.

    compute/cloud-client/src/main/java/compute/disks/DeleteDisk.java 
    
import com.google.cloud.compute.v1.DeleteDiskRequest;
import com.google.cloud.compute.v1.DisksClient;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteDisk {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.

    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // The zone from where you want to delete the disk.
    String zone = "europe-central2-b";

    // Name of the disk you want to delete.
    String diskName = "YOUR_DISK_NAME";

    deleteDisk(projectId, zone, diskName);
  }

  // Deletes a disk from a project.
  public static void deleteDisk(String projectId, String zone, String diskName)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {

    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `disksClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (DisksClient disksClient = DisksClient.create()) {

      // Create the request object.
      DeleteDiskRequest deleteDiskRequest = DeleteDiskRequest.newBuilder()
          .setProject(projectId)
          .setZone(zone)
          .setDisk(diskName)
          .build();

      // Wait for the delete disk operation to complete.
      Operation response = disksClient.deleteAsync(deleteDiskRequest)
          .get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        System.out.println("Disk deletion failed!" + response);
        return;
      }
      System.out.println("Operation Status: " + response.getStatus());
    }
  }
}

  7. Buat persistent disk baru di zona tujuan dari snapshot yang Anda buat. Buat boot disk terlebih dahulu, lalu disk data.