如何从代码到制作并发布一个 Helm 包?

本文涉及的产品
容器镜像服务 ACR,镜像仓库100个 不限时长
简介: Helm 是什么?云原生领域应用打包和分发的事实标准,Helm Chart 通常包含 Docker 镜像及其基础设施配置,能够把一个 K8s 生态的应用完整封装,并且在另一个 K8s 环境正常的运行。为什么 Helm 会流行?核心功能有两点:对复杂的 Kubernetes YAML 做了打包和抽象,简化为少量参数。给出应用的概念,并给出了完整生命周期解决方案:制作、上传(托管)、版本化、分发、部署

Helm 是什么?

云原生领域应用打包和分发的事实标准,Helm Chart 通常包含 Docker 镜像及其基础设施配置,能够把一个 K8s 生态的应用完整封装,并且在另一个 K8s 环境正常的运行。

为什么 Helm 会流行?

核心功能有两点:

  1. 对复杂的 Kubernetes YAML 做了打包和抽象,简化为少量参数。
  2. 给出应用的概念,并给出了完整生命周期解决方案:制作、上传(托管)、版本化、分发、部署。

真正让他流行起来的原因是:

  1. 踩准了时机,当时(2018年) K8s 生态对 YAML 深恶痛绝但是苦于没有好的工具,快速形成了丰富的生态,如今已经有 1000+ 开箱即用的 Helm Chart:  https://artifacthub.io/

Helm Chart 解决了云原生应用交付所有问题了吗?

没有,这个问题以后会逐步回答,今天的重点是怎么玩好 Helm。

如何从源代码开始制作一个 Helm 包?

准备工具

  • git
  • docker
  • helm
  • velad
  • kubectl

从代码到容器镜像

Helm Chart 是对 Kubernetes 资源的打包,所以制作 Helm Chart 的前提是需要对 Kubernetes 的常用对象和容器镜像有基本的了解。如果你对这些概念不熟悉,可以直接跳转到如何部署 Helm 包 一节。

  1. 准备好你的代码,比如一个  2048 小游戏
git clone https://github.com/gabrielecirulli/2048.git
cd 2048
  1. 将代码构建成容器镜像,构建镜像需要编写一个  Dockerfile ,如果你对 Dockerfile 不太熟悉,没关系,对于所有前端项目而言,下面的 Dockerfile 基本是万能的,可以直接复用。

把以下内容复制到一个叫 Dockerfile 的文件中。

FROM nginx:latest
COPY . /usr/share/nginx/html

现在,我们的代码目录如下:

$ tree
.
├── CONTRIBUTING.md
├── Dockerfile
├── README.md
...
└── style
...

4 directories, 33 files
  1. 编译镜像
docker build -t 2048 .
  1. 本地试运行
docker run -p 8080:80 2048

你可以打开浏览器访问 http://127.0.0.1:8080 就能看到这个小游戏了。

  1. 为了镜像可以到处分发(让全世界的人都可以使用),你可以将镜像上传至一个容器的镜像仓库,主流的镜像仓库是  DockerHub

登录镜像仓库:

docker login --username <你的账号>

将镜像改成对应账号的格式:

docker tag 2048 wonderflow/2048:v1

推送镜像:

docker push wonderflow/2048:v1

现在你也可以使用我推送好的镜像了:

docker run -p 8080:80 wonderflow/2048:v1

镜像制作好了,开始制作 Helm 包。

制作 Helm 包#

  1. 使用 helm 工具生成配置的脚手架:
helm create my-game-2048

此时会生成一个新的文件夹 “my-game-2048”,里面的文件都是 helm 自动生成的:

.
├── CONTRIBUTING.md
├── Dockerfile
├── README.md
...
├── my-game-2048
│   ├── Chart.yaml
│   ├── charts
│   ├── templates
│   │   ├── NOTES.txt
│   │   ├── _helpers.tpl
│   │   ├── deployment.yaml
│   │   ├── hpa.yaml
│   │   ├── ingress.yaml
│   │   ├── service.yaml
│   │   ├── serviceaccount.yaml
│   │   └── tests
│   │       └── test-connection.yaml
│   └── values.yaml
└── style
  ...
  1. 修改镜像

在我们的场景下,默认生成的配置基本都是满足需求的,使用起来非常简单,就是把镜像改成我们的游戏镜像即可。

修改 values.yaml 文件里面的镜像,将其中 repository 一行的 nginx 改成 wonderflow/2048,tag 一行加上 v1 即可:

image:
- repository: nginx
+ repository: wonderflow/2048
  pullPolicy: IfNotPresent
  # Overrides the image tag whose default is the chart appVersion.
- tag: ""
+ tag: "v1"

测试 Helm 包

  1. 安装集群

Helm 包的运行依赖 Kubernetes 集群,一个最简单的安装方法是使用 velad.

下载 velad

curl -fsSl https://static.kubevela.net/script/install-velad.sh
  1. 部署集群
velad install --name foo --cluster-only
export KUBECONFIG=$(velad kubeconfig --name foo --host)
  1. 测试 Helm 包

本地文件夹部署:

helm install my-1024 my-game-2048

验证:

