Crea un nuovo volume su disco permanente

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

Questo documento spiega come creare un volume del disco permanente vuoto a livello di zona e non di avvio, per poi collegarlo alla VM.

Per altri tipi di creazione e aggiunta di dischi, consulta quanto segue:

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

    Console

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

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  • Imposta una regione e una zona predefinite.

    • Terraform

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

    1. Installa Google Cloud CLI.

    2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    3. Se utilizzi una shell locale, crea credenziali di autenticazione locali per il tuo account utente: 

      gcloud auth application-default login

      Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

      Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

    REST

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

      Installa Google Cloud CLI.

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Limitazioni

  • Durante la creazione della VM, puoi collegare fino a 127 volumi di dischi permanenti secondari e non di avvio a livello di zona.
  • Puoi avere una capacità totale collegata di 257 TB per VM. Per informazioni su come garantire il massimo rendimento con volumi di grandi dimensioni, consulta Dimensioni dei volumi logici.

Aggiungi un disco non di avvio alla VM

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

Variabili di tipo disco permanente

La tabella seguente elenca i valori di riferimento di ogni tipo di disco permanente. Quando crei un volume del disco permanente con Google Cloud CLI, REST o le librerie client Cloud per Compute Engine, indica il tipo di disco permanente che vuoi creare specificando il valore corrispondente della tabella.

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.

Tipo di disco Nome del riferimento
Disco permanente bilanciato pd-balanced
Disco permanente (SSD) prestazionale pd-ssd
Disco permanente standard pd-standard
Disco permanente con carico estremo pd-extreme

Devi specificare un nome dispositivo personalizzato quando colleghi il disco a una VM. Il nome specificato viene utilizzato per generare un collegamento simbolico per il disco nel sistema operativo guest, in modo da semplificarne 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 relative proprietà e seleziona Vuoto come Tipo di origine.

  6. (Facoltativo) Sotto l'intestazione Nome dispositivo, seleziona l'opzione Utilizza un nome dispositivo personalizzato. Il nome inserito viene utilizzato per generare un collegamento simbolico per il disco, in modo da semplificarne 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 e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Utilizza il comando gcloud compute disks create per creare il volume del 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 consentite vanno da 10 GB a 65.536 GB, con incrementi di 1 GB.
    • DISK_TYPE: URL completo o parziale del tipo di volume del 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 in cui aggiunti il nuovo volume del 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. Crea una richiesta POST per creare un disco permanente 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 consentite vanno da 10 GB a 65.536 GB, con incrementi di 1 GB.
    • DISK_TYPE: URL completo o parziale del 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 al metodo compute.instances.attachDisk e includi l'URL del volume del disco permanente a livello di zona 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: l'ID del tuo progetto
    • ZONE: la zona in cui si trovano la VM e il nuovo disco
    • VM_NAME: il nome della VM in cui aggiungi il nuovo volume di 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 formattarlo e montarlo in modo che il sistema operativo possa utilizzare lo spazio di archiviazione disponibile.

Passaggi successivi