该镜像基于 当前版本的 Manticore 包。

默认配置包含一个示例实时表，并监听默认端口：

• 9306 用于来自 MySQL 客户端的连接
• 9308 用于通过 HTTP 的连接
• 9312 用于通过二进制协议的连接（例如在运行集群时）

该镜像附带用于从 MySQL、PostgreSQL、XML 和 CSV 文件轻松索引数据的库。

以下是启动 Manticore 容器并通过 mysql 客户端登录的最简单方法：

docker run --name manticore --rm -d manticoresearch/manticore && echo "Waiting for Manticore docker to start. Consider mapping the data_dir to make it start faster next time" && until docker logs manticore 2>&1 | grep -q "accepting connections"; do sleep 1; echo -n .; done && echo && docker exec -it manticore mysql && docker stop manticore

注意，退出 MySQL 客户端后，Manticore 容器将被停止并移除，导致数据不会被保存。有关在生产环境中使用 Manticore 的信息，请参见下文。

该镜像附带一个示例表，可以这样加载：

mysql> source /sandbox.sql

此外，mysql 客户端的历史记录中有几个示例查询，您可以在上述表上运行，只需在客户端使用上下键查看并执行它们。

为了数据持久化，文件夹 /var/lib/manticore/ 应挂载到本地存储或其他所需的存储引擎。

实例内的配置文件位于 /etc/manticoresearch/manticore.conf。对于自定义设置，应将此文件挂载到您自己的配置文件。

端口为 9306/9308/9312，分别用于 SQL/HTTP/二进制，根据您使用 Manticore 的方式暴露它们。例如：

docker run --name manticore -v $(pwd)/data:/var/lib/manticore -p 127.0.0.1:9306:9306 -p 127.0.0.1:9308:9308 -d manticoresearch/manticore

或者

docker run --name manticore -v $(pwd)/manticore.conf:/etc/manticoresearch/manticore.conf -v $(pwd)/data:/var/lib/manticore/ -p 127.0.0.1:9306:9306 -p 127.0.0.1:9308:9308 -d manticoresearch/manticore

如果您希望端口对外部主机可用，请确保移除 127.0.0.1:。

Manticore Search Docker 镜像预装了 Manticore Columnar Library 和 Manticore Buddy

在许多情况下，您可能希望将 Manticore 与 Docker Compose YAML 文件中指定的其他镜像一起使用。以下是在 docker-compose.yml 文件中为 Manticore Search 推荐的最小配置：

version: '2.2'
services:
  manticore:
    container_name: manticore
    image: manticoresearch/manticore
    restart: always
    ports:
      - 127.0.0.1:9306:9306
      - 127.0.0.1:9308:9308
    ulimits:
      nproc: 65535
      nofile:
         soft: 65535
         hard: 65535
      memlock:
        soft: -1
        hard: -1
    volumes:
      - ./data:/var/lib/manticore
#      - ./manticore.conf:/etc/manticoresearch/manticore.conf # uncomment if you use a custom config

除了使用暴露的端口 9306 和 9308，您还可以通过运行 docker-compose exec manticore mysql 登录实例。

HTTP 协议暴露在端口 9308。您可以将端口映射到本地并使用 curl 连接：

docker run --name manticore -p 9308:9308 -d manticoresearch/manticore

POST /cli -d 'CREATE TABLE testrt ( title text, content text, gid integer)'

POST /insert
-d'{"table":"testrt","id":1,"doc":{"title":"Hello","content":"world","gid":1}}'

POST /search -d '{"table":"testrt","query":{"match":{"*":"hello world"}}}'

默认情况下，服务器设置将日志发送到 /dev/stdout，可以从主机查看：

docker logs manticore

通过传递变量 QUERY_LOG_TO_STDOUT=true，查询日志可以重定向到 Docker 日志。

以下是定义两个节点集群的简单 docker-compose.yml：

