Importer des disques virtuels

Ce document décrit les étapes à suivre pour importer des images de disque de machine virtuelle (VM) dans Google Distributed Cloud (GDC) air-gapped.

Importez vos disques virtuels existants, souvent appelés disques de référence ou images de référence, dans Distributed Cloud pour gagner du temps et utilisez l'image obtenue pour créer des machines virtuelles. L'outil d'importation est compatible avec les formats d'image RAW et QCOW.

Ce document s'adresse aux développeurs des groupes d'administrateurs de plate-forme ou d'opérateurs d'applications qui créent des images de VM. Pour en savoir plus, consultez la documentation sur les audiences pour GDC sous air gap.

Avant de commencer

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

  • La gdcloud CLI est 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 (OS).

Demander des autorisations et un accès

Pour importer des images et effectuer les opérations sur les VM listées sur cette page, demandez à votre administrateur IAM de projet de vous accorder les rôles IAM suivants dans l'espace de noms du projet dans lequel réside la VM :

  • Administrateur VirtualMachine du projet (project-vm-admin) : gère les VM dans l'espace de noms du projet.

  • Lecteur de projet (project-viewer) : dispose d'un accès en lecture seule à toutes les ressources d'un espace de noms de projet.

Suivez la procédure pour valider votre accès.

Importer des disques virtuels

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.

Pour importer vos disques virtuels, utilisez la CLI gdcloud ou l'API Virtual Machine Manager.

gdcloud

La commande import vérifie que le disque dispose des packages nécessaires pour configurer les identifiants permettant de se connecter à l'instance à l'aide de Secure Shell (SSH) et du protocole RDP (Remote Desktop Protocol). Cela inclut l'environnement invité.

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

  • Pour créer une image bootable, utilisez la commande gdcloud compute images import :
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 comporter plus de 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 : OS du disque à importer.
  • TIMEOUT : durée maximale d'une importation avant qu'elle n'échoue avec le message "TIMEOUT". Par exemple, si vous spécifiez 2h, le processus échoue au bout de deux heures. Le délai avant expiration par défaut est de 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 durer plusieurs dizaines de minutes en fonction de la taille du disque.

API

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

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

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT_ID \
  apply -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: IMAGE_OS
    minimumDiskSize: DISK_SIZE
EOF

    Remplacez les variables suivantes :

    • 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/.
    • IMAGE_OS : OS du disque à importer.
    • DISK_SIZE : taille minimale requise pour créer un disque à partir de cette image. Utilisez une marge d'au moins 20 % en plus de la taille du système de fichiers de l'image d'origine. Par exemple, utilisez au moins 12G pour un disque virtuel dont la taille du système de fichiers d'origine est de 10 Go.

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

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT_ID \
  get virtualmachineimageimport.virtualmachine.gdc.goog IMAGE_NAME \
  -o jsonpath='{.status}'

Effectuer un nettoyage des ressources

Le processus d'importation consiste à importer le fichier de votre disque virtuel dans le stockage d'objets. Si vous utilisez la CLI gdcloud, l'objet est nettoyé à la fin de la commande, qu'elle ait réussi ou non. Si la commande est interrompue ou si vous importez l'image 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