Seastar

Seastar（海星）

介绍

SeaStar 是一个事件驱动的框架，允许您以相对直接的方式（一旦理解）编写非阻塞的异步代码。它基于 futures。

Seastar 构建

有关更多详细信息和可选工作流程，请阅读 HACKING.md。

假设您想使用系统软件包（RPM 或 DEB）作为 Seastar 的依赖项，请首先安装它们：

$ sudo ./install-dependencies.sh

然后配置（在"release"模式下）：

$ ./configure.py --mode=release

然后编译：

$ ninja -C build/release

如果您缺少 Seastar 的依赖项，则可以让配置过程在本地获取依赖项的版本以进行开发。

例如，要在本地获取 fmt，请按以下方式配置 Seastar：

$ ./configure.py --mode=dev --cook fmt

--cook 可以重复多次以选择多个依赖项。

构建模式

configure.p y脚本是 cmake 的包装。 --mode 参数映射到 CMAKE_BUILD_TYPE，并支持以下模式

| CMake mode | Debug info | Optimizations | Sanitizers | Allocator | Checks | Use for |

---------+-------------------+------------+----------------+--------------+-----------+----------+----------------------------------------| debug | Debug | Yes | -O0 | ASAN, UBSAN | System | All | gdb | release | RelWithDebInfo | Yes | -O3 | None | Seastar | Asserts | production | dev | Dev (Custom) | No | -O1 | None | Seastar | Asserts | build and test cycle | sanitize | Sanitize (Custom) | Yes | -Os | ASAN, UBSAN | System | All | second level of tests, track down bugs |

注意，seastar 对分配器和优化比平常更加敏感。有关性能的一个简单经验法则是，release 比 dev 快 2 倍，比 sanitize 快 150 倍，比 debug 快 300 倍。

从其构建目录使用 Seastar（无需安装）

可以使用 CMake 或 pkg-config 从其构建目录直接使用 Seastar。

我们假设 Seastar 存储库位于 $seastar_dir 的目录中。

通过 pkg-config：

$ g++ my_app.cc $(pkg-config --libs --cflags --static $seastar_dir/build/release/seastar.pc) -o my_app

以及使用 Seastar 软件包的 CMake：

my_app 的 CMakeLists.txt：

find_package (Seastar REQUIRED) add_executable (my_app my_app.cc) target_link_libraries (my_app Seastar::seastar)

$ 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 安装到文件系统后使用它。

重要：

首先，配置安装路径：

$ ./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 调用 CMake。）

还有在任何支持 Docker 的主机上进行构建的说明。

DPDK 的使用是 可选的。

Seastar 支持 C++ 17 和 C++ 20。 可以使用 --c++-dialect=gnu++17 配置选项来选择它，或者，如果直接使用 CMake，则可以通过在 Seastar_CXX_DIALECT CMake 变量上进行设置来选择它。

有关更多信息，请参见兼容性声明。

入门

有一个迷你教程，一个更全面的教程。

该文档可从 web 上获得。

资源

在开发邮件列表中提出问题并发布补丁。订阅信息和档案可以在这里找到，或者发送电子邮件到[email protected]。

信息可以在主项目网站上找到。

在项目问题跟踪器上记录错误报告。

本机 TCP/IP 堆栈

Seastar 带有自己的用户空间 TCP/IP 堆栈，以提高性能。

SeaStar的推荐硬件配置

使用Seastar的项目

（The first version translated by vz on 2020.07.04）

Seastar

Introduction

SeaStar is an event-driven framework allowing you to write non-blocking,
asynchronous code in a relatively straightforward manner (once understood).
It is based on futures.

Building Seastar

For more details and alternative work-flows, read HACKING.md.

Assuming that you would like to use system packages (RPMs or DEBs) for Seastar's dependencies, first install them:

$ sudo ./install-dependencies.sh

then configure (in "release" mode):

$ ./configure.py --mode=release

then compile:

$ ninja -C build/release

If you're missing a dependency of Seastar, then it is possible to have the configuration process fetch a version of the dependency locally for development.

For example, to fetch fmt locally, configure Seastar like this:

$ ./configure.py --mode=dev --cook fmt

--cook can be repeated many times for selecting multiple dependencies.

Build modes

The configure.py script is a wrapper around cmake. The --mode argument
maps to CMAKE_BUILD_TYPE, and supports the following modes

  961

Go

gocqlx

General purpose extensions to Go Cassandra driver - gocql

Go

go-set

Type-safe, zero-allocation sets for Go

系统和服务监控系统

Scylla监控栈

用 Grafana 对 Scylla 进行简单监控。「Simple monitoring of Scylla with ...