https://github.com/andrebriggs/azure-tf-k8s
Quick POC of creating AKS via Terrafform
https://github.com/andrebriggs/azure-tf-k8s
Last synced: 4 months ago
JSON representation
Quick POC of creating AKS via Terrafform
- Host: GitHub
- URL: https://github.com/andrebriggs/azure-tf-k8s
- Owner: andrebriggs
- Created: 2018-12-28T20:21:39.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-02-10T07:16:24.000Z (over 6 years ago)
- Last Synced: 2025-03-04T21:42:19.171Z (over 1 year ago)
- Language: HCL
- Size: 8.79 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Setting up AKS (Azure k8s) via Terraform
The instructions assume you have Azure CLI and Terraform. In Azure CLI make sure your you have "set" a subscription.
## Create an Azure service principal
```bash
az ad sp create-for-rbac --role="Contributor" --scopes="/subscriptions/$AZURE_SUBSCRIPTION_ID"
```
Save the output results somewhere.
## Create an Azure resource group
```bash
az group create -l $RESOURCE_GROUP_LOCATION -n $RESOURCE_GROUP_NAME
```
## Create Storage account
Navigate to the k8s directory ```cd k8s```
Run the shell script [setup-az-storage.sh](k8s/setup-az-storage.sh). Replace variables with your own. This file defines an Azure Blob container to store the terraform state.
## Getting started with what's inside the repo
### [variables.tf](k8s/variables.tf)
Adjust the values for each key in [variables.tf](k8s/variables.tf) to your liking.
Please make sure the value fo the ssh_public_key exists. If not please create it by navigating to your ```~/.ssh``` directory and running ```ssh-keygen -o```
### [main.tf](k8s/main.tf)
This file defines the environment landscape you want to declaratively describe. The default file creates a resource group, log analytics, and an AKS cluster. Edit this file to your liking.
### [output.tf](k8s/output.tf)
This file describes the output variables you will see when Terraform applies a [plan](https://www.terraform.io/docs/configuration/outputs.html).
## Set service principal info for Terraform
Run the shell script [set-sp-variables.sh](k8s/set-sp-variables.sh) and replace or set the environment variables with the output from creating the Azure Service Principal
## How deploy with Terraform
Typical Terraform commands are _init_, _plan_, then _apply_
Run the `terraform_init_backend.sh` file to setup your backend.
Then run:
```bash
terraform plan -out out.plan
```
If no errors then run. This may take several minutes to run
```bash
terraform apply out.plan
```
Finally once a successful install has happened run kubbectl to verify the nodes are running. To configure kubctl first run
```bash
echo "$(terraform output kube_config)" > ./azurek8s
```
then
```bash
export KUBECONFIG=./azurek8s
```
The above sets your kube config to this file. Consequently kubctl will only see this context when you run ```kubectl config get-contexts```
Alternatively if using AKS you can set the context to your cluster using the Azure CLI
az aks get-credentials --resource-group RESOURCE_GROUP_NAME_HERE --name CLUSTER_NAME_HERE
Run the following to verify
```bash
kubectl get nodes
```
# How to tear down
Run ```az group delete --name $RESOURCE_GROUP_NAME```