Extension de la capacité de partage de fichiers

Augmentez la capacité de partage de fichiers d' File Storage for VPC. jusqu'à 32 000 Go sans interruption de service ni migration des données. La facturation est automatiquement mise à jour pour tenir compte de la nouvelle capacité.

La facturation du partage de fichiers est automatiquement mise à jour pour ajouter la différence au prorata du nouveau prix au cycle de facturation en cours. Le nouveau montant total est ensuite facturé dans le cycle de facturation suivant.

Concepts de partage de fichiers extensible

Vous pouvez augmenter la capacité du partage de fichiers. La taille du partage de fichiers ne peut pas être inférieure à la taille de partage de fichiers en cours.

La capacité peut être augmentée pour les partages de fichiers qui se trouvent à l'état stable . Votre autorisation utilisateur est vérifiée avant l'extension du partage de fichiers. Vous pouvez utiliser l'interface utilisateur, la ligne de commande, l'API ou Terraform pour augmenter la capacité de partage de fichiers. Vous pouvez agrandir un partage de fichiers plusieurs fois, jusqu'à atteindre sa capacité maximale. Après avoir étendu le partage de fichiers, vous ne pouvez pas réduire la capacité.

La capacité étendue est déterminée par le maximum autorisé par le profil du partage de fichiers.

Sélectionner la disponibilité Les partages de fichiers régionaux créés avec le profil rfs peuvent être augmentés jusqu'à 32 TB sans restrictions.

Les partages de fichiers zonaux créés avec le profil personnalisé dp2 ou le profil personnalisé Deprecated peuvent être étendus dans la plage d'IOPS autorisée pour cette taille de partage de fichiers.

Les partages de fichiers zonaux créés avec l'un des profils de niveau IOPS ({: tag-red} ) [obsolètes] peuvent être étendus jusqu'à la taille maximale de leur niveau IOPS :

  • Un profil général, 3 IOPS/Go peut être étendu jusqu'à 32 000 Go.
  • Un profil 5 IOPS/Go peut être étendu jusqu'à 9 600 Go.
  • Un profil 10 IOPS/Go peut être étendu jusqu'à 4 800 Go.

Les IOPS sont automatiquement ajustées pour les profils de partage de fichiers à plusieurs niveaux obsolètes, en fonction de la taille du partage de fichiers. Par exemple, si vous développez un partage avec un profil de 5 IOPS/Go de 250 Go à 1 000 Go, il dispose d'un maximum d'IOPS de 5 000 IOPS (capacité de 1 000 Go x 5 IOPS). Étant donné qu'un partage de fichiers de 5 IOPS/Go peut potentiellement atteindre 9 600 Go, le nombre maximal d'IOPS est ajusté à 48 000 IOPS. La capacité et le nombre d'IOPS sont modifiés immédiatement, sans qu'il soit nécessaire de redémarrer l'instance.

Vous pouvez surveiller la progression de l'extension du partage de fichiers à partir de l'interface utilisateur ou de l'interface de ligne de commande. Vous pouvez également consulter les événements de suivi des activités pour vérifier que le partage de fichiers a bien été étendu. Une fois que le partage de fichiers a été étendu, vous ne pouvez pas en réduire la capacité.

Exigences

Le partage de fichiers doit se trouver dans l'état « stable » avant que vous puissiez demander une augmentation de sa capacité.

Limitations

Les limitations suivantes s'appliquent à cette édition.

  • Les partages de fichiers peuvent être étendus, avec les restrictions suivantes :
    • Si le partage de fichiers a été créé avec un profil à plusieurs niveaux limitant la capacité à moins de 32 000 Go, il ne peut être étendu que jusqu'à la capacité autorisée pour ce niveau.
    • Si le partage de fichiers a été créé avec le profil personnalisé dans une plage d'IOPS qui ne permet pas d'étendre à 16 000 Go, le partage ne peut s'étendre que jusqu'à la capacité maximale de la plage spécifiée.
    • Si le partage de fichiers a été créé avec le profil dp2 dans une plage d'IOPS qui ne permet pas l'extension à 32 000 Go, le partage ne peut s'étendre que jusqu'à la capacité maximale de la plage spécifiée.
    • Les partages de fichiers peuvent être étendus plusieurs fois jusqu'à ce que leur capacité maximale soit atteinte.
  • Augmenter le nombre d'IOPS jusqu'à la limite maximale autorisée par le profil.
  • Vous ne pouvez pas modifier indépendamment les IOPS d'un partage de fichiers créé à partir d'un profil de niveau IOPS. Le nombre d'IOPS est ajusté lorsque vous augmentez la capacité.
  • Lorsque vous développez un partage de fichiers créé à partir d'un profil personnalisé ou dp2, la capacité est augmentée, mais les IOPS restent les mêmes sauf si vous choisissez d' ajuster les IOPS.
  • Le nombre maximal d'IOPS pour un partage de fichiers de zone est plafonné à 48 000 IOPS s'il est accessible depuis un seul hôte. Pour un partage de fichiers en zone accessible par plusieurs hôtes, le nombre d'IOPS peut atteindre 96 000.
  • Une fois qu'un partage de fichiers est étendu, vous ne pouvez pas réduire sa taille.

Extension de la capacité de partage de fichiers dans la console

