arm32v5/geonetwork

注意：这是https://hub.docker.com/_/geonetwork%E7%9A%84%60arm32v5%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22%E6%AF%8F%E6%9E%B6%E6%9E%84%22%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/geonetwork/docker-geonetwork

• 获取帮助的途径：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及相应的Dockerfile链接

警告：此镜像在arm32v5架构上不受支持

快速参考（续）

• 问题反馈地址：
  https://github.com/geonetwork/docker-geonetwork/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/geonetwork/%E3%80%81https://hub.docker.com/r/arm32v7/geonetwork/%E3%80%81https://hub.docker.com/r/arm64v8/geonetwork/%E3%80%81https://hub.docker.com/r/ppc64le/geonetwork/

• 已发布镜像制品详情：
  https://github.com/docker-library/repo-info/blob/master/repos/geonetwork%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/geonetwork%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fgeonetwork
  https://github.com/docker-library/official-images/blob/master/library/geonetwork%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/geonetwork%EF%BC%89

• 此描述的来源：
  https://github.com/docker-library/docs/tree/master/geonetwork%EF%BC%88https://github.com/docker-library/docs/commits/master/geonetwork%EF%BC%89

什么是GeoNetwork？

GeoNetwork是一个用于管理空间参考资源的目录应用。它提供强大的元数据编辑和搜索功能，以及交互式Web地图查看器。

GeoNetwork项目始于2001年，最初是联合国粮食及农业组织（FAO）、联合国世界粮食计划署（WFP）和联合国环境规划署（UNEP）的空间数据目录系统。

目前，该项目被广泛用作全球空间数据基础设施的基础。

GeoNetwork旨在使用现代架构连接空间信息社区及其数据，该架构同时具备强大功能和低成本特性，基于自由开源软件（FOSS）原则以及服务和协议的国际开放标准（如：ISO/TC211、OGC）。

该项目是开放地理空间基金会（OSGeo）的一部分，可在GeoNetwork opensource获取。GeoNetwork通过现代架构连接空间信息社区及其数据，兼具强大功能和低成本特性。

!https://raw.githubusercontent.com/docker-library/docs/6a537ddd2def65eaaa31cbadbaa5303f2dc82fe3/geonetwork/logo.png

如何使用此镜像

GeoNetwork 4使用Elasticsearch服务器存储其管理的文档索引，因此必须配置Elasticsearch服务器的URL才能运行。

以下是快速示例，用于演示目的启动GeoNetwork 4.4最新版。此配置在容器被移除后不会保留数据。

console
docker pull elasticsearch:7.17.15
docker pull arm32v5/geonetwork:4

docker network create gn-network

docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15
docker run --name geonetwork-host --network gn-network -e GN_CONFIG_PROPERTIES="-Des.host=my-es-host -Des.protocol=http -Des.port=9200 -Des.url=http://my-es-host:9200" -p 8080:8080 arm32v5/geonetwork:4

对于GeoNetwork 4.2稳定版：

console
docker pull elasticsearch:7.17.15
docker pull arm32v5/geonetwork:4.2

docker network create gn-network

docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15
docker run --name geonetwork-host --network gn-network -e ES_HOST=my-es-host -e ES_PROTOCOL=http  -e ES_PORT=9200 -p 8080:8080 arm32v5/geonetwork:4.2

要确定使用哪个Elasticsearch版本，可查看对应GN版本的GeoNetwork文档，或所用GeoNetwork版本的https://github.com/geonetwork/core-geonetwork/blob/main/pom.xml#L1528C17-L1528C24%E6%96%87%E4%BB%B6%E4%B8%AD%E7%9A%84%60es.version%60%E5%B1%9E%E6%80%A7%E3%80%82

默认凭据

安装后，使用默认凭据：admin（用户名）和**admin**（密码）。建议安装后更新默认密码。

Elasticsearch配置

Java属性（4.4.0及更新版本）

从GeoNetwork 4.4.0开始，使用通过GN_CONFIG_PROPERTIES环境变量传递的Java属性配置Elasticsearch连接：

