如何在K8s集群部署Tika服务时加载自定义XML配置文件

和Docker运行时挂载本地配置+传入启动参数的逻辑完全对应，只需要完成三个核心配置即可实现同等效果：

• 将本地自定义的tika-config.xml存储为K8s ConfigMap资源，作为配置文件的载体
• 在Deployment中声明存储卷，将ConfigMap中的配置文件挂载到容器内的/tika-config.xml路径，替代Docker的-v挂载行为
• 给Tika容器添加启动参数，指定配置文件路径，和Docker启动时传入的--config参数保持一致

操作步骤 #

1. 创建ConfigMap
   在你本地存放tika-config.xml的目录下执行如下命令，将配置文件导入K8s集群：

kubectl create configmap tika-config --from-file=tika-config.xml=./tika-config.xml

如果配置中包含密钥类敏感信息，可将ConfigMap替换为Secret资源，挂载逻辑完全一致

2. 修改Deployment配置
   调整后的完整可用Deployment YAML如下，基于你提供的2.4.0版本镜像配置修改：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: tika
  labels:
    app: tika
spec:
  replicas: 1
  selector:
    matchLabels:
      app: tika
  template:
    metadata:
      labels:
        app: tika
    spec:
      containers:
        - name: tika
          image: apache/tika:2.4.0
          ports:
            - containerPort: 9998
          # 挂载配置文件到容器内指定路径
          volumeMounts:
            - name: tika-config-volume
              mountPath: /tika-config.xml
              subPath: tika-config.xml
          # 传入启动参数指定配置文件位置
          args:
            - "--config"
            - "/tika-config.xml"
      # 关联提前创建的ConfigMap作为存储卷
      volumes:
        - name: tika-config-volume
          configMap:
            name: tika-config

常见踩坑说明 #

• 挂载单个配置文件时必须添加subPath字段，否则会将容器内的对应路径覆盖为目录，导致Tika无法识别配置文件
• Tika 2.x版本镜像完全兼容1.x版本的--config启动参数，不需要调整配置文件格式或参数写法
• 后续更新配置时，只需要修改ConfigMap中的文件内容，重启对应Tika Pod即可加载新配置，不需要重新构建镜像
• 配置加载逻辑和Service暴露方式无关，后续如需对外提供服务，正常创建9998端口对应的Service即可

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