我正在軟體工程產品中以 Docker 映像方式自行託管 n8n。每當我需要從開發環境移至 SIT 環境時,有沒有辦法可以不用每次都執行新的 Docker 映像並複製所有工作流程?工作流程數量很多
@Mohamed8 別手動複製,改用 n8n CLI 的 export/import,一次可以移整個程式庫。在開發容器上匯出所有工作流程到一個資料夾,把那個資料夾複製到 SIT 機器上,再匯入:
# on dev
docker exec -u node <dev-container> n8n export:workflow --backup --output=/tmp/wf/
# copy /tmp/wf across, then on SIT
docker exec -u node <sit-container> n8n import:workflow --separate --input=/tmp/wf/
如果需要移認證資訊的話,還有對應的 export:credentials / import:credentials 配對。比起重新 spin up 一個全新映像檔然後每次複製檔案方便多了。
謝謝。我在工作流程中使用基本身份驗證,我已將它們添加到「認證資料」中,並為每個 HTTP 請求選擇適當的認證資料。當我複製工作流程時,它會重設並默認為所有 HTTP 節點選擇第一個基本身份驗證,我需要修復它們。
使用這種方法我會遇到相同的問題嗎?
@Mohamed8 重設發生是因為節點按 id 參考認證,而簡單的複製不會帶著那些 id,所以會回退到第一個相符的。只要你也移動認證,不只是工作流程,CLI 就能避免這個問題:在 dev 上執行 export:credentials --backup,然後在 SIT 上執行 import:credentials。該 import 會按 id 進行 upsert,所以每個認證都保留其原始 id,工作流程參考會自動解析到正確的基本認證。
有一個需要注意的地方,認證是用 N8N_ENCRYPTION_KEY 加密的,所以 SIT 需要和 dev 相同的金鑰,否則它們無法解密。如果金鑰不同,使用 --decrypted 匯出,它們會在匯入時重新加密。
太棒了!你知道怎樣才能取得那個加密金鑰嗎?它是否也能匯出?
@Mohamed8 它不會隨著工作流程一起匯出。它要嘛是你設定的 N8N_ENCRYPTION_KEY 環境變數,要嘛如果你從未設定過,n8n 會自動產生它並將其保存在設定檔中。在開發環境中用以下指令讀取它:
docker exec -u node <dev-container> cat /home/node/.n8n/config
你會在其中看到一個 encryptionKey 值。最簡單的方法是在 SIT 上將相同的值設定為 N8N_ENCRYPTION_KEY(在你的 compose/run 環境中),這樣兩者就會共享密鑰,匯入的認證資料就能解密。在兩邊明確設定它比依賴自動產生的檔案要好。
嘿 @Mohamed8、@achamm 的 CLI 方式對於你目前的情況是正確的修復。就長期而言,值得考慮一件事,既然這聽起來像是實際產品管道中反覆出現的 dev→SIT 部署,n8n 透過 Git 支援源控制(設定 → 源控制,在特定方案中可用),這會轉變成適當的 CI/CD 風格流程:從 dev 推送工作流程到 Git 倉庫,然後自動拉取/部署到 SIT。它也能妥善版控你的工作流程,所以你可以免費獲得差異對比和回滾功能,而不是每次都手動匯出/匯入。
如果你的方案/版本無法使用基於 Git 的源控制,@achamm 的 CLI 匯出/匯入是正確的手動替代方案,只是值得了解如果這變成頻繁的管道步驟而不是一次性的遷移,自動化選項是存在的。
我在嘗試將工作流程匯入到新環境時遇到問題。
我收到錯誤
Active version not found for workflow
Error: Active version not found for workflow
at ActiveWorkflowManager.clearWebhooks (/usr/local/lib/node_modules/n8n/src/active-workflow-manager.ts:248:10)
at ActiveWorkflowManager.remove (/usr/local/lib/node_modules/n8n/src/active-workflow-manager.ts:872:4)
at ImportService.importWorkflows (/usr/local/lib/node_modules/n8n/src/services/import.service.ts:84:5)
at ImportWorkflowsCommand.run (/usr/local/lib/node_modules/n8n/src/commands/import/workflow.ts:104:3)
at CommandRegistry.execute (/usr/local/lib/node_modules/n8n/src/command-registry.ts:83:4)
at /usr/local/lib/node_modules/n8n/bin/n8n:63:2
Could not remove webhooks of workflow "0YdMxcy7MAjVkwy2" because of error: "Active version not found for workflow"
Could not find workflow
Error: Could not find workflow
at ActiveWorkflowManager.clearWebhooks (/usr/local/lib/node_modules/n8n/src/active-workflow-manager.ts:244:10)
at ActiveWorkflowManager.remove (/usr/local/lib/node_modules/n8n/src/active-workflow-manager.ts:872:4)
at ImportService.importWorkflows (/usr/local/lib/node_modules/n8n/src/services/import.service.ts:84:5)
at ImportWorkflowsCommand.run (/usr/local/lib/node_modules/n8n/src/commands/import/workflow.ts:104:3)
at CommandRegistry.execute (/usr/local/lib/node_modules/n8n/src/command-registry.ts:83:4)
at /usr/local/lib/node_modules/n8n/bin/n8n:63:2
考慮到我的工作流程具有 Webhook 觸發器,其中一些是活躍的,而且我的 n8n 版本是 2.1.4
你有任何想法嗎?
@ShawnWilliams @achamm
@Mohamed8 那是 import 試圖管理工作流程的活躍狀態,較新版本的 n8n 通過版本 id 追蹤活躍工作流程,如果導入的活躍工作流程在 SIT 上還沒有對應的 active-version 記錄,就會導致 clearWebhooks 失敗。最乾淨的修復方式是讓它們以非活躍狀態導入,在 dev 上導出前先停用工作流程,這樣它們導入時 active:false,然後在 SIT 上載入後再啟用。如果失敗的執行在 SIT 上留下了半導入的副本處於活躍狀態,先停用或刪除那些,這樣下次導入就不會試圖為它們清除 webhook。
有沒有辦法用 CLI 來啟用/停用它們?
@Mohamed8 是啊,n8n 的 update:workflow 指令可以做到:
docker exec -u node <container> n8n update:workflow --all --active=false
改成 --active=true 來啟用,或是用 --id= 取代 --all 來指定單一個。所以你的流程變成在 dev 上停用、匯出、匯入到 SIT,然後在 SIT 上用 --active=true 執行。如果你不想讓 dev 離線,只要在 SIT 上用 --all --active=false 停用卡住的副本、重新匯入,然後在那邊重新啟用就行。
非常感謝您的幫助。@achamm
當我嘗試逐個發佈時,它給我一個錯誤
Publishing workflow with ID: Error tracking disabled because this release is older than 6 weeks. (current version)
Error updating database. See log messages for details.
GOT ERROR
Workflow "Error tracking disabled because this release is older than 6 weeks." not found.
Error: Workflow "Error tracking disabled because this release is older than 6 weeks." not found.
at WorkflowRepository.publishVersion (/usr/local/lib/node_modules/n8n/node_modules/.pnpm/
+db@file+packages+
+db_@opentelemetry+api@1.9.0_@opentelemetry+sdk-trace-base@1._ab22bba05a964211b9fe14bf4b841570/node_modules/
/db/src/repositories/workflow.repository.ts:894:11)
at PublishWorkflowCommand.run (/usr/local/lib/node_modules/n8n/src/commands/publish/workflow.ts:43:3)
at CommandRegistry.execute (/usr/local/lib/node_modules/n8n/src/command-registry.ts:83:4)
at /usr/local/lib/node_modules/n8n/bin/n8n:63:2
Workflow "Error tracking disabled because this release is older than 6 weeks." not found.
Publishing 0YdMxcy7MAjVkwy2
Error tracking disabled because this release is older than 6 weeks.
Publishing workflow with ID: 0YdMxcy7MAjVkwy2 (current version)
Error updating database. See log messages for details.
而且當我嘗試從 UI 發佈時,它說工作流程無法發佈:
找不到版本
@Mohamed8 別一個一個執行,那個逐一發佈的動作就是造成卡頓的地方,workflow id 沒有被正確解析,所以 n8n 找不到它。直接執行批量啟用:
docker exec -u node <container> n8n update:workflow --all --active=true
這樣可以一次把所有的都打開,不需要你逐個傳入 id。如果連 --all 都出錯的話,那可能是你用的版本有些怪癖(那個 6 weeks 的標記表示是比較舊的版本),試著升級到最新的 n8n 版本應該值得一試。
CLI 匯出/匯入建議是正確的基礎。如果你有許多工作流程,我也會把開發 → SIT 當作發布流程,而不是複製操作。
我會補充的幾點:
- 將匯出保存在版本控制系統中,這樣你就能知道在晉升之間發生了什麼變化。
- 將工作流程結構與環境特定的值分開。
- 除非你有明確的認證所有權模型,否則不要盲目移動生產認證。
- 在匯入後為重要的工作流程執行煙霧測試。
- 記錄哪些工作流程被晉升、哪些失敗,以及什麼需要手動後續處理。
- 保留回滾路徑,即使只是重新匯入先前已知良好的匯出。
複製步驟通常不是後來會造成傷害的地方。痛苦的部分是當沒有人知道哪個環境有哪個版本、SIT 是否真的經過測試,或者工作流程在移動後中斷了什麼。一旦工作流程面向客戶端,該晉升日誌就變得特別重要。
@achamm 但是每當我使用
docker exec -u node n8n update:workflow --all --active=true
它就顯示
⚠️ 警告:「update:workflow」命令已棄用。
不再支援透過「update:workflow --all」發佈工作流程。
請使用以下方式個別發佈工作流程:publish:workflow --id=<workflow-id>
@Mohamed8 是的,–all 已經棄用了,新的 publish:workflow 就是你之前遇到版本錯誤的地方,所以跳過 publish CLI,改用公開 REST API,它有一個專用的 activate 端點可以完全繞過版本控制:
POST /api/v1/workflows/{id}/activate
在 Settings > n8n API 中生成 API 金鑰,使用 GET /api/v1/workflows 列出你的工作流程來取得 id,然後對每個執行那個 activate 呼叫。這就是你的批量啟用方式,不用碰那個有問題的 publish 指令。
@achamm 從 sqlite 查詢工作流程 ID,然後對其進行迴圈處理可能是一個替代方案?
@Mohamed8 是的,從 sqlite 讀取 id 很好用,該表是 workflow_entity,所以 SELECT id FROM workflow_entity 就能取得列表(GET /api/v1/workflows api 也做同樣的事,但不綁定到資料庫架構,不過兩個都行)。只要保持讀取,別直接在 sqlite 寫入 active=1 來啟動,那樣會跳過 n8n 在啟動時執行的觸發器/webhook 註冊,這正是讓工作流卡在那種壞掉的 active-version 狀態的原因。隨意拉取 id,但要透過 api endpoint 執行實際的啟動,這樣 n8n 才會正確設定觸發器。
感謝你的幫助 @achamm 。你認為將 n8n 的 DEV 磁碟區複製到 SIT 使用時,能否妥善保留憑證 ID 和節點的關聯性?
我看到所有詳細資訊都儲存在 n8n 磁碟區內的 SQLite 資料庫中。
@Mohamed8 是的,克隆整個磁碟區可行,而且是保持所有內容連接的最乾淨方式——它是同一個 sqlite 資料庫的逐位元組複本,所以憑證 ID、工作流程 ID 和每個節點引用都保持相同,無需重新連結。加密金鑰也會一起帶過來,因為它在該磁碟區內的 .n8n/config 中,所以憑證在 SIT 上能解密,只要別在 SIT 上設定不同的 N8N_ENCRYPTION_KEY 環境變數,否則會衝突。
不過有兩個地方要注意:這是完整覆蓋,會替換掉 SIT 上的所有內容,並帶著 DEV 的環境特定配置(URL、webhook 基礎路徑、開發與正式環境的憑證值),所以如果 SIT 要鏡像 DEV 就很適合,但如果 SIT 需要自己的設定就不太理想。複製 sqlite 檔案前要停止 n8n,現場複製可能會破壞它,或者使用 sqlite 的 .backup 來取得乾淨的快照。如果 SIT 需要自己的配置,選擇性匯出/匯入仍然是更好的方式。