Suivez ces étapes pour augmenter la capacité du partage de fichiers dans la console :

  1. Dans la console IBM Cloud, cliquez sur l'icône de menu Navigation > Infrastructure VPC > Stockage > Partages de stockage de fichiers.

  2. La page contenant la liste des partages de fichiers pour VPC affiche tous les partages de fichiers qui ont été créés dans cette zone. Cliquez sur le nom du partage de fichiers pour accéder à la page des détails.

  3. Sur la page des détails des partages de fichiers, développez le menu Actions.

  4. Sélectionnez Expand file share. Le panneau « Agrandir la taille du partage de fichiers » affiche la taille actuelle du partage de fichiers (en Go) ainsi que le profil auquel il est associé. Vous pouvez également cliquer sur l'icône d'édition en regard des informations sur la taille du partage de fichiers.

  5. Saisissez une taille de partage de fichiers plus importante, basée sur le maximum autorisé pour le profil de partage de fichiers. La valeur par défaut est la taille en cours + 1 Go.

  6. Examinez le récapitulatif de commande mensuel estimé pour votre zone géographique et la nouvelle tarification.

  7. Si vous êtes satisfait, cliquez sur Enregistrer et continuer.

La nouvelle allocation de stockage de vos fichiers est disponible après quelques minutes. Si vos besoins changent, vous pouvez à nouveau augmenter la capacité après avoir augmenté la taille du partage de fichiers et lorsqu'il est à l'état stable.

Vous ne pouvez pas réduire la taille du partage de fichiers après en avoir augmenté la capacité.

Développement de partages de fichiers depuis l'interface de ligne de commande

Pour augmenter la capacité d'un partage de fichiers à partir de l'interface de ligne de commande, utilisez la commande share-update avec l'option --size et indiquez la nouvelle taille du partage de fichiers en Go.

  1. Localisez votre partage à partir de l'interface de ligne de commande en répertoriant vos partages de fichiers dans la région à l'aide de la commande ibmcloud is shares.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
    r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
    r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
    r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
    r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
    r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
    r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0
    
  2. Affichez les détails du partage de fichiers que vous souhaitez modifier à l'aide de la commande ibmcloud is share.

    ibmcloud is share my-file-share
    
 ```sh {: screen}
 Getting file share my-file-share under account Test Account as user test.user@ibm.com...
 ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
 Name                         my-file-share
 CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
 Lifecycle state              stable
 Access control mode          security_group
 Accessor binding role        none
 Zone                         us-south-2
 Profile                      dp2
 Size(GB)                     1000
 IOPS                         1000
 User Tags                    docs:test
 Encryption                   provider_managed
 Mount Targets                ID                                          Name
                              r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
 Resource group               ID                                 Name
                              db8e8d865a83e0aae03f25a492c5b39e   Default
 Created                      2023-10-18T22:15:15+00:00
 Replication role             none
 Replication status           none
 Replication status reasons   Status code   Status message
                              -             -
 Snapshot count               0
 Snapshot size                0
 Source snapshot              -
 Allowed Access Protocols     nfs4
 Availability Mode            zonal
 Bandwidth(Mbps)              1
 Storage Generation           1
  1. Exécutez la commande ibmcloud is share-update pour augmenter la capacité de votre partage de fichiers.
ibmcloud is share-update my-file-share --size 1500
Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1500
IOPS                         1000
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+00:00
Latest job                   Job status   Job status reasons
                             succeeded    -
Replication share            ID                                          Name               Resource type
                             r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share
Replication role             source
Replication status           active
Replication status reasons   Status code   Status message
                             -             -
Snapshot count               0
Snapshot size                0
Source snapshot              -
Allowed Access Protocols     nfs4
Availability Mode            zonal
Bandwidth(Mbps)              1
Storage Generation           1

Pour plus d'informations sur les options de commande, voir ibmcloud is share-update my-file-share.

Augmenter la capacité de partage de fichiers grâce à l'API

Vous pouvez étendre les partages de fichiers existants en appelant l'API VPC. Effectuez une demande PATCH /shares/{id} et spécifiez l'ID du partage de fichiers pour lequel vous souhaitez augmenter la taille.

Cet exemple de demande étend un partage de fichiers d'une capacité de 50 Go à 2500 Go pour un profil de 5 IOPS/Go.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "size": 2500
    }'

Le statut du partage de fichiers indique updating pendant que la capacité est augmentée. La capacité actuelle s'affiche pendant la mise à jour.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "updating",
  "name": "share-name1",
    .
    .
	"size": 2500,
    .
    .
    .
}

Lorsque l'extension du partage de fichiers est terminée, la nouvelle valeur s'affiche et le statut est stable.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "stable",
  "name": "share-name1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
    "name": "dp2",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/875623bcde2b4ebda924d32640908845",
    "id": "875623bcde2b4ebda924d32640908845",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 2500,
  .
  .
  .
}

Développement de partages de fichiers avec Terraform

Pour augmenter la capacité d'un partage de fichiers, utilisez la ressource ibm_is_share. Lorsqu'il est appliqué, l'exemple suivant met à jour la capacité de partage à 300 Go.

resource "ibm_is_share" "example" {
  name    = "my-new-share"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

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

Etapes suivantes

Montez et utilisez vos partages de fichiers :