• es.host：可选（默认localhost）：Elasticsearch服务器的主机名。
• es.port：可选（默认9200）：Elasticsearch服务器监听的端口。
• es.protocol：可选（默认http）：用于与Elasticsearch通信的协议，可为http或https。
• es.url：若主机、端口或协议非默认值则为必填（默认http://localhost:9200）：Elasticsearch服务器的完整URL。
• es.index.records：可选（默认gn_records）：若多个GeoNetwork实例使用同一Elasticsearch集群，每个实例需使用不同的索引名。使用此变量定义每个GeoNetwork使用的索引名。
• es.username：可选（默认空）：用于连接Elasticsearch的用户名。
• es.password：可选（默认空）：用于连接Elasticsearch的密码。
• kb.url：可选（默认http://localhost:5601）：Kibana监听的URL。

Docker Compose YAML示例片段：

yaml
services:
  geonetwork:
    image: arm32v5/geonetwork:4.4
    environment:
      GN_CONFIG_PROPERTIES: >-
        -Des.host=elasticsearch
        -Des.protocol=http
        -Des.port=9200
        -Des.url=http://elasticsearch:9200
        -Des.username=my_es_username
        -Des.password=my_es_password
        -Dkb.url=http://kibana:5601

环境变量（4.2及更早版本）

对于4.4.0之前的版本，使用环境变量配置Elasticsearch：

• ES_HOST：必填：Elasticsearch服务器的主机名。
• ES_PORT：可选（默认9200）：Elasticsearch服务器监听的端口。
• ES_PROTOCOL：可选（默认http）：用于与Elasticsearch通信的协议，可为http或https。
• ES_INDEX_RECORDS：可选（默认gn_records）：若多个GeoNetwork实例使用同一Elasticsearch集群，每个实例需使用不同的索引名。使用此变量定义每个GeoNetwork使用的索引名。
• ES_USERNAME：可选（默认空）：用于连接Elasticsearch的用户名。
• ES_PASSWORD：可选（默认空）：用于连接Elasticsearch的密码。
• KB_URL：可选（默认http://localhost:5601）：Kibana监听的URL。

数据库配置

默认情况下，GeoNetwork使用本地H2数据库用于演示（不推荐用于生产环境）。该镜像包含PostgreSQL和MySQL的JDBC驱动程序。要配置数据库连接，使用以下环境变量：

• GEONETWORK_DB_TYPE：要使用的数据库类型。有效值为postgres、postgres-postgis、mysql。可通过扩展镜像包含其他驱动程序来使用其他类型：db2、h2、oracle、sqlserver。这些其他数据库的JAR驱动程序需通过挂载或扩展官方镜像添加到/opt/geonetwork/WEB-INF/lib。
• GEONETWORK_DB_HOST：数据库主机名。
• GEONETWORK_DB_PORT：数据库端口。
• GEONETWORK_DB_NAME：数据库名称。
• GEONETWORK_DB_USERNAME：用于连接数据库的用户名。
• GEONETWORK_DB_PASSWORD：用于连接数据库的密码。
• GEONETWORK_DB_CONNECTION_PROPERTIES：要添加到连接字符串的其他属性，例如search_path=test,public&ssl=true将生成JDBC连接字符串如jdbc:postgresql://localhost:5432/postgres?search_path=test,public&ssl=true

启动GeoNetwork

以下命令将启动基于Debian的容器，运行Tomcat（GN 3）或Jetty（GN 4）Web服务器，并部署GeoNetwork WAR：

console
docker run --name some-geonetwork -d arm32v5/geonetwork

发布端口

GeoNetwork监听端口8080。若要从主机访问容器，必须发布此端口。例如，以下命令将容器的8080端口流量重定向到主机的同一端口：

console
docker run --name some-geonetwork -d -p 8080:8080 arm32v5/geonetwork

然后，若在Linux上运行Docker，可通过http://localhost:8080/geonetwork访问GeoNetwork。

设置数据目录和H2数据库文件

数据目录是目录在文件系统上存储其大部分自定义配置和上传文件的位置，也是存储多种支持文件（如空间索引、缩略图）的位置。默认变体还使用本地H2数据库存储元数据目录本身。

