OCI Compute Provisioning with Terraform + Ansible Automation

This project provisions Oracle Cloud Infrastructure (OCI) compute instances using Terraform, and configures them with Ansible. It provides a reproducible infrastructure-as-code setup for deploying and preparing lightweight OCI hosts, including K3s Kubernetes clusters.

---

What This Project Does

• Creates virtual machines (VMs) on OCI
• Provisions related OCI networking components
• Bootstraps instances using Ansible or cloud-init
• Deploys K3s Kubernetes clusters with master and worker nodes

---

📁 Project Structure

├── ansible
│   ├── playbooks
│   │   ├── deploy-jobwinner.yml
│   │   ├── setup-docker.yml
│   │   └── setup-k3s.yml
│   └── roles
│       ├── common
│       ├── deploy-jobwinner
│       ├── docker
│       └── k3s
├── modules
│   ├── k3s-worker
│   │   ├── cloud-init.sh.tftpl
│   │   ├── main.tf
│   │   ├── output.tf
│   │   ├── README.md
│   │   └── variables.tf
│   ├── lb
│   └── web-server
│       ├── cloud-init.sh.tftpl
│       ├── main.tf
│       ├── output.tf
│       ├── README.md
│       └── variables.tf
├── k3s-master.tf
├── k3s-workers.tf
├── lb-for-k3s.tf
├── job-winner.tf
└── README.md

Prerequisites

• Terraform >= 1.5.0
• Ansible (for master node setup)
• OCI storage bucket to store terraform state

---

How to Use

1. Provision OCI Compute with Terraform

From the project root:

terraform init
terraform apply

2. Configure the Host

• Set up Docker with Ansible
• Set up K3s master node with Ansible
• Deploy K3s worker nodes automatically with cloud-init

---

Current Capabilities

• Terraform module to create OCI compute with public IP
• Automatically configure firewall and SSH access
• Ansible workflow to install Docker and dependencies
• Ansible workflow to install K3s and configure a Kubernetes master node
• Automated K3s worker node deployment using cloud-init
• Dedicated K3s worker module
• Automatic cluster joining without manual intervention
• Cleanly organized roles for reusability

K3s Cluster Setup

Master Node

• Deployed using k3s-master.tf
• Configured with Ansible for full K3s server setup
• Public IP for external access and management

Worker Nodes

• Deployed using k3s-workers.tf
• Use cloud-init for automated setup (no Ansible required)
• No public IPs for enhanced security
• Automatically join the cluster by retrieving node token from master
• Shared network infrastructure with master node

Load Balancer

• Optional load balancer configuration in lb-for-k3s.tf
• Routes traffic to worker nodes for high availability

This setup is ideal for spinning up quick dev/test environments or bootstrap nodes with Docker or Kubernetes, and is easily extendable to other configurations. The K3s workers provide a scalable, secure Kubernetes cluster suitable for production workloads.