Connettiti a VM che utilizzano Anthos VM Runtime

Version 1.13 

• Più recente
• Versione 1.16
• Versioni precedenti (non supportate)

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questo documento è destinato ai proprietari di applicazioni che eseguono cluster Anthos su Bare Metal. Questo documento mostra come connettersi a macchine virtuali (VM) che utilizzano Anthos VM Runtime. Puoi connetterti alle VM direttamente utilizzando un indirizzo IP oppure utilizzando strumenti integrati per l'accesso SSH o console.

Prima di iniziare

Per completare questo documento, devi accedere alle seguenti risorse:

• Una VM in esecuzione in uno dei tuoi cluster. Se necessario, crea una VM in Cluster Anthos on bare metal.
• Lo strumento client virtctl è stato installato come plug-in per kubectl. Se necessario, installa lo strumento client Virtctl.

Configura l'accesso SSH senza password alle VM

L'accesso SSH diretto e senza password alla tua VM è facilitato da un agente guest installato da Anthos VM Runtime. Tra le altre cose, l'agente guest installa e fa scadere le chiavi SSH. Questa funzionalità abilita un tunnel SSH per accedere alla VM da client esterni alla rete del cluster.

Abilita l'agente guest

Per abilitare l'agente ospite:

Nota: per i sistemi operativi Windows Windows, sono necessari ulteriori passaggi per l'avvio iniziale dell'agente guest. Per le istruzioni, consulta la scheda del sistema operativo guest di Windows in Creare credenziali utente iniziali.

1. Controlla la tua risorsa personalizzata VirtualMachine per verificare che sia configurata per abilitare l'agente guest:

   kubectl get gvm VM_NAME -o yaml --kubeconfig KUBECONFIG
   

   Il campo spec.osType deve essere impostato sul sistema operativo della tua VM, Linux o Windows. La sezione spec.guestEnvironment non deve essere esplicitamente configurata come vuota. Se la sezione è configurata come vuota (guestEnvironment: {}), puoi rimuoverla completamente per abilitare l'agente ospite.

   La tua risorsa personalizzata VirtualMachine per la VM a cui vuoi accedere dovrebbe essere simile alla seguente:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachine
   metadata:
     name: sample-vm
   spec:
     compute:
       cpu:
         vcpus: 2
       memory:
         capacity: 4Gi
   ...
     osType: Linux
   ...
   

2. Se necessario, utilizza kubectl edit per aggiornare la risorsa personalizzata VirtualMachine.

3. Per verificare che l'agente guest funzioni, controlla il status nella risorsa personalizzata VM:

   kubectl get gvm VM_NAME --kubeconfig KUBECONFIG
   

   Quando l'agente guest funziona, viene visualizzato status: "True" per le condizioni GuestEnvironmentEnabled e 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
     ...
   

Abilita accesso SSH senza password

Per abilitare l'accesso SSH senza password per la tua VM:

1. Crea un file manifest VirtualMachineAccessRequest, ad esempio vm-access-request.yaml, nell'editor che preferisci:

   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
   

   Sostituisci quanto segue:

   • VMAR_NAME: il nome della risorsa di richiesta di accesso.
   • VM_NAMESPACE: lo spazio dei nomi per la VM a cui vuoi accedere.
   • VM_NAME: il nome della VM a cui vuoi accedere.
   • USERNAME: il nome utente per l'utente che accede alla VM.
   • PUBLIC_SSH_KEY: la chiave pubblica per l'accesso SSH. In genere, questi sono i contenuti del file id_rsa.pub.

   • EXPIRATION_TIME: il campo ttl (time-to-live) specifica per quanto tempo la chiave SSH è valida.

     Ad esempio, se specifichi 30m, la chiave SSH scade dopo 30 minuti.

     Questo flag utilizza le seguenti unità:

     • s per secondi
     • m per minuti
     • h per orari
     • d per giorni

