如何从代码到制作并发布一个 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 的基本部署。

相关实践学习
通过workbench远程登录ECS,快速搭建Docker环境
本教程指导用户体验通过workbench远程登录ECS,完成搭建Docker环境的快速搭建,并使用Docker部署一个Nginx服务。
深入解析Docker容器化技术
Docker是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的Linux机器上,也可以实现虚拟化,容器是完全使用沙箱机制,相互之间不会有任何接口。Docker是世界领先的软件容器平台。开发人员利用Docker可以消除协作编码时“在我的机器上可正常工作”的问题。运维人员利用Docker可以在隔离容器中并行运行和管理应用,获得更好的计算密度。企业利用Docker可以构建敏捷的软件交付管道,以更快的速度、更高的安全性和可靠的信誉为Linux和Windows Server应用发布新功能。 在本套课程中,我们将全面的讲解Docker技术栈,从环境安装到容器、镜像操作以及生产环境如何部署开发的微服务应用。本课程由黑马程序员提供。 &nbsp; &nbsp; 相关的阿里云产品:容器服务 ACK 容器服务 Kubernetes 版(简称 ACK)提供高性能可伸缩的容器应用管理能力,支持企业级容器化应用的全生命周期管理。整合阿里云虚拟化、存储、网络和安全能力,打造云端最佳容器化应用运行环境。 了解产品详情: https://www.aliyun.com/product/kubernetes
相关文章
|
4月前
|
前端开发 JavaScript 开发者
探索npm的高级特性:自定义脚本与包的发布与维护
探索npm的高级特性:自定义脚本与包的发布与维护
|
4月前
|
JavaScript 前端开发 Ruby
NPM 制作命令行工具 - 进阶辅助库
NPM 制作命令行工具 - 进阶辅助库
23 0
|
4月前
NPM 制作命令行工具 - 入门案例
NPM 制作命令行工具 - 入门案例
28 0
|
11月前
|
前端开发 开发工具 git
cimi——一款全自动发布NPM包的工具
博主最近的时间一直投入concis组件库的开发工作,每次改完bug或者是新增完一些组件功能后都需要去发包、更新线上文档,这样一步步下来其实是比较麻烦的。
153 1
cimi——一款全自动发布NPM包的工具
|
Linux 网络安全 开发工具
通过nexus3部署公司内部的私有npm仓库:从安装到配置、从发布包到测试包的一条龙服务
登录时使用默认用户admin,密码不知道就需要找默认的,点击Sign in时会提示你路径,这里我是这样查的,在linux服务器上输入以下命令
1497 0
|
PHP 开发工具 git
如何将自己的扩展发布到Composer包仓库?具体步骤是怎样的?底层原理是什么?
如何将自己的扩展发布到Composer包仓库?具体步骤是怎样的?底层原理是什么?
237 0
|
数据安全/隐私保护 开发者 Python
|
存储 Kubernetes 应用服务中间件
部署和体验Helm(2.16.1版本)
在Kubernetes上进行容器化部署并非易事,docker、环境变量、存储、网络等方面都会涉及到,这些复杂的操作可以被Helm应用包管理工具实现,避免了全手工操作的
492 0
部署和体验Helm(2.16.1版本)
|
JavaScript Shell 开发工具
还没发布过npm包?简单几步教会你
什么是npm?npm是nodejs上集成的原第三方包管理工具。
|
存储 编解码 openCL
cdr2022绿色精简免安装下载教程
CorelDRAW是我最早接触的矢量绘图软件,一直用它绘图、排版、打印、输出,一直感觉它功能很强大,CorelDRAW是加拿大的corel公司出品的,corel公司的产品强调的是编辑功能,它将各种要实现的功能直接表现于具体操作中,动动鼠标基本就能实现你想要的效果。
3003 0