Garnet技术实战测试开发：像使用Redis一样使用Garnet

最新推荐文章于 2024-05-04 22:48:40 发布

小乖兽技术

最新推荐文章于 2024-05-04 22:48:40 发布

阅读量2.8k

点赞数 34

分类专栏： C#开发基础文章标签： redis 缓存 Garnet

本文链接：https://blog.csdn.net/houbincarson/article/details/136954596

版权

C#开发基础专栏收录该内容

2 篇文章 0 订阅

订阅专栏

一、Garnet简介

最近一段时间，看到非常多的文章描述和转发Garnet项目，比如说：

关于Garnet详细介绍,我这里就不在赘述了。
在这里插入图片描述
根据其官网的信息，我们来进行实战测试。
开源仓库地址：https://github.com/microsoft/garnet
文档地址：https://microsoft.github.io/garnet/

二、部署Garnet Server

1、从GitHub仓库中Clone仓库到本地，然后编译构建项目。
在这里插入图片描述
本地编译无任何异常后，启用docker安装
2、查看docker-compose.yml和dockerfile文件内容

version: '3.4'

services:
  garnet:
    restart: always
    image: garnet
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3278:3278"

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /source

# Copy files
COPY . .
RUN dotnet restore
RUN dotnet build -c Release

# Copy and publish app and libraries
WORKDIR /source/main/GarnetServer
RUN dotnet publish -c Release -o /app --self-contained false -f net8.0

# Final stage/image
FROM mcr.microsoft.com/dotnet/runtime:8.0
WORKDIR /app
COPY --from=build /app .

# Run GarnetServer with an index size of 128MB
ENTRYPOINT ["/app/GarnetServer", "-i", "128m"]

3、通过docker指令安装&成功启动

docker-compose up

在这里插入图片描述
4、Image安装成功
查看Images

查看Containers

三、测试连接到Garnet

Garnet默认端口为3278。因为Garnet使用Redis的RESP协议作为其主要通信协议，因此可以使用大多数编程语言中现成的Redis客户端。这里我就使用常规的工具。
1、测试连接
在这里插入图片描述
2、测试写入键值对

四、C#开发连接Garnet

1、新建GarnetApp项目

dotnet new console -n "GarnetApp"

2、引入StackExchange.Redis库
在这里插入图片描述 3、编写测试代码

using StackExchange.Redis;

namespace GarnetApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            string garnetConnectionString = "localhost:3278"; // garnet 服务器地址

            // 建立连接
            ConnectionMultiplexer connection = ConnectionMultiplexer.Connect(garnetConnectionString);
            IDatabase garnet = connection.GetDatabase();

            // 写入数据
            garnet.StringSet("myKey", "Hello, Grant!");

            // 读取数据myKey
            string value = garnet.StringGet("myKey");
            Console.WriteLine(value);

            // 读取数据key01
            string value01 = garnet.StringGet("key01");
            Console.WriteLine(value01);

            connection.Close();

            Console.ReadKey();
        }
    }
}

4、运行查看测试结果
在这里插入图片描述

五、编写其他测试代码

1、将 C# 对象序列化为 JSON 或其他格式，并存储到 Garnet中，以及从 Garnet 中取出并反序列化对象。

private static void TestObject(IDatabase garnet)
{
    // 定义一个示例对象
    var person = new { Name = "Alice", Age = 30 };

    // 将对象序列化为 JSON
    string json = JsonConvert.SerializeObject(person);

    // 存储 JSON 数据到 garnet
    garnet.StringSet("person:1", json);

    // 从 garnet 中获取 JSON 数据
    string jsonFromgarnet = garnet.StringGet("person:1");

    // 将 JSON 数据反序列化为对象
    var personFromgarnet = JsonConvert.DeserializeObject<Person>(jsonFromgarnet);

    // 输出反序列化后的对象属性
    Console.WriteLine($"Name: {personFromgarnet.Name}, Age: {personFromgarnet.Age}");
}

在这里插入图片描述
2、常用的数据结构
列表（List）：使用 Garnet 的列表数据结构实现消息队列或者简单的日志记录功能。

string garnetConnectionString = "localhost:3278"; // garnet 服务器地址
// 建立连接
ConnectionMultiplexer connection = ConnectionMultiplexer.Connect(garnetConnectionString);
IDatabase garnet = connection.GetDatabase();
// 向列表中推入消息
for (int i = 1; i <= 5; i++)
{
    garnet.ListLeftPush("message_queue", $"Message {i}");
}
// 从列表中弹出消息
string message = garnet.ListRightPop("message_queue");
Console.WriteLine("Popped message: " + message);
connection.Close();

在这里插入图片描述

六、关于Garnet Server的配置项

默认配置下内容如下：
在这里插入图片描述
官网解释基本用法：
Garnet 服务器（GarnetServer.exe）可以使用配置文件进行配置（例如，garnet.conf、redis.conf、defaults.conf），同时命令行参数可用于覆盖文件中指定的任何设置。未在配置文件或命令行参数中指定的任何设置将被设置为文件中指定的默认值（可以通过命令行参数覆盖此文件的路径）。

Garnet 目前支持两种配置文件格式：

garnet.conf 文件格式（默认）- 一组以 JSON 格式排列的设置
redis.conf 文件格式 - 以 Redis 配置文件格式排列的设置：
keyword argument1 argument2 argument3 … argumentN

请参阅 Redis 文档以获取参考信息。重要提示：并非所有 redis.conf 关键字都受到 Garnet 的支持。为了实现完整的配置设置覆盖，请使用 garnet.conf 格式。

通过命令行参数可以指定配置文件路径（和默认文件路径）。

对于 garnet.conf：

GarnetServer.exe --config-import-path <file-path>

对于 redis.conf：

GarnetServer.exe --config-import-path <file-path> --config-import-format RedisConf

注意：要更改默认配置文件的路径（和/或格式），分别使用 config-default-import-path 和 config-default-import-format 关键字。

七、总结

本文关于如何使用Garnet 作为Server,以及使用大多数编程语言中现成的Redis客户端连接和使用StackExchange.Redis库连接，进行简单的测试和使用。如果本文对你有任何帮助，我将非常荣幸。

如果你喜欢我的文章，谢谢三连：关注、点赞、分享吧！！！

小乖兽技术

关注

34
点赞
踩
54

收藏

觉得还不错? 一键收藏
打赏
0
评论
Garnet技术实战测试开发：像使用Redis一样使用Garnet

Garnet是微软研究院基于C# .NET8.0开发的一种新型远程缓存存储系统，它设计目的是实现极速、可扩展和低延迟。Garnet能够在单节点内进行线程扩展，并支持分片集群执行，具备复制、检查点、故障转移和事务处理功能。它可以在主内存以及分层存储（如SSD和Azure存储）上运行。Garnet提供丰富的API接口和强大的可扩展性模型。
复制链接

扫一扫