gsutil文档翻译：安装gsutil,Install gsutil

这篇文档，说明的是，如何安装gsutil。它是一个命令行工具，能够帮助妳访问到谷歌云存储（Google Cloud Storage）。

如果 妳安装了 谷歌 云软件开发工具包 ，那么，妳实际上也已经安装了gsutil。如果 妳并不想安装云软件开发工具包中那么多的组件，或者， 妳在使用PyPI 来管理软件包的话，那么， 妳可以单独安装gsutil。

内容目录

系统要求

gsutil 可运行于 Linux/Unix 。 要想使用 gsutil 的话，妳的电脑上必须安装有 Python 2.6.x 或 2.7.x 。 gsutil目前 不支持 Python 3.x 。 大部分Linux 发行版中，默认都安装了Python。另外 ：如果妳需要使用复合对象的话，那么，妳还需要安装 crcmod ， 它只可在 32 位Python 中使用。

警告： 在某些 Linux 发行版中，会预装另一个名为 gsutil 的工具，它是由GrandStream BudgeTone 提供的。如果 妳运行的是这个命令，而不是谷歌云存储的gsutil，那么， 它狠可能会输出类似如下的错误信息： "Choose one of -b, -d, -e, or -r to do something" 。如果遇到 了这种问题，妳有两种手段来解决：将谷歌云存储的 gsutil移动 到 PATH 环境变量的开头；或者 ，在运行谷歌云存储gsutil 的时候指定完整路径(例如， /home/users/joan/gsutil/gsutil ls )。

如何安装gsutil

以下小节，说明的是，如何安装 gsutil ，但不说明如何登录到谷歌云存储服务。默认情况 下，妳不需要登录到谷歌云存储服务，除非妳需要读取非公开的数据或者写入不允许公开写入的存储桶，那样的话，妳应当参考下面的 如何登录 以访问受保护的数据 小节。注意 ：默认情况下，存储桶并非是公开可写的。

使用Python 软件包索引(PyPI)来安装

实验状态！

1. 1.安装必需的系统软件包。

   要想使用PyPI 来安装 gsutil 的话，需要先安装若干个软件包。妳可以使用以下命令来安装它们：

   sudo yum install gcc openssl-devel python-devel python-setuptools libffi-devel

2. 2.安装pip。

   我们建议使用pip安装器。妳可以使用以下命令来安装它：

   sudo yum install python-pip

   如果 妳正在使用 CentOS 或 RHEL ，yum 却仍然无法找到软件包 python-pip ，那么 ，狠有可能是因为妳没有启用企业 版额外软件包（Extra Packages for Enterprise Linux (EPEL)）仓库源。 若想启用它，则 按照 这里的指示来操作 。

3. 3.从 PyPI 中安装gsutil。

   要想从 PyPI 中安装gsutil，则执行以下命令：

   sudo pip install gsutil

好了。现在 可以使用gsutil 了。 要想查看gsutil 所支持的命令列表，则在命令行中执行 gsutil 。

更新gsutil

在通过PyPI 安装的情况下，gsutil update 这个命令是不可用的。要想更新 gsutil 的话，则需要使用pip 安装器来完成：

sudo pip install -U gsutil

如何配置认证信息以访问到受保护的数据

1. 1.打开一个新的命令行窗口。

2. 2. 在这个命令行窗口中执行 gsutil config 。

   当妳第一次运行这个命令的时候，gsutil会输出一个指向认证页面的网址（URL），妳可以通过访问该网址来授权gsutil 访问谷歌云存储。gsutil会输出类似以下内容的东西：

   This script will create a boto config file at <your_homedir> /.boto

   containing your credentials, based on your responses to the following questions.

   Please navigate your browser to the following URL: <http://urlto/authorization/dialog>

   In your browser you should see a page that requests you to authorize gsutil to access

   Google Cloud Storage on your behalf. After you approve, an authorization code will be displayed.

   Enter the authorization code:

   注意 ： 如果 妳希望 gsutil 为妳启动一个浏览器窗口的话，那么，应该执行 gsutil config -b ，而不是 gsutil config 。然而 ，如果妳是使用 SSH连接 到了一个远程电脑的话，那么， -b 选项可能不起作用。

3. 3.复制该网址并粘贴到浏览器窗口中。

   在浏览器窗口中，如果看到提示的话，则以与妳的谷歌云存储数据相关联的谷歌账号登录。

