Skip to content

#RI-4580 - add info about bulk upload #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 1, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 57 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,8 @@ If you want to share your own tutorials - add the `redis-tutorials` label to you
3. [Markdown](#Markdown)
4. [Images](#Images)
5. [Manifest](#Manifest)
6. [Advanced button parameters](#Advanced)
6. [Bulk Upload From Tutorials](#bulk-upload-from-tutorials)
7. [Advanced button parameters](#Advanced)

## Structure

Expand Down Expand Up @@ -105,6 +106,61 @@ A Node can be represented by various UI components and is specified by `type` pr
> _**!Note.** All **"internal-link"** nodes located in the same **"group"** will be connected to each other. And using pagination (created dynamically) you can go directly from one page to another. Therefore, it is better to combine elements into groups related to the same topic._


## Bulk Upload From Tutorials

You can upload sample data sets in bulk from your custom RedisInsight tutorials.
To do so, you will need to:
- create a text file with the list of Redis commands
- add this file to the archive with your custom tutorials
- create a special `redis-upload` button described in this section to execute all the Redis commands from custom tutorials

This button works similarly to the Bulk Upload in Browser, so all the Redis commands specified in the file will be executed.

The following syntax describes the `redis-upload` button:

````

```redis-upload:[{relative_path_to_the_text_file}] Upload data
```

````
**Notes:**

* use only a relative path to the text file inside the tutorial folder
* it is recommended to start the folder name with the text file from a dot (*.*) or underscore (*_*), so in the cases when the manifest file is automatically generated, RedisInsight will ignore this folder and not display it in your custom tutorial
* all the files included in your custom tutorials will be stored inside the RedisInsight folder as long as the tutorials exist in RedisInsight, so instead of including large text files in your custom tutorials, consider using Bulk Upload in Browser

**Example:**

For example, with the following structure of a custom tutorial:

```
_data // a folder with the file to upload in bulk
upload.txt
folder_1 // a folder with custom tutorials
my-tutorial.md
manifest.json
```

Use one of the following examples to specify the `redis-upload` button in `my-tutorial.md`:

````
```redis-upload:[../_data/upload.txt] Upload data
```
````

as a relative path from `folder_1`

or

````
```redis-upload:[./_data/upload.txt] Upload data
```
````

as an absolute path from the tutorial folder.


## Advanced

You can customize the run parameters to configure the raw mode, pipeline parameter and group mode. If specified, they will override
Expand Down