使用Helm Chart部署JIRA Data Center后共享主目录配置不生效问题

以下是针对该问题的排查与解决步骤：

• 确认Helm Values配置完整性
  确保sharedHome区块的配置未被意外覆盖：

  • 检查sharedHome.create确实设为true
  • 确认sharedHome.path配置为/var/atlassian/application-data/shared-home（默认值，但需排查是否被自定义values覆盖）
  • 排查是否存在additionalEnvironmentVariables或jiraConfig配置，手动设置了jira.shared.home系统属性导致冲突

• 验证Pod的挂载与环境变量

  • 执行命令确认环境变量值：

    kubectl exec <你的JIRA Pod名称> -- env | grep JIRA_SHARED_HOME
    

    确保输出为期望的/var/atlassian/application-data/shared-home
  • 检查Pod卷挂载状态：

    kubectl describe pod <你的JIRA Pod名称>
    

    确认EFS对应的PersistentVolume已正确挂载到/var/atlassian/application-data/shared-home，且挂载目录权限为JIRA运行用户（通常为jira）可读写

• 检查JIRA启动参数
  JIRA Data Center依赖-Djira.shared.home系统属性识别共享目录，而非仅环境变量：

  • 查看Pod启动命令中的JVM参数，确认是否包含该属性且值正确：

    kubectl exec <你的JIRA Pod名称> -- cat /opt/atlassian/jira/bin/setenv.sh | grep jira.shared.home
    

  • 若参数缺失或错误，尝试重新部署Helm release：

    helm upgrade <你的Helm Release名称> atlassian-data-center/jira -f <你的values配置文件>
    

• 排查JIRA本地配置文件
  进入Pod查看jira-config.properties文件（路径通常为/var/atlassian/application-data/jira/jira-config.properties）：

  • 若文件中存在jira.shared.home配置项，且值为/var/atlassian/application-data/jira，则会覆盖启动参数与环境变量，需删除该配置项或修改为正确路径后重启Pod

• 确认EFS访问点配置
  检查AWS EFS访问点的根目录设置，确保其与Kubernetes中PVC的挂载路径匹配，避免因路径不对应导致共享目录无法正常识别

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