Ugrás a fő tartalomra

Supabase beállítása a Docker Desktop segítségével

Ha még nem ismeri az önálló tárhelyszolgáltatást, vagy egyszerű, vizuális beállítást szeretne, a Docker Desktop a legegyszerűbb módja a Supabase helyi futtatásának. Grafikus felületet biztosít a konténerek kezeléséhez, a portok konfigurálásához és az adatok újraindítás utáni megőrzéséhez – parancssori munkára nincs szükség.

1. lépés: Telepítse a Docker Desktopot

       Töltse le a Docker Desktopot az operációs rendszeréhez.

       Telepítse a telepítő utasításait követve.

       Windows-felhasználók: Engedélyezze a WSL2-t a telepítés során, és indítsa újra a rendszert, ha a rendszer kéri.

       Nyissa meg a Docker Desktop alkalmazást, és ellenőrizze, hogy fut-e. A tálcán vagy a menüsoron megjelenik a Docker bálna ikonja.

embedded-image-cfhyjc6h.png

2. lépés: Készítsen elő egy mappát az adatok számára

       A Supabase az adatokat (PostgreSQL adatbázis, fájlfeltöltések) kötetekben tárolja. Az adatok állandóságának biztosítása érdekében:

       macOS / Linux: ~/supabase-data

       Windows: C:\supabase-data

embedded-image-z4mbjjs1.png

Ez a mappa biztosítja az adatok biztonságát akkor is, ha eltávolítja vagy frissíti a konténereket.

3. lépés: Hozza be a hivatalos Supabase-képeket

A Supabase több Docker-képet használ szolgáltatásaihoz: PostgreSQL, Auth, Realtime, Storage, API és Studio. Ezeket közvetlenül a Docker Desktopban töltheti le:

  1. Nyissa meg a Docker Desktopot, és lépjen az Images fülre.
  2. A keresősávba írja be a hivatalos képneveket:

       supabase/postgres

       supabase/gotrue

       supabase/realtime

       supabase/storage-api

       supabase/postgrest

       supabase/studio

  1. Kattintson az egyes képek Pull gombjára, hogy letöltse azokat a gépre. Ismételje meg az összes képnél.

embedded-image-dklw5adu.png

4. lépés: Konténerek létrehozása az egyes szolgáltatásokhoz

A képek letöltése után létre kell hoznia egy konténert az egyes szolgáltatásokhoz:

  1. Lépjen a Docker Desktop Containers/Apps (Konténerek/Alkalmazások) fülére, és kattintson a + Add Container (Konténer hozzáadása) gombra.
  2. Válassza ki az imént letöltött képet.
  3. Konfigurálja az egyes konténerek beállításait:

       Név: Adjon neki értelmes nevet (pl. supabase_postgres, supabase_auth).

       Portok: Térképezze fel a konténer portjait a gazdagép portjaira:

       PostgreSQL: 5432

       Supabase Studio: 3000

       Az egyéb szolgáltatások az alapértelmezett portokat használják (ellenőrizze az egyes szolgáltatások dokumentációját).

       Kötet: A tartós tárolás érdekében kösse össze a gazdagép mappáját a konténerrel:

       Példa: ~/supabase-data → /var/lib/postgresql/data a PostgreSQL esetében

       Környezeti változók: Állítsa be a szükséges kulcsokat:

       POSTGRES_PASSWORD, JWT_SECRET, ANON_KEY, SERVICE_ROLE_KEY

       Újraindítási szabály: Mindig vagy csak leállítás esetén

  1. Kattintson a Run (Futtatás) gombra a konténer elindításához. Ismételje meg az összes Supabase szolgáltatás esetében.

embedded-image-qtll77cb.png

5. lépés: Hozzáférés a Supabase Studiohoz

       Miután az összes konténer elindult, nyissa meg a böngészőjét, és lépjen a következő oldalra:

       http://localhost:3000

       Most már teljes hozzáférése van a Supabase Studiohoz, és vizuálisan kezelheti az adatbázisát, a hitelesítést és a tárolást.

embedded-image-zbcuglwy.png

6. lépés: A Supabase frissítése

Amikor új Supabase-kiadások érhetők el:

  1. Állítsa le és távolítsa el a konténereket a Docker Desktop segítségével.
  2. Töltse le a frissített képeket (Képek fül → Letöltés).
  3. Hozza létre újra a konténereket ugyanazokkal a beállításokkal és kötet-hozzárendelésekkel.

Mivel az adatok állandó kötetekben vannak tárolva, a frissítések során biztonságban maradnak.

7. lépés: Karbantartás és felügyelet

       A Docker Desktop segítségével figyelemmel kísérheti az erőforrások használatát, a naplókat és a konténerek állapotát.

       Rendszeresen ellenőrizze a naplókat hibák szempontjából, és győződjön meg arról, hogy az adatmappájában elegendő lemezterület áll rendelkezésre. Termelési vagy hosszú távú helyi használat esetén fontolja meg a konténerek frissítésének automatizálását a Watchtower segítségével.