Instanz erstellen

Auf dieser Seite erfahren Sie, wie Sie eine Filestore-Instanz entweder mit der Google Cloud Console oder der Google Cloud CLI erstellen.

Anleitung zum Erstellen einer Instanz

Google Cloud Console

Hinweis

  • Filestore API aktivieren. Es kann einige Minuten dauern, bis die Filestore API in der Liste Dienst unter Kontingente und Systemlimits angezeigt wird.

  • Das Kontingent für eine zonale oder regionale Instanz beginnt bei 0. Wenn Sie diese Kapazitäten nutzen möchten, müssen Sie zuerst eine Anfrage zur Kontingenterhöhung stellen und genehmigen lassen, bevor Sie eine Instanz erstellen können.

  • Wenn Sie eine Instanz mit einer Enterprise- oder High Scale SSD-Stufe erstellen müssen, müssen Sie Ihre Vorgänge direkt über die Filestore API oder mit gcloud ausführen. Diese create-Vorgänge werden über die Google Cloud Console nicht unterstützt.

    Weitere Informationen finden Sie unter Dienststufen.

Google Cloud Anleitung

  1. Rufen Sie in der Google Cloud Console die Filestore-Seite Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf Instanz erstellen.

  3. Füllen Sie alle erforderlichen Felder und optionalen Felder entsprechend den Anweisungen in den folgenden Abschnitten dieser Seite aus.

  4. Klicken Sie auf Erstellen.

gcloud

Hinweis

gcloud-Befehl zum Erstellen einer Filestore-Instanz

Sie können eine Filestore-Instanz mit dem Befehl filestore instances create erstellen. Das Kontingent für Instanzen variiert je nach Projekt, Region und Stufe. Weitere Informationen finden Sie unter Kontingente oder Kontingenterhöhung anfordern.

gcloud filestore instances create INSTANCE_ID \
    [--project=PROJECT_ID] \
    [--location=LOCATION] \
    [--description=DESCRIPTION] \
    [--performance=PERFORMANCE] \
    --tier=TIER \
    --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \
    --network=name="VPC-NETWORK",[connect-mode=CONNECT_MODE],[reserved-ip-range="RESERVED_IP_ADDRESS"] \
    [--labels=KEY=VALUE,[KEY=VALUE,…]] \
    [--kms-key=KMS_KEY] \
    [--deletion-protection] \
    [--deletion-protection-reason="PROTECTION_REASON"]

