.NET 使用入门

将应用部署到 Cloud Run

Cloud de Confiance 提供了 多种运行代码的方案。在此 示例中，您要使用 Cloud Run 将可伸缩 应用部署到 Cloud de Confiance。通过零服务器管理，Cloud Run 让您专注于编写代码。此外，Cloud Run 会自动扩缩以应对突发的流量高峰。

FROM mcr.microsoft.com/dotnet/core/aspnet:2.1
COPY . /app
WORKDIR /app
ENTRYPOINT ["dotnet", "Bookshelf.dll"]

Dockerfiles 可以 更丰富，但是此配置适用于许多应用。

Cloud Run 通过设置 PORT 环境变量来告诉您的应用要监听哪个端口。Bookshelf 的 Program.cs 包含用于 观察 PORT 变量并在该端口上监听的代码：

using Google.Cloud.Diagnostics.AspNetCore;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using System;

namespace Bookshelf
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseGoogleDiagnostics(Startup.GetProjectId(), "Bookshelf", "0.01")
                .UseStartup<Startup>().UsePortEnvironmentVariable();
    }

    static class ProgramExtensions
    {
        // Google Cloud Run sets the PORT environment variable to tell this
        // process which port to listen to.
        public static IWebHostBuilder UsePortEnvironmentVariable(
            this IWebHostBuilder builder)
        {
            string port = Environment.GetEnvironmentVariable("PORT");
            if (!string.IsNullOrEmpty(port))
            {
                builder.UseUrls($"http://0.0.0.0:{port}");
            }
            return builder;
        }
    }
}

在终端窗口中，使用 gcloud CLI 将应用部署到 Cloud Run：

1. 在本地构建应用。

   dotnet publish -c Release

2. 使用 Cloud Build 来构建 Docker 容器并发布到 Container Registry。

   gcloud builds submit --tag gcr.io/PROJECT_ID/bookshelf \
       bin/Release/netcoreapp2.1/publish

3. 使用 Cloud Run 运行容器。

   gcloud run deploy bookshelf --region us-central1 --platform managed \
       --image gcr.io/PROJECT_ID/bookshelf --allow-unauthenticated

   现在可以在 gcloud run 输出中显示的网址上查看您的应用：

   Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving traffic at
   https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app

4. 将网址复制到您的网络浏览器以查看该应用。

如需详细了解如何部署到 Cloud Run，请参阅 Cloud Run 文档。

使用 Firestore 保留数据

您不能在 Cloud Run 实例中存储信息，因为实例重启时信息会丢失，当新实例创建时该信息已不再存在。所以，您需要一个所有实例都能在其中读写的数据库。

Cloud de Confiance 提供了 多种存储数据的方案。在此示例中，您将使用 Firestore 存储每本图书的数据。 Firestore 是一种全代管式无服务器 NoSQL 文档数据库，可用于存储和查询数据。Firestore 能够根据您的应用需求自动扩缩，并在不使用时缩减到零个实例。现在添加第一本图书。

1. 如需为部署的应用创建图书，请点击添加图书。

   
2. 在书名字段中，输入 Moby Dick。
3. 在作者字段中，输入 Herman Melville。

4. 点击保存。现在您的 Bookshelf 应用有了一个条目。

   

5. 在 Cloud de Confiance 控制台中，前往 Cloud Firestore。 前往 Cloud Firestore

   现在数据出现在 Firestore 中。Bookshelf 应用将每本图书存储为具有唯一 ID 的 Firestore 文档，这些文档都存储在一个 Firestore 集合中。在本教程中，该集合称为 books。

   

Firestore 使用 Firestore 客户端库存储图书。 下面是一个提取 Firestore 文档的示例：

using Google.Cloud.Firestore;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Bookshelf.Models
{
    class FirestoreBookStore : IBookStore
    {
        private FirestoreDb _firestore;
        private CollectionReference _books;

        public FirestoreBookStore(string projectId)
        {
            _firestore = FirestoreDb.Create(projectId);
            _books = _firestore.Collection("Books");
        }

如需详细了解如何使用 Firestore，请参阅 向 Firestore 添加数据。

在 Cloud Storage 中存储上传的文件

现在您已经添加了一本图书，接下来该添加图书封面图片。您不能在实例中存储文件，数据库也不适合图片文件。这时，您就得用上 Cloud Storage 了。

Cloud Storage 是主要的 Blob 存储库 Cloud de Confiance。您可以使用 Cloud Storage 来 托管要在中共享的应用资源 Cloud de Confiance。如需使用 Cloud Storage，您需要创建一个 Cloud Storage 存储桶， 这是一个保存数据的基本容器。

1. 在 Cloud de Confiance 控制台中，前往 Cloud Storage 浏览器 页面。

   前往 Cloud Storage 浏览器页面

2. 点击创建存储桶 。
3. 在创建存储桶对话框中输入存储桶的名称：将 Cloud de Confiance 项目 ID 附加到字符串_bucket前面，这样名称就显示为 YOUR_PROJECT_ID_bucket。此名称须遵守 存储桶名称要求。其他所有字段可以保留默认值。
4. 点击创建。
5. 创建存储分区后，必须将对象设为可公开访问，以供用户查看。如需将对象设为可公开访问，请参阅公开数据。
6. 点击修改图书，然后选择一张图片上传为图书的封面。例如，可以使用图中所示的这张属于公共领域的图片：
   
7. 点击保存。您将被重定向至 首页，其中有您的 Bookshelf 应用的条目。
   

Bookshelf 应用会使用 Cloud Storage 客户端库将上传的文件发送到 Cloud Storage。

using Google.Cloud.Storage.V1;
using Microsoft.AspNetCore.Http;
using System;
using System.Threading.Tasks;
using System.Web;

namespace Bookshelf.Services
{
    public class ImageUploader
    {
        private readonly string _bucketName;
        private readonly StorageClient _storageClient;

        public ImageUploader(string bucketName)
        {
            _bucketName = bucketName;
            _storageClient = StorageClient.Create();
        }

如需详细了解如何使用 Cloud Storage，请参阅 Cloud Storage 简介。

使用 Google Cloud Observability 监控应用

您已经部署了应用，创建并修改了 books 集合。如需为用户监控这些事件，可以使用应用性能管理。

使用 Cloud Logging 监控日志

1. 在 Cloud de Confiance中，前往 Logs Explorer

   转到 Logs Explorer

   您可以在其中实时监控应用。如果您的应用出现问题，应该首先查看这里。

   
2. 在资源下拉列表中，选择 Cloud Run Revision, bookshelf。

使用 Error Reporting 监控错误

1. 在 Cloud de Confiance 控制台中，前往 Error Reporting 页面。
   前往 Error Reporting 页面
   Error Reporting 可突出显示应用中的错误和异常， 您还可以设置相关的提醒。
2. 在浏览器中，转到应用中的 /Home/Throw 网址。
   例如，如果您的应用托管在 https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app 中， 则转到 https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app/Home/Throw。

   此操作会生成一个新的测试异常并将其发送至 Google Cloud Observability。

3. 在 Cloud de Confiance 控制台中，返回到 Error Reporting 页面，很快就可以看到这个 新错误。点击自动重新加载 ，这样就无需手动刷新页面。