使用 gcloud CLI 建立 Filestore 執行個體

使用 gcloud CLI 建立 Filestore 執行個體

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

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

事前準備

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.

Install the Google Cloud CLI.

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

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

gcloud init

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• 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.

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

Verify that billing is enabled for your Google Cloud project.

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

Install the Google Cloud CLI.

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

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

gcloud init

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• 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.

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

Verify that billing is enabled for your Google Cloud project.

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

必要的角色

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

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

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

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

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

建立 Compute Engine VM

Linux

1. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance 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. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance nfs-client.
   • 將 --zone 旗標設為 us-central1-c。
   • 將 --image-project 旗標設為 windows-cloud。
   • 將 --image-family 旗標設為 windows-2012-r2。
   • 將 --tags 旗標設為 http-server,http-server,。

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

建立 IAM 執行個體

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

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

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

     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 執行個體中掛接 IAM 檔案共用區

Linux

1. Establish an SSH connection to the 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 執行個體上，為 IAM 檔案共用區建立掛接目錄：

   sudo mkdir /mnt/test
   

3. 指定 IAM 執行個體的 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，使用 mount 指令將檔案共用區掛接到 nfs-client 執行個體，並指定 IAM 執行個體的 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 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

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

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

刪除 IAM 執行個體

刪除 nfs-server 執行個體：

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

刪除 Compute Engine 執行個體

刪除執行個體：

gcloud compute instances delete nfs-client

後續步驟

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