记一次 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 ServerLoaded: 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 agoProcess: 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 也可以正常连接查看了。

5. 结果

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

6. 总结

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