Crear un volumen de Persistent Disk

Puedes crear un volumen de disco persistente en blanco o crear un disco a partir de una fuente de datos. Puedes usar un disco persistente como disco de arranque de una instancia de máquina virtual (VM) o como disco de datos que conectas a una VM.

En este documento se explica cómo crear un volumen de disco persistente de zona en blanco que no sea de arranque y cómo adjuntarlo a tu máquina virtual.

Para obtener información sobre otros tipos de creación y adición de discos, consulta los siguientes artículos:

Antes de empezar

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

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

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

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    Terraform

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

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Set up authentication for a local development environment.

    REST

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

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Restricciones

  • Durante la creación de la VM, puedes adjuntar hasta 127 volúmenes de disco persistente zonal secundario que no sea de arranque.
  • Puedes tener una capacidad total conectada de 257 TB por VM. Para obtener información sobre cómo conseguir el máximo rendimiento con grandes volúmenes, consulta Tamaño del volumen lógico.

Añadir un disco que no sea de arranque a una VM

Crea y conecta un disco zonal que no sea de arranque mediante Google Cloud console, la CLI de Google Cloud o REST.

Variables de tipo Persistent Disk

En la siguiente tabla se indican los valores de referencia de cada tipo de disco persistente. Cuando creas un volumen de Persistent Disk con la CLI de Google Cloud, REST o las bibliotecas de cliente de Cloud para Compute Engine, indica el tipo de Persistent Disk que quieres crear proporcionando el valor correspondiente de la tabla.

Si creas un disco en la consola de Google Cloud , el tipo de disco predeterminado es pd-balanced. Si creas un disco con la interfaz de línea de comandos (CLI) de gcloud o con REST, el tipo de disco predeterminado es pd-standard.

Tipo de disco Nombre de referencia
Disco persistente balanceado pd-balanced
Disco persistente de rendimiento (SSD) pd-ssd
Disco persistente estándar pd-standard
Disco persistente extremo pd-extreme

Debes especificar un nombre de dispositivo personalizado al conectar el disco a una VM. El nombre que especifiques se usará para generar un enlace simbólico del disco en el SO invitado, lo que facilitará la identificación.

Consola

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

    Ve a la página Instancias de VM.

  2. Haga clic en el nombre de la VM a la que quiera añadir un disco.

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

  4. En Discos adicionales, haz clic en Añadir disco.

  5. Especifica un nombre para el disco, configura sus propiedades y selecciona En blanco como Tipo de origen.

  6. Opcional: En el encabezado Nombre del dispositivo, selecciona la opción Usar un nombre de dispositivo personalizado. El nombre que introduzcas se usará para generar un enlace simbólico del disco, lo que facilitará su identificación.

  7. Haz clic en Hecho para completar la configuración del disco.

  8. Haz clic en Guardar para aplicar los cambios a la VM y añadir el nuevo disco.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Usa el gcloud compute disks create comando para crear el volumen de disco persistente zonal.

    gcloud compute disks create DISK_NAME \
  --size DISK_SIZE \
  --type DISK_TYPE

    Haz los cambios siguientes:

    • DISK_NAME: el nombre del nuevo disco.
    • DISK_SIZE: tamaño del nuevo disco en gigabytes. Los tamaños aceptables van de 10 a 65.536 GB (inclusive) en incrementos de 1 GB.
    • DISK_TYPE: URL completa o parcial del tipo del volumen de disco persistente. Por ejemplo, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.

  3. Una vez creado el disco, vincúlalo a cualquier VM 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

    Haz los cambios siguientes:

    • VM_NAME: nombre de la VM en la que vas a añadir el nuevo volumen de disco persistente de zona
    • DISK_NAME: el nombre del nuevo disco que vas a adjuntar a la VM.
    • DEVICE_NAME: nombre que usa el SO invitado para identificar el disco (opcional).

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

    5. 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 adjuntar 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]
  }


}

    Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

    REST

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

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

{
 "name": "DISK_NAME",
 "sizeGb": "DISK_SIZE",
 "type": "DISK_TYPE"
}

      Haz los cambios siguientes:

      • PROJECT_ID: tu ID de proyecto.
      • ZONE: la zona en la que se encuentran tu máquina virtual y el nuevo disco.
      • DISK_NAME: el nombre del nuevo disco.
      • DISK_SIZE: tamaño del nuevo disco en gigabytes. Los tamaños aceptables van de 10 a 65.536 GB (inclusive) en incrementos de 1 GB.
      • DISK_TYPE: URL completa o parcial del tipo de disco persistente. Por ejemplo, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.

    2. Crea una solicitud POST al método compute.instances.attachDisk e incluye la URL del volumen del disco persistente de zona 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
}

      Haz los cambios siguientes:

      • PROJECT_ID: tu ID de proyecto
      • ZONE: la zona en la que se encuentran tu VM y el nuevo disco
      • VM_NAME: el nombre de la VM en la que vas a añadir el nuevo volumen de disco persistente
      • DISK_NAME: el nombre del nuevo disco
      • DEVICE_NAME: nombre que usa el SO invitado para identificar el disco (opcional).

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

Siguientes pasos