4. 4.点击允许访问（Allow Access）按钮。

   这样，就完成了对 gsutil 的授权，使得它能够访问到谷歌云存储了。

5. 5.复制接下来的页面中出现的认证码，粘贴到gsutil 命令行窗口中，然后按回车键（Enter）。

6. 6.登录到谷歌云平台控制台，找到一个可指定为默认项目的项目编号。

   在妳提供了认证码之后， gsutil 会输出以下的提示，并且输出一个指向 谷歌 云平台控制台 的网址。复制 该网址并且粘贴到浏览器窗口中。

   Please navigate your browser to the following URL:

   https://console.cloud.google.com/

   What is your project-id?

7. 7.复制项目编号，并且粘贴到gsutil 中去。

   选择 一个项目以设置为 gsutil 的默认项目，具体做法就是：点击左侧 的 概 览 （ Overview ）标签页，复制项目编号 ，然后将项目编号输入到gsutil 所在的命令行窗口中。如果别人 给了妳一个项目编号，那么，妳也可以在这里输入它。 同一时刻，只能向gsutil 设置一个项目编号。

   任何时候 ，都可以通过编辑 boto配置文件 来改变gsutil 中的项目编号。

这就行了。 妳可以开始使用gsutil 了。 要想查看gsutil 支持的命令列表，则在命令行中执行 gsutil 。

如何将gsutil 切换为使用OAuth 2.0

如果 妳当前是在gsutil 中使用 HMAC认证 及开发者密钥 的话，那么，我们建议妳切换为使用 OAuth 2.0认证 。按照 以下说明来为gsutil 设置OAuth 2.0。

1. 1. 按照 上文的说明 来安装最新版的gsutil。

2. 2. 在命令行中运行 gsutil config 。

   gsutil 会输出一个指向认证页面的网址（ URL ），妳可以通过访问该网址来授权gsutil 访问谷歌云存储。 gsutil 会输出类似以下内容的东西：

   Backing up existing config file ' <your_homedir> /.boto' to ' <your_homedir> /.boto.bak'...

   This script will create a boto config file at <your_homedir> /.boto

   containing your credentials, based on your responses to the following questions.

   Please navigate your browser to the following URL:   <http://urlto/authorization/dialog>

   In your browser you should see a page that requests you to authorize gsutil to access

   Google Cloud Storage on your behalf. After you approve, an authorization code will be displayed.

   Enter the authorization code:

   注意 ： 如果 妳希望 gsutil 为妳启动一个浏览器窗口的话，那么，应该执行 gsutil config -b ，而不是 gsutil config 。然而 ，如果妳是使用 SSH连接 到了一个远程电脑的话，那么， -b 选项可能不起作用。

   如果gsutil输出了以下错误消息：

   CommandException: Cannot back up existing config file ' <your_homedir> /.boto':

   backup file exists (' <your_homedir> .boto.bak').

   则表示，gsutil无法创建一个新的配置文件，因为，已经存在两个配置文件了。妳需要删除一个文件或者将它改名，才能让gsutil继续进行配置过程。

   另外 ，也可以 向gsutil 提供一个不同的权限级别，具体做法是，在执行 gsutil config 命令的时候带上以下选项：

   • •. 请求获取只读权限 的令牌： -r

   • •. 请求获取 读写权限的令牌： -w

1. • •. 请求获取具有完全控制 权限（包括修改访问控制列表 （ Access Control Lists (ACLs) ） ）的令牌： -f

1. • •. 请求 一个具有其它谷歌服务的权限的令牌： -s <scope>

     注意 ： 一般来说， gsutil 并不具有对其它的谷歌应用编程接口进行访问的能力。然而 ， 妳可以使用这个选项来与 -r 、 -w 或 -f 选项组合起来 ，以获取到一个 可以同时访问谷歌云存储和另一个谷歌应用编程接口的令牌。 要想找到某个特定应用编程接口所对应的权限字符串，则参考该应用编程接口的文档。

2. 3.复制该网址并粘贴到浏览器窗口中。

   在浏览器窗口中，如果看到提示的话，则以与妳的谷歌云存储数据相关联的谷歌账号登录。

3. 4.点击允许访问（Allow Access）按钮。

   这样，就完成了对 gsutil 的授权，使得它能够访问到谷歌云存储了。

