Versión 1.9. Ya no se admite esta versión. Para obtener más información, consulta la política de asistencia de la versión. Para obtener información sobre cómo actualizar a la versión 1.10, consulta Actualiza Anthos en Bare Metal en la documentación de 1.10.

Versiones compatibles disponibles: 1.14 | 1.13 | 1.12

Trabaja con cargas de trabajo basadas en VM

En esta página, se muestra cómo implementar VM en clústeres de Anthos en equipos físicos mediante el entorno de ejecución de VM de Anthos. El entorno de ejecución de VM de Anthos usa KubeVirt para organizar las VM de los clústeres, lo que te permite trabajar con tus apps y cargas de trabajo basadas en VM en un entorno de desarrollo uniforme. Puedes habilitar el entorno de ejecución de VM de Anthos cuando creas un clúster nuevo y en clústeres existentes.

Antes de comenzar

En estas instrucciones, se supone que tienes un clúster en funcionamiento. De lo contrario, sigue las instrucciones de la guía de inicio rápido para clústeres de Anthos alojados en equipos físicos para configurar un clúster en tu estación de trabajo con rapidez.

Habilita el entorno de ejecución de VM de Anthos

Abre la configuración del clúster mediante la ejecución del siguiente comando:
```
kubectl --kubeconfig bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig edit cluster CLUSTER_NAME -n cluster-CLUSTER_NAME
```
Reemplaza CLUSTER_NAME por el nombre del clúster.
Agrega kubevirt a la sección spec de la configuración del clúster. Si el nodo admite la virtualización de hardware, establece useEmulation en false para obtener un mejor rendimiento. Si la virtualización de hardware no es compatible o no estás seguro, configúrala en true.
```
spec:
  anthosBareMetalVersion: 1.9.8
  kubevirt:
    useEmulation: true
  bypassPreflightCheck: false
```

Guarda la configuración y verifica que KubeVirt esté habilitado:

kubectl --kubeconfig bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig get pods -n kubevirt

Reemplaza CLUSTER_NAME por el nombre del clúster.

El comando muestra un resultado similar al siguiente:

NAME                              READY   STATUS    RESTARTS   AGE
virt-api-767bc4ccd5-56fk2         1/1     Running   0          11d
virt-api-767bc4ccd5-ms8tn         1/1     Running   0          11d
virt-controller-c8468c84c-l4dzr   1/1     Running   0          11d
virt-controller-c8468c84c-tljnj   1/1     Running   1          11d
virt-handler-6wk5v                1/1     Running   0          11d
virt-handler-ngth6                1/1     Running   0          11d
virt-operator-7447547957-c6g5d    1/1     Running   1          11d
virt-operator-7447547957-nl826    1/1     Running   0          11d

Instale `virtctl`

Instala la herramienta de la CLI virtctl como un complemento kubectl

export GOOGLE_APPLICATION_CREDENTIALS="bm-gcr.json"
sudo -E ./bmctl install virtctl

Verifica que virtctl esté instalado:
```
kubectl plugin list
```
virtctl se instaló correctamente si aparece en la respuesta.

Cree una VM

Una vez que habilites KubeVirt en tu clúster e instales el complemento virtctl para kubectl, puedes comenzar a crear VM en tu clúster con el comando kubectl virt create vm. Antes de ejecutar este comando, te recomendamos configurar un archivo cloud-init para asegurarte de tener acceso de consola a la VM una vez creada.

Crea un archivo cloud-init personalizado para el acceso a la consola

Hay dos formas de crear un archivo cloud-init personalizado. La forma más sencilla es especificar la marca --os=<OPERATING_SYSTEM> cuando se crea la VM. Este método configura automáticamente un archivo cloud-init simple y funciona para los siguientes sistemas operativos.

Ubuntu
En CentOS
Debian
Fedora

Una vez que se crea la VM, puedes acceder a ella por primera vez con las siguientes credenciales y, luego, cambiar la contraseña:

user: root
password: changeme

Si tu imagen contiene un SO diferente basado en Linux o necesitas una configuración más avanzada, puedes crear de forma manual un archivo cloud-init personalizado y especificar la ruta al archivo mediante la marca --cloud-init-file=<path/to/file>. En su forma más básica, el archivo cloud-init es un archivo YAML que contiene lo siguiente:

#cloud-config
user: root
password: changeme
lock_passwd: false
chpasswd: {expire: false}
disable_root: false
ssh_authorized_keys:
- <ssh-key>

Para obtener opciones de configuración más avanzadas, consulta los ejemplos de configuración de Cloud.

