Helm Developer Guide
You can upload the Helm chart of an app to KubeSphere so that tenants with necessary permissions can deploy it. This tutorial demonstrates how to prepare Helm charts using NGINX as an example.
Install Helm
If you have already installed KubeSphere, then Helm is deployed in your environment. Otherwise, refer to the Helm documentation to install Helm first.
Create a Local Repository
Execute the following commands to create a repository on your machine.
mkdir helm-repo
cd helm-repo
Create an App
Use helm create
to create a folder named nginx
, which automatically creates YAML templates and directories for your app. Generally, it is not recommended to change the name of files and directories in the top level directory.
$ helm create nginx
$ tree nginx/
nginx/
โโโ charts
โโโ Chart.yaml
โโโ templates
โ โโโ deployment.yaml
โ โโโ _helpers.tpl
โ โโโ ingress.yaml
โ โโโ NOTES.txt
โ โโโ service.yaml
โโโ values.yaml
Chart.yaml
is used to define the basic information of the chart, including name, API, and app version. For more information, see Chart.yaml File.
An example of the Chart.yaml
file:
apiVersion: v1
appVersion: "1.0"
description: A Helm chart for Kubernetes
name: nginx
version: 0.1.0
When you deploy Helm-based apps to Kubernetes, you can edit the values.yaml
file on the KubeSphere console directly.
An example of the values.yaml
file:
# Default values for test.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.
replicaCount: 1
image:
repository: nginx
tag: stable
pullPolicy: IfNotPresent
nameOverride: ""
fullnameOverride: ""
service:
type: ClusterIP
port: 80
ingress:
enabled: false
annotations: {}
# kubernetes.io/ingress.class: nginx
# kubernetes.io/tls-acme: "true"
path: /
hosts:
- chart-example.local
tls: []
# - secretName: chart-example-tls
# hosts:
# - chart-example.local
resources: {}
# We usually recommend not to specify default resources and to leave this as a conscious
# choice for the user. This also increases chances charts run on environments with little
# resources, such as Minikube. If you do want to specify resources, uncomment the following
# lines, adjust them as necessary, and remove the curly braces after 'resources:'.
# limits:
# cpu: 100m
# memory: 128Mi
# requests:
# cpu: 100m
# memory: 128Mi
nodeSelector: {}
tolerations: []
affinity: {}
Refer to Helm Specifications to edit files in the nginx
folder and save them when you finish editing.
Create an Index File (Optional)
To add a repository with an HTTP or HTTPS URL in KubeSphere, you need to upload an index.yaml
file to the object storage in advance. Use Helm to create the index file by executing the following command in the previous directory of nginx
.
helm repo index .
$ ls
index.yaml nginx
Note
If the repository URL is S3-styled, an index file will be created automatically in the object storage when you add apps to the repository.
For more information about how to add repositories to KubeSphere, see Import an Helm Repository.
Package the Chart
Go to the previous directory of nginx
and execute the following command to package your chart which creates a .tgz package.
helm package nginx
$ ls
nginx nginx-0.1.0.tgz
Upload Your App
Now that you have your Helm-based app ready, you can load it to KubeSphere and test it on the platform.
See Also
Feedback
Was this page Helpful?
Receive the latest news, articles and updates from KubeSphere
Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.