Jitsu 项目 Docker 快速部署指南

概述

Jitsu 是一个开源的数据收集和处理平台，本文将详细介绍如何使用 Docker 快速部署 Jitsu 本地测试环境。通过本指南，您可以在几分钟内完成 Jitsu 的基本部署和配置。

环境准备

在开始部署前，请确保您的系统满足以下要求：

• Docker Engine 19.03.0 或更高版本
• 可选：Kubernetes 集群（仅当需要使用连接器同步功能时）

配置步骤

1. 创建环境变量文件

首先需要创建 .env 配置文件：

# 从示例文件创建.env文件
cp .env.example .env

2. 配置关键环境变量

打开 .env 文件，配置以下重要参数：

管理员账户设置

• SEED_USER_EMAIL 和 SEED_USER_PASSWORD：必填项
  • 这是初始管理员账户的登录凭据
  • 首次登录后请立即修改密码
  • 示例：

    SEED_USER_EMAIL=admin@example.com
    SEED_USER_PASSWORD=your_secure_password
    

服务访问地址配置

• JITSU_PUBLIC_URL：

  • 默认值：http://localhost:${JITSU_UI_PORT}/
  • 这是 Jitsu 用户界面的访问地址
  • 生产环境建议配置为 HTTPS 地址，如：https://jitsu.yourdomain.com

• JITSU_INGEST_PUBLIC_URL：

  • 默认值：http://localhost:${JITSU_INGEST_PORT}/
  • 这是数据接收服务的访问地址
  • 生产环境同样建议配置 HTTPS

安全令牌配置

以下令牌用于 Jitsu 内部组件间通信，请务必使用随机生成的强密码：

• CONSOLE_TOKEN
• POSTGRES_PASSWORD
• BULKER_TOKEN
• SYNCCTL_TOKEN

启动 Jitsu 服务

完成配置后，在 jitsu/docker 目录下执行：

docker-compose up

服务启动后，在浏览器中访问配置的 UI 地址（如 http://localhost:3000/），使用初始管理员账户登录即可开始使用。

数据收集配置

登录后，按照以下步骤配置数据收集：

1. 在 Jitsu UI 中创建新站点
2. 点击站点菜单中的"Setup instructions"按钮
3. 按照指引获取数据收集代码片段

高级配置选项

根据实际需求，您还可以进行以下可选配置：

1. 连接器同步：配置数据源和目标之间的自动同步
2. 禁用用户注册：在 .env 文件中设置 DISABLE_SIGNUP=true 可关闭自助注册功能
3. 生产环境优化：参考生产部署文档调整其他配置参数

注意事项

1. 本文描述的部署方式仅适用于测试环境
2. 生产环境部署需要考虑以下因素：
   • 使用 HTTPS 加密通信
   • 配置适当的访问控制
   • 设置数据备份策略
   • 监控服务运行状态

通过以上步骤，您已经完成了 Jitsu 的基本部署。接下来可以开始探索 Jitsu 的数据收集、转换和路由功能，构建您的数据管道。