默认情况下，GeoNetwork将数据目录设置为/opt/geonetwork/WEB-INF/data，H2数据库文件在Jetty目录/var/lib/jetty/gn.h2.db（GN 4.0.0及以上）或Tomcat目录/usr/local/tomcat/gn.h2.db（GN 3），但可通过向容器注入环境变量覆盖这些值：-e DATA_DIR=...（默认/opt/geonetwork/WEB-INF/data）和-e GEONETWORK_DB_NAME=...（默认gn，在Tomcat的/usr/local/tomcat目录中设置数据库gn.h2.db）。注意，通过GEONETWORK_DB_NAME设置数据库位置仅从3.10.3版本开始支持。

从4.4.0版本开始，数据目录需通过GN_CONFIG_PROPERTIES环境变量传递的Java属性配置。例如：

console
docker run --name some-geonetwork -d -p 8080:8080  -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn arm32v5/geonetwork

持久化数据

要将数据目录设置为/catalogue-data/data，H2数据库文件设置为/catalogue-data/db/gn.h2.db，以便在重启后保留数据：

• GeoNetwork 4.2及更早版本

console
docker run --name some-geonetwork -d -p 8080:8080 -e DATA_DIR=/catalogue-data/data -e GEONETWORK_DB_NAME=/catalogue-data/db/gn arm32v5/geonetwork:3

• GeoNetwork 4.4.0及更新版本

console
docker run --name some-geonetwork -d -p 8080:8080  -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn arm32v5/geonetwork

若要使数据目录在容器重启甚至销毁后仍然存在，可将Docker引擎主机的目录挂载到容器中：-v /host/path:/path/to/data/directory。例如，以下命令将主机目录/host/geonetwork-docker挂载到容器的/catalogue-data：

• GeoNetwork 4.2及更早版本

console
docker run --name some-geonetwork -d -p 8080:8080 -e DATA_DIR=/catalogue-data/data -e GEONETWORK_DB_NAME=/catalogue-data/db/gn -v /host/geonetwork-docker:/catalogue-data arm32v5/geonetwork:3

• GeoNetwork 4.4.0及更新版本

console
docker run --name some-geonetwork -d -p 8080:8080  -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn -v /host/geonetwork-docker:/catalogue-data arm32v5/geonetwork

... 通过https://github.com/docker/compose

geonetwork的compose.yaml示例：

yaml
# GeoNetwork
#
# 通过 "http://localhost:8080/geonetwork" 访问
#
# 默认用户：admin
# 默认密码：admin

volumes:
  geonetwork:
  esdata:
  pgdata:
  pglog:

services:
  geonetwork:
    image: geonetwork:4.4
    healthcheck:
      test: curl http://localhost:8080/
      interval: 5s
      timeout: 5s
      retries: 30
    restart: always
    volumes:
      - geonetwork:/catalogue-data
    depends_on:
      database:
        condition: service_healthy
    ports:
      - 8080:8080
    environment:
      WEBAPP_CONTEXT_PATH: /geonetwork
      DATA_DIR: /catalogue-data
      TZ: Europe/Amsterdam

      JAVA_OPTS: >-
        --add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED
        -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true
        -Xms512M -Xss512M -Xmx2G -XX:+UseConcMarkSweepGC
        -Djetty.httpConfig.requestHeaderSize=32768
        -Dorg.eclipse.jetty.server.Request.maxFormContentSize=500000
        -Dorg.eclipse.jetty.server.Request.maxFormKeys=4000
      # 远程调试
      # -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005

      GN_CONFIG_PROPERTIES: >-
        -Dgeonetwork.dir=/catalogue-data
        -Dgeonetwork.formatter.dir=/catalogue-data/data/formatter
        -Dgeonetwork.schema.dir=/opt/geonetwork/WEB-INF/data/config/schema_plugins
        -Dgeonetwork.indexConfig.dir=/opt/geonetwork/WEB-INF/data/config/index
        -Dgeonetwork.schemapublication.dir=/opt/geonetwork/WEB-INF/data/resources/schemapublication
        -Dgeonetwork.htmlcache.dir=/opt/geonetwork/WEB-INF/data/resources/htmlcache
        -Des.host=elasticsearch
        -Des.protocol=http
        -Des.port=9200
        -Des