Conéctate a una VM

Console

1. En el menú de navegación, haz clic en Virtual Machines > Instances.

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

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

gdcloud

Conéctate a una VM con SSH ejecutando el comando gdcloud compute ssh.

gdcloud compute ssh VM_NAME \
  --project=PROJECT_ID

Reemplaza las siguientes variables:

• VM_NAME: el nombre de la VM.
• PROJECT_ID: Es el ID del proyecto que contiene la VM.

Si estableciste propiedades predeterminadas para la CLI, puedes omitir la marca --project de este comando. Por ejemplo:

gdcloud compute ssh VM_NAME

API

Conéctate a una VM:

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

GDC recupera 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.

Completa los siguientes 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 estaciones de trabajo con SO, usa la utilidad ssh-keygen para crear un nuevo par de claves SSH. En la siguiente muestra 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
   

   Reemplaza las variables con las siguientes definiciones.

   Variable	Definición
   KEY_FILENAME	El nombre de tu archivo de claves 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 claves privadas en la ruta de acceso ~/.ssh/KEY_FILENAME y el archivo de claves públicas en la ruta de acceso ~/.ssh/KEY_FILENAME.pub.

   Una clave pública para el usuario, testuser, es similar al 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 actividad (TTL) para la clave.

   En el siguiente ejemplo, se usa un archivo access_request.yaml para otorgar 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
   

   Reemplaza las variables con las siguientes definiciones:

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

3. Crea la clave:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     create -f access_request.yaml
   

4. Sigue estos pasos para verificar el estado de tu solicitud de acceso:

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

   Reemplaza 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
   

   Reemplaza los siguientes valores:

   • PATH_TO_PRIVATE_KEY con la ruta de acceso al archivo de clave SSH privada que corresponde a la clave pública que agregaste a la VM.
   • USERNAME por el nombre de usuario que especificaste cuando creaste la llave SSH. Por ejemplo, cloudysanfrancisco_example_com o cloudysanfrancisco.
   • EXTERNAL_IP con la dirección IP externa del Ingress de la VM.

Soluciona problemas

En esta sección, se describe cómo solucionar los problemas que pueden ocurrir cuando te conectas a una instancia de VM después de crear la solicitud de acceso.

Sigue estos pasos para identificar posibles problemas:

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

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

   Si la VM no está en ejecución, no podrás conectarte ni configurar solicitudes nuevas.

2. Verifica que la VM se haya ejecutado durante unos minutos. Si la VM acaba de iniciarse, es posible que los servicios necesarios para el acceso SSH aún no se estén ejecutando. Por lo general, se ejecutan dentro de los cinco minutos posteriores al inicio.

3. Verifica que no hayas superado el valor de TTL en la solicitud de acceso. La clave se quita después de que el tiempo alcanza el valor de TTL.

4. Si tu VirtualMachineAccessRequest muestra el estado configured, verifica los siguientes requisitos:

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

5. Si tu VirtualMachineAccessRequest muestra el estado failed, consulta el estado completo y revisa el mensaje de error que indica qué causó la falla de la solicitud:

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

   Reemplaza las variables editables en el comando anterior por tus propios valores.

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