Nextended.Aspire.Hosting.Supabase
📚 Vollständige API-Referenz — jeder öffentliche Typ und Member, erzeugt aus der kompilierten Assembly.
Der komplette Supabase-Stack — Postgres, Auth (GoTrue), REST, Realtime, Storage, Studio, Kong und Edge Functions — als eine kombinierbare Aspire-Ressource.
Installation
dotnet add package Nextended.Aspire.Hosting.SupabaseWas das Paket macht
Der komplette Supabase-Stack — Postgres, Auth (GoTrue), REST, Realtime, Storage, Studio, Kong und Edge Functions — als eine kombinierbare Aspire-Ressource.
Die vollständige Referenz — alle Typen, Builder, Optionen und ausführlich kommentierte Codebeispiele — steht auf der englischen Seite:
📖 Nextended.Aspire.Hosting.Supabase — vollständige Referenz (englisch) Ebenso ausführlich und ebenfalls englisch ist das Paket-README:
📄 Nextended.Aspire.Hosting.Supabase/README.md
Auf Azure Container Apps lassen sich auch Datenbank und Dateien dauerhaft halten (NFS + MinIO) und der Observability-Stack mitdeployen: Grafana speichert seinen Zustand in einer eigenen Datenbank grafana der Supabase-Postgres und liest über das Nur-Lese-Login grafana_reader, Loki und Tempo speichern in die MinIO-Buckets loki und tempo, angemeldet wird mit eigenem Admin-Login oder per Entra ID. Details in der englischen Referenz.
Anmeldung über die eigenen Konten: WithOAuthServer() macht Supabase Auth zum OAuth-2.1-Anbieter, AddOAuthClient(…) registriert Clients (öffentlich, PKCE, feste Client-ID), WithCustomAccessTokenHook() ergänzt Claims wie Rechte. Studio meldet sich damit statt per Basic Auth an (WithSupabaseLogin(claim, value), oder über Keycloak: WithOAuthLogin(StudioOAuthOptions.Keycloak(…))), Grafana mit grafana.WithSupabaseLogin(supabase, …). Für die App selbst gibt es fremde Anbieter: WithKeycloak(…), WithExternalProvider("github", …). Details in der englischen Referenz.
Datenbank-Sicherungen: WithDatabaseBackups(…) hängt einen Backup-Dienst an den Stack (<stack>-backup) — das Postgres-Image des Stacks selbst (pg_dump passt immer zum Server) mit einem eingebetteten Python-Skript, ohne eigenes Image, lokal wie auf Azure Container Apps. Er sichert täglich zur eingestellten Uhrzeit die Datenbank (die Schemas der App, nicht die internen von Supabase) und die gespeicherten Dateien in den Storage des Stacks (Bucket db-backups) und auf Wunsch zusätzlich nach Azure Blob (AddAzureBlobTarget) oder S3 (AddS3Target), mit Aufbewahrung nach Tagen und Wochen. Wiederherstellen macht zuerst eine Sicherheits-Sicherung und spielt dann die Daten in einer Transaktion in das aktuelle Schema zurück — ganz oder gar nicht. Sicherungen auf einem externen Ziel findet der Dienst auch in einer frischen Datenbank wieder. Einstellungen, Liste und API liegen im Schema nx_backup; die App bietet sie über eigene Funktionen mit ihrer Admin-Prüfung an. Details in der englischen Referenz.
Secrets (JWT-Secret, Keys, DB-, MinIO- und Admin-Passwort) lassen sich als Aspire-Parameter übergeben (builder.AddParameter(..., secret: true)). Lokal werden sie aus der Konfiguration aufgelöst; deployed bleiben sie Referenzen und landen als Container-App-Secrets in den Containern, nie als Klartext in Manifest oder Bicep.
Ausführbares Beispiel
Im Repository liegt ein vollständiger, startbarer AppHost:
git clone https://github.com/fgilde/Nextended.git
cd Nextended/Tests/TestProjects/Supabase.AppHost
dotnet runUnterstützte Frameworks
net10.0(Aspire 17 gibt es nur für .NET 10; die Nextended-Versionen auf Aspire 13 zielen auch aufnet8.0undnet9.0)
Plattform
Cross-platform
Abhängigkeiten
- Nextended.Aspire
- Nextended.Aspire.Hosting.Grafana
- Aspire.Hosting.PostgreSQL
Links
Lizenz
MIT — siehe LICENSE.