digitop/diginext

DIGINEXT CLI & 构建服务器

运行在您基础设施上的构建服务器及其命令行界面(CLI)，是DevOps工程师的必备工具。

开发者不应因部署应用到基础设施而感到沮丧，也无需麻烦DevOps工程师协助部署，他们应专注于应用开发，无需了解服务器、域名或基础设施相关知识。这时dx（DIGINEXT）应运而生，它是您的DevOps助手。

| 构建更快。部署更易。更灵活。

| dx也代表开发者体验（Developer Experience），这是我们的首要目标——为开发者创造最佳体验。

镜像概述和主要用途

DIGINEXT是一个运行在自有基础设施上的容器构建服务器，同时提供开发者友好的命令行界面(CLI)。它旨在简化应用部署流程，让开发者无需关心基础设施细节，专注于应用开发本身。该镜像支持Docker和Podman两种主流容器引擎，可通过Docker Compose快速部署，满足不同团队的容器构建需求。

核心功能和特性

• 双容器引擎支持：提供Docker和Podman两种容器引擎，灵活适配不同构建环境
• 开发者友好CLI：简化部署命令，降低操作复杂度
• Docker-in-Docker/Podman-in-Docker架构：支持在容器内运行容器构建流程
• 集成数据库：默认使用MongoDB存储配置和构建数据
• 持久化存储：通过卷挂载实现节点模块、用户主目录和应用数据的持久化
• 可配置性强：支持通过环境变量自定义端口、数据库连接、构建器类型等关键参数

使用场景和适用范围

• DevOps工程师管理容器化应用的构建和部署流程
• 需要在自有基础设施上搭建私有构建服务的团队
• 希望减少开发者与基础设施交互、提升开发效率的开发团队
• 同时使用Docker和Podman容器引擎的混合环境

使用方法和配置说明

使用Docker Engine作为构建器

您可以使用仓库中提供的docker-compose.example-docker.yaml模板，将其重命名为docker-compose.docker.yaml，并按以下说明修改环境变量：

yaml
version: "3"
networks:
    bridge:
        driver: bridge
volumes:
    mongo:
        external: true
        name: mongo
services:
    mongo:
        ports:
            - '27017'
        container_name: mongo
        restart: always
        logging:
            options:
                max-size: 1g
        networks:
            - bridge
        environment:
            - MONGO_INITDB_ROOT_USERNAME=root
            - MONGO_INITDB_ROOT_PASSWORD=diginext
        image: mongo
        volumes:
            - mongo:/data/db
    diginext:
        image: "digitop/diginext:latest"
        container_name: diginext
        working_dir: /usr/app/
        ports:
            - "6969:6969"
        restart: unless-stopped
        depends_on:
            - mongo
        networks:
            - bridge
        privileged: true  # Docker-in-Docker需要特权模式
        entrypoint: /usr/app/scripts/startup.sh
        volumes:
            # Docker套接字（用于Docker-in-Docker）
            - "/var/run/docker.sock:/var/run/docker.sock"
            # 缓存节点模块和主目录
            - /usr/app/node_modules/
            - /home/app/
            # 主机与容器目录映射（持久化存储）
            - ./storage:/var/app/storage
        environment:
            - NODE_ENV=production  # 运行环境
            - PORT=6969  # 服务端口
            - BASE_URL=http://localhost:6969  # 服务基础URL
            - MONGODB_CONNECTION_STRING=mongodb://root:diginext@mongo:27017/diginext?authSource=admin  # MongoDB连接字符串
            - CLI_MODE=server  # 运行模式（服务器模式）
            - BUILDER=docker  # 构建器类型（Docker）
            - JWT_SECRET=  # JWT密钥（需自行配置）
            - JWT_EXPIRE_TIME=48h  # JWT过期时间
            - GOOGLE_CLIENT_ID=  # Google OAuth客户端ID（可选）
            - GOOGLE_CLIENT_SECRET=  # Google OAuth客户端密钥（可选）

使用以下命令启动服务：

bash
# 前台启动（用于测试）
docker compose -f docker-compose.docker.yaml up

# 如无错误，可后台启动
docker compose -f docker-compose.docker.yaml up -d

服务启动后，可通过 http://localhost:6969 访问。

使用Podman Engine作为构建器

Podman-in-Docker

使用仓库中提供的docker-compose.example-podman.yaml模板，注意环境变量BUILDER=podman及容器的安全配置差异：

yaml
version: "3"
networks:
    bridge:
        driver: bridge
volumes:
    mongo:
        external: true
        name: mongo
services:
    # MongoDB数据库
    mongo:
        image: mongo
        container_name: mongo
        restart: always
        ports:
            - '27017'
        networks:
            - bridge
        logging:
            options:
                max-size: 1g
        volumes:
            - mongo:/data/db
        environment:
            - MONGO_INITDB_ROOT_USERNAME=root
            - MONGO_INITDB_ROOT_PASSWORD=diginext
    # 构建服务器
    diginext:
        image: digitop/diginext:beta
        container_name: diginext
        working_dir: /usr/app/
        ports:
            - "6969:6969"
        restart: unless-stopped
        networks:
            - bridge
        depends_on:
            - mongo
        # ----------- [START] Podman在Docker内运行的安全配置（无需特权模式） ----------
        devices:
            - "/dev/fuse"
        security_opt:
            - "seccomp=unconfined"
            - "label=disable"
        cap_add:
            - sys_admin
            - mknod
        # ----------- [END] Podman在Docker内运行的安全配置 ----------
        volumes:
            # 持久化节点模块和主目录
            - /usr/app/node_modules/
            - /home/app/
            # 主机与容器目录映射（持久化存储）
            - ./storage:/var/app/storage
        environment:
            - TZ=Asia/Ho_Chi_Minh  # 时区（可选）
            - NODE_ENV=production  # 运行环境
            - PORT=6969  # 服务端口
            - BASE_URL=http://localhost:6969  # 服务基础URL
            - MONGODB_CONNECTION_STRING=mongodb://root:diginext@mongo:27017/diginext-cli?authSource=admin  # MongoDB连接字符串
            - CLI_MODE=server  # 运行模式（服务器模式）
            - JWT_SECRET=  # JWT密钥（需自行配置）
            - JWT_EXPIRE_TIME=48h  # JWT过期时间
            - GOOGLE_CLIENT_ID=  # Google OAuth客户端ID（可选）
            - GOOGLE_CLIENT_SECRET=  # Google OAuth客户端密钥（可选）
            - BUILDER=podman  # 构建器类型（Podman）

使用以下命令启动服务：

bash
docker compose -f docker-compose.podman.yaml up -d

服务启动后，可通过 http://localhost:6969 访问。

重要配置参数说明

注意事项

• 使用Docker构建器时，容器需要privileged: true特权模式以支持Docker-in-Docker
• 使用Podman构建器时，需配置特定的安全选项（security_opt、cap_add等），无需特权模式
• MongoDB卷mongo需提前创建（可通过docker volume create mongo命令）
• 首次启动前，建议配置JWT_SECRET等敏感参数，确保服务安全