Lab 1: Deploy TiDB Cluster on AWS EKS

This lab deploys a TiDB cluster on an AWS EKS. The TiDB cluster is managed by TiDB-Operator, and the deployment process is automated with Pulumi.

• Lab 1: Deploy TiDB Cluster on AWS EKS
  • Introduction
  • Learning Objectives
  • Pre-Requisites
  • Syllabus
  • AWS billing price

Introduction

Why using cloud platform (AWS)?

Cloud computing is the delivery of computing services—including servers, storage, databases, networking, software, analytics, and intelligence—over the internet ("the cloud") to offer faster innovation, flexible resources, and economies of scale, as your business needs change.

Why Kubernetes (EKS)?

Kubernetes offers automating deployment, scaling, and management of containerized applications. Adopting Kubernetes ultimately accelerates business and saves costs under relatively high application workload.

Amazon EKS is a managed Kubernetes service that makes it easy for you to run Kubernetes on AWS.

Why Operator?

Operators are software extensions to Kubernetes that use custom resources to manage applications and their components.

At first, there is Kubernetes, which is capable of scaling and being usable in extremely diverse contexts and applications. To do more complex things, capability of Kubernetes must be extended and more sophisticated automations must be created, suited to individual applications and their specific domain of action. This is where the Operators come in.

Why TiDB?

TiDB is an open-source distributed SQL database that supports HTAP workloads. It provides users with a one-stop database solution, and helps improve scalability, availability and reliability for users' data storage systems.

Why TiDB on EKS?

When deploying TiDB clusters on AWS EKS, users can gain all features provided by TiDB, while leverage the benefits of operating TiDB clusters on managed Kubernetes services.

Why IaC (Pulumi)

Infrastructure as code (IaC) means using code to define and manage modern cloud infrastructure. IaC has many benefits, such as:

• Version control
• Testing
• Use of IDEs
• DevOps

Learning Objectives

• Understand basic usage of Kubernetes
• Understand basic usage of AWS Kubernetes service (EKS)
• Understand the fundamentals of operator pattern
• Learn to deploy TiDB clusters on Kubernetes with TiDB Operator
• Understand basic usage of TiDB cluster
• Automate deployment process with Pulumi IaC framework

Pre-Requisites

• An AWS account
• VPN for connecting to AWS API and GitHub
• Linux or MacOS or WSL2 environments

Syllabus

100 basic points + 20 bonus points.

• Step 0: Install Dependencies 0-install-dependencies

1. (25 points) Create an EKS cluster 1-create-an-eks-cluster
2. (25 points) Deploy TiDB with TiDB Operator 2-deploy-tidb-with-tidb-operator
3. (20 points) Explore TiDB basic usage 3-explore-tidb-basic-usage
4. (20 points) Scale up TiDB cluster with TiDB Operator 4-scale-up-tidb-cluster-with-tidb-operator
5. (10 points) Cleanup: Destroy the EKS cluster finished-destroy-the-eks-cluster-via-pulumi

• (20 bonus points) Bonus: Config the TiDB slow-log threshold and update the cluster with Pulumi code [bonus]config-slow-log-threshold

---

AWS billing price

This lab will incur charges under the aws account, described in detail at:

• New EKS cluster control plane, 1 cluster x 0.10 USD per hour
• Two EKS worker EC2 t2.medium instances, 2 instances * 0.0464 USD per hour
• 4 EBS of size 1 GiB, with negligible cost

Total 0.1928 USD per hour.