oci-k3s
A lightweight K3s cluster sized to start on OCI's Always Free tier, with Traefik ingress, automatic Let's Encrypt HTTPS and a network load balancer. Your own Kubernetes, without a managed-cluster bill.
Product Information
Summary ↑
oci-k3s is the K3s cluster module of the Easier Web catalog — a K3s cluster role plus a public
Network Load Balancer routing HTTP/HTTPS traffic to it, built on top of an existing
oci-aft-base deployment.
You get full Terraform and Ansible source code, a dev container for zero-setup onboarding, and
helper scripts. Together with oci-aft-base, this module gets you a working Kubernetes cluster
reachable over the public internet.
Who it is for:
oci-aft-basecustomers who want Kubernetes without hand-rolling K3s setup, load balancer routing, and NodePort wiring themselves- Teams standardizing on K3s who want the infrastructure-as-code, not a managed Kubernetes service with its own billing and lock-in
- Technical founders who want infrastructure-as-code they fully own (perpetual license, no subscription, your own OCI account) rather than a managed platform
Details ↑
What Is Included
Infrastructure (Terraform)
- Network Load Balancer — public OCI NLB routing
80 → 30080and443 → 30443to the cluster's Traefik NodePorts, with TCP health checks
Server Configuration (Ansible)
- K3s cluster role — installs and configures a K3s cluster on
oci-aft-base's compute instance(s), including the Traefik ingress controller - Cluster teardown playbook — cleanly removes K3s from a node
Scripts and Tooling
- Inventory generator — reads
oci-aft-base's and this module's Terraform state and writes the Ansible inventory automatically; no manual IP tracking - kubectl tunnel — one command to open a local port-forward to the cluster's API server over the OCI bastion
- SSH helper — one command to print the bastion-tunneled SSH command for any node
Dev Container
A pre-built development container (.devcontainer/) with Terraform, Ansible, kubectl, and the OCI
CLI already installed. Clone the repo, open it in VS Code or GitHub Codespaces, and start
deploying — no local toolchain setup required.
Documentation
- Step-by-step deployment guide for the Terraform module and Ansible playbooks
- A documented, versioned dependency on
oci-aft-base's output contract, and this module's own output contract for anything you build on top - Makefile with named targets for every common operation — no need to remember command-line arguments
Pricing and License
One-time purchase, no subscription.
You receive repository access upon purchase, along with a perpetual license to use and modify the Software. There's no subscription and no recurring fees. Your cloud infrastructure runs in your own OCI account using your own credentials — there are no usage fees, no data sent to us, and no per-seat charges.
Your license is perpetual and doesn't depend on continued access: repository access, updates, and the Discussions forum are services we may wind down (Section 12, "Term; Discontinuation of Access and Support", of the Software License Agreement). Keep your own clone of the repository once you have access, and it's yours to use regardless.
Full license terms are available on this product page and must be accepted at checkout.
Community and Support
After purchase you get access to a private GitHub Discussions forum in the repository. Use it to ask questions, share how you've extended the module, or discuss your setup. We participate actively.
Privacy
The software runs entirely within your own cloud account. We have no access to your environment, your data, or your infrastructure. No telemetry, no callbacks, no third-party analytics.
Dependencies ↑
Prerequisites: an existing oci-aft-base deployment (see its output contract for exactly what this
module reads). Basic familiarity with Terraform, Ansible, and Kubernetes is helpful but not
required — the documentation walks through every step.
Tech Stack
| Layer | Technology |
|---|---|
| Cloud provider | Oracle Cloud Infrastructure |
| Kubernetes distribution | K3s |
| Ingress | Traefik (bundled with K3s) |
| Load balancing | OCI Network Load Balancer |
| Infrastructure provisioning | Terraform |
| Server configuration | Ansible |