# 構建私有Chart倉庫 使用Chart便于封裝和管理kubernetes中的應用，因此當企業內部的應用多了以后，互相依賴、部署環境復雜之后，原先的直接使用yaml文件的管理方式已經不再適應生產的需要，因此我們有必要構建自己的chart倉庫。本文中我們將使用 GitHub Pages 來構建我們自己的 chart 倉庫。 ## 目的 我們需要構建一個GitHub pages存儲所有chart的壓縮文件，最好還要有一個前端來展示和搜索chart。 ## 什么是Chart Chart是helm管理的應用的打包格式。它包括如下特征： - Chart中包括一系列的yaml格式的描述文件。 - 一個Chart只用來部署單個的應用的，不應該過于復雜，不應該包含多個依賴，相當于一個微服務。 Chart有特定的目錄結構，可以打包起來進行版本控制。 ### Chart的組成結構 我們以nginx的chart為例，講解chart的組成結構。 ```bash nginx/ Chart.yaml # 必須：一個包含chart的名稱、版本和啟用條件信息等的YAML文件 LICENSE # 可選: chart的許可證 README.md # 可選: 使用說明 requirements.yaml # 可選: 該chart的依賴配置 values.yaml # 必須：該chart的默認配置值 charts/ # 可選: 包含該chart依賴的chart templates/ # 可選：kubernetes manifest文件模板，用于生成kubernetes yaml文件 templates/NOTES.txt # 可選: 該chart的使用說明和提示信息文本文件，作為helm install后的提示信息 ``` ### Chart的安裝方式 安裝chart主要分為安裝本地定義的chart和遠程chart倉庫中的chart兩種方式。 **安裝本地chart** - 指定本地chart目錄：helm install . - 指定本地chart壓縮包：helm install nginx-1.2.3.tgz **安裝chart倉庫中的chart** - 使用默認的遠程倉庫：helm install stable/nginx - 使用指定的倉庫：helm install localhost:8879/nginx-1.2.3.tgz 實際上可以將chart打包后作為靜態文件托管到web服務器上，例如GitHub pages作為chart倉庫也可以。 ### 依賴管理 有兩種方式來管理chart的依賴。 - 直接在本的chart的`charts`目錄下定義 - 通過在`requirements.yaml`文件中定義依賴的chart 在每個chart的`charts`目錄下可以定義依賴的子chart。子chart有如下特點： - 無法訪問父chart中的配置 - 父chart可以覆蓋子chart中的配置 ## Chart倉庫 Chart 倉庫（repository）是一個用來托管`index.yaml`文件和打包好的chart文件的web服務器。當前chart倉庫本身沒有設置身份和權限驗證，查看[此鏈接](https://github.com/kubernetes/helm/issues/1038)獲取該問題的最新進展。 因為chart倉庫只是一個HTTP服務，通過HTTP GET獲取YAML文件和chart的壓縮包，所以可以將這些文件存儲在web服務器中，例如GCS、Amazon S3、GitHub Pages等。 關于chart倉庫的更多信息請參考[Helm chart文檔](https://github.com/kubernetes/helm/blob/master/docs/chart_repository.md)。 ## 使用GitHub pages托管charts 我們在上文中說到，chart可以使用GitHub pages做存儲，接下來我們將會把之前夠夠構建的chart上傳到GitHub pages并在helm中新增一個repo。 ## 構建Monocular UI 克隆項目到本地 ```bash git clone https://github.com/kubernetes-helm/monocular.git ``` ### 依賴環境 - [Angular 2](https://angular.io/) - [angular/cli](https://github.com/angular/angular-cli) - Typescript - Sass - [Webpack](https://webpack.github.io/) - Bootstrap 在`monoclar/scr/ui`目錄下執行以下命令安裝依賴： ```bash yarn install npm install -g @angular/cli npm install -g typescript npm install -g webpack ``` ## 運行 ### 使用docker-compose 最簡單的運行方式使用[docker-compose](https://docs.docker.com/compose/)： ```bash docker-comopse up ``` 該命令需要用到如下鏡像： - bitnami/mongodb:3 - bitnami/node:8 - quay.io/deis/go-dev:v1.5.0 會有一個很長的build過程，構建失敗。 ### 使用helm 首先需要已在本地安裝了helm，并在kubernetes集群中安裝了tiller，見[使用helm管理kubernetes應用](helm.md)。 ```bash # 需要安裝nginx ingress $ helm install stable/nginx-ingress $ helm repo add monocular https://kubernetes-helm.github.io/monocular $ helm install monocular/monocular ```  因為nginx ingress配置問題，官方的chart中api與ui使用的是同樣的domain name，我使用的是traefik ingress，`api`訪問不到，所以加載不了chart。 ## 參考 - [Monocular UI](https://github.com/kubernetes-helm/monocular) - [Helm Chart - GitHub](https://github.com/kubernetes/helm/blob/master/docs/charts.md) - [簡化Kubernetes應用部署工具-Helm之應用部署](https://www.kubernetes.org.cn/2706.html) - [Speed deployment on Kubernetes with Helm Chart – Quick YAML example from scratch](https://www.ibm.com/blogs/bluemix/2017/10/quick-example-helm-chart-for-kubernetes/) - [Using a private github repo as helm chart repo (https access)](https://medium.com/@kavehmz/using-a-private-github-repo-as-helm-chart-repo-https-access-95629b2af27c)