Criando compartilhamentos de arquivo de réplica

Crie compartilhamentos de arquivos réplicas em outra zona dentro da mesma região metropolitana ou em uma região metropolitana diferente dentro da mesma área geográfica, utilizando o console, a CLI, a API ou o Terraform.

A tabela a seguir mostra quais regiões metropolitanas podem replicar entre si dentro de cada geografia.

Essa tabela mostra as regiões metropolitanas que podem se replicar umas com as outras em cada área geográfica. Cada geografia é uma coluna separada.
Américas Europa Asia
  • Dallas, TX / us-south
  • Montreal / ca-mon
  • São Paulo / br-sao
  • Toronto / ca-tor
  • Washington, DC / us-east
 -Frankfurt / eu-de
-Londres / eu-gb
-Madrid / eu-es
  • Chennai / in-che
  • Mumbai / in-mum
  • Osaka / jp-osa
  • Sydney / au-syd
  • Tóquio / jp-tok

O compartilhamento de arquivo de origem especificado ainda não deve ter outra réplica e não deve ser uma réplica de outro compartilhamento..

Se desejar criar uma réplica em outra região, será necessário estabelecer autorizações de serviço para serviço primeiro. Ambas as instâncias de serviço de arquivo devem pertencer à mesma conta.. A replicação entre contas não é suportada. Para obter mais informações, consulte Estabelecimento de autorizações de serviço a serviço para File Storage for VPC.

Ao criar compartilhamentos de arquivos com disponibilidade regional, os dados são replicados automaticamente em toda a região; portanto, não é necessário configurar pares de replicação dentro da região.

Adicionando replicação a um compartilhamento de arquivos no console

É possível criar uma réplica de seu compartilhamento de arquivo a partir da lista de todos os compartilhamentos de arquivo ou da página de detalhes do compartilhamento de arquivo Se ainda não tiver um compartilhamento de arquivos de origem, provisione um conforme descrito em Criar um compartilhamento de arquivos e montar o destino no console. Quando o compartilhamento de arquivos aparecer como "estável" na página Compartilhamentos de armazenamento de arquivos para VPC, clique no ícone Ações ícone Ações e clique em Criar réplica.

