Aggiungi un disco permanente alla tua VM

Puoi creare un disco permanente vuoto o creare un disco da un'origine dati. Puoi utilizzare un disco permanente come disco di avvio per un'istanza di macchina virtuale (VM) o come disco dati da collegare a una VM.

Questo documento spiega come:

  • Crea un disco permanente vuoto, non di avvio, e collegalo alla VM.

Se vuoi creare un disco di avvio da utilizzare in seguito per creare una VM, consulta Creare un disco di avvio personalizzato.

Se vuoi aggiungere un disco Google Cloud Hyperdisk alla tua VM, consulta Aggiungere spazio di archiviazione Hyperdisk a una VM.

Se hai bisogno di formattare o montare un disco permanente sulla tua VM, vedi:

Per informazioni generali su Persistent Disk e sui tipi di dischi disponibili, leggi la panoramica su Persistent Disk,

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    Seleziona la scheda relativa a come intendi utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

      gcloud init
    2. Imposta una regione e una zona predefinite.

    Terraform

    Per utilizzare gli esempi Terraform in questa pagina da un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Installa Google Cloud CLI.
    2. Per initialize gcloud CLI, esegui questo comando:

      gcloud init
    3. Crea credenziali di autenticazione locali per il tuo Account Google:

      gcloud auth application-default login

    Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

    REST

    Per utilizzare gli esempi di API REST su questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

      gcloud init

Limitazioni

  • Durante la creazione della VM, puoi collegare fino a 127 dischi permanenti a livello di zona secondari non di avvio.
  • Puoi avere una capacità totale collegata di 257 TB per VM. Per informazioni su come garantire le massime prestazioni in presenza di volumi elevati, consulta Dimensioni del volume logico.

Aggiunta di un disco non di avvio alla VM

Crea e collega un disco di zona non di avvio utilizzando la console Google Cloud, Google Cloud CLI o REST.

Se crei un disco nella console Google Cloud, il tipo di disco predefinito è pd-balanced. Se crei un disco utilizzando gcloud CLI o REST, il tipo di disco predefinito è pd-standard.

Quando colleghi il disco a una VM, devi specificare un nome di dispositivo personalizzato. Il nome specificato viene utilizzato per generare un link simbolico per il disco nel sistema operativo guest, facilitando l'identificazione.

Console

  1. Vai alla pagina Istanze VM.

    Vai alla pagina Istanze VM

  2. Fai clic sul nome della VM a cui vuoi aggiungere un disco.

  3. Nella pagina dei dettagli, fai clic su Modifica.

  4. In Dischi aggiuntivi, fai clic su Aggiungi nuovo disco.

  5. Specifica un nome per il disco, configura le proprietà del disco e seleziona Vuoto come Tipo di origine.

  6. (Facoltativo) Sotto l'intestazione Nome dispositivo, seleziona l'opzione Usa un nome dispositivo personalizzato. Il nome inserito viene utilizzato per generare un collegamento simbolico per il disco, che ne semplifica l'identificazione.

  7. Fai clic su Fine per completare la configurazione del disco.

  8. Fai clic su Salva per applicare le modifiche alla VM e aggiungere il nuovo disco.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Usa il comando gcloud compute disks create per creare il disco permanente a livello di zona.

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

    Sostituisci quanto segue:

    • DISK_NAME: il nome del nuovo disco.
    • DISK_SIZE: le dimensioni, in gigabyte, del nuovo disco. Le dimensioni accettabili variano, con incrementi di 1 GB, da 10 GB a 65.536 GB inclusi.
    • DISK_TYPE: URL completo o parziale per il tipo di disco permanente. Ad esempio: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.
  3. Dopo aver creato il disco, collegalo a qualsiasi VM in esecuzione o arrestata. Utilizza il comando gcloud compute instances attach-disk:

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

    Sostituisci quanto segue:

    • VM_NAME: il nome della VM a cui stai aggiungendo il nuovo disco permanente a livello di zona
    • DISK_NAME: il nome del nuovo disco che stai collegando alla VM.
    • DEVICE_NAME: facoltativo: un nome utilizzato dal sistema operativo guest per identificare il disco.
  4. Utilizza il comando gcloud compute disks describe per visualizzare una descrizione del disco.

Terraform

Per creare un disco, utilizza la risorsa 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"
}

Per collegare il disco a una VM, utilizza la risorsa 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]
  }

}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

REST

  1. Costruire una richiesta POST per creare un Persistent Disk a livello di zona utilizzando il metodo disks.insert. Includi le proprietà name, sizeGb e type. Per creare questo disco come disco non di avvio vuoto e non formattato, non specificare un'immagine di origine o uno snapshot di origine.

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

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto.
    • ZONE: la zona in cui si trovano la VM e il nuovo disco.
    • DISK_NAME: il nome del nuovo disco.
    • DISK_SIZE: le dimensioni, in gigabyte, del nuovo disco. Le dimensioni accettabili variano, con incrementi di 1 GB, da 10 GB a 65.536 GB inclusi.
    • DISK_TYPE: URL completo o parziale per il tipo di disco permanente. Ad esempio, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.
  2. Crea una richiesta POST per il metodo compute.instances.attachDisk e includi l'URL del disco permanente a livello di zona che hai appena creato:

    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
    }
    

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto
    • ZONE: la zona in cui si trovano la VM e il nuovo disco
    • VM_NAME: nome della VM in cui stai aggiungendo il nuovo disco permanente
    • DISK_NAME: il nome del nuovo disco
    • DEVICE_NAME: facoltativo: un nome utilizzato dal sistema operativo guest per identificare il disco.

Dopo aver creato il nuovo disco e averlo collegato a una VM, devi formattare e montare il disco in modo che il sistema operativo possa utilizzare lo spazio di archiviazione disponibile.

Passaggi successivi