使用 gcloud CLI 建立 Filestore 執行個體

使用 gcloud CLI 建立 Filestore 執行個體

本快速入門導覽課程說明如何使用 Google Cloud CLI，快速開始及執行 Filestore。在本快速入門導覽課程中，您將瞭解如何執行下列操作：

• 建立 Filestore 執行個體。
• 在 Compute Engine 用戶端 VM 上，掛接該執行個體的檔案共用區。
• 在已掛接的檔案共用區中建立檔案。
• 刪除 Filestore 執行個體。

事前準備

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

• 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您已獲授角色，即可選取任何專案。
• 建立專案：如要建立專案，您需要具備專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。完成這些步驟後，您就可以刪除專案，並移除與該專案相關聯的所有資源。

• 建立 Google Cloud 專案：

  gcloud projects create PROJECT_ID

  將 PROJECT_ID 替換為您要建立的 Google Cloud 專案名稱。

• 選取您建立的 Google Cloud 專案：

  gcloud config set project PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案名稱。

如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

確認專案已啟用計費功能 Google Cloud 。

啟用 Filestore API：

啟用 API 時所需的角色

如要啟用 API，您需要具備服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

gcloud services enable file.googleapis.com

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

• 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您已獲授角色，即可選取任何專案。
• 建立專案：如要建立專案，您需要具備專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。完成這些步驟後，您就可以刪除專案，並移除與該專案相關聯的所有資源。

• 建立 Google Cloud 專案：

  gcloud projects create PROJECT_ID

  將 PROJECT_ID 替換為您要建立的 Google Cloud 專案名稱。

• 選取您建立的 Google Cloud 專案：

  gcloud config set project PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案名稱。

如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

確認專案已啟用計費功能 Google Cloud 。

啟用 Filestore API：

啟用 API 時所需的角色

如要啟用 API，您需要具備服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

gcloud services enable file.googleapis.com

必要的角色

如要取得完成本快速入門導覽課程所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

• 建立及管理 Filestore 執行個體： Cloud Filestore 編輯者 (roles/file.editor)
• 建立及管理 Compute Engine 執行個體： Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

完成本文所述工作後，您可以刪除建立的資源，避免繼續計費，詳情請參閱「清除所用資源」一節。

建立 Compute Engine VM

Linux

1. 建立 Compute Engine 執行個體。請依照下列步驟來設定執行個體：
   • 將執行個體命名為 nfs-client。
   • 將 --zone 旗標設為 us-central1-c。
   • 將 --image-project 標記設為 debian-cloud。
   • 將 --image-family 標記設為 debian-11。
   • 將 --tags 旗標設為 http-server。

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=debian-cloud --image-family=debian-11 --tags=http-server

Windows

1. 建立 Compute Engine 執行個體。請依照下列步驟來設定執行個體：
   • 將執行個體命名為 nfs-client。
   • 將 --zone 旗標設為 us-central1-c。
   • 將 --image-project 標記設為 windows-cloud。
   • 將 --image-family 標記設為 windows-2012-r2。
   • 將 --tags 旗標設為 http-server。

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server

建立 Filestore 執行個體

本快速入門導覽課程說明如何在啟用自訂效能的區域服務層級中建立執行個體。如要瞭解如何建立執行個體，請參閱建立執行個體。

1. 建立 Filestore 執行個體。如下所示建立執行個體：

   • 為執行個體 nfs-server 命名。
   • 將 --region 旗標設為 us-central1。
   • 將 --tier 旗標設為 REGIONAL。

   • 將 --performance 旗標設為 max-iops-per-tb=17000。

     注意： 為執行個體啟用自訂效能後，就無法再停用。啟用自訂效能的執行個體會根據購買的 IOPS 計費。詳情請參閱 設定自訂效能和 Filestore 定價。

   • 將 --file-share 旗標設為 name="vol1",capacity=1TB。

   • 將 --network 旗標設為 name="default"。

     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. 取得您建立的 Filestore 執行個體相關資訊：

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

   指令會傳回類似下列內容：

       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

複製執行個體的 IP 位址，供掛接檔案共用區時使用。在本快速入門導覽課程中，我們使用 IP 位址 10.0.0.2。

在 nfs-client 執行個體上掛接 Filestore 檔案共用區

Linux

1. 建立與執行個體的 SSH 連線： nfs-client

   gcloud compute ssh nfs-client

1. 在 nfs-client 的終端機視窗中執行下列指令，安裝 NFS：

   sudo apt-get -y update &&
   sudo apt-get -y install nfs-common
   

2. 在 nfs-client 執行個體上，為 Filestore 檔案共用區建立掛接目錄：

   sudo mkdir /mnt/test
   

3. 指定 Filestore 執行個體 IP 位址、檔案共用區名稱，以及要掛接的掛接目錄，即可使用 mount 指令將檔案共用區掛接到 nfs-client 執行個體：

   sudo mount MOUNT-POINT-DIRECTORY /mnt/test
   

   其中：

   MOUNT-POINT-DIRECTORY 是掛接 Filestore 檔案共用區的所在目錄路徑。例如：10.0.0.2:/vol1

   注意： 如需 NFS 掛接選項建議，請參閱掛接檔案共用區。

4. 選用：確認已掛接 Filestore 檔案共用區：

   df -h --type=nfs

5. 變更設定，開放檔案共用區的存取權限：

   sudo chmod go+rw /mnt/test
   

重要事項： 建議您在實際工作環境中設定更精細的權限。詳情請參閱設定檔案共用區的存取權。

Windows

登入 nfs-client 執行個體，然後以管理員身分開啟命令提示字元

1. 為 nfs-client 執行個體建立帳戶並設定初始密碼：

   gcloud compute reset-windows-password nfs-client
   

2. 將執行個體設定為啟用序列埠連線：

   gcloud compute instances add-metadata nfs-client --metadata=serial-port-enable=1
   

3. 輸入互動工作階段：

   gcloud compute connect-to-serial-port nfs-client --port=2
   

4. 在 SAC> 提示下，建立新通道：

   cmd
   

   系統會建立名為「Cmd0001」的頻道。

5. 連線至管道：

   ch -sn Cmd0001
   

6. 輸入 nfs-client 執行個體的使用者名稱和密碼，並將 Domain 欄位保留空白。您已連線至 nfs-client 執行個體的 Command Prompt 介面。

安裝 NFS 用戶端

1. 在 nfs-client 的 Command Prompt 中，切換至 Windows PowerShell：

   powershell
   

2. 安裝 NFS 用戶端：

   Install-WindowsFeature -Name NFS-Client
   

3. 系統出現提示時，重新啟動 nfs-client 執行個體：

   restart-computer
   

4. 在 SAC> 提示中，等待顯示下列通知：

   EVENT: The CMD command is now available.

   然後，按照先前的指示執行 cmd 和 ch -sn 指令，登入並重新連線至 nfs-client 執行個體。

設定 NFS 用戶端所用的使用者 ID

1. 在命令提示字元中執行 powershell，切換至 Windows PowerShell。

2. 在 PowerShell 中執行下列指令，建立兩個新的登錄項目 AnonymousUid 和 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. 重新啟動 NFS 用戶端服務：

   nfsadmin client stop
   
   nfsadmin client start
   

將 vol1 檔案共用區對應至 nfs-client 執行個體

1. 離開 PowerShell：

   exit
   

2. 從 Command Prompt 將檔案共用區掛接到 nfs-client 執行個體，方法是使用 mount 指令，並指定 Filestore 執行個體的 IP 位址、檔案共用區名稱，以及要掛接的磁碟機代號：

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

在已掛接的檔案共用區中建立檔案

Linux

1. 在 nfs-client 終端機視窗中執行下列指令，建立名為 testfile 的檔案：

   echo 'This is a test' > /mnt/test/testfile
   

2. 執行下列指令並確認 testfile 位於傳回的目錄內容中，確認檔案已建立：

   ls /mnt/test
   

Windows

1. 在 nfs-client 執行個體的命令提示字元視窗中，建立名為 testfile 的檔案：

   echo 'This is a test' > Z:\testfile
   

2. 執行下列指令，確認檔案已建立：

   dir Z:
   

   並確認 testfile 位於傳回的目錄內容中。

清除所用資源

為了避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用，請刪除含有這些資源的 Google Cloud 專案。

刪除 Google Cloud 專案

注意：刪除專案會造成以下結果：

• 專案中的所有內容都會遭到刪除。如果使用現有專案來進行本文中的任務，刪除專案將一併移除當中已完成的其他任務'。
• 自訂專案 ID 會消失。當您之前建立這個專案時，可能建立了想要在日後使用的自訂專案 ID。如要保留使用該專案 ID 的網址 (例如 appspot.com 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

如果打算探索多種架構、教學課程或快速入門導覽課程，重複使用專案可避免超出專案配額限制。

刪除 Google Cloud 專案：

gcloud projects delete PROJECT_ID

刪除 Filestore 執行個體

刪除 nfs-server 執行個體：

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

刪除 Compute Engine 執行個體

刪除執行個體：

gcloud compute instances delete nfs-client

後續步驟

• 請參閱 Filestore 總覽，進一步瞭解 Filestore 的基本概念。
• 按照「建立執行個體」一文中的操作說明，自行設定 Filestore 執行個體。
• 參閱存取控管一文，瞭解如何控管對 Filestore 作業及執行個體資源的存取權。
• 瞭解如何將資料複製到 Filestore 執行個體，或是複製 Filestore 執行個體中的資料。
• 瞭解如何將大型資料集從 Cloud Storage 移轉至 Filestore。