chore: support reconfigure args (#10350)

Author: leon-ape

apis/apps/v1/componentdefinition_types.go

@@ -1115,6 +1115,7 @@ type ComponentFileTemplate struct {
 	//
 	// If specified, this action overrides the global reconfigure action defined in lifecycle actions
 	// for this specific file template.
+	// External-managed systems may define different behavior for this action entry.
 	//
 	// The container executing this action has access to following variables:
 	//

apis/apps/v1/types.go

@@ -522,7 +522,7 @@ type ClusterComponentConfig struct {
 	// +optional
 	Name *string `json:"name,omitempty"`
 
-	// Variables are key-value pairs for dynamic configuration values that can be provided by the user.
+	// Variables are template variables used to render managed configuration templates.
 	//
 	// +optional
 	Variables map[string]string `json:"variables,omitempty"`
@@ -571,6 +571,11 @@ type ClusterComponentConfig struct {
 	//
 	// +optional
 	ReconfigureAction *Action `json:"reconfigureAction,omitempty"`
+
+	// ReconfigureArgs is a list of runtime argument groups for the reconfigure action.
+	//
+	// +optional
+	ReconfigureArgs [][]string `json:"reconfigureArgs,omitempty"`
 }
 
 // ClusterComponentConfigSource represents the source of a configuration for a component.

apis/apps/v1/zz_generated.deepcopy.go

@@ -147,6 +147,10 @@ type ParametersDefinitionSpec struct {
 
 	// List dynamic parameters.
 	// Modifications to these parameters trigger a configuration reload without requiring a process restart.
+	// When parameter updates are applied through a ComponentDefinition config template reconfigure ExecAction,
+	// the controller invokes the action once for each updated
+	// parameter and appends the parameter name and value as the last arguments.
+	// HTTP and gRPC reconfigure actions are not currently supported for parameter updates.
 	//
 	// +listType=set
 	// +optional

apis/parameters/v1alpha1/parametersdefinition_types.go

@@ -556,10 +556,15 @@ type ConfigTemplate struct {
 	// +optional
 	ReconfigureActionName string `json:"reconfigureActionName,omitempty"`
 
-	// The parameters to call the reconfigure action.
+	// The env/template parameters to call the reconfigure action.
 	//
 	// +optional
 	Parameters map[string]string `json:"parameters,omitempty"`
+
+	// ReconfigureArgs is the runtime argv payload for the reconfigure action.
+	//
+	// +optional
+	ReconfigureArgs [][]string `json:"reconfigureArgs,omitempty"`
 }
 
 type InstanceStatus struct {

apis/workloads/v1/instanceset_types.go

@@ -713,15 +713,23 @@ spec:
                                 format: int32
                                 type: integer
                             type: object
+                          reconfigureArgs:
+                            description: ReconfigureArgs is a list of runtime argument
+                              groups for the reconfigure action.
+                            items:
+                              items:
+                                type: string
+                              type: array
+                            type: array
                           restart:
                             description: Specifies whether to restart the component
                               to reload the updated configuration.
                             type: boolean
                           variables:
                             additionalProperties:
                               type: string
-                            description: Variables are key-value pairs for dynamic
-                              configuration values that can be provided by the user.
+                            description: Variables are template variables used to
+                              render managed configuration templates.
                             type: object
                         type: object
                       type: array
@@ -11927,16 +11935,23 @@ spec:
                                     format: int32
                                     type: integer
                                 type: object
+                              reconfigureArgs:
+                                description: ReconfigureArgs is a list of runtime
+                                  argument groups for the reconfigure action.
+                                items:
+                                  items:
+                                    type: string
+                                  type: array
+                                type: array
                               restart:
                                 description: Specifies whether to restart the component
                                   to reload the updated configuration.
                                 type: boolean
                               variables:
                                 additionalProperties:
                                   type: string
-                                description: Variables are key-value pairs for dynamic
-                                  configuration values that can be provided by the
-                                  user.
+                                description: Variables are template variables used
+                                  to render managed configuration templates.
                                 type: object
                             type: object
                           type: array

apis/workloads/v1/zz_generated.deepcopy.go

@@ -3733,6 +3733,7 @@ spec:
 
                         If specified, this action overrides the global reconfigure action defined in lifecycle actions
                         for this specific file template.
+                        External-managed systems may define different behavior for this action entry.
 
                         The container executing this action has access to following variables:
 
@@ -17567,6 +17568,7 @@ spec:
 
                         If specified, this action overrides the global reconfigure action defined in lifecycle actions
                         for this specific file template.
+                        External-managed systems may define different behavior for this action entry.
 
                         The container executing this action has access to following variables:
 

config/crd/bases/apps.kubeblocks.io_clusters.yaml

@@ -595,15 +595,23 @@ spec:
                           format: int32
                           type: integer
                       type: object
+                    reconfigureArgs:
+                      description: ReconfigureArgs is a list of runtime argument groups
+                        for the reconfigure action.
+                      items:
+                        items:
+                          type: string
+                        type: array
+                      type: array
                     restart:
                       description: Specifies whether to restart the component to reload
                         the updated configuration.
                       type: boolean
                     variables:
                       additionalProperties:
                         type: string
-                      description: Variables are key-value pairs for dynamic configuration
-                        values that can be provided by the user.
+                      description: Variables are template variables used to render
+                        managed configuration templates.
                       type: object
                   type: object
                 type: array

config/crd/bases/apps.kubeblocks.io_componentdefinitions.yaml

@@ -109,6 +109,7 @@ spec:
 
                         If specified, this action overrides the global reconfigure action defined in lifecycle actions
                         for this specific file template.
+                        External-managed systems may define different behavior for this action entry.
 
                         The container executing this action has access to following variables:
 
@@ -1968,6 +1969,7 @@ spec:
 
                         If specified, this action overrides the global reconfigure action defined in lifecycle actions
                         for this specific file template.
+                        External-managed systems may define different behavior for this action entry.
 
                         The container executing this action has access to following variables: