eeacms/esbootstrap-configs

eea.esbootstrap.configs 镜像文档

镜像概述和主要用途

eea.esbootstrap.configs 是 esbootstrap 的配置仓库镜像，主要用于存储和管理 esbootstrap 应用的配置文件。该镜像提供标准化的配置文件结构，支持应用的自定义配置管理，适用于开发和部署环境中 esbootstrap 应用的配置加载与维护。

核心功能和特性

1. 灵活的配置文件结构

支持两种配置文件组织方式，满足不同场景需求：

• 完全自定义应用配置：包含完整配置文件集，支持深度自定义，目录结构如下：

  └── default
      ├── mapping.json
      ├── filtersQuery.sparql
      ├── query.sparql
      ├── facets.json
      ├── settings.json
      ├── riverconfig.example.json
      ├── riverconfig_1.json
      ├── riverconfig_2.json
      ├── public
      │   ├── custom.css
      │   └── custom.js
      └── views
          ├── cardview.jade
          ├── listview.jade
          └── landingview.jade
  

• 最小默认应用配置：包含运行所需的最小配置文件集，目录结构如下：

  └── default
      ├── mapping.json
      ├── query.sparql
      ├── facets.json
      ├── settings.json
      ├── public
      │   ├── custom.css
      │   └── custom.js
  

2. 开发环境支持

通过环境变量 DEV_CONFIG 启用开发模式，此时配置仓库会自动克隆/拉取到容器内的 /code/config 目录，支持开发过程中动态更新配置。

使用场景和适用范围

• esbootstrap 应用配置管理：适用于需要自定义 esbootstrap 应用的映射规则（mapping.json）、查询逻辑（query.sparql）、 facets 配置（facets.json）等场景。
• 开发环境配置动态加载：开发团队可通过设置 DEV_CONFIG 环境变量，实现在开发过程中实时拉取最新配置，加速配置调试。
• 特定领域应用：支持如 CaR app 等特定应用的配置管理，满足个性化业务需求。

使用方法和配置说明

配置文件结构说明

应用配置文件需放置在 config 目录下，根据需求选择完全自定义或最小默认配置结构：

• 核心配置文件说明：
  • mapping.json：数据映射规则配置
  • query.sparql：SPARQL 查询语句配置
  • facets.json：分面（facets）展示配置
  • settings.json：应用全局设置
  • public/：静态资源目录（含 custom.css、custom.js）
  • views/（完全自定义场景）：视图模板目录（如 cardview.jade）

开发环境配置

1. 启用开发模式：启动容器时设置环境变量 DEV_CONFIG，例如：

   bash
   docker run -e DEV_CONFIG=1 eea.esbootstrap.configs
   

2. 配置仓库路径：启用后，配置仓库会自动克隆/拉取到容器内的 /code/config 目录，支持实时更新配置。

配置详情与特定应用

• 通用配置文档：应用配置详情请参考 https://github.com/eea/eea.docker.esbootstrap/blob/master/docs/Details.md%E3%80%82
• 特定应用示例：
  • https://github.com/eea/eea.esbootstrap.configs/blob/master/CaR/README.md%EF%BC%9ACaR 应用的专用配置说明。