從零開始建立Rancher Catalog模板 - Part 1

RobinTang 發(fā)布于2019-06-28 15:48 / 497人閱讀

摘要：提供了許多可重用的預(yù)先構(gòu)建好的程序棧的模板。從我們的目的來看，是一個能夠部署基于容器的程序棧并管理其生命周期的開源的軟件。注意和棧被展開以顯示每一個程序棧中的多個容器。文件是與模板相關(guān)的元數(shù)據(jù)的初始資源。

Rancher提供了許多可重用的、預(yù)先構(gòu)建好的程序棧的模板。拓展這些已有的模板或者創(chuàng)建并分享已完成的新模板，是參與Rancher用戶社區(qū)的好方式。同時，這也可以幫助你的組織更高效地利用基于容器的技術(shù)。這個系列的文章致力于通過現(xiàn)有的最好的工具和技術(shù)來幫助新Catalog模板的作者快速投入工作。

在這篇文章中，我們將構(gòu)建一個十分簡單（但不是非常有用）的Cattle Catalog模板。在下一篇文章中，我們將以更多細(xì)節(jié)來完善這個模板，直到我們擁有一個可以正常工作的、多容器的、基于NGINX的靜態(tài)網(wǎng)站，它利用了Rancher Compose、Docker Compose和Rancher Cattle所有的基礎(chǔ)設(shè)施。

概述和術(shù)語

在我們投身到創(chuàng)建一個新的Rancher Catalog模板之前，讓我們先來弄清楚一些通用的術(shù)語。如果你是一個有經(jīng)驗的Rancher用戶，你應(yīng)該能夠快速瀏覽本章節(jié)。如果你是Linux容器、集群管理以及容器編排世界的新手，那么現(xiàn)在是去google上進(jìn)行搜索的好時候。

從我們的目的來看，Rancher是一個能夠部署基于容器的程序棧、并管理其生命周期的開源的軟件。它支持大多數(shù)通常容易獲得的開源的容器編排框架。目前，Rancher對Docker容器和下面的編排框架有了極好的支持：

Kubernetes

Mesos

Docker Swarm

Rancher’s own Docker Compose-based Cattle

在確保考慮了其他框架的情況下，如果你最喜歡的框架仍然沒有被列出來，那么對這個框架的支持可能正在進(jìn)行中。

在先前提到的每一個自動化容器管理框架的背景下，Rancher包括一個預(yù)先建立好并且可重用的應(yīng)用模板的目錄。這些模板可能由一個單一的容器鏡像構(gòu)成，但是它們常常由多個鏡像拼接而成。模板能被填入特定環(huán)境的配置參數(shù)，并且可以通過Rancher管理員控制臺實例化在運行的程序棧中。下面的截屏是通過Rancher管理員控制臺看到的幾個程序棧。注意：WordPress和Prometheus棧被展開以顯示每一個程序棧中的多個容器。

在這篇文章中我們將會專注于Rancher自己的Cattle編排框架。看下面的圖片，它們是一些為Cattle裝配的預(yù)先建立好的Catalog模板的示例。

建立你的第一個Rancher Cattle Catalog模板

雖然許多時候這些預(yù)先建立好的Rancher Catalog模板可以直接裝配使用，但是有時你將需要修改一個模板（并且之后請你提交你的pull請求至上行流！），甚至當(dāng)你渴望的程序棧并不存在時從頭去創(chuàng)建一個新的模板。

手動建立它

就這個練習(xí)而言，我假定你有：

（1）一個運行著rancher/server容器的容器主機(jī)
（2）至少一個運行著rancher/agent的計算節(jié)點（就這個demo而言，（1）和（2）可以使同一臺主機(jī)）
（3）一個配置好的Rancher Cattle環(huán)境（默認(rèn)具有一個運行中的rancher/server實例）

添加一個定制的Cattle Catalog模板

默認(rèn)情況下，Rancher管理員控制臺上所列出的Catalog模板是來自于Rancher Community Catalog repository。我們將創(chuàng)建我們自己的git倉庫作為我們新的‘demo應(yīng)用’的Cattle Catalog模板。首先，我們要在我們自己的本地工作站上建立工作目錄。

