mirror of
https://github.com/status-im/consul.git
synced 2025-01-27 22:16:23 +00:00
d4e8c8a2c1
This commit adds two new commands to the Consul KV CLI, which export and import a JSON formatted representation of the Consul KV tree. It is useful to migrate parts of the KV tree between unrelated Consul clusters, and could also be used for initial data population of the KV store.
47 lines
754 B
Plaintext
47 lines
754 B
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: KV Import"
|
|
sidebar_current: "docs-commands-kv-import"
|
|
---
|
|
|
|
# Consul KV Import
|
|
|
|
Command: `consul kv import`
|
|
|
|
The `kv import` command is used to import KV pairs from the JSON representation
|
|
generated by the `kv export` command.
|
|
|
|
## Usage
|
|
|
|
Usage: `consul kv import [DATA]`
|
|
|
|
#### API Options
|
|
|
|
<%= partial "docs/commands/http_api_options" %>
|
|
|
|
## Examples
|
|
|
|
To import from a file, prepend the filename with `@`:
|
|
|
|
```
|
|
$ consul kv import @values.json
|
|
# Output
|
|
```
|
|
|
|
To import from stdin, use `-` as the data parameter:
|
|
|
|
```
|
|
$ cat values.json | consul kv import -
|
|
# Output
|
|
```
|
|
|
|
You can also pass the JSON directly, however care must be taken with shell
|
|
escaping:
|
|
|
|
```
|
|
$ consul kv import "$(cat values.json)"
|
|
# Output
|
|
```
|
|
|
|
|