version: '2.2'
services:
  manticore-1:
    image: manticoresearch/manticore
    restart: always
    ulimits:
      nproc: 65535
      nofile:
         soft: 65535
         hard: 65535
      memlock:
        soft: -1
        hard: -1
    networks:
      - manticore
  manticore-2:
    image: manticoresearch/manticore
    restart: always
    ulimits:
      nproc: 65535
      nofile:
        soft: 65535
        hard: 65535
      memlock:
        soft: -1
        hard: -1
    networks:
      - manticore
networks:
  manticore:
    driver: bridge

• 启动它：docker-compose up
• 创建集群：

  $ docker-compose exec manticore-1 mysql
  mysql> CREATE TABLE testrt ( title text, content text, gid integer);
  mysql> CREATE CLUSTER posts;
  Query OK, 0 rows affected (0.24 sec)
  mysql> ALTER CLUSTER posts ADD testrt;
  Query OK, 0 rows affected (0.07 sec)
  MySQL [(none)]> exit
  Bye

• 在第二个实例加入集群

  $ docker-compose exec manticore-2 mysql
  mysql> JOIN CLUSTER posts AT 'manticore-1:9312';
  mysql> INSERT INTO posts:testrt(title,content,gid)  VALUES('hello','world',1);
  Query OK, 1 row affected (0.00 sec)
  MySQL [(none)]> exit
  Bye

• 如果现在回到第一个实例，您将看到新记录：

  $ docker-compose exec manticore-1 mysql
  MySQL [(none)]> select * from testrt;
  +---------------------+------+-------+---------+
  | id                  | gid  | title | content |
  +---------------------+------+-------+---------+
  | 3891565839006040065 |    1 | hello | world   |
  +---------------------+------+-------+---------+
  1 row in set (0.00 sec)
  MySQL [(none)]> exit
  Bye

建议覆盖 docker 的默认 ulimits 以适应 Manticore 实例：

 --ulimit nofile=65536:65536

为了获得最佳性能，表组件可以被“mlock”锁定到内存中。当 Manticore 在 Docker 下运行时，实例需要额外权限以允许内存锁定。运行实例时必须添加以下选项：

  --cap-add=IPC_LOCK --ulimit memlock=-1:-1

如果您想使用包含表定义的自定义配置运行 Manticore，则需要将配置挂载到实例：

docker run --name manticore -v $(pwd)/manticore.conf:/etc/manticoresearch/manticore.conf -v $(pwd)/data/:/var/lib/manticore -p 127.0.0.1:9306:9306 -d manticoresearch/manticore

请注意，容器内的 Manticore search 以用户 manticore 运行。对表文件的操作（如创建或轮换普通表）也应在 manticore 用户下进行。否则文件将由 root 创建，搜索守护进程将无权打开它们。例如，以下是如何轮换所有表：

docker exec -it manticore gosu manticore indexer --all --rotate

您还可以使用 Docker 环境变量设置单独的 searchd 和 common 配置项。

设置必须以其节名称为前缀，例如对于 mysql_version_string，变量名必须为 searchd_mysql_version_string：

docker run --name manticore  -p 127.0.0.1:9306:9306  -e searchd_mysql_version_string='5.5.0' -d manticoresearch/manticore

对于 listen 指令，使用 Docker 变量 searchd_listen 可以在默认监听接口之外添加新的监听接口。可以声明多个接口，用分号 ("|") 分隔。要仅监听网络地址，可以使用 $ip（内部通过 hostname -i 获取）作为地址别名。

例如，-e searchd_listen='9316:http|9307:mysql|$ip:5443:mysql_vip' 将在默认的 9306 和 9308 端口之外，额外添加一个 9307 端口的 SQL 接口，一个仅在实例 IP 上运行的 5443 端口的 SQL VIP 监听器，以及一个 9316 端口的 HTTP 监听器。

$ docker run --rm -p 1188:9307  -e searchd_mysql_version_string='5.5.0' -e searchd_listen='9316:http|9307:mysql|$ip:5443:mysql_vip'  manticore
[Mon Aug 17 07:31:58.719 2020] [1] using config file '/etc/manticoresearch/manticore.conf' (9130 chars)...
listening on all interfaces for http, port=9316
listening on all interfaces for mysql, port=9307
listening on 172.17.0.17:5443 for VIP mysql
listening on all interfaces for mysql, port=9306
listening on UNIX socket /var/run/mysqld/mysqld.sock
listening on 172.17.0.17:9312 for sphinx
listening on all interfaces for http, port=9308
prereading 0 indexes
prereaded 0 indexes in 0.000 sec
accepting connections

