SolidTime项目在Kubernetes环境下的部署实践

本文将详细介绍如何在Kubernetes环境中部署SolidTime时间管理系统的实践经验。SolidTime是一个基于Laravel框架构建的开源时间跟踪和管理解决方案，本文将从架构设计到具体实现，全面解析其Kubernetes部署方案。

环境准备与架构设计

SolidTime在Kubernetes中的部署需要考虑多个组件协同工作。核心架构包括：

1. 应用服务层：运行SolidTime主应用
2. 数据库层：使用PostgreSQL存储数据
3. 辅助服务：包括任务调度(Worker)和定时任务(Scheduler)

部署采用多容器Pod模式，共享存储卷，确保各组件能够访问相同的应用数据和日志文件。

关键配置解析

环境变量配置

SolidTime的核心配置通过环境变量实现，主要分为以下几类：

• 应用基础配置：

  • APP_URL：应用访问地址
  • APP_ENV：运行环境(production/development)
  • APP_DEBUG：调试模式开关

• 认证配置：

  • APP_KEY：Laravel应用密钥
  • PASSPORT_PRIVATE_KEY/PASSPORT_PUBLIC_KEY：OAuth认证密钥对

• 数据库配置：

  • DB_CONNECTION：数据库类型(pgsql)
  • DB_HOST/DB_DATABASE：数据库连接信息

• 邮件服务：

  • MAIL_MAILER：邮件驱动(smtp)
  • MAIL_HOST/MAIL_PORT：SMTP服务器配置

存储配置

SolidTime需要持久化存储以下数据：

• 应用文件(storage/app)
• 日志文件(storage/logs)
• 通用存储(storage)

在Kubernetes中，这些通过PVC(Persistent Volume Claim)实现，确保数据持久性和多容器共享访问。

部署实现细节

数据库部署

采用PostgreSQL数据库，通过CRD(Custom Resource Definition)定义数据库和用户：

• 创建专用数据库实例
• 配置数据库用户及权限
• 通过Secret存储敏感信息(用户名/密码)

应用部署

SolidTime应用部署包含三个主要容器：

1. HTTP服务容器：处理Web请求

   • 使用FrankenPHP作为Octane服务器
   • 暴露8000端口

2. Worker容器：处理队列任务

   • 监听并执行异步任务
   • 需要与HTTP容器共享存储

3. Scheduler容器：执行定时任务

   • 运行Laravel调度器
   • 同样需要共享存储

配置管理

采用Kubernetes ConfigMap和Secret分离配置：

• ConfigMap：存储非敏感配置
• Secret：存储敏感信息(数据库密码、应用密钥等)

常见问题与解决方案

在部署过程中可能会遇到以下典型问题：

1. Worker启动失败：

   • 错误提示缺少ENV_WORKER_COMMAND环境变量
   • 解决方案：确保正确设置CONTAINER_MODE=worker

2. 认证配置问题：

   • PASSPORT密钥对需要预先生成
   • 可通过initContainer生成并存入Secret

3. 邮件服务配置：

   • 账户创建依赖邮件服务
   • 必须正确配置SMTP参数才能完成用户注册

优化建议

1. 日志收集：

   • 配置Laravel日志驱动为stderr
   • 通过Fluentd等工具收集容器日志

2. 监控集成：

   • 添加Prometheus指标暴露
   • 配置健康检查端点

3. 自动伸缩：

   • 根据负载自动扩展Worker实例
   • 配置HPA(Horizontal Pod Autoscaler)

总结

SolidTime在Kubernetes环境中的部署展现了现代化PHP应用的云原生实践。通过合理的架构设计和配置管理，可以实现高可用、可扩展的部署方案。本文提供的实践经验可作为类似Laravel应用Kubernetes部署的参考模板。

未来可考虑将部署方案封装为Helm Chart，进一步简化部署流程，这也是SolidTime团队正在推进的工作方向。