Skip to content

Nextended.Aspire.Hosting.Supabase ​

📚 Vollständige API-Referenz — jeder öffentliche Typ und Member, erzeugt aus der kompilierten Assembly.

🇬🇧 This page in English

Der komplette Supabase-Stack — Postgres, Auth (GoTrue), REST, Realtime, Storage, Studio, Kong und Edge Functions — als eine kombinierbare Aspire-Ressource. NuGet


Installation ​

bash
dotnet add package Nextended.Aspire.Hosting.Supabase

Was 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:

Supabase.AppHost

bash
git clone https://github.com/fgilde/Nextended.git
cd Nextended/Tests/TestProjects/Supabase.AppHost
dotnet run

Unterstützte Frameworks ​

  • net10.0 (Aspire 17 gibt es nur für .NET 10; die Nextended-Versionen auf Aspire 13 zielen auch auf net8.0 und net9.0)

Plattform ​

Cross-platform

Abhängigkeiten ​

  • Nextended.Aspire
  • Nextended.Aspire.Hosting.Grafana
  • Aspire.Hosting.PostgreSQL

Lizenz ​

MIT — siehe LICENSE.