：本地跑通數(shù)據(jù)庫、函數(shù)和類型生成的完整鏈路)
Supabase CLI 實戰(zhàn)本地跑通數(shù)據(jù)庫、函數(shù)和類型生成的完整鏈路【免費下載鏈接】cliSupabase CLI. Manage postgres migrations, run Supabase locally, deploy edge functions. Postgres backups. Generating types from your database schema.項目地址: https://gitcode.com/GitHub_Trending/cli23/cliSupabase CLI 把 Supabase 平臺的能力搬進終端在你自己的機器上啟動完整的本地服務(wù)棧Postgres、Auth、Realtime、Storage 與 Edge Functions管理數(shù)據(jù)庫遷移部署邊緣函數(shù)并根據(jù)表結(jié)構(gòu)生成 TypeScript 類型。對想在本地寫完代碼再推送云端的開發(fā)者來說它就是連接本地工程與遠程項目的那座橋。什么情況下值得用 Supabase CLI你希望在沒有連網(wǎng)控制臺的情況下調(diào)試數(shù)據(jù)庫變更先在本地驗證遷移再上線。你需要把同一個工作區(qū)里的數(shù)據(jù)庫、函數(shù)、密鑰管理起來而不是各寫各的腳本。你在維護一個 TypeScript 項目希望數(shù)據(jù)庫表結(jié)構(gòu)變化時客戶端類型能跟著自動更新。多人協(xié)作時希望本地環(huán)境與線上項目通過supabase link關(guān)聯(lián)后保持一致。安裝前檢查依賴本地棧依賴容器運行時先確認兩點Docker Engine 已安裝并能正常運行docker ps不報錯。機器至少 7GB 可用內(nèi)存——啟動全部服務(wù)時官方給出的建議值。包管理方式任選其一npm 最為通用npm install -D supabasemacOS 和 Linux 也可以用 Homebrewbrew install supabase/tap/supabaseWindows 上可以用 Scoopscoop install supabase。裝完用supabase --version確認輸出版本號即可。初始化工作區(qū)并啟動本地服務(wù)棧在空目錄里執(zhí)行初始化會生成supabase/config.toml這個文件描述本地項目的全部配置supabase init supabase startstart會拉起 Postgres、Auth、Realtime、Storage、Edge Functions 等容器并自動做健康檢查。不想啟動某些服務(wù)時可以用-x排除比如-x gotrue,imgproxy。啟動完成后運行supabase status查看各項服務(wù)的狀態(tài)。如果項目已經(jīng)有supabase目錄結(jié)構(gòu)想看它到底生成了什么直接翻目錄即可config.toml之外migrations、functions、tests等目錄都掛在supabase/下。想從零腳手架一個帶模板的項目還可以直接跑supabase bootstrap它會替你搭好工作區(qū)骨架。用遷移管理一張用戶表建表這件事建議走遷移文件而不是手工連庫執(zhí)行 SQL。以創(chuàng)建profiles表為例supabase migration new create_profiles在supabase/migrations/下生成的 SQL 文件中寫入建表語句并順手打開行級安全create table public.profiles ( id uuid references auth.users primary key, full_name text, created_at timestamptz default now() ); alter table public.profiles enable row level security;然后讓本地庫跟上遷移supabase db resetdb reset會重建本地庫并按序應(yīng)用所有遷移和種子文件。遷移寫好后想對比本地與目標的差異用supabase db diff確認無誤再推送supabase db push。日常排查時supabase db --help能列出該子命令下所有可用的操作。創(chuàng)建、測試并部署一個 Edge Function函數(shù)是 TypeScript 寫的無服務(wù)器代碼運行在 Deno 兼容的邊緣運行時上冷啟動快、無需包管理。以hello-world為例supabase functions new hello-world這會生成函數(shù)目錄和入口文件。本地跑起來看看響應(yīng)是否符合預(yù)期supabase functions serve hello-world終端會輸出本地訪問地址用 curl 打一下確認能拿到 JSON 響應(yīng)。測試通過后部署到遠端supabase functions deploy hello-world如果函數(shù)需要環(huán)境變量部署時可以用--env-file指向一個.env文件避免把密鑰硬編碼進代碼。讓類型跟著數(shù)據(jù)庫走表結(jié)構(gòu)一變客戶端類型就過期這是最常見的隱性成本。Supabase CLI 可以直接從庫結(jié)構(gòu)反向生成類型supabase gen types --local database.types.ts--local從本地庫讀取結(jié)構(gòu)--linked則從關(guān)聯(lián)的遠程項目讀取。把生成的文件提交進倉庫supabase-js客戶端就能基于它做完整的類型檢查。關(guān)聯(lián)遠程項目并推送變更本地開發(fā)收斂后把改動帶上線分三步supabase login supabase link --project-ref 你的項目ref supabase db pushlogin需要個人訪問令牌憑證會存進系統(tǒng)鑰匙串不可用時寫到本地配置文件。CI 環(huán)境里可以跳過登錄直接用SUPABASE_ACCESS_TOKEN環(huán)境變量注入。link之后push、gen types --linked這類命令就知道該操作哪個項目。函數(shù)部署同理走supabase functions deploy即可。常見卡點排查supabase start卡住或超時首次運行要拉取多個鏡像耐心等待若健康檢查失敗先看 Docker 是否正常運行必要時supabase stop后重試也可臨時用--ignore-health-check跳過檢查排查。內(nèi)存不足導(dǎo)致容器反復(fù)重啟全部服務(wù)對內(nèi)存不友好用-x排除掉你暫時用不到的服務(wù)如imgproxy能明顯緩解。db reset后數(shù)據(jù)全沒了這是預(yù)期行為——它會重建本地庫。想保留某些數(shù)據(jù)先supabase db dump導(dǎo)出再重置后導(dǎo)入回去。找不到項目 ref 或權(quán)限不足ref 在控制臺的項目設(shè)置頁可以復(fù)制令牌權(quán)限不夠時回到賬戶的令牌管理頁重新生成。不知道某條命令有哪些參數(shù)任何子命令加--help都能列出參數(shù)與示例比如supabase functions deploy --help。接下來可以看什么倉庫內(nèi)的文檔目錄值得一讀apps/cli/docs/下按子命令拆分了start.md、status.md、functions.md等說明能覆蓋命令行手冊里的大部分細節(jié)。想深入本地棧的架構(gòu)可以參考packages/stack的源碼和packages/config中關(guān)于配置 schema 的定義。把init → start → migration → functions deploy → gen types這條鏈路跑通之后剩下的就是按你項目的節(jié)奏迭代了?！久赓M下載鏈接】cliSupabase CLI. Manage postgres migrations, run Supabase locally, deploy edge functions. Postgres backups. Generating types from your database schema.項目地址: https://gitcode.com/GitHub_Trending/cli23/cli創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Supabase CLI 實戰(zhàn)：本地跑通數(shù)據(jù)庫、函數(shù)和類型生成的完整鏈路
Supabase CLI 實戰(zhàn)本地跑通數(shù)據(jù)庫、函數(shù)和類型生成的完整鏈路【免費下載鏈接】cliSupabase CLI. Manage postgres migrations, run Supabase locally, deploy edge functions. Postgres backups. Generating types from your database schema.項目地址: https://gitcode.com/GitHub_Trending/cli23/cliSupabase CLI 把 Supabase 平臺的能力搬進終端在你自己的機器上啟動完整的本地服務(wù)棧Postgres、Auth、Realtime、Storage 與 Edge Functions管理數(shù)據(jù)庫遷移部署邊緣函數(shù)并根據(jù)表結(jié)構(gòu)生成 TypeScript 類型。對想在本地寫完代碼再推送云端的開發(fā)者來說它就是連接本地工程與遠程項目的那座橋。什么情況下值得用 Supabase CLI你希望在沒有連網(wǎng)控制臺的情況下調(diào)試數(shù)據(jù)庫變更先在本地驗證遷移再上線。你需要把同一個工作區(qū)里的數(shù)據(jù)庫、函數(shù)、密鑰管理起來而不是各寫各的腳本。你在維護一個 TypeScript 項目希望數(shù)據(jù)庫表結(jié)構(gòu)變化時客戶端類型能跟著自動更新。多人協(xié)作時希望本地環(huán)境與線上項目通過supabase link關(guān)聯(lián)后保持一致。安裝前檢查依賴本地棧依賴容器運行時先確認兩點Docker Engine 已安裝并能正常運行docker ps不報錯。機器至少 7GB 可用內(nèi)存——啟動全部服務(wù)時官方給出的建議值。包管理方式任選其一npm 最為通用npm install -D supabasemacOS 和 Linux 也可以用 Homebrewbrew install supabase/tap/supabaseWindows 上可以用 Scoopscoop install supabase。裝完用supabase --version確認輸出版本號即可。初始化工作區(qū)并啟動本地服務(wù)棧在空目錄里執(zhí)行初始化會生成supabase/config.toml這個文件描述本地項目的全部配置supabase init supabase startstart會拉起 Postgres、Auth、Realtime、Storage、Edge Functions 等容器并自動做健康檢查。不想啟動某些服務(wù)時可以用-x排除比如-x gotrue,imgproxy。啟動完成后運行supabase status查看各項服務(wù)的狀態(tài)。如果項目已經(jīng)有supabase目錄結(jié)構(gòu)想看它到底生成了什么直接翻目錄即可config.toml之外migrations、functions、tests等目錄都掛在supabase/下。想從零腳手架一個帶模板的項目還可以直接跑supabase bootstrap它會替你搭好工作區(qū)骨架。用遷移管理一張用戶表建表這件事建議走遷移文件而不是手工連庫執(zhí)行 SQL。以創(chuàng)建profiles表為例supabase migration new create_profiles在supabase/migrations/下生成的 SQL 文件中寫入建表語句并順手打開行級安全create table public.profiles ( id uuid references auth.users primary key, full_name text, created_at timestamptz default now() ); alter table public.profiles enable row level security;然后讓本地庫跟上遷移supabase db resetdb reset會重建本地庫并按序應(yīng)用所有遷移和種子文件。遷移寫好后想對比本地與目標的差異用supabase db diff確認無誤再推送supabase db push。日常排查時supabase db --help能列出該子命令下所有可用的操作。創(chuàng)建、測試并部署一個 Edge Function函數(shù)是 TypeScript 寫的無服務(wù)器代碼運行在 Deno 兼容的邊緣運行時上冷啟動快、無需包管理。以hello-world為例supabase functions new hello-world這會生成函數(shù)目錄和入口文件。本地跑起來看看響應(yīng)是否符合預(yù)期supabase functions serve hello-world終端會輸出本地訪問地址用 curl 打一下確認能拿到 JSON 響應(yīng)。測試通過后部署到遠端supabase functions deploy hello-world如果函數(shù)需要環(huán)境變量部署時可以用--env-file指向一個.env文件避免把密鑰硬編碼進代碼。讓類型跟著數(shù)據(jù)庫走表結(jié)構(gòu)一變客戶端類型就過期這是最常見的隱性成本。Supabase CLI 可以直接從庫結(jié)構(gòu)反向生成類型supabase gen types --local database.types.ts--local從本地庫讀取結(jié)構(gòu)--linked則從關(guān)聯(lián)的遠程項目讀取。把生成的文件提交進倉庫supabase-js客戶端就能基于它做完整的類型檢查。關(guān)聯(lián)遠程項目并推送變更本地開發(fā)收斂后把改動帶上線分三步supabase login supabase link --project-ref 你的項目ref supabase db pushlogin需要個人訪問令牌憑證會存進系統(tǒng)鑰匙串不可用時寫到本地配置文件。CI 環(huán)境里可以跳過登錄直接用SUPABASE_ACCESS_TOKEN環(huán)境變量注入。link之后push、gen types --linked這類命令就知道該操作哪個項目。函數(shù)部署同理走supabase functions deploy即可。常見卡點排查supabase start卡住或超時首次運行要拉取多個鏡像耐心等待若健康檢查失敗先看 Docker 是否正常運行必要時supabase stop后重試也可臨時用--ignore-health-check跳過檢查排查。內(nèi)存不足導(dǎo)致容器反復(fù)重啟全部服務(wù)對內(nèi)存不友好用-x排除掉你暫時用不到的服務(wù)如imgproxy能明顯緩解。db reset后數(shù)據(jù)全沒了這是預(yù)期行為——它會重建本地庫。想保留某些數(shù)據(jù)先supabase db dump導(dǎo)出再重置后導(dǎo)入回去。找不到項目 ref 或權(quán)限不足ref 在控制臺的項目設(shè)置頁可以復(fù)制令牌權(quán)限不夠時回到賬戶的令牌管理頁重新生成。不知道某條命令有哪些參數(shù)任何子命令加--help都能列出參數(shù)與示例比如supabase functions deploy --help。接下來可以看什么倉庫內(nèi)的文檔目錄值得一讀apps/cli/docs/下按子命令拆分了start.md、status.md、functions.md等說明能覆蓋命令行手冊里的大部分細節(jié)。想深入本地棧的架構(gòu)可以參考packages/stack的源碼和packages/config中關(guān)于配置 schema 的定義。把init → start → migration → functions deploy → gen types這條鏈路跑通之后剩下的就是按你項目的節(jié)奏迭代了?！久赓M下載鏈接】cliSupabase CLI. Manage postgres migrations, run Supabase locally, deploy edge functions. Postgres backups. Generating types from your database schema.項目地址: https://gitcode.com/GitHub_Trending/cli23/cli創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考