Ripristino dei dati da un'istantanea di una condivisione di file

Ripristinare i dati delle condivisioni di file creando nuove condivisioni a partire dagli snapshot. Le condivisioni ripristinate utilizzano lo stesso profilo e la stessa posizione dell'istantanea. Supporta il ripristino completo e il ripristino di un singolo file.

Le condivisioni possono essere create solo nella stessa posizione della condivisione di origine dell'istantanea. Quando la nuova condivisione viene creata, contiene solo i puntatori alla condivisione originale e il processo di copia dei dati ha inizio. Mentre i dati vengono copiati, la condivisione è in stato di attesa. Mentre la nuova condivisione può essere montata in lettura/scrittura in stato di attesa, alcune operazioni come la creazione di una replica o di istantanee non sono consentite. Al termine dell'operazione di copia dei dati, la nuova quota viene separata dalla quota madre per diventare indipendente, completando il processo di inizializzazione. Al termine del processo di inizializzazione, la condivisione passa allo stato stabile e può essere utilizzata come qualsiasi altra condivisione.

È possibile modificare la chiave di crittografia gestita dal cliente quando viene creata la nuova condivisione di file zonale. Questo processo registra la nuova azione nel servizio di gestione delle chiavi con una nuova chiave. La nuova chiave viene utilizzata per crittografare la nuova azione.

Selezionare la disponibilità In questa versione delle condivisioni di file regionali, non è possibile modificare la chiave di crittografia gestita dal cliente quando viene creata la nuova condivisione di file regionale.

Limitazioni

Quando si ripristina una condivisione da una snapshot si applicano le seguenti limitazioni.

  • Per ripristinare una condivisione, l'istantanea deve essere in uno stato stabile e disponibile.
  • Non è possibile eliminare lo snapshot da cui è stata ripristinata la condivisione, a meno che l'inizializzazione non sia completa.
  • Se l'istantanea è protetta con la crittografia gestita dal cliente e non si specifica una chiave radice CRN diversa, la condivisione ripristinata viene crittografata con la chiave di crittografia dell'istantanea. La codifica non può essere modificata in seguito. Se la chiave di crittografia della condivisione principale viene eliminata durante l'inizializzazione della nuova condivisione, il processo di inizializzazione viene interrotto e fallisce.

Ripristino delle condivisioni dalle istantanee nella console

È possibile creare condivisioni da varie pagine della console IBM Cloud.

Creazione di una condivisione da un'istantanea nella console

Dall'elenco delle istantanee dell' File Storage for VPC, è possibile creare una condivisione dell' File Storage for VPC. Le nuove azioni vengono aggiunte all'elenco delle azioni File Storage for VPC.

  1. Andare all'elenco delle istantanee File Storage for VPC. Nel sito IBM Cloud console, fate clic sull'icona Menu di navigazione icona del menu > Infrastrutture Icona VPC > Archiviazione > Condivisioni di archiviazione dei file.

  2. Selezionare la condivisione che contiene i dati che si desidera utilizzare per creare un'altra condivisione.

  3. Nella scheda Istantanee della pagina Dettagli condivisione, individuare l'istantanea che si desidera utilizzare. Deve trovarsi in uno stato di " stable ".

  4. Dal menu Azioni Icona Azioni, selezionare Ripristina.

  5. Nella pagina di provisioning vengono visualizzati i dettagli dell'istantanea. Alcune configurazioni della condivisione file, come la zona e il tipo di crittografia, sono ereditate dallo snapshot e non possono essere modificate.

  6. Fornire i dettagli dell'azione richiesti.

    Creare opzioni di condivisione.
    Campo Descrizione
    Dettagli condivisione Definire la nuova azione.
    Nome Inserisci un nome per la nuova condivisione.
    Gruppo di risorse Utilizzare le impostazioni predefinite o selezionare dall'elenco.
    Tag utente Specificare i tag utente per organizzare le risorse e per l'utilizzo da parte dei criteri di backup
    Tag di gestione accesso Specificare i tag di gestione degli accessi creati in IAM per aiutare a gestire l'accesso alle condivisioni.
    Profilo Il valore predefinito è dp2 per le azioni zonali e rfs per le azioni regionali. Il profilo e il valore di generazione dello storage della nuova condivisione devono corrispondere al profilo e al valore di generazione dello storage dell'istantanea.
    Dimensione Inserire una dimensione di condivisione consentita dal profilo. Deve essere maggiore o uguale alla dimensione dell'istantanea.
    IOPS Selezionare il valore IOPS compreso nell'intervallo consentito dal profilo di condivisione.
    Destinazioni di montaggio La creazione di una destinazione di montaggio è facoltativa, ma è necessario disporre di una destinazione di montaggio se si desidera connettersi alla condivisione di file da un'istanza di server virtuale.
    Crittografia Ereditato dall'istantanea.

  7. Una volta terminato, clicca su Crea. Viene creata la nuova azione.

Ripristino di una condivisione da un'istantanea dalla CLI

È possibile creare una condivisione File Storage for VPC da un'istantanea dalla CLI. Una volta creata la condivisione, è possibile creare una destinazione di montaggio e montare la condivisione su un'istanza in un secondo momento.

Prima di iniziare

Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI per VPC. Per ulteriori informazioni, consultare il sito Prerequisiti della CLI.

  1. Accedi a IBM Cloud®.

    ibmcloud login --sso -a cloud.ibm.com

    Questo comando restituisce un URL e richiede un passcode. Vai a tale URL nel tuo browser e accedi. Se l'operazione ha esito positivo, ricevi un passcode monouso. Copia questo passcode e incollalo come risposta al prompt. Dopo l'autenticazione, viene richiesto di scegliere il proprio account. Se hai accesso a più account, seleziona quello con cui desideri effettuare l'accesso. Rispondi alle richieste rimanenti per completare l'accesso.

  2. Raccogliere informazioni sull'istantanea che si desidera utilizzare per ripristinare una condivisione.

    1. È possibile utilizzare la CLI per elencare tutte le istantanee di una specifica condivisione e sceglierne una dall'output.
    2. Quindi, utilizzare il comando ibmcloud is share-snapshot SHARE SNAPSHOT per elencare i dettagli dell'istantanea scelta.

Creazione di una condivisione da un'istantanea dalla CLI

Eseguire il comando ibmcloud is share-create e specificare il parametro --snapshot e l'ID o il CRN dell'istantanea.

ibmcloud is share-create --name my-file-share-from-snapshot --snapshot r006-de41f19f-204c-4d4c-a630-1971ba85ed1d  --profile dp2 --size 100 --iops 2000  --user-tags env:test

Creating file share my-file-share-from-snapshot under account Test Account as user test.user@ibm.com...

ID                                 r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Name                               my-file-share-from-snapshot
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   none,user_managed
Zone                               us-south-2
Profile                            dp2
Size(GB)                           100
IOPS                               2000
User Tags                          env:test
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:35:03-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

L'esempio seguente crea una condivisione da una snapshot utilizzando il CRN della snapshot. Se non si specifica un nome per la nuova condivisione, ne verrà generato uno automaticamente. I valori di dimensione e IOPS sono ereditati dallo snapshot e possono essere modificati dopo la creazione della condivisione.

ibmcloud is share-create --profile dp2 --snapshot crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-ed78dc15-048f-4077-b7a2-88c213d53463/r006-de41f19f-204c-4d4c-a630-1971ba85ed1d

Creating file share  under account Test Account as user test.user@ibm.com...

ID                                 r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Name                               giggling-maturing-remnant-unworldly
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           10
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:37:01-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

I profili di condivisione file di prima e seconda generazione della famiglia di profili di prestazioni definiti non sono intercambiabili. Non è possibile utilizzare l'istantanea di seconda generazione per creare una condivisione di file zonale. Allo stesso modo, non è possibile utilizzare l'istantanea della condivisione di file di prima generazione per creare una condivisione con il profilo rfs.

Per ulteriori informazioni sulle opzioni di comando disponibili, vedere ibmcloud is share-create.

Ripristino di una condivisione da un'istantanea con l'API

È possibile ripristinare programmaticamente una condivisione chiamando il metodo /shares nell'API VPC.

