Ed-Fi Admin Databases Docker镜像文档

镜像概述和主要用途

本镜像提供EdFi_Admin和EdFi_Security数据库在PostgreSQL 11上的Docker部署方案。数据库在镜像首次启动时自动安装。该镜像不包含任何预安装的第三方供应商组件，适合生产环境使用。

核心功能和特性

• 集成EdFi_Admin和EdFi_Security数据库实现
• 基于PostgreSQL 11数据库引擎构建
• 采用Alpine基础镜像，实现轻量级部署
• 首次启动时自动初始化数据库架构和基础数据
• 支持API模式配置（沙箱模式/共享实例模式）
• 生产环境就绪，无第三方依赖组件

使用场景和适用范围

适用于Ed-Fi ODS/API生态系统的部署场景，需提供管理（EdFi_Admin）和安全（EdFi_Security）数据库支持的应用。支持以下使用场景：

• 教育数据标准（Ed-Fi）相关系统的开发、测试与生产环境部署
• 沙箱模式（Sandbox）下的应用测试与验证
• 共享实例模式（SharedInstance）下的多租户数据管理
• 需要标准化数据库部署流程的Ed-Fi生态系统组件集成

镜像变体

当前唯一支持的镜像变体基于Alpine系统和PostgreSQL 11构建：

edfialliance/ods-api-db-admin:<version>

支持的环境变量

使用方法

Docker Run命令示例

bash
docker run -d \
  --name edfi-admin-db \
  -e API_MODE=SharedInstance \
  -e POSTGRES_USER=edfiadmin \
  -e POSTGRES_PASSWORD=SecurePassw0rd \
  -p 5432:5432 \
  -v edfi-admin-db-data:/var/lib/postgresql/data \
  edfialliance/ods-api-db-admin:2.1.7

参数说明：

• -d：后台运行容器
• --name：指定容器名称为edfi-admin-db
• -e：设置环境变量（API模式、数据库用户及密码）
• -p：映射容器5432端口到主机5432端口（PostgreSQL默认端口）
• -v：挂载数据卷edfi-admin-db-data以持久化数据库数据

Docker Compose配置示例

yaml
version: '3.8'

services:
  edfi-admin-db:
    image: edfialliance/ods-api-db-admin:2.1.7
    container_name: edfi-admin-db
    restart: unless-stopped
    environment:
      - API_MODE=Sandbox
      - POSTGRES_USER=edfiadmin
      - POSTGRES_PASSWORD=SecurePassw0rd
    ports:
      - "5432:5432"
    volumes:
      - edfi-admin-db-data:/var/lib/postgresql/data

volumes:
  edfi-admin-db-data:
    driver: local

镜像版本链接

• 2.1.7
• 2.1.6
• 2.1.5
• 2.1.4
• 2.1.3
• 2.1.2
• 2.1.1
• 2.1.0
• 2.0.0
• 1.1.0
• 1.0.0

许可信息

查看镜像包含软件的许可信息。

与所有Docker镜像一样，本镜像可能包含其他软件组件（如基础镜像中的Bash等），这些组件可能受其他许可协议约束。镜像用户有责任确保其使用行为符合所有包含软件的相关许可要求。