https://github.com/yaroze/oci-k8s

Simple OpenTofu/Terraform to deploy a Kubernetes cluster on Oracle Cloud Infrastructure as well as some useful tools
https://github.com/yaroze/oci-k8s

example kubernetes kubernetes-deployment opentofu oracle-cloud terraform

Last synced: 2 months ago
JSON representation

Simple OpenTofu/Terraform to deploy a Kubernetes cluster on Oracle Cloud Infrastructure as well as some useful tools

• Host: GitHub
• URL: https://github.com/yaroze/oci-k8s
• Owner: yaroze
• License: gpl-2.0
• Created: 2025-02-10T16:04:10.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-29T02:33:06.000Z (about 1 year ago)
• Last Synced: 2025-05-15T03:11:26.708Z (about 1 year ago)
• Topics: example, kubernetes, kubernetes-deployment, opentofu, oracle-cloud, terraform
• Language: HCL
• Homepage:
• Size: 108 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# OCI Kubernetes Infrastructure

[![CI Status](https://codeberg.org/yaroze/oci-k8s/actions/workflows/tofu-tests.yaml/badge.svg)](https://codeberg.org/yaroze/oci-k8s/actions?workflow=tofu-tests.yaml)

A comprehensive Terraform/OpenTofu solution for deploying production-ready Kubernetes clusters on Oracle Cloud Infrastructure (OCI) with integrated application bootstrapping and database management via StackGres.

## Architecture Overview

This project provides three modular deployment components:

- **Base Infrastructure**: Core Kubernetes cluster with networking, security, and node pools

- **Bootstrap Applications**: Essential cluster services (ingress, DNS, certificates, monitoring)

- **StackGres Database**: PostgreSQL cluster management with high availability

## Quick Deploy

### Stable (Latest Release)

| Component | Deploy |

|-----------|--------|

| Base Kubernetes Infrastructure | [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/yaroze/oci-k8s/releases/latest/download/base.zip) |

| Bootstrap Applications | [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/yaroze/oci-k8s/releases/latest/download/bootstrap.zip) |

| StackGres Database | [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/yaroze/oci-k8s/releases/latest/download/stackgres.zip) |

### Development (Dev Branch)

| Component | Deploy |

|-----------|--------|

| Base Kubernetes Infrastructure | [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/yaroze/oci-k8s/releases/download/dev/base.zip) |

| Bootstrap Applications | [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/yaroze/oci-k8s/releases/download/dev/bootstrap.zip) |

| StackGres Database | [![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/yaroze/oci-k8s/releases/download/dev/stackgres.zip) |

## Documentation

Comprehensive deployment guides are available in the following series:

- [Part 1: Base Infrastructure Setup](https://medium.com/@plfarinha/automatically-deploying-a-basic-kubernetes-cluster-on-oracle-cloud-for-stackgres-d1ada61c46e2)

- [Part 2: Application Bootstrap](https://medium.com/@plfarinha/deploying-a-basic-kubernetes-cluster-on-oracle-cloud-for-stackgres-part-2-bc6d281cd2bf)

- [Part 3: StackGres Configuration](https://medium.com/@plfarinha/deploying-a-basic-kubernetes-cluster-on-oracle-cloud-for-stackgres-part-3-4d5bda66c48b)

## Prerequisites

- Oracle Cloud Infrastructure account with PAYG (Pay As You Go) subscription

- Appropriate IAM permissions for resource creation

- Basic understanding of Kubernetes and Terraform concepts

## Features

- **Production-Ready**: Secure networking, RBAC, and monitoring included

- **Modular Design**: Deploy components independently based on requirements

- **Cost-Optimized**: Designed to minimize OCI costs while maintaining functionality

- **Automated SSL**: Integrated cert-manager with Let's Encrypt

- **Private Networking**: Secure cluster communication with proper network segmentation

## Support

For questions, issues, or feature requests, please [open an issue](https://github.com/yaroze/oci-k8s/issues) on GitHub.

## Disclaimer

This project is provided as-is for educational and development purposes. While designed with best practices in mind, please review and test thoroughly before using in production environments. The author is not responsible for any costs, data loss, or issues that may arise from using this code.

## License

This project is licensed under the terms specified in the [LICENSE](LICENSE) file.