Crea un nuevo volumen de Persistent Disk

Puedes crear un volumen de Persistent Disk en blanco o crear un disco a partir de una fuente de datos. Puedes usar un Persistent Disk como disco de arranque para una instancia de procesamiento o como disco de datos que conectes a una instancia.

En este documento, se explica cómo crear un volumen de Persistent Disk zonal en blanco que no sea de arranque y conectarlo a tu VM.

Para conocer otros tipos de creación y adición de discos, consulta lo siguiente:

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

    • Terraform

    Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

    1. Instala Google Cloud CLI.

    2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

    3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario: 

      gcloud auth application-default login

      No es necesario que lo hagas si usas Cloud Shell.

      Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

    Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

    REST

    Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

      Instala Google Cloud CLI.

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Restricciones

  • Durante la creación de la instancia, puedes conectar hasta 127 volúmenes de Persistent Disk zonal secundario que no sean de arranque.
  • Nota: Puedes tener una capacidad total conectada de 257 TB por VM. Para obtener información sobre cómo garantizar el máximo rendimiento con volúmenes grandes, consulta Tamaño de volumen lógico.

Límites de tamaño y nombres de referencia de Persistent Disk

Cuando creas un volumen de Persistent Disk con Google Cloud CLI, REST o las bibliotecas cliente de Cloud para Compute Engine, indica el tipo de Persistent Disk que se creará proporcionando el valor en la columna Nombre de referencia de la siguiente tabla.

El tamaño que especifiques para un volumen de Persistent Disk debe estar dentro de los rangos que se indican en la siguiente tabla.

Tipo de disco Nombre de la referencia Tamaño mínimo Tamaño máximo Tamaño predeterminado
Disco persistente balanceado pd-balanced Zonal: 10 GiB
Regional: 10 GiB		 64 TiB 100 GiB
Persistent Disk de rendimiento (SSD) pd-ssd Zonal: 10 GiB
Regional: 10 GiB		 64 TiB 100 GiB
Disco persistente estándar pd-standard Zonal: 10 GiB
Regional: 200 GiB		 64 TiB 500 GiB
Disco persistente extremo pd-extreme 500 GiB 64 TiB 1 TiB

Agrega un Persistent Disk que no sea de arranque a tu instancia

Crea y conecta un Persistent Disk zonal que no sea de arranque con Google Cloud console, la Google Cloud CLI o REST.

Debes especificar un nombre de dispositivo personalizado cuando conectes el disco a una VM. El nombre que especifiques se usa a fin de generar un symlink para el disco en el SO invitado, lo que facilita la identificación.

Console

  1. Ve a la página Instancias de VM.

    Ir a la página Instancias de VM

  2. Haz clic en el nombre de la VM en la que deseas agregar un disco.

  3. En la página de detalles, haz clic en editarEditar.

  4. En la sección Almacenamiento, en Discos adicionales, haz clic en Agregar disco nuevo.

  5. Especifica un nombre para el disco y configura sus propiedades.

  6. En Tipo de fuente de disco, elige la fuente de datos para el disco:

    • Para crear un disco en blanco, selecciona Disco en blanco.
    • Para crear el disco a partir de una imagen, haz lo siguiente:
      1. Selecciona Imagen.
      2. En Imagen de origen, elige la imagen de origen para el disco.
    • Para crear el disco a partir de una instantánea existente, haz lo siguiente:
      1. Selecciona Instantánea, instantánea inmediata o Instantánea de archivo, según si la instantánea de origen es una instantánea estándar, una instantánea inmediata o una instantánea de archivo, respectivamente.
      2. En Instantánea de origen, selecciona la instantánea de origen o instantánea inmediata de la lista. Solo se muestran las instantáneas que se encuentran en la ubicación que seleccionaste.

  7. Opcional: Para ver las opciones de configuración avanzadas, expande la sección Mostrar configuración avanzada.

    • Selecciona el modo de conexión del disco en el campo Modo.
    • Para conservar o borrar el disco cuando se borre la instancia, selecciona la opción en el campo Regla de eliminación.
    • Para que sea más fácil identificar el disco desde el SO invitado, especifica un nombre de dispositivo personalizado. En el encabezado Nombre del dispositivo, selecciona la opción Usar un nombre de dispositivo personalizado. En el campo Nombre del dispositivo, ingresa una cadena para usarla como vínculo simbólico para el disco.

  8. Haz clic en Listo para completar la configuración del disco.

  9. Haz clic en Guardar para aplicar los cambios a la instancia y agregar el disco nuevo.

