在Kubernetes中为TandoorRecipes配置子路径访问的最佳实践

背景介绍

TandoorRecipes是一款流行的开源食谱管理应用，许多用户选择将其部署在Kubernetes集群中。当需要在同一域名下通过不同路径访问多个应用时（如example.com/tandoor），正确的配置尤为重要。

核心配置要点

1. 环境变量设置

在Kubernetes部署文件中，必须设置SCRIPT_NAME环境变量来指定应用的基础路径：

env:
  - name: SCRIPT_NAME
    value: /tandoor

这个变量告诉Django应用它应该处理的所有URL都以/tandoor开头。

2. Ingress控制器配置

对于Nginx Ingress控制器，需要添加特定的注解来处理路径重写和cookie路径：

annotations:
  nginx.ingress.kubernetes.io/configuration-snippet: |
    proxy_set_header X-Script-Name /tandoor;
    proxy_cookie_path / /tandoor;

3. 完整的Ingress示例

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: tandoor-ingress
  annotations:
    nginx.ingress.kubernetes.io/configuration-snippet: |
      proxy_set_header X-Script-Name /tandoor;
      proxy_cookie_path / /tandoor;
spec:
  rules:
  - host: my-website.de
    http:
      paths:
      - path: /tandoor
        pathType: Prefix
        backend:
          service:
            name: recipes
            port:
              number: 8080

常见问题解决方案

1. 静态文件404错误：确保静态文件和媒体文件也有正确的路径前缀配置。

2. 重定向问题：如果点击链接后跳转到根路径，检查SCRIPT_NAME是否设置正确。

3. Cookie路径问题：确保proxy_cookie_path配置正确，否则可能导致会话丢失。

进阶建议

1. 考虑使用ConfigMap来管理这些配置，而不是直接写在Deployment中。

2. 对于生产环境，建议添加适当的资源限制和健康检查。

3. 定期检查TandoorRecipes的更新，获取最新的Kubernetes部署最佳实践。

通过以上配置，用户可以成功地将TandoorRecipes部署在Kubernetes集群的子路径下，实现多应用共享同一域名的需求。