dbpedia/dbpedia-spotlight

DBpedia Spotlight 镜像文档

镜像概述和主要用途

DBpedia Spotlight 是一款用于自动标注文本中DBpedia资源提及的工具，提供了通过DBpedia将非结构化信息源链接到关联开放数据云的解决方案。

dbpedia/dbpedia-spotlight Docker镜像用于运行DBpedia Spotlight服务，包含从DBpedia Databus仓库下载的最新语言模型，支持多种语言如英语（en）、德语（de）、意大利语（it）等。

核心功能和特性

• 自动标注文本中的DBpedia资源提及
• 支持多语言模型，涵盖17种语言
• 通过Docker卷持久化语言模型
• 提供灵活的部署方式（单服务、多服务）
• 可配置的服务端口和重启策略

可用语言模型及快速启动命令

下表列出了可用的语言模型及其快速启动命令。--mount source=spotlight-model... 会自动创建 spotlight-model 卷。

若要运行多个DBpedia Spotlight服务，只需更改端口号（-p 222X:80），例如：英语使用 -p 2222:80，德语使用 -p 2223:80。

测试DBpedia Spotlight服务

必要时请更改端口号。

bash
curl http://localhost:2222/rest/annotate \
--data-urlencode "text=President Obama called Wednesday on Congress to extend a tax break for students included in last year's economic stimulus package, arguing that the policy provides more generous assistance." \
--data "confidence=0.35" \
-H "Accept: text/turtle"

Accept: text/turtle 返回NIF格式输出，可将该选项改为 Accept: application/json 以返回JSON格式输出。

停止Docker容器

可使用以下任一命令停止DBpedia Spotlight服务：

bash
docker kill dbpedia-spotlight.[LANG]
docker rm dbpedia-spotlight.[LANG]

docker kill 命令用于停止运行中的容器，docker rm 命令用于删除容器。dbpedia-spotlight.[LANG] 对应 docker run 命令中 --name 选项指定的容器名称。

运行DBpedia Spotlight的其他选项

运行单个DBpedia Spotlight服务（bash命令）

此选项可用于持久化运行DBpedia Spotlight服务的配置，推荐用于运行配置与上表默认配置不同的单个服务。

1. 将以下代码保存到bash文件（例如 english-spotlight.sh）：

bash
LANG=en
# 可用语言：ca, da, de, en, es, fi, fr, hu, it, lt, nl, no, pt, ro, ru, sv, tr

# 创建卷以持久化模型
docker volume create spotlight-model

# 运行docker镜像
docker run -tid \
 --restart unless-stopped \
 --name dbpedia-spotlight.$LANG \
 --mount source=spotlight-model,target=/opt/spotlight \
 -p 2222:80 \
 dbpedia/dbpedia-spotlight \
 spotlight.sh $LANG   

2. 授予文件执行权限：

bash
chmod a+x english-spotlight.sh

3. 执行bash文件：

bash
./english-spotlight.sh

运行一个或多个DBpedia Spotlight服务（docker-compose）

Docker-compose 是一款将多个容器作为单个服务运行的工具，基于YAML数据序列化语言定义一个或多个服务的配置。

可使用Docker-compose定义和运行多个DBpedia Spotlight服务。以下说明如何创建YAML配置文件以运行单个服务。多服务的YAML配置示例可在https://raw.githubusercontent.com/dbpedia/spotlight-docker/multilingual/spotlight-compose.yml%E8%8E%B7%E5%8F%96%E3%80%82

1. 创建Docker Compose文件：

   Docker Compose文件（例如 spotlight-compose.yml）通过以下配置块定义一个或多个DBpedia Spotlight服务：

yaml
version: '3.5'
services:
  spotlight.[LANG]:
    image: [DOCKER-IMAGE]
    container_name: dbpedia-spotlight.[LANG]
    volumes:
      - spotlight-model:/opt/spotlight
    restart: unless-stopped
    ports:
      - "0.0.0.0:2222:80"
    command: /bin/spotlight.sh [LANG]

volumes:
  spotlight-model:
    external: true

其中：

• [LANG]：语言模型的两位代码，可用语言模型包括：ca, da, de, en, es, fi, fr, hu, it, lt, nl, no, pt, ro, ru, sv, tr
• [DOCKER-IMAGE]：Docker镜像名称

2. 运行Docker Compose文件：

bash
docker-compose -f spotlight-compose.yml up -d

例如，以下docker-compose配置运行DBpedia Spotlight德语语言模型：

yaml
version: '3.5'
services:
  spotlight.de:
    image: dbpedia/dbpedia-spotlight
    container_name: dbpedia-spotlight.de
    volumes:
      - spotlight-model:/opt/spotlight/models
    restart: unless-stopped
    ports:
      - "0.0.0.0:2222:80"
    command: /bin/spotlight.sh de

volumes:
  dbp-model:
    external: true

创建文件后，执行 docker-compose -f spotlight-compose.yml up -d 即可启动服务。

停止Docker Compose服务

使用以下命令停止DBpedia Spotlight服务：

bash
docker-compose -f spotlight-compose.yml stop

stop 指令将停止运行中的容器，spotlight-compose.yml 对应运行Compose文件时使用的文件名。

通过Docker命令监控DBpedia Spotlight服务

以下Docker命令可用于查看dbpedia-spotlight镜像的相关信息：

• docker logs dbpedia-spotlight.[LANG]：显示对应服务的日志信息
• docker stats dbpedia-spotlight.[LANG]：显示对应服务的统计信息（如内存和CPU使用量）

故障排除

内存问题

DBpedia Spotlight服务会将语言模型复制到内存中以提高处理效率。所需内存量取决于所选语言模型，例如英语模型需要>8GB内存才能运行。

运行DBpedia Spotlight服务前，可能需要先调整Docker配置中的内存选项。例如，Mac用户默认情况下Docker仅使用2GB内存。相反，Linux用户无此限制，但Docker可能使用主机系统的可用内存，从而导致内存不足问题。

支持的Docker版本

此镜像官方支持Docker版本 19.03.11。

有关如何升级Docker守护进程的详细信息，请参见Docker安装文档。

文档

此镜像的文档存储在http://github.com/dbpedia-spotlight/dbpedia-spotlight/wiki%E4%B8%AD%E3%80%82