Importer des disques virtuels

Si vous possédez des disques virtuels dans votre environnement sur site avec les logiciels et les configurations nécessaires (parfois appelés disques de référence ou images de référence), vous pouvez gagner du temps en important ces disques virtuels dans l'appliance GDC isolée et en utilisant l'image obtenue pour créer des machines virtuelles. L'outil d'importation est compatible avec les formats d'image RAW et QCOW.

Avant de commencer

Avant de continuer, assurez-vous de disposer des éléments suivants :

  • Le gdcloud CLI téléchargée, installée et configurée. Toutes les commandes CLI pour GDC utilisent la CLI gdcloud ou kubectl, et nécessitent un environnement de système d'exploitation.

  • Accès au serveur de l'API Management. Suivez les étapes de la CLI décrites dans Se connecter pour vous connecter au serveur de l'API Management.

Demander des autorisations et un accès

Pour effectuer les tâches listées sur cette page, vous devez disposer des rôles Administrateur de machine virtuelle de projet et Administrateur d'image de machine virtuelle de projet. Suivez les étapes pour vérifier ou demander à votre administrateur IAM de projet de vous attribuer les rôles Administrateur de machine virtuelle de projet (project-vm-admin) et Administrateur d'image de machine virtuelle de projet (project-vm-image-admin) dans l'espace de noms du projet où réside la VM.

Pour les opérations de VM à l'aide de la console GDC ou de gdcloud CLI, demandez à votre administrateur IAM de projet de vous attribuer les rôles listés dans le paragraphe précédent, ainsi que le rôle Lecteur de projet (project-viewer).

Importer des disques virtuels

Vous pouvez importer vos disques virtuels à l'aide de gdcloud CLI ou de l' API Gestionnaire de machine virtuelle.

Pour obtenir les autorisations nécessaires pour importer des images, demandez à votre administrateur IAM d'organisation de vous attribuer le rôle Administrateur d'image de machine virtuelle de projet (project-vm-image-admin) pour votre projet.

gdcloud

Utilisez la commande gdcloud compute images import pour créer une image amorçable.

La commande import s'assure que le disque dispose des packages requis, y compris l'environnement invité, qui est nécessaire pour configurer les identifiants de connexion à l'instance à l'aide du protocole SSH (Secure Shell) sur Linux et du protocole RDP (Remote Desktop Protocol) sur Windows.

Sous Linux, la commande installe également des packages pour le protocole NTP (Network Time Protocol) et cloud-init afin que l'instance s'exécute correctement dans GDC.

Vous pouvez importer des fichiers de disque virtuel directement depuis votre poste de travail. L'outil d'importation importe automatiquement le fichier dans un bucket de stockage d'objets de votre projet.

gdcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE \
  --os=IMAGE_OS \
  --timeout=TIMEOUT

Remplacez les variables suivantes :

  • IMAGE_NAME : nom de votre image de destination. Le nom ne doit pas dépasser 35 caractères.
  • SOURCE_FILE : votre fichier de disque virtuel. Ce fichier est un fichier local sur votre poste de travail. Vous pouvez fournir un chemin d'accès absolu ou relatif.
  • IMAGE_OS : système d'exploitation sur le disque à importer.
  • TIMEOUT : durée maximale d'une importation avant qu'elle n'échoue avec "TIMEOUT". Par exemple, si vous spécifiez 2h, le processus échoue après deux heures. Le délai avant expiration par défaut est 1h.

L'opération d'importation peut prendre un certain temps en fonction de la taille de votre disque virtuel et de la vitesse de votre connexion réseau. L'opération d'importation peut prendre plusieurs dizaines de minutes en fonction de la taille du disque.

API

Avant de commencer le processus d'importation avec l'API, vous devez importer votre disque virtuel dans un bucket de stockage d'objets nommé vm-images-bucket. Pour créer un bucket de stockage d'objets, consultez Créer des buckets de stockage pour des projets.

Pour importer un disque virtuel via l'API, procédez comme suit :

  1. Créez un objet VirtualMachineImageImport dans le serveur de l'API Management pour démarrer le processus d'importation d'images :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
  apply -n PROJECT_ID -f - <<EOF
apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineImageImport
metadata:
  name: IMAGE_NAME
  namespace: PROJECT_ID
spec:
  source:
    objectStorage:
      bucketRef:
        name: vm-images-bucket
      objectName: SOURCE_FILE
  imageMetadata:
    name: IMAGE_NAME
    operatingSystem: OPERATING_SYSTEM
    minimumDiskSize: DISK_SIZE
EOF

    Remplacez les variables suivantes :

    Variable Description
    IMAGE_NAME Nom de l'image à importer. Le nom ne doit pas dépasser 35 caractères.
    PROJECT_ID ID du projet dans lequel vous souhaitez importer l'image.
    SOURCE_FILE Nom du fichier source contenant l'importation du disque virtuel dans le stockage d'objets. Cette valeur correspond à la section du chemin d'accès au stockage d'objets après vm-images-bucket/.
    OPERATING_SYSTEM Système d'exploitation sur le disque à importer.
    DISK_SIZE Taille minimale d'un disque à créer avec cette image. Nous vous recommandons d'utiliser une mémoire tampon d'au moins 20% en plus de la taille du système de fichiers de l'image d'origine. Par exemple, utilisez au moins 12 Gio pour un disque virtuel dont la taille d'origine du système de fichiers est de 10 Gio.

  2. Surveillez la progression de l'importation en interrogeant l'état de l'objet VirtualMachineImageImport :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
  get virtualmachineimageimport --namespace PROJECT_ID \
  IMAGE_NAME -o jsonpath='{.status}'

Effectuer un nettoyage des ressources

Le processus d'importation implique l'importation de votre fichier de disque virtuel dans le stockage d'objets. Si vous utilisez gdcloud CLI, l'objet est nettoyé à la fin de la commande, qu'elle ait réussi ou non. Si la commande est interrompue ou si l'importation d'images est effectuée avec l'API, le fichier de disque virtuel peut rester dans le bucket de stockage d'objets nommé vm-images-bucket jusqu'à ce que vous le supprimiez manuellement.

Étape suivante

Créez une instance de VM qui utilise votre image sur la page, Créer et démarrer une VM.