?摘要：Kubernetes是Google開(kāi)源的容器集群管理系統(tǒng)。它構(gòu)建Ddocker技術(shù)之上，為容器化的應(yīng)用提供資源調(diào)度、部署運(yùn)行、服務(wù)發(fā)現(xiàn)、擴(kuò)容縮容等整一套功能，本文節(jié)選自龔正的《kubernetes權(quán)威指南》一書(shū)的第三章3.2節(jié)，獲得出版社和作者的獨(dú)家授權(quán)發(fā)布。本節(jié)重點(diǎn)講述了kubernetes的API概述。
　　Kubernetes API概述
　　Kubernetes API是集群系統(tǒng)中的重要組成部分，Kubernetes中各種資源（對(duì)象）的數(shù)據(jù)通過(guò)該API接口被提交到后端的持久化存儲(chǔ)（etcd）中，Kubernetes集群中的各部件之間通過(guò)該API接口實(shí)現(xiàn)解耦合，同時(shí)Kubernetes集群中一個(gè)重要且便捷的管理工具kubectl也是通過(guò)訪問(wèn)該API接口實(shí)現(xiàn)其強(qiáng)大的管理功能的。Kubernetes API中的資源對(duì)象都擁有通用的元數(shù)據(jù)，資源對(duì)象也可能存在嵌套現(xiàn)象，比如在一個(gè)Pod里面嵌套多個(gè)Container。創(chuàng)建一個(gè)API對(duì)象是指通過(guò)API調(diào)用創(chuàng)建一條有意義的記錄，該記錄一旦被創(chuàng)建，Kubernetes將確保對(duì)應(yīng)的資源對(duì)象會(huì)被自動(dòng)創(chuàng)建并托管維護(hù)。
　　在Kubernetes系統(tǒng)中，大多數(shù)情況下，API定義和實(shí)現(xiàn)都符合標(biāo)準(zhǔn)的HTTP REST格式， 比如通過(guò)標(biāo)準(zhǔn)的HTTP動(dòng)詞（POST、PUT、GET、DELETE）來(lái)完成對(duì)相關(guān)資源對(duì)象的查詢、創(chuàng)建、修改、刪除等操作。但同時(shí)Kubernetes 也為某些非標(biāo)準(zhǔn)的REST行為實(shí)現(xiàn)了附加的API接口，例如Watch某個(gè)資源的變化、進(jìn)入容器執(zhí)行某個(gè)操作等。另外，某些API接口可能違背嚴(yán)格的REST模式，因?yàn)榻涌诓皇欠祷貑我坏腏SON對(duì)象，而是返回其他類型的數(shù)據(jù)，比如JSON對(duì)象流（Stream）或非結(jié)構(gòu)化的文本日志數(shù)據(jù)等。
　　Kubernetes開(kāi)發(fā)人員認(rèn)為，任何成功的系統(tǒng)都會(huì)經(jīng)歷一個(gè)不斷成長(zhǎng)和不斷適應(yīng)各種變更的過(guò)程。因此，他們期望Kubernetes API是不斷變更和增長(zhǎng)的。同時(shí)，他們?cè)谠O(shè)計(jì)和開(kāi)發(fā)時(shí)，有意識(shí)地兼容了已存在的客戶需求。通常，新的API資源（Resource）和新的資源域不希望被頻繁地加入系統(tǒng)。資源或域的刪除需要一個(gè)嚴(yán)格的審核流程。
　　為了方便查閱API接口的詳細(xì)定義，Kubernetes使用了swagger-ui提供API在線查詢功能，其官網(wǎng)為http://kubernetes.io/third_party/swagger-ui/，Kubernetes開(kāi)發(fā)團(tuán)隊(duì)會(huì)定期更新、生成UI及文檔。Swagger UI是一款REST API文檔在線自動(dòng)生成和功能測(cè)試軟件，關(guān)于Swagger的內(nèi)容請(qǐng)?jiān)L問(wèn)官網(wǎng)http://swagger.io。
　　運(yùn)行在Master節(jié)點(diǎn)上的API Server進(jìn)程同時(shí)提供了swagger-ui的訪問(wèn)地址：http://： /swagger-ui/。假設(shè)我們的API Server安裝在192.168.1.128服務(wù)器上，綁定了8080端口，則可以通過(guò)訪問(wèn)