gcloud

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell que muestra una ventana emergente con una línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Usa el comando gcloud compute disks create para crear el volumen de Persistent Disk zonal.

    gcloud compute disks create DISK_NAME \
  --size DISK_SIZE --zone=ZONE \
  --type DISK_TYPE

    Reemplaza lo siguiente:

    • DISK_NAME: Es el nombre del disco nuevo.
    • DISK_SIZE: Es el tamaño, en gigabytes, del disco nuevo. Los tamaños aceptables varían, en incrementos de 1 GB, desde 10 GB hasta 65,536 GB inclusive.
    • ZONE: Es la zona en la que Compute Engine crea el disco, por ejemplo, us-central1-f.
    • DISK_TYPE: Es el tipo del disco nuevo. Por ejemplo, para un disco persistente SSD, especifica pd-ssd.

  3. Una vez creado el disco, conéctalo a cualquier instancia en ejecución o detenida. Usa el comando gcloud compute instances attach-disk:

    gcloud compute instances attach-disk VM_NAME \
  --disk DISK_NAME --device-name=DEVICE_NAME \
  --zone=ZONE

    Reemplaza lo siguiente:

    • VM_NAME: Es el nombre de la VM en la que deseas agregar el nuevo volumen de Persistent Disk zonal.
    • DISK_NAME: el nombre del disco nuevo que deseas conectar a la VM.
    • DEVICE_NAME: Es un nombre que el SO invitado usa para identificar el disco (opcional).
    • ZONE: Es la zona en la que Compute Engine crea la instancia y el disco, por ejemplo, us-central1-f.

  4. Usa el comando gcloud compute disks describe para ver una descripción del disco.

Terraform

Para crear un disco, usa el recurso google_compute_disk.

# Using pd-standard because it's the default for Compute Engine

resource "google_compute_disk" "default" {
  name = "disk-data"
  type = "pd-standard"
  zone = "us-west1-a"
  size = "5"
}

Para conectar el disco a una VM, usa el recurso google_compute_instance.

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }


}

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

REST

  1. Formula una solicitud POST para crear un disco persistente zonal con el método disks.insert. Incluye las propiedades name, sizeGb y type. Para crear este disco como un disco vacío sin formato y que no sea de arranque, no especifiques una imagen ni una instantánea de origen.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks

{
 "name": "DISK_NAME",
 "sizeGb": "DISK_SIZE",
 "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
}

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID de tu proyecto
    • ZONE: la zona en la que se encuentran la VM y el disco nuevo.
    • DISK_NAME: Es el nombre del disco nuevo.
    • DISK_SIZE: Es el tamaño, en gigabytes, del disco nuevo. Los tamaños aceptables varían, en incrementos de 1 GB, desde 10 GB hasta 65,536 GB inclusive.
    • DISK_TYPE: Es el tipo del disco nuevo. Por ejemplo, para un disco persistente SSD, especifica pd-ssd.

  2. Crea una solicitud POST para el compute.instances.attachDiskmétodo e incluye la URL al Persistent Disk zonal que acabas de crear:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/attachDisk

{
 "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME",
 "deviceName": DEVICE_NAME
}

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID de tu proyecto
    • ZONE: la zona en la que se encuentran la VM y el disco nuevo
    • VM_NAME: Es el nombre de la VM en la que deseas agregar el nuevo volumen de Persistent Disk.
    • DISK_NAME: Es el nombre del disco nuevo.
    • DEVICE_NAME: Es un nombre que el SO invitado usa para identificar el disco (opcional).

Después de crear el disco nuevo y conectarlo a una VM, debes formatearlo y activarlo para que el sistema operativo pueda usar el espacio de almacenamiento disponible.

¿Qué sigue?