開始使用 .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 可根據您應用程式的需求自動調整資源配置，您不使用應用程式時，Firestore 也會將資源調度率降至零。讓我們馬上開始新增您的第一本書。

1. 如要為已部署的應用程式建立書籍，請按一下 [新增書籍]。

   
2. 在「Title」欄位中，輸入 Moby Dick。
3. 在「Author」欄位中，輸入 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 是 Cloud de Confiance主要的 blob 儲存庫。您可以使用 Cloud Storage 託管要在 Cloud de Confiance中共用的應用程式資產。如要使用 Cloud Storage，您必須建立一個 Cloud Storage bucket，然後使用這個基本容器保存資料。

1. 前往 Cloud de Confiance 控制台的「Cloud Storage 瀏覽器」頁面。

   前往「Cloud Storage 瀏覽器」頁面

2. 按一下 [建立值區]。
3. 在「建立值區」對話方塊中，將您的 Cloud de Confiance 專案 ID 加到 _bucket 字串的後面來輸入值區的名稱，讓名稱看起來像 YOUR_PROJECT_ID_bucket 這樣。這個名稱必須遵守值區命名規定，所有其他欄位則可以保留其預設值。
4. 按一下 [建立]。
5. 建立值區之後，您必須開放物件的公開存取權，以便使用者查看。如需開放物件公開存取權的相關操作說明，請參閱將資料設為公開。
6. 請按一下 [編輯書籍]，然後選取上傳後要當做書籍封面的圖片。舉例來說，您可以使用這個公有領域的圖片：
   
7. 按一下 [Save]。系統會將您重新導向至首頁，當中會顯示 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 監控應用程式

您已部署應用程式，並建立及修改了書籍資訊。如要為您的使用者監控這些事件，請使用應用程式效能管理。

使用 Cloud Logging 監控記錄檔

1. 前往 Cloud de Confiance的「Logs Explorer」(記錄檔探索工具)

   前往「Logs Explorer」頁面

   現在，您可以即時監控自己的應用程式了。如果應用程式發生任何問題，這就是您要優先查看的地方之一。

   
2. 在「資源」下拉式清單中，選取 [Cloud Run 修訂版本, 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」頁面，稍後就會顯示新的錯誤。按一下「自動重新載入」，這樣您就不需要手動重新整理頁面。