Wobei:

  • INSTANCE_ID durch die Instanz-ID der Filestore-Instanz, die Sie erstellen möchten. Weitere Informationen finden Sie unter Instanz benennen.

  • PROJECT_ID durch die Projekt-ID des Google Cloud -Projekts, das die Filestore-Instanz enthält. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz im Standardprojekt gcloud befindet. Sie können das Standardprojekt mit dem Befehl config set project festlegen:

      gcloud config set project PROJECT_ID

  • LOCATION durch den Standort, an dem sich die Filestore-Instanz befinden soll. Weitere Informationen finden Sie unter Standort auswählen. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz am gcloud-Standardstandort befindet. Sie können den standardmäßigen Standort mit dem Befehl config set filestore/zone festlegen:

      gcloud config set filestore/zone zone

    Verwenden Sie für die regionale oder Enterprise-Stufe den Befehl config set filestore/region:

      gcloud config set filestore/region region

  • DESCRIPTION Eine Beschreibung der Filestore-Instanz.

  • PERFORMANCE Wenn Sie das Flag --performance verwenden möchten, um die benutzerdefinierte Leistung zu konfigurieren, verwenden Sie eine der folgenden Optionen:

    • max-iops-per-tb gibt eine IOPS-pro-TiB-Rate an, die die IOPS linear mit der Instanzkapazität skaliert.
    • max-iops gibt eine IOPS-Rate an, bei der die IOPS nicht mit der Instanzkapazität skaliert werden.

    Das Format dafür ist:

    --performance=max-iops-per-tb=17000

    Das Flag --performance ist erforderlich, wenn regionale Instanzen mit einer Kapazität von weniger als 1.024 GiB erstellt werden. Weitere Informationen finden Sie unter Filestore-Instanzen mit geringer Kapazität.

  • TIER durch die Dienststufe, die Sie verwenden möchten.

  • FILE_SHARE_NAME durch den Namen, den Sie für die NFS-Dateifreigabe festlegen, der von der Instanz bereitgestellt wird. Siehe Dateifreigabe benennen.

  • FILE_SHARE_SIZE durch die gewünschte Dateifreigabegröße. Weitere Informationen finden Sie unter Kapazität zuweisen.

  • VPC_NETWORK durch den Namen des VPC-Netzwerks (Virtual Private Cloud), das die Instanz verwenden soll. Siehe VPC-Netzwerk auswählen. Wenn Sie eine freigegebene VPC über ein Dienstprojekt festlegen möchten, müssen Sie den voll qualifizierten Netzwerknamen im Format projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME und connect-mode=PRIVATE_SERVICE_ACCESS angeben. Beispiel:

    --network=name=projects/host/global/networks/shared-vpc-1,connect-mode=PRIVATE_SERVICE_ACCESS

    Sie können für den Wert VPC_NETWORK kein Legacy-Netzwerk angeben. Erstellen Sie bei Bedarf ein neues VPC-Netzwerk, das verwendet werden soll. Folgen Sie dazu der Anleitung unter Neues VPC-Netzwerk im automatischen Modus erstellen.

  • CONNECT_MODE durch DIRECT_PEERING oder PRIVATE_SERVICE_ACCESS. Wenn Sie eine freigegebene VPC als Netzwerk angeben, müssen Sie auch PRIVATE_SERVICE_ACCESS als Verbindungsmodus angeben.

  • RESERVED_IP_ADDRESS durch den IP-Adressbereich für die Filestore-Instanz. Wenn Sie connect-mode=PRIVATE_SERVICE_ACCESS angeben und einen reservierten IP-Adressbereich verwenden möchten, müssen Sie den Namen eines zugewiesenen Adressbereichs anstelle eines CIDR-Bereichs angeben. Weitere Informationen finden Sie unter Reservierte IP-Adresse konfigurieren. Wir empfehlen, dieses Flag zu überspringen, damit Filestore automatisch einen verfügbaren IP-Adressbereich finden und der Instanz zuweisen kann.

  • KEY durch ein Label, das Sie hinzufügen möchten. Beim Erstellen einer Filestore-Instanz müssen keine Labels hinzugefügt werden. Sie können Labels auch hinzufügen, löschen oder aktualisieren, nachdem Sie eine Instanz erstellt haben. Weitere Informationen finden Sie unter Labels verwalten.

  • VALUE durch den Wert für ein Label.

  • KMS_KEY ist der voll qualifizierte Name des Cloud Key Management Service-Verschlüsselungsschlüssels, den Sie verwenden möchten, wenn Sie Ihre eigene Datenverschlüsselung verwalten möchten. Das Format sieht so aus:

    projects/KMS_PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY

  • PROTECTION_REASON Wenn Sie das Flag --deletion-protection verwenden, können Sie eine Notiz zur Einstellung hinzufügen. Verwenden Sie das optionale Flag --deletion-protection-reason, um die Notiz hinzuzufügen, und geben Sie eine Beschreibung der Begründung für die von Ihnen gewählte Einstellung an. Beispiel: „Alle Genomdaten müssen den aktuellen Organisationsrichtlinien entsprechen.“ Weitere Informationen finden Sie unter Löschschutz.

Instanz benennen

Mit dem folgenden Befehl wird eine Instanz mit diesen Eigenschaften erstellt:

  • ID ist render1.
  • Projekt ist myproject.
  • Die Region ist us-central1.
  • Stufe ist REGIONAL.
  • Für die Leistung wird der Parameter max-iops-per-tb mit dem Wert 17000 verwendet.
  • Der Name der Dateifreigabe lautet my_vol.
  • Die Größe der Dateifreigabe ist 2 TiB.
  • VPC-Netzwerk ist default.
  • Der reservierte IP-Adressbereich ist 10.0.7.0/29.
  • Gewährt Lese- und Schreibzugriff auf den Client mit der IP-Adresse 10.0.2.0.
  • Der Löschschutz ist aktiviert.
  • Eine Begründung für die Einstellung des Löschschutzes wird angegeben.
gcloud filestore instances create render1 \
  --project=myproject \
  --region=us-central1 \
  --tier=REGIONAL \
  --performance=max-iops-per-tb=17000 \
  --network=name="default",reserved-ip-range="10.0.7.0/29" \
  --flags-file=nfs-export-options.json \
  --deletion-protection \
  --deletion-protection-reason="All genomics data must adhere to current
  organization policies."

Inhalte der Datei nfs-export-options.json:

 {
"--file-share":
  {
    "capacity": "2048",
    "name": "my_vol",
    "nfs-export-options": [
      {
        "access-mode": "READ_WRITE",
        "ip-ranges": [
          "10.0.0.0/29",
          "10.2.0.0/29"
        ],
        "squash-mode": "ROOT_SQUASH",
        "anon_uid": 1003,
        "anon_gid": 1003
      },
      {
        "access-mode": "READ_ONLY",
        "ip-ranges": [
          "192.168.0.0/26"
        ],
        "squash-mode": "NO_ROOT_SQUASH"
      }
    ]
  }
}

