## Prerequisites
Download and install [Terraform](https://www.terraform.io/downloads.html).
Verify the installation using the `terraform` command.
```sh
$ terraform
```
You should see output similar to the following.
```output
Usage: terraform [--version] [--help] [args]
...
Common commands:
apply Builds or changes infrastructure
console Interactive console for Terraform interpolations
destroy Destroy Terraform-managed infrastructure
env Workspace management
fmt Rewrites config files to canonical format
```
## Set the Azure credentials
Export the required credentials in your current shell using the following commands:
```sh
echo "Setting environment variables for Terraform"
export ARM_SUBSCRIPTION_ID="your_subscription_id"
export ARM_CLIENT_ID="your_appId"
export ARM_CLIENT_SECRET="your_password"
export ARM_TENANT_ID="your_tenant_id"
```
For instructions on installing Terraform and configuring it for Azure, see [Quickstart: Configure Terraform in Azure Cloud Shell with Bash](https://docs.microsoft.com/en-gb/azure/virtual-machines/linux/terraform-install-configure).
## Create a Terraform configuration file
Create a Terraform configuration file named `yugabyte-db-config.tf` and add the following details to it. The Terraform module can be found in the [terraform-azure-yugabyte](https://github.com/yugabyte/terraform-azure-yugabyte) GitHub repository.
```terraform
module "yugabyte-db-cluster"
{
# The source module used for creating clusters on Azure.
source = "github.com/Yugabyte/terraform-azure-yugabyte"
# The name of the cluster to be created, change as per need.
cluster_name = "test-cluster"
# key pair.
ssh_private_key = "PATH_TO_SSH_PRIVATE_KEY_FILE"
ssh_public_key = "PATH_TO_SSH_PUBLIC_KEY_FILE"
ssh_user = "SSH_USER_NAME"
# The region name where the nodes should be spawned.
region_name = "YOUR VPC REGION"
# The name of resource group in which all Azure resource will be created.
resource_group = "test-yugabyte"
# Replication factor.
replication_factor = "3"
# The number of nodes in the cluster, this cannot be lower than the replication factor.
node_count = "3"
}
output "outputs"
{
value = module.yugabyte-db-cluster
}
```
## Create a cluster
Initialize terraform first, if you have not already done so.
```sh
$ terraform init
```
Now, run the following to create the instances and bring up the cluster.
```sh
$ terraform apply
```
After the cluster is created, you can go to the URL `http://:7000` to view the UI. You can find the node's public IP address by running the following:
```sh
$ terraform state show module.yugabyte-db-cluster.azurerm_public_ip.YugaByte_Public_IP[0]
```
You can access the cluster UI by going to public IP address of any of the instances at port `7000`. The IP address can be viewed by replacing `0` in the preceding command with the desired index.
You can check the state of the nodes at any point by running the following command:
```sh
$ terraform show
```
## Verify resources created
The following resources are created by this module:
- `module.azure-yugabyte.azurerm_virtual_machine.Yugabyte-Node`
The Azure VM instances.
For a cluster named `test-cluster`, the instances are named `yugabyte-test-cluster-node-1`, `yugabyte-test-cluster-node-2`, and `yugabyte-test-cluster-node-3`.
- `module.azure-yugabyte.azurerm_network_security_group.Yugabyte-SG`
The security group that allows the various clients to access the YugabyteDB cluster.
For a cluster named `test-cluster`, this security group is named `yugabyte-test-cluster-SG`, with the ports 7000, 9000, 9042, 7100, 9200, and 6379 open to all other instances in the same security group.
- `module.azure-yugabyte.null_resource.create_yugabyte_universe`
A local script that configures the newly created instances to form a new YugabyteDB universe.
- `module.azure-yugabyte.azurerm_network_interface.Yugabyte-NIC`
The Azure network interface for VM instance.
For a cluster named `test-cluster`, the network interface is named `yugabyte-test-cluster-NIC-1`, `yugabyte-test-cluster-NIC-2`, and `yugabyte-test-cluster-NIC-3`.
## Destroy the cluster [optional]
To destroy what you just created, you can run the following command:
```sh
$ terraform destroy
```