export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=my-game-2048,app.kubernetes.io/instance=my-1024" -o jsonpath="{.items[0].metadata.name}")
  export CONTAINER_PORT=$(kubectl get pod --namespace default $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
  echo "Visit http://127.0.0.1:8080 to use your application"
  kubectl --namespace default port-forward $POD_NAME 8080:$CONTAINER_PORT

浏览器访问 http://127.0.0.1:8080 就可以看到这个游戏。

验证完毕,我们的 helm chart 就制作完成了,更复杂的制作可以参考 Helm 官方文档

基于 GitHub 搭建 Helm 仓库做分发

为了让我们的 Helm Chart 可以被其他人使用,我们可以基于 GitHub Pages 功能,搭建一个 Helm 仓库。

  1. 创建文件夹 Helm Chart 仓库文件夹

跟源代码区分开来,我们创建一个新的文件夹。

mkdir docs
  1. 生成压缩包到指定目录
helm package my-game-2048 -d docs/
  1. 生成访问的 index 文件
cd docs/
helm repo index .
  1. 查看生成的内容:
$ cd ../
$ tree docs/
docs/
├── index.yaml
└── my-game-2048-0.1.0.tgz

0 directories, 2 files
  1. 推送到你的自己的 Github 仓库(可以直接 fork 2048 游戏的仓库):
git add .
git commit -m "my first helm repo"
git push 

经过我们的实验,结果仓库为: https://github.com/wonderflow/2048

  1. 配置开启 GitHub Pages

配置路径: settings => Pages 设置 Sources 指向 master 分支,路径读取 docs/ 。

  1. 至此我们就已经有了一个 helm 仓库了:
helm repo add my-repo https://<你的github账号>.github.io/2048
helm repo update

如何部署 Helm 包?#

对于我本次的实验仓库而言: https://github.com/wonderflow/2048 ,已经可以直接使用这个仓库部署:

  1. 添加仓库
helm repo add my-repo https://wonderflow.github.io/2048
helm repo update
  1. 部署 Helm 应用
helm install my-2048 my-repo/my-game-2048

到这里,就完成了一个 Helm 的基本部署。

相关实践学习
通过容器镜像仓库与容器服务快速部署spring-hello应用
本教程主要讲述如何将本地Java代码程序上传并在云端以容器化的构建、传输和运行。
Kubernetes极速入门
Kubernetes(K8S)是Google在2014年发布的一个开源项目,用于自动化容器化应用程序的部署、扩展和管理。Kubernetes通常结合docker容器工作,并且整合多个运行着docker容器的主机集群。 本课程从Kubernetes的简介、功能、架构,集群的概念、工具及部署等各个方面进行了详细的讲解及展示,通过对本课程的学习,可以对Kubernetes有一个较为全面的认识,并初步掌握Kubernetes相关的安装部署及使用技巧。本课程由黑马程序员提供。 &nbsp; 相关的阿里云产品:容器服务 ACK 容器服务 Kubernetes 版(简称 ACK)提供高性能可伸缩的容器应用管理能力,支持企业级容器化应用的全生命周期管理。整合阿里云虚拟化、存储、网络和安全能力,打造云端最佳容器化应用运行环境。 了解产品详情:&nbsp;https://www.aliyun.com/product/kubernetes
相关文章
|
Kubernetes NoSQL 关系型数据库
通过helm部署gitlab服务
通过helm部署gitlab服务
|
Kubernetes API Docker
k8s教程(pod篇)-容器获取pod信息(Downward API)
k8s教程(pod篇)-容器获取pod信息(Downward API)
1520 0
|
存储 Kubernetes 监控
Open-Local - 云原生本地磁盘管理系统
Open-Local是由多个组件构成的本地磁盘管理系统,目标是解决当前 Kubernetes 本地存储能力缺失问题。通过Open-Local,使用本地存储会像集中式存储一样简单。
Open-Local - 云原生本地磁盘管理系统
|
存储 JSON 运维
直击痛点,详解 K8s 日志采集最佳实践
在 Kubernetes 中,日志采集和普通虚拟机的方式有很大不同,相对实现难度和部署代价也略大,但若使用恰当则比传统方式自动化程度更高、运维代价更低。
直击痛点,详解 K8s 日志采集最佳实践
|
7月前
|
Kubernetes 搜索推荐 应用服务中间件
制作KubeVirt镜像
制作KubeVirt镜像
198 13
|
7月前
|
存储 Kubernetes 算法框架/工具
Kubevirt
Kubevirt
287 12
|
9月前
|
存储 Kubernetes 安全
第四章 Helm仓库介绍配置国内仓库地址
第四章 Helm仓库介绍配置国内仓库地址
2410 2
|
Kubernetes 安全 关系型数据库
Helm入门(一篇就够了)
Helm快速入门
13586 0
|
Kubernetes 监控 安全
基于containerd部署的k8s集群
基于containerd部署的k8s集群。
2067 1
|
Prometheus Kubernetes 监控
NVIDIA GPU Operator分析六:NVIDIA GPU Operator原理分析
背景我们知道,如果在Kubernetes中支持GPU设备调度,需要做如下的工作:节点上安装nvidia驱动节点上安装nvidia-docker集群部署gpu device plugin,用于为调度到该节点的pod分配GPU设备。除此之外,如果你需要监控集群GPU资源使用情况,你可能还需要安装DCCM exporter结合Prometheus输出GPU资源监控信息。要安装和管理这么多的组件,对于运维
2876 0

热门文章

最新文章