2. Usa kubectl apply per creare VirtualMachineAccessRequest dal file manifest. Ad esempio, se hai denominato il file manifest vm-access-request.yaml,

   kubectl apply -f MANIFEST --kubeconfig KUBECONFIG
   

   Sostituisci quanto segue:

   • MANIFEST: il nome del file manifest della richiesta di accesso. Ad esempio, vm-access-request.yaml.
   • KUBECONFIG: il percorso del file kubeconfig del cluster che ospita la VM a cui stai accedendo.

3. Per verificare che la configurazione della richiesta di accesso sia andata a buon fine, controlla lo stato dell'VirtualMachineAccessRequest:

   kubectl get vmar VMAR_NAME -o yaml --kubeconfig KUBECONFIG
   

   Se la configurazione ha esito positivo, la sezione status include 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
   

Disattiva l'agente ospite

Quando crei una nuova VM e imposti il campo osType, l'agente guest è abilitato. Quando questa funzionalità è in anteprima, puoi disabilitarla modificando la risorsa personalizzata VirtualMachine. La disabilitazione dello user agent disabilita l'accesso SSH senza password alla VM.

Nota: le funzionalità indicate come Anteprima sono regolate dai Termini delle Offerte pre-GA dei Termini di servizio di Google Cloud. Il supporto e i prodotti pre-GA potrebbero avere supporto limitato e le modifiche a prodotti e funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. Le offerte in anteprima sono destinate esclusivamente all'utilizzo in ambienti di test.

Per disattivare l'agente ospite:

1. Utilizza kubectl per arrestare la VM prima di apportare modifiche alla configurazione:

   kubectl virt stop VM_NAME --kubeconfig KUBECONFIG
   

1. Modifica la risorsa VM:

   kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG
   

2. Aggiorna la configurazione VirtualMachine per aggiungere esplicitamente un elemento spec.guestEnvironment vuoto:

   apiVersion: vm.cluster.gke.io/v1alpha1
   kind: VirtualMachine
   metadata:
     name: vm-example
     namespace: default
   spec:
     compute:
     ...
     osType: Linux
     guestEnvironment: {}
   

3. Salva e chiudi il manifest della VM aggiornato nell'editor.

4. Usa kubectl per avviare la VM:

   kubectl virt start VM_NAME --kubeconfig KUBECONFIG
   

Connettiti utilizzando un indirizzo IP

Se la tua VM ha un indirizzo IP accessibile e hai già le credenziali per accedervi, puoi connetterti utilizzando un protocollo come SSH, VNC o RDP.

Connessione tramite indirizzo IP

Se riesci a connetterti direttamente all'indirizzo IP della tua VM, utilizza uno dei seguenti metodi:

SSH

1. Ottieni i dettagli della tua VM per visualizzarne l'indirizzo IP:

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

   Sostituisci i seguenti valori:

   • VM_NAME: nome della VM.
   • VM_NAMESPACE: lo spazio dei nomi per la tua VM.

   L'output di esempio seguente mostra le informazioni sulla VM e l'indirizzo IP:

   NAME   STATUS    AGE   IP
   vm1    Running   7m    10.200.0.21
   

2. Connettiti alla VM utilizzando un client SSH:

   ssh USERNAME@IP_ADDRESS -i PATH_TO_KEY
   

   Sostituisci i seguenti valori:

   • USERNAME: il nome utente di un account sulla VM.
   • IP_ADDRESS: l'indirizzo IP della tua VM ottenuto nel passaggio precedente.
   • PATH_TO_KEY: il percorso della chiave SSH privata.

VNC o RDP

VNC (Virtual Network Computing) e RDP (Remote Desktop Protocol) ti consentono di utilizzare la console grafica per accedere alla VM. Quando usi un indirizzo IP, devi abilitare VNC o RDP nel sistema operativo guest prima di poterli utilizzare per la connessione alla VM. Per informazioni sull'attivazione e l'utilizzo di VNC o RDP, consulta la documentazione del sistema operativo guest.

Devi disporre anche delle credenziali esistenti per accedere alla VM, ad esempio quelle che definisci per creare le credenziali utente iniziali quando crei una VM.

1. Ottieni i dettagli della tua VM per visualizzarne l'indirizzo IP:

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

   Sostituisci i seguenti valori:

   • VM_NAME: nome della VM.
   • VM_NAMESPACE: lo spazio dei nomi per la tua VM.

   L'output di esempio seguente mostra le informazioni sulla VM e l'indirizzo IP:

   NAME   STATUS    AGE   IP
   vm1    Running   7m    10.200.0.21
   

