add interpret command

[ikaven1024]

Signed-off-by: yingjinhui yingjinhui@didiglobal.com

What type of PR is this?
/kind feature

What this PR does / why we need it:
add skeleton of interpreter command.

Which issue(s) this PR fixes:
part of #2371

Special notes for your reviewer:

Usage

Check the valid of customizations. Or show the result of the rules running.

  1. 
 Check valid. Given the customization by NAME or '-f' option, this tool will check the rules in customization, and print
'PASS' or 'FAIL' for each rule. The fail reasons are also printed.
  2. 
 Execute rules and show result. Given the customization by NAME or '-f' option, the operation by 'operation' option, and
arguments by options(desired, desired-file, observed, observed-file, status, status-file, desired-replica),  this tool
will run the rule and print result. The arguments for operations see below.

  *  retention                : (desired|desired-file), (observed|observed-file)
  *  replicaResource          : (desired|desired-file|observed|observed-file)
  *  replicaRevision          : (desired|desired-file|observed|observed-file), desired-replica
  *  statusReflection         : (desired|desired-file|observed|observed-file)
  *  statusAggregation        : (desired|desired-file|observed|observed-file), status-file...
  *  healthInterpretation     : (desired|desired-file|observed|observed-file)
  *  dependencyInterpretation : (desired|desired-file|observed|observed-file)

Examples:
  # Check the customizations in file
  karmadactl interpret -f customization.json --check
  # Check the customizations on server
  karmadactl interpret customization --check
  # Check the retention rule
  karmadactl interpret customization --operation retention --check
  
  # Execute the retention rule for local resource
  karmadactl interpret customization --operation retention --desired-file desired.json --observed-file observed.json
  # Execute the retention rule for server resource
  karmadactl interpret customization --operation retention --desired-file desired.json --observed deployments/foo

Options:
    --check=false:
        Check the given customizations

    --desired='':
        The type and name of resource on server to use as desiredObj argument in rule script. For example:
        deployment/foo.

    --desired-file='':
        Filename, directory, or URL to files identifying the resource to use as desiredObj argument in rule script.

    --desired-replica=0:
        The desiredReplica argument in rule script.

    -f, --filename=[]:
        Filename, directory, or URL to files containing the customizations

    --karmada-context='':
        The name of the kubeconfig context to use

    -n, --namespace='':
        If present, the namespace scope for this CLI request

    --observed='':
        The type and name of resource on server to use as observedObj argument in rule script. For example:
        deployment/foo.

    --observed-file='':
        Filename, directory, or URL to files identifying the resource to use as observedObj argument in rule script.

    --operation='':
        The interpret operation to use. One of:
        (retention,replicaResource,replicaRevision,statusReflection,statusAggregation,healthInterpretation,dependencyInterpretation)

    -R, --recursive=false:
        Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests
        organized within the same directory.

    --status-file=[]:
        Filename, directory, or URL to files identifying the resource to use as statusItems argument in rule script.

Usage:
  karmadactl interpret (-f FILENAME | NAME) (--operation OPERATION) [-n NAMESPACE] [--ARGS VALUE]...  [options]

Use "karmadactl options" for a list of global command-line options (applies to all commands).

Check

Prepare a customization.yaml

apiVersion: config.karmada.io/v1alpha1
kind: ResourceInterpreterCustomization
metadata:
  name: customization
spec:
  target:
    apiVersion: apps/v1
    kind: Deployment
  customizations:
    retention:
      luaScript: >
        function Retain(desiredObj, runtimeObj)
          desiredObj.spec.fieldFoo = runtimeObj.spec.fieldFoo
          return desiredObj
        end
    replicaResource:
      luaScript: >
        bad format

interpret -f customization.yml --check

Output:

-----------------------------------
SOURCE: customization
TARGET: apps/v1 Deployment   
RULERS:
    retention:                  PASS
    replicaResource:            ERROR: <string> line:1(column:10) near 'format':   parse error   
    replicaRevision:            UNSET
    statusReflection:           UNSET
    statusAggregation:          UNSET
    healthInterpretation:       UNSET
    dependencyInterpretation:   UNSET

Does this PR introduce a user-facing change?:

`karmadactl`: add interpreter command for resource interpret customizations.

[ikaven1024]

@RainbowMango: PLZ check the usage of this command.

[codecov-commenter]

Codecov Report

Merging #2750 (79b63d6) into master (594ad9f) will decrease coverage by 0.05%.
The diff coverage is 0.00%.

@@            Coverage Diff             @@
##           master    #2750      +/-   ##
==========================================
- Coverage   37.91%   37.85%   -0.06%     
==========================================
  Files         189      190       +1     
  Lines       17644    17696      +52     
==========================================
+ Hits         6689     6699      +10     
- Misses      10548    10590      +42     
  Partials      407      407              

Flag	Coverage Δ
unittests	37.85% <0.00%> (-0.06%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...ceinterpreter/configurableinterpreter/luavm/lua.go	55.83% <0.00%> (-2.21%)	⬇️
...armadactl/cmdinit/karmada/webhook_configuration.go	81.91% <0.00%> (-6.53%)	⬇️
pkg/karmadactl/util/idempotency.go	6.74% <0.00%> (-1.60%)	⬇️
pkg/karmadactl/taint/taint.go	43.75% <0.00%> (ø)
pkg/karmadactl/cmdinit/utils/rbac.go	0.00% <0.00%> (ø)
pkg/karmadactl/cmdinit/karmada/deploy.go	0.00% <0.00%> (ø)
.../resourceinterpreter/defaultinterpreter/default.go	0.00% <0.00%> (ø)
pkg/util/metrics/metrics.go	71.42% <0.00%> (ø)
pkg/karmadactl/cmdinit/karmada/rbac.go	88.57% <0.00%> (+0.45%)	⬆️

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[ikaven1024]

@RainbowMango Will you merge this PR when you feel ok? I will do this work in several PRs.

[lonelyCZ]

Hi, @ikaven1024 perhaps you can develop it in this PR as multiple commits.

Because the karmadactl will have a big change recently at #2664

[ikaven1024]

Waiting for #2794 ready

[ikaven1024]

@RainbowMango @XiShanYongYe-Chang It's ready for review.

[ikaven1024]

OK. Please help to rebase your code since we have solved some fake tests in these two days.

@XiShanYongYe-Chang I have rebase the master, but still fail:
https://github.com/karmada-io/karmada/actions/runs/3485018546/jobs/5830406361#step:5:3394

[ikaven1024]

I have pick out the execute mod into #2824, make this pr smaller

[RainbowMango]

/assign

[XiShanYongYe-Chang]

@XiShanYongYe-Chang I have rebase the master, but still fail:
https://github.com/karmada-io/karmada/actions/runs/3485018546/jobs/5830406361#step:5:3394

This error is caused by the failure to delete the Kind node and can be ignored.

[RainbowMango]

I believe this approach is much better now.

The review is still ongoing.

[RainbowMango]

Some small touches, otherwise LGTM.

[RainbowMango]

/lgtm
/approve

[karmada-bot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: RainbowMango

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [RainbowMango]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment