使用 Boto

本頁面說明 gsutil 如何使用 boto 設定檔,並提供 boto 協同合作範例。

在 Cloud Storage 中使用 boto

  • 安裝內含 gsutil 的 Google Cloud SDK:

    我們建議您直接安裝內含 gsutil 的 Google Cloud SDK,這樣 boto/gsutil 設定會包含用於控制 gsutil 行為方式的值;舉例來說,您可以使用 prefer_api 變數指定 gsutil 優先使用的 API。這些變數可透過直接編輯檔案加以變更。該檔案「不」包含憑證,且不會控制預設專案 ID,因為這些項目均由 Cloud SDK 處理。

  • 獨立安裝 gsutil 工具:

    獨立安裝 gsutil 工具時,boto/gsutil 設定檔會包含控制 gsutil 行為方式的值;舉例來說,您可以使用 prefer_apidefault_project_id 變數分別指定 gsutil 優先使用的 API 和預設使用的專案 ID。這些變數可透過直接編輯檔案加以變更。該檔案亦會控制憑證和 OAuth2 設定;這些項目一般是透過 gsutil config 指令加以建立。

Linux 和 macOS 作業系統的 boto 設定檔預設位置位於使用者主目錄 ~/.boto 中,而 Windows 作業系統的 boto 設定檔預設位置則位於 %HOMEDRIVE%%HOMEPATH%。如要取得該設定檔的位置,請執行 gsutil version -l 指令。

您可以透過設定 BOTO_CONFIG 環境變數來覆寫設定檔的使用位置,還可以透過設定 BOTO_PATH 環境變數來指定欲載入 boto 設定檔的路徑;在共用資料和進行協作等情境下,這些操作可能相當實用,如以下範例所示。

如需 boto 設定檔包含項目的完整清單,請參閱 gsutil config 一文。

boto 協同合作範例

在本範例中,某間小型公司想要使用 Cloud Storage 做為員工的儲存系統。身為 IT 管理員,您在 Google Cloud Platform 主控台中建立了專案,並為每位員工建立值區。為了讓員工更容易使用 Cloud Storage,您想要在中央檔案內建立和儲存適用於全公司的設定 (例如 Proxy 設定和平行複合上傳門檻),作為員工在 BOTO 設定路徑中的指向目標。如此一來,各員工便無須手動調整設定的共用部分,而管理員也能在有需要時輕鬆地變更這些共用設定。

為了達成上述目標,請執行下列步驟:

  1. 建立所有員工皆可讀取的中央 boto 設定檔。

    直接安裝內含 gsutil 的 Google Cloud SDK 時,可使用 gcloud init 完成此操作。

    舉例來說,boto 設定檔可能含有下列資訊:

    [Boto]
    proxy = yourproxy.com
    proxy_port = 8080
    
    [GSUtil]
    parallel_composite_upload_threshold = 150M
    
  2. 指示員工安裝 Google Cloud SDK

    安裝期間,員工必須指定公司目前使用的專案 ID。由於您無法集中共用驗證憑證,因此他們也必須產生個別驗證憑證

  3. 指示員工新增 BOTO_PATH 環境變數。

    BOTO_PATH 環境變數會列出中央設定檔的路徑,後面接續員工的本機設定檔。舉例來說,如果中央設定檔位於 centralhub/ 目錄中,則使用者 jane 的 BOTO_PATH 環境變數可能為:

    BOTO_PATH =/centralhub/boto.cfg:home/jane/.boto

員工執行 gsutil 時,會自動使用中央 boto 檔案內指定的設定。如有需要,管理員可以變更中央設定檔內的 Proxy 設定、平行複合上傳門檻以及其他設定,並且讓變更內容反映在所有使用中央設定檔的員工電腦上。

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

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

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