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 yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API.
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:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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 Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.
-
Menetapkan versi image dalam kelompok image
Di konsol Google Cloud, buka halaman Create an image.
Tentukan Nama image Anda. Contoh,
image-v1
.Tentukan Source tempat Anda ingin membuat image. Ini dapat berupa persistent disk, snapshot, image lain, atau file disk.raw di Cloud Storage.
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.
Di menu drop-down Berdasarkan lokasi disk sumber (default), tentukan lokasi untuk menyimpan image. Misalnya, tentukan
us
untuk menyimpan image di multi-regionus
, atauus-central1
untuk menyimpannya di regionus-central1
. Jika Anda tidak menentukan pilihan, Compute Engine akan menyimpan image di multi-region yang paling dekat dengan lokasi sumber image Anda.Tentukan Keluarga image untuk image baru. Misalnya, tambahkan
my-image-family
untuk mengatur image sebagai bagian dari kelompok image.Opsional: tentukan properti gambar lainnya:
- Deskripsi: deskripsi untuk gambar kustom Anda.
- Label: label untuk mengelompokkan resource.
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.
Klik Create untuk membuat image.
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
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.
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
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