使用 gcloud 工具探索物件儲存空間

使用 gcloud 工具探索物件儲存空間

本頁面說明如何使用 gcloud 指令列工具在 Cloud Storage 中執行基本工作。

Cloud Storage 產生的費用取決於您耗用的資源。這項快速入門導覽課程使用的 Cloud Storage 資源通常不到 $0.01 美元。

事前準備

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
<x0A> <x0A>
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 (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.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
• PROJECT_ID: Your project ID.
• USER_IDENTIFIER: The identifier for your user account. For example, [e-mail].
• ROLE: The IAM role that you grant to your user account.

Install the Google Cloud CLI.

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

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

gcloud init

<x0A> <x0A>

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

Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Replace the following:

• PROJECT_ID: Your project ID.
• USER_IDENTIFIER: The identifier for your user account. For example, [e-mail].
• ROLE: The IAM role that you grant to your user account.
注意： 如果您使用 Cloud Shell 或 Compute Engine 執行個體，系統會預先安裝並驗證 Google Cloud SDK。如果您的 Compute Engine 執行個體在沒有服務帳戶範圍的情況下設為 Cloud Storage，請執行 gcloud init 並按照操作說明進行操作。

建立值區

「bucket」是 Cloud Storage 中存放資料的基本容器。

如何建立值區：

1. 開啟終端機視窗。

2. 使用 gcloud storage buckets create 指令和專屬名稱來建立值區：

   gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access

   指令使用名稱為「my-awesome-bucket」的值區。您必須選擇自己擁有且全域專屬的值區名稱。

   請參閱值區命名需求。

   • bucket 名稱只能含有小寫字母、數字、破折號 (-)、底線 (_) 與點 (.)，不得包含空格。如果名稱含有點，則必須經過驗證。
   • bucket 名稱的開頭與結尾必須是數字或英文字母。
   • bucket 名稱必須包含 3 至 63 個字元。如果名稱中包含點，則其長度上限為 222 個字元，但每個以點分隔的字串組合不得超過 63 個字元。
   • 值區名稱不得為採用小數點十進位表示法 (例如 192.168.5.4) 的 IP 位址。
   • 值區名稱不得使用「goog」前置字串做為開頭。
   • 值區名稱不得包含「google」或類似錯別字，例如「g00gle」。
   注意： 由於值區命名空間屬於全域性質，並且會公開顯示，因此請勿在值區名稱中加入任何機密資訊。

   如果執行成功，指令會傳回下列內容：

   Creating gs://my-awesome-bucket/...

您已經建立值區，可以開始儲存您的資料！

注意： 如果所選值區名稱已有人使用 (無論是您或其他人)，指令就會傳回下列內容：

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

請使用其他值區名稱再試一次。

將物件上傳到值區



1. 在上方的圖片上按一下滑鼠右鍵，並將圖片儲存至電腦的任意位置 (例如桌面)。

   注意：如果您使用 Cloud Shell 或 Compute Engine 執行個體，請使用下列指令下載圖片： wget https://cloud.google.com/storage/images/kitten.png

2. 使用 gcloud storage cp 指令將位於儲存位置的圖片複製到您建立的值區中：

   gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

   如果執行成功，指令會傳回下列內容：

   Copying file://Desktop/kitten.png [Content-Type=image/png]...
   Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
   Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

   您剛剛在值區中儲存了一個物件。

注意：鍵入值區名稱時，您可以按下 Tab 鍵以自動完成。

從 bucket 下載物件

1. 使用 gcloud storage cp 指令將儲存在值區中的圖片下載至電腦任意位置 (例如桌面)：

   gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

   如果執行成功，指令會傳回下列內容：

   Copying gs://my-awesome-bucket/kitten.png...
   Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
   Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

   您剛剛下載了值區中的物件。

將物件複製到值區中的資料夾

1. 使用 gcloud storage cp 指令建立資料夾，並將圖片複製到資料夾中：

   gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

   注意： 與本機檔案系統相比，Cloud Storage 中的資料夾設有限制，但仍支援許多相同的作業。

   如果執行成功，指令會傳回下列內容：

   Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
   Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

   您剛剛已將圖片複製到值區中的新資料夾。

列出值區或資料夾的內容

1. 使用 gcloud storage ls 指令列出值區頂層的內容：

   gcloud storage ls gs://my-awesome-bucket

   如果成功，指令會傳回類似以下的訊息：

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/just-a-folder/

   您剛剛看到了值區頂層的內容。

列出物件的詳細資料

1. 使用帶有 --long 旗標的 gcloud storage ls 指令，取得圖片的一些詳細資料：

   gcloud storage ls gs://my-awesome-bucket/kitten.png --long

   如果成功，指令會傳回類似以下的訊息：

   2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
   TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

   您剛剛取得了圖片大小和建立日期的相關資訊。

將物件設為可公開存取

1. 使用 gcloud storage buckets add-iam-policy-binding 指令授予權限，讓所有使用者都能讀取值區圖片：

   gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

   如果回應包含下列內容，表示指令執行成功：

   bindings:
     - members:
       - allUsers
       role: roles/storage.objectViewer
   

   現在任何人都能取得您的圖片。

2. 如要移除這個存取權，請使用下列指令：

   gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

   如果系統未傳回錯誤，即代表指令執行成功。

   您已移除值區中圖片的公開存取權。

注意： 移除公開存取權後，在一段時間內，您還是可以存取圖片的快取版本。

向使用者提供值區的存取權

1. 使用 gcloud storage buckets add-iam-policy-binding 指令授予特定電子郵件地址在值區中新增物件的權限：

   gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:[e-mail] --role=roles/storage.objectCreator

   如果回應包含下列內容，表示指令執行成功：

   bindings:
     - members:
       - user:[e-mail]
       role: roles/storage.objectCreator
   

   現在其他使用者可以將項目加入值區。

2. 如要移除這個權限，請使用以下指令：

   gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:[e-mail] --role=roles/storage.objectCreator

   如果系統未傳回錯誤，即代表指令執行成功。

   您剛剛移除了使用者對這個值區的存取權。

刪除物件

1. 使用 gcloud storage rm 指令刪除其中一張圖片：

   gcloud storage rm gs://my-awesome-bucket/kitten.png

   如果執行成功，指令會傳回下列內容：

   Removing gs://my-awesome-bucket/kitten.png...

   Cloud Storage 中已不存在這個圖片副本 (雖然您在資料夾 just-a-folder/ 中產生的副本仍然存在)。

清除所用資源

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

1. 開啟終端機視窗 (如果尚未開啟)。

2. 使用 gcloud storage rm 指令並加上 --recursive 標記，刪除值區及其中的內容：

   gcloud storage rm gs://my-awesome-bucket --recursive

   如果成功，指令會傳回類似以下的訊息：

   Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
   Removing gs://my-awesome-bucket/...

   您刪除了值區和其內容。

後續步驟

• 使用 Google Cloud 控制台逐步完成 Cloud Storage 快速入門導覽課程。
• 參閱 Cloud Storage 產品總覽。

• 瞭解 Cloud Storage 定價。

• 請參閱 Google Cloud CLI 指令的參考頁面，例如建立值區 (buckets create)、複製 (cp)、列出 (ls)、新增存取權 (buckets add-iam-policy-binding)，以及移除 (rm)。