calicoctl replace

This sections describes the calicoctl replace command.

Read the calicoctl command line interface user reference for a full list of calicoctl commands.

calicoctl replace - 图1note

The available actions for a specific resource type may be limited based on the datastore used for Calico (etcdv3 / Kubernetes API). Please refer to the Resources section for details about each resource type.

Displaying the help text for ‘calicoctl replace’ command

Run calicoctl replace --help to display the following help menu for the command.

  1. Usage:
  2.   calicoctl replace --filename=<FILENAME> [--recursive] [--skip-empty] [--config=<CONFIG>] [--namespace=<NS>]
  4. Examples:
  5.   # Replace a policy using the data in policy.yaml.
  6.   calicoctl replace -f ./policy.yaml
  8.   # Replace a policy based on the JSON passed into stdin.
  9.   cat policy.json | calicoctl replace -f -
  11. Options:
  12.   -h --help                  Show this screen.
  13.   -f --filename=<FILENAME>   Filename to use to replace the resource.  If set
  14.                              to "-" loads from stdin. If filename is a directory, this command is
  15.                              invoked for each .json .yaml and .yml file within that directory,
  16.                              terminating after the first failure.
  17.   -R --recursive             Process the filename specified in -f or --filename recursively.
  18.      --skip-empty            Do not error if any files or directory specified using -f or --filename contain no
  19.                              data.
  20.   -c --config=<CONFIG>       Path to the file containing connection
  21.                              configuration in YAML or JSON format.
  22.                              [default: /etc/calico/calicoctl.cfg]
  23.   -n --namespace=<NS>        Namespace of the resource.
  24.                              Only applicable to NetworkPolicy, NetworkSet, and WorkloadEndpoint.
  25.                              Uses the default namespace if not specified.
  26.   --context=<context>        The name of the kubeconfig context to use.
  28. Description:
  29.   The replace command is used to replace a set of resources by filename or
  30.   stdin.  JSON and YAML formats are accepted.
  32.   Valid resource types are:
  34.     * bgpConfiguration
  35.     * bgpPeer
  36.     * felixConfiguration
  37.     * globalNetworkPolicy
  38.     * hostEndpoint
  39.     * ipPool
  40.     * networkPolicy
  41.     * networkSet
  42.     * node
  43.     * profile
  44.     * workloadEndpoint
  46.   Attempting to replace a resource that does not exist is treated as a
  47.   terminating error.
  49.   The output of the command indicates how many resources were successfully
  50.   replaced, and the error reason if an error occurred.
  52.   The resources are replaced in the order they are specified.  In the event of
  53.   a failure replacing a specific resource it is possible to work out which
  54.   resource failed based on the number of resources successfully replaced.
  56.   When replacing a resource, the complete resource spec must be provided, it is
  57.   not sufficient to supply only the fields that are being updated.

Examples

  1. Replace a set of resources (of mixed type) using the data in resources.yaml.

    1. calicoctl replace -f ./resources.yaml

    Results indicate that 8 resources were successfully replaced.

    1. Successfully replaced 8 resource(s)

  2. Replace a policy based on the JSON passed into stdin.

    1. cat policy.json | calicoctl replace -f -

    Results indicate the policy does not exist.

    1. Failed to replace any 'policy' resources: resource does not exist: Policy(name=dbPolicy)

Options

  1. -f --filename=<FILENAME>   Filename to use to replace the resource.  If set
  2.                            to "-" loads from stdin.

General options

  1. -c --config=<CONFIG>       Path to the file containing connection
  2.                            configuration in YAML or JSON format.
  3.                            [default: /etc/calico/calicoctl.cfg]

See also