Creazione di condivisioni file di replica

Creare condivisioni di file replica in un'altra zona all'interno della stessa regione metropolitana o in una regione metropolitana diversa all'interno della stessa area geografica utilizzando la console, la CLI, l'API o Terraform.

La seguente tabella mostra quali regioni della metropolitana possono replicarsi tra loro in ogni area geografica.

Questa tabella mostra le regioni metropolitane che possono replicarsi l'una con l'altra in ogni geografia. Ogni area geografica è una colonna separata.
Americhe Europa Asia
  • Dallas, TX / us-south
  • Montreal / ca-mon
  • San Paolo / br-sao
  • Toronto / ca-tor
  • Washington, DC / us-east
  • Francoforte / eu-de
  • Londra / eu-gb
  • Madrid / eu-es
  • Chennai / in-che
  • Mumbai / in-mum
  • Osaka / jp-osa
  • Sydney / au-syd
  • Tokyo / jp-tok

La condivisione file di origine specificata non deve avere già un'altra replica e non deve essere una replica di un'altra condivisione.

Se vuoi creare una replica in un'altra regione, devi stabilire prima le autorizzazioni service - to - service. Entrambe le istanze del servizio file devono appartenere allo stesso account. La replica tra account non è supportata. Per ulteriori informazioni, vedere Stabilire le autorizzazioni da servizio a servizio per File Storage for VPC.

Quando si creano condivisioni di file con disponibilità regionale, i dati vengono replicati automaticamente in tutta la regione, quindi non è necessario configurare coppie di replica all'interno della regione.

Aggiunta della replica a una condivisione di file nella console

È possibile creare una replica della condivisione file dall'elenco di tutte le condivisioni file o dalla pagina dei dettagli della condivisione file. Se non si dispone già di una condivisione di file di origine, è necessario configurarne una come descritto in Creare una condivisione di file e montare il target nella console. Quando la condivisione di file viene visualizzata come "stabile" nella pagina Condivisioni di archiviazione file per VPC, fare clic sull'icona Azioni Azioni Azioni e fare clic su Crea replica.

Nella pagina di creazione della replica di condivisione file, esaminare i dettagli della condivisione file di origine e completare i dettagli della replica.

  1. Nome - Fornire un nome univoco per la condivisione della replica.

  2. Ubicazione replica - L'area geografica è preselezionata e non è possibile modificarla. Utilizza il menu " Zona " per selezionare la zona per la replica. Il menu è suddiviso per area geografica. All’interno di ciascuna area geografica, le località metropolitane sono elencate in ordine alfabetico. Fai clic sulla freccia accanto al nome di una linea della metropolitana per espandere le relative zone, quindi fai clic su una zona per selezionarla.

  3. Gruppo di risorse - Selezionare il gruppo di risorse dall'elenco.

  4. Tag - Facoltativamente, specificare tag utente. I tag che si applicano alla replica possono essere uguali o diversi dai tag della condivisione di origine.

  5. Profilo - Il profilo dp2 è preselezionato, anche se la condivisione del file di origine si basa su un profilo di una release precedente. Specificare il valore massimo per IOPS. Determina le prestazioni che si ottengono sulla replica dopo aver eseguito un failover.

  6. Destinazioni di montaggio - facoltativamente, creare una destinazione di montaggio per la condivisione di repliche. È possibile ignorare questo passo se non si desidera creare una destinazione di montaggio ora. Altrimenti, fare clic su Crea. È possibile creare una sola destinazione di montaggio per VPC per condivisione file. A seconda della modalità di accesso della destinazione di montaggio della condivisione, il modulo Crea destinazione montaggio ha un aspetto diverso.

    • Se si è selezionato il gruppo di sicurezza come modalità di accesso, inserire le informazioni come descritto nella Tabella 2. Questa azione crea e collega un' interfaccia di rete virtuale alla destinazione di montaggio che identifica la condivisione file con un indirizzo IP riservato e applica le regole del gruppo di protezione selezionato. Questa destinazione di montaggio supporta la crittografia in transito e il montaggio tra zone.
    Valori per la creazione di una destinazione di montaggio.
    Campo Valore
    Dettagli
    Nome destinazione di montaggio Specificare un nome di destinazione di montaggio. Il nome può contenere fino a 63 caratteri alfanumerici in minuscolo, compreso il trattino (-), e deve iniziare con una lettera minuscola. Puoi modificare successivamente il nome, se lo desideri.
    Zona La zona viene ereditata dalla condivisione file (ad esempio, Dallas 2).
    VPC Selezionare un VPC disponibile. L'elenco include solo i VPC che dispongono di una sottorete nella zona selezionata.
    Sottorete Selezionare una sottorete dall'elenco.
    Indirizzo IP riservato Richiesto per la destinazione di montaggio. L'indirizzo IP non può essere modificato successivamente. Tuttavia, è possibile eliminare la destinazione di montaggio e crearne un'altra con un diverso indirizzo IP.
    Metodo per l'assegnazione di un indirizzo IP riservato È possibile fare in modo che il servizio file selezioni un indirizzo IP. L'IP riservato diventa visibile dopo la creazione della destinazione di montaggio. In alternativa, specificare il proprio IP.
    Rilascio automatico Rilascia l'indirizzo IP quando si elimina la destinazione di montaggio. Abilitato per impostazione predefinita.
    Gruppi di sicurezza Viene selezionato il gruppo di sicurezza predefinito per il VPC. È possibile utilizzarlo oppure selezionare un altro gruppo di sicurezza dall'elenco.
    • Deprecato Se si è selezionato VPC come modalità di accesso, fornire un nome per la destinazione di montaggio e selezionare un VPC dall'elenco. Questa destinazione di montaggio può essere utilizzata per montare la condivisione file su qualsiasi istanza del server virtuale del VPC selezionato nella stessa zona della condivisione file. Il montaggio tra zone non è supportato.

    La modalità di accesso VPC è obsoleta e il supporto terminerà il 6 maggio 2027. Seguire la guida alla migrazione per aggiornare la modalità di controllo dell'accesso della condivisione di origine a security-group.

  7. Frequenza di sincronizzazione - Specificare la frequenza con cui si desidera sincronizzare le modifiche dalla condivisione file principale alla condivisione replica. Per la frequenza, selezionare una delle seguenti opzioni e configurare l'ora di inizio:

    • Ogni 15 minuti: inserire il valore in minuti corrispondente all'ora di inizio.
    • Orario: inserire il valore in minuti corrispondente all'ora di inizio.
    • Giornaliero: inserire l'ora di inizio in Tempo Universale Coordinato (UTC) nel formato HH:MM, compresa tra 00:00 e 23:59.
    • Settimanale: selezionare il giorno o i giorni della settimana in cui deve essere eseguita la replica e inserire l'ora di inizio in UTC nel formato HH:MM, compresa tra 00:00 e 23:59.
    • Mensile: inserire il giorno del mese in cui viene eseguita la replica (da 1 a 31) e l'ora di inizio in UTC nel formato HH:MM, compresa tra 00:00 e 23:59.
    • Espressione Cron: inserire un'espressione di tipo " cron-spec " nel formato minute hour day month weekday. La replica deve essere programmata a un intervallo di almeno 15 minuti. Ad esempio, per eseguire la replica ogni giorno alle 17:30 UTC, inserisci 30 17 * * *.
  8. Crittografia - La replica eredita sempre le impostazioni di crittografia della condivisione di origine. Non è possibile modificare il tipo di crittografia. Se la condivisione di origine utilizza la crittografia gestita dal provider, il riquadro relativo alla crittografia gestita dal provider viene visualizzato ma non è selezionabile. Se la condivisione di origine utilizza la crittografia gestita dal cliente, i dettagli relativi alla chiave vengono visualizzati in sola lettura, inclusi il tipo di crittografia, il nome della chiave, l'istanza del servizio di gestione delle chiavi e l'ID della chiave.

  9. Nel pannello laterale, controlla il tuo costo stimato e applica un codice di sconto, se ne hai uno.

  10. Fare clic su " Crea condivisione file ".

Se non sei ancora pronto per ordinare o stai solo cercando informazioni sui prezzi, puoi aggiungere le informazioni che vedi nel pannello laterale a una stima. Per ulteriori informazioni sul funzionamento di questa funzione, vedere Stima dei costi.

Aggiunta della replica alla condivisione file dalla CLI

