Utilisez une image système pour stocker la totalité de la configuration, des métadonnées, des autorisations et des données de plusieurs disques pour une instance de VM exécutée sur Compute Engine. L'instance de VM que vous utilisez pour créer une image système est appelée instance de VM source.
Pour savoir quand et comment utiliser des images système, consultez la page Images système.
Ce document explique comment créer une image système à partir d'une instance de VM source.
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Trusted Cloud by S3NS .
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
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
-
Installez la Google Cloud CLI, puis connectez-vous-y avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud init
- Set a default region and zone.
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous-y avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .
Limites et restrictions
- Vous pouvez créer une image système d'une instance spécifique au maximum six fois toutes les 60 minutes.
- Vous pouvez protéger une image système à l'aide de Cloud Key Management Service (Cloud KMS) ou d'une clé de chiffrement fournie par le client (CSEK). La clé de chiffrement protège le contenu des disques. Cependant, notez que les métadonnées ne sont pas protégées.
- Si vous utilisez une clé CSEK pour protéger votre image système, une copie intégrale de toutes les données du disque est enregistrée lors de la génération de l'image système. Dans tout autre scénario, les données de disque sont stockées dans des copies différentielles.
Vous ne pouvez pas créer d'images système à partir de VM sources qui :
- sont associées à plus de 200 To de disques ;
- ne sont associées à aucun disque ;
- sont associées à des volumes Hyperdisk.
- Utilisez le type de machine Z3, à l'exception de
z3-highmem-192-highlssd-metal
. - Utilisez un type de machine C3D, H3 ou A3.
Propriétés d'instance et de disque non compatibles avec l'image système
Lorsque vous créez des images système à partir d'instances de VM ou que vous créez des instances de VM à partir d'images système, les propriétés d'instance et de disque suivantes ne sont pas conservées ni restaurées :
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
Créer une image système à partir d'une VM
Vous pouvez créer des images système à l'aide de la consoleTrusted Cloud , de la Google Cloud CLI ou de REST.
Pour créer une image système, vous avez besoin des informations suivantes :
- Le nom de l'image système que vous souhaitez créer.
- Le nom de l'instance de VM source.
- La zone dans laquelle se trouve l'instance de VM source.
- Description facultative
- Un emplacement
storageLocation
facultatif. Si vous ne spécifiez pas d'emplacement, l'emplacement de stockage par défaut est l'emplacement Cloud Storage multirégional de l'instance de VM source. - Une clé de chiffrement facultative. Vous pouvez choisir entre une clé Google Cloud-powered encryption key, une clé Cloud Key Management Service (Cloud KMS) ou une clé de chiffrement fournie par le client (CSEK). Si aucune clé de chiffrement n'est spécifiée, les images système sont chiffrées à l'aide d'une Google Cloud-powered encryption key.
Si vous souhaitez utiliser une image système pour le clonage et la création d'instantanées d'une instance, supprimez les informations de système d'exploitation et d'application propres à l'instance avant de l'utiliser pour générer l'image système. Par exemple, pour les instances de VM Windows, utilisez
GCESysprep
pour préparer le système à la réplication.
Console
Dans la console Trusted Cloud , accédez à la page Images système.
Cliquez sur Créer une image système.
Spécifiez un nom pour votre image système.
Facultatif : Fournissez une description.
Sélectionnez l'instance de VM source.
Facultatif : Spécifiez l'emplacement où stocker l'image système. Choisissez entre un stockage multirégional ou régional. Pour en savoir plus sur les emplacements, consultez la section Emplacement de stockage des images système.
Facultatif : Sélectionnez une méthode de chiffrement.
Cliquez sur Créer.
gcloud
Pour créer une image système à partir d'une instance, utilisez la commande
gcloud compute machine-images create
.gcloud compute machine-images create MACHINE_IMAGE_NAME \ --source-instance=SOURCE_VM_NAME
Remplacez les éléments suivants :
MACHINE_IMAGE_NAME
: nom de l'image système que vous souhaitez créer.SOURCE_VM_NAME
: nom de l'instance de VM source à partir de laquelle vous souhaitez créer l'image.
Exemple
Par exemple, vous pouvez utiliser la commande
gcloud
suivante pour créer une image système appeléemy-machine-image
à partir d'une instance source nomméemy-instance
:gcloud compute machine-images create my-machine-image \ --source-instance=my-instance
Le processus prend quelques minutes. Une fois l'image système créée, vous obtenez un résultat semblable à celui-ci :
Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image]. NAME STATUS my-machine-image READY
REST
Dans l'API, envoyez une requête
POST
à la méthodemachineimages.insert
. Dans le corps de la requête, incluez la requêtePOST
suivante :POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages { "name": "MACHINE_IMAGE_NAME", "sourceInstance": "SOURCE_INSTANCE_URL" }
Remplacez les éléments suivants :
PROJECT_ID
: ID de votre projet.MACHINE_IMAGE_NAME
: nom de l'image système que vous souhaitez créer.SOURCE_INSTANCE_URL
: URL complète ou partielle de l'instance de VM source que vous souhaitez utiliser pour créer l'image système. Par exemple, si vous avez une instance source appeléemy-instance
dans un projet nommémyProject
, les URL suivantes sont valides :https://www.googleapis.com/compute/v1/projects/myProject/global/instances/my-instance
projects/myProject/global/instances/my-instance
global/instances/my-instance
Étapes suivantes
- En savoir plus sur les images système
- Créer des instances de VM à partir d'images système
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]],[]] -