全部產品
Search
文件中心

Alibaba Cloud DevOps:Node.js測試構建

更新時間:May 16, 2025

流水線 Flow提供了一站式 Node.js 專案測試與構建解決方案,協助您快速配置 CI/CD 流水線,並實現自動化測試、代碼編譯、依賴管理、構建產物上傳等。本文為您介紹如何通過可視化介面配置Node.js · 測試、構建

步驟一:建立測試構建流水線

  1. 登入流水線 Flow控制台,單擊右上方建立流水線

  2. 在彈出的選擇流水線模板頁面,選擇Node.js · 測試、構建,並單擊建立

    image

步驟二:配置流水線源

  1. 建立流水線流程配置中,單擊流水線源階段的添加流水線源

  2. 選擇添加您的代碼源。本文使用流水線 Flow預置的範例程式碼,您需依次單擊範例程式碼源 > NodeJS > 添加

步驟三:配置測試構建

Node.js · 測試、構建模板預置了JavaScript 代碼掃描Node.js 單元測試Node.js 構建上傳。它們的配置基本類似,本文以Node.js 構建上傳為例進行說明。image

Node.js 構建上傳配置詳情

  1. 配置基本參數。

    參數

    說明

    任務名稱

    您可自訂任務名稱,一般保持預設即可。

    構建叢集

    支援以下構建叢集:

    構建環境

    支援以下構建環境:

    • 指定容器環境(雲效預設構建叢集):流水線 Flow在構建機器上啟動指定容器,在單容器環境進行構建。雲效提供官方常用鏡像供選擇使用、您也可以指定自己的鏡像作為運行環境。

    • 預設VM環境(僅私人構建叢集支援):須選擇指定構建節點流水線 Flow會直接在構建機器上安裝環境並執行任務,為了提升任務構建速度建議提前在構建機器上安裝好相應SDK和環境。

    說明

    任務執行期間,流水線任務構建環境分配給使用者使用,構建環境的使用權歸屬使用者,任務執行指令碼由使用者自訂。

    下載流水線源

    開啟下載流水線源後,您配置的源檔案將會被下載至對應的工作目錄下。支援以下三種方式:

    • 下載全部流水線源

    • 不下載流水線源

    • 下載部分流水線源

  2. 配置任務步驟

    指定容器環境/預設VM環境

    1. 安裝 Node 環境

      根據具體需求配置Node 版本npm 類型等參數。

      重要

      版本選擇方式支援從預置版本中選擇輸入指定版本使用程式碼程式庫中 .nvmrc 檔案中的版本。但如果 .nvmrc 檔案存在,則無論選擇哪個選項都會使用 .nvmrc 檔案

      image

    2. 執行命令

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

      image

    3. 構建物上傳

      將構建產物上傳到製品倉庫 Packages統一管理

      參數說明:

      參數

      說明

      添加服務串連

      單擊添加服務串連,根據介面提示建立流水線 Flow製品倉庫 Packages的服務串連。更多資訊,請參見服務串連管理

      倉庫

      添加服務串連後,可選擇Packages中的通用製品倉庫作為目標倉庫。

      說明

      關於通用製品倉庫的更多資訊,請參見通用製品管理

      製品名稱

      用於區分多次構建產生的不同產出物,定義後在部署組件使用,建議使用動態變數形式設定。預設使用Artifacts_${PIPELINE_ID}。您可自訂構建物的名稱(如target1)。

      製品版本

      版本用於唯一標識您的製品檔案,因此同一製品不允許推送重複版本。建議使用動態變數形式,比如 ${DATETIME}

      打包路徑

      設定起始位置為專案檔夾的相對路徑(如target/),可以設定多個檔案路徑。

      製品中包含打包路徑的目錄

      如果選中,則產生的壓縮包中,包含完整的打包路徑,否則僅包含檔案。當選擇了多個打包路徑時,該值自動化佈建為true

      配置樣本:

      image

JavaScript 代碼掃描專屬參數說明

參數

說明

是否使用本地 ESLint 配置

是否使用倉庫自身的 ESLint 配置,而不是系統規則集進行掃描。啟用該選項後,需在「運行本地 ESLint 配置所需依賴」選項中聲明所需依賴,且確保倉庫根目錄有 .eslintrc.* 檔案

運行本地 ESLint 配置所需依賴

在此聲明運行倉庫自身 ESLint 配置所需的所有依賴,依賴間用空格間隔,這個欄位將直接跟在 npm install 後面進行安裝。例如本地使用 eslint-config-standard,此處依賴需要寫 eslint eslint-config-standardeslint-plugin-standardeslint-plugin-promiseeslint-plugin-importeslint-plugin-node。當配置為*時,則預設安裝package.json中聲明的全部依賴。

重要

該選項僅在是否使用本地 ESLint 配置選項開啟後有效。

開啟增量掃描模式

未開啟增量掃描模式時,將對全量代碼進行掃描。

排除子目錄

需要被排除在掃描範圍之外的目錄或檔案,可參考gitignore配置,例如設定test/,表示排除掃描test/目錄下所有檔案。

紅線資訊

設定代碼掃描成功判定的條件,支援從以下四個維度進行設定:

  • Total 問題數

  • Bloker 問題數

  • Critical 問題數

  • Major 問題數

Node.js 單元測試專屬參數說明

參數

說明

執行命令

需自訂Node.js單元測試命令。

測試報告檔案路徑

測試命令執行後產生的測試報告所在目錄,例如mochawesome-report/mochawesome.html

測試載入器

選擇測試載入器/架構,例如Node.js-Mocha

步驟四:運行並查看目標流水線任務

  1. 流程配置完成後,單擊頁面右上方儲存並運行,並在彈出的對話方塊中單擊運行,即可開始運行流水線任務。

  2. 運行流水線任務完成後,在構建鏡像任務節點的右下方單擊日誌,可以查看到流水線任務的執行過程結果日誌。image