KubeBlocks
BlogsKubeBlocks Cloud

Getting Started

Introduction
Supported addons
Installation

Concepts and Features

Concepts

Backup and Restore

Introduction

Backup

Configure BackupRepo
Configure BackupPolicy
Scheduled backup
On-demand backup

Restore

Restore from backup set
Point-in-Time Recovery

In Place Update

Introduction
Enable in-place update

Instance Template

Introduction
Apply instance template

Trouble Shooting

FAQs

References

API Reference

Cluster
Operations
Parameters
Dataprotection
Add-On
Terminology
Install Addons
Install kbcli
Snapshot Controller
Create a test Kubernetes cluster
Kubernetes and Operator 101

Upgrade KubeBlocks

Upgrade to v0.8
Upgrade to v0.9.0
Upgrade to v0.9.x

Release Notes

v1.0.0-cn
v1.0.0
v0.9.3
v0.9.2
v0.9.1
v0.9.0

    Packages:

    • extensions.kubeblocks.io/v1alpha1

    extensions.kubeblocks.io/v1alpha1

    Resource Types:

    • Addon

    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

    © 2025 ApeCloud PTE. Ltd.