gcloud init 来执行初始设置任务。gcloud init 命令会执行以下步骤:
使用用户账号凭据进行身份验证,然后授权 gcloud CLI 代表您访问 Google Cloud 资源。您也可以使用
gcloud auth login命令单独执行此操作。设置 gcloud CLI 配置 并设置核心属性,例如活跃账号、 当前项目以及默认的 Compute Engine 区域和可用区(如适用)。
如果您已初始化 gcloud CLI,则再次运行 gcloud init 可让您更改现有设置或创建新配置。
初始化 gcloud CLI
如需初始化 gcloud CLI,请执行以下操作:
-
运行
gcloud init:gcloud init如果您使用的是远程终端会话,请添加
--console-only flag。此标志会提供身份验证和授权流程的网址,而不是尝试在默认浏览器中打开该网址。gcloud init --console-only
-
根据提示创建或选择配置。
对于新的 gcloud CLI 安装,
gcloud init会为您创建一个名为default的配置并将其设置为 活跃配置。如果您已有配置,gcloud init会提示您在以下选项中进行选择:- 重新初始化活跃配置。
- 切换到另一个配置并重新初始化。
- 创建新配置。
-
根据提示完成身份验证和授权步骤。
如果您之前已授权访问 Google Cloud,系统可能会 提示您重新登录并在网络浏览器中授予访问权限,或提示您 选择现有账号。
如果您使用了
--console-only标志并且需要登录,请将提供的授权网址复制并粘贴到另一个浏览器窗口中,然后按照提示操作。 -
根据提示选择 Google Cloud 项目。
如果您只能访问一个项目(包括您的用户账号的默认项目 ),
gcloud init会为您选择该项目。否则,您可以从您拥有 Owner 、Editor 或 Viewer 角色的项目列表中选择一个项目。如果您有 权访问超过 200 个项目,系统会提示您输入项目 ID、 创建新项目或列出项目。
-
如果出现提示,请选择默认的 Compute Engine 可用区。 如果您没有启用 Compute Engine API,或者您的项目级层元数据中已经存在默认可用区,系统会跳过此步骤。
查看配置属性
如需查看通过 gcloud init 命令设置的属性,请使用
gcloud config list 命令。该命令会返回类似于以下示例的输出:
[compute]
region = us-east1
zone = us-east1-b
[core]
account = dana@example.com
disable_usage_reporting = False
project = example-project
后续步骤
如需详细了解 gcloud CLI 的身份验证,请参阅 gcloud CLI 的身份验证。
如需详细了解如何为 Cloud 客户端库和 Google API 客户端库授权应用默认凭据 (ADC),请参阅 设置应用默认凭证。
如需详细了解如何管理配置,请参阅 管理 gcloud CLI 配置。
如需详细了解如何管理属性,请参阅 管理 gcloud CLI 属性。