Una vez que hayas determinado qué método usar, estarás listo para crear una VM.

Ejecuta el comando `kubectl virt create vm`

Puedes crear VM a partir de imágenes públicas o personalizadas.

Imagen pública

Si tu clúster tiene una conexión externa, puedes crear una VM a partir de una imagen pública si ejecutas lo siguiente:

kubectl virt create vm VM_NAME \
    --boot-disk-access-mode=MODE \
    --boot-disk-size=DISK_SIZE \
    --boot-disk-storage-class="DISK_CLASS" \
    --cloud-init-file=FILE_PATH \
    --cpu=CPU_NUMBER \
    --image=IMAGE_NAME \
    --memory=MEMORY_SIZE

Reemplaza lo siguiente:

VM_NAME por el nombre de la VM que deseas crear.
MODE por el modo de acceso del disco de arranque. Los valores posibles son ReadWriteOnce (predeterminado) o ReadWriteMany.
DISK_SIZE por el tamaño que deseas para el disco de arranque. El valor predeterminado es 20Gi.
DISK_CLASS por la clase de almacenamiento del disco de arranque. El valor predeterminado es local-shared. Para obtener una lista de las clases de almacenamiento disponibles, ejecuta kubectl get storageclass.
FILE_PATH por la ruta completa del archivo cloud-init personalizado. Según la imagen, es posible que se requiera para obtener acceso de consola a la VM después de crearla. Si planeas configurar el archivo cloud-init con la marca --os de forma automática, no especifiques la marca --cloud-init-file. Si especificas la marca --cloud-init-file, se ignorará la marca --os. Los valores aceptables para --os son ubuntu, centos, debian y fedora.
CPU_NUMBER por la cantidad de CPU que deseas configurar para la VM. El valor predeterminado es 1.
IMAGE_NAME por la imagen de VM, que puede ser ubuntu20.04 (predeterminado), centos8 o una URL de la imagen.
MEMORY_SIZE por el tamaño de memoria de la VM. El valor predeterminado es 4Gi.

Imagen personalizada

Cuando creas una VM a partir de una imagen personalizada, puedes especificar una imagen de un servidor de imágenes HTTP o una imagen almacenada de forma local.

Servidor de imágenes HTTP

Puedes configurar un servidor HTTP mediante Apache o nginx y subir la imagen personalizada a su carpeta expuesta. Luego, puedes crear una VM a partir de la imagen personalizada si ejecutas el siguiente comando:

kubectl virt create vm VM_NAME \
    --boot-disk-access-mode=DISK_ACCESS_MODE \
    --boot-disk-size=DISK_SIZE \
    --boot-disk-storage-class=DISK_CLASS \
    --cloud-init-file=FILE_PATH \
    --cpu=CPU_NUMBER \
    --image=http://SERVER_IP/IMAGE_NAME \
    --memory=MEMORY_SIZE

Reemplaza lo siguiente:

VM_NAME por el nombre de la VM que deseas crear.
DISK_ACCESS_MODE por el modo de acceso del disco de arranque. Los valores posibles son ReadWriteOnce (predeterminado) o ReadWriteMany.
DISK_SIZE por el tamaño que deseas para el disco de arranque. El valor predeterminado es 20Gi.
DISK_CLASS por la clase de almacenamiento del disco de arranque. El valor predeterminado es local-shared. Para obtener una lista de las clases de almacenamiento disponibles, ejecuta kubectl get storageclass.
FILE_PATH por la ruta completa del archivo cloud-init personalizado. Según la imagen, es posible que se requiera para obtener acceso de consola a la VM después de crearla. Si planeas configurar el archivo cloud-init con la marca --os de forma automática, no especifiques la marca --cloud-init-file. Si especificas la marca --cloud-init-file, se ignorará la marca --os. Los valores aceptables para --os son ubuntu, centos, debian y fedora.
CPU_NUMBER por la cantidad de CPU que deseas configurar para la VM. El valor predeterminado es 1.
SERVER_IP por la dirección IP del servidor que aloja la imagen.
IMAGE_NAME por el nombre del archivo de la imagen personalizada.
MEMORY_SIZE por el tamaño de memoria de la VM. El valor predeterminado es 4Gi.

Imagen almacenada de forma local

Puedes almacenar la imagen personalizada de forma local y crear una VM a partir de ella si ejecutas el siguiente comando:

kubectl virt create vm VM_NAME \
    --boot-disk-access-mode=DISK_ACCESS_MODE \
    --boot-disk-size=DISK_SIZE \
    --boot-disk-storage-class=DISK_CLASS \
    --cloud-init-file=FILE_PATH \
    --cpu=CPU_NUMBER \
    --image=IMAGE_PATH \
    --memory=MEMORY_SIZE \

Reemplaza lo siguiente:

VM_NAME por el nombre de la VM que deseas crear.
DISK_ACCESS_MODE por el modo de acceso del disco de arranque. Los valores posibles son ReadWriteOnce (predeterminado) o ReadWriteMany.
DISK_SIZE por el tamaño que deseas para el disco de arranque. El valor predeterminado es 20Gi.
DISK_CLASS por la clase de almacenamiento del disco de arranque. El valor predeterminado es local-shared.
FILE_PATH por la ruta completa del archivo cloud-init personalizado. Según la imagen, es posible que se requiera para obtener acceso de consola a la VM después de crearla. Si planeas configurar el archivo cloud-init con la marca --os de forma automática, no especifiques la marca --cloud-init-file. Si especificas la marca --cloud-init-file, se ignorará la marca --os. Los valores aceptables para --os son ubuntu, centos, debian y fedora.
CPU_NUMBER por la cantidad de CPU que deseas configurar para la VM. El valor predeterminado es 1.
IMAGE_PATH por la ruta de acceso del archivo local a la imagen personalizada.
MEMORY_SIZE por el tamaño de memoria de la VM. El valor predeterminado es 4Gi.

Cambia los valores predeterminados para las marcas

El comando kubectl virt create vm usa valores predeterminados para autocompletar marcas no especificadas cuando se ejecuta el comando. Para cambiar estos valores predeterminados, ejecuta el siguiente comando:

kubectl virt config default FLAG

Reemplaza FLAG por la marca del parámetro del que deseas cambiar el valor predeterminado.

Ejemplo: Con el siguiente comando, se cambia la configuración predeterminada de la CPU del valor predeterminado inicial de 1 a 2:

kubectl virt config default --cpu=2

Para obtener una lista de las marcas compatibles y sus valores predeterminados actuales, ejecuta lo siguiente:

kubectl virt config default -h

Los parámetros de configuración predeterminados se almacenan del lado del cliente como un archivo local llamado ~/.virtctl.default. También puedes cambiar la configuración predeterminada si editas este archivo.

Accede a tu VM

Puedes acceder a las VM mediante los siguientes métodos:

Acceso a Console

Para acceder a una VM desde Console, ejecuta el siguiente comando:

kubectl virt console VM_NAME

Reemplaza VM_NAME por el nombre de la VM a la que deseas acceder.

Acceso de VNC

Para acceder a una VM mediante VNC, ejecuta:

# This requires remote-viewer from the virt-viewer package and a graphical desktop from where you run virtctl
kubectl virt vnc VM_NAME

Reemplaza VM_NAME por el nombre de la VM a la que deseas acceder.

Acceso interno

Todos los otros pods en el clúster pueden acceder directamente a las direcciones IP de las VM de tu clúster. Para encontrar la dirección IP de una VM, ejecuta este comando:

kubectl get vmi VM_NAME

Reemplaza VM_NAME por el nombre de la VM a la que deseas acceder.

El comando muestra un resultado similar al siguiente:

NAME     AGE   PHASE     IP              NODENAME
vm1      13m   Running   192.168.1.194   upgi-bm002

Acceso externo

Las VM creadas en tu clúster tienen direcciones de red de pod a las que solo se puede acceder desde el clúster. Para acceder a las VM del clúster de forma externa, sigue estos pasos:

Expón la VM como un servicio de balanceador de cargas:
```
kubectl virt expose vm VM_NAME \
    --port=LB_PORT \
    --target-port=VM_PORT \
    --type=LoadBalancer \
    --name=SERVICE_NAME
```
Reemplaza lo siguiente:
- VM_NAME por el nombre de la VM a la que deseas acceder.
- LB_PORT por el puerto del servicio del balanceador de cargas que se expone.
- VM_PORT por el puerto en la VM al que deseas acceder a través del servicio del balanceador de cargas.
- SERVICE_NAME por el nombre que deseas darle a este servicio de balanceador de cargas.
Obtén la dirección IP externa del servicio del balanceador de cargas como sigue:
```
kubectl get svc SERVICE_NAME
```
Reemplaza SERVICE_NAME por el nombre del servicio del balanceador de cargas que expone la VM.

Puedes acceder al puerto de destino de la VM mediante la dirección IP que aparece en el campo EXTERNAL-IP de la respuesta.

Ejemplo

Si tienes una VM llamada galaxy a la que deseas acceder desde fuera del clúster mediante SSH, debes ejecutar lo siguiente:

