Menetapkan versi image dalam kelompok image

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

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

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

Sebelum memulai

  • Baca dokumen Gambar.
  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Untuk 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 image

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

  3. Tentukan Source tempat Anda ingin membuat image. 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 image. 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 kunci milik dan dikelola Google, kunci Cloud Key Management Service (Cloud KMS), atau kunci enkripsi yang disediakan pelanggan (CSEK). Jika kunci enkripsi tidak ditentukan, gambar akan dienkripsi menggunakan kunci milik dan dikelola Google.

  9. Klik Create untuk membuat image.

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 keluarga:

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 dalam 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 dituju oleh suatu 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 dalam 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 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