本教程介绍了如何为 .NET 和 .NET Core 应用的开发准备本地机器,这些应用在 Google Cloud 上运行并调用 Google Cloud API。
安装开发环境
在本文档中,用于运行 .NET 教程和示例应用的推荐开发环境是 Visual Studio 或 Visual Studio Code。
创建 Google Cloud 项目
创建一个 Google Cloud 项目以运行您的应用。Google Cloud 项目构成创建、启用和使用所有 Google Cloud 服务的基础。
Authentication
在本地开发期间,您的 .NET 应用必须进行自身身份验证,才能与 Google Cloud API 进行互动。以下说明介绍如何创建服务帐号密钥以对您的应用进行身份验证。应用可以使用此方法在本地以及部署到 Google Cloud 时进行身份验证。详细了解身份验证,包括部署应用后如何处理身份验证。
创建用于身份验证的服务帐号密钥
控制台
创建服务帐号:
-
在控制台中,打开创建服务帐号页面。
打开“创建服务帐号” - 选择您的项目。
-
在服务帐号名称字段中,输入一个名称。控制台会根据此名称填充服务帐号 ID 字段。
在服务帐号说明字段中,输入说明。例如,
Service account for quickstart
。 - 点击创建并继续。
-
如需提供对项目的访问权限,请向服务帐号授予以下角色:Project > Owner。
在选择角色列表中,选择一个角色。
如需添加其他角色,请点击
添加其他角色,然后添加其他各个角色。 - 点击继续。
-
点击完成以完成服务帐号的创建过程。
不要关闭浏览器窗口。您将在下一步骤中用到它。
创建服务帐号密钥:
- 在控制台中,点击您创建的服务帐号的电子邮件地址。
- 点击密钥。
- 点击添加密钥,然后点击创建新密钥。
- 点击创建。JSON 密钥文件将下载到您的计算机上。
- 点击关闭。
gcloud
设置身份验证:
-
创建服务帐号:
gcloud iam service-accounts create NAME
将
NAME
替换为服务帐号的名称。 -
向服务帐号授予角色。对以下每个 IAM 角色运行以下命令一次:
roles/owner
gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=ROLE
替换以下内容:
SERVICE_ACCOUNT_NAME
:服务帐号的名称PROJECT_ID
:您在其中创建服务帐号的项目的 IDROLE
:要授予的角色
-
生成密钥文件:
gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
替换以下内容:
FILE_NAME
:密钥文件的名称SERVICE_ACCOUNT_NAME
:服务帐号的名称PROJECT_ID
:您在其中创建服务帐号的项目的 ID
接下来,将环境变量 GOOGLE_APPLICATION_CREDENTIALS
设置为已下载的 JSON 密钥的路径。在 PowerShell 中,命令如下所示:
对于此 PowerShell 会话:
PS > $env:GOOGLE_APPLICATION_CREDENTIALS = "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json"
对于此命令后创建的所有进程:
PS > [Environment]::SetEnvironmentVariable("GOOGLE_APPLICATION_CREDENTIALS", "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json", "User")
(可选)安装 .NET 工具和 SDK
尽管您可以通过网络浏览器使用 Google Cloud Console 创建和管理 Google Cloud 资源,但如果您希望通过 Visual Studio 或命令行来管理 Google Cloud 资源,则可以考虑安装以下工具:
Google Cloud CLI:gcloud CLI 是适用于 Google Cloud 产品和服务的命令行界面。
Tools for Visual Studio:Tools for Visual Studio 可在 Google Cloud 上的 Visual Studio 中进行开发。
Tools for PowerShell:Tools for PowerShell 是 Windows PowerShell 的一组 cmdlet,可用于管理 Google Cloud 资源。