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