跳到主要内容

在线部署指南（Docker）

部署说明

本文档介绍如何在有外网访问的环境中使用 Docker 部署 Lighthouse 可观测平台。在线安装包（online_install_x.x.x.tar.gz）会从网络获取所需的组件和依赖。

部署准备

环境要求

硬件配置
  • CPU：8 核心及以上
  • 内存：16 GB 及以上
  • 硬盘：100 GB 及以上
  • 网络带宽：1000 Mbps
软件环境
  • 操作系统：支持以下主流 Linux 发行版
    • RedHat 7.6+
    • CentOS 7.6+
    • RockyLinux 8.x+
    • Ubuntu LTS 版本
    • Debian 稳定版
  • Docker Engine 20.10.0+
  • Docker Compose v2.0.0+

部署步骤

1. 安装包准备

1.1 下载安装包

执行以下命令下载最新版本的安装包：

curl http://static.lighthouse.cyritex.com/install.sh | sh -s -- --online
版本选择

建议在生产环境中使用指定版本的安装命令，以确保环境的稳定性和可控性。

如需安装特定版本，请在命令中指定版本号，例如安装 1.13.0 版本：

curl http://static.lighthouse.cyritex.com/install.sh | sh -s -- -v 1.13.0 --online

1.2 解压安装包

tar zxvf lighthouse_online_1.13.0.tar.gz

2. 部署平台

cd lighthouse
./lighthouse.sh install
部署过程

安装脚本会自动完成以下操作：

  1. 检查系统环境
  2. 下载 Docker 镜像
  3. 初始化数据库
  4. 启动所有必需服务

3. 验证部署

执行以下命令查看服务状态：

./lighthouse.sh ls

正常情况下，您将看到类似下图的输出：

服务状态

服务状态说明
  • 所有服务应显示为 running 状态
  • light-schema-migrator 服务显示为 exited 是正常的，这是一个一次性的数据库迁移服务

访问平台

  1. 打开浏览器，访问 http://{部署服务器IP}
  2. 首次访问时，系统会引导您创建管理员账号
  3. 完成账号创建后，将自动登录到 Lighthouse 平台

平台运维

常用命令

运维命令
# 查看服务状态
./lighthouse.sh ls

# 停止所有服务
./lighthouse.sh stop

# 停止指定服务
./lighthouse.sh stop <服务名>

# 重启所有服务
./lighthouse.sh restart

# 重启指定服务
./lighthouse.sh restart <服务名>

# 卸载平台
./lighthouse.sh uninstall

# 查看版本信息
./lighthouse.sh -v

示例数据（可选）

如需体验平台功能，可以部署示例应用生成测试数据：

cd /opt/lighthouse/deploy/docker-compose/
PROFILER_EXPORTER_ENDPOINT={部署服务器IP}:8085 OPTIONAL_SERVICE_REPLICAS=1 docker compose --env-file /opt/lighthouse/.env up -d light-demo
RUM 数据采集
  1. 部署完成后，访问 http://{部署服务器IP}:8082
  2. 在示例网站上进行页面交互
  3. 打开 Lighthouse 平台的「用户体验监控」模块查看采集到的 RUM 数据

故障处理

如果部署过程中遇到问题，请检查：

  1. 系统资源是否满足最低要求
  2. Docker 服务是否正常运行
  3. 网络连接是否正常，能否访问镜像仓库
  4. 查看服务日志：docker logs <容器名>

如需更多帮助，请联系技术支持。