Conectarse a una VM

Consola

1. En el menú de navegación, haz clic en Máquinas virtuales > Instancias.

2. En la lista de VMs, busca la fila de la VM en ejecución a la que quieras conectarte. En la columna Conectar, haz clic en SSH.

3. Se abrirá una terminal del navegador SSH. Introduce cualquier comando en el shell o haz clic en FTP para desplazarte por la estructura de archivos y subir archivos.

gdcloud

Conectarse a una VM mediante SSH ejecutando el comando gdcloud compute ssh

gdcloud compute ssh VM_NAME --project=PROJECT_ID

Sustituye las siguientes variables:

• VM_NAME: el nombre de la VM.
• PROJECT_ID: el ID del proyecto que contiene la máquina virtual.

Si has definido propiedades predeterminadas para la CLI, puedes omitir la marca --project en este comando. Por ejemplo:

gdcloud compute ssh VM_NAME

API

Conéctate a una VM:

• Abre la terminal.
• Crea un par de claves SSH.
• Sube la clave pública y el nombre de usuario con un valor de tiempo de vida (TTL).

GDC obtiene la clave SSH y el nombre de usuario, y crea una cuenta de usuario con el nombre de usuario. En las VMs, GDC almacena la clave pública en el archivo ~/.ssh/authorized_keys del usuario en la VM.

Sigue estos pasos para conectarte a una VM desde la línea de comandos:

1. Crea un par de claves SSH y un nombre de usuario.

   En las estaciones de trabajo con SO, usa la utilidad ssh-keygen para crear un par de claves SSH. En el siguiente ejemplo de código se crea un par de claves RSA (Rivest–Shamir–Adleman):

   ssh-keygen -t rsa -f ~/.ssh/KEY_FILENAME -C USERNAME -b 2048
   

   Sustituye las variables por las siguientes definiciones.

   Variable	Definición
   KEY_FILENAME	El nombre del archivo de clave SSH. Por ejemplo, el nombre de archivo my-ssh-key genera un archivo de clave privada llamado my-ssh-key y un archivo de clave pública llamado my-ssh-key.pub.
   USERNAME	Tu nombre de usuario en la VM, como testuser o testuser_gmail_com.

   La utilidad ssh-keygen guarda el archivo de clave privada en la ruta ~/.ssh/KEY_FILENAME y el archivo de clave pública en la ruta ~/.ssh/KEY_FILENAME.pub.

   La clave pública del usuario, testuser, es similar a la del siguiente ejemplo:

   ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF... testuser
   

2. Sube tu clave a la VM y crea un recurso de Kubernetes con tu clave pública, nombre de usuario y valor de tiempo de vida (TTL) de la clave.

   En el siguiente ejemplo se usa un archivo access_request.yaml para conceder acceso a la instancia de VM con la clave privada KEY_FILENAME y un valor de TTL de diez minutos:

   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineAccessRequest
   metadata:
     namespace: VM_NAMESPACE
     name: AR_NAME
   spec:
     ssh:
       key: |
         ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF... cloudysanfrancisco
       ttl: 10m
     user: USERNAME
     vm: VM_NAME
   

   Sustituye las variables con las siguientes definiciones:

   Variable	Definición
   VM_NAMESPACE	Espacio de nombres de la VM.
   AR_NAME	Nombre de la solicitud de acceso.
   USERNAME	Tu nombre de usuario en la VM, como testuser o testuser_gmail_com.
   VM_NAME	Nombre de la instancia de VM.

3. Crea la clave:

   kubectl create -f access_request.yaml --kubeconfig MANAGEMENT_API_SERVER
   

4. Para comprobar el estado de tu solicitud de acceso, sigue estos pasos:

   kubectl get virtualmachineaccessrequests.virtualmachine.gdc.goog -n VM_NAMESPACE --kubeconfig MANAGEMENT_API_SERVER
   

   Sustituye VM_NAMESPACE por el espacio de nombres de la VM.

   El estado configured indica que puedes conectarte a la VM.

5. Conéctate a la VM:

   ssh -i PATH_TO_PRIVATE_KEY USERNAME@EXTERNAL_IP
   

   Sustituye los siguientes valores:

   • PATH_TO_PRIVATE_KEY con la ruta al archivo de clave SSH privada que corresponde a la clave pública que has añadido a la VM.
   • USERNAME con el nombre de usuario que especificaste al crear la clave SSH. Por ejemplo, cloudysanfrancisco_example_com o cloudysanfrancisco.
   • EXTERNAL_IP con la dirección IP de entrada externa de la VM.

Solución de problemas

En esta sección se describe cómo solucionar los problemas que pueden surgir al conectarse a una instancia de VM después de crear la solicitud de acceso.

Sigue estos pasos para identificar posibles problemas:

1. Comprueba que la VM se esté ejecutando. Sustituye las variables editables por tus valores en el siguiente comando:

   kubectl get virtualmachines.virtualmachine.gdc.goog VM_NAME -n VM_NAMESPACE --kubeconfig MANAGEMENT_API_SERVER
   

   Si la VM no se está ejecutando, no podrás conectarte ni configurar nuevas solicitudes.

2. Comprueba que la VM se haya ejecutado durante unos minutos. Si la VM acaba de iniciarse, es posible que los servicios necesarios para acceder por SSH aún no se estén ejecutando. Normalmente, se ejecutan en los cinco minutos posteriores al arranque.

3. Comprueba que no hayas superado el valor de TTL en la solicitud de acceso. La clave se elimina cuando el tiempo alcanza el valor de TTL.

4. Si tu VirtualMachineAccessRequest muestra el estado configured, comprueba que se cumplen los siguientes requisitos:

   1. Has habilitado la transferencia de datos a tu VM en el puerto 22.
   2. Tu máquina se dirige a la VM. Por ejemplo, puedes usar el comando
      curl -vso /dev/null --connect-timeout 5 EXTERNAL_IP:22 para comprobar el enrutamiento.

5. Si tu VirtualMachineAccessRequest muestra el estado failed, consulta el estado completo y revisa el mensaje de error que indica por qué no se ha podido completar la solicitud:

   kubectl describe virtualmachineaccessrequest.virtualmachine.gdc.goog AR_NAME -n VM_NAMESPACE --kubeconfig MANAGEMENT_API_SERVER
   

   Sustituye las variables editables del comando anterior por tus propios valores.

6. Si el estado de tu VirtualMachineAccessRequest está en blanco, es posible que el entorno de invitado no se esté ejecutando.