È possibile utilizzare la CLI per creare una condivisione di file con una condivisione di replica in un'altra zona o regione, oppure per creare una condivisione di replica per una condivisione di file esistente.

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

Creazione di una condivisione file con una replica dalla CLI

È possibile creare contemporaneamente una condivisione di file a livello di zona con una replica nella stessa regione. Questo approccio è supportato solo per le quote zonali con repliche che rimangono nella stessa regione. Le repliche interregionali devono essere create in una fase separata, poiché richiedono che la condivisione di origine si trovi in uno stato stabile al momento dell'inizializzazione della replica.

Quando si utilizza il comando 'ibmcloud is share-create per creare la condivisione, è possibile creare contemporaneamente una condivisione di replica specificando i valori delle opzioni '--replica-share-name, '--replica-share-profile, '--replica-share-cron-spec,--replica-share-zone. La specifica cron specifica la frequenza di replica; è possibile programmare la replica dei dati con una frequenza di 15 minuti. Per ulteriori informazioni sulle opzioni del comando, vedere 'ibmcloud is share-create.

Nel seguente esempio, una condivisione my-source-file-share viene creata in us-south-2 con una condivisione file di replica my-replica-file-share in us-south-1. In questo esempio, viene creata una sola destinazione di montaggio per la condivisione file di origine. È anche possibile creare una destinazione di montaggio per la condivisione di replica utilizzando la stessa sintassi JSON con l'opzione --replica-share-mount-targets.

ibmcloud is share-create --name my-source-file-share --zone us-south-2 --profile dp2 --size 1500 --iops 2000  --user-tags env:dev --mount-targets '[{"name":"my-source-mount-target","virtual_network_interface": {"name":"my-source-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]' --replica-share-name my-replica-file-share --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-1
Creating file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Name                               my-source-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
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)                           1500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-67799c85-09cf-4cfe-811d-effa10c99395   my-source-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-08-01T17:25:05+00:00
Replication share                  ID                                          Name                    Resource type
                                   r006-2068a709-8c18-4844-8c1d-42b83889dfb3   my-replica-file-share   share
Replication role                   source
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

Creazione di una replica per una condivisione file esistente dalla CLI

È possibile creare una replica di una condivisione di file esistente nella stessa regione o in un'altra regione all'interno della stessa area geografica.

  1. Individua la tua condivisione file di origine dalla CLI elencando le tue condivisioni file nella regione con il comando 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. Visualizzare i dettagli della condivisione file che si desidera utilizzare come origine con il comando ibmcloud is share. Puoi utilizzare il nome o l'ID della condivisione quando crei una replica nella stessa regione. Se si crea la replica in un'altra regione, prendere nota del CRN della condivisione file di origine.

    ibmcloud is share my-file-share
    
    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
    
  3. Creare una condivisione di replica eseguendo il comando ibmcloud is share-replica-create nella regione di destinazione. Se non si sta puntando alla regione giusta, usare il comando ibmcloud target -r REGION per cambiare la regione di destinazione. Specificare la condivisione di origine per ID o CRN utilizzando l'opzione --source-share-id. Fornire i valori per definire la zona in cui verrà creata la condivisione di file di replica e il profilo della condivisione di replica. Specificare la pianificazione della replica con un'espressione cron utilizzando l'opzione --replication-cron-spec. Se la condivisione di file di origine ha la crittografia user_managed, è necessario fornire l'indirizzo --encryption-key-crn. La proprietà --encryption-key-crn non deve essere specificata altrimenti.

    ibmcloud is share-replica-create --name my-replica-share --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share my-file-share
    
    Creating replica file share my-replica-share under account Test Account as user test.user@ibm.com...
    ID                               r006-6d1719da-f790-45cc-9f68-896fd5673a1a
    Name                             my-replica-share
    CRN                              crn:v1:bluemix:public:is:us-south-3:a/a1234567::share:r006-6d1719da-f790-45cc-9f68-896fd5673a1a
    Lifecycle state                  pending
    Access control mode              security_group
    Accessor binding role            origin
    Allowed transit encryption modes ipsec,none
    Zone                             us-south-3
    Profile                          dp2
    Size(GB)                         1000
    IOPS                             100
    User Tags                        docs:test
    Encryption                       provider_managed
    Mount Targets                    ID                          Name
                                     No mounted targets found.
    Resource group                   ID                                 Name
                                     db8e8d865a83e0aae03f25a492c5b39e   Default
    Created                          2024-06-25T15:13:18+00:00
    Latest job                       Job status   Job status reasons
                                     running      -
    Replication cron spec            10 05 * * *
    Replication role                 replica
    Replication status               initializing
    Replication status reasons       Status code   Status message
                                     -             -
    Source share                     ID                                          Name            Resource type
                                     r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share   share
    Snapshot count                   0
    Snapshot size                    0
    Source snapshot                  -
    Allowed Access Protocols         nfs4
    Availability Mode                zonal
    Bandwidth(Mbps)                  1
    Storage Generation               1
    

