流水線 Flow提供了一站式 Node.js 專案測試與構建解決方案,協助您快速配置 CI/CD 流水線,並實現自動化測試、代碼編譯、依賴管理、構建產物上傳等。本文為您介紹如何通過可視化介面配置Node.js · 測試、構建。
步驟一:建立測試構建流水線
登入流水線 Flow控制台,單擊右上方建立流水線。
在彈出的選擇流水線模板頁面,選擇Node.js · 測試、構建,並單擊建立。

步驟二:配置流水線源
在建立流水線的流程配置中,單擊流水線源階段的添加流水線源。
選擇添加您的代碼源。本文使用流水線 Flow預置的範例程式碼,您需依次單擊。
步驟三:配置測試構建
Node.js · 測試、構建模板預置了JavaScript 代碼掃描、Node.js 單元測試和Node.js 構建上傳。它們的配置基本類似,本文以Node.js 構建上傳為例進行說明。
Node.js 構建上傳配置詳情
配置基本參數。
參數
說明
任務名稱
您可自訂任務名稱,一般保持預設即可。
構建叢集
支援以下構建叢集:
構建環境
支援以下構建環境:
指定容器環境(雲效預設構建叢集):流水線 Flow在構建機器上啟動指定容器,在單容器環境進行構建。雲效提供官方常用鏡像供選擇使用、您也可以指定自己的鏡像作為運行環境。
預設VM環境(僅私人構建叢集支援):須選擇指定構建節點。流水線 Flow會直接在構建機器上安裝環境並執行任務,為了提升任務構建速度建議提前在構建機器上安裝好相應SDK和環境。
說明任務執行期間,流水線任務構建環境分配給使用者使用,構建環境的使用權歸屬使用者,任務執行指令碼由使用者自訂。
下載流水線源
開啟下載流水線源後,您配置的源檔案將會被下載至對應的工作目錄下。支援以下三種方式:
下載全部流水線源
不下載流水線源
下載部分流水線源
配置任務步驟。
指定容器環境/預設VM環境
安裝 Node 環境
根據具體需求配置Node 版本、npm 類型等參數。
重要版本選擇方式支援從預置版本中選擇、輸入指定版本或使用程式碼程式庫中 .nvmrc 檔案中的版本。但如果 .nvmrc 檔案存在,則無論選擇哪個選項都會使用 .nvmrc 檔案。

執行命令
輸入執行命令(執行命令為使用者自訂構建命令),並選擇是否指定運行Shell。如需配置環境變數,請參見環境變數。

構建物上傳
將構建產物上傳到製品倉庫 Packages統一管理
參數說明:
參數
說明
添加服務串連
單擊添加服務串連,根據介面提示建立流水線 Flow到製品倉庫 Packages的服務串連。更多資訊,請參見服務串連管理。
倉庫
添加服務串連後,可選擇Packages中的通用製品倉庫作為目標倉庫。
說明關於通用製品倉庫的更多資訊,請參見通用製品管理
製品名稱
用於區分多次構建產生的不同產出物,定義後在部署組件使用,建議使用動態變數形式設定。預設使用
Artifacts_${PIPELINE_ID}。您可自訂構建物的名稱(如target1)。製品版本
版本用於唯一標識您的製品檔案,因此同一製品不允許推送重複版本。建議使用動態變數形式,比如
${DATETIME}。打包路徑
設定起始位置為專案檔夾的相對路徑(如
target/),可以設定多個檔案路徑。製品中包含打包路徑的目錄
如果選中,則產生的壓縮包中,包含完整的打包路徑,否則僅包含檔案。當選擇了多個打包路徑時,該值自動化佈建為
true。配置樣本:

JavaScript 代碼掃描專屬參數說明
參數 | 說明 |
是否使用本地 ESLint 配置 | 是否使用倉庫自身的 ESLint 配置,而不是系統規則集進行掃描。啟用該選項後,需在「運行本地 ESLint 配置所需依賴」選項中聲明所需依賴,且確保倉庫根目錄有 .eslintrc.* 檔案 |
運行本地 ESLint 配置所需依賴 | 在此聲明運行倉庫自身 ESLint 配置所需的所有依賴,依賴間用空格間隔,這個欄位將直接跟在 重要 該選項僅在是否使用本地 ESLint 配置選項開啟後有效。 |
開啟增量掃描模式 | 未開啟增量掃描模式時,將對全量代碼進行掃描。 |
排除子目錄 | 需要被排除在掃描範圍之外的目錄或檔案,可參考 |
紅線資訊 | 設定代碼掃描成功判定的條件,支援從以下四個維度進行設定:
|
Node.js 單元測試專屬參數說明
參數 | 說明 |
執行命令 | 需自訂Node.js單元測試命令。 |
測試報告檔案路徑 | 測試命令執行後產生的測試報告所在目錄,例如 |
測試載入器 | 選擇測試載入器/架構,例如 |
步驟四:運行並查看目標流水線任務
流程配置完成後,單擊頁面右上方儲存並運行,並在彈出的對話方塊中單擊運行,即可開始運行流水線任務。
運行流水線任務完成後,在構建鏡像任務節點的右下方單擊日誌,可以查看到流水線任務的執行過程結果日誌。
