Filestore-Instanz mit der gcloud CLI erstellen

In dieser Schnellstartanleitung erfahren Sie, wie Sie mithilfe der Google Cloud CLI schnell mit Filestore arbeiten können. In dieser Kurzanleitung erfahren Sie mehr über die folgenden Themen:

  • Filestore-Instanz erstellen
  • Stellen Sie die Dateifreigabe von dieser Instanz auf einer Compute Engine-Client-VM bereit.
  • Erstellen Sie eine Datei in der bereitgestellten Dateifreigabe.
  • Löschen Sie die Filestore-Instanz.

Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Install the Google Cloud CLI.

  3. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  4. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  5. Create or select a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  6. Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.

  7. Verify that billing is enabled for your Google Cloud project.

  8. Enable the Filestore API:

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    gcloud services enable file.googleapis.com
  9. Install the Google Cloud CLI.

  10. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  11. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  12. Create or select a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  13. Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.

  14. Verify that billing is enabled for your Google Cloud project.

  15. Enable the Filestore API:

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    gcloud services enable file.googleapis.com
  16. Erforderliche Rollen

    Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Kurzanleitung benötigen:

    Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

    Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

    Compute Engine-VM erstellen

    Linux

    1. Create a Compute Engine instance. Configure the instance as follows:
      • Name the instance nfs-client.
      • Legen Sie für das Flag --zone den Wert us-central1-c fest.
      • Legen Sie für das Flag --image-project den Wert debian-cloud fest.
      • Legen Sie für das Flag --image-family den Wert debian-11 fest.
      • Legen Sie das Flag --tags auf http-server, fest.
      • gcloud compute instances create nfs-client --zone=us-central1-c --image-project=debian-cloud --image-family=debian-11 --tags=http-server,

    Windows

    1. Create a Compute Engine instance. Configure the instance as follows:
      • Name the instance nfs-client.
      • Legen Sie für das Flag --zone den Wert us-central1-c fest.
      • Legen Sie für das Flag --image-project den Wert windows-cloud fest.
      • Legen Sie für das Flag --image-family den Wert windows-2012-r2 fest.
      • Legen Sie das Flag --tags auf http-server,http-server, fest.
      • gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server,http-server,

    Filestore-Instanz erstellen

    In dieser Kurzanleitung wird gezeigt, wie Sie eine Instanz in der regionalen Dienststufe mit aktivierter benutzerdefinierter Leistung erstellen. Weitere Informationen zum Erstellen von Instanzen finden Sie unter Instanz erstellen.

    1. Filestore-Instanz erstellen Konfigurieren Sie die Instanz wie folgt:

      • Geben Sie der Instanz den Namen nfs-server.
      • Legen Sie das Flag --region auf us-central1 fest.
      • Legen Sie das Flag --tier auf REGIONAL fest.
      • Legen Sie das Flag --performance auf max-iops-per-tb=17000 fest.

      • Legen Sie das Flag --file-share auf name="vol1",capacity=1TB fest.

      • Legen Sie das Flag --network auf name="default" fest.

        gcloud filestore instances create nfs-server --region=us-central1 --tier=REGIONAL --performance=max-iops-per-tb=17000 --file-share=name="vol1",capacity=1TB --network=name="default"
    2. Rufen Sie Informationen zur erstellten Filestore-Instanz ab:

        gcloud filestore instances describe nfs-server --region=us-central1 

      Der Befehl gibt etwa Folgendes zurück:

          createTime: '2025-02-12T09:15:08.163246004Z'
          customPerformanceSupported: true
          fileShares:
           -capacityGb: '1024'
              name: vol1
          name: projects/yourproject/locations/us-central1/instances/nfs-server
          networks:
          -connectMode: DIRECT_PEERING
            ipAddresses:
             - 10.0.0.2
            network: default
            reservedIpRange: 10.0.0.2/26
          performanceConfig:
            iopsPerTb:
              maxIopsPerTb: '17000'
          performanceLimits:
            maxIops: '17000'
            maxReadIops: '17000'
            maxReadThroughputBps: '417792000'
            maxWriteIops: '5100'
            maxWriteThroughputBps: '139264000'
          protocol: NFS_V3
          state: READY
          tier: REGIONAL

    Notieren Sie sich die IP-Adresse der Instanz, die beim Bereitstellen der Dateifreigabe verwendet werden soll. In dieser Kurzanleitung verwenden wir die IP-Adresse 10.0.0.2.

    Filestore-Dateifreigabe auf der nfs-client-Instanz bereitstellen

    Linux

    1. Establish an SSH connection to the nfs-client Instanz:
      gcloud compute ssh nfs-client

    1. Installieren Sie NFS, indem Sie die folgenden Befehle im Terminalfenster von nfs-client ausführen:

      sudo apt-get -y update &&
      sudo apt-get -y install nfs-common
      
    2. Erstellen Sie ein Bereitstellungsverzeichnis auf der nfs-client-Instanz für die Filestore-Dateifreigabe:

      sudo mkdir /mnt/test
      
    3. Stellen Sie die Dateifreigabe in der nfs-client-Instanz mit dem Befehl mount bereit, indem Sie die IP-Adresse der Filestore-Instanz, den Namen der Dateifreigabe und das Bereitstellungsverzeichnis für die Bereitstellung angeben:

      sudo mount MOUNT-POINT-DIRECTORY /mnt/test
      

      Dabei gilt:

      MOUNT-POINT-DIRECTORY ist der Pfad zu dem Verzeichnis, in dem die Filestore-Dateifreigabe bereitgestellt wird. Beispiel: 10.0.0.2:/vol1

    4. Optional: Bestätigen Sie, dass die Filestore-Dateifreigabe bereitgestellt ist:

      df -h --type=nfs

    5. Geben Sie den Zugriff auf die Dateifreigabe frei, indem Sie ihre Berechtigungen ändern:

      sudo chmod go+rw /mnt/test
      

    Windows

    Bei der Instanz nfs-client anmelden und eine Eingabeaufforderung als Administrator öffnen

    1. Erstellen Sie ein Konto und legen Sie ein anfängliches Kennwort für die nfs-client-Instanz fest:

      gcloud compute reset-windows-password nfs-client
      
    2. Konfigurieren Sie die Instanz so, dass die Verbindung zu seriellen Ports aktiviert werden kann:

      gcloud compute instances add-metadata nfs-client --metadata=serial-port-enable=1
      
    3. Geben Sie eine interaktive Sitzung ein:

      gcloud compute connect-to-serial-port nfs-client --port=2
      
    4. Erstellen Sie bei der Eingabeaufforderung SAC> einen neuen Kanal:

      cmd
      

      Ein Kanal mit dem Namen Cmd0001 wird erstellt.

    5. Verbindung zum Kanal herstellen:

      ch -sn Cmd0001
      
    6. Geben Sie den Benutzernamen und das Kennwort der nfs-client-Instanz ein und lassen Sie das Feld Domain leer. Sie sind mit der Command Prompt-Schnittstelle der nfs-client-Instanz verbunden.

    NFS-Client installieren

    1. Wechseln Sie im Command Prompt des nfs-client zu Windows PowerShell:

      powershell
      
    2. NFS-Client installieren:

      Install-WindowsFeature -Name NFS-Client
      
    3. Starten Sie die nfs-client-Instanz neu, wenn Sie dazu aufgefordert werden:

      restart-computer
      
    4. Warten Sie bei der Eingabeaufforderung SAC>, bis die folgende Benachrichtigung angezeigt wird:

      EVENT: The CMD command is now available.

      Führen Sie dann die Befehle cmd und ch -sn wie zuvor angewiesen aus, um sich anzumelden und die Verbindung zur Instanz nfs-client wiederherzustellen.

    Die vom NFS-Client verwendete Nutzer-ID konfigurieren

    1. Führen Sie in der Eingabeaufforderung powershell aus, um zu Windows PowerShell zu wechseln.
    2. Führen Sie in PowerShell die folgenden Befehle aus, um zwei neue Registry-Einträge zu erstellen, und zwar AnonymousUid und AnonymousGid:

      New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
          -Name "AnonymousUid" -Value "0" -PropertyType DWORD
      
      New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
          -Name "AnonymousGid" -Value "0" -PropertyType DWORD
      
    3. Starten Sie den NFS-Clientdienst neu:

      nfsadmin client stop
      
      nfsadmin client start
      

    Weisen Sie die Dateifreigabe vol1 der Instanz nfs-client zu.

    1. Beenden Sie PowerShell:

      exit
      
    2. Stellen Sie die Dateifreigabe von Command Prompt in der nfs-client-Instanz mit dem Befehl mount bereit, indem Sie die IP-Adresse der Filestore-Instanz, den Namen der Dateifreigabe und den Laufwerksbuchstaben für die Bereitstellung angeben:

      mount -o mtype=hard 10.0.0.2:/vol1 z:
      

    Eine Datei in dem bereitgestellten Fileshare erstellen

    Linux

    1. Erstellen Sie im Terminalfenster nfs-client eine Datei mit dem Namen testfile, indem Sie den folgenden Befehl ausführen:

      echo 'This is a test' > /mnt/test/testfile
      
    2. Bestätigen Sie, dass die Datei erstellt wurde, indem Sie den folgenden Befehl ausführen und prüfen, ob sich testfile im zurückgegebenen Verzeichnisinhalt befindet:

      ls /mnt/test
      

    Windows

    1. Erstellen Sie im Eingabeaufforderungsfenster der nfs-client-Instanz eine Datei mit dem Namen testfile:

      echo 'This is a test' > Z:\testfile
      
    2. Überprüfen Sie mit dem folgenden Befehl, ob die Datei erstellt wurde.

      dir Z:
      

      und prüfen sie, ob sich testfile im zurückgegebenen Verzeichnisinhalt befindet.

    Bereinigen

    Löschen Sie das Projekt von Google Cloud zusammen mit den Ressourcen, damit Ihrem Konto von Google Cloud die auf dieser Seite verwendeten Ressourcen nicht in Rechnung gestellt werden.

    Google Cloud -Projekt löschen

      Delete a Google Cloud project:

      gcloud projects delete PROJECT_ID

    Filestore-Instanz löschen

    Löschen Sie die nfs-server-Instanz:

    gcloud filestore instances delete nfs-server --zone=us-central1-c
    

    Compute Engine-Instanz löschen

    Löschen Sie die Instanz:
    gcloud compute instances delete nfs-client

    Nächste Schritte