REST API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Verwenden Sie cURL, um die Filestore API aufzurufen:

    curl --request POST \
    'https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances?instanceId=NAME' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
            "tier":"TIER",
            "networks":[
                {
                "network":"NETWORK"
                }
              ],
            "performanceConfig": {"PERFORMANCE"}
            "fileShares":[
              {"capacityGb":CAPACITY,"name":"SHARE_NAME"}
              ],
            "deletionProtectionEnabled": true,
            "deletionProtectionReason": "PROTECTION_REASON"}' \
    --compressed

    Wobei:

    • PROJECT ist der Name des Projekts, in dem sich Ihre Instanz befinden wird. Beispiel: my-genomics-project.
    • LOCATION ist der Standort, an dem sich die Instanz befinden wird. Beispiel: us-east1 oder us-central1-a
    • NAME ist der Name der Instanz, die Sie erstellen möchten. Beispiel: my-genomics-instance.
    • TIER ist der Name der Dienststufe, die Sie verwenden möchten. Beispiel: REGIONAL.

    • PERFORMANCE ist die Leistungskonfiguration, mit der benutzerdefinierte Leistungseinstellungen angegeben werden.

      Sie können nur eine der angegebenen Optionen verwenden.

      • PerformanceConfig.iopsPerTb.maxIopsPerTb gibt eine IOPS-pro-TiB-Rate an, die die IOPS linear mit der Instanzkapazität skaliert.
      • PerformanceConfig.fixedIops.maxIops gibt eine feste IOPS-Rate an, bei der die IOPS nicht mit der Instanzkapazität skaliert werden.

      Das Format dafür ist:

         "performanceConfig": {
      "iopsPerTb" : {
          "maxIopsPerTb":17000
      }
    }

    • NETWORK ist der Name des Netzwerks, das Sie verwenden möchten. Beispiel: default.

    • CAPACITY ist die Größe in GiB, die Sie der Instanz zuweisen möchten. Beispiel: 1024.

    • SHARE_NAME ist der Name der Dateifreigabe. Beispiel: vol1.

    • PROTECTION_REASON Wenn Sie das Flag deletionProtectionEnabled verwenden, können Sie eine Notiz zur Einstellung hinzufügen. Verwenden Sie das optionale Flag deletionProtectionReason, um die Notiz hinzuzufügen, und geben Sie eine Beschreibung der Begründung für die von Ihnen gewählte Einstellung an. Beispiel: „Alle Genomdaten müssen den aktuellen Organisationsrichtlinien entsprechen.“ Weitere Informationen finden Sie unter Löschschutz.

Instanzen und Freigaben verstehen

Eine Filestore-Instanz stellt physische Speicherkapazität dar.

Eine Freigabe stellt einen zugewiesenen Teil dieses Speichers mit einem individuellen, eindeutigen Zugriffspunkt dar.

Alle Dienststufen bieten Speicheroptionen mit einem Freigabe-zu-Instanz-Verhältnis von 1:1. Alternativ bietet Filestore Multishares für Google Kubernetes Engine (GKE), das nur für Instanzen der Enterprise-Stufe verfügbar ist, Zugriff auf mehrere Freigaben auf einer einzelnen Instanz.

Instanznamen oder Instanz-IDs werden von Administratoren zum Verwalten von Instanzen verwendet. Dateifreigabenamen werden von Clients verwendet, um eine Verbindung zu den Freigaben herzustellen, die von diesen Instanzen exportiert wurden.

Instanz benennen

Der Name Ihrer Filestore-Instanz oder Instanz-ID wird zur Identifizierung der Instanz verwendet und in gcloud-Befehlen verwendet. Instanz-IDs müssen dem Element <label> von RFC 1035 entsprechen. Sie müssen insbesondere:

  • Muss 1 bis 63 Zeichen lang sein
  • Muss mit einem Kleinbuchstaben beginnen
  • Besteht aus Bindestrichen, Kleinbuchstaben oder Ziffern.
  • Beenden Sie mit Kleinbuchstaben oder Ziffern.

Die Instanz-ID muss im Google Cloud Projekt und in der Zone, in der sie sich befindet, eindeutig sein. Nachdem eine Instanz erstellt wurde, kann die Instanz-ID nicht mehr geändert werden.

Dienststufe konfigurieren

Wählen Sie die Servicestufe aus, die Ihren Anforderungen am besten entspricht. Nachdem eine Instanz erstellt wurde, kann ihre Dienststufe nicht mehr geändert werden. Eine detaillierte Beschreibung der Funktionen, die je nach Dienststufe verfügbar sind, finden Sie unter Dienststufen.

Create-Vorgänge für zonale, regionale und Enterprise-Instanzen können je nach Instanzgröße zwischen 15 Minuten und einer Stunde dauern.

Das Filestore-Kontingent wird verwendet, wenn die Instanz erstellt wird, aber Ihnen während dieser Zeit keine Instanz in Rechnung gestellt wird.

Kapazität zuweisen