要使用自定义启动标志启动 Manticore，请在使用 docker run 时将它们作为参数指定。确保不要包含 searchd 命令，并包含 --nodetach 标志。示例如下：

docker run --name manticore --rm manticoresearch/manticore:latest --replay-flags=ignore-trx-errors --nodetach

默认情况下，主 Manticore 进程 searchd 在容器内以用户 manticore 运行，但启动容器时运行的脚本是以您的默认 docker 用户身份运行的，在大多数情况下是 root。如果这不是您想要的，可以使用 docker ... --user manticore 或在 docker compose yaml 中使用 user: manticore 使所有内容都以 manticore 用户身份运行。下面会介绍您可能遇到的卷权限问题及其解决方法。

要构建自定义配置文件中指定的普通表，可以使用环境变量 CREATE_PLAIN_TABLES=1。它将在 Manticore 启动前执行 indexer --all。如果您不使用卷，并且表容易重新创建，这非常有用。

docker run -e CREATE_PLAIN_TABLES=1 --name manticore -v $(pwd)/manticore.conf:/etc/manticoresearch/manticore.conf -p 9306:9306 -p 9308:9308 -d manticoresearch/manticore

如果您以非 root 用户运行 Manticore Search docker（使用 docker ... --user manticore 或在 docker compose yaml 中使用 user: manticore），可能会遇到权限问题，例如：

FATAL: directory /var/lib/manticore write error: failed to open /var/lib/manticore/tmp: Permission denied

这是因为用于在容器内运行进程的用户可能没有权限修改您挂载到容器的目录。为了解决此问题，您可以对挂载目录执行 chown 或 chmod。如果您以用户 manticore 运行容器，需要执行：

chown -R 999:999 data

因为容器内用户 manticore 的 ID 是 999。

在 Windows 上，如果您希望 Manticore 在启动时自动运行，可以将其安装为 Windows 服务。您可以按照 Manticore 作为 Windows 服务 指南中的说明将 Manticore 安装为服务。

一旦 Manticore 被安装为服务，您可以通过控制面板或使用 sc.exe 命令从命令行启动和停止它。

sc.exe start Manticore

sc.exe stop Manticore

或者，如果您没有将 Manticore 安装为 Windows 服务，可以通过运行以下命令从命令行启动它：

.\bin\searchd -c manticore.conf

此命令假设您已将 Manticore 的二进制文件和配置文件放在当前目录中。

如果使用 HomeBrew 安装了 Manticore，可以将其作为 Brew 服务运行。

要启动 Manticore，请运行以下命令：

brew services start manticoresearch

要停止 Manticore，请运行以下命令：

brew services stop manticoresearch

Manticore Search 提供了多种创建表格的方法，每种方法针对不同的用例和需求设计。本节涵盖主要的方法及其具体配置。

Manticore 支持不同类型的表格：

• 实时表 - 用于实时更新和即时搜索
• 普通表 - 用于不需要频繁更新的静态数据
• Percolate 表 - 用于存储和匹配搜索查询
• 模板表 - 用于创建表格模板
• 分布式表 - 用于跨多个节点扩展

创建表格时，您需要考虑：

1. 数据类型 - 了解可用的数据类型及其存储选项
2. NLP 和分词 - 配置文本数据的处理和索引方式
3. 表结构 - 定义特定用例的模式和设置

要创建表格，您需要：

1. 为您的用例选择合适的表格类型
2. 定义包含所需字段和属性的表格模式
3. 配置满足特定需求的必要设置

有关每个方面的详细信息，请参阅以下章节：

• 数据类型 - 了解支持的数据类型和存储选项
• 创建本地表 - 创建不同类型本地表的详细指南
• NLP 和分词 - 配置文本处理和索引
• 创建分布式表 - 设置分布式表以实现扩展

这些章节分别提供了关于 Manticore Search 中表格创建各个具体方面的深入信息。