Skip to main content
Version: release-0.9

Add-On API Reference


Packages:

extensions.kubeblocks.io/v1alpha1

Resource Types:

Addon

Addon is the Schema for the add-ons API.

FieldDescription

apiVersion
string

extensions.kubeblocks.io/v1alpha1

kind
string

Addon

metadata

Kubernetes meta/v1.ObjectMeta

Refer to the Kubernetes API documentation for the fields of the metadata field.

spec

AddonSpec



description

string

(Optional)

Specifies the description of the add-on.

type

AddonType

Defines the type of the add-on. The only valid value is ‘helm’.

version

string

(Optional)

Indicates the version of the add-on.

provider

string

(Optional)

Specifies the provider of the add-on.

helm

HelmTypeInstallSpec

(Optional)

Represents the Helm installation specifications. This is only processed when the type is set to ‘helm’.

defaultInstallValues

[]AddonDefaultInstallSpecItem

Specifies the default installation parameters.

install

AddonInstallSpec

(Optional)

Defines the installation parameters.

installable

InstallableSpec

(Optional)

Represents the installable specifications of the add-on. This includes the selector and auto-install settings.

cliPlugins

[]CliPlugin

(Optional)

Specifies the CLI plugin installation specifications.

status

AddonStatus

AddonDefaultInstallSpecItem

(Appears on:AddonSpec)

FieldDescription

AddonInstallSpec

AddonInstallSpec

(Members of AddonInstallSpec are embedded into this type.)

selectors

[]SelectorRequirement

(Optional)

Indicates the default selectors for add-on installations. If multiple selectors are provided, all selectors must evaluate to true.

AddonInstallExtraItem

(Appears on:AddonInstallSpec)

FieldDescription

AddonInstallSpecItem

AddonInstallSpecItem

(Members of AddonInstallSpecItem are embedded into this type.)

name

string

Specifies the name of the item.

AddonInstallSpec

(Appears on:AddonDefaultInstallSpecItem, AddonSpec)

FieldDescription

AddonInstallSpecItem

AddonInstallSpecItem

(Members of AddonInstallSpecItem are embedded into this type.)

enabled

bool

(Optional)

Can be set to true if there are no specific installation attributes to be set.

extras

[]AddonInstallExtraItem

(Optional)

Specifies the installation specifications for extra items.

AddonInstallSpecItem

(Appears on:AddonInstallExtraItem, AddonInstallSpec)

FieldDescription

replicas

int32

(Optional)

Specifies the number of replicas.

persistentVolumeEnabled

bool

(Optional)

Indicates whether the Persistent Volume is enabled or not.

storageClass

string

(Optional)

Specifies the name of the storage class.

tolerations

string

(Optional)

Specifies the tolerations in a JSON array string format.

resources

ResourceRequirements

(Optional)

Specifies the resource requirements.

AddonPhase (string alias)

(Appears on:AddonStatus)

AddonPhase defines addon phases.

ValueDescription

"Disabled"

"Disabling"

"Enabled"

"Enabling"

"Failed"

AddonSelectorKey (string alias)

(Appears on:SelectorRequirement)

AddonSelectorKey are selector requirement key types.

ValueDescription

"KubeGitVersion"

"KubeProvider"

"KubeVersion"

AddonSpec

(Appears on:Addon)

AddonSpec defines the desired state of an add-on.

FieldDescription

description

string

(Optional)

Specifies the description of the add-on.

type

AddonType

Defines the type of the add-on. The only valid value is ‘helm’.

version

string

(Optional)

Indicates the version of the add-on.

provider

string

(Optional)

Specifies the provider of the add-on.

helm

HelmTypeInstallSpec

(Optional)

Represents the Helm installation specifications. This is only processed when the type is set to ‘helm’.

defaultInstallValues

[]AddonDefaultInstallSpecItem

Specifies the default installation parameters.

install

AddonInstallSpec

(Optional)

Defines the installation parameters.

installable

InstallableSpec

(Optional)

Represents the installable specifications of the add-on. This includes the selector and auto-install settings.

cliPlugins

[]CliPlugin

(Optional)

Specifies the CLI plugin installation specifications.

AddonStatus

(Appears on:Addon)

AddonStatus defines the observed state of an add-on.

FieldDescription

phase

AddonPhase

Defines the current installation phase of the add-on. It can take one of the following values: Disabled, Enabled, Failed, Enabling, Disabling.

conditions

[]Kubernetes meta/v1.Condition

(Optional)

Provides a detailed description of the current state of add-on API installation.

observedGeneration

int64

(Optional)

Represents the most recent generation observed for this add-on. It corresponds to the add-on’s generation, which is updated on mutation by the API Server.

AddonType (string alias)

(Appears on:AddonSpec)

AddonType defines the addon types.

ValueDescription

"Helm"

CliPlugin

(Appears on:AddonSpec)

FieldDescription

name

string

Specifies the name of the plugin.

indexRepository

string

Defines the index repository of the plugin.

description

string

(Optional)

Provides a brief description of the plugin.

DataObjectKeySelector

(Appears on:HelmInstallValues)

FieldDescription

name

string

Defines the name of the object being referred to.

key

string

Specifies the key to be selected.

HelmInstallOptions (map[string]string alias)

(Appears on:HelmTypeInstallSpec)

HelmInstallValues

(Appears on:HelmTypeInstallSpec)

FieldDescription

urls

[]string

(Optional)

Specifies the URL location of the values file.

configMapRefs

[]DataObjectKeySelector

(Optional)

Selects a key from a ConfigMap item list. The value can be a JSON or YAML string content. Use a key name with “.json”, “.yaml”, or “.yml” extension to specify a content type.

