Newbe.Claptrap 框架入门，第一步 —— 开发环境准备

Newbe.Claptrap 框架依托于一些关键性的基础组件和一些可选的辅助组件。本篇咱们来介绍一下如何准备一个开发环境。

Newbe.Claptrap 是一个用于轻松应对并发问题的分布式开发框架。若是您是首次阅读本系列文章。建议能够先从本文末尾的入门文章开始了解。

必要组件

这些组件是使用本框架进行开发是必需要安装的组件。

Docker Desktop

Docker Desktop 是如下全部组件运行的基础。开发能够经过如下连接下载对应操做系统的版本并进行安装：

https://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 并按照提示进行安装：

https://dotnet.microsoft.com/download/dotnet/5.0

安装完毕后，能够在控制台中使用如下命令验证安装效果：

PS C:\Repos\newbe\Newbe.Claptrap.Docs\src> dotnet --version 5.0.103

Tye

Tye 是有微软开发提供的一款简化分布式应用开发的辅助命令行工具。

开发者能够在如下连接中找到最新的安装命令行脚本：

https://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 运行的基石。能够经过如下官方文档了解开发环境的安装方式：

https://docs.dapr.io/getting-started/

中文用户也能够经过如下连接查看中文介绍：

https://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 文件以部署数据库：

https://github.com/newbe36524/Newbe.Claptrap/tree/master/src/Docker/Database

可选组件

这些组件是使用本框架进行开发时可选的组件。只有当须要使用到特定特性时才须要使用到。不过，咱们仍然建议开发者安装这些组件。这样有助于开发者更有效的了解系统的运行状况。

Grafana

Grafana 能够将系统的监控数据以图表的形式展现出来，是一个很是优秀的开源方案。

开发者可使用如下连接中提供的 docker-compose.yml 来建立一个用于本项目的 Grafana 实例:

https://github.com/newbe36524/Newbe.Claptrap/tree/master/src/Docker/Monitor

Jaeger

Jaeger 是一款分布式链路监控工具，能够帮助开发者进一步了解服务间的关系和性能细节。

开发者能够经过如下连接提供的 docker-compose.yml 来构建一个用于本项目的 Jaeger 实例：

https://github.com/newbe36524/Newbe.Claptrap/tree/master/src/Newbe.Claptrap.Template/HelloClaptrap

也能够从本项目的项目模板中找到这个 docker-compose.yml 文件。关于项目模板的详细介绍，将在下节进行说明。

Seq

Seq 是一款高效的分布式日志管理工具，能够帮助开发者对多个应用程序的日志进行收集和可视化。

开发者能够经过如下连接提供的 docker-compose.yml 来构建一个用于本项目的 Seq 实例：

https://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

您还能够查阅本系列的其余选文：

理论入门篇

1. Newbe.Claptrap - 一套以 “事件溯源” 和 “Actor 模式” 做为基本理论的服务端开发框架

术语介绍篇

1. Actor 模式
2. 事件溯源（Event Sourcing）
3. Claptrap
4. Minion
5. 事件 （Event）
6. 状态 （State）
7. 状态快照 （State Snapshot）
8. Claptrap 设计图 （Claptrap Design）
9. Claptrap 工厂 （Claptrap Factory）
10. Claptrap Identity
11. Claptrap Box
12. Claptrap 生命周期（Claptrap Lifetime Scope）
13. 序列化（Serialization）
14. 最小竞争资源 (Minimal Competing Resources)

样例实践篇

1. 设计一个火车票销售系统

开发入门篇

1. Newbe.Claptrap 框架入门，第一步 —— 开发环境准备
2. Newbe.Claptrap 框架入门，第二步 —— 建立项目

开发工具篇

1. 使用 Tye 辅助开发 k8s 应用竟如此简单（一）
2. 使用 Tye 辅助开发 k8s 应用竟如此简单（二）
3. 使用 Tye 辅助开发 k8s 应用竟如此简单（三）
4. 使用 Tye 辅助开发 k8s 应用竟如此简单（四）
5. 使用 Tye 辅助开发 k8s 应用竟如此简单（五）
6. 使用 Tye 辅助开发 k8s 应用竟如此简单（六）

其余番外篇

1. 谈反应式编程在服务端中的应用，数据库操做优化，从 20 秒到 0.5 秒
2. 谈反应式编程在服务端中的应用，数据库操做优化，提速 Upsert
3. 十万同时在线用户，须要多少内存？——Newbe.Claptrap 框架水平扩展实验
4. docker-mcr 助您全速下载 dotnet 镜像
5. 十多位全球技术专家，为你献上近十个小时的.Net 微服务介绍
6. 年轻的樵夫哟，你掉的是这个免费 8 核 4G 公网服务器，仍是这个随时可用的 Docker 实验平台？
7. 如何使用 dotTrace 来诊断 netcore 应用的性能问题
8. 只要十步，你就能够应用表达式树来优化动态调用

GitHub 项目地址：https://github.com/newbe36524/Newbe.Claptrap

Gitee 项目地址：https://gitee.com/yks/Newbe.Claptrap

您当前查看的是先行发布于 www.newbe.pro 上的博客文章，实际开发文档随版本而迭代。若要查看最新的开发文档，须要移步 claptrap.newbe.pro。

------ 本文结束 ------

• 本文做者： newbe36524
• 本文连接： https://www.newbe.pro/Newbe.Claptrap/Get-Started-1/
• 版权声明： 本博客全部文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！