前面一節我們介紹了使用curl命令行工具訪問apiserver,命令行工具快速高效,但是對於輸出非常長的內容查看不是特別方便,尤其終端界面輸入的東西非常多的時候,過長的內容不是特別容易通過滾動快速定位到本次輸出內容的開始部分.也不便於復制到網頁在線json格式化工具里查看.命令行輸入過長的內容也更容易出錯.這里推薦使用postman工具來請求接口.當然postman對於較長的json查看也不是非常友好,但是我們可以通過ctrl+a復制所有內容,然后粘貼到在線json查看工具里查看.
工欲善其事,必先利其器.一個好的json查看工具對我們請求apiserver(或者其它返回json類型數據的接口)查看返回的json有着非常大的幫助作用.這里介紹兩個工具一個是在線的,另一個是notepad++的一個插件.
- 在線json查看工具
地址:http://www.bejson.com/jsonviewernew/
使用方法非常簡單,我們把想要查看的json字符串復制到粘貼到指定區域內,點擊格式化便可以對格式進行整理(kubernetes api返回的json為格式化過的,這里不用再格式化).點擊左上角的視圖標簽.我們便可以很清楚地看到json的整體結構
通過右邊面板可以看到都有哪些key
我們點擊有+號的折疊項,便可以通過右側的面板查看到其里面的鍵值
當然,我們也可以點擊+號本身來展示選項,直接在左側查看其包含的鍵值
如果折疊項是數組,我們點擊加號很容易看清楚數組里元素的個數
想要查看數組里元素的結構,展開其中任意一個即可.
2)Notepad++ jsonviewer插件
notepad++是windows平台下非常方便且功能強大的文本查看工具,本身並沒有json格式整理功能,可以通過安裝json viewer工具來格式化json.
打開Notepad++,在上面的菜單里選擇插件(Plugins)->插件管理(Plugins-Admin)這時候會出現一個插件管理對話框,我們從中找到json viewer並安裝.
新版本notepad++不帶插件管理功能,需要額外安裝.安裝方法查看這里
安裝完以后,我們把json復制到notepad++里,然后執行插件(Plugins)->JSON viewer->Format JSON便可以對json進行格式化.
還可以通過執行上圖中的Show JSON Viwer便可以調出一個單獨的窗口來查看json的結構,和上面web里差不多.
使用postman工具請求apiserver
下面我們進入正題,開始介紹如何通過postman工具請求apiserver
首先,我們通過scp等工具把上一節生成的myca.crt證書復制到windows機器上一份.然后雙擊打開.便會出現一個安裝按鈕,一直下一步直到安裝成功即可.
在centos上使用curl命令的時候,我們也不是必須每次都輸入--cert,可以全局添加ca信任即可.
我們打開postman工具,新建一個標簽輸入我們要請求的地址,點擊下面的Authorization,點擊Type下拉選擇,選擇Bearer Token然后在右側的token選項里輸入我們上一節獲取到的token,這時候就可以正常發送請求了
把token存儲為全局變量
我們可能經常要使用這個token來請求api,直接寫在頁面里如果頁面關閉就會丟失掉,把它存儲到文本文件每次都要粘貼都不是很方便.其實在postman里,我們可以把它存儲為一個變量,然后在需要使用的地方引用即可.
我們點擊postman右上角齒輪圖標,彈出設置窗口界面
在出現的彈出界面里選擇Globals,出現環境變量管理界面,在里面輸入一個key(任意名稱,引用時要使用)和值.設置完成后點擊save
我們把上面設置的Bearer token的token值改造一下,這里引用剛才設置的apiservertoken,格式為{{key}}
如果key正確,鼠標放在鍵上便會出現一個值預覽窗口.
當然,我們也可以把請求的基地址存儲為變量.改造后如下
快捷請求
我們從上面截圖可以看到,請求基地址會把所有的頂級api都返回,在postman里,可以直接在響應的body里點擊這些api的名稱,postman會打開一個新的窗口來請求它.比如我點擊api/v1便會出現一個新的請求界面.我們點擊下面的authorization然后選擇bearer token后面會自動把設置的token帶出來
我們可以點擊send發送一次請求.
postman針對大body布局優化.
有些api返回的json數量量比較大,但是body窗口比較小.我們可以通過調整布局來增加body空格的高度,以更方便查看.
我們點擊上面的view菜單,選擇toggle tow-panel view(快捷鍵ctrl+alt+v),這樣body視窗就會變得高一些.當然針對特別巨大的json這樣也往往無能為力,這就需要借助其它工具.大家可以使用自己喜歡的json查看工具或者嘗試前面推薦的兩款.