Budibase Apps Service 镜像文档

镜像概述和主要用途

Budibase Apps Service 镜像是 Budibase 自托管架构的核心组件之一，用于运行和管理 Budibase 应用服务。作为组合服务的关键部分，该镜像需与其他 Budibase 组件（如数据库、缓存服务等）协同工作，支持用户在自有基础设施上部署完整的低代码平台。

核心功能和特性

• 应用服务运行：提供 Budibase 应用的运行时环境，支持低代码应用的执行和交互。
• 自托管架构集成：作为 Budibase 自托管部署的核心组件，与数据库、缓存、存储等服务协同，构成完整的低代码平台。
• 服务组件协同：与 Budibase 其他服务（如 API 服务、认证服务）无缝集成，支持应用生命周期管理（创建、更新、部署）。

使用场景和适用范围

• 自托管低代码平台需求：企业或个人需要在私有基础设施（如服务器、私有云）部署低代码平台，满足数据本地化、隐私合规需求。
• 内部业务系统开发：用于构建内部管理系统、流程自动化工具等定制化应用，支持团队快速迭代。
• 私有部署场景：适用于对公共云服务有限制，或需完全控制基础设施的场景（如***、政务、大型企业）。

使用方法和配置说明

前提条件

• 已安装 Docker 和 Docker Compose。
• 需准备依赖服务：PostgreSQL（数据库）、Redis（缓存）、MinIO（文件存储，可选）。

1. 基础 Docker Run 命令

单独运行 Apps Service 需指定依赖服务连接信息，示例：

bash
docker run -d \
  --name budibase-apps \
  -p 4001:4001 \
  -e PORT=4001 \
  -e NODE_ENV=production \
  -e BB_DATABASE_URL=postgresql://user:password@db-host:5432/budibase \
  -e BB_REDIS_URL=redis://redis-host:6379 \
  budibase/apps-service:latest

2. Docker Compose 配置（推荐）

作为组合服务的一部分，建议通过 Docker Compose 管理完整部署，示例配置（含依赖服务）：

yaml
version: '3.8'

services:
  # Budibase Apps Service
  apps-service:
    image: budibase/apps-service:latest
    container_name: budibase-apps
    ports:
      - "4001:4001"  # 应用服务端口
    environment:
      - PORT=4001  # 服务监听端口
      - NODE_ENV=production  # 运行环境（production/development）
      - BB_DATABASE_URL=postgresql://budibase:budibase@db:5432/budibase  # 数据库连接URL
      - BB_REDIS_URL=redis://redis:6379  # Redis连接URL
      - BB_MINIO_URL=[***]  # MinIO存储服务URL（如需文件存储）
      - BB_MINIO_ACCESS_KEY=minio_access_key  # MinIO访问密钥
      - BB_MINIO_SECRET_KEY=minio_secret_key  # MinIO密钥
    depends_on:
      - db
      - redis
      - minio  # 如需文件存储
    volumes:
      - ./budibase-data:/app/data  # 持久化应用数据
    restart: unless-stopped

  # 依赖服务：PostgreSQL数据库
  db:
    image: postgres:14
    container_name: budibase-db
    environment:
      - POSTGRES_USER=budibase  # 数据库用户名
      - POSTGRES_PASSWORD=budibase  # 数据库密码
      - POSTGRES_DB=budibase  # 数据库名
    volumes:
      - postgres-data:/var/lib/postgresql/data  # 持久化数据库数据
    restart: unless-stopped

  # 依赖服务：Redis缓存
  redis:
    image: redis:alpine
    container_name: budibase-redis
    volumes:
      - redis-data:/data  # 持久化缓存数据
    restart: unless-stopped

  # 依赖服务：MinIO文件存储（可选）
  minio:
    image: minio/minio
    container_name: budibase-minio
    environment:
      - MINIO_ROOT_USER=minio_access_key  # MinIO访问密钥
      - MINIO_ROOT_PASSWORD=minio_secret_key  # MinIO密钥
    volumes:
      - minio-data:/data  # 持久化文件存储数据
    command: server /data  # 启动MinIO服务
    restart: unless-stopped

volumes:
  postgres-data:  # 数据库数据卷
  redis-data:     # Redis数据卷
  minio-data:     # MinIO数据卷（如启用）

3. 核心配置参数说明

4. 部署验证

启动服务后，通过 http://<服务器IP>:4001 访问 Apps Service 健康检查接口（如返回 OK 则表示服务正常运行）。完整平台部署需结合 Budibase 前端服务（budibase/frontend）访问应用控制台。