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

tiup: add kvcdc server topylogy example #19230

Merged
merged 19 commits into from
Nov 6, 2024
Merged
Changes from 2 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
44 changes: 44 additions & 0 deletions tiup/tiup-cluster-topology-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -463,6 +463,50 @@ tiproxy_servers:
- host: 10.0.1.22
```

### `kvcdc_servers`

`kvcdc_servers` specifies the machines to which the TiKV-CDC services are deployed. It also specifies the service configuration on each machine. `kvcdc_servers` is an array. Each array element contains the following fields:
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `addr`: The listening address of TiKV-CDC, the HTTP API address, and the Prometheus address of the TiKV-CDC service. The default value is 127.0.0.1:8600.
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `advertise-addr`: The advertised address via which clients access TiKV-CDC. If unspecified, the value is the same as addr.
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `pd`: A comma-separated list of PD endpoints.

- `config`: The address of the configuration file that TiKV-CDC uses (optional).

- `data-dir`: Specifies the directory that TiKV-CDC uses to store temporary files for sorting. It is recommended to ensure that the free disk space for this directory is greater than or equal to 500 GiB (optional).
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `gc-ttl`: The TTL (Time To Live, in seconds) of the service level GC safepoint in PD set by TiKV-CDC (optional). It's the duration that replication tasks can suspend, defaults to 86400, that is 24 hours. Note that suspending of replication task will affect the progress of TiKV garbage collection. The longer of gc-ttl, the longer a changefeed can be paused, but at the same time more obsolete data will be kept and larger space will be occupied. Vice versa.
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `log-file`: The path to which logs are output when the TiKV-CDC process is running (optional). If this parameter is not specified, logs are written to the standard output (stdout).
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `log-level`: The log level when the TiKV-CDC process is running (optional). The default value is "info".
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `ca`: The path of the CA certificate file in PEM format for TLS connection (optional).

- `cert`: The path of the certificate file in PEM format for TLS connection (optional).

- `key`: The path of the private key file in PEM format for TLS connection (optional).

- `cert-allowed-cn`: Specifies to verify caller's identity (certificate Common Name, optional). Use comma to separate multiple CN.
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

Among the above fields, you cannot modify the following configured fields after the deployment:
wk989898 marked this conversation as resolved.
Show resolved Hide resolved

- `host`
- `port`
- `deploy_dir`
- `data_dir`
- `log_dir`

A `kvcdc_servers` configuration example is as follows:

```yaml
kvcdc_servers:
- host: 10.0.1.21
- host: 10.0.1.22
```

### `cdc_servers`

`cdc_servers` specifies the machines to which the TiCDC services are deployed. It also specifies the service configuration on each machine. `cdc_servers` is an array. Each array element contains the following fields:
Expand Down
Loading