Crea y administra discos virtuales en clústeres de Anthos alojados en equipos físicos

Este documento está dirigido a los propietarios de aplicaciones que ejecutan clústeres de Anthos en equipos físicos. En este documento, se muestra cómo crear y administrar recursos de discos para máquinas virtuales (VM) que usan el entorno de ejecución de VM de Anthos.

Antes de comenzar

Para completar este documento, necesitas acceso a los siguientes recursos:

Acceso a la versión 1.12.0 (anthosBareMetalVersion: 1.12.0) o superior de los clústeres de Anthos alojados en equipos físicos. Puedes usar cualquier tipo de clúster capaz de ejecutar cargas de trabajo. Si es necesario, prueba los clústeres de Anthos alojados en equipos físicos en Compute Engine o consulta la descripción general de la creación de clústeres.
La herramienta de cliente virtctl instalada como un complemento para kubectl. Si es necesario, instala la herramienta cliente de virtctl.

Crea una VM con un disco conectado

Cuando creas una VM, puedes conectar un disco de arranque o de datos existente, crear un disco a partir de una imagen (incluido el disco de arranque) o crear un disco en blanco.

Disco en blanco

En esta situación, debes crear un disco en blanco y conectarlo a la VM. Esta situación te permite crear un disco de datos para almacenar datos de la aplicación.

Crea un manifiesto que defina un VirtualMachineDisk y VirtualMachine, como my-vm.yaml, en el editor que elijas:
```
nano my-vm.yaml
```
Copia y pega la siguiente definición de YAML:
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: DISK_NAME
spec:
  size: 10Gi
---
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: VM_NAME-boot-dv
    - virtualMachineDiskName: DISK_NAME
```
Reemplaza lo siguiente:
- DISK_NAME: Es el nombre del disco en blanco que creas y adjuntas a la VM.
  
  Nota: A partir de la versión 1.13.0 de Anthos en clústeres en Anthos, cuando creas una VM, Anthos VM Runtime establece los nombres de disco especificados con virtualMachineDiskName como el número de serie para el disco. Para obtener más información, consulta Ubica los discos.
- VM_NAME: Es el nombre de la VM que estás creando.
  
  En este ejemplo, se crea un disco 10Gi en blanco (10 gibibyte) llamado DISK_NAME. En la sección spec.disks de la VM, también debes adjuntar un disco de arranque, como a partir de una imagen tal como se muestra en la siguiente sección.
Guarda y cierra el archivo de manifiesto en tu editor.
Crea la VM y el disco con kubectl:
```
kubectl apply -f my-vm.yaml --kubeconfig KUBECONFIG
```
Reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster.

Desde la imagen

En esta situación, crearás un disco a partir de una imagen y lo conectará a la VM. Esta situación te permite crear un disco de arranque, por ejemplo, a partir de una imagen. También puedes crear y adjuntar discos de datos a partir de una imagen.

Fuentes de imágenes admitidas

Anthos VM Runtime permite una variedad de formatos de imagen y admite tres tipos de fuentes de imágenes que se pueden especificar en la especificación VirtualMachineDisk. Cada uno de los siguientes ejemplos crea un disco de 20 gibibytes a partir de una fuente de imagen compatible diferente.

Protocolo de transferencia de hipertexto (HTTP)

En el siguiente ejemplo de VirtualMachineDisk, se muestra la estructura básica de una fuente de imagen HTTP. El campo url espera una URL HTTP o HTTPS.

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: my-disk
spec:
  source:
    http:
      url: https://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img
  size: 20GiB
  storageClassName: local-shared

Cloud Storage

En el siguiente ejemplo, se muestra cómo crear un disco a partir de una imagen en un bucket de Cloud Storage. Si las credenciales predeterminadas de la aplicación en la máquina no son suficientes para acceder a la URL de Cloud Storage, debes proporcionar credenciales. En el siguiente ejemplo, my-gcs es un secreto que contiene una clave de cuenta de servicio codificada en base64.
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: my-disk
spec:
  source:
    gcs:
      url: gs://kubevirt-ci-vm-images/rhel8.2/rhel8_2_cloud.qcow2
      secretRef: my-gcs
  size: 20GiB
  storageClassName: local-shared
```
Si usaste claves de cuenta de servicio descargadas para crear tu clúster, puedes usar la clave de cuenta de servicio de Container Registry para el acceso a Cloud Storage. Si creas una cuenta de servicio independiente para acceder a Cloud Storage, consulta Configura una cuenta de servicio que pueda acceder a un bucket de Cloud Storage.

Usa el siguiente comando para crear un secreto de Kubernetes a partir del archivo de claves de la cuenta de servicio descargado:
```
kubectl create secret generic SECRET_NAME --from-file=KEY_FILE --namespace default \
    --kubeconfig KUBECONFIG
```
Reemplaza lo siguiente:
- SECRET_NAME: Es el nombre de tu secreto.
- KEY_FILE: Es la ruta al archivo JSON de claves de la cuenta de servicio descargado. Por ejemplo, bmctl-workspace/.sa-keys/my-project-anthos-baremetal-gcr.json
- KUBECONFIG: Es la ruta de acceso al archivo kubeconfig del clúster.
Si deseas obtener más información sobre el uso de credenciales para acceder a Cloud Storage, consulta Crea y usa credenciales para importar imágenes desde Cloud Storage.
Ejemplo de Container Registry

Se admiten los registros de contenedores que cumplan con las especificaciones de distribución de Open Container Initiative (OCI). En el siguiente ejemplo, se crea un disco a partir de una imagen almacenada en un registro de Docker.
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: my-disk
spec:
  source:
    registry:
      url: docker://kubevirt/fedora-cloud-registry-disk-demo
  size: 20GiB
  storageClassName: local-shared
```

Formatos válidos de imagen

Puedes usar cualquiera de los siguientes formatos de imagen cuando creas un disco a partir de una imagen:

Archivo ZIP de GNU (gzip) (.gz)
RAW (.raw, .img)
Copia de QEMU en la imagen de disco de la versión 2 de escritura (qcow2) (.qcow2)
Archivo comprimido en XZ (.xz)
Archivo de disco de máquina virtual (VMDK) (.vmdk)
Archivo de imagen de disco virtual de VirtualBox (VDI) (.vdi)
Archivo de imagen de disco duro virtual (VHD) (.vdh)
Archivo de versión de disco duro virtual 2 (VDHX) (.vdhx)
Archivo de imagen de disco ISO (.iso)

Ejemplo de un disco creado a partir de una imagen HTTP

Sigue estos pasos para crear un disco de arranque a partir de una imagen de Ubuntu:

Crea un manifiesto que defina VirtualMachineDisk y VirtualMachine, como my-vm.yaml, en el editor que elijas:
```
nano my-vm.yaml
```

Copia y pega la siguiente definición de YAML:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: VM_NAME-boot-dv
spec:
  size: 20Gi
  source:
    http:
      url: https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64.img
---
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: VM_NAME-boot-dv

En este ejemplo, se crea un disco 20Gi (20 gibibytes) llamado VM_NAME-boot-dv con una imagen pública de Ubuntu. En la sección spec.disks de la VM, el disco se establece en boot: true.

Guarda y cierra el manifiesto en tu editor.
Crea la VM y el disco con kubectl:
```
kubectl apply -f my-vm.yaml --kubeconfig KUBECONFIG
```
Reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster.

Disco existente

En esta situación, debes crear un disco en blanco y conectarlo a la VM. Esta situación te permite crear un disco de datos para almacenar datos de la aplicación.

Crea un manifiesto VirtualMachine, como my-vm.yaml, en el editor que elijas:
```
nano my-vm.yaml
```

Copia y pega la siguiente definición de YAML:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: VM_NAME-boot-dv
    - virtualMachineDiskName: EXISTING_DISK_NAME

En este ejemplo, se conecta un disco existente llamado EXISTING_DISK_NAME.

En la sección spec.disks de la VM, también debes adjuntar un disco de arranque, como a partir de una imagen tal como se muestra en la sección anterior.

Guarda y cierra el manifiesto de la VM en el editor.
Crea la VM mediante kubectl:
```
kubectl apply -f my-vm.yaml --kubeconfig KUBECONFIG
```
Reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster.

Ubica los discos

A partir de la versión 1.13.0 de los clústeres de Anthos en Bare Metal, cuando creas una VM, el entorno de ejecución de VM de Anthos usa los nombres de disco que especifiques en el recurso de VM para establecer los números de serie del disco. En particular, los nombres que especificas con spec.disks.virtualMachineDiskName en el recurso personalizado VirtualMachine se usan en el número de serie de los discos. Esta característica facilita la ubicación de tus discos en la VM cuando necesitas realizar operaciones de disco, como formatear o activar.

Por ejemplo, si creaste una VM y especificaste un disco de arranque llamado sample-boot-dv, tu recurso personalizado VirtualMachine se verá así:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: sample-vm
spec:
  osType: Linux
  compute:
    cpu:
      vcpus: 2
    memory:
      capacity: 4Gi
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: sample-vm-boot-dv
    - virtualMachineDiskName: attached-disk

En las VM de Linux, cuando accedes a la VM, puedes ejecutar el siguiente comando para enumerar los discos según su número de serie:

ls -l /dev/disk/by-id/

La respuesta debería ser similar a este resultado de ejemplo, en el que los nombres de disco aparecen como números de serie:

total 0
lrwxrwxrwx 1 root root  9 Oct 19 17:17 ata-QEMU_HARDDISK_agentInstallation -> ../../sdb
lrwxrwxrwx 1 root root  9 Oct 19 17:17 ata-QEMU_HARDDISK_agentSADisk -> ../../sda
lrwxrwxrwx 1 root root  9 Oct 19 17:17 virtio-sample-boot-dv -> ../../vda
lrwxrwxrwx 1 root root 10 Oct 19 17:17 virtio-sample-boot-dv-part1 -> ../../vda1
lrwxrwxrwx 1 root root 11 Oct 19 17:17 virtio-sample-boot-dv-part14 -> ../../vda14
lrwxrwxrwx 1 root root 11 Oct 19 17:17 virtio-sample-boot-dv-part15 -> ../../vda15
lrwxrwxrwx 1 root root 11 Oct 19 17:17 virtio-attached-disk -> ../../vdb

Ten en cuenta el siguiente comportamiento de funciones:

Si el valor virtualMachineDiskName tiene más de 20 caracteres, el entorno de ejecución de la VM de Anthos usa solo los primeros 20 caracteres como número de serie.
Si hay dos discos con los mismos 20 caracteres, solo el primer disco tendrá un número de serie.

Crea y conecta discos a la VM existente

Si tienes una VM existente, puedes crear y adjuntar discos para respaldar los ciclos de vida de las aplicaciones. La VM debe estar detenida antes de conectar un disco.

Disco en blanco

En esta situación, debes crear un disco en blanco y conectarlo a la VM. Esta situación te permite crear un disco de datos para almacenar datos de la aplicación.

Usa kubectl para detener la VM, si es necesario:
```
kubectl virt stop vm VM_NAME --kubeconfig KUBECONFIG
```
Reemplaza lo siguiente:
- VM_NAME: Es el nombre de la VM que deseas detener.
- KUBECONFIG: Es la ruta al archivo kubeconfig del clúster.

Edita el recurso de VM existente, como my-vm:

kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG

Actualiza el manifiesto YAML VirtualMachine para agregar una sección VirtualMachineDisk en la parte superior y, luego, conecta el disco al final de la sección spec.disks de la VM:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: DISK_NAME
spec:
  size: 10Gi
---
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: VM_NAME-boot-dv
    - virtualMachineDiskName: DISK_NAME

En este ejemplo, se crea un disco 10Gi en blanco (10 gibibyte) llamado DISK_NAME.

Guarda y cierra el manifiesto de VM actualizado en el editor.

Usa kubectl para iniciar la VM:

kubectl virt start vm VM_NAME --kubeconfig KUBECONFIG

Desde la imagen

En esta situación, debes crear un disco a partir de una imagen de origen y conectarlo a la VM.

Usa kubectl para detener la VM, si es necesario:
```
kubectl virt stop vm VM_NAME --kubeconfig KUBECONFIG
```
Reemplaza lo siguiente:
- VM_NAME: Es el nombre de la VM que deseas detener.
- KUBECONFIG: Es la ruta al archivo kubeconfig del clúster.

Edita el recurso de VM existente, como my-vm:

kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG

Actualiza el manifiesto VirtualMachine para agregar una sección VirtualMachineDisk en la parte superior y, luego, conecta el disco al final de la sección spec.disks de la VM:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: DISK_NAME
spec:
  size: 10Gi
  source:
    http:
      url: http://example.com/my-disk-img.qcow2
---
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: VM_NAME-boot-dv
    - virtualMachineDiskName: DISK_NAME

En este ejemplo, se crea un disco 10Gi (10 gibibytes) llamado DISK_NAME desde la fuente HTTP http://example.com/my-disk-img.qcow2.

Guarda y cierra el manifiesto de VM actualizado en el editor.

Usa kubectl para iniciar la VM:

kubectl virt start vm VM_NAME --kubeconfig KUBECONFIG

Crear un disco

En esta situación, debes crear los recursos de discos por separado de los recursos de la VM. Esta situación te permite crear discos con anticipación y, luego, conectarte a las VM según sea necesario.

Disco en blanco

Para crear un disco en blanco, completa los siguientes pasos.

Crea un manifiesto VirtualMachineDisk, como my-disk.yaml, en el editor que elijas:
```
nano my-disk.yaml
```
Copia y pega la siguiente definición de YAML:
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: DISK_NAME
spec:
  size: 10Gi
```
En este ejemplo, se crea un disco 10Gi en blanco (10 gibibyte) llamado DISK_NAME.
Guarda y cierra el manifiesto del disco en el editor.
Crea el disco con kubectl:
```
kubectl apply -f my-disk.yaml --kubeconfig KUBECONFIG
```
Reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster.

Desde la imagen

Para crear un disco a partir de una imagen, completa los siguientes pasos.

Crea un manifiesto VirtualMachineDisk, como my-disk.yaml, en el editor que elijas:
```
nano my-disk.yaml
```

Copia y pega la siguiente definición de YAML:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineDisk
metadata:
  name: DISK_NAME
spec:
  size: 20Gi
  source:
    http:
      url: https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64.img

En este ejemplo, se crea un disco 20Gi (20 gibibytes) llamado DISK_NAME con una imagen pública de Ubuntu.

Guarda y cierra el manifiesto del disco en el editor.
Crea el disco con kubectl:
```
kubectl apply -f my-disk.yaml --kubeconfig KUBECONFIG
```
Reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster.

¿Qué sigue?

Crea y usa credenciales para importar imágenes desde Cloud Storage.
Crea y usa clases de almacenamiento en clústeres de Anthos en equipos físicos.
Cuando ya no necesites las VM ni sus recursos de discos virtuales, borra una VM en clústeres de Anthos alojados en equipos físicos.