Question

使用Chart便于封装和管理kubernetes中的应用，因此当企业内部的应用多了以后，互相依赖、部署环境复杂之后，原先的直接使用yaml文件的管理方式已经不再适应生产的需要，因此我们有必要构建自己的chart仓库。本文中我们将使用 GitHub Pages 来构建我们自己的 chart 仓库。

目的

我们需要构建一个GitHub pages存储所有chart的压缩文件，最好还要有一个前端来展示和搜索chart。

什么是Chart

Chart是helm管理的应用的打包格式。它包括如下特征：

• Chart中包括一系列的yaml格式的描述文件。
• 一个Chart只用来部署单个的应用的，不应该过于复杂，不应该包含多个依赖，相当于一个微服务。

Chart有特定的目录结构，可以打包起来进行版本控制。

Chart的组成结构

我们以nginx的chart为例，讲解chart的组成结构。

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仓库本身没有设置身份和权限验证，查看此链接获取该问题的最新进展。

因为chart仓库只是一个HTTP服务，通过HTTP GET获取YAML文件和chart的压缩包，所以可以将这些文件存储在web服务器中，例如GCS、Amazon S3、GitHub Pages等。

关于chart仓库的更多信息请参考Helm chart文档。

使用GitHub pages托管charts

我们在上文中说到，chart可以使用GitHub pages做存储，接下来我们将会把之前够够构建的chart上传到GitHub pages并在helm中新增一个repo。

构建Monocular UI

克隆项目到本地

git clone https://github.com/kubernetes-helm/monocular.git

依赖环境

• Angular 2
• angular/cli
• Typescript
• Sass
• Webpack
• Bootstrap

在monoclar/scr/ui目录下执行以下命令安装依赖：

yarn install
npm install -g @angular/cli
npm install -g typescript
npm install -g webpack

运行

使用docker-compose

最简单的运行方式使用docker-compose：

docker-comopse up

该命令需要用到如下镜像：

• bitnami/mongodb:3
• bitnami/node:8
• quay.io/deis/go-dev:v1.5.0

会有一个很长的build过程，构建失败。

使用helm

首先需要已在本地安装了helm，并在kubernetes集群中安装了tiller，见使用helm管理kubernetes应用。

# 需要安装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
• Helm Chart - GitHub
• 简化Kubernetes应用部署工具-Helm之应用部署
• Speed deployment on Kubernetes with Helm Chart – Quick YAML example from scratch
• Using a private github repo as helm chart repo (https access)