This project uses Terraform to create a Kubernetes cluster on the Oracle Cloud Infrastructure (OCI) Free Tier resources. The cluster consists of 4 nodes: one control plane and three worker nodes. Each node uses the Arm-based Ampere A1 core and 6 GM of memory.
Note: This project is not intended to be used in production environments.
Before running this project, you must have the following:
- An OCI account with Free Tier resources available
- Terraform installed on your local machine
- OCI CLI installed on your local machine
- SSH key pair generated on your local machine
To help get started quickly with this Terraform module, I have included an example configuration in the example folder. This example demonstrates how to use the module to provision a sample infrastructure that showcases its functionality.
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| fingerprint | The fingerprint of the private_key, e.g. 8c:bf:17:7b:5f:e0:7d:13:75:11:d6:39:0d:e2:84:74. | string |
n/a | yes |
| private_key | The private key retrieved from the Oracle account. | string |
n/a | yes |
| region | The desired region of the cluster, e.g. us-phoenix-1. | string |
n/a | yes |
| ssh_private_key | The private key used for SSH to the instances. | string |
n/a | yes |
| ssh_public_key | The public key used for SSH to the instances. | string |
n/a | yes |
| tenancy_ocid | The OCID of the tenany, e.g. ocid1.tenancy.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa. | string |
n/a | yes |
| user_ocid | The OCID of the user, e.g. ocid1.user.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa. | string |
n/a | yes |
| availability_domain | The availability domain in which the instance should be created, e.g Uocm:PHX-AD-1. | string |
null |
no |
| instance_count | Number of instances which should be created. | number |
4 |
no |
| instance_memory | Amount of memory available to the instance, in gigabytes. | number |
6 |
no |
| instance_ocpus | Number of OCPUs available to the instance. | number |
1 |
no |
| instance_os | Operating system for compute instances. | string |
"Canonical Ubuntu" |
no |
| instance_shape | Shape of the instances. | string |
"VM.Standard.A1.Flex" |
no |
| linux_os_version | Operating system version for all Linux instances. | string |
"22.04" |
no |
| name | Name will be used for compartment and kubeconfig. | string |
"terraform-oci-free-tier-kubernetes" |
no |
| Name | Description |
|---|---|
| all_availability_domains | All availaility domains. |
| available_images | Available images. |
| client_certificate | Kubernetes Client Certificate |
| client_key | Kubernetes Client Key |
| cluster_ca_certificate | Kubernetes Cluster CA Certificate |
| compartment_id | ID of the compartment. |
| compartment_name | Name of the compartment. |
| instance_OCPUs | CPUs of the instances. |
| instance_memory_in_GBs | Memory in GB of the instances. |
| instance_name | Names of the instances. |
| instance_ocid | OCID of the instances. |
| instance_region | Region of the instances. |
| instance_shape | Shape of the instances. |
| instance_state | State of the instances. |
| kubeconfig | Kubeconfig to access the cluster |
| kubeconfig_commands | Kubeconfig commands to apply to local kubeconfig |
| public_ip_for_compute_instance | Public IPs of the instances. |
| time_created | Creation time of the instances |
| vcn_id_route_id | ID of the route. |
| vcn_nat_gateway_id | ID of the NAT gateway. |
| vcn_nat_route_id | ID of the NAT route. |
| vcp_id | ID of the VCN. |
This project is released under the Apache License 2.0. For more information, see the LICENSE file.