tree: f3fffad7ad7fc83fe1c1bef46535a028a33a09cc [path history] [tgz]
  1. charts/
  2. templates/
  3. .helmignore
  4. Chart.yaml
  5. README.md
  6. values.yaml
charts/apisix-dashboard/README.md

Apache APISIX Dashboard

APISIX Dashboard is designed to make it as easy as possible for users to operate Apache APISIX through a frontend interface.

This chart bootstraps an apisix-dashboard deployment on a Kubernetes cluster using the Helm package manager.

Prerequisites

APISIX Dashboard requires Kubernetes version 1.14+.

Get Repo Info

helm repo add apisix https://charts.apiseven.com
helm repo update

Install Chart

Important: only helm3 is supported

helm install [RELEASE_NAME] apisix/apisix-dashboard --namespace ingress-apisix --create-namespace

The command deploys apisix-dashboard on the Kubernetes cluster in the default configuration.

See configuration below.

See helm install for command documentation.

Uninstall Chart

helm uninstall [RELEASE_NAME] --namespace ingress-apisix

This removes all the Kubernetes components associated with the chart and deletes the release.

See helm uninstall for command documentation.

Upgrading Chart

helm upgrade [RELEASE_NAME] [CHART] --install

See helm upgrade for command documentation.

Parameters

The following tables lists the configurable parameters of the apisix-dashboard chart and their default values per section/component:

Common parameters

NameDescriptionValue
nameOverrideString to partially override apisix-dashboard.fullname template (will maintain the release name)nil
fullnameOverrideString to fully override apisix-dashboard.fullname templatenil
imagePullSecretsDocker registry secret names as an array[]
image.repositoryApache APISIX Dashboard image repositoryapache/apisix-dashboard
image.tagApache APISIX Dashboard image tag (immutable tags are recommended)2.10.1-alpine
image.pullPolicyApache APISIX Dashboard image pull policyIfNotPresent

Apache APISIX Dashboard configurable parameters

NameDescriptionValue
config.conf.listen.hostThe address on which the Manager API should listen. The default value is 0.0.0.0, if want to specify, please enable it. This value accepts IPv4, IPv6, and hostname.0.0.0.0
config.conf.listen.portThe port on which the Manager API should listen.9000
config.authentication.secertSecret for jwt token generationsecert
config.authentication.expireTimeJWT token expire time, in second3600
config.authentication.usersSpecifies username and password for login manager api.[{username: admin, password: admin}]
config.conf.etcd.endpointsSupports defining multiple etcd host addresses for an etcd clusterapisix-etcd:2379
config.conf.etcd.prefixApache APISIX config's prefix in etcd, /apisix by default/apisix
config.conf.etcd.usernameSpecifies etcd basic auth username if enable etcd auth~
config.conf.etcd.passwordSpecifies etcd basic auth password if enable etcd auth~
config.conf.log.accessLog.filePathAccess log path/dev/stdout
config.conf.log.errorLog.filePathError log path/dev/stderr
config.conf.log.errorLog.levelError log level. Supports levels, lower to higher: debug, info, warn, error, panic, fatalwarn

Deployment parameters

NameDescriptionValue
replicaCountNumber of Apache APISIX Dashboard nodes1
podAnnotationsApache APISIX Dashboard Pod annotations{}
nodeSelectorNode labels for pod assignment{}
tolerationsTolerations for pod assignment[]
resources.limitsThe resources limits for Apache APISIX Dashboard containers{}
resources.requestsThe requested resources for Apache APISIX Dashboardcontainers{}
podSecurityContextSet the securityContext for Apache APISIX Dashboard pods{}
securityContextSet the securityContext for Apache APISIX Dashboard container{}
autoscaling.enabledEnable autoscaling for Apache APISIX Dashboard deploymentfalse
autoscaling.minReplicasMinimum number of replicas to scale back1
autoscaling.maxReplicasMaximum number of replicas to scale out100
autoscaling.targetCPUUtilizationPercentageTarget CPU utilization percentage80
autoscaling.targetMemoryUtilizationPercentageTarget Memory utilization percentagenil

Traffic Exposure parameters

NameDescriptionValue
service.typeService typeClusterIP
service.portService HTTP port80
ingress.enabledSet to true to enable ingress record generationfalse
ingress.annotationsIngress annotations{}
ingress.hostsThe list of hostnames to be covered with this ingress record.[]
ingress.tlsCreate TLS Secretfalse
ingress.classNameingressClassName replace annotations kubernetes.io/ingress.class, required kubernetes 1.18>=apisix

RBAC parameters

NameDescriptionValue
serviceAccount.createSpecifies whether a ServiceAccount should be createdtrue
serviceAccount.nameThe name of the ServiceAccount to use. If not set and create is true, a name is generated using the fullname templatenil
serviceAccount.annotationsAnnotations to add to the ServiceAccount Metadata{}