Skip to main content

# kater chart duplicate

Copies a saved chart under a new name, over the same query.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

The copy comes after the query's last chart. Without a name, the copy is `unnamed_chart_1`, or the next free number.

## Examples

```bash
# Keep the spend_mix chart in a file
kater chart read --request-file spend_mix.json --json > spend_mix_read.json
# Make a request that copies it as spend_mix_donut
jq '{chart: .definition.spec.relation, expected_revision: .definition.revision, name: "spend_mix_donut"}' spend_mix_read.json > spend_mix_duplicate.json
# Copy the chart
kater chart duplicate --request-file spend_mix_duplicate.json
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<path>` | Optional. In place of `--request-file`: the workspace, the query file or the chart file the request names. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--request-file <file>` | The chart to copy, with its revision and the copy's name, as JSON. Give `-` to read it from standard input. See [The request](#the-request). |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json`, `--kater-root`, `--scope` and `--help`.

## The request

| Field | What it holds |
| --- | --- |
| `chart` | The chart to copy: its `name`, and the full `path` of its workspace under `namespace`. |
| `expected_revision` | The chart's `revision` from `kater chart read`. |
| `name` | Optional. The copy's name, such as `spend_mix_donut`. |

## See also

- [`kater chart`](https://kater.ai/docs/cli-reference/chart/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
The request
See also

Kater CLI Present and share chart

kater chart duplicate

Copies a saved chart under a new name, over the same query.

The copy comes after the query’s last chart. Without a name, the copy is unnamed_chart_1, or the next free number.

Examples

# Keep the spend_mix chart in a file
kater chart read --request-file spend_mix.json --json > spend_mix_read.json
# Make a request that copies it as spend_mix_donut
jq '{chart: .definition.spec.relation, expected_revision: .definition.revision, name: "spend_mix_donut"}' spend_mix_read.json > spend_mix_duplicate.json
# Copy the chart
kater chart duplicate --request-file spend_mix_duplicate.json

Arguments

Argument	Description
`<path>`	Optional. In place of `--request-file`: the workspace, the query file or the chart file the request names.

Options

Option	Description
`--request-file <file>`	The chart to copy, with its revision and the copy’s name, as JSON. Give `-` to read it from standard input. See The request.

It also takes the global options --json, --kater-root, --scope and --help.

The request

Field	What it holds
`chart`	The chart to copy: its `name`, and the full `path` of its workspace under `namespace`.
`expected_revision`	The chart’s `revision` from `kater chart read`.
`name`	Optional. The copy’s name, such as `spend_mix_donut`.

See also