secretRefs

[]DataObjectKeySelector

(Optional)

Selects a key from a Secrets item list. The value can be a JSON or YAML string content. Use a key name with “.json”, “.yaml”, or “.yml” extension to specify a content type.

setValues

[]string

(Optional)

Values set during Helm installation. Multiple or separate values can be specified with commas (key1=val1,key2=val2).

setJSONValues

[]string

(Optional)

JSON values set during Helm installation. Multiple or separate values can be specified with commas (key1=jsonval1,key2=jsonval2).

HelmJSONValueMapType

(Appears on:HelmValuesMappingItem)

FieldDescription

tolerations

string

(Optional)

Specifies the toleration mapping key.

HelmTypeInstallSpec

(Appears on:AddonSpec)

HelmTypeInstallSpec defines the Helm installation spec.

FieldDescription

chartLocationURL

string

Specifies the URL location of the Helm Chart.

installOptions

HelmInstallOptions

(Optional)

Defines the options for Helm release installation.

installValues

HelmInstallValues

(Optional)

Defines the set values for Helm release installation.

valuesMapping

HelmValuesMapping

(Optional)

Defines the mapping of add-on normalized resources parameters to Helm values’ keys.

chartsImage

string

(Optional)

Defines the image of Helm charts.

chartsPathInImage

string

(Optional)

Defines the path of Helm charts in the image. This path is used to copy Helm charts from the image to the shared volume. The default path is “/charts”.

HelmValueMapType

(Appears on:HelmValuesMappingItem)

FieldDescription

replicaCount

string

(Optional)

Defines the key for setting the replica count in the Helm values map.

persistentVolumeEnabled

string

(Optional)

Indicates whether the persistent volume is enabled in the Helm values map.

storageClass

string

(Optional)

Specifies the key for setting the storage class in the Helm values map.

HelmValuesMapping

(Appears on:HelmTypeInstallSpec)

FieldDescription

HelmValuesMappingItem

HelmValuesMappingItem

(Members of HelmValuesMappingItem are embedded into this type.)

extras

[]HelmValuesMappingExtraItem

(Optional)

Helm value mapping items for extra items.

HelmValuesMappingExtraItem

(Appears on:HelmValuesMapping)

FieldDescription

HelmValuesMappingItem

HelmValuesMappingItem

(Members of HelmValuesMappingItem are embedded into this type.)

name

string

Name of the item.

HelmValuesMappingItem

(Appears on:HelmValuesMapping, HelmValuesMappingExtraItem)

FieldDescription

valueMap

HelmValueMapType

(Optional)

Defines the “key” mapping values. Valid keys include replicaCount, persistentVolumeEnabled, and storageClass. Enum values explained:

  • replicaCount sets the replicaCount value mapping key.

  • persistentVolumeEnabled sets the persistent volume enabled mapping key.

  • storageClass sets the storageClass mapping key.

jsonMap

HelmJSONValueMapType

(Optional)

Defines the “key” mapping values. The valid key is tolerations. Enum values explained:

  • tolerations sets the toleration mapping key.

resources

ResourceMappingItem

(Optional)

Sets resources related mapping keys.

InstallableSpec

(Appears on:AddonSpec)

FieldDescription

selectors

[]SelectorRequirement

(Optional)

Specifies the selectors for add-on installation. If multiple selectors are provided, they must all evaluate to true for the add-on to be installed.

autoInstall

bool

Indicates whether an add-on should be installed automatically.

LineSelectorOperator (string alias)

(Appears on:SelectorRequirement)

LineSelectorOperator defines line selector operators.

ValueDescription

"Contains"

"DoesNotContain"

"DoesNotMatchRegex"

"MatchRegex"

ResourceMappingItem

(Appears on:HelmValuesMappingItem)

FieldDescription

storage

string

(Optional)

Specifies the key used for mapping the storage size value.

cpu

ResourceReqLimItem

(Optional)

Specifies the key used for mapping both CPU requests and limits.

memory

ResourceReqLimItem

(Optional)

Specifies the key used for mapping both Memory requests and limits.

ResourceReqLimItem

(Appears on:ResourceMappingItem)

FieldDescription

requests

string

(Optional)

Specifies the mapping key for the request value.

limits

string

(Optional)

Specifies the mapping key for the limit value.

ResourceRequirements

(Appears on:AddonInstallSpecItem)

FieldDescription

limits

Kubernetes core/v1.ResourceList

(Optional)

Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/.

requests

Kubernetes core/v1.ResourceList

(Optional)

Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified; otherwise, it defaults to an implementation-defined value. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/.

SelectorRequirement

(Appears on:AddonDefaultInstallSpecItem, InstallableSpec)

FieldDescription

key

AddonSelectorKey

The selector key. Valid values are KubeVersion, KubeGitVersion and KubeProvider.

  • KubeVersion the semver expression of Kubernetes versions, i.e., v1.24.

  • KubeGitVersion may contain distro. info., i.e., v1.24.4+eks.

  • KubeProvider the Kubernetes provider, i.e., aws, gcp, azure, huaweiCloud, tencentCloud etc.

operator

LineSelectorOperator

Represents a key’s relationship to a set of values. Valid operators are Contains, NotIn, DoesNotContain, MatchRegex, and DoesNoteMatchRegex.

Possible enum values:

  • Contains line contains a string.

  • DoesNotContain line does not contain a string.

  • MatchRegex line contains a match to the regular expression.

  • DoesNotMatchRegex line does not contain a match to the regular expression.

values

[]string

(Optional)

Represents an array of string values. This serves as an “OR” expression to the operator.


Generated with gen-crd-api-reference-docs