Replikatdateifreigaben erstellen

Erstellen Sie Replik-Dateifreigaben in einer anderen Zone innerhalb derselben Metropolregion oder in einer anderen Metropolregion innerhalb derselben geografischen Region mithilfe der Konsole, der Befehlszeilenschnittstelle (CLI), der API oder von Terraform.

Die folgende Tabelle zeigt, welche Metropolregionen in den einzelnen Regionen miteinander repliziert werden können.

Diese Tabelle zeigt die Metropolregionen, die in jeder Region miteinander verglichen werden können. Jede Geografie ist eine separate Spalte.
Nord- und Südamerika Europa Asien
  • Dallas, TX / us-south
  • Montreal / ca-mon
  • São Paulo / br-sao
  • Toronto / ca-tor
  • Washington, DC / us-east
-Frankfurt/ eu-de
-London/ eu-gb
-Madrid/ eu-es
  • Chennai / in-che
  • Mumbai / in-mum
  • Osaka / jp-osa
  • Sydney / au-syd
  • Tokio / jp-tok

Die angegebene Quellendateifreigabe darf noch kein Replikat haben und darf kein Replikat einer anderen Freigabe sein.

Wenn Sie ein Replikat in einer anderen Region erstellen wollen, müssen Sie zuerst Service-zu-Service-Berechtigungen einrichten. Beide Dateiserviceinstanzen müssen zu demselben Konto gehören. Die kontenübergreifende Replikation wird nicht unterstützt. Weitere Informationen finden Sie unter Einrichtung von Dienst-zu-Dienst-Berechtigungen für File Storage for VPC.

Wenn Sie Dateifreigaben mit regionaler Verfügbarkeit erstellen, werden die Daten automatisch in der gesamten Region repliziert, sodass Sie keine Replikationspaare innerhalb der Region einrichten müssen.

Replikation zu einer Dateifreigabe in der Konsole hinzufügen

Sie können eine Replik Ihrer Dateifreigabe aus der Liste aller Dateifreigaben oder der Detailseite der Dateifreigabe erstellen. Wenn Sie noch keine Quelldateifreigabe haben, richten Sie eine ein, wie unter Erstellen einer Dateifreigabe und Einhängen des Ziels in der Konsole beschrieben. Wenn die Dateifreigabe auf der Seite Dateispeicherfreigaben für VPC als "stabil" angezeigt wird, klicken Sie auf das Symbol Aktionen Aktionen Aktionen und klicken Sie auf Replikat erstellen.