Weisen Sie Kapazität dem Betrag zu, den Sie beim Erstellen der Instanz benötigen. Wenn Sie die Kapazitätsgrenze erreichen, können Sie die Kapazität nach Bedarf hochskalieren, ohne die Laufzeit zu beeinträchtigen. Informationen zum Überwachen der Kapazität Ihrer Instanzen finden Sie unter Instanzen überwachen.

In der gcloud CLI können Sie die Kapazität in ganzen Zahlen mit GiB oder TiB angeben. Die Standardeinheit ist GiB.

Die folgende Tabelle zeigt die für jede Stufe verfügbaren Instanzgrößen:

Stufe Mindestgröße Maximalgröße Inkrementelle Schrittgröße
Zonal 1 TiB 9,75 TiB 256 GiB
Zonal 10 TiB 100 TiB 2,5 TiB
Regional 100 GiB 10.239 GiB 1 GiB
Regional 10 TiB 100 TiB 2,5 TiB
Basic HDD 1 TiB 63,9 TiB 1 GiB
Basic SSD 2,5 TiB 63,9 TiB 1 GiB
Enterprise 1 TiB 10 TiB 256 GiB

Die Größe von Instanzen kann ein beliebiger ganzzahliger Gibibyte-Wert oder der entsprechende Tebibyte-Wert sein, der zwischen der minimalen und maximalen Instanzgröße liegt und durch die inkrementelle Schrittgröße teilbar ist. Gültige Größen für zonale Instanzen mit einem höheren Kapazitätsbereich sind beispielsweise 10 TiB, 12,5 TiB und 15 TiB.

Nach dem Erstellen können Basic HDD- und Basic SSD-Instanzen nur vergrößert werden. Bei allen anderen Dienststufen kann die Kapazität hoch- oder herunterskaliert werden. Weitere Informationen finden Sie unter Instanzen bearbeiten und Kapazität skalieren.

Gesamtkapazitätskontingent

Jedem Projekt wird ein separates Kapazitätskontingent zugewiesen, das nach Region und Dienststufe definiert ist. Die Kontingentlimits variieren je nach Dienststufe.

Sobald Sie Ihr Kontingentlimit erreicht haben, können Sie keine weiteren Filestore-Instanzen mehr erstellen oder die Kapazität Ihrer vorhandenen Instanzen erhöhen. Ihr verfügbares Kontingent finden Sie in der Google Cloud Console auf der Seite Kontingente:

Kontingente aufrufen

Informationen zum Anfordern eines höheren Kontingents finden Sie unter Kontingenterhöhungen anfordern.

Leistung konfigurieren

Die Instanzleistung hängt von der ausgewählten Dienststufe ab.

Regionale und zonale Stufen

  • Bei regionalen und zonalen Stufen ist die benutzerdefinierte Leistung standardmäßig aktiviert, wenn Sie die Google Cloud Console verwenden. So können Sie die Leistung anhand der Arbeitslast und Skalierung konfigurieren. Sie können ein IOPS-pro-TiB-Verhältnis festlegen, mit dem die IOPS der Instanz mit der Kapazität skaliert werden, oder einen konstanten IOPS-Wert, der nicht mit der Kapazität skaliert wird, aber jederzeit angepasst werden kann, wenn sich die Kapazität ändert. Weitere Informationen zu Limits finden Sie unter Benutzerdefinierte Leistungslimits.

  • Zum Erstellen regionaler Instanzen mit einer Kapazität von weniger als 1.024 GiB muss die benutzerdefinierte Leistung aktiviert sein. Der Mindest-IOPS-Wert für diese Instanzen beträgt 2.000. Weitere Informationen finden Sie unter Filestore-Instanzen mit geringer Kapazität.

Basic SSD- und Basic HDD-Stufen

  • Bei SSD-Basisstufen ist die Anzahl der IOPS konstant und ändert sich nicht, wenn Sie die Kapazitätseinstellungen ändern.
  • Bei Basic HDD-Stufen ändern sich die Leistungslimits je nachdem, ob die Kapazität im Bereich von 1 TiB bis 10 TiB oder von 10 TiB bis 63,9 TiB liegt.

Weitere Informationen zu Leistungsgrenzen und -einstellungen finden Sie unter Leistung.

IOPS-pro-TiB-Verhältnis angeben

Mit „Benutzerdefinierte Leistung“ können Sie das Verhältnis im Feld IOPS pro TiB angeben, wobei die Leistung basierend auf der Kapazität skaliert wird.

Wenn Sie feste IOPS verwenden möchten, entfernen Sie das Häkchen bei Leistung kapazitätsabhängig skalieren.

Angenommen, Sie haben die folgenden anfänglichen Leistungswerte angegeben:

  • Kapazität: 1 TiB
  • IOPS pro TiB: 6.000
  • Leistung (wenn das Kästchen Leistung kapazitätsabhängig skalieren aktiviert ist): 6.000 IOPS

