bsord/rcvr-web

rcvr服务Kubernetes部署指南

概述

本指南提供在Kubernetes集群中部署rcvr服务的完整步骤。rcvr服务是一个包含多个组件的Web服务，涵盖数据库、缓存、DMARC处理、API服务、Web界面、邮件中继、SMTP服务及Ingress路由等功能，需通过Kubernetes资源配置和Helm图表完成部署。

核心功能和特性

• 数据库支持：使用MariaDB作为后端数据库，支持主从复制
• 缓存服务：集成Redis作为消息队列
• DMARC处理：部署专用DMARC处理器组件
• API服务：提供rcvr核心功能的API接口
• Web界面：包含React前端的Web界面
• 邮件中继：提供邮件中继服务
• SMTP服务：处理SMTP相关功能
• Ingress路由：通过Ingress配置外部访问

使用场景

适用于需要在Kubernetes集群中部署rcvr完整服务栈的环境，满足邮件处理、DMARC分析及Web访问需求。

部署步骤

1. 进入Kubernetes目录

console
cd kubernetes

2. 创建命名空间和ConfigMap

console
kubectl apply -f rcvr-namespace.yml
kubectl apply -f configmap.yml

3. 创建数据库密钥

重要：请将以下值替换为您的实际配置！

console
kubectl create secret generic -n rcvr rcvr-db-user-pass --from-literal=mariadb-username=DBUs3rName --from-literal=mariadb-password='DBPassw0rd' --from-literal=mariadb-root-password='R00tPassw0rd' --from-literal=mariadb-replication-password='R3plication@ssw0rdHere'

4. 使用密钥部署MariaDB数据库

console
helm install rcvr-db stable/mariadb -n rcvr --set db.user=RcvrDBUser --set existingSecret=rcvr-db-user-pass --set db.name=rcvr-db --set slave.replicas=1

5. 部署Redis

console
helm install rcvr-queue stable/redis --namespace rcvr --set usePassword=false

6. 部署DMARC处理器

console
kubectl apply -f rcvr-dmarc.yml

7. 部署API服务

console
kubectl apply -f rcvr-api.yml

8. 部署Web界面

编辑REACT_APP_API为您将用于Ingress的公共DNS主机名

console
kubectl apply -f rcvr-web.yml

9. 部署中继服务

console
kubectl apply -f rcvr-relay.yml

10. 部署SMTP服务

console
kubectl apply -f rcvr-smtp.yml

11. 部署Ingress

运行YAML前需更新主机名

console
kubectl apply -f rcvr-ingress.yml

待办事项

1. 通过opendkim命令为出站中继添加DKIM支持，将其作为密钥导入并在中继部署中挂载为文件。