多Docker容器部署Vespa时应用提交失败问题

结合你描述的跨主机部署Vespa Docker集群、提交应用时准备会话失败的场景，我整理了一套针对性的排查和修复步骤：

1. 先确认节点间的网络连通性 #

跨主机集群的核心前提是两个Vespa节点能互相通信，这也是最容易出问题的环节：

• 分别进入两台机器的Vespa容器，测试对对方节点的连通性：

  # 在vespa1容器内执行
  ping vespa2
  telnet vespa2 19071  # 配置服务端口
  telnet vespa2 6380   # Vespa内部通信端口
  

  同理在vespa2容器内测试连通vespa1，如果任何一步失败，说明网络存在障碍。
• 检查Docker网络模式：如果用默认桥接网络，跨主机容器无法直接通过主机名通信，建议改用--network host模式启动容器，或者创建跨主机的Docker overlay网络；如果坚持用桥接，启动容器时必须通过--add-host参数手动添加节点解析：

  # 以vespa1为例，替换<vespa2-ip>为第二台机器的实际IP
  docker run -d --hostname vespa1 --name vespa1 -p 19071:19071 --add-host vespa2:<vespa2-ip> vespaengine/vespa
  

2. 验证应用包的services.xml配置 #

确保你的应用配置文件正确指定了集群节点，尤其是configserver的配置（双节点集群建议把两个节点都配置为configserver）：

<services version="1.0">
    <admin version="2.0">
        <configservers>
            <node hostalias="vespa1"/>
            <node hostalias="vespa2"/>
        </configservers>
        <clustercontroller/>
    </admin>
    <!-- 容器和内容集群配置按需调整 -->
    <container id="container" version="1.0">
        <nodes>
            <node hostalias="vespa1"/>
            <node hostalias="vespa2"/>
        </nodes>
    </container>
    <content id="my-content" version="1.0">
        <redundancy>2</redundancy>
        <documents>
            <document type="my-document" mode="index"/>
        </documents>
        <nodes>
            <node hostalias="vespa1"/>
            <node hostalias="vespa2"/>
        </nodes>
    </content>
</services>

注意hostalias要和你/etc/hosts里配置的vespa1、vespa2完全一致。

3. 检查Docker容器的启动参数 #

启动Vespa容器时，必须指定集群的configserver地址，否则节点无法加入集群：

# 启动vespa1容器
docker run -d --hostname vespa1 --name vespa1 --network host -e VESPA_CONFIGSERVERS=vespa1,vespa2 vespaengine/vespa

# 启动vespa2容器
docker run -d --hostname vespa2 --name vespa2 --network host -e VESPA_CONFIGSERVERS=vespa1,vespa2 vespaengine/vespa

这里用--network host让容器直接使用主机的网络和hosts解析，避免额外的端口映射和host配置问题。

4. 查看详细错误日志定位问题 #

如果前面的步骤都没问题，就需要查看Vespa的日志找具体错误：

• 进入容器查看配置服务的日志：

  docker exec -it vespa1 tail -f /var/log/vespa/configserver.log
  

  或者查看容器服务的日志：

  docker exec -it vespa1 tail -f /var/log/vespa/container.log
  

  日志里会包含准备会话失败的具体原因，比如节点无法连接、配置文件语法错误等。

5. 调整应用提交的目标地址 #

你当前是提交到http://localhost:19071，如果是在主机上执行提交命令，需要确保该端口已经映射到Vespa容器的19071端口；或者直接提交到configserver的实际地址，比如http://vespa1:19071（前提是主机能解析vespa1）。

内容的提问来源于stack exchange，提问作者aman.gupta