Prima di iniziare, raccogliere informazioni sull'istantanea che si desidera utilizzare per ripristinare una condivisione.

Creazione di una condivisione da un'istantanea con l'API

Per ripristinare una condivisione da un'istantanea, fare una richiesta a POST /shares e specificare l'ID o il CRN dell'istantanea nella proprietà source_snapshot. La capacità della condivisione ripristinata (in GB) deve essere almeno pari alla capacità minima dell'istantanea.

La seguente richiesta di esempio crea una condivisione da 100 GB basata sullo snapshot di origine r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4.

curl -X POST \
"$vpc_api_endpoint/v1/shares/?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
     "name": "my-share-from-snapshot",
     "capacity": 100,
     "iops": 2000,
     "source_snapshot:" {"id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4"},
     "profile": {"name": "dp2"},
     "encryption_key":{"crn":"crn:[...]"},
     "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
     "allowed_transit_encryption_modes": ["none","user_managed"],
     "resource_group": {},
     "user_tags": ["env:test"]
   }`

I profili di condivisione file di prima e seconda generazione della famiglia di profili di prestazioni definiti non sono intercambiabili. Non è possibile utilizzare l'istantanea di seconda generazione per creare una condivisione di file zonale. Allo stesso modo, non è possibile utilizzare l'istantanea della condivisione di file di prima generazione per creare una condivisione con il profilo rfs.

Ripristino di una condivisione da un'istantanea con Terraform

Per utilizzare Terraform, scaricare la CLI di Terraform e configurare il plug-in IBM Cloud Provider. Per ulteriori informazioni, si veda Iniziare con Terraform.

I servizi di infrastruttura VPC utilizzano un endpoint regionale specifico, che per impostazione predefinita si rivolge a us-south. Se il VPC è stato creato in un'altra regione, assicurarsi di puntare alla regione appropriata nel blocco provider del file provider.tf.

Si veda il seguente esempio di targeting di una regione diversa da quella predefinita us-south.

provider "ibm" {
  region = "eu-de"
}

Creazione di una condivisione da un'istantanea con Terraform

Per creare una condivisione da un'istantanea, utilizzare la risorsa ibm_is_share. L'esempio seguente crea una condivisione da un'istantanea con il profilo dp2.

resource "ibm_is_share" "storage" {
  name            = "restore-share-new"
  profile         = "dp2"
  zone            = "us-south-1"
  source_snapshot = "ibm_is_snapshot.example.crn"
}

Per ulteriori informazioni sugli argomenti e gli attributi, vedere ibm_is_share.

Ripristino dei file da uno snapshot

Per eseguire il ripristino di un singolo file, è possibile utilizzare le funzioni native del sistema operativo. È possibile navigare fino alla destinazione di montaggio NFS della condivisione e aprire la directory nascosta delle istantanee (in genere denominata /.snapshot o .snap, a seconda del tipo di condivisione). All'interno di questa directory si trovano le sottodirectory che rappresentano ciascuna istantanea della condivisione. È possibile aprirli per individuare e poi copiare il file selezionato in una posizione diversa.

Sebbene la directory delle istantanee sia nascosta, è accessibile quando ci si rivolge direttamente a essa con comandi come cd .snapshot o ls .snapshot/. Ogni istantanea appare come una sottodirectory denominata con la sua impronta digitale unica, che corrisponde a quella visualizzata nella console, nella CLI o nell'API.

[root@server .snapshot]# ls -lah
total 34K
drwxr-xr-x  3 root root  3 May 10 08:28 .
drwxr-xr-x 22 root root 56 May 10 08:28 ..
drwxr-xr-x  2 root root  2 May 10 08:28 c2c2439c-cbeb-4f12-8d9d-6059a3b85502

Queste sottodirectory rappresentano lo stato della condivisione al momento in cui è stata scattata l'istantanea. Le sottodirectory sono di sola lettura. Non è possibile eliminare i dati da queste istantanee con i metodi NFS. Allo stesso modo, è vietato creare nuove sottodirectory. Questa vista serve solo per comodità nell'esecuzione del ripristino di un singolo file e nell'ispezione dei dati in tempo reale.

Passi successivi

È possibile creare altre istantanee o gestire quelle esistenti.