# chassis <ˈʃæsi>

chassis <ˈʃæsi>  n. 底盘，底架

仓库名寓意服务的底盘，基础库。搭建微服务底盘是为了简化服务的创建过程，同时确保开发者遵循这套开发标准。

## 包含的特性

### 已包含

- 模板代码
   - nameko 微服务
   - apiflask Web 服务
   - rocketry 定时任务服务 
- 服务注册和发现 (RabbitMQ)
- 可观测 Observability
   - Metrics 
     - Statsd + Prometheus + Grafana
   - Logging 
     - fluentd + ELK
   - Error Reporting
     - Sentry
- 数据存储相关 utils
  - Sqlalchemy
    - 连接池 
    - 读写分离
    - 数据库迁移
      - Alembic 

### TODO 

- environs 替代 python-dotenv
- 可观测 Observability
  - Tracing 
    - OpenTelemetry
    - Skywalking
- 事务
  - 基于开源库 DTM 实现 Saga 模式 
- 高可用
  - 重试
  - 断路器
  - 限流
  - 缓存
  - 健康检查
- 数据存储相关 utils
  - Redis 连接池
  - ElasticSearch
  - mongodb 相关库
- 全局配置服务
  - 配置工具
- 代码生成工具
- 容器打包工具

## 实现的功能

- 服务注册和发现(RabbitMQ)
- 同步/异步传输(RabbitMQ)
- 负载均衡（RabbitMQ）
- 限流降级（消息确认+断路器）
- 健康检查 
  - 通过可观测实现（Metrics + Logging + Tracing + Error Reporting)

## 部署

目前使用 docker compose 编排管理容器

后续期望迁移到 k8s or k3s 编排管理容器
   
## 安装方法

基础代码库：
`python3 -m pip install --trusted-host=gitea.bearcatlog.com git+https://gitea.bearcatlog.com/BryantStudio/chassis.git@main`

基础代码库依赖的服务：
`python3 -m pip install --trusted-host=gitea.bearcatlog.com git+https://gitea.bearcatlog.com/BryantStudio/chassis-agent.git@main`


## 备忘

metrics 方面
- 关注 nameko-prometheus 的进展
  - https://github.com/Emplocity/nameko-prometheus

tracing 方面
- 尝试研究给 nameko 适配 skywalking agent