Skip to content

Commit

Permalink
en: add single page to describe enterprise edition deployment (pingca…
Browse files Browse the repository at this point in the history
…p#643)

* zh: add single page to describe enterprise edition deployment

* Update TOC.md

* Update deploy-tidb-enterprise-edition.md

* Apply suggestions from code review

Co-authored-by: Ran <[email protected]>

* Convert several paragraphs to a list

* Update content organization and format

Co-authored-by: Lilian Lee <[email protected]>
Co-authored-by: Ran <[email protected]>
  • Loading branch information
3 people authored Aug 18, 2020
1 parent 35fad80 commit d037cf5
Show file tree
Hide file tree
Showing 2 changed files with 87 additions and 0 deletions.
1 change: 1 addition & 0 deletions en/TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@
- [Deploy TiFlash](deploy-tiflash.md)
- [Deploy TiCDC](deploy-ticdc.md)
- [Deploy TiDB Binlog](deploy-tidb-binlog.md)
- [Deploy TiDB Enterprise Edition](deploy-tidb-enterprise-edition.md)
+ Deploy Monitoring
- [Monitor Kubernetes and TiDB Cluster](monitor-a-tidb-cluster.md)
- [Monitor TiDB Cluster Using TidbMonitor](monitor-using-tidbmonitor.md)
Expand Down
86 changes: 86 additions & 0 deletions en/deploy-tidb-enterprise-edition.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
---
title: Deploy TiDB Enterprise Edition in Kubernetes
summary: Learn how to deploy TiDB Enterprise Edition in Kubernetes.
---

# Deploy TiDB Enterprise Edition in Kubernetes

This document describes how to deploy TiDB Enterprise Edition and related tools in Kubernetes. TiDB Enterprise Edition has the following features:

* Enterprise-level best practices
* Enterprise-level service support
* Fully-enhanced security features

## Prerequisites

* TiDB Operator is [deployed](deploy-tidb-operator.md).

## Deploy the Enterprise Edition

Currently, the difference between the deployment of TiDB Operator Enterprise Edition and Community Edition mainly lies in image naming. Compared with that of Community Edition, the image of Enterprise Edition has an extra `-enterprise` suffix.

```yaml
spec:
version: v4.0.2
...
pd:
baseImage: pingcap/pd-enterprise
...
tikv:
baseImage: pingcap/tikv-enterprise
...
tidb:
baseImage: pingcap/tidb-enterprise
...
tiflash:
baseImage: pingcap/tiflash-enterprise
...
pump:
baseImage: pingcap/tidb-binlog-enterprise
...
ticdc:
baseImage: pingcap/ticdc-enterprise
```
+ If you are deploying a new cluster:
Refer to [Configure a TiDB Cluster in Kubernetes](configure-a-tidb-cluster.md) to configure `tidb-cluster.yaml` and the enterprise edition image as described above, and run the `kubectl apply -f tidb-cluster.yaml -n ${namespace}` command to deploy the TiDB Enterprise Edition cluster and related tools.

+ If you want to switch an existing Community Edition cluster to Enterprise Edition:

- Method #1: Add the "-enterprise" suffix to the `baseImage` item of the configuration file of the existing cluster in the above format and run the `kubectl apply -f tidb-cluster.yaml -n ${namespace}` command to update the cluster configuration.
- Method #2: Run the `kubectl edit tc ${name} -n ${namespace}` command to add the suffix "-enterprise" to each component's `baseImage` in the above format, and then update the cluster configuration.

TiDB Operator will automatically update the cluster image to the enterprise image through a rolling upgrade.

## Switch back to the Community Edition

```yaml
spec:
version: v4.0.2
...
pd:
baseImage: pingcap/pd
...
tikv:
baseImage: pingcap/tikv
...
tidb:
baseImage: pingcap/tidb
...
tiflash:
baseImage: pingcap/tiflash
...
pump:
baseImage: pingcap/tidb-binlog
...
ticdc:
baseImage: pingcap/ticdc
```

If you need to switch an existing Enterprise Edition cluster back to Community Edition:

- Method #1: Remove the "-enterprise" suffix from the `baseImage` item in the configuration file of the existing cluster in the above format, and run the `kubectl apply -f tidb-cluster.yaml -n ${namespace}` command to update the cluster configuration.
- Method #2: Run the `kubectl edit tc ${name} -n ${namespace}` command to remove the suffix "-enterprise" from each component's `baseImage` in the above format, and then update the cluster configuration.

After updating the configuration, TiDB Operator will automatically switch the cluster image to Community Edition image through a rolling upgrade.

0 comments on commit d037cf5

Please sign in to comment.