Restauration de données à partir d'un instantané de partage de fichiers

Restaurer les données des partages de fichiers en créant de nouveaux partages à partir des instantanés. Les partages restaurés utilisent le même profil et le même emplacement que l'instantané. Prend en charge la restauration complète et la restauration d'un seul fichier.

Les partages ne peuvent être créés que dans le même emplacement que le partage d'origine de l'instantané. Lorsque le nouveau partage est créé, il ne contient que des pointeurs vers le partage d'origine et le processus de copie des données commence. Pendant que les données sont copiées, le partage est en attente. Bien que le nouveau partage puisse être monté en lecture/écriture dans un état d' attente, certaines opérations telles que la création d'une réplique ou d'instantanés ne sont pas autorisées. Une fois l'opération de copie des données terminée, le nouveau partage est séparé du partage parent pour devenir indépendant, ce qui termine le processus d'initialisation. Une fois le processus d'initialisation terminé, le partage passe à l'état stable et peut être utilisé comme n'importe quel autre partage.

Il est possible de modifier la clé de chiffrement gérée par le client lors de la création du nouveau partage de fichiers zonal. Ce processus enregistre le nouveau partage dans le service de gestion des clés avec une nouvelle clé. La nouvelle clé est utilisée pour crypter le nouveau partage.

Sélectionner la disponibilité Dans cette version des partages de fichiers régionaux, il n'est pas possible de modifier la clé de chiffrement gérée par le client lors de la création d'un nouveau partage de fichiers régional.

Limitations

Les restrictions suivantes s'appliquent lorsque vous restaurez un partage à partir d'un instantané.

  • Pour restaurer un partage, l'instantané doit être dans un état stable et disponible.
  • Vous ne pouvez pas supprimer l'instantané à partir duquel le partage est restauré tant que l'initialisation n'est pas terminée.
  • Si l'instantané est protégé par un chiffrement géré par le client et que vous ne spécifiez pas de clé racine CRN différente, le partage restauré est chiffré avec la clé de chiffrement de l'instantané. Le cryptage ne peut pas être modifié ultérieurement. Si la clé de chiffrement du partage parent est supprimée pendant l'initialisation du nouveau partage, cela perturbe le processus d'initialisation et le fait échouer.

Restauration de partages à partir d'instantanés dans la console

Vous pouvez créer des partages à partir de différentes pages de la console IBM Cloud

Création d'un partage à partir d'un instantané dans la console

À partir de la liste des instantanés d' File Storage for VPC, vous pouvez créer un partage d' File Storage for VPC. Les nouvelles actions sont ajoutées à la liste des actions File Storage for VPC

  1. Accéder à la liste des instantanés d' File Storage for VPC. Dans la console IBM Cloud, cliquez sur l'icône de menu Navigation > Infrastructure VPC > Stockage > Partages de stockage de fichiers.

  2. Sélectionnez le partage qui contient les données que vous souhaitez utiliser pour créer un autre partage.

  3. Dans l'onglet Instantanés de la page Détails du partage, recherchez l'instantané que vous souhaitez utiliser. Il doit être à l'état stable.

  4. Dans le menu Actions , icône Actions, sélectionnez Restaurer.

  5. Dans la page de provisionnement, les détails de l'instantané sont affichés. Certaines configurations de partage de fichiers, telles que la zone et le type de cryptage, sont héritées de l'instantané et ne peuvent pas être modifiées.

  6. Fournir les informations requises sur l'action.

    Créer des options de partage.
    Zone Description
    Détails du partage Définir la nouvelle action.
    Nom Saisissez un nom pour le nouveau partage.
    Groupe de ressources Utiliser les valeurs par défaut ou sélectionner dans la liste.
    Etiquettes utilisateur Spécifiez des étiquettes d'utilisateur pour organiser vos ressources et pour les utiliser dans le cadre des politiques de sauvegarde
    Etiquettes de gestion des accès Spécifiez les balises de gestion d'accès qui ont été créées dans IAM pour vous aider à gérer l'accès à vos partages.
    Profil La valeur par défaut est dp2 pour les parts zonales et rfs pour les parts régionales. Le profil et la valeur de génération de stockage du nouveau partage doivent correspondre au profil et à la valeur de génération de stockage de l'instantané.
    Taille Entrez une taille de partage autorisée par le profil. Elle doit être supérieure ou égale à la taille de l'instantané.
    IOPS Sélectionnez l'IOPS qui se situe dans la plage autorisée par le profil de partage.
    Cibles de montage La création d'une cible de montage est facultative, mais vous devez disposer d'une cible de montage si vous souhaitez vous connecter à votre partage de fichiers à partir d'une instance de serveur virtuel.
    Chiffrement Hérité de l'instantané.

  7. Une fois que vous avez terminé, cliquez sur « Créer ». La nouvelle action est créée.

Restauration d'un partage à partir d'un instantané à partir de la CLI

Vous pouvez créer un partage File Storage for VPC à partir d'un instantané depuis l'interface de gestion. Lorsque le partage est créé, vous pouvez créer une cible de montage et monter le partage sur une instance ultérieurement.

Avant de commencer

