https://github.com/dorukgezici/k3s-oci-always-free

A K3s cluster using Oracle Cloud's "always free" resources
https://github.com/dorukgezici/k3s-oci-always-free

cloudflare oracle-cloud-infrastructure tailscale terraform

Last synced: 1 day ago
JSON representation

A K3s cluster using Oracle Cloud's "always free" resources

• Host: GitHub
• URL: https://github.com/dorukgezici/k3s-oci-always-free
• Owner: dorukgezici
• License: mit
• Created: 2024-04-27T16:33:26.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2024-08-10T01:23:26.000Z (3 months ago)
• Last Synced: 2024-08-10T02:33:01.583Z (3 months ago)
• Topics: cloudflare, oracle-cloud-infrastructure, tailscale, terraform
• Language: HCL
• Homepage:
• Size: 43.9 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# k3s-oci-always-free

## Cluster Stack

- [Oracle Cloud Infrastructure](https://cloud.oracle.com/) for compute & network

- [Tailscale](https://tailscale.com/) for mesh VPN

- [Cloudflare](https://cloudflare.com/) for DNS

- [k3s](https://k3s.io/)

- [helm](https://helm.sh/)

- [cert-manager](https://cert-manager.io/)

- [longhorn](https://longhorn.io/)

- [Kubeapps](https://kubeapps.com/)

## Prerequisites

- Oracle Cloud, Tailscale and Cloudflare accounts set up

- Terraform CLI

- kubectl CLI

## Usage

1. Copy `.env.template` to `.env` and fill in the values

2. `source .env` to load env variables into the shell

3. `terraform init` to initialize the modules

4. `terraform import module.tailscale.tailscale_acl.cluster_acl acl` to import your network ACL state

5. `terraform apply` to deploy the cluster (some errors are expected at this stage)

6. Wait for all nodes to be registered in your Tailscale network so that `local.is_ready` becomes true

7. `terraform apply -target module.helm` to first deploy the CRDs via Helm

8. `terraform apply` apply again for DNS to kick in, may still take a while after Cloudflare records are created

- `terraform output fetch_kubeconfig | xargs | sh` to fetch kubectl config to `kubeconfig` file

- `terraform output merge_kubeconfig | xargs | sh` to merge `kubeconfig` file with local `~/.kube/config`

- (Caution) Overwrite your local `~/.kube/config` file with `kubeconfig-merged` file's contents after checking it

## Troubleshooting

### Error: 500-InternalError, Out of host capacity.

- You are out of luck, try again later to see if any free instances are available on Oracle Cloud.

### no matches for kind "ClusterIssuer" in group "cert-manager.io"

- Apply the helm module first for the CRDs to be created.

- `terraform apply -target module.helm`

### Tailscale

- Un/comment `cluster_acl` in `tailscale/main.tf` depending on if you want to manage your Tailscale network ACL

- `terraform import module.tailscale.tailscale_acl.cluster_acl acl` to import your network ACL state before applying