Docker部署Vespa应用后查询服务无法就绪问题求助

部署环境与问题描述 #

我通过Docker部署了包含以下Schema的Vespa应用：

schema bert_search {
    document bert_search {

        field title type string {
            indexing: attribute | summary
        }
        field hash type string {
            indexing: attribute | index
        }
        field plain_text type string {
            indexing: summary | index
            index: enable-bm25
        }
        field text_embedding type tensor<int8>(x[128]) {
            indexing: attribute | index
            attribute {
                distance-metric: angular
            }
            index {
                hnsw {
                    max-links-per-node: 16
                    neighbors-to-explore-at-insert: 500
                }
            }
        }
    }

    fieldset default {
        fields: plain_text
    }
    rank-profile similaritembedding_y inherits default { 
        first-phase {
            expression: closeness(text_embedding)
        }
    }
    rank-profile bm25 inherits default {
        first-phase {
            expression: bm25(plain_text)
        }
    }
    rank-profile bm25-embedding-similarity inherits default {
        first-phase {
            expression: bm25(plain_text) + closeness(text_embedding)
        }
    }
}

部署完成后可正常导入数据，但无法执行查询操作。Vespa容器内日志如下：

runserver(configserver) running with pid: 26
1688376323.746318       43dbbea6e5d1    28      -       vespa-start-services    info    Too low vm.max_map_count [65530] - trying to increase it to 262144
1688376323.746327       43dbbea6e5d1    28      -       vespa-start-services    warning Could not increase vm.max_map_count - current value [65530] too low, should be at least 262144
Starting config proxy using tcp/43dbbea6e5d1:19070 as config source(s)
Waiting for config proxy to start
`runserver(configproxy)` running with pid: 89
1688376325.143058       43dbbea6e5d1    28      -       start-services  warning Could not ping configproxy: exit status 1
config proxy started after 1s (runserver pid 89)
runserver(config-sentinel) running with pid: 266
Deploying. Waiting for Vespa to start 60...

Success: Deployed .

Waiting up to 1m0s for query service to become available ...

日志中最后一行“等待查询服务就绪”持续运行超一分钟无反馈，另一台配置相近的机器部署相同应用无此问题，已排除资源不足，询问是否是防火墙导致的问题？

机器配置信息：

System: Debian 11
RAM: 32GB
CPU: 11th Gen Intel(R) Core(TM) i7-11700K @ 3.60GHz 
GPU: RTX 3080

问题分析与解决建议 #

1. 优先解决vm.max_map_count过低问题 #

日志明确警告vm.max_map_count值（65530）远低于Vespa要求的最小值262144，这会导致Vespa的索引服务（尤其是HNW向量索引）无法正常初始化，即使能导入数据，查询服务也无法就绪。

执行以下操作调整参数：

• 临时生效：

sysctl -w vm.max_map_count=262144

• 永久生效（重启后保留）：
  编辑/etc/sysctl.conf文件，添加一行：

vm.max_map_count=262144

执行sysctl -p使配置立即生效，或重启机器。

2. 防火墙是潜在的故障原因 #

如果调整完内存映射参数后问题仍存在，防火墙配置需要重点排查：

• 宿主机防火墙：检查ufw/iptables是否开放了Vespa所需端口。默认查询端口是8080，同时Vespa内部组件通信需要19070、19090等端口，确保这些端口的TCP流量被允许。
  • 检查ufw状态：ufw status
  • 开放查询端口：ufw allow 8080/tcp
• Docker网络策略：Docker的iptables规则可能阻止容器内部或容器与宿主机的通信。可以尝试重启Docker服务：systemctl restart docker，或检查iptables -L确认没有拦截Vespa相关流量。
• 容器网络模式：若使用host模式，需确保宿主机防火墙开放所有Vespa端口；若使用桥接模式，确认端口映射正确，且桥接网络无通信限制。

3. 容器内部连通性测试 #

进入Vespa容器内部，执行curl http://localhost:8080，若无法连通，说明容器内部服务未正常启动；若能连通，则问题出在宿主机到容器的网络路径上（如防火墙端口未开放）。

内容的提问来源于stack exchange，提问作者Daniel Jankowski