Überprüfen Sie auf der Seite 'Replik der Dateifreigabe erstellen' die Details der Quellendateifreigabe und vervollständigen Sie die Replikatdetails.

  1. Name – Geben Sie einen eindeutigen Namen für die Replik-Freigabe an.

  2. Replikatposition-Die Geografie ist vorausgewählt und kann nicht geändert werden. Wählen Sie über das Menü Zone die Zone für die Replik aus. Das Menü ist nach Regionen gegliedert. Unter jeder Region sind die Metropolen alphabetisch aufgelistet. Klicken Sie auf den Pfeil neben dem Namen einer Metro, um deren Zonen anzuzeigen, und klicken Sie dann auf eine Zone, um sie auszuwählen.

  3. Ressourcengruppe-Wählen Sie die Ressourcengruppe aus der Liste aus.

  4. Tags-Geben Sie optional Benutzertags an. Die Tags, die Sie auf das Replikat anwenden, können mit den Tags der Quellenfreigabe identisch sein oder sich von diesen unterscheiden.

  5. Profil-Das Profil dp2 ist vorausgewählt, auch wenn die Quellendateifreigabe auf einem Profil aus einem früheren Release basiert. Geben Sie den Maximalwert für IOPS an. Er bestimmt die Leistung, die Sie auf dem Replikat erzielen, nachdem Sie einen Failover durchgeführt haben.

  6. Einbindepunkte – Erstellen Sie optional einen Einbindepunkt für die Replik-Freigabe. Sie können diesen Schritt überspringen, wenn kein Mountziel erstellt werden soll. Andernfalls klicken Sie auf Erstellen. Sie können ein Mountziel pro VPC und Dateifreigabe erstellen. Abhängig vom Zugriffsmodus des Mountziels der Freigabe sieht das Formular Mountziel erstellen anders aus.

    • Wenn Sie die Sicherheitsgruppe als Zugriffsmodus ausgewählt haben, geben Sie die Informationen wie in Tabelle 2 beschrieben ein. Diese Aktion erstellt eine virtuelle Netzschnittstelle und ordnet sie Ihrem Mountziel zu, die die Dateifreigabe mit einer reservierten IP-Adresse identifiziert und die Regeln der ausgewählten Sicherheitsgruppe anwendet. Dieses Mountziel unterstützt die Verschlüsselung bei der Übertragung und das zonenübergreifende Anhängen.
    Werte für die Erstellung eines Einhängeziels.
    Feld Wert
    Details
    Name des Mountziels Geben Sie einen Namen für das Einhängeziel an. Der Name darf bis zu 63 alphanumerische Zeichen in Kleinbuchstaben enthalten, einschließlich des Bindestrichs (-), und muss mit einem Kleinbuchstaben beginnen. Bei Bedarf kann der Name zu einem späteren Zeitpunkt bearbeitet werden.
    Zone Zone wird von der Dateifreigabe übernommen (z. B. Dallas 2)
    VPC Wählen Sie eine verfügbare VPC aus. Die Liste enthält nur jene VPCs, die über ein Subnetz in der ausgewählten Zone verfügen.
    Teilnetz Wählen Sie ein Teilnetz aus der Liste aus.
    Reservierte IP-Adresse Erforderlich für das Mountziel. Die IP-Adresse kann danach nicht geändert werden. Sie können das Mountziel jedoch löschen und ein anderes mit einer anderen IP-Adresse erstellen.
    Reservierungsmethode Sie können den Dateiservice eine IP-Adresse für Sie auswählen lassen. Die reservierte IP wird sichtbar, nachdem das Mountziel erstellt wurde. Oder geben Sie Ihre eigene IP an.
    Automatische Freigabe Gibt die IP-Adresse frei, wenn Sie das Mountziel löschen Standardmäßig aktiviert.
    Sicherheitsgruppen Die Standardsicherheitsgruppe für die VPC ist ausgewählt. Sie können sie verwenden oder eine andere Sicherheitsgruppe aus der Liste auswählen.
    • Veraltet Wenn Sie VPC als Zugriffsmodus gewählt haben, geben Sie einen Namen für das Einhängeziel an und wählen einen VPC aus der Liste aus. Dieses Mountziel kann zum Anhängen der Dateifreigabe an eine beliebige virtuelle Serverinstanz der ausgewählten VPC in derselben Zone wie die Dateifreigabe verwendet werden. Zonenübergreifendes Anhängen wird nicht unterstützt.

    Der VPC-Zugriffsmodus ist veraltet und wird am 6. Mai 2027 nicht mehr unterstützt. Folgen Sie der Migrationsanleitung, um den Zugriffskontrollmodus der Quellfreigabe auf security-group zu aktualisieren.

  7. Synchronisationsfrequenz-Geben Sie an, wie oft Änderungen aus der primären Dateifreigabe mit der Replikatfreigabe synchronisiert werden sollen. Wählen Sie unter Häufigkeit eine der folgenden Optionen aus und legen Sie die Startzeit fest:

    • Alle 15 Minuten: Geben Sie den Minutenwert für die Startzeit ein.
    • Stündlich: Geben Sie den Minutenwert für die Startzeit ein.
    • Täglich: Geben Sie die Startzeit in koordinierter Weltzeit (UTC) im Format HH:MM zwischen 00:00 und 23:59 ein.
    • Wöchentlich: Wählen Sie den Tag oder die Tage der Woche aus, an denen die Replikation ausgeführt werden soll, und geben Sie die Startzeit in UTC im Format HH:MM zwischen 00:00 und 23:59 ein.
    • Monatlich: Geben Sie den Tag des Monats ein, an dem die Replikation ausgeführt wird (1–31), und geben Sie die Startzeit in UTC im Format HH:MM zwischen 00:00 und 23:59 ein.
    • Cron-Ausdruck: Geben Sie einen Ausdruck cron-spec im Format ein minute hour day month weekday. Die Replikation muss in Abständen von mindestens 15 Minuten geplant werden. Um beispielsweise täglich um 17:30 Uhr UTC eine Replikation durchzuführen, geben Sie Folgendes ein: 30 17 * * *.
  8. Verschlüsselung – Die Replik übernimmt stets die Verschlüsselungseinstellungen der Quellfreigabe. Die Verschlüsselungsart kann nicht geändert werden. Wenn für die Quellfreigabe eine vom Anbieter verwaltete Verschlüsselung verwendet wird, wird die Kachel Vom Anbieter verwaltet angezeigt, ist jedoch nicht auswählbar. Wenn für die Quellfreigabe eine vom Kunden verwaltete Verschlüsselung verwendet wird, werden die Schlüsseldetails als schreibgeschützt angezeigt, darunter der Verschlüsselungstyp, der Schlüsselname, die Instanz des Schlüsselverwaltungsdienstes und die Schlüssel-ID.

  9. Überprüfen Sie in der Seitenleiste die geschätzten Kosten und wenden Sie, falls vorhanden, einen Rabattcode an.

  10. Klicken Sie auf Dateifreigabe erstellen.