4. 5.复制接下来的页面中出现的认证码，粘贴到gsutil 命令行窗口中。

5. 6. 登录 到谷歌云平台控制台，找到一个可指定为默认项目的项目编号。

   在妳提供了认证码之后， gsutil 会输出以下的提示，并且输出一个指向 谷歌 云平台控制台 的网址。复制 该网址并且粘贴到浏览器窗口中。

   Please navigate your browser to the following URL:

   https://console.cloud.google.com/

   What is your project-id?

6. 7.复制项目编号，并且粘贴到gsutil 中去。

   选择 一个项目以设置为 gsutil 的默认项目，具体做法就是：点击左侧 的 概 览 （ Overview ）标签页，复制项目编号 ，然后将项目编号输入到gsutil 所在的命令行窗口中。

   任何时候 ，都可以通过编辑 boto配置文件 来改变gsutil 中的项目编号。 当妳使用 XML 或 JSON应用编程接口 时，某些操作 （例如创建存储 桶 ）中要求妳提供一个项目编号 。 gsutil允许 妳在boto 配置文件中指定一个默认的项目编号， 这样， 在妳针对默认项目进行操作时，就不需要显式指定项目编号了。

恭喜，妳已经设置好了gsutil，让它使用OAuth 2.0 认证了！

如何在谷歌云存储中使用boto

1. 1.设置好boto 配置文件，以使用OAuth 2.0。

   妳可以利用gsutil 来完成这一点，具体就是，运行 gsutil config 命令。如果 妳尚未安装gsutil，那么，阅读 gsutil安装说明 。

2. 2. 在boto 配置文件中，确保[Boto]小节中的 https_validate_certificates 标志位未被设置为 False 。

   这个选项实现了服务器证书验证。欲知更多关于配置文件位置 的信息，则阅读 boto配置文件 。

3. 3.在PYTHONPATH 中，加入gsutil、boto 和gcs-oauth2-boto-plugin 库。

   向妳的.bashrc或.bash_profile文件中加入以下代码。

   export PYTHONPATH=${PYTHONPATH}:$HOME/gsutil/third_party/boto:$HOME/gsutil/third_party/gcs-oauth2-boto-plugin:$HOME/gsutil

   如果 妳将gsutil 安装到了家目录之外的某个目录，则，将 $HOME 替换成gsutil 目录实 际 存在的目录。

4. 4.导入oauth2_plugin。

   以下语句会导入oauth2_plugin：

   from gcs_oauth2_boto_plugin import oauth2_plugin

这就可以了！现在，妳可以在boto 中使用OAuth 2.0 认证了。以下示例，在boto 中使用OAuth 2.0 认证来请求获取一个名为rose.txt 的文本文件的内容：

from boto import storage_uri

from gcs_oauth2_boto_plugin import oauth2_plugin

content = storage_uri('gs://pub/shakespeare/rose.txt').get_contents_as_string()

print(content)

注意 ： 在妳的开发环境中，可能需要做出比这里显示的还要多的配置。如果 以上示例代码无法正常工作，那么， 妳可 能 需要安装一些必须的软件包，并且更新 PYTHONPATH ，将 $HOME/gsutil/third_party 中那些软件包的路径包含进去。 要想在Python 中安装软件包，妳可以使用 pip 。例如 ，要想安装 httplib2 软件包，则执行 pip install httplib2 。

boto配置文件

boto/gsutil 的配置文件，指定 了一些值，它们控制着 gsutil 的行为，以及，认证 和 OAuth2设置信息 。 一般情况下，妳都是通过 gsutil config 命令 来间接地操作配置文件 的。 在某些情况下，妳可能需要直接编辑该文件，例如，当妳需要改变默认项目编号 的时候。欲知更多关于boto 配置文件 中内容的信息，则阅读 gsutil config 。

对于Linux 操作系统 ，boto 配置文件的默认路径位于用户的家目录 ，~/.boto 。 妳可以通过运行 gsutil version -l 命令来获取该配置文件的位置。

妳可以通过设置BOTO_CONFIG 环境变量来改写配置文件的位置。 妳还可以指定一个路径，以载入该路径中的所有boto 配置文件。 这个功能狠有用，例如，在 数据分享 及协作 场景下就狠有用。

未知美人

未知美人