conversion-gdal

![Docker Hub Badge]([***]

镜像概述和主要用途

基于GDAL/OGR的Docker镜像，用于文件格式转换。该镜像设计用于通过一次性docker run命令执行特定的转换任务。运行容器时应调用工作目录中的脚本./ogr-convert.sh，默认命令会显示脚本的使用方法。

核心功能和特性

• 基于GDAL/OGR工具集，支持多种地理空间数据格式转换
• 适用于一次性转换任务，通过简单的docker run命令即可执行
• 提供ogr-convert.sh脚本简化转换流程，降低使用复杂度
• 支持处理远程文件（HTTP/HTTPS协议）和本地挂载文件
• 可灵活指定输出目录和文件名，支持多种输出格式（如ESRI Shapefile、GeoJson等）

使用场景和适用范围

• 需要临时转换地理空间数据格式的场景（如GML转Shapefile、GeoJson等）
• 处理远程地理数据文件或本地文件的格式转换需求
• 无需在本地安装GDAL/OGR环境，通过容器化方式快速完成转换任务

详细使用方法和配置说明

基本使用方式

通过docker run命令调用容器内的./ogr-convert.sh脚本执行转换，脚本主要参数说明：

• --source：源文件路径或URL（远程文件需提供完整HTTP/HTTPS链接；本地文件需为容器内可访问的路径，通常通过挂载卷实现）
• --target-name：目标文件名（不带格式后缀）
• -f：输出格式（需指定GDAL支持的格式名称，如"ESRI Shapefile"、"GeoJson"等）
• --target-dir：目标文件输出目录（可选，若不指定则使用容器内部默认卷路径）

Docker部署示例

1. 构建镜像（修改后）

若对镜像进行修改，可通过以下命令重新构建：

docker build -t wetransform/conversion-gdal:latest .

2. 转换远程文件（结果存储在容器内部卷）

将远程文件转换后，结果保存在容器内部卷中：

docker run -it wetransform/conversion-gdal:latest ./ogr-convert.sh --source [***] --target-name hydroEx.shp -f "ESRI Shapefile"

3. 转换远程文件（结果存储在挂载文件夹，当前用户权限）

将远程文件转换后，结果保存在本地挂载的文件夹中，并以当前用户权限执行（避免文件权限问题）：

docker run -it --user=$(id -u):$(id -g) -v $(pwd):/data wetransform/conversion-gdal:latest ./ogr-convert.sh --source [***] --target-dir /data --target-name hydroEx.json -f "GeoJson"

4. 转换本地挂载文件

通过挂载本地目录到容器，转换本地文件（需确保源文件路径在容器内可访问）：

docker run -it -v <本地待挂载文件夹路径>:/data wetransform/conversion-gdal:latest ./ogr-convert.sh --source /data/<example.gml> --target-dir /data/target --target-name test.shp -f "ESRI Shapefile"

说明：将<本地待挂载文件夹路径>替换为实际本地目录路径，<example.gml>替换为该目录下的源文件名。