Newbe.Claptrap 框架入门，第一步 —— 开发环境准备
- 2021 年 2 月 27 日
- 筆記
Newbe.Claptrap 框架依托于一些关键性的基础组件和一些可选的辅助组件。本篇我们来介绍一下如何准备一个开发环境。
Newbe.Claptrap 是一个用于轻松应对并发问题的分布式开发框架。如果您是首次阅读本系列文章。建议可以先从本文末尾的入门文章开始了解。
必要组件
这些组件是使用本框架进行开发是必须要安装的组件。
Docker Desktop
Docker Desktop 是以下所有组件运行的基础。开发可以通过以下链接下载对应操作系统的版本并进行安装：
//www.docker.com/products/docker-desktop
安装完毕后，可以在控制台中使用以下命令验证安装效果：
PS C:\Repos\newbe\Newbe.Claptrap.Docs\src> docker --version
Docker version 20.10.2, build 2291f61
|
中国大陆用户，需要为 Docker Desktop 配置好加速镜像。这将有助于后续环境的安装。
dotnet SDK
本框架依赖于 net 5 SDK 和 runtime。开发者可以通过以下链接下载最新的 SDK 并按照提示进行安装：
//dotnet.microsoft.com/download/dotnet/5.0
安装完毕后，可以在控制台中使用以下命令验证安装效果：
PS C:\Repos\newbe\Newbe.Claptrap.Docs\src> dotnet --version
5.0.103
|
Tye
Tye 是有微软开发提供的一款简化分布式应用开发的辅助命令行工具。
开发者可以在以下链接中找到最新的安装命令行脚本：
//www.nuget.org/packages/Microsoft.Tye
安装完毕后，可以在控制台中使用以下命令验证安装效果：
PS C:\Repos\newbe\Newbe.Claptrap.Docs\src> tye --version
0.6.0-alpha.21070.5+a42e4463943e3136dbd1de38474d8d62b802797c
|
Dapr
Dapr 是 Newbe.Claptrap 运行的基石。可以通过以下官方文档了解开发环境的安装方式：
//docs.dapr.io/getting-started/
中文用户也可以通过以下链接查看中文介绍：
//dapr-cn.gitee.io/getting-started/
安装完毕后，可以在控制台中使用以下命令验证安装效果：
PS C:\Repos\newbe\Newbe.Claptrap.Docs\src> dapr --version
CLI version: 1.0.0
Runtime version: 1.0.0
|
数据库
Newbe.Claptrap 目前支持 SQLite/Mysql/PostgreSQL/Mongodb 多种数据库。
开发者可以选择已经部署好的应用实例，也可以通过以下链接获取本项目开发时使用的 docker-compose.yml 文件以部署数据库：
//github.com/newbe36524/Newbe.Claptrap/tree/master/src/Docker/Database
可选组件
这些组件是使用本框架进行开发时可选的组件。只有当需要使用到特定特性时才需要使用到。不过，我们仍然建议开发者安装这些组件。这样有助于开发者更有效的了解系统的运行情况。
Grafana
Grafana 可以将系统的监控数据以图表的形式展示出来，是一个非常优秀的开源方案。
开发者可以使用以下链接中提供的 docker-compose.yml 来创建一个用于本项目的 Grafana 实例:
//github.com/newbe36524/Newbe.Claptrap/tree/master/src/Docker/Monitor
Jaeger
Jaeger 是一款分布式链路监控工具，可以帮助开发者进一步了解服务间的关系和性能细节。
开发者可以通过以下链接提供的 docker-compose.yml 来构建一个用于本项目的 Jaeger 实例：
//github.com/newbe36524/Newbe.Claptrap/tree/master/src/Newbe.Claptrap.Template/HelloClaptrap
也可以从本项目的项目模板中找到这个 docker-compose.yml 文件。关于项目模板的详细介绍，将在下节进行说明。
Seq
Seq 是一款高效的分布式日志管理工具，可以帮助开发者对多个应用程序的日志进行收集和可视化。
开发者可以通过以下链接提供的 docker-compose.yml 来构建一个用于本项目的 Seq 实例：
//github.com/newbe36524/Newbe.Claptrap/tree/master/src/Newbe.Claptrap.Template/HelloClaptrap
也可以从本项目的项目模板中找到这个 docker-compose.yml 文件。关于项目模板的详细介绍，将在下节进行说明。
小结
本篇，我们初步了解了如何为 Newbe.Claptrap 项目初始化一个基础可用的开发环境。
下一篇，我们将使用该环境以及项目模板，创建第一个 Newbe.Claptrap 项目。
最后但是最重要！
如果读者对该内容感兴趣，欢迎转发、评论、收藏文章以及项目。
最近作者正在构建以 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）
- 最小竞争资源 (Minimal Competing Resources)
样例实践篇
开发入门篇
开发工具篇
- 使用 Tye 辅助开发 k8s 应用竟如此简单（一）
- 使用 Tye 辅助开发 k8s 应用竟如此简单（二）
- 使用 Tye 辅助开发 k8s 应用竟如此简单（三）
- 使用 Tye 辅助开发 k8s 应用竟如此简单（四）
- 使用 Tye 辅助开发 k8s 应用竟如此简单（五）
- 使用 Tye 辅助开发 k8s 应用竟如此简单（六）
其他番外篇
- 谈反应式编程在服务端中的应用，数据库操作优化，从 20 秒到 0.5 秒
- 谈反应式编程在服务端中的应用，数据库操作优化，提速 Upsert
- 十万同时在线用户，需要多少内存？——Newbe.Claptrap 框架水平扩展实验
- docker-mcr 助您全速下载 dotnet 镜像
- 十多位全球技术专家，为你献上近十个小时的.Net 微服务介绍
- 年轻的樵夫哟，你掉的是这个免费 8 核 4G 公网服务器，还是这个随时可用的 Docker 实验平台？
- 如何使用 dotTrace 来诊断 netcore 应用的性能问题
- 只要十步，你就可以应用表达式树来优化动态调用
GitHub 项目地址：//github.com/newbe36524/Newbe.Claptrap
Gitee 项目地址：//gitee.com/yks/Newbe.Claptrap
您当前查看的是先行发布于 www.newbe.pro 上的博客文章，实际开发文档随版本而迭代。若要查看最新的开发文档，需要移步 claptrap.newbe.pro。
- 本文作者： newbe36524
- 本文链接： //www.newbe.pro/Newbe.Claptrap/Get-Started-1/
- 版权声明： 本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！
