Gunakan image mesin untuk menyimpan semua konfigurasi, metadata, izin, dan data dari beberapa disk untuk instance VM yang berjalan di Compute Engine. Instance VM yang Anda gunakan untuk membuat image mesin disebut sebagai instance sumber VM.
Untuk mengetahui informasi tentang waktu dan cara menggunakan image mesin, lihat Image mesin.
Dokumen ini menjelaskan langkah-langkah untuk membuat image mesin dari instance VM sumber.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
- 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.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Pembatasan dan batasan
- Anda dapat membuat image mesin dari instance tertentu paling banyak 6 kali setiap 60 menit.
- Anda dapat melindungi image mesin menggunakan Cloud Key Management Service (Cloud KMS) atau kunci enkripsi yang disediakan pelanggan (CSEK). Kunci enkripsi melindungi konten disk. Namun, metadata tidak dilindungi.
- Jika Anda menggunakan CSEK untuk melindungi image mesin, salinan lengkap semua data disk akan disimpan selama pembuatan image mesin. Dalam semua skenario lainnya, data disk disimpan dalam salinan diferensial.
Anda tidak dapat membuat image mesin dari VM sumber yang:
- Memiliki disk yang terpasang lebih dari 200 TB.
- Tidak memiliki disk yang terpasang.
- Memiliki volume Hyperdisk yang terpasang.
- Gunakan jenis mesin Z3, kecuali
z3-highmem-192-highlssd-metal
. - Gunakan jenis mesin C3D, H3, atau A3.
Properti instance dan disk tidak didukung oleh image mesin
Saat Anda membuat image mesin dari instance VM atau membuat instance VM dari image mesin, properti instance dan disk berikut tidak dipertahankan atau dipulihkan:
disks.architecture
disks.description
disks.labels
disks.locked
disks.multiWriter
disks.onUpdateAction
disks.provisionedIops
disks.shieldedInstanceInitialState
disks.sourceImage
disks.sourceImageEncryptionKey
disks.sourceInstantSnapshot
disks.sourceSnapshot
disks.sourceSnapshotEncryptionKey
privateIpv6GoogleAccess
resourceManagerTags
resourcePolicies
secure_tag
shieldedInstanceConfig
Membuat image mesin dari VM
Anda dapat membuat image mesin menggunakan konsolTrusted Cloud , Google Cloud CLI, atau REST.
Untuk membuat image mesin, Anda memerlukan informasi berikut:
- Nama untuk image mesin yang ingin Anda buat.
- Nama instance VM sumber.
- Zona tempat instance VM sumber berada.
- Deskripsi opsional.
storageLocation
opsional. Jika Anda tidak menentukan lokasi, lokasi penyimpanan default-nya adalah lokasi Cloud Storage multiregional instance VM sumber.- Kunci enkripsi opsional. Anda dapat memilih antara Google Cloud-powered encryption key, kunci Cloud Key Management Service (Cloud KMS) atau kunci enkripsi yang disediakan pelanggan (CSEK). Jika kunci enkripsi tidak ditentukan, image mesin akan dienkripsi menggunakan Google Cloud-powered encryption key.
Jika Anda ingin menggunakan image mesin untuk cloning instance dan pembuatan snapshot, hapus informasi OS dan aplikasi yang unik untuk instance tersebut sebelum membuat image mesin dari instance. Misalnya, untuk instance VM Windows, gunakan
GCESysprep
untuk menyiapkan sistem untuk replikasi.
Konsol
Di konsol Trusted Cloud , buka halaman Machine images.
Klik Buat image mesin.
Tentukan Nama untuk image mesin Anda.
Opsional: Berikan Deskripsi.
Pilih Instance VM sumber.
Opsional: Tentukan tempat untuk menyimpan image mesin. Pilih antara penyimpanan Multi-regional atau Regional. Untuk mengetahui informasi selengkapnya tentang lokasi, lihat Lokasi penyimpanan image mesin.
Opsional: Pilih metode Enkripsi.
Klik Buat.
gcloud
Gunakan perintah
gcloud compute machine-images create
untuk membuat image mesin dari instance.gcloud compute machine-images create MACHINE_IMAGE_NAME \ --source-instance=SOURCE_VM_NAME
Ganti kode berikut:
MACHINE_IMAGE_NAME
: nama image mesin yang ingin Anda buat.SOURCE_VM_NAME
: nama instance VM sumber tempat Anda ingin membuat image.
Contoh
Misalnya, Anda dapat menggunakan perintah
gcloud
berikut untuk membuat image mesin yang disebutmy-machine-image
dari instance sumber yang disebutmy-instance
:gcloud compute machine-images create my-machine-image \ --source-instance=my-instance
Proses ini memerlukan waktu beberapa menit. Setelah image mesin dibuat, Anda akan mendapatkan output yang terlihat seperti berikut:
Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image]. NAME STATUS my-machine-image READY
REST
Di API, buat permintaan
POST
ke metodemachineimages.insert
. Dalam isi permintaan, sertakan permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages { "name": "MACHINE_IMAGE_NAME", "sourceInstance": "SOURCE_INSTANCE_URL" }
Ganti kode berikut:
PROJECT_ID
: ID project.MACHINE_IMAGE_NAME
: nama image mesin yang ingin Anda buat.SOURCE_INSTANCE_URL
: URL lengkap atau sebagian instance VM sumber yang ingin Anda gunakan untuk membuat image mesin. Misalnya, jika Anda memiliki instance sumber bernamamy-instance
dalam project bernamamyProject
. URL berikut valid:https://www.googleapis.com/compute/v1/projects/myProject/global/instances/my-instance
projects/myProject/global/instances/my-instance
global/instances/my-instance
Apa langkah selanjutnya?
- Pelajari image mesin lebih lanjut
- Buat instance VM dari image mesin
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-08 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-08 UTC."],[[["Machine images store a VM instance's configuration, metadata, permissions, and data from multiple disks, using a source VM instance as the base."],["Machine images can be created through the Google Cloud console, the Google Cloud CLI, or REST API, requiring specific permissions such as `compute.machineImages.create`."],["Creating a machine image involves specifying a name, the source VM instance, and its zone, with optional settings like storage location and encryption key, with a limit of six creations per instance every 60 minutes."],["Certain instance and disk properties are not preserved or restored when creating or using machine images, such as `disks.architecture`, `disks.description`, and `resourcePolicies`, among others."],["Machine images can not be created from source VMs that exceed 200TB of disks, have no attached disks, any attached Hyperdisk volumes or use a C3D, H3, A3 or Z3 machine type."]]],[]] -