源码克隆

克隆 Garnet 存储库。 Garnet 源码位于该存储库的主分支上。

bash

git clone git@github.com:microsoft/garnet.git

项目构建

确保已安装 .NET 8，请按照此处. 您可以使用 Linux 或 Windows； Garnet 在这两个平台上的表现同样出色。

转到克隆源码的根目录并使用 dotnet 进行构建，或者打开 Garnet.sln 并使用 Visual Studio 2022 进行构建（我们建议使用预览版以获得最新功能）。通过检查更新来确保 Visual Studio 是最新的。

bash

cd garnet
dotnet restore
dotnet build -c Release

作为健全性检查，您可以运行我们的测试套件。下面显示了在 .NET 8 发布模式下运行测试并将详细输出到控制台的命令（确保位于源码的根目录中）。

bash

dotnet test -c Release -f net8.0 -l "console;verbosity=detailed"

TIP

除非将环境变量设置 RunAzureTests 为 yes a并运行 Azurite，否则将跳过使用 Azure 云存储的测试。

现在，您已准备好部署 Garnet 服务器。这很简单，运行以下命令

bash

cd main/GarnetServer
dotnet run -c Release -f net8.0

TIP

默认情况下，Garnet 侦听 TCP 端口 3278，当您需要从远程计算机访问服务器时，请务必调整防火墙设置。

要查看可配置选项及其默认值，请运行以下命令。您可以配置索引大小、内存大小、页面大小、数据文件路径和检查点路径、要绑定的 IP 地址、要运行的端口号等。

bash

dotnet run -c Release -f net8.0 -- --help

TIP

要运行索引大小为 512MB（而不是默认值）的服务器，请运行以下命令：

bash

dotnet run -c Release -f net8.0 -- -i 512m

Garnet 使用 RESP 协议，因此您可以使用您喜欢的客户端语言的任何 Redis 客户端与 Garnet 服务器进行通信。对于 C# 应用程序，您可以使用 StackExchange.Redis 或我们自己的 C# 客户端（称为 GarnetClient）。

在Windows上，您可以在WSL（Linux）上安装redis-cli，使用具有图形界面的RedisInsight，或安装Memurai（提供了Windows上的Redis）并使用他们的memurai-cli命令行工具。

使用这些任何客户端时，请确保在连接到Garnet服务器时使用正确的端口（例如，3278）。