Menetapkan versi image dalam kelompok image

Gunakan kelompok image untuk menyederhanakan pembuatan versi image. Tambahkan gambar ke kelompok gambar untuk menetapkannya sebagai versi gambar terbaru. Jika Anda memutuskan bahwa Anda harus melakukan roll back kelompok image ke versi image sebelumnya, hentikan penggunaan image terbaru dalam kelompok tersebut.

Untuk mengetahui praktik terbaik saat menangani kelompok image, lihat Praktik terbaik kelompok image.

Secara opsional, Anda dapat menentukan lokasi penyimpanan image menggunakan Google Cloud konsol, perintah gcloud compute images create dengan tanda --storage-location, atau metode images().insert.

Sebelum memulai

  • Baca dokumen Gambar.
  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan region dan zona default.

    • REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Menetapkan versi image dalam kelompok image

Konsol

  1. Di konsol Google Cloud , buka halaman Create an image.

    Buka Buat gambar

  2. Tentukan Name image Anda. Contoh, image-v1.

  3. Tentukan Sumber tempat Anda ingin membuat image. Hal ini dapat berupa persistent disk, snapshot, image lain, atau file disk.raw di Cloud Storage.

  4. Jika Anda membuat image dari disk yang terpasang ke VM yang sedang berjalan, centang Keep instance running untuk mengonfirmasi bahwa Anda ingin membuat image saat VM sedang berjalan. Anda dapat menyiapkan VM sebelum membuat image.

  5. Di menu drop-down Berdasarkan lokasi disk sumber (default), tentukan lokasi untuk menyimpan gambar. Misalnya, tentukan us untuk menyimpan image di multi-region us, atau us-central1 untuk menyimpannya di region us-central1. Jika Anda tidak menentukan pilihan, Compute Engine akan menyimpan image dalam multi-region yang paling dekat dengan lokasi sumber image Anda.

  6. Tentukan Keluarga image untuk image baru. Misalnya, tambahkan my-image-family untuk mengatur image sebagai bagian dari kelompok image.

  7. Opsional: tentukan properti gambar lainnya:

    • Deskripsi: deskripsi untuk gambar kustom Anda.
    • Label: label untuk mengelompokkan resource.

  8. Tentukan kunci enkripsi. Anda dapat memilih antara Google-owned and Google-managed encryption key, kunci Cloud Key Management Service (Cloud KMS) atau kunci enkripsi yang disediakan pelanggan (CSEK). Jika kunci enkripsi tidak ditentukan, image akan dienkripsi menggunakan Google-owned and Google-managed encryption key.

  9. Klik Create untuk membuat gambar.

gcloud 

gcloud compute images create image-v1 \
    --source-disk disk-1 \
    --source-disk-zone us-central1-f \
    --family my-image-family

Kelompok image mengarah ke image-v1. Tambahkan gambar kedua ke kelompok:

gcloud compute images create image-v2 \
    --source-disk disk-2 \
    --source-disk-zone us-central1-f \
    --family my-image-family

REST

Buat permintaan POST ke metode images().insert. Tentukan kelompok image di isi permintaan.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images

{
  "name": "image-v2",
  "sourceDisk": "/zones/us-central1-f/disks/disk-2",
  "family":"my-image-family",

}

Kelompok image mengarah ke image-v2 karena merupakan image terbaru yang Anda tambahkan ke kelompok image.

gcloud

Anda dapat melihat image yang ditunjuk oleh kelompok dengan menjalankan perintah gcloud compute images describe-from-family.

Contoh:

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '8904691942610171306'
kind: compute#image
name: image-v2
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v2
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v2
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY

REST

Buat permintaan GET ke metode images().getFromFamily. Tentukan kelompok image di isi permintaan.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/family

{
  "resourceId":"my-image-family",

}

Jika Anda memutuskan bahwa Anda harus melakukan roll back kelompok image agar tidak lagi mengarah ke image-v2, hentikan penggunaan image-v2 dan kelompok tersebut akan mengarah ke image-v1 lagi.

gcloud compute images deprecate image-v2 \
    --state DEPRECATED \
    --replacement image-v1

Periksa untuk memastikan bahwa kelompok image mengarah ke image-v1.

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '2741732787056801255'
kind: compute#image
name: image-v1
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v1
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v1
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY