使用 Boto

本页面介绍 gsutil 如何使用 boto 配置文件,并提供了一个 boto 协作示例。

在 Cloud Storage 中使用 boto

  • gsutil 随 Google Cloud SDK 一同安装后:

    我们建议您随 Google Cloud SDK 一起安装 gsutil。采用这种安装方式时,boto/gsutil 配置文件中包含用于控制 gsutil 行为方式的值,例如,您可以通过 prefer_api 变量控制 gsutil 优先使用哪个 API。您可以更改这些变量,直接修改此文件即可。此文件不包含凭据,也不控制默认项目 ID,因为这些内容由 Cloud SDK 进行处理。

  • gsutil 作为独立工具安装后:

    将 gsutil 作为一个独立工具安装后,boto/gsutil 配置文件会包含用于控制 gsutil 行为方式的值,例如,您可以分别通过 prefer_apidefault_project_id 变量控制 gsutil 优先使用哪个 API 及 gsutil 使用的默认项目 ID。您可以更改这些变量,直接修改此文件即可。此文件还可控制凭据和 OAuth2 设置,这些内容通常是使用 gsutil config 命令创建的。

boto 配置文件的默认位置位于用户主目录 ~/.boto(对于 Linux 和 Mac OS X)和 %HOMEDRIVE%%HOMEPATH%(对于 Windows)中。您可以通过运行 gsutil version -l 命令来获取此配置文件的位置。

可通过设置 BOTO_CONFIG 环境变量替换使用此配置文件的位置,还可通过设置 BOTO_PATH 环境变量来设定要加载的 boto 配置文件的路径。例如,在数据共享和协作场景(如下面的示例所示)中,这些操作会很有用。

如需 boto 配置文件所含内容的完整列表,请参阅 gsutil config

boto 协作示例

在此示例中,一家小型公司希望使用 Cloud Storage 作为其员工的存储系统。IT 管理员需要在 Google Cloud Platform Console 中创建项目,并为每位员工创建存储分区。为了让员工更轻松地使用 Cloud Storage,您需要创建公司范围内的设置(如代理配置和并行复合上传阈值),并将这些设置存储到各员工可在其 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 文件中指定的配置。如有必要,管理员可以更改中央配置文件中的代理设置、并行复合上传阈值和其他设置,并将所做更改反映给所有使用中央配置文件的员工。

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Cloud Storage
需要帮助?请访问我们的支持页面