Die folgenden Beispiele zeigen, wie sich die Leistung je nach geänderten Einstellungen skaliert:

  • Wenn Sie die IOPS pro TiB auf 7.000 erhöhen, wird die Leistung auf 7.000 IOPS angepasst.
  • Wenn Sie die Kapazität auf 2 TiB erhöhen,wird die Leistung auf 14.000 IOPS angepasst.
  • Wenn Sie die Leistung auf 8.000 IOPS verringern, werden die IOPS pro TiB auf 4.000 angepasst.

Feste Anzahl von IOPS angeben

Wenn Sie das Häkchen bei Leistung kapazitätsabhängig skalieren entfernen, wird im Feld Leistung die Anzahl der IOPS angegeben, die Sie verwenden möchten. Diese Zahl muss im Leistungsbereich liegen und ein Vielfaches von 1.000 sein.

Wenn Sie eine feste Anzahl von IOPS unabhängig von der Kapazität festlegen, können Sie die Leistung optimieren. Diese Option verhindert jedoch die automatische Leistungsskalierung bei Kapazitätsänderungen. Wenn Sie die Kapazität ändern, müssen Sie möglicherweise den Leistungswert anpassen und umgekehrt.

Sie haben beispielsweise die folgenden Werte angegeben:

  • Kapazität: 4 TiB
  • Leistung: 40.000 IOPS

An diesem Punkt können Sie die Leistung auf bis zu 68.000 IOPS erhöhen, was dem Limit für 4 TiB Kapazität entspricht. Sie möchten die Leistung auf 70.000 IOPS erhöhen,was über dem Leistungsbereich für die Kapazität von 4 TiB liegt. Um die Kompatibilität aufrechtzuerhalten, müssen Sie die Kapazität auf mindestens 4,25 TiB erhöhen, damit sie im Leistungsbereich liegt.

Standort auswählen

"Standort" bezieht sich auf die Region und die Zone, in denen sich die Filestore-Instanz befindet. Sie sollten die Filestore-Instanz in derselben Region befinden wie die Compute Engine-VMs, die auf die Instanzen zugreifen müssen, um die Leistung zu optimieren und regionsübergreifende Netzwerkgebühren zu vermeiden.

Weitere Informationen zu Regionen und Zonen finden Sie unter Geografie und Regionen.

Dateisystemprotokoll auswählen

Wählen Sie das Dateisystemprotokoll aus, das Ihren Anforderungen entspricht. Filestore unterstützt die Protokolle NFSv3 und NFSv4.1.

Verbindungen einrichten

Wählen Sie den IP-Stack-Typ des Netzwerks und das VPC-Netzwerk aus.

IP-Stacktyp des Netzwerks auswählen

Wählen Sie entweder IPv4 oder IPv6 als IP-Stack-Typ für Ihr Netzwerk aus.

VPC-Netzwerk auswählen

Das Netzwerk, das Sie für die Verwendung mit Filestore auswählen, kann entweder ein Standard-VPC-Netzwerk oder ein freigegebene VPC-Netzwerk sein.

VPC-Netzwerk

Wenn Sie die Google Cloud Console verwenden, müssen Sie Private Service Connect verwenden, damit Nutzer privat aus ihrem VPC-Netzwerk auf verwaltete Dienste zugreifen können. Bei Private Service Connect muss der Nutzer eine einzelne interne IP-Adresse in seiner eigenen VPC bereitstellen, um einen Private Service Connect-Endpunkt zu erstellen, anstatt einen gesamten IP-Adressbereich für die Verbindung zuzuweisen.

Wenn Sie einen Private Service Connect-Endpunkt im Zielnetzwerk des Nutzers erstellen möchten, müssen Sie in Ihrem Projekt eine Richtlinie für Dienstverbindungen erstellen.

Weitere Informationen zur Verwendung von Private Service Connect finden Sie unter Filestore-Instanz mit Private Service Connect erstellen.

Das von Ihnen ausgewählte Netzwerk muss genügend verfügbare IP-Ressourcen haben, die der Filestore-Instanz zugewiesen werden können. Andernfalls kann die Instanz aufgrund von IP-Adressenmangel nicht erstellt werden. Weitere Informationen finden Sie unter Anforderungen an Netzwerk- und IP-Ressourcen.

Clients müssen sich im selben Netzwerk wie die Filestore-Instanz befinden, um auf die auf dieser Instanz gespeicherten Dateien zugreifen zu können. Nachdem eine Instanz erstellt wurde, kann diese Netzwerkauswahl nicht mehr geändert werden.

Gemeinsam genutztes VPC-Netzwerk