Aggiunta della replica alla condivisione file con l'API

Puoi programmaticamente configurare la replica richiamando il metodo /shares nella API VPC come mostrato nelle seguenti richieste di esempio.

Prima di iniziare, configurare l'ambiente API. Per ulteriori informazioni sull'API VPC delle condivisioni file, vedi il Riferimento API VPC.

Creazione di una condivisione file con una replica con l'API

È possibile creare contemporaneamente una condivisione di file a livello di zona con una replica nella stessa regione. Questo approccio è supportato solo per le quote zonali con repliche che rimangono nella stessa regione. Le repliche interregionali devono essere create in una fase separata, poiché richiedono che la condivisione di origine si trovi in uno stato stabile al momento dell'inizializzazione della replica.

Quando si crea una condivisione file, è possibile specificare che una condivisione file di replica viene creata anche in una zona diversa. Effettuare una richiesta POST /shares e specificare la proprietà replica_share per definire la condivisione del file di replica.

Il seguente esempio crea la replica test-replica-001 per la condivisione di origine source-share-001. Le destinazioni di montaggio, che sono facoltative quando si crea una condivisione file, vengono specificate per la condivisione file di replica e la condivisione file di origine.

curl -X POST\
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "name": "source-share-001",
    "profile":{"name":"dp2"},
    "size":100,
    "iops": 400,
    "mount-targets":[{"vpc":{"id":"08669c86-4c8a-4bfa-8ddc-37071f955c52"}],
    "zone":{"name":"us-south-1"},
    "replica_share":{
  	   "name": "test-replica-001",
      "profile":{"name":"dp2"},
      "replication_cron_spec":"0 */5 * * *",
      "zone":{"name":"us-south-3"},
      "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
      "resource_group": {},
      "allowed_transit_encryption_modes": "ipsec",
      "user_tags": ["string"]}}]
      }
    "resource_group": {},
    "allowed_transit_encryption_modes": "ipsec",
    "user_tags": ["string"]
   }'

Creazione di una replica per una condivisione file esistente con l'API

Per aggiungere la replica a una condivisione di file esistente, è necessario creare una condivisione replica in una zona diversa. Nella richiesta POST /shares, specificare il nome e il profilo della condivisione di replica e specificare source_share in base al nome, ID o CRN. Altre proprietà richieste sono zone e replication_cron_spec, che fornisce la pianificazione della replica. È possibile programmare la replica dei dati con una frequenza di 15 minuti.

Aggiunta della replica alla condivisione file con Terraform

Puoi utilizzare la risorsa ibm_is_share in Terraform per creare una condivisione file con la replica o aggiornare una condivisione file per includere la replica.

L'esempio seguente crea una condivisione replica nella zona us-south-3 e la associa alla condivisione principale specificata dal suo ID ibm_is_share.example.id.

resource "ibm_is_share" "my-replica1" {
  zone                  = "us-south-3"
  source_share          = ibm_is_share.example.id
  name                  = "my-replica1"
  profile               = "dp2"
  replication_cron_spec = "0 */5 * * *"
}

Il seguente esempio crea una condivisione file in us-south-1 con una replica in us-south-3.

resource "ibm_is_share" "my-replica" {
  zone    = "us-south-1"
  size    = 220
  name    = "my-share"
  profile = "dp2"
  replica_share {
    name                  = "my-replica"
    replication_cron_spec = "0 */5 * * *"
    profile               = "dp2"
    zone                  = "us-south-3"
  }
}

Passi successivi