使用 Tye 輔助開發 k8s 應用竟如此簡單（三）

續上篇，這篇我們來進一步探索 Tye 更多的使用方法。本篇我們來了解一下如何在 Tye 中如何對資料庫進行連結。

Newbe.Claptrap 是一個用於輕鬆應對併發問題的分散式開發框架。如果您是首次閱讀本系列文章。建議可以先從本文末尾的入門文章開始瞭解。

中介軟體連結

絕大多數服務都需要用到外部中介軟體來支援應用程式的正常執行，通常來說，就包含有資料庫、快取中介軟體、訊息佇列和檔案系統等等。

因此，在開發過程中需要在應用程式中管理對這些中介軟體的連結字串。

Tye 提供了一種方式以便更加容易的管理這些連結字串。

使用 Tye 啟動 mongo

首先，我們使用 Tye 來啟動一個 mongo。

手動建立一個 tye.yml:

tye.yml

name: mongo-sample
services:
  - name: mongo
    image: mongo
    env:
      - name: ME_CONFIG_MONGODB_ADMINUSERNAME
        value: root
      - name: ME_CONFIG_MONGODB_ADMINPASSWORD
        value: example
  - name: mongo-express
    image: mongo-express
    bindings:
      - port: 8081
        containerPort: 8081
        protocol: http
    env:
      - name: ME_CONFIG_MONGODB_ADMINUSERNAME
        value: root
      - name: ME_CONFIG_MONGODB_ADMINPASSWORD
        value: example

使用 tye run 便可以在本地啟動一個 mongo 並且在 http://localhost:8081 通過 ui 檢視 mongo 中的資料情況：

mongo express

實際上就是使用 Tye 控制 docker desktop 啟動 mongo。因此需要提前在本地安裝好 docker desktop，以便啟動。

當然，這實際上和使用 docker-compose 沒有什麼實質性的區別。

建立應用程式連線 mongo

下面，我們建立一個應用，並且將應用與 mongo 進行連線。

建立測試應用，並安裝必要的包：

create-tye-mongo-test.sh

dotnet new sln -n TyeTest
dotnet new webapi -n TyeTest
dotnet sln ./TyeTest.sln add ./TyeTest/TyeTest.csproj
dotnet add ./TyeTest/TyeTest.csproj package Microsoft.Tye.Extensions.Configuration --version 0.6.0-alpha.21070.5
dotnet add ./TyeTest/TyeTest.csproj package MongoDB.Driver

進入 Startup，向容器中註冊 MongoClient :

Startup.cs

// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new OpenApiInfo {Title = "TyeTest", Version = "v1"}); });
    services.AddScoped(p =>
    {
        var config = p.GetRequiredService<IConfiguration>();
        var connectionString = config.GetConnectionString("mongo");
        Console.WriteLine(connectionString);
        var client = new MongoClient(connectionString);
        return client;
    });
}

值得注意的是，這裡使用了一個擴充套件方法從 IConfiguration 中讀取 mongo 的連線字串：

mongo 實際上就是定義在 tye 中的服務名稱。
GetConnectionString 是來自於 Microsoft.Tye.Extensions.Configuration 的擴充套件方法
MongoClient 應該全域性單例還是 Scope 其實筆者也沒查過資料。實際專案開發者注意按照需求調整。

開啟 WeatherForecastController，讓我們在每次接受請求時，都寫入一些資料到 mongo 中以驗證效果。

WeatherForecastController.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using MongoDB.Driver;

namespace TyeTest.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        private readonly ILogger<WeatherForecastController> _logger;
        private readonly MongoClient _mongoClient;

        public WeatherForecastController(ILogger<WeatherForecastController> logger,
            MongoClient mongoClient)
        {
            _logger = logger;
            _mongoClient = mongoClient;
        }

        [HttpGet]
        public IEnumerable<WeatherForecast> Get()
        {
            var rng = new Random();
            var result = Enumerable.Range(1, 5).Select(index => new WeatherForecast
                {
                    Date = DateTime.Now.AddDays(index),
                    TemperatureC = rng.Next(-20, 55),
                    Summary = Summaries[rng.Next(Summaries.Length)]
                })
                .ToArray();

            var mongoCollection = _mongoClient.GetDatabase(nameof(WeatherForecast))
                .GetCollection<WeatherForecast>(nameof(WeatherForecast));
            mongoCollection.InsertMany(result);
            return result;
        }
    }
}

至此，測試應用就建立完畢了。預期的效果是，當接受到請求時，就會向 mongo 中的 WeatherForecast collection 寫入一些資料。可以通過 mongo express UI 進行檢視。

修改 tye.yml 以配置連結串

由於前面，我們是手動建立過了 tye.yml。因此，我們現在直接在原來的基礎上進行修改，以便加入測試應用。

首先，將之前建立好的 tye.yml 放置到 TyeTest.sln 的根目錄。

然後修改為如下形式:

tye.yml

name: mongo-sample
services:
  - name: mongo
    image: mongo
    env:
      - name: ME_CONFIG_MONGODB_ADMINUSERNAME
        value: root
      - name: ME_CONFIG_MONGODB_ADMINPASSWORD
        value: example
    bindings:
      - containerPort: 27017
        connectionString: 'mongodb://${host}:${port}'
  - name: mongo-express
    image: mongo-express
    bindings:
      - port: 8081
        containerPort: 8081
        protocol: http
    env:
      - name: ME_CONFIG_MONGODB_ADMINUSERNAME
        value: root
      - name: ME_CONFIG_MONGODB_ADMINPASSWORD
        value: example
  - name: tyetest
    project: TyeTest/TyeTest.csproj