Na página de criação da réplica de Compartilhamento de arquivo, revise os detalhes de compartilhamento de arquivo de origem e conclua os detalhes da réplica

  1. Nome - Insira um nome exclusivo para o compartilhamento da réplica.

  2. Local da réplica-A geografia é pré-selecionada e não pode ser mudada Use o menu “Zona” para selecionar a zona da réplica. O menu está organizado por região. Em cada região, as áreas metropolitanas são listadas em ordem alfabética. Clique na seta ao lado do nome de uma linha do metrô para expandir suas zonas e, em seguida, clique em uma zona para selecioná-la.

  3. Grupo de recursos-Selecione o grupo de recursos na lista

  4. Tags-Opcionalmente, especifique tags do usuário. As tags que você aplica à réplica podem ser iguais ou diferentes das tags do compartilhamento de origem.

  5. Perfil-O perfil do dp2 é pré-selecionado, mesmo se o compartilhamento de arquivo de origem for baseado em um perfil de uma liberação anterior Especifique o valor máximo para o IOPS. Determina o desempenho que você obtém na réplica após executar um failover.

  6. Destinos de montagem — Opcionalmente, crie um destino de montagem para o compartilhamento da réplica. É possível ignorar essa etapa se você não desejar criar um destino de montagem agora Caso contrário, selecione Criar. É possível criar um destino de montagem por VPC por compartilhamento de arquivo. Dependendo do modo de acesso de destino de montagem do compartilhamento, o formulário Criar destino de montagem parece diferente..

    • Se você selecionou o grupo de segurança como modo de acesso, insira as informações conforme descrito na Tabela 2. Essa ação cria e conecta uma interface de rede virtual ao seu destino de montagem que identifica o compartilhamento de arquivo com um endereço IP reservado e aplica as regras do grupo de Segurança selecionado. Esse destino de montagem suporta a montagem de criptografia em trânsito e de zona cruzada
    Valores para a criação de um destino de montagem.
    Campo Valor
    Detalhes
    Nome do destino de montagem Especifique um nome de destino de montagem. O nome pode ter até 63 caracteres alfanuméricos em letras minúsculas e incluir o hífen (-), e deve começar com uma letra minúscula. Se desejar, será possível editar o nome posteriormente.
    Zona A zona é herdada do compartilhamento de arquivo (por exemplo, Dallas 2).
    VPC Selecione uma VPC disponível. A lista inclui apenas as VPCs que possuem uma sub-rede na zona selecionada.
    Sub-rede Selecione uma sub-rede da lista.
    Endereço IP reservado Necessário ao destino de montagem. O endereço IP não pode ser alterado mais tarde Entretanto, é possível excluir o destino de montagem e criar outro com um endereço IP diferente.
    Reservando método É possível que o serviço de arquivo selecione um endereço IP para você. O IP reservado se torna visível após o destino de montagem ser criado. Ou especifique seu próprio IP.
    Liberação automática Libera o endereço IP ao excluir o destino de montagem. Ativado por padrão.
    Grupos de segurança O grupo de segurança padrão para o VPCs é selecionado Você pode usá-lo ou selecionar outro grupo de segurança na lista.
    • Depreciado Se você selecionou VPC como modo de acesso, forneça um nome para o destino de montagem e selecione uma VPC na lista. Esse destino de montagem pode ser usado para montar o compartilhamento de arquivo em qualquer instância de servidor virtual do VPC selecionado, na mesma zona que o compartilhamento de arquivo A montagem de zona cruzada não é suportada

    O modo de acesso VPC está obsoleto e chegará ao fim do suporte em 6 de maio de 2027. Siga o guia de migração para atualizar o modo de controle de acesso do compartilhamento de origem para security-group.

  7. Frequência de sincronização-Especifique com que frequência você deseja sincronizar mudanças do compartilhamento de arquivo primário para o compartilhamento de réplica. Em “Frequência”, selecione uma das opções a seguir e configure a hora de início:

    • A cada 15 minutos: Insira o valor em minutos para a hora de início.
    • Por hora: Insira o valor em minutos correspondente à hora de início.
    • Diariamente: Insira a hora de início no Tempo Universal Coordenado (UTC) no formato HH:MM, entre 00:00 e 23:59.
    • Semanal: Selecione o dia ou os dias da semana em que a replicação será executada e insira a hora de início em UTC no formato HH:MM, entre 00:00 e 23:59.
    • Mensal: Insira o dia do mês em que a replicação é executada (1 a 31) e insira a hora de início em UTC no formato HH:MM, entre 00:00 e 23:59.
    • Expressão Cron: Insira uma expressão do tipo “ cron-spec ” no formato minute hour day month weekday. A replicação deve ser agendada com um intervalo mínimo de 15 minutos entre as execuções. Por exemplo, para realizar a replicação todos os dias às 17h30 UTC, digite 30 17 * * *.

  8. Criptografia — A réplica sempre herda as configurações de criptografia do compartilhamento de origem. O tipo de criptografia não pode ser alterado. Se o compartilhamento de origem utilizar criptografia gerenciada pelo provedor, o bloco “gerenciado pelo provedor” será exibido, mas não poderá ser selecionado. Se o compartilhamento de origem utilizar criptografia gerenciada pelo cliente, os detalhes da chave serão exibidos como somente leitura, incluindo o tipo de criptografia, o nome da chave, a instância do serviço de gerenciamento de chaves e o ID da chave.

  9. No painel lateral, revise seu custo estimado e aplique um código de desconto, se você tiver um.

  10. Clique em “Criar compartilhamento de arquivos ”.

Se você ainda não estiver pronto para encomendar ou apenas procurando informações de precificação, será possível incluir as informações que você vê no painel lateral em uma Estimativa. Para obter mais informações sobre como esse recurso funciona, consulte Estimativa de seus custos.

Adicionando replicação a um compartilhamento de arquivos pela CLI

Você pode usar a CLI para criar um compartilhamento de arquivo com uma réplica de compartilhamento em outra zona ou região, ou para criar uma réplica de compartilhamento para um compartilhamento de arquivo existente.

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

Criando um compartilhamento de arquivo com uma réplica por meio da CLI

É possível criar um compartilhamento de arquivos por zona com uma réplica na mesma região ao mesmo tempo. Essa abordagem só é compatível com compartilhamentos zonais cujas réplicas permaneçam na mesma região. As réplicas inter-regionais devem ser criadas em uma etapa separada, pois exigem que o compartilhamento de origem esteja em um estado estável no momento da inicialização da réplica.

