设置 .NET 开发环境

本教程介绍了如何为 .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 时进行身份验证。详细了解身份验证，包括部署应用后如何处理身份验证。

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

控制台

创建服务帐号：

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

后续步骤