Openship 數據庫層完整解析Drizzle ORM 與 Postgres/PGlite 內嵌數據庫遷移指南【免費下載鏈接】openshipSelf-hosted deployment platform項目地址: https://gitcode.com/GitHub_Trending/ope/openshipOpenship是一款自托管部署平臺Self-hosted Deployment Platform而支撐它的全部數據能力就是位于 packages/db/ 下的數據庫層。這一層以Drizzle ORM為核心同時支持兩種數據庫驅動生產級的Postgres以及零配置即可運行的PGlite 內嵌數據庫WASM 版 PostgreSQL無需安裝任何服務。所有數據庫遷移Migration在應用啟動時自動執行遷移鏈已從0000一路演進到0116。本文將帶你快速看懂驅動如何選擇、遷移鏈如何自動運行、PGlite 如何避免數據損壞以及數據導出恢復怎么做。一圖看懂為什么部署平臺需要「雙驅動」數據庫層上面就是 Openship 的控制臺界面。界面上的每一個項目、部署記錄、域名、服務器和通知背后都對應數據庫中的一張表。Openship 的數據庫層解決了一個典型矛盾開發者體驗希望clone倉庫就能跑起來不想先裝 Docker 和 Postgres生產部署希望用標準的 Postgres獲得并發、備份和運維工具鏈的完整能力。解決方案就是一套接口兩種驅動場景驅動數據存放位置生產 / Docker 自托管node-postgres 連接真實 Postgres你的 Postgres 服務本地開發 / 桌面端PGlite 內嵌數據庫默認~/.openship/data可用PGLITE_DATA_DIR指定選擇邏輯很簡單配置了DATABASE_URL或POSTGRES_HOST/POSTGRES_PASSWORD等變量就連 Postgres否則自動降級為 PGlite真正做到零配置啟動。統一接口上層代碼不關心底層是哪個數據庫數據庫客戶端的工廠邏輯集中在 client.ts 中postgresql://開頭的連接串 → 創建node-postgres 連接池 Drizzle實例連接池上限 20見 client.ts空或未配置 → 創建PGlite 內嵌數據庫實例。兩種驅動最終都歸一為同一個Database類型所有倉庫層Repo和服務拿到的是同一個接口完全不知道底層跑的是哪種數據庫。這也是 Drizzle ORM 的價值類型安全 一套查詢語法覆蓋兩種后端。 小細節測試環境下VITESTPGlite 會自動切換到內存模式memory://保證測試永不污染磁盤上的開發數據——見 client.ts。遷移鏈解析從 0000 到 0116 的自動演進Openship 的遷移文件全部存放在 packages/db/drizzle/ 目錄目前已積累117 個遷移 SQL 文件起點0000_init.sql —— 初始建表近期演進示例0084_analytics_daily_rollup.sql分析日匯總、0108_credential.sql憑據表、0116_domain_ssl_challenge.sql域名 SSL 驗證。遷移如何自動運行無論使用哪種驅動應用啟動時都會調用 Drizzle 的migrate()把packages/db/drizzle/目錄里尚未執行的遷移按順序、每條一個事務地應用完——見 client.tsPostgres 驅動與 client.tsPGlite 驅動。開發者的日常工作流只需三步修改表定義packages/db/src/schema/下對應文件運行db:generate腳本基于 drizzle-kit配置見 drizzle.config.ts生成新的遷移 SQL提交遷移文件重啟應用——遷移自動完成。?? 特別提醒遷移目錄通過OPENSHIP_MIGRATIONS_DIR環境變量可被重定向。桌面端 App 是bun build --compile編譯的單體二進制SQL 文件不在文件系統里而是作為數據資源隨二進制一起發布這個變量就是為它準備的。領域化 Schema49 個文件一個業務域一個表集合表定義不是一團亂麻而是按業務域拆分成 packages/db/src/schema/ 下的近 50 個文件并在 index.ts 統一導出部署核心project.ts、deployment.ts、service.ts網絡與邊緣domain.ts、route-rule.ts、edge-target-verification.ts基礎設施servers.ts、server-container-status.ts、server-tunnel.ts商業化billing.ts、oauth.ts運維backup.ts、notification.ts、service-incident.ts以 deployment.ts 為例可以看到典型的 Drizzle 寫法text主鍵帶dep_前綴、外鍵引用 project 和 organization 并配置級聯刪除onDelete: cascade、trigger字段記錄部署由 webhook 還是回滾觸發。所有字段都有清晰的注釋文檔讀 Schema 就像讀 API 文檔。所有數據庫訪問都被收口到倉庫層Repos——見 packages/db/src/index.ts 的導出注釋“所有 DB 訪問都經過這里”。業務代碼不直接拼查詢而是調用createProjectRepo、createDeploymentRepo等工廠這是全項目可測試性的關鍵。避坑指南PGlite 單進程鎖與 Postgres 啟動等待內嵌數據庫最大的風險是兩個進程同時打開同一份數據導致不可逆損壞。Openship 在這里做了兩重工程保障① PGlite 單實例文件鎖— 實現見 pglite-lock.ts用原子創建O_EXCL在數據目錄旁生成dir.lock鎖文件保證同一時刻只有一個進程持有數據目錄鎖內記錄操作系統級的機器標識machine-id / MachineGuid區分「本機崩潰殘留」和「另一臺機器占用」崩潰自愈發現前一個進程已死亡死 PID立即回收鎖SIGKILL不會把目錄鎖死鎖文件刻意放在數據目錄外部因為 PGlite 首次初始化拒絕非空目錄。熱重載場景下新進程會最多等待 30 秒讓舊進程優雅釋放數據庫避免開發時反復出現 “already using the database” 報錯。② Postgres 就緒等待— 實現見 client.ts啟動時最多等待90 秒每 1 秒重試一次覆蓋宿主重啟后 Postgres 崩潰恢復的慢啟動致命錯誤立即失敗而非空等28P01/28000密碼錯誤通常是.env與數據卷不匹配和3D000數據庫不存在會立刻拋出可讀的錯誤幫你省下幾十分鐘排查時間連接池掛載了空閑連接錯誤監聽Postgres 重啟不會讓整個 API 進程崩潰退出。 配套工具package.json提供了db:heal-pglite、db:heal-orphans等自愈腳本入口在 scripts/heal-pglite.ts遇到極端異常時有標準修復手段。數據層能力延伸導出、恢復與跨實例遷移除了 CRUDpackages/db/ 還內置了一套結構化備份體系核心在 dump.tsdumpDatabase/restoreDatabase整庫按拓撲順序導出與恢復dumpSubgraph/restoreSubgraph項目級子圖導出——把單個項目及其關聯數據打包帶走用于團隊模式遷移和項目轉讓敏感字段自動處理加密列ENCRYPTED_COLUMNS在導出時剝離防止密鑰材料泄露到備份文件。命令行入口同樣齊備db:dump與db:restore兩個腳本scripts/dump.ts / scripts/restore.ts配合桌面端發布打包讓「把數據從一臺自托管服務器搬到另一臺」成為一條命令的事。快速上手5 分鐘認識 Openship 數據庫層如果你想動手體驗先獲取代碼git clone https://gitcode.com/GitHub_Trending/ope/openship然后按場景二選一零配置模式什么都不配直接啟動 API——PGlite 會在~/.openship/data自動建庫并跑完全部 117 條遷移Postgres 模式設置DATABASE_URL或直接復用 docker-compose 中的POSTGRES_HOST/POSTGRES_PASSWORD變量名啟動時自動連池并執行遷移。 關鍵文件地圖驅動選擇與啟動等待packages/db/src/client.tsPGlite 單實例鎖packages/db/src/pglite-lock.tsPostgres 咨詢鎖跨進程串行化packages/db/src/advisory-lock.ts遷移 SQL 目錄packages/db/drizzle/遷移生成配置packages/db/drizzle.config.ts倉庫層出口packages/db/src/repos/總結Openship 的數據庫層是一套教科書級的自托管工程實踐Drizzle ORM提供類型安全的統一接口Postgres 與 PGlite 雙驅動兼顧生產嚴謹與開發零門檻自動遷移鏈讓 schema 演進零手工干預而單實例鎖、啟動等待與結構化備份則把內嵌數據庫最常見的坑提前堵死。理解了這一層你就掌握了 Openship 所有項目、部署與計費數據的底層脈絡。【免費下載鏈接】openshipSelf-hosted deployment platform項目地址: https://gitcode.com/GitHub_Trending/ope/openship創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Openship 數據庫層完整解析：Drizzle ORM 與 Postgres/PGlite 內嵌數據庫遷移指南
Openship 數據庫層完整解析Drizzle ORM 與 Postgres/PGlite 內嵌數據庫遷移指南【免費下載鏈接】openshipSelf-hosted deployment platform項目地址: https://gitcode.com/GitHub_Trending/ope/openshipOpenship是一款自托管部署平臺Self-hosted Deployment Platform而支撐它的全部數據能力就是位于 packages/db/ 下的數據庫層。這一層以Drizzle ORM為核心同時支持兩種數據庫驅動生產級的Postgres以及零配置即可運行的PGlite 內嵌數據庫WASM 版 PostgreSQL無需安裝任何服務。所有數據庫遷移Migration在應用啟動時自動執行遷移鏈已從0000一路演進到0116。本文將帶你快速看懂驅動如何選擇、遷移鏈如何自動運行、PGlite 如何避免數據損壞以及數據導出恢復怎么做。一圖看懂為什么部署平臺需要「雙驅動」數據庫層上面就是 Openship 的控制臺界面。界面上的每一個項目、部署記錄、域名、服務器和通知背后都對應數據庫中的一張表。Openship 的數據庫層解決了一個典型矛盾開發者體驗希望clone倉庫就能跑起來不想先裝 Docker 和 Postgres生產部署希望用標準的 Postgres獲得并發、備份和運維工具鏈的完整能力。解決方案就是一套接口兩種驅動場景驅動數據存放位置生產 / Docker 自托管node-postgres 連接真實 Postgres你的 Postgres 服務本地開發 / 桌面端PGlite 內嵌數據庫默認~/.openship/data可用PGLITE_DATA_DIR指定選擇邏輯很簡單配置了DATABASE_URL或POSTGRES_HOST/POSTGRES_PASSWORD等變量就連 Postgres否則自動降級為 PGlite真正做到零配置啟動。統一接口上層代碼不關心底層是哪個數據庫數據庫客戶端的工廠邏輯集中在 client.ts 中postgresql://開頭的連接串 → 創建node-postgres 連接池 Drizzle實例連接池上限 20見 client.ts空或未配置 → 創建PGlite 內嵌數據庫實例。兩種驅動最終都歸一為同一個Database類型所有倉庫層Repo和服務拿到的是同一個接口完全不知道底層跑的是哪種數據庫。這也是 Drizzle ORM 的價值類型安全 一套查詢語法覆蓋兩種后端。 小細節測試環境下VITESTPGlite 會自動切換到內存模式memory://保證測試永不污染磁盤上的開發數據——見 client.ts。遷移鏈解析從 0000 到 0116 的自動演進Openship 的遷移文件全部存放在 packages/db/drizzle/ 目錄目前已積累117 個遷移 SQL 文件起點0000_init.sql —— 初始建表近期演進示例0084_analytics_daily_rollup.sql分析日匯總、0108_credential.sql憑據表、0116_domain_ssl_challenge.sql域名 SSL 驗證。遷移如何自動運行無論使用哪種驅動應用啟動時都會調用 Drizzle 的migrate()把packages/db/drizzle/目錄里尚未執行的遷移按順序、每條一個事務地應用完——見 client.tsPostgres 驅動與 client.tsPGlite 驅動。開發者的日常工作流只需三步修改表定義packages/db/src/schema/下對應文件運行db:generate腳本基于 drizzle-kit配置見 drizzle.config.ts生成新的遷移 SQL提交遷移文件重啟應用——遷移自動完成。?? 特別提醒遷移目錄通過OPENSHIP_MIGRATIONS_DIR環境變量可被重定向。桌面端 App 是bun build --compile編譯的單體二進制SQL 文件不在文件系統里而是作為數據資源隨二進制一起發布這個變量就是為它準備的。領域化 Schema49 個文件一個業務域一個表集合表定義不是一團亂麻而是按業務域拆分成 packages/db/src/schema/ 下的近 50 個文件并在 index.ts 統一導出部署核心project.ts、deployment.ts、service.ts網絡與邊緣domain.ts、route-rule.ts、edge-target-verification.ts基礎設施servers.ts、server-container-status.ts、server-tunnel.ts商業化billing.ts、oauth.ts運維backup.ts、notification.ts、service-incident.ts以 deployment.ts 為例可以看到典型的 Drizzle 寫法text主鍵帶dep_前綴、外鍵引用 project 和 organization 并配置級聯刪除onDelete: cascade、trigger字段記錄部署由 webhook 還是回滾觸發。所有字段都有清晰的注釋文檔讀 Schema 就像讀 API 文檔。所有數據庫訪問都被收口到倉庫層Repos——見 packages/db/src/index.ts 的導出注釋“所有 DB 訪問都經過這里”。業務代碼不直接拼查詢而是調用createProjectRepo、createDeploymentRepo等工廠這是全項目可測試性的關鍵。避坑指南PGlite 單進程鎖與 Postgres 啟動等待內嵌數據庫最大的風險是兩個進程同時打開同一份數據導致不可逆損壞。Openship 在這里做了兩重工程保障① PGlite 單實例文件鎖— 實現見 pglite-lock.ts用原子創建O_EXCL在數據目錄旁生成dir.lock鎖文件保證同一時刻只有一個進程持有數據目錄鎖內記錄操作系統級的機器標識machine-id / MachineGuid區分「本機崩潰殘留」和「另一臺機器占用」崩潰自愈發現前一個進程已死亡死 PID立即回收鎖SIGKILL不會把目錄鎖死鎖文件刻意放在數據目錄外部因為 PGlite 首次初始化拒絕非空目錄。熱重載場景下新進程會最多等待 30 秒讓舊進程優雅釋放數據庫避免開發時反復出現 “already using the database” 報錯。② Postgres 就緒等待— 實現見 client.ts啟動時最多等待90 秒每 1 秒重試一次覆蓋宿主重啟后 Postgres 崩潰恢復的慢啟動致命錯誤立即失敗而非空等28P01/28000密碼錯誤通常是.env與數據卷不匹配和3D000數據庫不存在會立刻拋出可讀的錯誤幫你省下幾十分鐘排查時間連接池掛載了空閑連接錯誤監聽Postgres 重啟不會讓整個 API 進程崩潰退出。 配套工具package.json提供了db:heal-pglite、db:heal-orphans等自愈腳本入口在 scripts/heal-pglite.ts遇到極端異常時有標準修復手段。數據層能力延伸導出、恢復與跨實例遷移除了 CRUDpackages/db/ 還內置了一套結構化備份體系核心在 dump.tsdumpDatabase/restoreDatabase整庫按拓撲順序導出與恢復dumpSubgraph/restoreSubgraph項目級子圖導出——把單個項目及其關聯數據打包帶走用于團隊模式遷移和項目轉讓敏感字段自動處理加密列ENCRYPTED_COLUMNS在導出時剝離防止密鑰材料泄露到備份文件。命令行入口同樣齊備db:dump與db:restore兩個腳本scripts/dump.ts / scripts/restore.ts配合桌面端發布打包讓「把數據從一臺自托管服務器搬到另一臺」成為一條命令的事。快速上手5 分鐘認識 Openship 數據庫層如果你想動手體驗先獲取代碼git clone https://gitcode.com/GitHub_Trending/ope/openship然后按場景二選一零配置模式什么都不配直接啟動 API——PGlite 會在~/.openship/data自動建庫并跑完全部 117 條遷移Postgres 模式設置DATABASE_URL或直接復用 docker-compose 中的POSTGRES_HOST/POSTGRES_PASSWORD變量名啟動時自動連池并執行遷移。 關鍵文件地圖驅動選擇與啟動等待packages/db/src/client.tsPGlite 單實例鎖packages/db/src/pglite-lock.tsPostgres 咨詢鎖跨進程串行化packages/db/src/advisory-lock.ts遷移 SQL 目錄packages/db/drizzle/遷移生成配置packages/db/drizzle.config.ts倉庫層出口packages/db/src/repos/總結Openship 的數據庫層是一套教科書級的自托管工程實踐Drizzle ORM提供類型安全的統一接口Postgres 與 PGlite 雙驅動兼顧生產嚴謹與開發零門檻自動遷移鏈讓 schema 演進零手工干預而單實例鎖、啟動等待與結構化備份則把內嵌數據庫最常見的坑提前堵死。理解了這一層你就掌握了 Openship 所有項目、部署與計費數據的底層脈絡。【免費下載鏈接】openshipSelf-hosted deployment platform項目地址: https://gitcode.com/GitHub_Trending/ope/openship創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考