@bitnami/readme-generator-for-helm
Version:
Autogenerate READMEs tables and OpenAPI schemas for Helm Charts
565 lines (512 loc) • 18.7 kB
YAML
## Global Docker image parameters
## Please, note that this will override the image parameters, including dependencies, configured to use the global value
## Current available global Docker image parameters: imageRegistry and imagePullSecrets
## @section Global parameters
## @param global.imageRegistry Global Docker image registry
## @param global.imagePullSecrets Global Docker registry secret names as an array
##
## @descriptionStart
## Example:
##
## ```yaml
## global:
## imageRegistry: myRegistryName
## imagePullSecrets:
## - myRegistryKeySecretName
## ```
## @descriptionEnd
global:
imageRegistry: ""
imagePullSecrets: []
## @section Common parameters
## @descriptionStart This section contains parameters common to most of the Helm Charts in the wild
## as they are mainly auto-generated by initializing a new Helm Chart directory.
##
## It even supports multiple lines and [Link parsing](#common-parameters).
## @descriptionEnd
## String to partially override aspnet-core.fullname template (will maintain the release name)
## @param nameOverride String to partially override common.names.fullname
##
nameOverride: ""
## String to fully override aspnet-core.fullname template
## @param fullnameOverride String to fully override common.names.fullname
##
fullnameOverride: ""
## Add labels to all the deployed resources
## @param commonLabels Labels to add to all deployed objects
##
commonLabels: {}
## Add annotations to all the deployed resources
## @param commonAnnotations Annotations to add to all deployed objects
##
commonAnnotations: {}
## Extra objects to deploy (value evaluated as a template)
## @param extraDeploy Array of extra objects to deploy with the release
##
extraDeploy: []
## Deployment pod host aliases
## https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/
## @param hostAliases Add deployment host aliases
##
hostAliases: []
## @section Kubewatch parameters
## @descriptionStart
## This description starts in a new line instead of the same line of description start tag. It does not have multiple lines.
## @descriptionEnd
## Bitnami Kubewatch image version
## ref: https://hub.docker.com/r/bitnami/kubewatch/tags/
##
## @param image.registry [default: REGISTRY_NAME] Kubewatch image registry
## @param image.repository [default: REPOSITORY_NAME/kubewatch] Kubewatch image name
## @skip image.tag Kubewatch image tag
## @param image.pullPolicy Kubewatch image pull policy
## @param image.pullSecrets Specify docker-registry secret names as an array
image:
registry: docker.io
repository: bitnami/kubewatch
tag: 0.1.0-debian-10-r162
## Specify a imagePullPolicy
## Defaults to 'Always' if image tag is 'latest', else set to 'IfNotPresent'
## ref: http://kubernetes.io/docs/user-guide/images/#pre-pulling-images
##
pullPolicy: IfNotPresent
## Optionally specify an array of imagePullSecrets.
## Secrets must be manually created in the namespace.
## ref: https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/
## Example:
## pullSecrets:
## - myRegistryKeySecretName
##
pullSecrets: []
## @param slack.enabled Enable Slack notifications
## @param slack.channel Slack channel to notify
## @param slack.token Slack API token
##
slack:
enabled: true
# Slack channel to notify
channel: "XXXX"
# Slack bots token. Create using: https://my.slack.com/services/new/bot
# and invite the bot to your channel using: /join @botname
token: "XXXX"
## @param hipchat.enabled Enable HipChat notifications
## @param hipchat.room HipChat room to notify
## @param hipchat.token HipChat token
## @param hipchat.url HipChat URL
##
hipchat:
enabled: false
room: ""
token: ""
url: ""
## @param mattermost.enabled Enable Mattermost notifications
## @param mattermost.channel Mattermost channel to notify
## @param mattermost.username Mattermost user to notify
## @param mattermost.url Mattermost URL
##
mattermost:
enabled: false
channel: ""
username: ""
url: ""
## @param flock.enabled Enable Flock notifications
## @param flock.url Flock URL
##
flock:
enabled: false
url: ""
## @param msteams.enabled Enable Microsoft Teams notifications
## @param msteams.webhookurl Microsoft Teams webhook URL
##
msteams:
enabled: false
webhookurl: ""
## @param webhook [object] Enable Webhook notifications
##
webhook:
enabled: false
url: ""
## SMTP configuration
## @param smtp.enabled Enable SMTP (email) notifications
## @param smtp.to Destination email address (required)
## @param smtp.from Source email address (required)
## @param smtp.hello SMTP hello field (optional)
## @param smtp.smarthost SMTP server address (name:port) (required)
## @param smtp.subject SMTP subject for the email
## @param smtp.requireTLS Force STARTTLS
##
smtp:
enabled: false
to: ""
from: ""
hello: ""
smarthost: ""
subject: ""
requireTLS: false
## @param smtp.auth.username Username for LOGIN and PLAIN auth mech
## @param smtp.auth.password Password for LOGIN and PLAIN auth mech
## @param smtp.auth.secret Secret for CRAM-MD5 auth mech
## @param smtp.auth.identity Identity for PLAIN auth mech
auth:
username: ""
password: ""
secret: ""
identity: ""
## Namespace to watch, leave it empty for watching all
## @param namespaceToWatch Namespace to watch, leave it empty for watching all
##
namespaceToWatch: ""
## Resources to watch
## @param resourcesToWatch.pod Watch changes to Pods
## @param resourcesToWatch.deployment Watch changes to Deployments
## @param resourcesToWatch.replicationcontroller Watch changes to ReplicationControllers
## @param resourcesToWatch.replicaset Watch changes to ReplicaSets
## @param resourcesToWatch.daemonset Watch changes to DaemonSets
## @param resourcesToWatch.services Watch changes to Services
## @param resourcesToWatch.job Watch changes to Jobs
## @param resourcesToWatch.persistentvolume Watch changes to PersistentVolumes
##
resourcesToWatch:
pod: true
deployment: true
replicationcontroller: false
replicaset: false
daemonset: false
services: false
job: false
persistentvolume: false
## @section Deployment parameters
## Command for running the container (set to default if not set). Use array form
## @param command Override default container command (useful when using custom images)
##
command: []
## Args for running the container (set to default if not set). Use array form
## @param args Override default container args (useful when using custom images)
##
args: []
## An array to add extra env vars
## @param extraEnvVars[0].name Name of the env var
## @param extraEnvVars[0].value Value for the env var
##
## Example:
extraEnvVars:
- name: FOO
value: "bar"
##
## extraEnvVars: []
## ConfigMap with extra environment variables
## @param extraEnvVarsCM Name of existing ConfigMap containing extra env vars
##
extraEnvVarsCM: ""
## Secret with extra environment variables
## @param extraEnvVarsSecret Name of existing Secret containing extra env vars
##
extraEnvVarsSecret: ""
## Number of Kubewatch replicas to deploy
## @param replicaCount Number of Kubewatch replicas to deploy
replicaCount: 1
## Kubewatch containers' SecurityContext
## ref: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod
##
## @param podSecurityContext.enabled Enabled Kubewatch pods' Security Context
## @param podSecurityContext.fsGroup Set Kubewatch pod's Security Context fsGroup
##
podSecurityContext:
enabled: false
fsGroup: 1001
## Kubewatch pods' Security Context
## ref: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-container
##
## @param containerSecurityContext.enabled Enabled Kubewatch containers' Security Context
## @param containerSecurityContext.runAsUser Set Kubewatch container's Security Context runAsUser
## @param containerSecurityContext.runAsNonRoot Set Kubewatch container's Security Context runAsNonRoot
##
containerSecurityContext:
enabled: false
runAsUser: 1001
runAsNonRoot: true
## Kubewatch resource requests and limits
## ref: http://kubernetes.io/docs/user-guide/compute-resources/
##
## @skip resources Optional description
## @disabled-param resources.limits The resources limits for the Kubewatch container
## @disabled-param resources.requests The requested resources for the Kubewatch container
##
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: 200m
# memory: 256Mi
requests: {}
# cpu: 200m
# memory: 10Mi
## Kubewatch containers' liveness probe.
## ref: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/#configure-probes
##
## @param livenessProbe.enabled Enable livenessProbe
## @param livenessProbe.initialDelaySeconds Initial delay seconds for livenessProbe
## @param livenessProbe.periodSeconds Period seconds for livenessProbe
## @param livenessProbe.timeoutSeconds Timeout seconds for livenessProbe
## @param livenessProbe.failureThreshold Failure threshold for livenessProbe
## @param livenessProbe.successThreshold Success threshold for livenessProbe
##
livenessProbe:
enabled: false
initialDelaySeconds: 10
periodSeconds: 10
timeoutSeconds: 1
failureThreshold: 3
successThreshold: 1
## Kubewatch containers' readiness probe.
## ref: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/#configure-probes
##
## @param readinessProbe.enabled Enable readinessProbe
## @param readinessProbe.initialDelaySeconds Initial delay seconds for readinessProbe
## @param readinessProbe.periodSeconds Period seconds for readinessProbe
## @param readinessProbe.timeoutSeconds Timeout seconds for readinessProbe
## @param readinessProbe.failureThreshold Failure threshold for readinessProbe
## @param readinessProbe.successThreshold Success threshold for readinessProbe
##
readinessProbe:
enabled: false
initialDelaySeconds: 10
periodSeconds: 10
timeoutSeconds: 1
failureThreshold: 3
successThreshold: 1
## Custom Liveness probes for Kubewatch
## @param customLivenessProbe Override default liveness probe
##
customLivenessProbe: {}
## Custom Rediness probes Kubewatch
## @param customReadinessProbe Override default readiness probe
##
customReadinessProbe: {}
## Pod affinity preset
## Allowed values: soft, hard
## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity
##
## @param podAffinityPreset Pod affinity preset. Ignored if `affinity` is set. Allowed values: `soft` or `hard`
##
podAffinityPreset: ""
## Pod anti-affinity preset
## Allowed values: soft, hard
## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity
##
## @param podAntiAffinityPreset Pod anti-affinity preset. Ignored if `affinity` is set. Allowed values: `soft` or `hard`
##
podAntiAffinityPreset: soft
## Node affinity preset
## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#node-affinity
##
## @param nodeAffinityPreset.type Node affinity preset type. Ignored if `affinity` is set. Allowed values: `soft` or `hard`
## @param nodeAffinityPreset.key Node label key to match. Ignored if `affinity` is set
## @param nodeAffinityPreset.values Node label values to match. Ignored if `affinity` is set
##
nodeAffinityPreset:
## Node affinity type
## Allowed values: soft, hard
##
type: ""
## Node label key to match
## E.g.
## key: "kubernetes.io/e2e-az-name"
##
key: ""
## Node label values to match
## E.g.
## values:
## - e2e-az1
## - e2e-az2
##
values: []
## Affinity for pod assignment. Evaluated as a template.
## ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity
## Note: podAffinityPreset, podAntiAffinityPreset, and nodeAffinityPreset will be ignored when it's set
##
## @param affinity Affinity for pod assignment
##
affinity: {}
## Node labels for pod assignment. Evaluated as a template.
## ref: https://kubernetes.io/docs/user-guide/node-selection/
##
## @param nodeSelector Node labels for pod assignment
##
nodeSelector: {}
## Tolerations for pod assignment. Evaluated as a template.
## ref: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
##
## @param tolerations Tolerations for pod assignment
##
tolerations: []
## Pod extra labels
## ref: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
##
## @param podLabels Extra labels for Kubewatch pods
##
podLabels: {}
## Annotations for server pods.
## ref: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
##
## @param podAnnotations Annotations for Kubewatch pods
##
podAnnotations: {}
## Extra volumes to add to the deployment
##
## @param extraVolumes Optionally specify extra list of additional volumes for Kubewatch pods
##
extraVolumes: []
## Extra volume mounts to add to the container
##
## @param extraVolumeMounts Optionally specify extra list of additional volumeMounts for Kubewatch container(s)
##
extraVolumeMounts: []
## Add init containers to the Kubewatch pods.
## Example:
## initContainers:
## - name: your-image-name
## image: your-image
## imagePullPolicy: Always
## ports:
## - name: portname
## containerPort: 1234
##
## @param initContainers Add additional init containers to the Kubewatch pods
##
initContainers: {}
## Add sidecars to the Kubewatch pods.
## Example:
## sidecars:
## - name: your-image-name
## image: your-image
## imagePullPolicy: Always
## ports:
## - name: portname
## containerPort: 1234
##
## @param sidecars Add additional sidecar containers to the Kubewatch pods
##
sidecars: {}
## Specifies whether RBAC resources should be created
##
## @param rbac.create Weather to create & use RBAC resources or not
##
rbac:
create: false
## Specifies whether a ServiceAccount should be created
##
## @param serviceAccount.create Enable the creation of a ServiceAccount for Kubewatch pods
## @param serviceAccount.name Name of the created ServiceAccount
##
serviceAccount:
create: true
## The name of the ServiceAccount to use.
## If not set and create is true, a name is generated using the fullname template
##
name: ""
## Invented parameter to test arrays
## @param inventedArray Test parameter to check arrays
inventedArray:
- a
- b
## Invented parameter to test array modifier
## @param arrayModifier [array] Test parameter for modifier array
arrayModifier:
- a
- b
## @param configuration [string] haproxy configuration
##
configuration: |
global
log stdout format raw local0
maxconn 1024
defaults
## Jobs definition
##
jobs:
-
## @param jobs[0].nameOverride String to partially override jobs.names.fullname
##
nameOverride: ""
## @param jobs[0].fullnameOverride String to fully override jobs.names.fullname
##
fullnameOverride: ""
## @param jobs[0].resources.limits The resources limits override for the Job
##
resources:
limits: {}
## @param jobs[0].newOption.subArray[0].object Test object inside Arrat
## @param jobs[0].newOption.subArray[0].plainArray Test nested arrays
## @param jobs[0].newOption.subArray[0].threeLevelsArray[0].c Test 3 levels array
## @param jobs[0].newOption.subArray[0].emptyObject Empty object
newOption:
subArray:
- object: a
plainArray:
- b
threeLevelsArray:
- c: d
emptyObject: {}
## Test the extra tag
## @extra extraTest An object that we want to document even though it is not at the end of the YAML tree
## @param extraTest.content Content of the object
## We expect both entries to appear in the README and the paths keys inside the object to be verified
extraTest:
content: whatever
## @param forceSchemaArrayModifier [array] The parameter should appear completely into the schema but with the modifier value into the README
##
forceSchemaArrayModifier:
- w: "x"
y:
- "z"
## Invented parameter to test links in descriptions
## @param linkInDescription [object] Link with square brackets present in description. [More information here](#deployment-parameters).
linkInDescription:
propertyOne: valueOne
propertyTwo: valueTwo
## Nullable value
## @param nullable [nullable] Nullable parameter
nullable: null
## @param nullableNullStringWithValueChange [nullable,string] Nullable null string. We apply string modifier that will change the type and value, but the schema will show `nullable: true`.
nullableNullStringWithValueChange: null
## @param nullableNullArray [array,nullable] Nullable null array. We apply array modifier that will change the type in the schema plus `nullable: true`.
nullableNullArray: null
## @param nullableNullString [string,nullable] Nullable null string. We apply string modifier to avoid infering an object type. The null must be preverved as value.
nullableNullString: null
## @param nullableNotNull [nullable] Nullable parameter with a non null value
nullableNotNull: somestring
## @param nullableObject [nullable] Nullable parameter with an object value
nullableObject: {}
## @param nullableArray [nullable] Nullable parameter with an array value
nullableArray: []
## @param arrayEmptyModifier [array] Test empty array modifier
arrayEmptyModifier: value
## @param annotations.prometheus.io/scrape A Prometheus annotation
annotations:
prometheus.io/scrape: "true"
## @param weird.key.with.weird.format/and.object A weird key with weird format and an object inside.
weird.key:
with:
weird.format/and:
object: asValue
## @section Regression tests
## Issue: https://github.com/bitnami/readme-generator-for-helm/issues/60
## section foo bar
## @param foo.file.ext.foo A weird key with a list.
foo:
file.ext:
foo:
- bar
## Issue: https://github.com/bitnami/readme-generator-for-helm/issues/70
## @param vault.annotations.vault.hashicorp.com/agent-inject Some desc
vault:
annotations:
vault.hashicorp.com/agent-inject: "true"
## Issue: ## Issue: https://github.com/bitnami/readme-generator-for-helm/issues/73
## @param stack.mode [string, nullable] way to deploy
## @param stack.version version of the stack
stack:
version: 8.10.3