kubectl confluent block-reconcile

Pause reconciliation for all Confluent Platform components in a namespace.

To install the Confluent plugin, see Confluent plugin.

Synopsis

Pause reconciliation for all Confluent Platform components in a namespace.

Sets the platform.confluent.io/block-reconcile annotation on every Confluent Platform CR in the namespace — both Day-1 infrastructure (Kafka, Zookeeper, KRaftController, Connect, SchemaRegistry, ksqlDB, ControlCenter, KafkaRestProxy, USMAgent, Gateway) and Day-2/logical resources (KafkaTopic, Schema, Connector, ClusterLink, …). Use it before an operator or CRD upgrade so components are not reconciled (and workloads are not rolled) during the upgrade; run ‘kubectl confluent enable-reconcile’ afterwards to resume.

CR kinds are discovered dynamically, so new components are covered automatically. The command is client-side (works whether or not the operator is running) and idempotent — re-running is a no-op.

Namespace targeting — pick the one that matches how your operator watches namespaces:

-n, --namespace <ns>    a single namespace (default: the current kubeconfig namespace)
--namespaces a,b,c      a namespaced operator that watches a known set of namespaces
-A, --all-namespaces    a cluster-wide operator (every namespace)

All standard kubectl flags are honored, e.g. –context, –cluster, –kubeconfig.

kubectl confluent block-reconcile [flags]

Examples

# Pause reconciliation in one namespace before upgrading the operator
kubectl confluent block-reconcile -n confluent

# A namespaced operator that watches several namespaces
kubectl confluent block-reconcile --namespaces team-a,team-b,team-c

# A cluster-wide operator (all namespaces)
kubectl confluent block-reconcile --all-namespaces

# Target a specific cluster context
kubectl confluent block-reconcile -n confluent --context prod-cluster

Options

-A, --all-namespaces       Target CRs in all namespaces (use for a cluster-wide operator). Mutually exclusive with --namespaces.
-h, --help                 help for block-reconcile
    --namespaces strings   Comma-separated namespaces to target (use for a namespaced operator watching a known set). Overrides -n/--namespace.

Options inherited from parent commands

    --as string                      Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
    --as-group stringArray           Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
    --as-uid string                  UID to impersonate for the operation.
    --cache-dir string               Default cache directory (default "$HOME/.kube/cache")
    --certificate-authority string   Path to a cert file for the certificate authority
    --client-certificate string      Path to a client certificate file for TLS
    --client-key string              Path to a client key file for TLS
    --cluster string                 The name of the kubeconfig cluster to use
    --context string                 The name of the kubeconfig context to use
    --disable-compression            If true, opt-out of response compression for all requests to the server
    --insecure-skip-tls-verify       If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
    --kubeconfig string              Path to the kubeconfig file to use for CLI requests.
-n, --namespace string               If present, the namespace scope for this CLI request
    --request-timeout string         The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
-s, --server string                  The address and port of the Kubernetes API server
    --tls-server-name string         Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
    --token string                   Bearer token for authentication to the API server
    --user string                    The name of the kubeconfig user to use

SEE ALSO