seastar
介绍
seastar是一个事件驱动的框架，使您可以以相对简单的方式编写非阻滞，异步代码（曾经理解）。它基于未来。
建筑seastar
有关更多详细信息和替代工作流程，请阅读hacking.md。
假设您想将seastar的依赖项使用系统软件包（RPMS或DEB），请首先安装它们：
$ sudo ./install-dependencies.sh
然后配置（以“发布”模式）：
$ ./configure.py --mode=release
然后编译：
$ ninja -C build/release
如果存在编译问题，尤其是像G ++：内部编译器错误：杀死（程序CC1PLUS）尝试通过限制线程（-J1）和/或允许至少4G RAM到机器的螺纹量（-J1）来给GCC提供更多内存。
如果您缺少seastar的依赖性，则可以使配置过程在本地获取依赖项的版本以进行开发。
例如，要在本地获取fetch fmt，请像这样配置seastar ：
$ ./configure.py --mode=dev --cook fmt
– 可以重复多次选择多次，以选择多个依赖性。
建立模式
configure.py脚本是围绕cmake的包装器。 – 模式参数映射到cmake_build_type，并支持以下模式
| CMAKE模式 | 调试信息 | 优化 | 消毒剂 | 分配器 | 检查 | 用于 | |
|---|---|---|---|---|---|---|---|
| 调试 | 调试 | 是的 | -O0 | 阿桑，乌班 | 系统 | 全部 | GDB |
| 发布 | Relwithdebinfo | 是的 | -O3 | 没有任何 | seastar | 断言 | 生产 |
| 开发 | 开发（自定义） | 不 | -O1 | 没有任何 | seastar | 断言 | 建立和测试周期 |
| 消毒 | 消毒（自定义） | 是的 | -os | 阿桑，乌班 | 系统 | 全部 | 测试的第二级，跟踪错误 |
请注意， seastar对分配者和优化更为敏感。相对性能的快速规则是，该版本比开发人员快2倍，比消毒快150倍，比调试快300倍。
使用其构建目录中的seastar （无安装）
可以用CMAKE或PKG-CONFIG直接从其构建目录中消耗seastar 。
我们假设seastar存储库位于$ seastar _dir的目录中。
通过pkg-config：
seastar .pc) -o my_app\”>
$ g++ my_app.cc $(pkg-config --libs --cflags --static $ seastar _dir/build/release/ seastar .pc) -o my_app
并使用cmake使用seastar软件包：
cmakelists.txt for my_app：
seastar REQUIRED)
add_executable (my_app
my_app.cc)
target_link_libraries (my_app
seastar :: seastar )\”>
set (CMAKE_CXX_STANDARD 23) find_package ( seastar REQUIRED) add_executable (my_app my_app.cc) target_link_libraries (my_app seastar :: seastar )
seastar _dir/build/release/_cooking/installed\” -DCMAKE_MODULE_PATH=$ seastar _dir/cmake $my_app_dir\”>
$ mkdir $my_app_dir/build $ cd $my_app_dir/build $ cmake -DCMAKE_PREFIX_PATH=\"$ seastar _dir/build/release;$ seastar _dir/build/release/_cooking/installed\" -DCMAKE_MODULE_PATH=$ seastar _dir/cmake $my_app_dir
cmake_prefix_path值确保CMAKE可以找到seastar及其编译的子模型。 cmake_module_path值可确保CMake可以使用seastar的Cmake脚本来定位其依赖关系。
使用安装的seastar
将其安装到文件系统后，您也可以消耗seastar 。
重要的：
- seastar使用DPDK的自定义版本，因此默认情况下构建并将DPDK子模型安装到$ build_dir/_cooking/已安装
首先，配置安装路径：
$ ./configure.py --mode=release --prefix=/usr/local
然后运行安装目标：
$ ninja -C build/release install
然后从pkg-config消费：
$ g++ my_app.cc $(pkg-config --libs --cflags --static seastar ) -o my_app
或与以前相同的cmakelists.txt消耗它，但使用更简单的cmake调用：
$ cmake ..
（如果尚未将seastar安装到 /usr或 /usr /local之类的“标准”位置，则可以使用-dcmake_prefix_path = $ my_install_root。
还有指示在任何支持Docker的主机上构建的说明。
DPDK的使用是可选的。
seastar的C ++标准：C ++ 20或C ++ 23
seastar支持C ++ 20和C ++ 23。构建默认值为编译器支持的最新标准，但可以使用-C ++ – 标准配置选项明确选择，例如，-C ++ – 标准= 20，或者如果直接使用CMAKE，通过在CMAKE_CXX_CAX_STANDARD CMAKE CMAKE CMAKE变量上进行设置。
有关更多信息，请参见兼容性语句。
入门
有一个迷你教程和一个更全面的教程。
该文档可在网络上可用。
资源
- Seasatar开发邮件列表：讨论挑战，通过发送代码贡献（补丁）提出改进，并从经验丰富的开发人员那里获得帮助。订阅或浏览档案：此处（或发送电子邮件至seastar -dev@googlegroups.com）。
- GitHub讨论：有关更多随意的对话和快速问题，请考虑使用seastar项目在GitHub上的讨论。
- 问题跟踪器：有关项目问题跟踪器的文件错误报告。
在主要项目网站上了解有关seastar更多信息。
本机TCP/IP堆栈
seastar配备了自己的用户空间TCP/IP堆栈，以提高性能。
推荐的seastar的硬件配置
- CPU-尽可能多。 seastar对多核和NUMA非常友好
- NICS-尽可能快地建议使用10G或40G卡。也可以使用1G，但您可能会受到其能力的限制。此外，每CPU的硬件队列越多， seastar越好。否则，我们必须在软件中模仿它。
- 磁盘 – IOPS数量大的快速SSD。
- 客户端机器 – 通常单台客户端计算机无法加载我们的服务器。 MEMASLAP（MEMCACHED）和WRK（HTTPD）都无法过多加载其匹配的服务器计数器零件。我们建议在与服务器不同的机器上运行客户端，并使用其中几个。
使用seastar的项目
- CPV-CQL-驱动器：基于seastar框架的Cassandra/Scylla的C ++驱动程序
- CPV-FRAMEWORK：基于seastar框架的C ++编写的Web框架
- REDPANDA：任务关键系统的Kafka替代品
- Scylla：一种与Cassandra和DynamoDB兼容的快速可靠的NOSQL数据存储
- SMF：西方最快的RPC
- CEPH-绯红色：基于seastar框架的下一代OSD（对象存储守护程序）实现
