Kubernetes on Oracle Cloud Infrastructure

Deploy a Kubernetes cluster on OCI Free Tier using Terraform & Ansible

Table of Contents

1. Installation
2. Usage
3. Troubleshooting
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

Getting Started

The following must already be present on your system

• Terraform CLI
• Ansible
• Kubectl
• OCI config file

Usage

1. Clone this repository

   git clone https://github.com/solamarpreet/kubernetes-on-oci.git

   cd kubernetes-on-oci/terraform

2. Change the values in terraform.tfvars as per your account & region

   nano terraform.tfvars

3. Rename secret.tfvars.example to secret.tfvars and populate it with values

   mv secret.tfvars.example secret.tfvars

4. Initialize terraform

   terraform init

5. Apply terraform configuration

   terraform apply --var-file=secret.tfvars

6. Install either Microk8s or K3s on the created infrastructure depending on your preference

   cd ../ansible

   # Recommended
   ansible-playbook playbooks/microk8s.yml

   or

   ansible-playbook playbooks/k3s.yml

7. Copy the kubeconfig file to ~/.kube/config

   mkdir ~/.kube && cp kubeconfig ~/.kube/config

8. Start using kubectl commands

   kubectl get nodes

(back to top)

Troubleshooting

Check the open issues for a list known issues and open a new issue if necessary.

Roadmap

• Add Ansible playbook for provisioning a private container registry on the VM.Standard.E2.1.Micro instance

Contributing

Please create pull requests in the dev branch. You can also give your ideas by opening a new issue and describing the features you would like to see added.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Amarpreet Singh - solamarpreet@protonmail.com

Blog & Portfolio : https://solamarpreet.github.io

Acknowledgments

• Dennis Pfisterer
• Python Discord

(back to top)