hestiae/ce-api

Hestia社区版API

通过预打包安装方式运行Hestia计算任务。

快速开始

设置以下环境变量：

DATA_FOLDER=/app/data

所有计算用文件将存储在容器内的/app/data目录。若需持久化数据，可挂载卷：

-v ${PWD}/data:/app/data

在指定端口运行容器：

bash
docker run --rm \
  --name hestia-ce-api \
  --env-file .env \
  -v ${PWD}/data:/app/data \
  -p 3000:80 \
  hestiae/ce-api:latest

访问http://localhost:3000/docs开始测试API。

使用Earth Engine模块补全站点测量数据

Hestia包含一个模块，可补全Site的部分地理数据。若要使用该功能，请遵循快速开始指南创建账户并获取账户ID和credentials.json文件，然后添加以下额外环境变量：

# 设置可补全的最大站点面积，值过高会显著减慢计算速度或导致错误
MAX_AREA_SIZE=100000
# 指向从Google Cloud获取的credentials.json文件，可放在任何挂载点可用的位置
EARTH_ENGINE_KEY_FILE=/app/ee/credentials.json
EARTH_ENGINE_ACCOUNT_ID=<account@iam.gserviceaccount.com>

配合UI使用API

我们提供额外的前端Docker镜像：https://hub.docker.com/r/hestiae/ce-ui%E3%80%82

在80端口运行容器：

bash
docker run --rm \
  --name hestia-ce-ui \
  -p 80:80 \
  hestiae/ce-ui:latest

也可使用Docker Compose一起运行所有服务。

使用预打包的ElasticSearch引擎

默认情况下，查询Hestia术语表时会重定向到Hestia API。您也可使用预索引的ElasticSearch镜像进行查询：

1. 添加以下环境变量：

# 连接到本地网络
SEARCH_URL=http://localhost:9200 

2. 在9200端口运行容器：

bash
docker run --rm \
  --name hestia-ce-es \
  -p 9200:9200 \
  hestiae/ce-es:latest

也可使用Docker Compose一起运行所有服务。

使用Runners和RabbitMQ运行计算

我们提供额外的Docker镜像用于在API外运行计算：https://hub.docker.com/r/hestiae/ce-runner%E3%80%82

首先，您需要访问RabbitMQ 3实例，然后在.env文件中添加其URL：

# 若RabbitMQ安装在本地
AMQP_URL=amqp://guest:guest@localhost:5672/

• 若要使用自定义通道，设置AMQP_CHANNEL=my-custom-channel
• 若Admin访问端口不是***，使用AMQP_ADMIN_PORT=101

您可根据需要多次运行容器（以并行执行计算）：

bash
docker run --rm \
  --name hestia-ce-runner-1 \
  --env-file .env \
  -v ${PWD}/data:/app/data \
  hestiae/ce-runner:latest

需与API容器共享相同的.env文件（以访问数据目录、Earth Engine凭据或ecoinvent文件路径）。

最后，确保在UI设置中开启“队列系统”，或使用以下命令：

bash
curl -X 'PUT' \
  'http://<domain>/settings/enableQueuing' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d 'true'

也可使用Docker Compose一起运行所有服务。