Wenn Sie noch nicht zur Bestellung bereit sind oder nach Preisinformationen suchen, können Sie die Informationen, die in der seitlichen Anzeige angezeigt werden, zu einer Schätzung hinzufügen. Weitere Informationen zur Funktionsweise dieser Funktion finden Sie unter Schätzung Ihrer Kosten.

Replikation für eine Dateifreigabe über die Befehlszeilenschnittstelle (CLI) hinzufügen

Sie können die CLI verwenden, um eine Dateifreigabe mit einer Replikatfreigabe in einer anderen Zone oder Region zu erstellen oder um eine Replikatfreigabe für eine vorhandene Dateifreigabe zu erstellen.

Bevor Sie die Befehlszeilenschnittstelle (CLI) verwenden können, müssen Sie die IBM Cloud-CLI und das VPC-CLI-Plug-in installieren. Weitere Informationen finden Sie unter CLI-Voraussetzungen.

Dateifreigabe mit einem Replikat über die Befehlszeilenschnittstelle erstellen

Sie können eine zonale Dateifreigabe erstellen und gleichzeitig eine Replik in derselben Region einrichten. Dieser Ansatz wird nur für zonale Anteile unterstützt, deren Replikate in derselben Region verbleiben. Regionsübergreifende Replikate müssen in einem separaten Schritt erstellt werden, da sich die Quellfreigabe zum Zeitpunkt der Initialisierung des Replikats in einem stabilen Zustand befinden muss.

Wenn Sie mit dem Befehl ' ibmcloud is share-create Ihre Freigabe erstellen, können Sie gleichzeitig eine Replikatfreigabe erstellen, indem Sie Werte für die Optionen ' --replica-share-name, ' --replica-share-profile, ' --replica-share-cron-spec,--replica-share-zone angeben. Die cron-Spezifikation gibt die Replikationshäufigkeit an, und Sie können die Replikation Ihrer Daten in Abständen von bis zu 15 Minuten planen. Weitere Informationen zu den Befehlsoptionen finden Sie unter ' ibmcloud is share-create.

Im folgenden Beispiel wird eine gemeinsam genutzte Ressource my-source-file-share in us-south-2 mit einer Replikatdateifreigabe my-replica-file-share in us-south-1 erstellt. In diesem Beispiel wird nur ein Einhängeziel für die Quelldatei-Freigabe erstellt. Sie können auch ein Einhängeziel für die Replikatfreigabe erstellen, indem Sie die gleiche JSON-Syntax mit der Option --replica-share-mount-targets verwenden.

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

Erstellen einer Replik für eine vorhandene Dateifreigabe über die Befehlszeilenschnittstelle (CLI)

