opendatacube/geobase-runner

opendatacube/geobase-builder 镜像文档

镜像概述

opendatacube/geobase-builder是一个基于Ubuntu 20.04的Docker镜像，专为构建地理空间Python虚拟环境设计。该镜像提供了一致的构建环境，简化地理空间相关Python项目的依赖管理和环境配置过程，确保开发和部署的环境一致性。

核心功能与特性

• 基础环境：基于Ubuntu 20.04 LTS，提供稳定的操作系统基础
• Python支持：内置Python环境，支持构建地理空间相关的Python虚拟环境
• 依赖管理：包含构建地理空间应用所需的系统依赖和工具链
• 环境一致性：确保不同开发/部署环境中构建过程的一致性，减少"在我机器上能运行"问题

使用场景

• 地理空间Python项目的开发环境构建
• 地理数据处理、分析工具的打包与分发
• 需要统一构建环境的地理空间应用团队协作
• CI/CD流程中地理空间项目的自动化构建

使用方法

基本使用

通过以下命令拉取并运行镜像：

bash
docker pull opendatacube/geobase-builder
docker run -it --rm opendatacube/geobase-builder

挂载项目目录

将本地项目目录挂载到容器中，进行虚拟环境构建：

bash
docker run -it --rm -v /path/to/your/project:/app opendatacube/geobase-builder

在容器内，可使用标准Python虚拟环境工具（如venv或conda）构建地理空间虚拟环境：

bash
# 创建并激活虚拟环境
python -m venv /app/venv
source /app/venv/bin/activate

# 安装地理空间依赖（示例）
pip install numpy rasterio geopandas

环境变量配置

可通过环境变量自定义构建行为（具体支持的环境变量请参考Docker Hub官方文档）：

bash
docker run -it --rm -e PYTHON_VERSION=3.8 -v /path/to/your/project:/app opendatacube/geobase-builder

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  geobase-builder:
    image: opendatacube/geobase-builder
    volumes:
      - ./project:/app
    environment:
      - PYTHON_VERSION=3.8
    command: /bin/bash -c "python -m venv /app/venv && source /app/venv/bin/activate && pip install -r /app/requirements.txt"

运行：

bash
docker-compose up

注意事项

• 该镜像主要用于构建环境，非运行时环境
• 构建完成的虚拟环境需从容器中导出或通过挂载目录保留
• 具体支持的地理空间库版本和系统依赖细节，请参考https://hub.docker.com/repository/docker/opendatacube/geobase-builder