Kubernetes cluster

Requirements

• working Azure subscription and tenant (with admin access)
• azure-cli
• terraform

  If using Windows, Terraform must be accessible from PATH

How to

• configure azure-cli
  • az login
  • select the subscription
  • az account show
• clone current repo

  git clone https://github.com/Cosmo-Tech/terraform-azure.git --branch <tag>
  cd terraform-azure
  

• deploy
  • fill terraform-cluster/terraform.tfvars variables according to your needs

    ✏️ you can change default Kubernetes nodes configuration from terraform-cluster/terraform.auto.tfvars

  • run pre-configured script
    • plan

      get an execution plan to preview the changes without applying

      • Linux

        ./_run-terraform.sh
        

      • Windows

        ./_run-terraform.ps1
        

    • apply

      executes the operations proposed in the plan

      • Linux

        ./_run-terraform.sh --apply
        

      • Windows

        ./_run-terraform.ps1 --apply
        

Known errors

• Error: Get "http://localhost/api/v1/persistentvolumes/pv-name": dial tcp 127.0.0.1:80: connect: connection refused

  If the cluster has been deleted, check the state file has also been deleted. If not, delete it.

Developpers

• modules
  • terraform-state-storage
    • standalone module intended to facilitate creation of a Storage Account (that will be used to store states of others modules)
    • state of this module itselft will not be saved, once created it should never be changed
    • manually create a Storage Account called csmstates<id> will have the same effect
  • terraform-cluster
    • cluster = Kubernetes cluster
    • dns = pre-configure DNS zones that will be required in next deployments
    • network = network management
    • nodes = Kubernetes cluster nodes
    • rbac = access management
    • storage = persistent storage for Kubernetes statefulsets (this module is not used directly here, it's always used in remote modules through its Github URL)

Made with ❤️ by Cosmo Tech DevOps team