Skip to content
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

docs/*: add overview, op-guide, client #3494

Merged
merged 15 commits into from
Aug 29, 2018

Conversation

lilin90
Copy link
Member

@lilin90 lilin90 commented Aug 22, 2018

Signed-off-by: lilin90 lilin@pingcap.com

What have you changed? (mandatory)

Add the following TiKV documents:

  • Overview
  • Install and Deploy TiKV
    • Install and Deploy TiKV Using Docker Compose
    • Install and Deploy TiKV Using Ansible
    • Install and Deploy TiKV Using Docker
    • Install and Deploy TiKV Using Binary Files
  • Client Drivers
    • Go

Does this PR affect documentation (docs/docs-cn) update? (mandatory)

Relevant.

Does this PR affect tidb-ansible update? (mandatory)

No.

Signed-off-by: lilin90 <lilin@pingcap.com>
@lilin90
Copy link
Member Author

lilin90 commented Aug 22, 2018

@queenypingcap PTAL

@siddontang
Copy link
Contributor

overview may be duplicated with readme?

@lilin90
Copy link
Member Author

lilin90 commented Aug 22, 2018

@siddontang I also noticed that when I commit. I keep it because later we'll maintain a whole set of separate documentation for TiKV and might put them on a separate website page. And all those contents come from here (tikv/docs).

Currently, I'll maintain TiKV documentation at TiKV Wiki.

QueenyJin
QueenyJin previously approved these changes Aug 22, 2018
siddontang
siddontang previously approved these changes Aug 22, 2018
@siddontang
Copy link
Contributor

PTAL @Hoverbear

@breezewish breezewish added the status/LGT1 Indicates that a PR has LGTM 1. label Aug 22, 2018
zhangjinpeng87
zhangjinpeng87 previously approved these changes Aug 23, 2018
Copy link
Member

@zhangjinpeng87 zhangjinpeng87 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM


## Try the Raw Key-Value API

To use the Raw Key-Value API in applications developed by golang, take the following steps:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

in the Go language

Description of two parameters in the above command:

- `string`: a list of PD servers’ addresses
- `config.Security`: used for establishing TLS connections, usually left empty when you do not need TLS
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it expected that the user will understand how to set up TLS here if they want it?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes.


- Transaction

Like the Transaction in SQL, a Transaction symbolizes a series of read and write operations performed within the Storage. Internally, a Transaction consists of a Snapshot for reads, and a MemBuffer for all writes. The default isolation level of a Transaction is Snapshot Isolation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Like transactions in SQL

- CentOS 7.3 (64 bit) or later with Python 2.7 installed, x86_64 architecture (AMD64)
- Network between machines

> **Note:** When you deploy TiKV using Ansible, use SSD disks for the data directory of TiKV and PD nodes. Otherwise, it cannot pass the check. For more details, see [Software and Hardware Requirements](https://github.com/pingcap/docs/blob/master/op-guide/recommendation.md).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can have a better reason than this. Maybe "Otherwise, the system will not perform well."

@lilin90
Copy link
Member Author

lilin90 commented Aug 27, 2018

@siddontang @zhangjinpeng1987 @Hoverbear PTAL again. Thanks!

@siddontang siddontang merged commit 4666556 into tikv:master Aug 29, 2018
@lilin90 lilin90 deleted the overview-deploy-client branch August 29, 2018 10:04
sticnarf pushed a commit to sticnarf/tikv that referenced this pull request Oct 27, 2019
* docs/*: add overview, op-guide, client

Signed-off-by: lilin90 <lilin@pingcap.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
status/LGT1 Indicates that a PR has LGTM 1.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants