IBM Clusters Terraform Module
This is a collection of modules that make it easier to provision a cluster on IBM Cloud Platform:
- classic-kubernetes-multi-zone-cluster
- classic-kubernetes-single-zone-cluster
- classic-openshift-multi-zone-cluster
- classic-openshift-single-zone-cluster
- vpc-kubernetes-cluster
- vpc-openshift-cluster
- classic-free-cluster
And it also has the following modules to configure a already provisioned cluster in IBM Cloud Platform:
Compatibility
This module is meant for use with Terraform 0.12. If you haven't [upgraded][terraform-0.12-upgrade] and need a Terraform 0.11.x-compatible version of this module, the last released version intended for Terraform 0.11.x is [1.1.1][v1.1.1].
Usage
Full examples are in the examples folder, but basic usage is as follows for creation of classic cluster with single zone:
provider "ibm" {
}
data "ibm_resource_group" "test" {
name = var.resource_group
}
module "classic_kubernetes_single_zone_cluster" {
source = "terraform-ibm-modules/cluster/ibm//modules/classic-kubernetes-single-zone"
cluster_name = var.cluster_name
worker_zone = var.worker_zone
hardware = var.hardware
resource_group_id = data.ibm_resource_group.test.id
worker_nodes_per_zone = (var.worker_nodes_per_zone != null ? var.worker_nodes_per_zone : 1)
worker_pool_flavor = var.worker_pool_flavor != null ? var.worker_pool_flavor : null
public_vlan = (var.public_vlan_id != null ? var.public_vlan_id : null)
private_vlan = (var.private_vlan_id != null ? var.private_vlan_id : null)
master_service_public_endpoint = (var.master_service_public_endpoint != null ? var.master_service_public_endpoint : null)
master_service_private_endpoint = (var.master_service_private_endpoint != null ? var.master_service_private_endpoint : null)
force_delete_storage = (var.force_delete_storage != null ? var.force_delete_storage : false)
gateway_enabled = (var.gateway_enabled != null ? var.gateway_enabled : false)
encrypt_local_disk = (var.encrypt_local_disk != null ? var.encrypt_local_disk : true)
no_subnet = (var.no_subnet != null ? var.no_subnet : false)
subnet_id = var.subnet_id != null ? var.subnet_id : []
update_all_workers = (var.update_all_workers != null ? var.update_all_workers : false)
tags = (var.tags != null ? var.tags : [])
kube_version = (var.kube_version != null ? var.kube_version : null)
kms_config = var.kms_config != null ? var.kms_config :[]
workers_info = var.workers_info != null ? var.workers_info : []
webhook = var.webhook != null ? var.webhook : []
}
Creation of vpc openshift cluster:
provider "ibm" {
generation = var.generation
}
data "ibm_resource_group" "test" {
name = var.resource_group
}
module "vpc_openshift_cluster" {
source = "terraform-ibm-modules/cluster/ibm//modules/vpc-openshift"
cluster_name = var.cluster_name
vpc_id = var.vpc_id
worker_pool_flavor = var.worker_pool_flavor
worker_zones = var.worker_zones
worker_nodes_per_zone = (var.worker_nodes_per_zone != null ? var.worker_nodes_per_zone : 1)
resource_group_id = data.ibm_resource_group.test.id
kube_version = (var.kube_version != null ? var.kube_version : null)
update_all_workers = (var.update_all_workers != null ? var.update_all_workers : false)
service_subnet = (var.service_subnet != null ? var.service_subnet : "172.21.0.0/16")
pod_subnet = (var.pod_subnet != null ? var.pod_subnet : "172.30.0.0/16")
worker_labels = (var.worker_labels != null ? var.worker_labels : null)
wait_till = (var.wait_till != null ? var.wait_till : "ingressReady")
disable_public_service_endpoint = (var.disable_public_service_endpoint != null ? var.disable_public_service_endpoint : true)
tags = (var.tags != null ? var.tags : [])
cos_instance_crn = (var.cos_instance_crn != null ? var.cos_instance_crn : null)
force_delete_storage = (var.force_delete_storage != null ? var.force_delete_storage : false)
kms_config = (var.kms_config != null ? var.kms_config : [])
entitlement = (var.entitlement != null ? var.entitlement : null)
}
Requirements
Terraform plugins
Install
Terraform
Be sure you have the correct Terraform version (0.12), you can choose the binary here:
Terraform plugins
Be sure you have the compiled plugins on $HOME/.terraform.d/plugins/
How to input varaible values through a file
To review the plan for the configuration defined (no resources actually provisioned)
terraform plan -var-file=./input.tfvars
To execute and start building the configuration defined in the plan (provisions resources)
terraform apply -var-file=./input.tfvars
To destroy the VPC and all related resources
terraform destroy -var-file=./input.tfvars
All optional parameters by default will be set to null in respective example's varaible.tf file. If user wants to configure any optional paramter he has overwrite the default value.
Note
All optional fields should be given value null
in respective resource varaible.tf file. User can configure the same by overwriting with appropriate values.