karmadactl interpret

Validate and test interpreter customization before applying it to the control plane

Synopsis

Validate and test interpreter customization before applying it to the control plane.

1. Validate the ResourceInterpreterCustomization configuration as per API schema and try to load the scripts for syntax check.
2. Run the rules locally and test if the result is expected. Similar to the dry run.

karmadactl interpret (-f FILENAME) (--operation OPERATION) [--ARGS VALUE]... 

Examples

  # Check the customizations in file
  karmadactl interpret -f customization.json --check
  
  # Execute the retention rule
  karmadactl interpret -f customization.yml --operation retain --desired-file desired.yml --observed-file observed.yml
  
  # Execute the replicaResource rule
  karmadactl interpret -f customization.yml --operation interpretReplica --observed-file observed.yml
  
  # Execute the replicaRevision rule
  karmadactl interpret -f customization.yml --operation reviseReplica --observed-file observed.yml --desired-replica 2
  
  # Execute the statusReflection rule
  karmadactl interpret -f customization.yml --operation interpretStatus --observed-file observed.yml
  
  # Execute the healthInterpretation rule
  karmadactl interpret -f customization.yml --operation interpretHealth --observed-file observed.yml
  
  # Execute the dependencyInterpretation rule
  karmadactl interpret -f customization.yml --operation interpretDependency --observed-file observed.yml
  
  # Execute the statusAggregation rule
  karmadactl interpret -f customization.yml --operation aggregateStatus --observed-file observed.yml --status-file status.yml
  
  # Fetch observed object from url, and status items from stdin (specified with -)
  karmadactl interpret -f customization.yml --operation aggregateStatus --observed-file https://example.com/observed.yml --status-file -

Options

      --check                    Validates the given ResourceInterpreterCustomization configuration(s)
      --desired-file string      Filename, directory, or URL to files identifying the resource to use as desiredObj argument in rule script.
      --desired-replica int32    The desiredReplica argument in rule script.
  -f, --filename strings         Filename, directory, or URL to files containing the customizations
  -h, --help                     help for interpret
      --karmada-context string   The name of the kubeconfig context to use
      --observed-file string     Filename, directory, or URL to files identifying the resource to use as observedObj argument in rule script.
      --operation string         The interpret operation to use. One of: (Retain,InterpretReplica,ReviseReplica,InterpretStatus,AggregateStatus,InterpretHealth,InterpretDependency)
  -R, --recursive                Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory.
      --status-file string       Filename, directory, or URL to files identifying the resource to use as statusItems argument in rule script.

Options inherited from parent commands

      --add-dir-header                   If true, adds the file directory to the header of the log messages
      --alsologtostderr                  log to standard error as well as files (no effect when -logtostderr=true)
      --kubeconfig string                Paths to a kubeconfig. Only required if out-of-cluster.
      --log-backtrace-at traceLocation   when logging hits line file:N, emit a stack trace (default :0)
      --log-dir string                   If non-empty, write log files in this directory (no effect when -logtostderr=true)
      --log-file string                  If non-empty, use this log file (no effect when -logtostderr=true)
      --log-file-max-size uint           Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
      --logtostderr                      log to standard error instead of files (default true)
      --one-output                       If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
      --skip-headers                     If true, avoid header prefixes in the log messages
      --skip-log-headers                 If true, avoid headers when opening log files (no effect when -logtostderr=true)
      --stderrthreshold severity         logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=false) (default 2)
  -v, --v Level                          number for the log level verbosity
      --vmodule moduleSpec               comma-separated list of pattern=N settings for file-filtered logging

SEE ALSO

• karmadactl - karmadactl controls a Kubernetes Cluster Federation.

Go Back to Karmadactl Commands Homepage.

Auto generated by spf13/cobra script in Karmada.