2. Connettiti all'indirizzo IP della tua VM ottenuto nel passaggio precedente utilizzando uno strumento client e la porta appropriata come la porta VNC 5900 o la porta RDP 3389.

Connessione tramite un servizio

Se la tua VM si connette al valore predefinito pod-network e non riesci a comunicare direttamente con l'indirizzo IP della VM, esponi la VM dietro un bilanciatore del carico Service.

1. Crea un manifest Service, ad esempio my-service-load-balancer.yaml, nell'editor che preferisci:

   nano my-service-load-balancer.yaml
   

2. Copia e incolla il seguente manifest YAML:

   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
   

   In questo tipo di manifest Service, sostituisci i seguenti valori:

   • VM_NAME: il nome della VM a cui esporre l'accesso remoto.
   • PORT_NAME: il nome del protocollo, ad esempio ssh, vnc o rdp.
   • PROTOCOL_TYPE: il tipo di protocollo, ad esempio tcp per SSH e RDP oppure udp per VNC.
   • EXTERNAL_PORT: il numero della porta esterna da esporre e che utilizzi per connetterti.
   • TARGET_PORT: la porta di destinazione, ad esempio 22 per SSH.

3. Salva e chiudi il manifest Service nell'editor.

4. Crea Service utilizzando kubectl:

   kubectl apply -f my-service-load-balancer.yaml  --kubeconfig KUBECONFIG
   

5. Ottieni l'indirizzo EXTERNAL-IP del servizio bilanciatore del carico:

   kubectl get service VM_NAME-service --kubeconfig KUBECONFIG
   

   Viene visualizzato l'indirizzo IP del bilanciatore del carico, come illustrato nell'output di esempio seguente:

   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. Connettiti all'indirizzo EXTERNAL-IP del bilanciatore del carico con un protocollo standard, ad esempio utilizzando un client SSH:

   ssh USERNAME@LOAD_BALANCER_IP_ADDRESS  -i PATH_TO_KEY
   

   Sostituisci i seguenti valori:

   • USERNAME: il nome utente di un account sulla VM.
   • LOAD_BALANCER_IP_ADDRESS: l'indirizzo IP del bilanciatore del carico.
   • PATH_TO_KEY: il percorso della chiave SSH privata.

Connettiti direttamente tramite SSH

Se il client è connesso alla stessa rete fisica del tuo cluster Anthos su nodi Bare Metal e non hai bisogno dell'utilizzo di tunnel SSH per connetterti al cluster, puoi connetterti utilizzando kubectl virt ssh.

1. Per usare SSH per connettere una VM Linux dalla console con il componente aggiuntivo virtctl:

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

   Sostituisci i seguenti valori:

   • USERNAME: il nome utente per accedere alla tua VM. Questo account viene creato se non esiste nella VM.
   • VM_NAME: il nome della tua VM.

2. Una volta stabilita la connessione tramite SSH, la VM e la connessione non sono più necessarie, esci dalla sessione SSH:

   exit
   

Connettiti direttamente tramite la console

Se non hai connettività di rete diretta alla VM Linux per l'accesso SSH, connettiti alla console della VM utilizzando la VM Runtime di Anthos Console. Questo metodo apre una console seriale. Al momento della connessione, ti viene chiesto un comando, anziché una console grafica.

1. Per accedere a una VM Linux dalla console, utilizza il componente aggiuntivo virtctl:

   kubectl virt console VM_NAME --kubeconfig KUBECONFIG
   

   Sostituisci VM_NAME con il nome della tua VM.

   Quando richiesto, inserisci le credenziali utente della tua VM. Queste credenziali devono esistere nella VM oppure essere applicate quando viene creata la VM. Se necessario, consulta la sezione seguente per creare le credenziali utente iniziali quando crei una VM.

2. Dopo aver effettuato il collegamento alla console della VM e aver bisogno della connessione, esci dalla sessione VM e dalla console:

   Ctrl + ]
   

Connessione diretta tramite VNC

Puoi utilizzare il comando kubectl virt vnc per aprire la console grafica Virtual Network Computing (VNC) per accedere alle VM. Questo metodo funziona per le VM che eseguono un sistema operativo guest Windows o Linux. Quando utilizzi il comando kubectl virt vnc, Anthos VM Runtime apre automaticamente la VNC, quindi non è necessario abilitarla nel sistema operativo guest.

Devi disporre di credenziali esistenti per accedere alla VM, ad esempio quelle che definisci per creare le credenziali utente iniziali quando crei una VM.

1. Per accedere a una VM tramite VNC, utilizza il componente aggiuntivo virtctl:

   kubectl virt vnc VM_NAME --kubeconfig KUBECONFIG
   

   Sostituisci VM_NAME con il nome della tua VM.

   Quando richiesto, inserisci le credenziali utente della tua VM.

2. Una volta stabilita la connessione alla sessione VNC della VM e una connessione non è più necessaria, disconnettiti dalla VM per chiudere la connessione VNC.

Crea credenziali utente iniziali

Quando ti connetti alla VM utilizzando la console, devi specificare le credenziali utente. Il processo di creazione delle credenziali utente iniziali è diverso per i sistemi operativi guest Linux e Windows.

Sistema operativo guest Linux

Per le VM Linux, le credenziali utente possono essere integrate nelle immagini personalizzate oppure specificate quando crei una VM.

• Utilizza il parametro --configure-initial-password con il comando kubectl virt create:

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

  Sostituisci i seguenti valori:

  • VM_NAME: nome della VM.
  • USERNAME: nome utente dell'account da creare sulla VM.
  • PASSWORD: password dell'account utente.

  Questo comando di esempio crea una VM Linux che esegue Ubuntu 20.04. Ti consigliamo di modificare le credenziali iniziali dopo aver effettuato l'accesso alla VM per la prima volta.

Nota: per modificare le credenziali su una VM esistente, connettiti alla VM utilizzando kubectl virt console VM_NAME e quindi aggiorna le credenziali all'interno del sistema operativo guest.

Sistema operativo guest Windows

Segui questi passaggi per reimpostare una password per un utente esistente o per creare la password iniziale per un nuovo utente:

1. Attiva l'agente guest nella VM Windows:

   1. Configura la VM per abilitare l'agente ospite.

   2. Utilizza VNC o RDP per connetterti alla VM.

   3. Nella VM, vai all'unità guest agent. Nella maggior parte dei casi, questo è Drive E:.

   4. Usa PowerShell per eseguire install.ps1.

      L'installazione e l'avvio dell'agente ospite vengono avviate. Lo user agent si avvia automaticamente per i successivi riavvii delle VM.

   5. Chiudi la sessione remota.

2. Nella workstation di amministrazione, utilizza il comando seguente per reimpostare (o impostare se utilizzare un nuovo nome utente) la password della VM Windows:

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

   Sostituisci quanto segue:

   • VM_NAME: il nome della VM.
   • USERNAME: il nome utente per cui vuoi reimpostare (o impostare) la password. Se il nome utente è nuovo, il comando crea un nuovo account Windows e imposta la password iniziale.
   • VM_NAMESPACE: (facoltativo) lo spazio dei nomi della VM. Il flag è facoltativo. Se non è specificato, viene utilizzato lo spazio dei nomi predefinito default.

   Per reimpostare (o impostare) la password senza richiesta di conferma, utilizza il flag facoltativo --force. Quando usi il flag --force, la richiesta ti avvisa delle conseguenze della reimpostazione della password per un account esistente. Senza il flag --force, il comando ti chiede di confermare la reimpostazione della password con il seguente testo:

   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)?
   

   Dopo aver confermato (o forzato) la reimpostazione della password, il comando restituisce la nuova password per la VM e il nome utente specificati:

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

Passaggi successivi

• Gestisci lo stato di alimentazione di una VM in Cluster Anthos on bare metal.
• Modifica una VM in Cluster Anthos on bare metal.
• Visualizza i log della console VM in Cluster Anthos on bare metal.