tracardi/init

Tracardi初始化脚本镜像概述

Tracardi初始化脚本镜像是Tracardi客户数据平台部署流程中的核心组件，专门用于在系统启动前执行必要的初始化操作，确保平台运行环境配置正确、依赖服务就绪，并完成基础数据准备，为Tracardi主应用提供可直接运行的环境。

核心功能与特性

主要功能

• 环境配置验证：检查必要环境变量是否存在，确保配置完整性
• 数据库初始化：支持PostgreSQL等数据库的连接测试、表结构创建及初始数据加载
• 依赖服务检测：验证Kafka、Redis等核心依赖服务的网络可达性
• 配置文件生成：根据环境变量动态生成Tracardi主应用所需的配置文件
• 权限初始化：创建默认管理员账户及基础角色权限

特性

• 轻量级设计，基于Alpine Linux构建，镜像体积小
• 支持多环境适配（开发、测试、生产）
• 失败自动重试机制，提高初始化成功率
• 详细日志输出，便于问题排查

使用场景与适用范围

• 首次部署Tracardi平台：作为初始化流程的关键步骤，确保系统从零开始正确配置
• 环境迁移或升级：在数据库结构变更、配置参数调整时执行，同步更新基础数据
• 容器化部署流程：集成至Docker Compose或Kubernetes部署流程，作为前置启动任务
• 开发环境快速搭建：帮助开发者本地快速初始化完整的Tracardi运行环境

使用方法与配置说明

前提条件

• 已部署Tracardi依赖的数据库服务（PostgreSQL）
• 已部署消息队列（Kafka，可选）及缓存服务（Redis，可选）
• 容器运行环境需支持Docker 19.03+或兼容的容器运行时

环境变量配置

Docker运行示例

基础运行命令

bash
docker run --rm \
  -e TRACARDI_DB_HOST=postgres-host \
  -e TRACARDI_DB_PORT=5432 \
  -e TRACARDI_DB_NAME=tracardi \
  -e TRACARDI_DB_USER=dbuser \
  -e TRACARDI_DB_PASSWORD=dbpass \
  tracardi/init-script:latest

带Kafka配置的运行命令

bash
docker run --rm \
  -e TRACARDI_DB_HOST=postgres-host \
  -e TRACARDI_DB_PORT=5432 \
  -e TRACARDI_DB_NAME=tracardi \
  -e TRACARDI_DB_USER=dbuser \
  -e TRACARDI_DB_PASSWORD=dbpass \
  -e TRACARDI_KAFKA_HOST=kafka-host \
  -e TRACARDI_KAFKA_PORT=9092 \
  -e INIT_RETRY_COUNT=5 \
  tracardi/init-script:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  tracardi-init:
    image: tracardi/init-script:latest
    environment:
      TRACARDI_DB_HOST: postgres
      TRACARDI_DB_PORT: 5432
      TRACARDI_DB_NAME: tracardi
      TRACARDI_DB_USER: ${DB_USER}
      TRACARDI_DB_PASSWORD: ${DB_PASSWORD}
      TRACARDI_KAFKA_HOST: kafka
      TRACARDI_KAFKA_PORT: 9092
    depends_on:
      postgres:
        condition: service_healthy
      kafka:
        condition: service_started
    networks:
      - tracardi-network

  # 其他服务（postgres、kafka、tracardi-api等）...

运行后预期结果

• 脚本执行成功后输出 [SUCCESS] Tracardi initialization completed
• 数据库中创建Tracardi所需的表结构及初始配置数据
• 生成的配置文件可被Tracardi主应用读取（若通过卷挂载共享）
• 容器自动退出（因初始化完成，无需持续运行）

注意事项

• 该脚本为一次性执行工具，完成后容器会自动退出，建议添加--rm参数清理临时容器
• 生产环境中需通过环境变量或密钥管理工具传递敏感信息（如数据库密码）
• 初始化失败时，脚本会输出详细错误日志，可通过docker logs <container_id>查看
• 数据库已有数据时，脚本会跳过表结构创建，但仍会验证数据完整性并更新必要配置