只需幾個簡單的步驟即可在你的硬件上從Fuego
運行測試。
注意:這是快速入門指南。有關更多詳細信息和說明,請參考:安裝Fuego
概述
這些步驟的概述是:
- 安裝必備軟件
- 下載
fuego
資料庫 - 建立你的
fuego
容器 - 啓動容器
- 進入界面
- 將你的板子添加到
fuego
- 進行測試
這些步驟如下所述。
安裝必備軟件
要檢索fuego
軟件併爲其創建docker
鏡像,你需要在系統上安裝git
和docker
。在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
,需要執行三個主要步驟:
- 在目標上創建測試目錄
- 創建一個板文件(在主機上)
- 將你的板子添加到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
編輯板文件中的變量以匹配你的板子。大多數變量可以保留,但是你需要更改IPADDR
,TOOLCHAIN
和ARCHITECTURE
變量,並將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
界面應如下所示:
運行測試
要手動運行作業,可以執行以下操作:
- 轉到
Jenkins
儀表板(在Jenkins
主頁上) - 選擇作業(包括板名稱和測試名稱)
- 單擊“構建作業”(
Jenkins
將運行測試稱爲“構建”它)
你也可以在Jenkins
儀表板中,在帶有作業名稱的直線的最右邊單擊帶有綠色三角形的圓圈。
測試完成後,狀態將通過儀表板中測試側面的彩色球顯示。藍色表示成功,紅色表示失敗,灰色表示測試未完成(未運行或中止)。你可以通過單擊歷史記錄列表中的鏈接來獲取有關測試運行的詳細信息。
附加說明
板子文件中的其他變量
根據要運行的測試,你可能需要定義其他一些特定於你的主板或主板上文件系統配置的變量。請參閱添加電路板以獲取詳細說明以及目標上可能使用的變量的完整列表。
Jenkins
界面
有關Jenkins Web
界面的更多屏幕截圖,請參閱Jenkins用戶界面。如果你不熟悉此工具,這將有助於你熟悉Jenkins
的某些功能。
故障排除
如果你在安裝或使用Fuego
時遇到問題,請參閱我們的故障排除指南