Merge pull request #245 from marsishandsome/feature/docs-5.1-overview

docs for v5.1: add `Get Started -> What's Next` and `Overview`
This commit is contained in:
iosmanthus 2021-07-16 14:03:54 +08:00 committed by GitHub
commit f5e5909a34
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 133 additions and 12 deletions

View File

@ -1,9 +1,38 @@
---
title: Get Started
description: TODO
description: TiKV Introduction
menu:
"5.1":
weight: 1
---
TODO
**TiKV** is a highly scalable, low latency, and easy to use key-value database that delivers <10ms performance at any scale.
TiKV is intended to fill the role of a unifying distributed storage layer. TiKV excels at working with **data in the large** by supporting petabyte scale deployments spanning trillions of rows.
As a graduate project of the [Cloud Native Computing Foundation](https://www.cncf.io/), TiKV is originally created by [PingCAP](https://pingcap.com/en) to complement [TiDB](https://github.com/pingcap/tidb).
{{< info >}}
The **Ti** in TiKV stands for **titanium**. Titanium has the highest strength-to-density ratio of any metallic element and is named after the Titans of Greek mythology.
{{< /info >}}
## Architecture
A TiKV cluster consists of the following components:
- A group of TiKV nodes: storing key-value pair data
- A Placement Driver (PD) node: working as the manager of the TiKV cluster
TiKV clients interact with PD and TiKV through gRPC.
{{< figure
src="/img/basic-architecture.png"
alt="TiKV architecture diagram"
caption="The architecture of TiKV"
width="70" >}}
You can read more in the [Core concepts and architecture behind TiKV](../../reference/architecture/overview/) documentation.
## What's Next
[TiKV in 5 Minutes](../tikv-in-5-minutes/) is strongly recommended if you want to try TiKV.

View File

@ -1,10 +1,25 @@
---
title: What's Next
description: TODO
description:
menu:
"5.1":
parent: Get Started
weight: 3
---
TODO
We recommend continuing learning about TiKV using the following resources:
- As a TiKV cluster administrator, learn how to:
- Install a TiKV cluster: [Install TiKV](../../deploy/install/install/)
- Config a TiKV cluster: [Configure TiKV](../../deploy/configure/introduction/)
- Benchmark of a TiKV cluster: [Benchmark and Performance](../../deploy/benchmark/benchmark/)
- Monitor a TiKV cluster: [Monitor and Alert](../../deploy/monitor/monitor/)
- Maintain and operate a TiKV cluster: [Operate TiKV Cluster](../../deploy/operate/operate/)
- Administrate TiKV Cluster with CLI Tools: [CLI](../../reference/cli/introduction/)
- As an application developer, learn
- How to interact with a TiKV cluster using TiKV clients: [TiKV clients](../../develop/clients/introduction/)
- How to interact with TiKV using RawKV API: [RawKV](../../develop/rawkv/introduction/)
- The architecture of TiKV: [Architecture](../../reference/architecture/introduction/)
- Want to become a contributor, learn
- How to be a TiKV Contributor: [Contribute](/community/contribute/)
- The internal of TiKV: [Deep Dive](/deep-dive/introduction/)

View File

@ -1,9 +1,65 @@
---
title: Deploy
description: TODO
description: Learn how to deploy and operate a TiKV cluster
menu:
"5.1":
weight: 3
---
TODO
Learn to deploy, configure, monitor, and scale TiKV as you adopt the service into your project and infrastructure.
## [Install TiKV](../install/install/)
In the [Install TiKV](../install/install/) section youll find several guides to help you deploy and integrate TiKV into your infrastructure.
The best supported and most comprehensive deployment solution for production environment is to [Deploy TiKV using TiUP](../install/production/).
If youre determined to strike it out on your own, weve done our best to provide you with the tools you need to build your own solution. Start with [Install binary manually](../install/test/#install-binary-manually).
If you want to try TiKV on your own Mac or Linux machine, please try [TiUP Playground](../install/test/#tiup-playground).
## [Configure TiKV](../configure/introduction/)
Learn about how you can configure TiKV to meet your needs in the [configure](../configure/introduction/) section. There youll find a number of guides including:
PD
- [PD Command Line Parameters](../pd-command-line): Learn configuration flags of PD.
- [PD Config](../pd-configuration-file): Learn the PD configuration file.
TiKV
- [TiKV Command Line Parameters](../tikv-command-line): Learn configuration flags of TiKV.
- [TiKV Config](../tikv-configuration-file): Learn the TiKV configuration file.
- [Security](../security): Use TLS security and review security procedures.
- [Topology Lable](../topology): Use location awareness to improve resiliency and performance.
- [Limit](../limit): Learn how to configure scheduling rate limit on stores.
- [Region Merge](../region-merge): Tweak region merging.
- [RocksDB](../rocksdb): Tweak RocksDB configuration parameters.
- [Raftstore](../raftstore): Learn how to configure Raftstore in TiKV.
- [Titan](../titan): Enable titan to improve performance with large values.
- [Storage](../storage): Learn how to configure storage in TiKV.
- [gRPC](../grpc): Learn how to configure gRPC in TiKV.
- [Coprocessor](../coprocessor): Learn how to configure Coprocessor in TiKV.
## [Benchmark and Performance](../benchmark/benchmark/)
## [Monitor and Alert](../monitor/monitor/)
Learn how to inspect a TiKV cluster in the [Monitor and Alert](../monitor/monitor/) section. Youll find out
- [Monitoring Framework](../monitor/framework/): Use Prometheus and Grafana to build the TiKV monitoring framework.
- [Monitoring API](../monitor/api/): Learn the API of TiKV monitoring services.
- [Deploy Monitoring Services](../monitor/deploy/): Learn how to deploy monitoring services for the TiKV cluster.
- [Export Grafana Shapshots](../monitor/grafana/): Learn how to export snapshots of Grafana Dashboard, and how to visualize these files.
- [Key Metrics](../monitor/key-metrics/): Learn some key metrics displayed on the Grafana Overview dashboard.
- [TiKV Cluster Alert Rules](../monitor/alert/): Learn the alert rules in a TiKV cluster.
## [Operate TiKV](../operate/operate/)
This section introduces how to maintain and operate a TiKV cluster.
- [Upgrade a TiKV cluster using TiUP](../operate/upgrade): Learn how to upgrade TiKV using TiUP
- [Scale out/in a TiKV cluster using TiUP](../operate/scale): How to grow and shrink your TiKV cluster.
- [Maintain a TiKV cluster using TiUP](../operate/maintain): Learn the common operations to operate and maintain a TiKV cluster using TiUP

View File

@ -23,7 +23,7 @@ TiKV has clients for a number of languages:
| Clients | RawKV API | TxnKV API | Supported TiKV Version |
| -------------------------- | ----------------- | ----------------- | ---------------------- |
| [Java Client](../java) | Stable | Under development | >= 2.0.0 |
| [Go Client V2](../go) | Unstable | Unstable | >= 5.0.0 |
| [Rust Client](../rust) | Stable | Stable | >= 5.0.0 |
| [Go Client](../go) | Unstable | Unstable | >= 5.0.0 |
| [Rust Client](../rust) | Unstable | Unstable | >= 5.0.0 |
| [Python Client](../python) | Unstable | Unstable | >= 5.0.0 |
| [C Client](../c) | Unstable | Unstable | >= 5.0.0 |
| [C++ Client](../cpp) | Unstable | Unstable | >= 5.0.0 |

View File

@ -1,9 +1,30 @@
---
title: Develop
description: TODO
description: Learn how to use TiKV Clients for different languages
menu:
"5.1":
weight: 2
---
TODO
Learn how to use TiKV Clients for different languages.
## [TiKV Clients](../clients/introduction/)
TiKV has clients for a number of languages:
- [Java Client](../clients/java)'s RawKV API is ready for production.
- [Go Client](../clients/go) is still in the stage of prove-of-concept and under heavy development.
- [Rust Client](../clients/rust) is still in the stage of prove-of-concept and under heavy development.
- [Python Client](../clients/python) is still in the stage of prove-of-concept and under heavy development.
- [C++ Client](../clients/cpp) is still in the stage of prove-of-concept and under heavy development.
## RawKV and TxnKV
TiKV supports both transactional (TxnKV) API and non-transactional (RawKV) API.
Learn how to use [RawKV API](../rawkv/introduction/):
- [Get Put Delete](../rawkv/get-put-delete/)
- [Scan](../rawkv/scan)
- [Time to Live (TTL)](../rawkv/ttl)
- [Compare And Swap (CAS)](../rawkv/cas)

View File

@ -9,7 +9,7 @@ menu:
TiKV supports both transactional (TxnKV) API and non-transactional (RawKV) API. This chapter walks you through a few demonstrations about how to use RawKV API.
- [Put Get Delete](../put-get-delete)
- [Get Put Delete](../get-put-delete/)
- [Scan](../scan)
- [Time to Live (TTL)](../ttl)
- [Compare And Swap (CAS)](../cas)