Skip to content

Conversation

@a-klos
Copy link
Member

@a-klos a-klos commented Nov 27, 2025

This pull request refactors secret management and environment variable handling across the local development and deployment workflow, focusing on improving flexibility and security. The changes standardize secret references, introduce dev-only helpers for Langfuse initialization, and update documentation and templates to reflect the new structure. The most important changes are grouped below:

Secret Management Refactor

  • Secrets for basic authentication, Langfuse, S3, STACKIT, and RAGAS are now split into individual username/password or API key fields with support for referencing Kubernetes secrets via secretKeyRef in values.yaml and Helm templates. This enables easier integration with external secret managers and more granular secret configuration. (.env.template, Tiltfile, infrastructure/README.md, README.md, [1] [2] [3] [4] [5] [6] [7] F9cc2a25L27R29)
  • Helm templates now use new helper functions to resolve secret names, preferring secretKeyRef.name when set, and falling back to default names. This affects backend/admin deployments and ingress authentication. (infrastructure/rag/templates/_admin_backend_and_extractor_helpers.tpl, infrastructure/rag/templates/_backend_helpers.tpl, [1] [2] [3] [4] [5]

Langfuse Dev-Only Helper

  • Added a dev-only workflow for Langfuse initialization secrets using Kustomize and Tilt: developers can fill out a .env.langfuse file, which is used to generate a stable Kubernetes secret for local development. Documentation and Tiltfile logic were updated to support this workflow. (infrastructure/kustomize/langfuse/.env.langfuse.template, infrastructure/kustomize/langfuse/kustomization.yaml, Tiltfile, README.md, infrastructure/README.md, [1] [2] [3] [4] [5]

Documentation Updates

  • Updated README.md and infrastructure/README.md to reflect the new environment variable and secret structure, clarify dev/prod secret management, and provide step-by-step instructions for local setup and deployment. (README.md, infrastructure/README.md, [1] [2] [3] [4] [5] [6]

Configuration and Template Changes

  • Updated Helm values and templates to match the new secret structure, including support for referencing secrets and setting inline values for all major providers (basic auth, Langfuse, S3, STACKIT, RAGAS). (infrastructure/README.md, infrastructure/rag/templates/_admin_backend_and_extractor_helpers.tpl, infrastructure/rag/templates/_backend_helpers.tpl, [1] [2]

Minor Improvements

  • Added new environment variables for evaluation settings and improved example values for clarity in documentation. (infrastructure/README.md, infrastructure/README.mdL313-R353)

Let me know if you need more details about any specific change or how these updates affect your workflow!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants