This repository contains Terraform code to deploy a TiDB cluster on Azure. By using Terraform, you can automate the process of creating and managing resources on Azure, such as virtual machines, databases, and networking components.
Before using this repository, make sure you have the following:
- An Azure account
- Terraform installed on your local machine
- Familiarity with Terraform syntax and Azure resources
- Clone this repository to your local machine.
- Open the
variables.tffile and modify the variables as needed to match your desired deployment configuration. You can also create a.tfvarsfile to specify values for the variables. - Run
terraform initto download the required providers and initialize the Terraform working directory. - Run
terraform planto preview the changes that will be made to your Azure resources. - If the plan looks good, run
terraform applyto apply the changes and deploy the TiDB cluster on Azure.
After deploying the TiDB cluster, you can use Terraform to make changes to the resources or manage the deployment. To update the cluster, modify the Terraform code, run terraform plan, and then run terraform apply. To destroy the cluster, run terraform destroy.
After deploying the TiDB cluster with Terraform, you can use the terraform output command to retrieve important information about the deployment. The output includes the bastion IP (public IP) and the tidb_bastion_keypair_private_key, which is the SSH key.
terraform output -json | jq -r .tidb_bastion_keypair_private_key.value > ~/.ssh/tidb-test-azure-bastion
chmod 600 ~/.ssh/tidb-test-azure-bastion
terraform output -json | jq -r .tidb_database_keypair_private_key.value > ~/.ssh/tidb-test-azure-db
chmod 600 ~/.ssh/tidb-test-azure-db
To access the bastion host, use the following command, replacing $bastion_public_ip with the actual IP:
eval `ssh-agent`
ssh-add ~/.ssh/tidb-test-azure-bastion
ssh-add ~/.ssh/tidb-test-azure-db
ssh -A azureuser@$bastion_public_ip
curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
source /home/azureuser/.bash_profile
tiup --version
tiup cluster check tiup-topology.yaml
tiup cluster check tiup-topology.yaml --apply
tiup cluster deploy <cluster-name> <version> tiup-topology.yaml
tiup cluster start test-tidb --init
Once connected to the bastion host, you can use the tiup cluster subcommand to deploy the cluster components.
With Terraform and Azure, you can easily deploy a TiDB cluster and manage the resources as needed. This repository provides a starting point for deploying a TiDB cluster on Azure, but you can customize the code to fit your specific requirements.