pdok/geopackage-optimizer-go

geopackage-optimizer-go

!https://img.shields.io/github/license/PDOK/geopackage-optimizer-go https://img.shields.io/github/release/PDOK/geopackage-optimizer-go.svg](https://github.com/PDOK/geopackage-optimizer-go/releases) https://goreportcard.com/badge/PDOK/geopackage-optimizer-go](https://goreportcard.com/report/PDOK/geopackage-optimizer-go) https://img.shields.io/docker/pulls/pdok/geopackage-optimizer-go.svg](https://hub.docker.com/r/pdok/geopackage-optimizer-go)

镜像概述和主要用途

geopackage-optimizer-go是一个用于优化GeoPackage文件的Docker镜像，其核心功能是对GeoPackage进行特定处理，使其能够作为PDOK OGC服务的数据源。通过一系列索引优化，确保GeoPackage在作为服务数据源时具备更好的性能和安全性。

核心功能和特性

优化措施

• 创建PUUID索引：使用UUID4生成随机UUID作为索引
• 创建FUUID索引：基于[表名].[PUUID]生成索引

优化优势

上述优化措施带来以下优势：

• 提升性能：索引的创建有助于提高数据查询和访问性能
• 防止爬虫：采用UUID而非自增ID，可有效防止通过ID序列进行数据爬取
• 避免ID依赖：防止用户开发依赖ID含义或稳定性的应用

使用场景和适用范围

适用于需要将GeoPackage文件作为PDOK OGC服务数据源的场景，特别适合以下情况：

• 需要提升GeoPackage数据在OGC服务中的访问性能
• 关注数据安全性，希望防止通过ID序列爬取数据
• 希望避免用户应用对数据ID的不合理依赖

使用方法和配置说明

基本Docker运行示例

从仓库根目录运行（注意：会修改geopackage/original.gpkg文件）：

bash
docker run \
  -v geopackage:/geopackage \
  docker.xuanyuan.run/pdok/geopackage-optimizer-go:latest "/geopackage/original.gpkg"

Argo工作流配置示例

以下是在Argo工作流中使用该镜像的配置示例：

yaml
spec:
  templates:
    - name: optimize-gpkg
      retryStrategy:
        limit: 2
        retryPolicy: "Always"
        backoff:
          duration: "10"
          factor: 3
      volumes:
        - name: gpkg-volume
          emptyDir: {}
        - name: optimize-gpkg
          configMap:
            name: optimize-gpkg
            defaultMode: 0777
      inputs:
        parameters:
          - name: source-key
          - name: destination-key
        artifacts:
          - name: "gpkg"
            path: "/data/input.gpkg"
            archive:
              none: {}
      outputs:
        artifacts:
          - name: gpkg
            path: "/data/input.gpkg"
            archive:
              none: {}
            azure:
              endpoint: "$(BLOBS_ENDPOINT)"
              container: geopackages
              blob: "{{inputs.parameters.destination-key}}"
              accountKeySecret:
                name: blobs-argo
                key: BLOBS_KEY
      container:
        image: docker.xuanyuan.run/geopackage-optimizer-go
        imagePullPolicy: IfNotPresent
        volumeMounts:
          - name: gpkg-volume
            mountPath: /data
        command: ["/optimizer", "-s"] # 与Argo 3.4.4 Emissary工作流执行器配合需要
        args: ["/data/input.gpkg"]
        resources:
          limits:
            cpu: "0.1"
            memory: "650Mi"
            ephemeral-storage: # PATCH
          requests:
            cpu: "0.1"
            memory: "650Mi"
            ephemeral-storage: # PATCH

工作流配置说明

• command: ["/optimizer", "-s"]：与Argo 3.4.4 Emissary工作流执行器配合时需要的命令参数
• args: ["/data/input.gpkg"]：指定待优化的GeoPackage文件路径
• 资源限制：根据实际需求调整CPU、内存和临时存储的资源配置
• 输入输出：通过工件（artifacts）定义GeoPackage文件的输入输出路径，支持Azure Blob存储作为输出目标