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

本文涉及的产品
容器镜像服务 ACR,镜像仓库100个 不限时长
容器服务 Serverless 版 ACK Serverless,317元额度 多规格
容器服务 Serverless 版 ACK Serverless,952元额度 多规格
简介: 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代码程序上传并在云端以容器化的构建、传输和运行。
深入解析Docker容器化技术
Docker是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的Linux机器上,也可以实现虚拟化,容器是完全使用沙箱机制,相互之间不会有任何接口。Docker是世界领先的软件容器平台。开发人员利用Docker可以消除协作编码时“在我的机器上可正常工作”的问题。运维人员利用Docker可以在隔离容器中并行运行和管理应用,获得更好的计算密度。企业利用Docker可以构建敏捷的软件交付管道,以更快的速度、更高的安全性和可靠的信誉为Linux和Windows Server应用发布新功能。 在本套课程中,我们将全面的讲解Docker技术栈,从环境安装到容器、镜像操作以及生产环境如何部署开发的微服务应用。本课程由黑马程序员提供。 &nbsp; &nbsp; 相关的阿里云产品:容器服务 ACK 容器服务 Kubernetes 版(简称 ACK)提供高性能可伸缩的容器应用管理能力,支持企业级容器化应用的全生命周期管理。整合阿里云虚拟化、存储、网络和安全能力,打造云端最佳容器化应用运行环境。 了解产品详情: https://www.aliyun.com/product/kubernetes
相关文章
|
2月前
|
JavaScript
GitHub——自动发布NPM包
GitHub——自动发布NPM包
14 0
|
3月前
包管理工具——npm实用教程 (修改下载源,安装依赖 -D -S -g ,卸载依赖等)
包管理工具——npm实用教程 (修改下载源,安装依赖 -D -S -g ,卸载依赖等)
52 0
|
5月前
|
JavaScript 前端开发 开发工具
npm更新和管理已发布的包
npm更新和管理已发布的包
|
前端开发 开发工具 git
cimi——一款全自动发布NPM包的工具
博主最近的时间一直投入concis组件库的开发工作,每次改完bug或者是新增完一些组件功能后都需要去发包、更新线上文档,这样一步步下来其实是比较麻烦的。
208 1
cimi——一款全自动发布NPM包的工具
|
PHP 开发工具 git
如何将自己的扩展发布到Composer包仓库?具体步骤是怎样的?底层原理是什么?
如何将自己的扩展发布到Composer包仓库?具体步骤是怎样的?底层原理是什么?
267 0
|
数据安全/隐私保护 开发者 Python
|
存储 Kubernetes 应用服务中间件
部署和体验Helm(2.16.1版本)
在Kubernetes上进行容器化部署并非易事,docker、环境变量、存储、网络等方面都会涉及到,这些复杂的操作可以被Helm应用包管理工具实现,避免了全手工操作的
530 0
部署和体验Helm(2.16.1版本)
|
Apache 网络架构 Python
|
JavaScript Shell 开发工具
还没发布过npm包?简单几步教会你
什么是npm?npm是nodejs上集成的原第三方包管理工具。
|
数据安全/隐私保护
npm关于组件包的发布与管理
虽然uniapp推荐使用uni_modules开发管理插件,但是也提供了npm包使用的能力(下载的包统一放到了node_mudules文件夹中),况且有些包不能开放,只能放到私有的服务器中,因此还是很有必要了解下npm包的开发与发布流程。 由于前面专研了uni_modules组件的开发发布流程,现在继续专研关于node_modules的包开发与发布,即npm包的开发与发布,他们发布时都使用package.json的配置。那么在处理node_modules包发布时会顺畅一些。
363 0
npm关于组件包的发布与管理
下一篇
无影云桌面