Skip to content

docs(deployment): document multi-cloud object storage for langfuse and drop minio references - #329

Open
pavlochaikivskyi wants to merge 8 commits into
mainfrom
EPMCDME-10609
Open

docs(deployment): document multi-cloud object storage for langfuse and drop minio references#329
pavlochaikivskyi wants to merge 8 commits into
mainfrom
EPMCDME-10609

Conversation

@pavlochaikivskyi

Copy link
Copy Markdown
Collaborator

Summary

  • Replaces the bundled-MinIO langfuse-s3 secret/example with the langfuse-object-storage secret shape (AWS S3 / Azure Blob / GCS).
  • Adds a dedicated Object Storage step to the deployment prerequisites guide.
  • Updates the system requirements table (and architecture diagram) to show object storage as an external, client-provided resource instead of an in-cluster MinIO deployment.

Test plan

  • npm run lint / npm run typecheck pass
  • Docs render correctly with updated table and architecture diagram

@github-actions

Copy link
Copy Markdown

PR Preview Ready!

Your preview documentation is ready! Visit it here:

Preview URL: http://codemie-docs-pr-previews.s3-website.eu-central-1.amazonaws.com/pr-329/


This preview will be automatically updated when you push new commits to this PR.
Preview files will be deleted when the PR is closed or merged.

pavlochaikivskyi and others added 7 commits July 24, 2026 15:38
Expands the Object Storage step to cover IRSA as the recommended EKS auth
method, with a note that IRSA is not supported by Langfuse for Azure Blob
or GCS (static credentials required for those providers).
…d drop minio references

Co-Authored-By: Claude <noreply@anthropic.com>
Add dedicated GCS Workload Identity section to deployment-prerequisites,
replacing the incorrect "static credentials required" claim. Separate
Azure and GCS (non-GKE) static-creds paths into their own sections.
Update manual-deployment secret comment to clarify WI skips the secret.

Co-Authored-By: Claude <noreply@anthropic.com>
…ent script

Add GKE Workload Identity as a skip path for the object storage secret
prompt, alongside IRSA. Clarify GCS static-creds as non-GKE fallback.

Co-Authored-By: Claude <noreply@anthropic.com>
…on gke

Remove the incorrect "static credentials required" claim for GCS.
Document Workload Identity as the recommended path on GKE, with
static service-account JSON as the non-GKE fallback.

Co-Authored-By: Claude <noreply@anthropic.com>

- **AWS EKS with IRSA** (recommended): type `y`. The pod's IAM role grants S3 access; no secret is needed. Verify that `langfuse.langfuse.serviceAccount.annotations` in `values.yaml` contains the correct IRSA role ARN (output `LANGFUSE_AWS_ROLE_ARN` from `deployment_outputs.env`).
- **GKE with Workload Identity** (recommended for GCS): type `y`. The pod's GCP service account grants GCS access; no secret is needed. Verify that `langfuse.langfuse.serviceAccount.annotations` in `values.yaml` contains the correct `iam.gke.io/gcp-service-account` annotation and `s3.gcs.credentials: {}` is set.
- **Azure Blob Storage**: type `N`. Enter the Storage Account name as the access key ID and the Storage Account key as the secret.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you add an explanation about why N is required for Azure. It's not clear at all. Also such type of instructions of "what to type" I would avoid. It would be better to rephrase at all this statements explaining exactly what happened and why instead of directing user what to type.

storageProvider: "gcs"
bucket: "your-bucket-name"
gcs:
credentials: {} # empty → uses Workload Identity / ADC

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is ADC?

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