Harbor+Helm Chart构建k8s应用程序打包存储发布的基础环境

Posted 2020-12-18

Harbor

简介

Harbor是由VMware公司中国团队为企业用户设计的 Registry server开源项目，包括了权限管理(RBAC)、LDAP、审计、管理界面、自我注册、HA、RESTful API等企业必需的功能，属于Cloud Native Computing Foundation（CNCF，云原生计算基金会）的毕业项目。

我们建议使用2.0以后的版本，Harbor在2.0以后的版本使Harbor成为第一个符合OCI（Open Container Initiative，开放容器倡议）标准的开源Registry server，能够存储大量云原生组件，例如container images、Helm Chart、OPAs、CNAB、Singularity等。

目前，Harbor最新稳定版本为2.1，本文使用此版本部署。

部署

1,我们的需求如下

• 提供registey服务的域名为registry.myk8s.com
• 我们需要把域名解析到有外网ip的nginx上，然后nginx给Harbor做代理
• 我们给Harbor单独提供一个分区挂载到了/data1目录

2,现在准备docker环境：

# yum install docker-ce -y
# yum install docker-compose -y
# systemctl start docker

3,Harbor安装配置：

# wget https://github.com/goharbor/harbor/releases/download/v2.0.1/harbor-online-installer-v2.0.1.tgz
# tar xf harbor-online-installer-v2.0.1.tgz
# cd harbor

# vim harbor.yml
hostname: registry.myk8s.com  #服务的域名

https: # 如下配置域名的证书
  certificate: /opt/registry.myk8s.com.crt
  private_key: /opt/registry.myk8s.com.key

external_url: https://registry.myk8s.com # 由于要用nginx做代理，故需要配置

harbor_admin_password: 123546  # 设置harbor默认admin用户的密码

data_volume: /data1 # 设置存储卷

# bash install.sh

最后install.sh会执行安装操作，需要从外网下载镜像，故需要一定的时间。

4,公网nginx配置给Harbor做代理转发:

• 给nginx添加vhost如下

  # vim registry.myk8s.com.conf
  server {
  listen 443;
         access_log /data0/logs/registry.myk8s.com.log main;
         server_name registry.myk8s.com;
         location / {
                 proxy_pass https://x.x.x.x:443;
                 proxy_set_header  Host registry.myk8s.com;
         }
  }

• 重启nginx

  # systemctl reload nginx

  5,访问Harbor界面和配置

• 访问url：https://registry.myk8s.com
• 登陆界面之后，可以创建私有项目和不同权限的新用户，然后给用户绑定到不同的项目。私有项目需要对应用户的凭证才能访问。
• 也可以创建公共项目，公共项目不需要凭证就可以访问

推送docker image到Harbor的私有test项目

说到使用image就离不开要理解image的tag，我们先来理解下tag的作用：
1，docker可以为image的每一个commit ID创建一个tag
docker image将文件等信息的变动抽象为一次次的commit，每一次commit以后会生成一串无规则的字符串代表此次生成的image的ID，此时，tag的作用就是为这个ID创建一个友好的NAME，方便我们对镜像库的管理。
2，docker可以为给一个本地存在的image创建一个指向远程registry server的tag
3，一个image可以有多个tag，不同的tag可以用来区分不同的版本

# docker login registry.myk8s.com # 输入用户名和密码

# docker tag tutum/dnsutils registry.myk8s.com/test/dnsutils:latest
# docker push registry.myk8s.com/test/dnsutils:latest

对比docker registry

docker registry也提供镜像仓库的功能，但是Harbor功能更为强大。主要提供了docker registry所没有的镜像同步，用户角色权限控制，Helm Chart仓库支持等。

Helm Chart

简介

Helm是一个开源的k8s包管理器，属于Cloud Native Computing Foundation（CNCF，云原生计算基金会）的毕业项目。它能够把创建一个应用所需的所有Kubernetes API对象声明文件组合并打包在一起，并提供了仓库的机制便于存储和分发共享，还支持模版变量替换，同时还有版本的概念，使之能够对一个应用进行版本的管理。

Helm的主要组件如下：

• helm cli：helm的命令行客户端工具，主要用于k8s应用程序Chart的创建、打包、发布以及创建和管理本地和远程的Chart仓库。
• Chart：Helm的软件包，采用tar格式。类似于YUM的rpm包，其包含了一组定义k8s资源相关的YAML文件。
• Repoistory：Helm的软件仓库，Repository本质上是一个Web服务器，该服务器保存了一系列的Chart软件包以供用户下载，并且提供了一个该Repository的Chart包的清单文件以供查询。Helm可以同时管理多个不同的Repository。
• Release：使用helm install命令在Kubernetes集群中部署的Chart称为Release。

在Helm中，一个Chart可能依赖于任何数量的其他Chart。这些依赖关系可以通过requirements.yaml文件动态链接或引入Charts/目录并手动管理。

helm3在2019年年底发布，移除了Tiller，支持推送Chart包到Harbor registry server。目前helm最新稳定版为helm 3.2.4，本位使用此版本部署。

架构

安装

在官方网站https://github.com/helm/helm/releases下载helm3以上的最新稳定二进制版本：

# wget https://get.helm.sh/helm-v3.2.4-linux-amd64.tar.gz
# tar xf helm-v3.2.4-linux-amd64.tar.gz
# mv linux-amd64/helm /usr/local/bin/helm