Ao usar o comando ' ibmcloud is share-create para criar o compartilhamento, você pode criar um compartilhamento de réplica ao mesmo tempo, especificando valores para as opções ' --replica-share-name, ' --replica-share-profile, ' --replica-share-cron-spec,--replica-share-zone. A especificação cron especifica a frequência de replicação e você pode programar a replicação dos dados com uma frequência de até 15 minutos. Para obter mais informações sobre as opções de comando, consulte ' ibmcloud is share-create.

No exemplo a seguir, um compartilhamento my-source-file-share é criado em us-south-2 com um compartilhamento de arquivo de réplica my-replica-file-share em us-south-1. Neste exemplo, apenas um destino de montagem é criado para o compartilhamento de arquivos de origem. Você também pode criar um destino de montagem para o compartilhamento de réplica usando a mesma sintaxe JSON com a opção --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

Criação de uma réplica para um compartilhamento de arquivos existente a partir da CLI

É possível criar uma réplica de um compartilhamento de arquivos existente na mesma região ou em outra região dentro da mesma área geográfica.

  1. Localize seu compartilhamento de arquivo de origem na CLI listando seus compartilhamentos de arquivo na região com o 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. Visualize os detalhes do compartilhamento de arquivo que deseja usar como sua origem com o comando ibmcloud is share. É possível usar o nome ou ID do compartilhamento ao criar uma réplica na mesma região. Se você criar a réplica em outra região, anote o CRN do compartilhamento de arquivo de origem

    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. Crie um compartilhamento de réplica executando o comando ibmcloud is share-replica-create na região de destino. Se você não estiver direcionando a região correta, use o comando ibmcloud target -r REGION para mudar a região de destino. Especifique o compartilhamento de origem por ID ou CRN usando a opção --source-share-id. Forneça valores para definir a zona em que o compartilhamento de arquivos de réplica será criado e o perfil do compartilhamento de réplica. Especifique o cronograma de replicação com uma expressão cron usando a opção --replication-cron-spec. Se o compartilhamento do arquivo de origem tiver a criptografia user_managed, você deverá fornecer o endereço --encryption-key-crn. A propriedade --encryption-key-crn não deve ser especificada de outra forma.

    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

Adicionando replicação a um compartilhamento de arquivos por meio da API

É possível configurar programaticamente a replicação chamando o método /shares na API do VPC, conforme mostrado nas solicitações de amostra a seguir:

Antes de começar, primeiro configure o Ambiente da API. Para obter mais informações sobre a API da VPC de compartilhamentos de arquivos, consulte a Referência da API da VPC.

Criando um compartilhamento de arquivo com uma réplica com a API.

É possível criar um compartilhamento de arquivos por zona com uma réplica na mesma região ao mesmo tempo. Essa abordagem só é compatível com compartilhamentos zonais cujas réplicas permaneçam na mesma região. As réplicas inter-regionais devem ser criadas em uma etapa separada, pois exigem que o compartilhamento de origem esteja em um estado estável no momento da inicialização da réplica.

Ao criar um compartilhamento de arquivos, é possível especificar que um compartilhamento de arquivos réplica também seja criado em uma zona diferente. Faça uma solicitação POST /shares e especifique a propriedade replica_share para definir o compartilhamento de arquivo de réplica.

O seguinte exemplo cria a réplica test-replica-001 para o compartilhamento de origem source-share-001. Os destinos de montagem, que são opcionais ao criar um compartilhamento de arquivos, são especificados para o compartilhamento de arquivos réplica e para o compartilhamento de arquivos de origem.

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"]
   }'

Criando uma réplica para um compartilhamento de arquivo existente com a API

Para adicionar replicação a um compartilhamento de arquivos existente, é necessário criar um compartilhamento de réplica em uma zona diferente. Na solicitação POST /shares, especifique o nome e o perfil do compartilhamento de réplica e especifique o source_share por seu nome, ID ou CRN. Outras propriedades necessárias são o zone e o ` `replication_cron_spec, que definem a programação da replicação. Você pode programar a replicação de seus dados com uma frequência de até 15 minutos.

Incluindo replicação no compartilhamento de arquivo com o Terraform

É possível usar o recurso ibm_is_share no Terraform para criar um compartilhamento de arquivo com replicação ou atualizar um compartilhamento de arquivo para incluir a replicação.

O exemplo a seguir cria um compartilhamento réplica na zona us-south-3 e o associa ao compartilhamento pai especificado por seu 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 * * *"
}

O exemplo a seguir cria um compartilhamento de arquivo em us-south-1 com uma réplicas em 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"
  }
}

Próximas etapas