i386/geonetwork

注意：这是https://hub.docker.com/_/geonetwork%E7%9A%84%60i386%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链接

警告：此镜像不支持i386架构

快速参考（续）

• 提交问题地址：
  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是一个用于管理空间参考资源的目录应用。它提供强大的元数据编辑和搜索功能，以及交互式网络地图查看器。

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 i386/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 i386/geonetwork:4

对于GeoNetwork 4.2稳定版：

console
docker pull elasticsearch:7.17.15
docker pull i386/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 i386/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: i386/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 i386/geonetwork

发布端口

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

console
docker run --name some-geonetwork -d -p 8080:8080 i386/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 bin目录/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 i386/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 i386/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 i386/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 i386/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 i386/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.url=[***]
        -