Sie können eine Replik einer vorhandenen Dateifreigabe in derselben Region oder in einer anderen Region innerhalb desselben geografischen Gebiets erstellen.

  1. Lokalisieren Sie Ihre Quellendateifreigabe über die Befehlszeilenschnittstelle, indem Sie Ihre Dateifreigaben in der Region mit dem Befehl ibmcloud is shares auflisten.

    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. Zeigen Sie mit dem Befehl ibmcloud is share die Details der Dateifreigabe an, die Sie als Quelle verwenden möchten. Sie können den Namen oder die ID der Freigabe verwenden, wenn Sie ein Replikat in derselben Region erstellen. Wenn Sie das Replikat in einer anderen Region erstellen, notieren Sie den CRN der Quellendateifreigabe.

    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. Erstellen Sie eine Replikatfreigabe, indem Sie den Befehl ibmcloud is share-replica-create in der Zielregion ausführen. Wenn Sie nicht die richtige Region anvisieren, verwenden Sie den Befehl ibmcloud target -r REGION, um die Zielregion zu wechseln. Geben Sie die Quellfreigabe nach ID oder CRN an, indem Sie die Option --source-share-id verwenden. Geben Sie Werte an, um die Zone zu definieren, in der die Replikatfreigabe erstellt werden soll, sowie das Profil der Replikatfreigabe. Geben Sie den Replikationsplan mit einem Cron-Ausdruck an, indem Sie die Option --replication-cron-spec verwenden. Wenn die Quelldateifreigabe user_managed verschlüsselt ist, müssen Sie die --encryption-key-crn bereitstellen. Die Eigenschaft --encryption-key-crn darf nicht anders angegeben werden.

    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
    

Replikation für eine Dateifreigabe über die API hinzufügen

Sie können die Replikation programmgesteuert einrichten, indem Sie die Methode /shares in der VPC-API aufrufen, wie in den folgenden Beispielanforderungen gezeigt.

Zur Vorbereitung müssen Sie zunächst die API-Umgebung einrichten. Weitere Informationen zur VPC-API für Dateifreigaben finden Sie in der VPC-API-Referenz.

Dateifreigabe mit einem Replikat mit der API erstellen

Sie können eine zonale Dateifreigabe erstellen und gleichzeitig eine Replik in derselben Region einrichten. Dieser Ansatz wird nur für zonale Anteile unterstützt, deren Replikate in derselben Region verbleiben. Regionsübergreifende Replikate müssen in einem separaten Schritt erstellt werden, da sich die Quellfreigabe zum Zeitpunkt der Initialisierung des Replikats in einem stabilen Zustand befinden muss.

Wenn Sie eine Dateifreigabe erstellen, können Sie festlegen, dass zusätzlich eine Replik dieser Dateifreigabe in einer anderen Zone erstellt wird. Erstellen Sie eine POST /shares-Anforderung und geben Sie die Eigenschaft replica_share an, um die Replikatdateifreigabe zu definieren.

Im folgenden Beispiel wird das Replikat test-replica-001 für die Quellenfreigabe source-share-001 erstellt. Einbindeziele, die beim Erstellen einer Dateifreigabe optional sind, werden für die Replik-Dateifreigabe und die Quell-Dateifreigabe angegeben.

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

Replikat für eine vorhandene Dateifreigabe mit der API erstellen

Um eine Replikation für eine bestehende Dateifreigabe hinzuzufügen, müssen Sie eine Replikationsfreigabe in einer anderen Zone erstellen. Geben Sie in der Anforderung POST /shares den Namen und das Profil der gemeinsam genutzten Replikatressource an und geben Sie für source_share den Namen, die ID oder den CRN an. Weitere erforderliche Eigenschaften sind die zone, und replication_cron_spec, die den Replikationszeitplan festlegen. Sie können die Replikation Ihrer Daten in Abständen von bis zu 15 Minuten planen.

Replikation zur Dateifreigabe mit Terraform hinzufügen

Sie können die ibm_is_share-Ressource in Terraform verwenden, um eine Dateifreigabe mit Replikation zu erstellen, oder eine Dateifreigabe aktualisieren, um die Replikation einzuschließen.

Im folgenden Beispiel wird eine Replik-Freigabe in der Zone „ us-south-3 “ erstellt und der über die ID „ ibm_is_share.example.id “ angegebenen übergeordneten Freigabe zugeordnet.

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 * * *"
}

Im folgenden Beispiel wird eine Dateifreigabe in us-south-1 mit einem Replikat in us-south-3 erstellt.

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

Nächste Schritte