Bevor Sie eine Instanz in einem gemeinsam genutzten VPC-Netzwerk in einem Dienstprojekt erstellen können, muss der Netzwerkadministrator zuerst den Zugriff auf private Dienste für das freigegebene VPC-Netzwerk aktivieren. Wenn Sie die Instanz im Hostprojekt erstellen, ist der Zugriff auf private Dienste nicht erforderlich.

Freigegebene VPC-Netzwerke werden in der Google Cloud Console im folgenden Format angezeigt:

projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME

Eine ausführliche Anleitung finden Sie unter Instanz in einem freigegebene VPC erstellen.

NFS-Dateisperren

Wenn die Anwendungen, die Sie mit einer Filestore-Instanz verwenden möchten, eine NFS-Dateisperre erfordern, müssen Sie möglicherweise die von Filestore verwendeten Ports im ausgewählten Netzwerk öffnen, wenn eine der folgenden Optionen auf Ihren Anwendungsfall zutrifft:

  • ein anderes VPC-Netzwerk als das Standardnetzwerk oder
  • das Standard-VPC-Netzwerk mit geänderten Firewallregeln auswählen,

Diese Überlegung gilt nur für Filestore-Instanzen, die den Zugriff auf private Dienste oder Direct-Peering-Verbindungsmethoden verwenden.

Weitere Informationen finden Sie unter Firewallregeln konfigurieren.

Dateifreigabe konfigurieren

Eine Dateifreigabe ist das Verzeichnis auf einer Filestore-Instanz, in dem alle freigegebenen Dateien gespeichert sind. Es ist auch das, was Sie auf der Client-VM bereitstellen oder zuordnen.

Der Name der Dateifreigabe muss folgendermaßen lauten:

  • Bei zonalen, regionalen und Enterprise-Stufen zwischen 1 und 32 Zeichen lang sein und bei Basisstufen zwischen 1 und 16 Zeichen lang sein.
  • Sie müssen mit einem Buchstaben beginnen.
  • Sie bestehen aus Groß- und Kleinbuchstaben, Zahlen und Unterstrichen.
  • Muss mit einem Buchstaben oder einer Ziffer enden.

IP-basierte Zugriffssteuerung konfigurieren

Standardmäßig gewährt eine Filestore-Instanz allen Clients, einschließlich Compute Engine-VMs und GKE-Clustern, die dasselbe Google Cloud -Projekt und VPC-Netzwerk gemeinsam nutzen, Lese- und Schreibzugriff auf Root-Ebene. Wenn Sie den Zugriff beschränken möchten, erstellen Sie mithilfe von IP-Adressen Regeln, mit denen bestimmten Clients Zugriffsebenen zugewiesen werden. Sobald die Regeln hinzugefügt sind, wird allen Nutzern und IP-Adressen, die nicht in einer Regel angegeben sind, der Zugriff entzogen. Zonale, regionale und Enterprise-Instanzen unterstützen Konfigurationseinstellungen für überlappende IP-Adressbereiche. Weitere Informationen finden Sie unter Sich überschneidende Berechtigungen.

In der folgenden Tabelle werden die Berechtigungen jeder Zugriffsebene beschrieben. Diese Zugriffsebenen werden nur in der Google Cloud Console verwendet. In der gcloud CLI und der API müssen Sie die Regelkonfigurationen direkt angeben.

Zugriffsebene Regelkonfiguration Beschreibung
admin
  • lesen/schreiben
  • No-Root-Squash
 Der Client kann alle Dateien, Ordner und Metadaten als Root-Nutzer aufrufen und ändern. Sie kann auch die Eigentümerschaft für Dateien oder Ordner übertragen, indem sie uid und gid festlegt. Dadurch wird Clients, die keinen Root-Zugriff auf die Dateifreigabe haben, Zugriff gewährt.
admin-viewer
  • Schreibgeschützt
  • No-Root-Squash
 Der Client kann alle Dateien, Ordner und Metadaten als Root-Nutzer anzeigen, aber nicht ändern.
editor
  • lesen/schreiben
  • Root-Squash
 Der Client kann die Dateien, Ordner und Metadaten entsprechend den zugewiesenen uid und gid ansehen und ändern.
viewer
  • Schreibgeschützt
  • Root-Squash
 Der Client kann die Dateien, Ordner und Metadaten entsprechend den zugewiesenen uid und gid ansehen.

root-squash ordnet alle Anfragen von uid 0 und gid 0 jeweils anon_uid und anon_gid zu. Durch diese Konfiguration wird der Zugriff auf Root-Ebene von Clients entfernt, die versuchen, als Root-Nutzer auf die Dateifreigabe zuzugreifen.

