راه اندازی Supabase CLI و محیط محلی

فهرست مطالب

مزایا و محدودیت های توسعه محلی با Supabase

• supabase به ما امکان می دهد برای بازآفرینی یک محیط مجازی در رایانه محلی ما برای هر پروژه.

• ما می توانیم طرحواره پایگاه داده را فشار داده و اعمال کنیدبا سیاست های معتبروت تنظیمات دیگر در محیط محلی ما به محیط تولید از راه دور توسعه یافته است.

• Supabase دستوراتی را برای راه اندازی یک محیط محلی فراهم می کند و به ما امکان می دهد به سادگی این دستورات را برای ایجاد یک محیط مجازی در Docker اجرا کنیدبشر این دستورات هستند supabase cli!

پیش نیازهای

• node.js و NPM نصب شده است
• Docker نصب شده (محیط محلی Supabase به Docker متکی است)

مرحله 1: نصب Supabase CLI

1. دستور زیر را برای نصب Supabase CLI در سطح جهان اجرا کنید

هنگام استفاده از NPM

npm install -g supabase 

هنگام استفاده از Homebrew (MACOS)

brew install supabase/tap/supabase

1. نصب را با اجرا تأیید کنید

supabase --version
> 2.2.1

مرحله 2: ایجاد یک پروژه جدید Supabase

1. یک دایرکتوری جدید ایجاد کنید و به آن حرکت کنید

mkdir my-supabase-project  
cd my-supabase-project
supabase login  

1. یک پروژه supabase را آغاز کنید

supabase init

مرحله 3: شروع محیط محلی

1. اطمینان حاصل کنید که Docker در حال اجرا است
2. محیط محلی Supabase را با شروع کنید

supabase start  

1. پس از شروع ، ترمینال URL های محلی و جزئیات اتصال را به نمایش می گذارد

supabase start

Started supabase local development setup.

         API URL: http://127.0.0.1:54321
     GraphQL URL: http://127.0.0.1:54321/graphql/v1
  S3 Storage URL: http://127.0.0.1:54321/storage/v1/s3
          DB URL: postgresql://postgres:postgres@127.0.0.1:54322/postgres
      Studio URL: http://127.0.0.1:54323
    Inbucket URL: http://127.0.0.1:54324
      JWT secret: 
        anon key: 
service_role key: 
   S3 Access Key: 
   S3 Secret Key: 
       S3 Region: local

هنگامی که ما برای اولین بار محیط محلی را شروع می کنیم ، زمان لازم است تا تصاویر Docker بارگیری شود.

پس از اتمام تنظیم ، خدمات زیر برای استفاده در دسترس خواهد بود

• پایگاه داده postgresql
• سرویس احراز هویت (AUTH)
• سرویس ذخیره سازی
• سرور زمان واقعی

مرحله 4: دسترسی به استودیوی Supabase

در محیط محلی می توانیم دسترسی پیدا کنیم http://localhost:54323/project/default و استودیوی Supabase را ببینید.

مرحله 5: به برنامه متصل شوید

SUPABASE_URL=http://localhost:54321
SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...

این کار تنظیمات Supabase CLI و محیط Supabase محلی را تکمیل می کند!

سایر دستورات Supabase CLI

SUPBASE را متوقف کنید

supabase stop

تنظیم مجدد پایگاه داده supabase

supabase stop --no-backup

نمایش متغیرهای محیط محلی Supabase

supabase status

نمی توان به خطای Daommon Docker متصل شد

اگر Docker روی دستگاه محلی شما کار نمی کند ، هنگام اجرای خطای زیر را مشاهده خواهید کرد supabase start

supabase start

Cannot connect to the Docker daemon at unix:///Users/username/.docker/run/docker.sock. Is the docker daemon running?
  in github.com/supabase/cli/internal/utils.AssertDockerIsRunning:52
  in github.com/supabase/cli/internal/start.Run:38
Try rerunning the command with --debug to troubleshoot the error.