opendatacube/geobase

opendatacube/geobase 镜像说明

镜像概述

本镜像集合用于构建最新版本的地理空间库及依赖这些库的Python环境，采用多阶段构建技术以最小化输出镜像体积，并减少安全与部署方面的潜在问题。

核心功能

• 包含预编译的地理空间基础库：PROJ 6.3.0、GEOS 3.7.2、GDAL 3.0.4
• 提供预构建的Python轮子（Wheels），覆盖地理空间（rasterio、pyproj等）、数值计算（scipy、pandas等）、IO（h5py等）多类别
• 支持多阶段构建分离构建/运行环境，优化镜像大小与安全性

使用场景

• 地理空间数据处理应用的Docker镜像构建
• 定制化Python环境快速搭建（适用于遥感图像处理、数据科学场景）
• 开发阶段调试地理空间库相关编译问题

配置说明

快速开始示例

1. 创建requirements.txt

rasterio[s3]
pyproj

2. 创建Dockerfile

docker
FROM opendatacube/geobase:wheels as env_builder
COPY requirements.txt /
RUN env-build-tool new /requirements.txt /env /wheels

FROM opendatacube/geobase:runner
COPY --from=env_builder /env /env
ENV LC_ALL=C.UTF-8
ENV PATH="/env/bin:${PATH}"

镜像分层说明

• base/builder：基于buildpack-deps:bionic，源码构建PROJ/GEOS/GDAL，包含编译所需开发库
• base/wheels：基于builder，预构建地理空间及相关Python轮子
• base/runner：基于ubuntu:18.04，包含运行所需非开发版依赖库，用于最终运行环境

本地开发辅助

构建本地镜像

bash
./scripts/build-docker.sh

运行本地构建环境

bash
mkdir -p run/dl run/build run/envs
cd run
docker run \
       -v $(pwd)/dl:/dl \
       -v $(pwd)/build:/build \
       -v $(pwd)/envs:/envs \
       -ti --rm \
       geobase:local

内部构建Python轮子示例

bash
pip3 wheel --no-deps --no-binary :all: \
     GDAL==$(gdal-config --version) \
     pyproj \
     Shapely \
     fiona \
     rasterio \
     h5py