安裝 gsutil

本頁面說明如何安裝及設定 gsutil,這項工具可讓您透過指令列存取 Cloud Storage。

只要安裝 gsutil,即可立即讀取及/或寫入公開資料。如果通過 Cloud Storage 服務驗證,您就能讀取及/或寫入他人與您共用的受保護資料。啟用計費功能則讓您建立及管理自己的值區。

系統需求

  • gsutil 工具可以在 Linux/Unix、Mac OS 和 Windows (XP 或更新版本) 上執行。

  • 如要使用複合物件,則必須安裝經過編譯的 crcmod。在 Windows 上,這種做法僅適用於 32 位元 Python。

安裝 gsutil

Google Cloud SDK 包含官方支援的 gsutil 安裝及更新方法。

安裝 Google Cloud SDK 內含的 gsutil:

按照適用於您作業系統的操作說明,安裝 Google Cloud SDK 內含的 gsutil:

Linux
  1. 在命令提示字元中輸入以下內容:
    curl https://sdk.cloud.google.com | bash
  2. 重新啟動殼層:
    exec -l $SHELL
  3. 執行 gcloud init 以初始化 gcloud 環境:
    gcloud init
Debian/Ubuntu

您可以取得套件格式的 Cloud SDK,並在 Debian 和 Ubuntu 系統上予以安裝。這個套件只包含 gcloudgcloud alphagcloud betagsutilbq 指令,不包括 kubectl 或使用 gcloud 指令部署應用程式所需的 App Engine 擴充功能。如需這些元件,您必須按照本節後段的說明分別安裝。

在所有尚未終止服務的官方版 Ubuntu 與 Wheezy 日後的 Debian 穩定版本上,您可以透過 Debian/Ubuntu 套件安裝 Cloud SDK。

注意:如果您在 Google Compute Engine 上使用執行個體,則系統已預設安裝 Cloud SDK。但您仍然可以按照下面的指示手動安裝 Cloud SDK。

  1. 建立環境變數,以進行正確的發布作業:
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. 新增 Cloud SDK 發布作業 URI 做為套件來源:
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    附註:如果您已安裝 apt-transport-https,可在此步驟中使用「https」取代「http」。
  3. 匯入 Google Cloud 公開金鑰:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    疑難排解提示:如果您因為金鑰過期而無法得到最新的更新內容,請取得最新的 apt-get.gpg 金鑰檔案
  4. 更新並安裝 Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    附註:如需停用提示或模擬測試等其他 apt-get 選項的資訊,請參閱 apt-get 手冊頁面
  5. 您也可以選擇安裝下列任一附加元件
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-bigtable-emulator
    • kubectl

    例如,您可以按照以下方式安裝 google-cloud-sdk-app-engine-java 元件:

    sudo apt-get install google-cloud-sdk-app-engine-java
  6. 執行 gcloud init 以開始使用:
    gcloud init
macOS
  1. 在命令提示字元中輸入以下內容:
    curl https://sdk.cloud.google.com | bash
  2. 重新啟動殼層:
    exec -l $SHELL
  3. 執行 gcloud init 以初始化 gcloud 環境:
    gcloud init
Windows
  1. 下載 Cloud SDK 安裝程式。這個安裝程式是由 Google Inc. 簽署。

  2. 啟動安裝程式並按照提示操作。

    Cloud SDK 需要使用 Python 2.7.9 以上版本的 Python 2。 安裝程式會安裝所有必需的依附元件,包含所需的 Python 預設版本。如果您已經安裝 Python 2.x.y,而且想要使用現有的安裝版本,則可以取消勾選「安裝隨附 Python」的選項。

  3. 安裝完成後,請接受下列選項:

    • 啟動 Cloud SDK Shell
    • 執行 gcloud init

  4. 安裝程式會開啟終端機視窗並執行 gcloud init 指令。

  5. 預設的安裝不包括使用 gcloud 指令部署應用程式所需的 App Engine 擴充功能。您可利用 Cloud SDK 元件管理員來安裝這些元件。

附註:在執行 Windows Server 的 Google Compute Engine 執行個體上,Internet Explorer 會採用增強式安全性設定。這會導致您無法執行前述的安裝程式。請先停用增強式安全性設定,重新啟動 Internet Explorer,然後再執行安裝程式。如需在 Windows Server 執行個體上停用增強式安全性設定的操作說明,請開啟「Windows 說明及支援」並搜尋「IE ESC」。

使用 components update 指令執行更新:gcloud components update

如要瞭解如何使用 gsutil,請參閱快速入門導覽課程:使用 gsutil 工具一文來進行練習,或是執行 gsutil help

替代安裝方法

有幾種方法能夠以獨立產品的形式安裝 gsutil。如果不想要使用 Cloud SDK 隨附的其他任何元件,或者是透過 PyPI 來管理套件,那麼您可能會想要採用下列其中一種方法。

如果您將 gsutil 做為獨立產品來進行安裝,則必須滿足下列這項額外的系統需求:由於 gsutil 目前無法在 Python 3.x 上執行,因此您必須在電腦上安裝 Python 2.7.x 版。根據預設,大多數的 Linux 和 macOS 版本均已安裝 Python。然而,Windows 系統上並沒有預先安裝 Python,因此您必須先安裝 Python,才能在 Windows 上執行 gsutil。

展開您需要的方法來取得操作說明。

設定憑證以存取受保護的資料

安裝 gsutil 可讓您下載及存取能公開存取的物件,但是您必須設定憑證 (驗證),才能存取受保護的資料或寫入受保護的值區。舉例來說,如果某位使用者建立了 Cloud Storage 帳戶,並且上傳只提供您或其他特定使用者存取的資料,那麼您必須向 Cloud Storage 服務設定憑證,才能存取這類資料。

如果您是安裝 Google Cloud SDK 內含的 gsutil,請按照下列操作說明。如果不是,則請參閱驗證獨立式 gsutil 一節。

驗證 Google Cloud SDK

將 gsutil 併入 Google Cloud SDK 使用時,您會透過 OAuth2 進行驗證和授權存取。請注意,如果您有按照上述安裝 Google Cloud SDK 內含的 gsutil一節的內容進行操作,那麼您可能已經執行下列步驟。如果您先前執行過 gcloud init,系統會詢問您要重新初始化設定,或是要建立新的設定。

  1. 開啟命令提示字元執行個體。

  2. 在命令提示字元中執行 gcloud init

    您會收到下列輸出內容:

    Welcome! This command will take you through the configuration of gcloud.
    
    Your current configuration has been set to: [default]
    
    To continue, you must login. Would you like to login (Y/n)?
    

  3. 輸入「Y」並按下 Enter 鍵進行登入。

    • 該指令會輸出一個網址,並嘗試開啟瀏覽器視窗以要求存取您的專案。如果瀏覽器視窗能夠開啟,您就會看到以下的輸出內容:

      Your browser has been opened to visit:
      
      https://accounts.google.com/o/oauth2/auth?redirect_uri=http%3A%2F%2F...
      

      前往下一步。

    • 如果您是使用本機電腦工作,但是瀏覽器並未自動載入網址,請搭配 --console-only 標記重新執行 gcloud init 指令:

      gcloud init --console-only
      

      如果您使用這項指令,或 Cloud SDK 偵測到瀏覽器無法開啟 (例如您是使用遠端電腦工作),您就會看到以下的輸出內容:

      Go to the following link in your browser:
      
      https://accounts.google.com/o/oauth2/auth?redirect_uri=urn%3Aietf%3Awg%3A...
      
      Enter verification code:
      

      開啟瀏覽器並前往提供的網址。

  4. 如果畫面出現提示,請在瀏覽器視窗中使用與 Cloud Storage 資料相關的 Google 帳戶登入。

  5. 授予存取權。

    • 如果瀏覽器視窗自動開啟,請查看應用程式權限,並在準備完畢後按一下 [Accept] (接受)。接著系統就會自動將驗證碼傳送至指令列工具。

    • 如果您正在使用遠端電腦工作,或是使用了 --console-only 標記,請從網址複製驗證碼,然後將驗證碼貼到終端機指令列的 Enter verification code: 後方。

  6. 選擇此設定的預設專案。

    設定憑證後,gcloud 指令列工具會提示您選擇這個設定的預設專案,並且會提供可用專案的清單。請從清單中選取專案 ID。

    設定這個屬性後,除非您使用 -p 標記覆寫指令或設定 CLOUDSDK_CORE_PROJECT 環境變數,否則像是 gsutil mb 這類需要專案的 gsutil 指令都會使用預設專案 ID。

大功告成,您現在可以開始存取受保護的資料。如要查看 gsutil 指令的清單,請在命令提示字元視窗中輸入 gsutil

驗證獨立式 gsutil

透過 HMAC 進行驗證

雖然我們建議您使用 OAuth 2.0 來驗證 gsutil,但是您也可以使用 HMAC 驗證與開發人員金鑰。如要進行此操作,請在 gsutil config 指令中使用 -a 標記:

gsutil config -a

使用這個指令進行的程序與驗證獨立式 gsutil 類似 (請參閱上述章節的內容),不同之處在於系統會提示您輸入「google 存取金鑰 ID」和「google 存取權密鑰」

如果您使用的是 Google Cloud SDK,您也應該使用下列指令停用憑證傳遞功能:

gcloud config set pass_credentials_to_gsutil false

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Storage
需要協助嗎?請前往我們的支援網頁