kubectl virt expose vm galaxy \
   --port=25022 \
   --target-port=22 \
   --type=LoadBalancer \
   --name=galaxy-ssh

Obtén la dirección IP del balanceador de cargas:

kubectl get svc galaxy-ssh

El comando muestra un resultado similar al siguiente:

NAME        TYPE          CLUSTER-IP     EXTERNAL-IP   PORT(S)           AGE
galaxy-ssh  LoadBalancer  10.96.250.76   21.1.38.202   25000:30499/TCP   4m40s

Ahora puedes acceder a la VM mediante SSH a través de 21.1.38.202:25022 (VIP:port) desde fuera del clúster:

ssh root@21.1.38.202:22 -p 25022

Inspecciona los registros de la consola y la telemetría de VM

Los registros de la consola y la telemetría de VM se integraron en la consola de Google Cloud. La información de telemetría y los datos de registro son fundamentales para supervisar el estado de las VM y solucionar cualquier problema con las VM del clúster.

Telemetría de VM

En el panel Estado de VM de clústeres de Anthos, se proporcionan datos de telemetría activos para las VM del clúster.

Para ver información de telemetría de las VM de tu clúster, haz lo siguiente:

En la consola de Google Cloud, selecciona Monitoring o haz clic en el siguiente botón:

Ir a Monitoring
Selecciona Paneles.
Haz clic en Estado de VM de clústeres de Anthos en la lista Todos los paneles.

Registros de la consola de VM

Los registros de la consola en serie de VM se transmiten a Cloud Logging y se pueden ver en el Explorador de registros.

Explorador de registros que muestra datos de VM de clústeres de Anthos

Borra las VM y sus recursos

Borra solo la VM

kubectl virt delete vm VM_NAME

Reemplaza VM_NAME por el nombre de la VM que deseas borrar.

Borra solo los discos de VM

kubectl virt delete disk DISK_NAME

Reemplaza DISK_NAME por el nombre del disco que deseas borrar. Si intentas borrar un disco de una VM antes de borrarla, este se marcará para su eliminación pendiente de eliminación de la VM.

Borra VM y recursos

kubectl virt delete vm VM_NAME --all

Reemplaza VM_NAME por el nombre de la VM que deseas borrar.

Si deseas verificar los recursos que usa la VM que se borrarán, puedes especificar la marca --dry-run junto con --all.

Inhabilita el entorno de ejecución de VM de Anthos

Antes de inhabilitar el entorno de ejecución de VM de Anthos en un clúster, debes asegurarte de que todas las VM de ese clúster se hayan borrado. Inhabilitar el entorno de ejecución de VM de Anthos quita todas las implementaciones relacionadas con KubeVirt, como los pods y los servicios en los espacios de nombres de KubeVirt y CDI.

Verifica si hay VM existentes en el clúster.
```
kubectl get vm
```
Si el comando muestra que todavía hay VM en tu clúster, debes borrarlas antes de continuar.
Abre la configuración del clúster mediante la ejecución del siguiente comando:
```
kubectl --kubeconfig bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig edit cluster CLUSTER_NAME -n cluster-CLUSTER_NAME
```
Reemplaza CLUSTER_NAME por el nombre del clúster.

Quita kubevirt de la sección spec de la configuración del clúster.

spec:
  anthosBareMetalVersion: 1.9.8
  kubevirt:
    useEmulation: true
  bypassPreflightCheck: false

Guarde la configuración.

¿Qué sigue?

Obtén información sobre los problemas conocidos del entorno de ejecución de VM de Anthos.
Consulta la guía del usuario de KubeVirt.

Trabaja con cargas de trabajo basadas en VM

Antes de comenzar

Habilita el entorno de ejecución de VM de Anthos

Instale virtctl

Cree una VM

Crea un archivo cloud-init personalizado para el acceso a la consola

Ejecuta el comando kubectl virt create vm

Imagen pública

Imagen personalizada

Servidor de imágenes HTTP

Imagen almacenada de forma local

Cambia los valores predeterminados para las marcas

Accede a tu VM

Acceso a Console

Acceso de VNC

Acceso interno

Acceso externo

Ejemplo

Inspecciona los registros de la consola y la telemetría de VM

Telemetría de VM

Registros de la consola de VM

Borra las VM y sus recursos

Borra solo la VM

Borra solo los discos de VM

Borra VM y recursos

Inhabilita el entorno de ejecución de VM de Anthos

¿Qué sigue?

Instale `virtctl`

Ejecuta el comando `kubectl virt create vm`