设置 .NET 开发环境

本教程介绍了如何为 .NET.NET Core 应用的开发准备本地机器,这些应用在 Google Cloud 上运行并调用 Google Cloud API。

安装开发环境

在本文档中,用于运行 .NET 教程和示例应用的推荐开发环境是 Visual StudioVisual Studio Code

创建 Google Cloud 项目

创建一个 Google Cloud 项目以运行您的应用。Google Cloud 项目构成创建、启用和使用所有 Google Cloud 服务的基础。

身份验证

在本地开发期间,您的 .NET 应用必须进行自身身份验证,才能与 Google Cloud API 进行互动。以下说明介绍如何创建服务帐号密钥以对您的应用进行身份验证。应用可以使用此方法在本地以及部署到 Google Cloud 时进行身份验证。详细了解身份验证,包括部署应用后如何处理身份验证。

创建用于身份验证的服务帐号密钥

Cloud Console

创建服务帐号:

  1. 在 Cloud Console 中,转到创建服务帐号页面。

    转到“创建服务帐号”
  2. 选择一个项目。
  3. 服务帐号名称字段中,输入一个名称。 Cloud Console 会根据此名称填充服务帐号 ID 字段。

    服务帐号说明字段中,输入说明。例如,Service account for quickstart

  4. 点击创建
  5. 点击选择角色字段。

    快速访问下,点击基本,然后点击所有者

  6. 点击继续
  7. 点击完成以完成服务帐号的创建过程。

    不要关闭浏览器窗口。您将在下一步骤中用到它。

创建服务帐号密钥:

  1. 在 Cloud Console 中,点击您创建的服务帐号的电子邮件地址。
  2. 点击密钥
  3. 依次点击添加密钥创建新密钥
  4. 点击创建。JSON 密钥文件将下载到您的计算机上。
  5. 点击关闭

命令行

您可以使用本地机器上的 Cloud SDK 或在 Cloud Shell 中运行以下命令。

  1. 创建服务帐号。将 NAME 替换为服务帐号的名称。

    gcloud iam service-accounts create NAME
  2. 向服务帐号授予权限。将 PROJECT_ID 替换为您的项目 ID。

    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role="roles/owner"
  3. 生成密钥文件。将 FILE_NAME 替换为密钥文件的名称。

    gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com

接下来,将环境变量 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 资源,也可以考虑安装以下工具:

  • Cloud SDK:Cloud SDK 是 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 资源。

后续步骤