Avant de pouvoir utiliser l'interface de ligne de commande, vous devez installer l'interface de ligne de commande d'IBM Cloud et le plug-in de l'interface de ligne de commande du VPC. Pour plus d'informations, reportez-vous à la rubrique Configuration requise pour l'interface de ligne de commande.

  1. Connectez-vous sur IBM Cloud®.

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

    Cette commande renvoie une URL et des invites pour un code d'accès. Accédez à cette URL dans votre navigateur et connectez-vous. En cas de réussite, vous obtenez un code d'accès à usage unique. Copiez ce code et collez-le en réponse à l'invite. Une fois l'authentification réussie, vous êtes invité à choisir votre compte. Si vous avez accès à plusieurs comptes, sélectionnez celui avec lequel vous souhaitez vous connecter. Répondez à toutes les invites restantes pour terminer la connexion.

  2. Rassemblez des informations sur l'instantané que vous souhaitez utiliser pour restaurer un partage.

    1. Vous pouvez utiliser l'interface CLI pour répertorier tous les instantanés d'un partage spécifique et en choisir un parmi les résultats.
    2. Ensuite, utilisez la commande ibmcloud is share-snapshot SHARE SNAPSHOT pour afficher les détails de l'instantané choisi.

Création d'un partage à partir d'un instantané à partir de l'interface CLI

Exécutez la commande ibmcloud is share-create et spécifiez le paramètre --snapshot et l'ID ou le CRN de l'instantané.

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'exemple suivant crée un partage à partir d'un instantané en utilisant le CRN de l'instantané. Si vous n'indiquez pas de nom pour votre nouveau partage, un nom sera généré automatiquement. Les valeurs de taille et d'IOPS sont héritées de l'instantané et vous pouvez les modifier après la création du partage.

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

Les profils de partage de fichiers de première et de deuxième génération de la famille des profils de performance définis ne sont pas interchangeables. Vous ne pouvez pas utiliser votre snapshot de deuxième génération pour créer un partage de fichiers zonal. De même, vous ne pouvez pas utiliser l'instantané du partage de fichiers de première génération pour créer un partage avec le profil rfs.

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is share-create.

Restauration d'un partage à partir d'un instantané via l'API

Vous pouvez restaurer un partage de manière programmatique en appelant la méthode /shares dans l'API VPC.

Avant de commencer, rassemblez des informations sur l'instantané que vous souhaitez utiliser pour restaurer un partage.

Créer un partage à partir d'un instantané via l'API

Pour restaurer un partage à partir d'un instantané, faites une demande POST /shares et indiquez l'ID ou le CRN de l'instantané dans la propriété source_snapshot. La capacité restaurée du partage (en Go) doit être au moins égale à la valeur « minimum_capacity » du snapshot.

L'exemple de requête suivant crée un partage de 100 Go basé sur le cliché source 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"]
   }`

Les profils de partage de fichiers de première et de deuxième génération de la famille des profils de performance définis ne sont pas interchangeables. Vous ne pouvez pas utiliser votre snapshot de deuxième génération pour créer un partage de fichiers zonal. De même, vous ne pouvez pas utiliser l'instantané du partage de fichiers de première génération pour créer un partage avec le profil rfs.

Restauration d'un partage à partir d'un instantané avec Terraform

Pour utiliser Terraform, téléchargez le CLI Terraform et configurez le plug-in IBM Cloud Provider. Pour plus d'informations, voir Démarrer avec Terraform.

Les services d'infrastructure VPC utilisent un point de terminaison régional spécifique, qui cible par défaut us-south. Si votre VPC est créé dans une autre région, assurez-vous de cibler la région appropriée dans le bloc fournisseur du fichier provider.tf.

Voir l'exemple suivant de ciblage d'une région autre que la région par défaut us-south.

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

Créer un partage à partir d'un instantané avec Terraform

Pour créer un partage à partir d'un instantané, utilisez la ressource ibm_is_share. L'exemple suivant crée un partage à partir d'un instantané avec le profil dp2.

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

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_share.

Restauration de fichiers à partir d'un instantané

Pour effectuer la restauration d'un seul fichier, vous pouvez utiliser les fonctions natives du système d'exploitation. Vous pouvez naviguer jusqu'à la cible de montage NFS du partage et ouvrir le répertoire snapshot caché (généralement nommé /.snapshot ou .snap, selon le type de partage de fichiers). Dans ce répertoire, vous trouverez des sous-répertoires représentant chaque instantané de votre partage. Vous pouvez les ouvrir pour les localiser et copier le fichier sélectionné à un autre endroit.

Bien que le répertoire d'instantanés soit caché, il est accessible lorsqu'on y accède directement à l'aide de commandes telles que cd .snapshot ou ls .snapshot/. Chaque instantané apparaît sous la forme d'un sous-répertoire nommé avec son empreinte digitale unique, qui correspond à ce que vous voyez dans la console, l'interface de programmation ou l'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

Ces sous-répertoires représentent l'état du partage au moment où l'instantané a été pris. Les sous-répertoires sont en lecture seule. Il n'est pas possible de supprimer les données de ces instantanés par des méthodes NFS. De même, la création de nouveaux sous-répertoires est interdite. Cette vue ne sert qu'à faciliter la restauration d'un seul fichier et l'inspection ponctuelle des données.

Etapes suivantes

Vous pouvez créer d' autres instantanés ou gérer les instantanés existants.