helm
linux 安装
-
每个Helm 版本都提供了各种操作系统的二进制版本,这些版本可以手动下载和安装。
- 下载 需要的版本
- 解压(tar -zxvf helm-v3.0.0-linux-amd64.tar.gz)
- 在解压目录中找到helm程序,移动到需要的目录中(mv linux-amd64/helm /usr/local/bin/helm)
- 添加仓库: helm repo add bitnami https://charts.bitnami.com/bitnami
- 验证安装: helm help.
概念
- Chart 代表着 Helm 包。它包含在 Kubernetes 集群内部运行应用程序,工具或服务所需的所有资源定义。你可以把它看作是 Homebrew formula,Apt dpkg,或 Yum RPM 在Kubernetes 中的等价物。
- Repository(仓库) 是用来存放和共享 charts 的地方。它就像 Perl 的 CPAN 档案库网络 或是 Fedora 的 软件包仓库,只不过它是供 Kubernetes 包所使用的。
- Release 是运行在 Kubernetes 集群中的 chart 的实例。一个 chart 通常可以在同一个集群中安装多次。每一次安装都会创建一个新的 release。以 MySQL chart为例,如果你想在你的集群中运行两个数据库,你可以安装该chart两次。每一个数据库都会拥有它自己的 release 和 release name。
使用
搜索
- helm search hub 从 Artifact Hub 中查找并列出 helm charts。 Artifact Hub中存放了大量不同的仓库。
- helm search repo 从你添加(使用 helm repo add)到本地 helm 客户端中的仓库中进行查找。该命令基于本地数据进行搜索,无需连接互联网。
安装
- 需要有k8s环境
- [root@k8s-node1 ~]# helm install nginx bitnami/nginx'
- 注意: 安装chart时创建了一个新的 release 对象。上述发布被命名为 nginx。 (如果想让Helm生成一个名称,删除发布名称并使用--generate-name
- helm list
- helm status nginx
- helm uninstall nginx
创建功能chart
- 自定义的 chart
shell
helm create app
- 查看 chart 目录结构
- templates/ 目录包括了模板文件。当Helm评估chart时,会通过模板渲染引擎将所有文件发送到templates/目录中。 然后收集模板的结果并发送给Kubernetes。
- values.yaml 文件也导入到了模板。这个文件包含了chart的 默认值 。这些值会在用户执行helm install 或 helm upgrade时被覆盖。
- Chart.yaml 文件包含了该chart的描述。你可以从模板中访问它。charts/目录 可以 包含其他的chart(称之为 子chart)。
shell
app/
Chart.yaml
values.yaml
charts/
templates/
...
自定义模板
shell
rm -rf mychart/templates/*
- 编写 namespace.yaml
shell
apiVersion: v1
kind: Namespace
metadata:
name: {{ .Chart.Name }}
namespace: {{ .Values.namespace }}
- 编写 deployment.yml
shell
apiVersion: apps/v1
kind: Deployment
metadata:
name: {{ .Chart.Name}}
namespace: {{.Values.namespace}}
labels:
app: {{ .Chart.Name}}
spec:
replicas: {{ .Values.replicas }}
template:
metadata:
name: {{ .Chart.Name}}
labels:
app: {{ .Chart.Name}}
spec:
containers:
- name: {{ .Chart.Name}}
image: {{ .Values.image}}
imagePullPolicy: {{.Values.imagePullPolicy}}
ports:
- containerPort: {{.Values.containerPort}}
restartPolicy: {{ .Values.restartPolicy }}
selector:
matchLabels:
app: {{ .Chart.Name}}
- 编写 service.yml
shell
apiVersion: v1
kind: Service
metadata:
name: {{.Chart.Name}}
namespace: {{.Values.namespace}}
spec:
selector:
app: {{.Chart.Name}}
ports:
- port: {{.Values.service.port}}
targetPort: {{.Values.containerPort}}
type: {{ .Values.service.type }}
- 编写chart.yaml
shell
apiVersion: v2
name: app
description: A Helm chart for Kubernetes
# A chart can be either an 'application' or a 'library' chart.
#
# Application charts are a collection of templates that can be packaged into versioned archives
# to be deployed.
#
# Library charts provide useful utilities or functions for the chart developer. They're included as
# a dependency of application charts to inject those utilities and functions into the rendering
# pipeline. Library charts do not define any templates and therefore cannot be deployed.
type: application
# This is the chart version. This version number should be incremented each time you make changes
# to the chart and its templates, including the app version.
# Versions are expected to follow Semantic Versioning (https://semver.org/)
version: 0.1.0
# This is the version number of the application being deployed. This version number should be
# incremented each time you make changes to the application. Versions are not expected to
# follow Semantic Versioning. They should reflect the version the application is using.
# It is recommended to use it with quotes.
appVersion: "1.16.0"
- 编写 values.yaml
shell
replicas: 1
namespace: app
image: nginx:1.19
imagePullPolicy: IfNotPresent
restartPolicy: Always
containerPort: 80
service:
port: 80
type: ClusterIP
- 验证是否存在错误
shell
helm lint app
- 打包自定义 chart
shell
helm package app
- 安装
shell
helm install app app-0.1.0.tgz