entropicdev/registry

Entropic包管理器后端服务镜像

镜像概述

本镜像为Entropic包管理器的后端服务，是包管理系统的核心组件，负责处理包的存储、检索、版本控制及相关API请求，支持Entropic包管理器的完整功能实现。

核心功能与特性

• 包管理核心：提供包的上传、下载、版本控制及元数据管理功能
• API接口支持：对外暴露RESTful API，支持包管理器客户端的各类操作请求
• 数据持久化：支持通过数据卷挂载实现包数据及配置的持久化存储
• 可扩展性：设计支持水平扩展，可根据负载需求调整服务实例数量

使用场景与适用范围

• 开发环境：用于本地或团队内部Entropic包管理器的后端服务部署
• 测试环境：验证包管理器功能及兼容性的测试环境搭建
• 生产环境：为企业或组织提供稳定的包管理后端服务，支持内部或公开的包分发

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name entropic-backend \
  -p 3000:3000 \
  -v entropic-data:/app/data \
  entropic-backend:latest

参数说明：

• -p 3000:3000：映射容器端口3000到主机，默认API端口为3000
• -v entropic-data:/app/data：挂载数据卷，持久化存储包数据及配置

环境变量配置

可通过环境变量自定义服务配置，常用变量如下：

示例（自定义数据库连接）：

bash
docker run -d \
  --name entropic-backend \
  -p 3000:3000 \
  -v entropic-data:/app/data \
  -e DATABASE_URL="postgresql://user:password@db-host:5432/entropic" \
  -e LOG_LEVEL="debug" \
  entropic-backend:latest

Docker Compose配置

yaml
version: '3'
services:
  entropic-backend:
    image: entropic-backend:latest
    ports:
      - "3000:3000"
    volumes:
      - entropic-data:/app/data
    environment:
      - DATABASE_URL=postgresql://user:password@db:5432/entropic
      - LOG_LEVEL=info
    depends_on:
      - db

  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=entropic
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  entropic-data:
  postgres-data:

注意事项

• 首次启动时，服务会自动初始化数据库结构，无需额外手动操作
• 生产环境建议使用外部数据库（如PostgreSQL）替代默认SQLite，提升性能和可靠性
• 数据卷挂载为必选配置，避免容器重启导致数据丢失