這裡將簡單介紹teuthology中自動化測試的用例的編寫。Ceph的自動化測試使用yaml檔案描述，如下的例子搭建了一個三節點的Ceph叢集，終端在叢集搭建好後停止在python的interactive上，允許測試著呼叫相關的函式與叢集互動。

roles:
- [mon.0, mds.0, osd.0]
- [mon.1, osd.1]
- [mon.2, client.0]

tasks:
- install:
- ceph:
- ceph-fuse: [client.0]
- interactive:

targets:
  [email protected]<host1>: ssh-rsa <host1 key>
  
 
[email protected]<host2>: ssh-rsa <host2 key>
  [email protected]<host3>: ssh-rsa <host3 key>

基礎模組介紹

roles

roles需要與targets下的節點相互對應，每一組對應targets中的一個人節點。書寫形式可以如例子中的，一行一組，也可以使用- - 來區分組。例如：

roles：
-- mon.0
 - mds.0
 - osd.0
-- mon.1
 - osd.1
-- mon.2
 - client01
 

該部分描述了怎樣去使用host，每一組表示了某一個host上的角色，例如上面這個說明了host1上將會包含一個mon.0、mds.0、osd.0。

tasks

tasks 只需要執行的任務，這裡只簡單介紹，後面將主要講解tasks，給出支援的tasks與使用範例。 task是一個python的模組，它處於teuthology.task 的包中，另外task也包含了ceph/qa/tasks下的任務，如 ceph這個任務，teuthology執行到對應的tasks時候，會首先import本身目錄下的tasks，也就是teuthology.task，如果沒有則import ceph/qa/tasks，如果還沒找到對應的任務模組則會報錯。它包含兩個引數分別是ctx、config，例如install這個task的函式定義為：

def task(ctx, config):

每一個任務的python程式碼中都有這樣的一個函式，該定義位於 teuthology.task.install下
其中 引數的解釋為：

ctx: a context that is available through the lifetime of the test run, and has useful attributes such as cluster, letting the task access the remote hosts. Tasks can also store their internal state here. (TODO beware of namespace collisions.)

config: the data structure after the colon in the config file, e.g. for the above ceph-fuse example, it would be a list like [“client.0”].

前面也說到，tasks將會從teuthology.task 和ceph/qa/tasks中尋找，所以teuthology所支援的任務型別都可以在這兩個目錄下找到，這裡只是簡單的說明下列子中的任務，更詳細的將會在後面另外作為一個章節介紹。

示例yaml中的tasks包含四個任務：

1. install 該任務是teuthology.task下的任務，它負責根據作業系統型別安裝Ceph的包，CentOS則安裝rpm包，ubuntu則安裝deb包。teuthology.task.install下有一個packages.yaml，它描述了需要安裝的軟體包。
2. ceph 該任務主要是 部署其一個ceph叢集，它是ceph/qa/tasks 下的任務。Teuthology執行到ceph任務的時候就會呼叫 ceph/qa/tasks 下的ceph.py 檔案。
3. ceph-fuse 該任務表示使用ceph-fuse掛在檔案系統，它包含了一個引數 client.0
4. interactive 該任務是teuthology自身包含的任務，該任務很簡單，直接呼叫python 的interactive模組調出 互動程式，給使用者使用。 該任務的描述：
   The interactive task presents a prompt for you to interact with the teuthology configuration.
   This is also useful to pause the execution of the test between two tasks, either to perform ad hoc operations,or to examine the state of the cluster. Hit control-D to continue when done.

該例子中，interactive是最後一個任務，當按下 control-D之後，teuthology將會認為任務完成，測試結束，然後開始清空節點的所有內容，解除安裝Ceph叢集，恢復節點測試之前的狀態。

targets

該模組表示測試將選擇的節點，它每一行表示測試將要執行的節點的名字和祕鑰，格式為：“[email protected]: ssh-rsa long_hostkey_here”，在使用teuthology執行的時候，需要將對應數量的節點lock住，給其使用。

執行該測試用例

將上面的列子稍微修改，然後儲存為example.yaml。

鎖住型別為plana的3臺機器

teuthology-lock --lock-many 3 --machine-type plana

執行yaml檔案

teuthology example.yaml --suite-path /home/foo/src/github.com_ceph_ceph_master/qa/

suite-path 後面的路徑是ceph/qa/的路徑，不指定也可以，teuthology將會自己根據配置檔案尋找，並匯入 os.path。

這一步是對前面整個平臺的總體驗證，其中可能會出現很多問題，但是其實都不難解決。另外這一塊執行出錯，百度或者谷歌其實都很難搜尋得到。建議耐心去看輸出的資訊，然後去看看程式碼，也可以在程式碼中加log，輸出更多的資訊來觀察分析，出錯的地方。然後去解決它就行了，有時候會發現，就只是。。。。配置檔案出錯了而已。

Ceph中的suite測試

Suite測試指的是ceph-qa-suite下的測試，目前該專案整和到了Ceph專案下，ceph/qa/suite 下。每一個suite其實是一個directory ，下面又會包含子目錄或者yam檔案。這些yaml檔案通過排列組合形成suite的job，一個suite包含很多的job，一個job就是一寫yaml檔案組合在一個的，一個job包含一些task。

Teuthology測試

Teuthology中包含很多的命令，teuthology-suite命令是用來跑suite測試的，而teuthology是用來跑自定義的測試的。這些都可以通過 #teuthology –help以及#teuthology-suite –help 來檢視相關幫助。

teuthology-suite -s <suite> [-c <ceph>][-k <kernel>][-e email][-f flavor][-t <teuth>][-m <mtype>]

其實很多引數不是必須的，因為其都有預設值，在help中都可以看的到。

• suite: the name of the suite (the directory in ceph-qa-suite).
• ceph: ceph branch to be used.
• kernel: version of the kernel to be used.
• email: email address to send the results to.
• flavor: the kernel flavor to run against
• teuth: version of teuthology to run
• mtype: machine type of the run
• templates: template file used for further modifying the suite (optional)

這裡舉一個例子，加入需要測試一個rbd/librbd的包含CentOS關鍵字的測試的JOB，也可以在猴米艾尼加一個過濾的引數。

#teuthology-suite -v -s rbd/librbd -c master -m plana -S 9106dcXXXXXXXXXXXXX --filter centos

其中 -v表示輸出的日誌會包含debug

-s 表示suite 這裡是suite的目錄，如果測整個rbd直接 -s rbd 就行
-c 表示ceph的branch
-m 表示跑測試使用的資源節點的型別
-S 表示該branch下的某一個commit ID
–filter 表示過濾，只執行那些描述包含centos的job

另外還包含了以下的命令，只列出一些，不再展開，可以檢視–help
teuthology 執行ceph的整合測試
teuthology-suite 執行一系列（suite）的整合測試，一個suite是一個directory，下面有子目錄和yaml檔案
teuthology-kill 殺掉執行的teuthology的job，會清空佇列，殺死正在跑的job，然後重置相關的機器
teuthology-queue 檢視佇列中的job
teuthology-nuke 重置測試的機器
teuthology-lock 解鎖或者鎖住機器等
…………………………………………………………………………………………………………………………………………………………………………………………………………..