actinia-core 镜像文档

概述

本镜像为预配置的actinia-core Docker镜像，已集成actinia-plugins插件和GRASS GIS附加组件，无需额外安装即可直接部署使用。actinia-core是基于GRASS GIS的开源地理信息系统(GIS)REST API服务框架，可提供空间数据处理、分析与管理的编程接口，适用于快速构建GIS应用服务。

核心功能

• 完整actinia-core服务：提供标准actinia-core的REST API功能，支持空间数据导入/导出、地图代数运算、空间分析等GIS核心操作
• 预集成插件扩展：包含actinia-plugins生态插件，扩展服务功能（如时间序列分析、区域统计等高级GIS处理能力）
• GRASS GIS工具集：内置GRASS GIS及其附加组件(addons)，支持超过400种GIS算法与工具调用
• 开箱即用配置：已完成基础配置，减少部署时的环境依赖处理与参数调试工作

使用场景

• GIS应用开发者：快速搭建后端GIS处理服务，通过API接口集成到Web/移动应用中
• 科研人员：部署临时或长期GIS分析服务，处理遥感影像、地形数据等空间信息
• 教育机构：教学环境中提供标准化GIS服务实例，降低学生实验环境配置门槛
• 企业级应用：作为GIS微服务架构的基础组件，支撑空间数据处理业务流程

使用方法

1. 获取镜像

从Docker仓库拉取镜像（假设镜像名为actinia/core-with-plugins）：

bash
docker pull actinia/core-with-plugins:latest

2. 启动容器

基本启动命令（默认配置，映射8088端口）：

bash
docker run -d -p 8088:8088 --name actinia-service actinia/core-with-plugins:latest

3. 带数据持久化的启动

挂载本地数据目录以持久化存储GIS数据和配置：

bash
docker run -d \
  -p 8088:8088 \
  -v /local/grassdata:/actinia/grassdata \
  -v /local/actinia_config:/actinia/config \
  --name actinia-service \
  actinia/core-with-plugins:latest

• /local/grassdata：本地GRASS GIS数据存储目录
• /local/actinia_config：本地actinia配置文件目录（如actinia.cfg）

4. 访问服务

容器启动后，通过以下URL访问actinia-core API：

http://localhost:8088/api/v3/

可通过API文档（默认访问http://localhost:8088/api/v3/ui/）查看可用接口与调用示例。

配置说明

环境变量

可通过环境变量调整服务配置（部分常用变量）：

• ACTINIA_PORT：服务监听端口（默认8088）
• ACTINIA_WORKERS：处理请求的工作进程数（默认4）
• GRASS_REGION：默认GRASS GIS区域设置（如"n=400000 e=600000 s=200000 w=***"）

示例：指定端口与工作进程数

bash
docker run -d \
  -p 8080:8080 \
  -e ACTINIA_PORT=8080 \
  -e ACTINIA_WORKERS=8 \
  --name actinia-service \
  actinia/core-with-plugins:latest

自定义配置文件

通过挂载actinia.cfg配置文件覆盖默认设置：

bash
docker run -d \
  -p 8088:8088 \
  -v /local/actinia_config/actinia.cfg:/actinia/etc/actinia.cfg \
  --name actinia-service \
  actinia/core-with-plugins:latest

配置文件详细参数可参考actinia-core***文档。