记一次 Garnet 的安装部署问题排查

本文主要以安装部署替代 Redis 的 Garnet 为例，介绍如何排查 Linux 系统中部署 .NET 独立应用程序时遇到的问题。通过检查文件权限、依赖库、SELinux 配置等方面，解决了应用程序无法正常运行的问题。

1. 背景

Garnet 是微软研究院的新开源项目，它是一个远程缓存存储，提供了一系列独特的优势。Garnet 采用了 Redis 的 RESP 协议作为起点，这使得开发者可以使用大多数编程语言中现成的Redis客户端，例如 .NET 中的 StackExchange.Redis，来使用 Garnet。相比于其他开源缓存存储，Garnet 在性能、延迟、可扩展性和持久性方面有显著的提升。

最近在将其作为 .NET 独立应用程序部署到 Linux 系统时，遇到了一些问题。在此记录整个排查过程，希望能为其他遇到类似问题的人提供一些帮助。

2. 环境描述

•操作系统：Anolis OS 8•应用程序：Garnet（.NET 独立应用程序）•部署方式：systemd 服务

这边 Garnet 直接通过源码生成的二进制文件进行部署，生成非框架依赖的独立应用程序，没有进行裁剪。

生成发布

3. 问题描述

这里添加了执行权限，并开放了相关端口。

权限

端口

在控制台手动启动 Garnet 应用程序时，一切正常：

./GarnetServer

但是，通过 systemd 服务启动时，应用程序却无法正常运行，报错如下：

● garnet.service - Garnet Server
   Loaded: loaded (/etc/systemd/system/garnet.service; enabled; vendor preset: disabled)
   Active: failed (Result: exit-code) since Fri 2024-08-16 11:57:09 CST; 497ms ago
  Process: 1331875 ExecStart=/root/app/garnet/GarnetServer (code=exited, status=203/EXEC)
 Main PID: 1331875 (code=exited, status=203/EXEC)

错误

4. 排查过程

4.1 确认文件权限和路径

首先确认文件是否存在并具有执行权限：

ls -l /root/app/garnet/GarnetServer

输出显示文件存在并且权限正确：

-rwxr-xr-x. 1 root root 74325221 8月  16 11:29 /root/app/garnet/GarnetServer

4.2 检查依赖库

使用 ldd 命令检查依赖库是否存在：

ldd /root/app/garnet/GarnetServer

输出显示所有依赖库都存在：

linux-vdso.so.1 (0x00007ffcc8c44000)
libpthread.so.0 => /lib64/libpthread.so.0 (0x00007fe048e00000)
libdl.so.2 => /lib64/libdl.so.2 (0x00007fe048a00000)
libz.so.1 => /lib64/libz.so.1 (0x00007fe048600000)
libm.so.6 => /lib64/libm.so.6 (0x00007fe048200000)
librt.so.1 => /lib64/librt.so.1 (0x00007fe047e00000)
libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007fe047a00000)
libstdc++.so.6 => /lib64/libstdc++.so.6 (0x00007fe047600000)
libc.so.6 => /lib64/libc.so.6 (0x00007fe047200000)

依赖库

4.3 检查 SELinux 配置

怀疑可能是 SELinux 的问题，检查文件的 SELinux 上下文：

ls -lZ /root/app/garnet/GarnetServer

输出显示文件的当前 SELinux 上下文：

-rwxr-xr-x. root root unconfined_u:object_r:default_t:s0 /root/app/garnet/GarnetServer

将文件的 SELinux 类型更改为 bin_t，以允许其被执行：

sudo chcon -t bin_t /root/app/garnet/GarnetServer

再次检查文件的 SELinux 上下文，确认已更改：

ls -lZ /root/app/garnet/GarnetServer

输出显示类型已更改为 bin_t：

-rwxr-xr-x. root root unconfined_u:object_r:bin_t:s0 /root/app/garnet/GarnetServer

4.4 更新 systemd 服务单元文件

确保 systemd 服务单元文件配置正确：

[Unit]
Description=Garnet Server
After=network.target


[Service]
Type=simple
ExecStart=/root/app/garnet/GarnetServer
Restart=on-failure
User=root
WorkingDirectory=/root/app/garnet
StandardOutput=journal
StandardError=journal


[Install]
WantedBy=multi-user.target

4.5 刷新并重启服务

刷新 systemd 配置并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart garnet.service

修复

此时服务已可以正常启动，通过 Tiny RDM 也可以正常连接查看了。

Tiny RDM

5. 结果

调整 SELinux 上下文后，Garnet 服务成功启动并运行正常。问题的根源在于 SELinux 的安全策略，默认情况下不允许执行非 bin_t 类型的文件。通过将文件类型更改为 bin_t，解决了 203/EXEC 错误。

6. 总结

在 Linux 系统中部署应用程序时，SELinux 的安全策略常常是导致问题的原因之一。通过正确设置文件的 SELinux 上下文，可以确保应用程序正常运行。如果你在部署过程中遇到类似问题，希望这篇文章能为你提供一些帮助。