系列目录
前面一节我们介绍了使用 curl 命令行工具访问 apiserver, 命令行工具快速高效, 但是对于输出非常长的内容查看不是特别方便, 尤其终端界面输入的东西非常多的时候, 过长的内容不是特别容易通过滚动快速定位到本次输出内容的开始部分. 也不便于复制到网页在线 JSON 格式化工具里查看. 命令行输入过长的内容也更容易出错. 这里推荐使用 postman 工具来请求接口. 当然 postman 对于较长的 JSON 查看也不是非常友好, 但是我们可以通过 ctrl+a 复制所有内容, 然后粘贴到在线 JSON 查看工具里查看.
工欲善其事, 必先利其器. 一个好的 JSON 查看工具对我们请求 apiserver(或者其它返回 JSON 类型数据的接口)查看返回的 JSON 有着非常大的帮助作用. 这里介绍两个工具一个是在线的, 另一个是 notepad++ 的一个插件.
1) 在线 JSON 查看工具
地址 http://www.bejson.com/jsonviewernew/ : 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 查看工具或者尝试前面推荐的两款.
来源: https://www.cnblogs.com/tylerzhou/p/11096745.html