Skip to content

Latest commit

 

History

History
93 lines (78 loc) · 4.66 KB

README.md

File metadata and controls

93 lines (78 loc) · 4.66 KB

Deploy Portainer using Helm Chart

Before proceeding, ensure to create a namespace in advance. For instance:

kubectl create namespace portainer

Install the chart repository

helm repo add portainer https://portainer.github.io/k8s/
helm repo update

Testing the Chart

Execute the following for testing the chart:

helm install --dry-run --debug portainer -n portainer deploy/helm/portainer

Installing the Chart

Execute the following for installing the chart:

helm upgrade -i -n portainer portainer portainer/portainer

## Refer to the output NOTES on how-to access Portainer web
## An example is attached below

NOTES:
1. Get the application URL by running these commands:
     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
           You can watch the status of by running 'kubectl get --namespace portainer svc -w portainer'

  export SERVICE_IP=$(kubectl get svc --namespace portainer portainer --template "{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}")
  echo http://$SERVICE_IP:9000
  http://20.40.176.8:9000

Deleting the Chart

Execute the following for deleting the chart:

## Delete the Helm Chart
helm delete -n portainer portainer
## Delete the Namespace
kubectl delete namespace portainer

Chart Configuration

The following table lists the configurable parameters of the Portainer chart and their default values. The values file can be found under deploy/helm/portainer/values.yaml.

The parameters will be keep updating.

Parameter Description Default
replicaCount Number of Portainer service replicas (ALWAYS set to 1) 1
image.repository Portainer Docker Hub repository portainer/portainer-ce
image.tag Tag for the Portainer image latest
image.pullPolicy Portainer image pulling policy IfNotPresent
imagePullSecrets If Portainer image requires to be in a private repository nil
nodeSelector Used to apply a nodeSelector to the deployment {}
serviceAccount.annotations Annotations to add to the service account null
serviceAccount.name The name of the service account to use portainer-sa-clusteradmin
localMgmt Enables or disables the creation of SA, Roles in local cluster where Portainer runs, only change when you don't need to manage the local cluster through this Portainer instance true
service.type Service Type for the main Portainer Service; ClusterIP, NodePort and LoadBalancer LoadBalancer
service.httpPort HTTP port for accessing Portainer Web 9000
service.httpNodePort Static NodePort for accessing Portainer Web. Specify only if the type is NodePort 30777
service.edgePort TCP port for accessing Portainer Edge 8000
service.edgeNodePort Static NodePort for accessing Portainer Edge. Specify only if the type is NodePort 30776
service.annotations Annotations to add to the service {}
feature.flags Enable one or more features separated by spaces. For instance, --feat=open-amt nil
ingress.enabled Create an ingress for Portainer false
ingress.ingressClassName For Kubernetes >= 1.18 you should specify the ingress-controller via the field ingressClassName. For instance, nginx nil
ingress.annotations Annotations to add to the ingress. For instane, kubernetes.io/ingress.class: nginx {}
ingress.hosts.host URL for Portainer Web. For instance, portainer.example.io nil
ingress.hosts.paths.path Path for the Portainer Web. /
ingress.hosts.paths.port Port for the Portainer Web. 9000
ingress.tls TLS support on ingress. Must create a secret with TLS certificates in advance []
resources Portainer resource requests and limits {}
tls.force Force Portainer to be configured to use TLS only false
tls.existingSecret Mount the existing TLS secret into the pod ""
mtls.enable Option to specicy mtls Certs to be used by Portainer false
mtls.existingSecret Mount the existing mtls secret into the pod ""
persistence.enabled Whether to enable data persistence true
persistence.existingClaim Name of an existing PVC to use for data persistence nil
persistence.size Size of the PVC used for persistence 10Gi
persistence.annotations Annotations to apply to PVC used for persistence {}
persistence.storageClass StorageClass to apply to PVC used for persistence default
persistence.accessMode AccessMode for persistence ReadWriteOnce
persistence.selector Selector for persistence nil