嵌入式自動化測試框架Fuego:快速入門指南

只需幾個簡單的步驟即可在你的硬件上從Fuego運行測試。
注意:這是快速入門指南。有關更多詳細信息和說明,請參考:安裝Fuego

概述

這些步驟的概述是:

  1. 安裝必備軟件
  2. 下載fuego資料庫
  3. 建立你的fuego容器
  4. 啓動容器
  5. 進入界面
  6. 將你的板子添加到fuego
  7. 進行測試
    這些步驟如下所述。

安裝必備軟件

要檢索fuego軟件併爲其創建docker鏡像,你需要在系統上安裝gitdocker。在Ubuntu上,嘗試以下命令:

$ sudo apt install git docker.io

下載,構建,啓動和訪問

要完成最後6個步驟,請在Linux命令提示符下執行以下操作:

$ git clone https://bitbucket.org/fuegotest/fuego.git
$ cd fuego
$ ./install.sh
$ ./start.sh
$ firefox http://localhost:8090/fuego

第四步(使用./install.sh)將花費一些時間-在我的計算機上大約需要45分鐘。這是構建Fuego docker容器的主要步驟。
當你運行start.sh腳本時,將以root用戶身份在docker容器內的shell提示符下運行該終端。容器將一直運行,直到您退出此shell。在測試期間,應保持運行狀態。
在最後一步,要訪問Fuego界面,你可以使用任何瀏覽器(不只是firefox)。默認情況下,Fuego接口在主機上的端口8090上運行,URL路徑爲/fuego。在瀏覽器中,你應該看到類似於以下內容的屏幕:
在這裏插入圖片描述
現在,我們將項目添加到Fuego(以及此屏幕上),以便你可以開始測試。

將你的板子添加到fuego

要將自己的板子添加到Fuego,需要執行三個主要步驟:

  1. 在目標上創建測試目錄
  2. 創建一個板文件(在主機上)
  3. 將你的板子添加到Jenkins界面
    你可以在以下位置找到添加板子的詳細說明:添加主板
    不過,我們這裏是快速添加自己的板子,以及向Fuego添加示例docker板子的步驟:

在板上創建測試目錄

登錄到你的板子,並創建用於測試的目錄:

$ ssh root@your_board
 <board>$ mkdir /home/a
 <board>$ exit

如果不使用ssh,請使用通常用於訪問板子的任何方法。

創建板子文件

現在,創建你的板子文件。該開發板文件位於fuego-dir/fuego-ro/boards中,並具有帶有開發板名稱的文件名,擴展名爲.board。請執行下列操作:

 $ cd fuego-ro/boards
 $ cp template-dev.board myboard.board
 $ vi myboard.board

編輯板文件中的變量以匹配你的板子。大多數變量可以保留,但是你需要更改IPADDRTOOLCHAINARCHITECTURE變量,並將BOARD_TESTDIR設置爲上面剛剛創建的目錄。

有關Board文件中的其他變量,或專門用於與不同於SSH的其他傳輸方式信息,請參閱以下更完整的說明:添加主板

將板子添加到Jenkins界面

最後,在Jenkins界面中添加板子。在Jenkins界面中,板子被稱爲“節點”。在容器Shell提示符下,運行以下命令:

(container prompt)$ ftc add-nodes -b myboard docker

這會將你的板子添加爲一個節點,並同時在Jenkins界面中添加一個docker節點。

安裝工具鏈

如果你只想使用Fuego進行實驗,而不想安裝自己的板子,則可以使用現有的docker板子。這將在主機上的docker容器內運行測試。這幾乎不需要任何設置,並且旨在讓人們嘗試Fuego來查看接口和測試的工作原理,而不必自己建立板子。
如果你正在運行帶有基於Debian發行版的ARM板子,則可以使用以下命令(在容器內部)將Debian ARM交叉編譯器安裝到docker容器中:

(container prompt)$ /fuego-ro/toolchains/install_armhf_toolchain.sh

如果要安裝其他類型的板子(不同的架構,不同的根文件系統佈局或不同的共享庫集),則需要在Docker容器內爲你的板子安裝工具鏈。請按照以下說明進行操作: 添加工具鏈以執行此操作。

現在選擇一些測試

爲了使用Jenkins界面執行測試,你需要爲其創建Jenkins“作業”。你可以使用ftc add-jobs命令執行此操作。這些命令也在docker容器中的shell提示符下執行。

你可以單獨添加作業,也可以一次基於“測試計劃”添加一組作業。測試計劃是Fuego測試的列表,每個測試都有一些選項。你可以使用以下命令查看系統中的測試計劃列表:

(container prompt)$ ftc list-plans

要爲系統上的docker板創建一組作業,請執行以下操作:

(container prompt)$ ftc add-jobs -b docker -p testplan_docker

要爲自己的板子創建一組作業(假設你將其稱爲myboard),請執行以下操作:

(container prompt)$ ftc add-jobs -b myboard -p testplan_smoketest

smoketest測試計劃包含大約20個測試,這些測試在Linux系統中具有多種功能。運行這些命令後,一組作業將出現在Jenkins界面中。

完成此操作後,你的Jenkins界面應如下所示:
在這裏插入圖片描述

運行測試

要手動運行作業,可以執行以下操作:

  1. 轉到Jenkins儀表板(在Jenkins主頁上)
  2. 選擇作業(包括板名稱和測試名稱)
  3. 單擊“構建作業”(Jenkins將運行測試稱爲“構建”它)

你也可以在Jenkins儀表板中,在帶有作業名稱的直線的最右邊單擊帶有綠色三角形的圓圈。

測試完成後,狀態將通過儀表板中測試側面的彩色球顯示。藍色表示成功,紅色表示失敗,灰色表示測試未完成(未運行或中止)。你可以通過單擊歷史記錄列表中的鏈接來獲取有關測試運行的詳細信息。

附加說明

板子文件中的其他變量

根據要運行的測試,你可能需要定義其他一些特定於你的主板或主板上文件系統配置的變量。請參閱添加電路板以獲取詳細說明以及目標上可能使用的變量的完整列表。

Jenkins界面

有關Jenkins Web界面的更多屏幕截圖,請參閱Jenkins用戶界面。如果你不熟悉此工具,這將有助於你熟悉Jenkins的某些功能。

故障排除

如果你在安裝或使用Fuego時遇到問題,請參閱我們的故障排除指南

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章