Se connecter à des VM qui utilisent l'environnement d'exécution des VM sur GDC

Ce document est destiné aux propriétaires d'applications qui exécutent Google Distributed Cloud. Ce document explique comment se connecter à des machines virtuelles (VM) qui utilisent l'environnement d'exécution des VM sur GDC. Vous pouvez vous connecter directement aux VM à l'aide d'une adresse IP, ou en utilisant des outils intégrés pour l'accès SSH ou console.

Avant de commencer

Pour suivre les instructions de ce document, vous devez disposer des ressources suivantes :

Configurer un accès SSH sans mot de passe aux VM

L'accès SSH direct et sans mot de passe à votre VM est facilité par un agent invité installé par l'environnement d'exécution des VM sur GDC. Entre autres, l'agent invité installe et désactive les clés SSH. Cette fonctionnalité permet à un tunnel SSH d'accéder à votre VM depuis des clients situés en dehors du réseau du cluster.

Activer l'agent invité

Pour activer l'agent invité :

  1. Vérifiez votre ressource personnalisée VirtualMachine pour vérifier qu'elle est configurée pour activer l'agent invité :

    kubectl get gvm VM_NAME -o yaml --kubeconfig KUBECONFIG
    

    Le champ spec.osType doit être défini sur le système d'exploitation de votre VM, Linux ou Windows. La section spec.guestEnvironment ne doit pas être explicitement configurée comme vide. Si la section est configurée comme vide (guestEnvironment: {}), vous pouvez la supprimer entièrement pour activer l'agent invité.

    Votre ressource personnalisée VirtualMachine pour la VM à laquelle vous souhaitez accéder doit se présenter comme suit :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      name: sample-vm
    spec:
      compute:
        cpu:
          vcpus: 2
        memory:
          capacity: 4Gi
    ...
      osType: Linux
    ...
    
  2. Si nécessaire, utilisez kubectl edit pour mettre à jour la ressource personnalisée VirtualMachine.

  3. Pour vérifier que l'agent invité fonctionne, vérifiez le status de votre ressource personnalisée de VM :

    kubectl get gvm VM_NAME --kubeconfig KUBECONFIG
    

    Lorsque l'agent invité fonctionne, status: "True" s'affiche pour les conditions GuestEnvironmentEnabled et GuestEnvironmentDataSynced.

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      ...
      name: vm-sample-01
      ...
    status:
      conditions:
      - lastTransitionTime: "2022-10-05T22:40:26Z"
        message: ""
        observedGeneration: 1
        reason: UserConfiguration
        status: "True"
        type: GuestEnvironmentEnabled
      - lastTransitionTime: "2022-10-06T21:55:57Z"
        message: ""
        observedGeneration: 1
        reason: GuestEnvironmentDataSynced
        status: "True"
        type: GuestEnvironmentSynced
      ...
    

Activer l'accès SSH sans mot de passe

