使用 Tye 辅助开发 k8s 应用竟如此简单（三）
续上篇，这篇我们来进一步探索 Tye 更多的使用方法。本篇我们来了解一下如何在 Tye 中如何对数据库进行链接。
Newbe.Claptrap 是一个用于轻松应对并发问题的分布式开发框架。如果您是首次阅读本系列文章。建议可以先从本文末尾的入门文章开始了解。
中间件链接
绝大多数服务都需要用到外部中间件来支持应用程序的正常运行，通常来说，就包含有数据库、缓存中间件、消息队列和文件系统等等。
因此，在开发过程中需要在应用程序中管理对这些中间件的链接字符串。
Tye 提供了一种方式以便更加容易的管理这些链接字符串。
使用 Tye 启动 mongo
首先，我们使用 Tye 来启动一个 mongo。
手动创建一个 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 中的数据情况：
实际上就是使用 Tye 控制 docker desktop 启动 mongo。因此需要提前在本地安装好 docker desktop，以便启动。
当然，这实际上和使用 docker-compose 没有什么实质性的区别。
创建应用程序连接 mongo
下面，我们创建一个应用，并且将应用与 mongo 进行连接。
创建测试引用，并安装必要的包：
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 :
// 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();
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 中以验证效果。
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 _logger;
private readonly MongoClient _mongoClient;
public WeatherForecastController(ILogger logger,
MongoClient mongoClient)
{
_logger = logger;
_mongoClient = mongoClient;
}
[HttpGet]
public IEnumerable 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(nameof(WeatherForecast));
mongoCollection.InsertMany(result);
return result;
}
}
}
至此，测试引用就创建完毕了。预期的效果是，当接受到请求时，就会想 mongo 中的 WeatherForecast collection 写入一些数据。可以荣国 mongo express UI 进行查看。
修改 tye.yml 以配置链接串
由于前面，我们是手动创建过了 tye.yml。因此，我们现在直接在原来的基础上进行修改，以便加入测试应用。
首先，将之前创建好的 tye.yml 放置到 TyeTest.sln 的根目录。
然后修改为如下形式:
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
对比之前，一共有两处修改：
- 增加了
tyetest服务配置的节点，以便能够启动测试应用 - 在
mongo服务上增加了bindings。这是tye中组织服务之间相互连接的一种方式。其中的connectionString便是其他服务连接mongo所使用的链接串。
修改完毕之后。使用 tye run 启动应用。
打开 swagger 页面，并访问 API，便可以在 mongo express 中查看到数据已经成功完成了写入：
查看效果之后可以使用 Ctrl + C 停止 tye 以移除相关容器。
最后，发到 K8S 里面试一下
这次的样例，并不是直接使用 tye deploy 就可以完成了。
首先，通常来说，中间件在生成环境中不太可能是通过部署在容器中的方式而存在的。即便是使用容器部署，也不会每次 deploy 都希望重新部署。也就是说，通常是直接连接已有的中间件就可以了。
其次，中间件连接字符串通常来说是以 secret 的形式存在在 k8s 中。故而不太可能在 tye 脚本中进行指定。
故而， tye 仅仅会帮助开发者检查需要部署的目标集群中是否已经存在符合要求的 secret 。当且仅当，目标集群中存在符合要求的 secret 才能部署。
以本示例为例，需要在目标集群中存在 binding-production-mongo-secret 对应的 secret 才能都实现使用 tye 进行部署。
具体的名称约定规则，可以参照如下内容：
https://github.com/dotnet/tye/blob/master/docs/reference/deployment.md#validate-secrets
小结
本篇，我们已经顺利完成了使用 Tye 来完成应用与中间件之间的链接配置。
不过还遗留一些问题没有细说：
- 如果一个中间存在多个绑定该如何处理
- https 绑定该如何处理
详细这些内容，请移步官方文档进行查看：
https://github.com/dotnet/tye/blob/master/docs/reference/service_discovery.md
下一篇，我们将进一步在 Tye 中实现对纷繁复杂的日志进行统一管理。
最后但是最重要！
如果读者对该内容感兴趣，欢迎转发、评论、收藏文章以及项目。
最近作者正在构建以 反应式 、 Actor模式 和 事件溯源 为理论基础的一套服务端开发框架。希望为开发者提供能够便于开发出“分布式”、“可水平扩展”、“可测试性高”的应用系统——Newbe.Claptrap
本篇文章是该框架的一篇技术选文，属于技术构成的一部分。
项目文档库：claptrap.newbe.pro
联系方式： QQ 群 610394020
您还可以查阅本系列的其他选文：
理论入门篇
术语介绍篇
- Actor 模式
- 事件溯源（Event Sourcing）
- Claptrap
- Minion
- 事件 （Event）
- 状态 （State）
- 状态快照 （State Snapshot）
- Claptrap 设计图 （Claptrap Design）
- Claptrap 工厂 （Claptrap Factory）
- Claptrap Identity
- Claptrap Box
- Claptrap 生命周期（Claptrap Lifetime Scope）
- 序列化（Serialization）
实现入门篇
- Newbe.Claptrap 框架入门，第一步——创建项目，实现简易购物车
- Newbe.Claptrap 框架入门，第二步——简单业务，清空购物车
- Newbe.Claptrap框架入门，第三步——定义Claptrap，管理商品库存
- Newbe.Claptrap框架入门，第四步——利用Minion，商品下单
样例实践篇
开发工具篇
About The Author
