设置 .NET 开发环境

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

安装开发环境

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

创建 Google Cloud 项目

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

Authentication

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

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

控制台

创建服务帐号:

  1. 在控制台中,打开创建服务帐号页面。

    打开“创建服务帐号”
  2. 选择您的项目。
  3. 服务帐号名称字段中,输入一个名称。控制台会根据此名称填充服务帐号 ID 字段。

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

  4. 点击创建并继续
  5. 如需提供对项目的访问权限,请向服务帐号授予以下角色:Project > Owner

    选择角色列表中,选择一个角色。

    如需添加其他角色,请点击 添加其他角色,然后添加其他各个角色。

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

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

创建服务帐号密钥:

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

gcloud

设置身份验证:

  1. 创建服务帐号:

    gcloud iam service-accounts create NAME

    NAME 替换为服务帐号的名称。

  2. 向服务帐号授予角色。对以下每个 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:您在其中创建服务帐号的项目的 ID
    • ROLE:要授予的角色
  3. 生成密钥文件:

    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 资源。

后续步骤