https://github.com/khuedoan/horus

Free cloud native platform for service hosting
https://github.com/khuedoan/horus

cloud iaas k3s kubernetes kustomize oci terraform vpn

Last synced: about 1 month ago
JSON representation

Free cloud native platform for service hosting

• Host: GitHub
• URL: https://github.com/khuedoan/horus
• Owner: khuedoan
• License: gpl-3.0
• Created: 2021-08-24T04:20:13.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-12-07T07:53:25.000Z (about 2 months ago)
• Last Synced: 2024-12-07T08:22:00.000Z (about 2 months ago)
• Topics: cloud, iaas, k3s, kubernetes, kustomize, oci, terraform, vpn
• Language: HCL
• Homepage:
• Size: 257 KB
• Stars: 39
• Watchers: 3
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Horus

> [!IMPORTANT]

> This project is designed to manage my offsite setup, which is specific to my

> use cases, so it might not be directly useful to you. For a ready-to-use

> solution, please refer to my [homelab project](https://github.com/khuedoan/homelab).

> The name is from [Horus the Child, or Harpocrates](https://en.wikipedia.org/wiki/Harpocrates)

## Features

### Infrastructure

Oracle Cloud was chosen due to their very generous free tier.

| Provider        | Service                     | Usage             | Pricing                        |

| :--             | :--                         | :--               | :--                            |

| Terraform Cloud | Workspace                   | 1                 | Free                           |

| Oracle Cloud    | Virtual Cloud Network       | 1                 | Free                           |

| Oracle Cloud    | `VM.Standard.A1.Flex` (ARM) | 4 cores, 24GB mem | Free (yes, you read it right!) |

| Oracle Cloud    | Block Storage               | 200GB             | Free                           |

## Get started

### Prerequisites

- Fork this repository because you will need to customize it for your needs.

- A credit/debit card to register for the accounts.

- Basic knowledge on Terraform, Ansible and Kubernetes (optional, but will help a lot)

Configuration files:

Terraform Cloud

- Create a Terraform Cloud account at 

Oracle Cloud

- Create an Oracle Cloud account at 

- Generate an API signing key:

  - Profile menu (User menu icon) -> User Settings -> API Keys -> Add API Key

  - Select Generate API Key Pair, download the private key to `~/.oci/private.pem` and click Add

  - Copy the Configuration File Preview to `~/.oci/config` and change `key_file` to `~/.oci/private.pem`

If you see a warning like this, try to avoid those regions:

> ⚠️ Because of high demand for Arm Ampere A1 Compute capacity in the Foo and Bar regions, A1 instance availability in these regions is limited.

> If you plan to create A1 instances, we recommend choosing another region as your home region

Install the following packages:

- [Nix](https://nixos.org/download.html)

That's it! Run the following command to open the Nix shell:

```sh

nix develop

```

### Provision

Build the infrastructure:

```sh

make

```

## Acknowledgments and References

- [Oracle Terraform Modules](https://github.com/oracle-terraform-modules)

- [Official k3s systemd service file](https://github.com/k3s-io/k3s/blob/master/k3s.service)