Pour activer l'accès SSH sans mot de passe pour votre VM, procédez comme suit :

  1. Créez un fichier manifeste VirtualMachineAccessRequest, tel que vm-access-request.yaml, dans l'éditeur de votre choix :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineAccessRequest
    metadata:
      name: VMAR_NAME
      namespace: VM_NAMESPACE
    spec:
      vm: VM_NAME
      user: USERNAME
      ssh:
        key: PUBLIC_SSH_KEY
        ttl: EXPIRATION_TIME
    

    Remplacez les éléments suivants :

    • VMAR_NAME : nom de la ressource de demande d'accès
    • VM_NAMESPACE : espace de noms de la VM à laquelle vous souhaitez accéder
    • VM_NAME : nom de la VM à laquelle vous souhaitez accéder
    • USERNAME : nom d'utilisateur de l'utilisateur qui accède à la VM
    • PUBLIC_SSH_KEY : clé publique pour l'accès SSH. Il s'agit généralement du contenu du fichier id_rsa.pub.
    • EXPIRATION_TIME : le champ ttl (durée de vie) spécifie la durée de validité de la clé SSH.

      Par exemple, si vous spécifiez 30m, la clé SSH expire au bout de 30 minutes.

      Cette option utilise les unités suivantes :

      • s pour les secondes
      • m pour les minutes
      • h pour les heures
      • d pour les jours
  2. Utilisez kubectl apply pour créer VirtualMachineAccessRequest à partir du fichier manifeste. Par exemple, si vous avez nommé votre fichier manifeste vm-access-request.yaml,

    kubectl apply -f MANIFEST --kubeconfig KUBECONFIG
    

    Remplacez les éléments suivants :

    • MANIFEST : nom du fichier manifeste de requête d'accès. Exemple :vm-access-request.yaml
    • KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster qui héberge la VM à laquelle vous accédez
  3. Pour vérifier que la configuration de votre requête d'accès a réussi, vérifiez l'état de VirtualMachineAccessRequest :

    kubectl get vmar VMAR_NAME -o yaml --kubeconfig KUBECONFIG
    

    Lorsque la configuration réussit, la section status inclut state: configured :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineAccessRequest
    metadata:
      ...
      annotations:
        kubectl.kubernetes.io/last-applied-configuration: |
          {"apiVersion":"vm.cluster.gke.io/v1","kind":"VirtualMachineAccessRequest",
          "metadata":{"annotations":{},"name":"vmar-sample","namespace":"default"},
          "spec":{"ssh":{"key":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQ...jMLHFc=
              sample-user@sample-host","ttl":"5h"},"user":"sample-user","vm":"vm-sample-01"}}
      creationTimestamp: "2022-10-06T21:55:57Z"
      finalizers:
      - vm.cluster.gke.io/vmar-finalizer
      generation: 2
      name: vmar-sample
      namespace: default
      resourceVersion: "13033921"
      uid: 282d72ad-f48d-4e89-af22-336940ac9f58
    spec:
      ssh:
        key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQ...jMLHFc= sample-user@sample-host
        ttl: 5m0s
      user: sample-user
      vm: vm-sample-01
    status:
      processedAt: "2022-10-06T21:55:57Z"
      state: configured
    

Désactiver l'agent invité

Lorsque vous créez une VM et que vous définissez le champ osType, l'agent invité est activé. Tant que cette fonctionnalité est en version preview, vous pouvez la désactiver en modifiant la ressource personnalisée VirtualMachine. La désactivation de l'agent invité désactive l'accès SSH sans mot de passe à votre VM.

Pour désactiver l'agent invité :

  1. Utilisez kubectl pour arrêter votre VM avant de modifier la configuration :

    kubectl virt stop VM_NAME --kubeconfig KUBECONFIG
    
  1. Modifiez votre ressource de VM :

    kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG
    
  2. Mettez à jour la configuration VirtualMachine pour ajouter explicitement une valeur spec.guestEnvironment vide :

    apiVersion: vm.cluster.gke.io/v1alpha1
    kind: VirtualMachine
    metadata:
      name: vm-example
      namespace: default
    spec:
      compute:
      ...
      osType: Linux
      guestEnvironment: {}
    
  3. Enregistrez et fermez le fichier manifeste mis à jour de la VM dans votre éditeur.

  4. Utilisez kubectl pour démarrer la VM :

    kubectl virt start VM_NAME --kubeconfig KUBECONFIG
    

Se connecter en utilisant une adresse IP

Si votre VM possède une adresse IP accessible et que vous disposez déjà des identifiants d'accès à la VM, vous pouvez vous connecter à l'aide d'un protocole tel que SSH, VNC ou RDP.

Se connecter via une adresse IP

Si vous pouvez vous connecter directement à l'adresse IP de votre VM, utilisez l'une des méthodes suivantes :

SSH

  1. Obtenez les détails de votre VM pour afficher son adresse IP :

    kubectl get gvm VM_NAME --namespace VM_NAMESPACE --kubeconfig KUBECONFIG
    

    Remplacez les valeurs suivantes :

    • VM_NAME : nom de votre VM.
    • VM_NAMESPACE : espace de noms de votre VM

    L'exemple de résultat suivant affiche les informations et l'adresse IP de la VM :

    NAME   STATUS    AGE   IP
    vm1    Running   7m    10.200.0.21
    
  2. Connectez-vous à votre VM à l'aide d'un client SSH :

    ssh USERNAME@IP_ADDRESS -i PATH_TO_KEY
    

    Remplacez les valeurs suivantes :

    • USERNAME : nom d'utilisateur d'un compte sur votre VM
    • IP_ADDRESS : adresse IP de votre VM obtenue à l'étape précédente
    • PATH_TO_KEY : chemin d'accès à la clé SSH privée

VNC ou RDP

Virtual Network Computing (VNC) et Remote Desktop Protocol (RDP) vous permettent d'accéder à votre VM via la console graphique. Lorsque vous utilisez une adresse IP, vous devez activer VNC ou RDP dans l'OS invité avant de pouvoir utiliser l'un d'entre eux pour vous connecter à la VM. Pour plus d'informations sur l'activation et l'utilisation de VNC ou de RDP, consultez la documentation de votre OS invité.

Pour vous connecter à la VM, vous avez également besoin d'identifiants existants, tels que ceux que vous définissez pour créer des identifiants utilisateur initiaux lors de la création d'une VM.

  1. Obtenez les détails de votre VM pour afficher son adresse IP :

    kubectl get gvm VM_NAME --namespace VM_NAMESPACE --kubeconfig KUBECONFIG
    

    Remplacez les valeurs suivantes :

    • VM_NAME : nom de votre VM.
    • VM_NAMESPACE : espace de noms de votre VM

    L'exemple de résultat suivant affiche les informations et l'adresse IP de la VM :

    NAME   STATUS    AGE   IP
    vm1    Running   7m    10.200.0.21
    
  2. Connectez-vous à l'adresse IP de votre VM obtenue à l'étape précédente en utilisant un outil client sur le port approprié (port VNC 5900 ou port RDP 3389 par exemple).

Se connecter via un service

Si votre VM se connecte à la VM pod-network par défaut et que vous ne pouvez pas communiquer directement avec l'adresse IP de votre VM, exposez la VM derrière un équilibreur de charge Service.

  1. Créez un fichier manifeste Service, tel que my-service-load-balancer.yaml, dans l'éditeur de votre choix :

    nano my-service-load-balancer.yaml
    
  2. Copiez et collez le fichier manifeste YAML suivant :

    apiVersion: v1
    kind: Service
    metadata:
      name: VM_NAME-service
    spec:
      selector:
        kubevirt/vm: VM_NAME
      ports:
      - name: PORT_NAME
        protocol: PROTOCOL_TYPE
        port: EXTERNAL_PORT
        targetPort: TARGET_PORT
      type: LoadBalancer
    

    Dans ce type de fichier manifeste Service, remplacez les valeurs suivantes :

    • VM_NAME : nom de votre VM à exposer pour un accès à distance.
    • PORT_NAME : nom de votre protocole, tel que ssh, vnc ou rdp.
    • PROTOCOL_TYPE : type de protocole, tel que tcp pour SSH et RDP, ou udp pour VNC.
    • EXTERNAL_PORT : numéro de port externe à exposer et que vous utilisez pour vous connecter.
    • TARGET_PORT : port cible, tel que 22 pour SSH
  3. Enregistrez et fermez le fichier manifeste Service dans votre éditeur.

  4. Créez Service en utilisant kubectl :

    kubectl apply -f my-service-load-balancer.yaml  --kubeconfig KUBECONFIG
    
  5. Obtenez l'adresse EXTERNAL-IP du service d'équilibrage de charge :

    kubectl get service VM_NAME-service --kubeconfig KUBECONFIG
    

    L'adresse IP de l'équilibreur de charge s'affiche, comme illustré dans l'exemple de résultat suivant :

    NAME          TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)        AGE
    vm1-service   LoadBalancer   172.26.232.167   10.200.0.51   22:31141/TCP   6d20h
    
  6. Connectez-vous à l'adresse EXTERNAL-IP de l'équilibreur de charge avec un protocole standard, par exemple via un client SSH :

    ssh USERNAME@LOAD_BALANCER_IP_ADDRESS  -i PATH_TO_KEY
    

    Remplacez les valeurs suivantes :

    • USERNAME : nom d'utilisateur d'un compte sur votre VM.
    • LOAD_BALANCER_IP_ADDRESS : adresse IP de votre équilibreur de charge.
    • PATH_TO_KEY : chemin d'accès à la clé SSH privée

Se connecter directement via SSH

Si votre client est connecté au même réseau physique que votre cluster Anthos sur nœuds Bare Metal et que vous n'avez pas besoin de vous connecter en SSH aux clusters, vous pouvez vous connecter en utilisant kubectl virt ssh.

  1. Pour utiliser SSH afin de vous connecter à une VM Linux à partir de la console avec le module complémentaire virtctl, procédez comme suit :

    kubectl virt ssh USERNAME@VM_NAME --namespace VM_NAMESPACE --kubeconfig KUBECONFIG
    

    Remplacez les valeurs suivantes :

    • USERNAME : nom d'utilisateur permettant d'accéder à votre VM. Ce compte est créé s'il n'existe pas sur la VM.
    • VM_NAME : nom de votre VM.
  2. Après vous être connecté à la VM via SSH et une fois que vous n'avez plus besoin de la connexion, quittez la session SSH :

    exit
    

Se connecter directement via la console

Si vous ne disposez pas d'une connectivité réseau directe à votre VM Linux pour l'accès SSH, connectez-vous à la console de la VM à l'aide de l'environnement d'exécution des VM sur la console GDC. Cette méthode ouvre une console série. Au moment de la connexion, une invite de commande s'affiche, et non une console graphique.

  1. Pour accéder à une VM Linux à partir de la console, utilisez le module complémentaire virtctl :

    kubectl virt console VM_NAME --kubeconfig KUBECONFIG
    

    Remplacez VM_NAME par le nom de votre VM.

    Lorsque vous y êtes invité, saisissez les identifiants d'utilisateur pour votre VM. Ces identifiants doivent exister sur la VM ou être appliqués au moment de sa création. Si nécessaire, consultez la section suivante pour créer des identifiants utilisateur initiaux lorsque vous créez une VM.

  2. Une fois que vous êtes connecté à la console de la VM et que vous n'avez plus besoin de la connexion, quittez la session et la console de la VM :

    Ctrl + ]
    

Se connecter directement via VNC

Vous pouvez utiliser la commande kubectl virt vnc pour ouvrir la console graphique de Virtual Network Computing (VNC) pour accéder à vos VM. Cette méthode fonctionne pour les VM exécutant un OS invité Windows ou Linux. Lorsque vous utilisez la commande kubectl virt vnc, l'environnement d'exécution de VM sur GDC ouvre VNC pour vous. Vous n'êtes donc pas obligé d'activer VNC dans le système d'exploitation invité.

Pour vous connecter à la VM, vous avez besoin d'identifiants existants, tels que ceux que vous définissez pour créer des identifiants utilisateur initiaux lors de la création d'une VM.

  1. Pour accéder à une VM à l'aide de VNC, utilisez le module complémentaire virtctl :

    kubectl virt vnc VM_NAME --kubeconfig KUBECONFIG
    

    Remplacez VM_NAME par le nom de votre VM.

    Lorsque vous y êtes invité, saisissez les identifiants d'utilisateur pour votre VM.

  2. Après vous être connecté à la session VNC de la VM et une fois que vous n'avez plus besoin de la connexion, déconnectez-vous de la VM pour fermer la connexion VNC.

Créer les identifiants utilisateur initiaux

Lorsque vous vous connectez à votre VM en utilisant la console, vous devez spécifier les identifiants d'utilisateur. Le processus de création des identifiants utilisateur initiaux diffère selon les systèmes d'exploitation invités Linux et Windows.

OS invité Linux

Pour les VM Linux, les identifiants utilisateur peuvent être intégrés à vos images personnalisées ou être spécifiés lorsque vous créez une VM.

  • Utilisez le paramètre --configure-initial-password avec la commande kubectl virt create :

    kubectl virt create vm VM_NAME \
        --image ubuntu20.04 \
        --os-type Linux \
        --configure-initial-password USERNAME:PASSWORD \
        --kubeconfig KUBECONFIG
    

    Remplacez les valeurs suivantes :

    • VM_NAME : nom de votre VM.
    • USERNAME : nom d'utilisateur du compte à créer sur la VM
    • PASSWORD : mot de passe du compte utilisateur

    Cet exemple de commande crée une VM Linux qui exécute Ubuntu 20.04. Il est recommandé de modifier les identifiants initiaux après vous être connecté à la VM.

OS invité Windows

Pour réinitialiser le mot de passe d'un utilisateur existant ou créer le mot de passe initial d'un nouvel utilisateur, procédez comme suit:

  1. Activez l'agent invité dans votre VM Windows:

    1. Configurez la VM pour activer l'agent invité.

    2. Utilisez VNC ou RDP pour vous connecter à la VM.

    3. Dans la VM, accédez au disque guest agent. Dans la plupart des cas, il s'agit du disque E:.

    4. Utilisez PowerShell pour exécuter install.ps1.

      Cette action installe et démarre l'agent invité. L'agent invité démarre automatiquement pour les redémarrages de VM suivants.

    5. Fermez la session à distance.

  2. Sur votre poste de travail administrateur, utilisez la commande suivante pour réinitialiser (ou définir si vous utilisez un nouveau nom d'utilisateur) le mot de passe de la VM Windows:

    kubectl virt reset-windows-password VM_NAME \
        --user=USERNAME \
        --namespace=VM_NAMESPACE
    

    Remplacez les éléments suivants :

    • VM_NAME : Nom de la VM.
    • USERNAME: nom d'utilisateur pour lequel vous souhaitez réinitialiser (ou définir) le mot de passe. S'il s'agit d'un nouveau nom d'utilisateur, la commande crée un compte Windows et définit le mot de passe initial.
    • VM_NAMESPACE : (facultatif) espace de noms de la VM. Cette option est facultative. S'il n'est pas spécifié, l'espace de noms par défaut, default, est utilisé.

    Pour réinitialiser (ou définir) le mot de passe sans invite de confirmation, utilisez l'option facultative --force. Lorsque vous utilisez l'option --force, l'invite vous informe des conséquences de la réinitialisation du mot de passe d'un compte existant. Sans l'indicateur --force, la commande vous invite à confirmer la réinitialisation du mot de passe avec le texte suivant:

    This command creates an account and sets an initial password for the
    user USERNAME if the account does not already exist.
    If the account already exists, resetting the password can cause the
    LOSS OF ENCRYPTED DATA secured with the current password, including
    files and stored passwords.
    
    Would you like to set or reset the password for USERNAME (Y/n)?
    

    Une fois que vous avez confirmé (ou forcé) la réinitialisation du mot de passe, la commande renvoie le nouveau mot de passe pour la VM et le nom d'utilisateur spécifiés:

    Resetting and retrieving password for USERNAME on VM_NAME
    
    vm_name:    VM_NAME
    username:   USERNAME
    password:   PASSWORD
    

Étapes suivantes