# helm version
version.BuildInfo{Version:"v3.2.4", GitCommit:"0ad800ef43d3b826f31a5ad8dfbb4fe05d143688", GitTreeState:"clean", GoVersion:"go1.13.12"}

使用

公共仓库

helm有自己的官方公开仓库https://hub.helm.sh/，里面有开发者贡献的一些常见应用的Chart。如果有使用开源软件的需求可以在上面搜索直接下载使用。当然，也可以自己搭建Harbor registry server创建公共仓库。

我们以在k8s集群部署cerebro应用为例子，需要先添加应用对应的repo，然后进行安装：

# helm repo add stable https://kubernetes-charts.storage.googleapis.com
# helm repo list
NAME        URL
stable      https://kubernetes-charts.storage.googleapis.com

# helm install stable/cerebro --version 1.1.4  --generate-name

# helm list
NAME                NAMESPACE   REVISION    UPDATED                                 STATUS      CHART           APP VERSION
cerebro-1591777586  default     1           2020-07-22 16:26:30.419723417 +0800 CST deployed    cerebro-1.1.4   0.8.4

# kubectl get pods|grep cerebro
cerebro-1591777586-7fd87f7d48-hmlp7   1/1     Running   0          11m

私有仓库

1，我们把helm hub的cerebro应用下载到本地，需要再给helm安装push插件，然后给推送到我们自己的Harbor registry server上。

# helm repo add stable https://kubernetes-charts.storage.googleapis.com
# helm pull stable/cerebro
# tar xf cerebro-1.9.2.tgz

# yum install git -y
# helm plugin install https://github.com/chartmuseum/helm-push.git

# export  HELM_EXPERIMENTAL_OCI=1
[root@master2 ~]# helm chart save cerebro registry.myk8s.com/test/cerebro:v1.9.2
ref:     registry.myk8s.com/test/cerebro:v1.9.2
digest:  d32e30e72bb1929b6cf7e46381e7d54f01fc5926c638ef5a47547e0fa24822d5
size:    5.4 KiB
name:    cerebro
version: 1.9.2
v1.9.2: saved

# helm registry login https://registry.myk8s.com
Username: username
Password:
Login succeeded

# helm chart push registry.myk8s.com/test/cerebro:v1.9.2
The push refers to repository [registry.myk8s.com/test/cerebro]
ref:     registry.myk8s.com/test/cerebro:v1.9.2
digest:  d32e30e72bb1929b6cf7e46381e7d54f01fc5926c638ef5a47547e0fa24822d5
size:    5.4 KiB
name:    cerebro
version: 1.9.2
v1.9.2: pushed to remote (1 layer, 5.4 KiB total)

注意：
如果helm-push安装失败，需要通过一些办法把https://github.com/chartmuseum/helm-push/releases/download/v0.8.1/helm-push_0.8.1_linux_amd64.tar.gz文件下载到服务器，然后通过如下方法安装：

# tar xf helm-push_0.8.1_linux_amd64.tar.gz
# mkdir -p /root/.local/share/helm/plugins/helm-push.git/bin/
# cp bin/helmpush /root/.local/share/helm/plugins/helm-push.git/bin/

2，我们自己初始化一个简单的Chart，默认会安装一个nginx应用, 然后给推送到Harbor registry server。

# helm create helm-test
# vim helm-test/values.yaml # 修改相关Chart的配置

# helm package helm-test
# helm  install helm-test-0.1.0.tgz --generate-name # 在本地k8s安装应用
# helm list
helm-test-0-1595410957  default     1           2020-07-22 17:42:38.051204463 +0800 CST deployed    helm-test-0.1.0 1.16.0

# helm chart save helm-test registry.myk8s.com/test/helm-test:v2
ref:     registry.myk8s.com/test/helm-test:v2
digest:  7f1f17b1516d9173b3368cb64393ec31ad8b818b722b743b31276f49c1c36cf9
size:    3.5 KiB
name:    helm-test
version: 0.1.0
v2: saved

# helm chart push registry.myk8s.com/test/helm-test:v2
The push refers to repository [registry.myk8s.com/test/helm-test]
ref:     registry.myk8s.com/test/helm-test:v2
digest:  7f1f17b1516d9173b3368cb64393ec31ad8b818b722b743b31276f49c1c36cf9
size:    3.5 KiB
name:    helm-test
version: 0.1.0
v2: pushed to remote (1 layer, 3.5 KiB total)

对比CNAB规范

Helm Chart只能用于k8s应用程序的包管理，而CNAB应用更为广泛。Cloud Native Application Bundles (CNAB) 是全新的开源打包格式规范，通过一个可安装文件就能管理多款，在不同环境中配置应用程序资源并分布式应用，在不同环境中配置应用程序资源，无需多个工具集就能轻松管理应用程序的生命周期。它兼容Azure，on-prem OpenStack, Kubernetes, Swarm, Ansible, Terraform等平台。

总结

目前Helm Chart是主流的k8s包管理工具，而Harbor也是主流的registry server，值的我们研究使用。

参考

https://goharbor.io/docs/2.0.0/install-config/
https://goharbor.io/docs/2.0.0/working-with-projects/working-with-images/managing-helm-charts/
https://goharbor.io/blog/harbor-2.0/
https://helm.sh/docs/intro/install/
https://helm.sh/docs/