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.
  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Menginstal Google Cloud CLI. Setelah penginstalan, lakukan 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.

    2. Set a default region and zone.

    REST

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

      Menginstal Google Cloud CLI. Setelah penginstalan, lakukan 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.

    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 Buat 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 Tetap jalankan instance 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 di 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 menunjuk ke image-v2, hentikan penggunaan image-v2 dan kelompok tersebut akan kembali menunjuk ke image-v1.

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