Beachten Sie beim Erstellen von IP-basierten Zugriffsregeln Folgendes:

  • Sie müssen eine interne IP-Adresse oder einen internen IP-Adressbereich und die gewährte Zugriffsebene angeben.
  • Mindestens eine Regel muss zum Zeitpunkt der Instanzerstellung admin-Zugriff gewähren. Diese Regel kann entfernt werden, sobald die Instanz erstellt wurde.
  • Zonale, regionale und Enterprise-Instanzen unterstützen Konfigurationseinstellungen für sich überschneidende IP-Adressbereiche. Instanzen der Basis-Stufe werden nicht unterstützt. Weitere Informationen finden Sie unter Sich überschneidende Berechtigungen.

In der Google Cloud Console können Sie bis zu 4 verschiedene Regeln (admin, admin-viewer, editor, viewer) mit bis zu 64 verschiedenen IP-Adressen oder -Bereichen erstellen.

In der gcloud CLI können Sie bis zu 64 verschiedene IP-Adressen oder CIDR-Blöcke pro Filestore-Instanz über maximal 10 verschiedene Regeln konfigurieren. Eine Regel wird als Kombination der Konfigurationen access-mode, squash-mode und anon_uid/anon_gid definiert. Die Felder anon_uid und anon_gid haben die Standardwerte 65534 und können nur über die API und die gcloud CLI konfiguriert werden.

Beispiel

Hier sehen Sie ein Beispiel für drei verschiedene IP-basierte Zugriffsregeln:

  • access-mode=READ_ONLY, squash-mode=ROOT_SQUASH, anon_uid=10000.
  • access-mode=READ_WRITE, squash-mode=ROOT_SQUASH, anon_gid=150.
  • access-mode=READ_WRITE, squash-mode=NO_ROOT_SQUASH.

Wenn Sie IP-basierte Zugriffssteuerungsregeln mit der gcloud CLI erstellen möchten, verwenden Sie das Flag --flags-file mit den Befehlen instances create oder instances update und verweisen Sie auf eine JSON-Konfigurationsdatei. Wenn die JSON-Konfigurationsdatei beispielsweise nfs-export-options.json heißt, lautet das Flag:

--flags-file=nfs-export-options.json

Beispiel für eine JSON-Konfigurationsdatei:

   {
  "--file-share":
    {
      "capacity": "2048",
      "name": "my_vol",
      "nfs-export-options": [
        {
          "access-mode": "READ_WRITE",
          "ip-ranges": [
            "10.0.0.0/29",
            "10.2.0.0/29"
          ],
          "squash-mode": "ROOT_SQUASH",
          "anon_uid": 1003,
          "anon_gid": 1003
        },
         {
          "access-mode": "READ_ONLY",
          "ip-ranges": [
            "192.168.0.0/26"
          ],
          "squash-mode": "NO_ROOT_SQUASH"
        }
      ]
    }
}
  • ip-ranges ist die IP-Adresse oder der Bereich, auf die bzw. den Zugriff gewährt werden soll. Sie können mehrere IP-Adressen oder -Bereiche angeben, indem Sie sie durch ein Komma trennen. Nur zonale, regionale und Enterprise-Instanzen unterstützen Konfigurationseinstellungen für überlappende IP-Adressbereiche. Weitere Informationen finden Sie unter Sich überschneidende Berechtigungen.
  • access-mode ist die Zugriffsebene, die den Clients zugewiesen werden soll, deren IP-Adresse in den ip-range fällt. Sie kann die Werte READ_WRITE oder READ_ONLY haben. Der Standardwert ist READ_WRITE.
  • squash-mode kann die Werte ROOT_SQUASH oder NO_ROOT_SQUASH haben. ROOT_SQUASH entfernt Root-Zugriff auf die Clients, deren IP-Adresse in ip-range fällt, während NO_ROOT_SQUASH Root-Zugriff ermöglicht. Der Standardwert ist NO_ROOT_SQUASH.
  • anon_uid ist der Nutzer-ID-Wert, den Sie anon_uid zuordnen möchten. Der Standardwert ist 65534.
  • anon_gid ist der Gruppen-ID-Wert, den Sie anon_gid zuordnen möchten. Der Standardwert ist 65534.

Clients in Bereichen außerhalb von RFC 1918

Wenn Sie Clients, die nicht RFC 1918 entsprechen, mit Ihrer Filestore-Instanz verbinden möchten, müssen Sie ihnen explizit Zugriff auf die Filestore-Instanz gewähren. Verwenden Sie dazu die IP-basierte Zugriffssteuerung.

Optionale Felder

In den folgenden Abschnitten werden optionale Felder beschrieben.

Instanzbeschreibung hinzufügen

Mit einer Instanzbeschreibung können Sie Beschreibungen, Notizen oder Anleitungen für sich selbst und andere Nutzer schreiben. Sie können beispielsweise Informationen zu folgenden Themen angeben:

  • Die in der Instanz gespeicherten Dateitypen.
  • Wer Zugriff auf die Instanz hat.
  • Anleitung zum Zugriff auf die Instanz.
  • Wofür wird die Instanz verwendet?

Instanzbeschreibungen sind auf 2048 Zeichen beschränkt. Es gibt keine Einschränkungen hinsichtlich der zulässigen Zeichen. Nachdem eine Filestore-Instanz erstellt wurde, können Sie ihre Instanzbeschreibung jederzeit nach Bedarf aktualisieren. Informationen zum Aktualisieren von Instanzbeschreibungen finden Sie unter Instanzen bearbeiten.

Labels hinzufügen

Labels sind Schlüssel/Wert-Paare, mit denen Sie verwandte Instanzen gruppieren und Metadaten zu einer Instanz speichern können. Sie können Labels jederzeit hinzufügen, löschen oder ändern. Weitere Informationen finden Sie unter Labels verwalten.

Reservierten IP-Adressbereich konfigurieren

Jeder Filestore-Instanz muss ein IP-Adressbereich zugeordnet sein. Sowohl RFC 1918- als auch Nicht-RFC 1918-IP-Adressbereiche (GA) werden unterstützt.

Der IP-Adressbereich einer Instanz kann nach der Angabe nicht mehr geändert werden.

Nutzer werden aufgefordert, Filestore automatisch einen verfügbaren IP-Adressbereich bestimmen und der Instanz zuweisen zu lassen. Berücksichtigen Sie bei der Auswahl eines eigenen Bereichs die folgenden Filestore-IP-Ressourcenanforderungen:

  • Verwenden Sie die CIDR-Notation.

  • Muss ein gültiger VPC-Subnetzbereich sein.

  • Für Basic-Instanzen ist eine Blockgröße von 29 erforderlich. Beispiel: 10.123.123.0/29.

  • Zonale, regionale und Enterprise-Instanzen erfordern eine Blockgröße von 26. Beispiel: 172.16.123.0/26

  • Der IP-Adressbereich darf sich nicht mit Folgendem überschneiden:

    • Vorhandene Subnetze im VPC-Netzwerk, die von der Filestore-Instanz verwendet werden.

    • Vorhandene Subnetze in einem VPC-Netzwerk, das per Peering mit dem Subnetz verbunden ist, das von der Filestore-Instanz verwendet wird. Weitere Informationen finden Sie unter Sich überschneidende Subnetze zum Zeitpunkt des Peerings.

    • IP-Adressbereiche, die anderen vorhandenen Filestore-Instanzen in diesem Netzwerk zugewiesen sind.

    • Der Adressbereich 172.17.0.0/16 ist für interne Filestore-Komponenten reserviert. Deshalb gelten folgende Einschränkungen:

      • Clients in diesem Bereich können nicht mit Filestore-Instanzen verbunden werden.

      • In diesem IP-Bereich können keine Filestore-Instanzen erstellt werden. Weitere Informationen finden Sie unter Bekannte Probleme.

  • Pro VPC muss mindestens eine VPC-Netzwerk-Peering-Verbindung oder eine Verbindung für den Zugriff auf private Dienste vorhanden sein.

Die IP-Adressbereiche für die Subnetze Ihres Netzwerks finden Sie auf der Seite „VPC-Netzwerke“ in der Google Cloud Console:

Zur Seite VPC-Netzwerke

Sie können den reservierten IP-Adressbereich für jede Filestore-Instanz auf der Seite „Filestore-Instanzen“ in derGoogle Cloud Console abrufen:

Zur Seite „Filestore-Instanzen“

Wenn Sie den Zugriff auf private Dienste verwenden und einen reservierten IP-Adressbereich angeben möchten, müssen Sie den Namen eines zugewiesenen Adressbereichs für die Verbindung angeben. Wenn Sie keinen Bereichsnamen angeben, verwendet Filestore automatisch einen der zugewiesenen Bereiche, die der Verbindung für den Zugriff auf private Dienste zugeordnet sind.

Kundenverwalteten Verschlüsselungsschlüssel verwenden

Standardmäßig verschlüsselt Google Cloud Daten im inaktiven Zustand automatisch mit von Google verwalteten Verschlüsselungsschlüsseln. Wenn Sie mehr Kontrolle über die Schlüssel benötigen, die Ihre Daten schützen, können Sie kundenverwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEKs) für Filestore verwenden. Weitere Informationen finden Sie unter Daten mit kundenverwalteten Verschlüsselungsschlüsseln verschlüsseln.

Löschschutz aktivieren

Legen Sie die Einstellung für den Löschschutz der Instanz fest. Diese Einstellung ist standardmäßig deaktiviert. Weitere Informationen finden Sie unter Löschschutz.

Beschreibung für die Einstellung „Löschschutz“ hinzufügen

Fügen Sie eine Beschreibung der Begründung für die von Ihnen gewählte Löschschutzeinstellung hinzu. Weitere Informationen finden Sie unter Löschschutz.

Nächste Schritte