oneterm高可用部署方案：Docker Compose与Kubernetes配置详解

【免费下载链接】oneterm Provide secure access and control over all infrastructure 项目地址: https://gitcode.com/gh_mirrors/on/oneterm

oneterm是一款提供安全访问和控制所有基础设施的工具，通过Docker Compose和Kubernetes可以实现其高可用部署，确保系统稳定运行。

一、Docker Compose快速部署指南

1.1 环境准备

首先需要克隆仓库：git clone https://gitcode.com/gh_mirrors/on/oneterm，进入项目目录后，重点关注部署相关文件，如deploy/docker-compose.yaml和deploy/setup.sh。

1.2 配置初始化

运行部署目录下的deploy/setup.sh脚本，该脚本会帮助配置密码等关键信息。它支持手动输入密码或自动生成随机密码两种方式，确保数据库等服务的安全访问。

1.3 服务启动

执行docker compose up -d命令启动服务，deploy/docker-compose.yaml中定义了多个关键服务，包括oneterm-api、oneterm-guacd、mysql、redis、oneterm-ui和acl-api等。各服务之间通过健康检查确保依赖服务正常运行后才启动，如oneterm-api依赖oneterm-guacd和acl-api的健康状态。

二、Docker Compose配置详解

2.1 核心服务组件

• oneterm-api：核心API服务，使用deploy/config.yaml进行配置，挂载了回放和RDP相关目录，通过健康检查确保服务端口可访问。
• oneterm-guacd：提供RDP/VNC支持的服务，负责处理相关协议连接。
• mysql和redis：分别作为数据库和缓存服务，存储系统数据和会话信息。
• oneterm-ui：前端UI服务，通过Nginx配置与后端API通信，环境变量中设置了API主机地址等关键参数。

2.2 开发环境配置

对于开发场景，可以使用deploy/docker-compose.backend-dev.yaml配置。该配置将oneterm-ui的ONETERM_API_HOST指向本地后端地址，方便开发调试，同时暴露了更多端口便于开发人员访问服务。

三、Kubernetes部署方案

3.1 基础架构规划

在Kubernetes环境中，需要将Docker Compose中的服务转换为对应的Deployment、Service、ConfigMap等资源。例如，将mysql和redis部署为StatefulSet以保证数据持久化，oneterm-api和oneterm-ui部署为Deployment实现多副本高可用。

3.2 配置管理

使用ConfigMap管理deploy/config.yaml等配置文件，通过环境变量注入敏感信息，如数据库密码等。利用Secret存储加密数据，确保配置的安全性。

3.3 服务暴露与负载均衡

通过Ingress资源暴露前端UI和API服务，配置负载均衡策略，实现流量分发和高可用。同时，利用Kubernetes的自愈能力，当服务出现故障时自动重启或重新调度。

四、高可用保障措施

4.1 健康检查与自动恢复

无论是Docker Compose还是Kubernetes部署，都配置了健康检查机制。如deploy/docker-compose.yaml中对各服务设置了test、interval等健康检查参数，确保服务异常时能及时发现并自动恢复。

4.2 数据持久化

通过挂载卷（Volume）确保mysql数据、回放文件等重要数据的持久化存储，防止数据丢失。在Kubernetes中可使用PersistentVolume和PersistentVolumeClaim实现更灵活的存储管理。

4.3 多副本部署

在Kubernetes环境下，为关键服务如oneterm-api部署多个副本，通过Service实现负载均衡，提高系统的并发处理能力和可用性。

五、部署后验证与维护

5.1 服务状态检查

部署完成后，可通过docker compose ps（Docker Compose）或kubectl get pods（Kubernetes）查看服务状态，确保所有服务正常运行。

5.2 日志查看与问题排查

利用docker compose logs [service-name]或kubectl logs [pod-name]查看服务日志，及时排查部署和运行过程中的问题。

5.3 定期备份与更新

定期备份数据库等关键数据，关注项目更新，通过重新部署更新服务版本，确保系统安全性和功能完整性。

通过以上Docker Compose和Kubernetes部署方案，可以实现oneterm的高可用部署，满足不同场景下的使用需求，保障系统稳定可靠运行。

【免费下载链接】oneterm Provide secure access and control over all infrastructure 项目地址: https://gitcode.com/gh_mirrors/on/oneterm