盡管這里沒有什么高深的魔法，但還是讓我們按上面的步驟一步一步地來做：

在工作空間下建立一個名為“rancher-cattle-demo”的工程工作目錄。這些名字和路徑完全是任意的，但是你可能會發(fā)現(xiàn)根據(jù)以下慣例命名工作目錄和git倉庫是很有用的：rancher--。

創(chuàng)建git倉庫，若是在本地則使用”git init”命令，若是在GitHub上則通過“hub”途徑。

用Rancher Cattle目錄模板所必須的最小文件集合來填充這個倉庫。我們將馬上詳細(xì)地介紹這些內(nèi)容。

現(xiàn)在讓我們進(jìn)行這個示例模版的第一步提交及“git push”。

你可能想確保你成功地推送到了GitHub上面。下面是進(jìn)行上面的推送后我的賬戶的樣子：

值得注意的是，在上面的截圖中，我使用了Chrome瀏覽器插件Octotree來獲得整個倉庫文件系統(tǒng)完整的視圖。

現(xiàn)在讓我們配置Rancher以放入我們新的Catalog模板。這是在Admin/Setting菜單下，使用Rancher管理員控制臺完成的：

點擊頁面中間的“Add Catalog”前面的“+”號。一個你可以為新的Catalog倉庫輸入名字和URI的文本框會出現(xiàn)。在這次示范中，我為我們新的Catalog倉庫起的名字為“demo app”。填寫來自先前定制工作的其它定制的Catalog設(shè)置。

現(xiàn)在我們可以在Rancher管理員控制臺里的Catalog/demo應(yīng)用中查看容器模板的列表。在這個案例中就是我們的“demo app”模板。但是等等，什么地方錯了。

雖然我們已經(jīng)為Rancher Cattle模板成功創(chuàng)建了框架，但是我們既沒有為我們的模板放入任何的元數(shù)據(jù)，也沒有填充對于我們基于容器的應(yīng)用的定義或配置。

盡管基于dock-compose.yml和rancher-compose.yml的應(yīng)用值得用一整篇文章（或兩篇）來定義，但就目前來看，我們只會關(guān)注模板的基本元數(shù)據(jù)。換句話說，我們只會看一下config.yml的內(nèi)容。

最小的config.yml

Rancher文檔包含了關(guān)于config.yml的細(xì)節(jié)信息。雖然我們將要做的已經(jīng)足夠讓它工作起

來，但是也十分推薦深入的閱讀這個文檔。

config.yml

config.yml文件是與模板相關(guān)的元數(shù)據(jù)的初始資源。讓我們看一個最小的例子：

---name: Demo Appdescription: >
  A Demo App which does almost nothing of any practical value.
version: 0.0.1-rancher1
category: Toy Apps
maintainer: Nathan Valentine 
license: Apache2
projectURL: https://github.com/nrvale0/rancher-cattle-demo

萬一從文件名看不出來的話，元數(shù)據(jù)就會被指定為YAML。有了以上的YAML和git提交中的圖標(biāo)文件，讓我們看看模板的新狀態(tài)吧。

雖然這開始看起來好多了，但是目前我們創(chuàng)建的這個Catalog模板還沒什么實際性的作用。在這個系列的下一篇博文中，我們將介紹如何創(chuàng)建我們的程序棧（提示：它包含填充docker-compose.yml和rancher-compose.yml文件。）

一個更好的創(chuàng)建模板的方法

在我們轉(zhuǎn)移到應(yīng)用定義這個話題之前，我得告訴你個秘密。

在手動創(chuàng)建新的Catalog模板的時候不需要任何高深的魔法，這個過程很容易產(chǎn)生一些小而愚蠢的錯誤而引發(fā)問題。擁有一個能讓我們以快速的、可重復(fù)的，低錯誤的方式創(chuàng)建一個新的Catalog模板的工具將會是極好的。事實上，這種工具的確存在。Rancher社區(qū)已經(jīng)向The Yeoman Project提交了一個Rancher Catalog模板“產(chǎn)生器”。假定你有一個工作的Node.js環(huán)境，使用默認(rèn)的框架產(chǎn)生一個新的Cattle Catalog模板就像下面所示的過程一樣簡單。