# Terraform Provider

Follow these steps to create a Kubernetes cluster using the Platform9 terraform provider.

### What you’ll need

* General understanding of [Terraform](https://learn.hashicorp.com/terraform)
* Access to the inbox of a valid email address
* AWS account that meets the [AWS Native Clusters](https://docs.platform9.com/managed-kubernetes/clusters/aws-native-clusters)

## Log in to your Platform9 Account

Log in to your Platform9 account. Once you sign in you’ll be directed to your account's dashboard. This is a summary of all Kubernetes clusters, nodes, pods, and cloud accounts associated with your Platform9 account. If this is a brand new account, there may not be anything associated… yet!

<figure><img src="https://content.gitbook.com/content/dN3UKqOJY9TdzQV1eEIf/blobs/V7Jj0Ex1xXHj3v4J2TGK/bf1w8d93y735vd25z2gwg9bzynsnyowscb1p8jp2735mgoivyqk2s91uurei335m.png" alt="Platform9 – UI - Dashboard"><figcaption><p>Platform9 – UI - Dashboard</p></figcaption></figure>

{% hint style="success" %}
**Logged In**
{% endhint %}

## Create a terraform file

Create a file named `p9-simple-cluster.tf` and paste the below contents within that file.

{% tabs %}
{% tab title="JSON" %}

```json
locals {
  p9_tenant_uuid            = ""
  aws_account_key           = ""
  aws_account_secret        = ""
  aws_keypair_name          = ""
  tags                      = {
    source: "terraform/platform9/pf9"
    provider_version: "0.1.6"
  }
}

terraform {
  required_providers {
    pf9 = {
      source = "platform9/pf9"
      version = "0.1.6"
    }
  }
}

provider "pf9" {}

resource "pf9_aws_cloud_provider" "My-AWS-Provider" {
    name                = "My-AWS-Provider"
    type                = "aws"
    key                 = local.aws_account_key
    secret              = local.aws_account_secret
    project_uuid        = local.p9_tenant_uuid
}

resource "pf9_cluster" "simple-aws-cluster" {
  /*P9 Account Values*/
  project_uuid        = local.p9_tenant_uuid
  cloud_provider_uuid = ""

  /*Cluster Config Values*/
  name                = "simple-aws-cluster"
  containers_cidr     = "10.20.0.0/16"
  services_cidr       = "10.21.0.0/16"
  num_masters         = 1
  num_workers         = 1
  
  /*AWS Specific Values*/
  ami                 = "ubuntu"
  azs                 = ["us-east-1b"]
  region              = "us-east-1"
  worker_flavor       = "t2.medium"
  master_flavor       = "t2.medium"
  ssh_key             = local.aws_keypair_name
  tags                = local.tags
}
```

{% endtab %}
{% endtabs %}

In the “locals” area of the file fill in the relevant information:

|                      |                                                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| p9\_tenant\_uuid     | Your Platform9 project UUID. Learn how to find this value, [here](https://platform9.com/docs/kubernetes/introduction-to-platform9-uuid#tenants--project-uuid). |
| aws\_account\_key    | Your AWS account info.                                                                                                                                         |
| aws\_account\_secret | Your AWS account secret.                                                                                                                                       |
| aws\_keypair\_name   | The name of a saved AWS keypair.                                                                                                                               |

Save the file and note its path

## Create cloud provider and cluster using Terraform

Navigate to the directory where you saved the tf file, in your terminal

Run the following command using the terraform cli

{% tabs %}
{% tab title="Bash" %}

```bash
terraform init
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Info**

Terraform will find the .tf file and initialize the directory for management of the provider.
{% endhint %}

Once initialized, start the Terraform pf9 provider with the following command

{% tabs %}
{% tab title="Bash" %}

```bash
terraform apply
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Info**

Terraform will run through validations of your values and begin creating the cloud provider and then the cluster.
{% endhint %}

To follow the progress of your cluster creation go back to the Platform9 dashboard and navigate to “Infrastructure”, and then “Node Health”. Initially, the screen will be:

<figure><img src="https://content.gitbook.com/content/dN3UKqOJY9TdzQV1eEIf/blobs/U7YtXBfY6yq2xmw1PBGm/hnl3ujz3gifdncnfeevqe1f2je7wefg3kszfg0n0kj7hppg5st7yhg8gcin44ypb.png" alt=""><figcaption></figcaption></figure>

As the deployment progresses, the screen will update with steps completed and a final message of "Connected" and "Healthy".

<figure><img src="https://content.gitbook.com/content/dN3UKqOJY9TdzQV1eEIf/blobs/5OPQdGyETZ6hTTVOD84Y/x4o3ybzd2p9fg02e0hkvbu6c3li16truj0o662lgmr3t83lklise40yfpvqlgffa.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/dN3UKqOJY9TdzQV1eEIf/blobs/CJMomat51d9P7Nvfw8BK/ab77b9je3r3mmcnarcjza1n7o422s5v5122e5d3180g6geifvik9q5qi18ltefia.png" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Cluster Created**

Navigate back to your dashboard to see a summary of the new management plane.
{% endhint %}

## Removing the new cluster using Terraform

1. Using your terminal run the following command:

{% tabs %}
{% tab title="Bash" %}

```bash
terraform destroy
```

{% endtab %}
{% endtabs %}

This will remove the cluster completely.