tec3/ublue-forge
tec3/ublue-forge
1
0
Fork 0
mirror of https://github.com/ublue-os/forge.git synced 2025-04-09 16:23:44 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity
On-premises Universal Blue https://universal-blue.org
39 commits 7 branches 3 tags 5.9 MiB
Python 58.9%
Shell 35.2%
Dockerfile 5.9%
Find a file
Stephan Lüscher 9ac50c787e
refactor(devcontainer): new devcontainer specification based on debian 
with debian based container features such as poetry, black etc.
can be more easily integrated
2024-04-26 21:29:40 +00:00
.devcontainer refactor(devcontainer): new devcontainer specification based on debian 2024-04-26 21:29:40 +00:00
.github refactor(devcontainer): new devcontainer specification based on debian 2024-04-26 21:29:40 +00:00
.vscode refactor(devcontainer): new devcontainer specification based on debian 2024-04-26 21:29:40 +00:00
minica style: new line at end of file 2023-05-04 18:56:06 +00:00
registry feat: add container registry and mini ca (#3,#4) 2023-04-27 17:20:18 +00:00
rvproxy feat: create ssh key for automation tasks 2023-05-04 15:02:05 +00:00
semaphore feat: add semaphore to the stack (#10) 2023-04-29 19:28:08 +00:00
setup feat: configure host system (#12) 2023-05-05 21:23:16 +00:00
.gitignore chore: ignore locally installed ansible collections 2023-05-01 16:15:40 +00:00
.gitmessage chore(devcontainer): init 2023-04-27 06:10:08 +00:00
.markdownlint.yml refactor(devcontainer): new devcontainer specification based on debian 2024-04-26 21:29:40 +00:00
.prettierignore chore(devcontainer): init 2023-04-27 06:10:08 +00:00
.prettierrc.yml refactor(devcontainer): new devcontainer specification based on debian 2024-04-26 21:29:40 +00:00
forge-pod.yml feat: configure host system (#12) 2023-05-05 21:23:16 +00:00
forge.sh feat: check installation pre-requisites (#14) 2023-05-06 17:03:12 +00:00
LICENSE Initial commit 2023-04-26 16:58:51 -04:00
README.md feat: manage forge with one command (#14) 2023-05-04 17:05:33 +00:00

README.md

forge

On-premises Universal Blue

This repo is intended to provide the service units necessary to set up a self-hosted OS forge for custom images.

Warning

This project is "work in progress" and not ready for production

Vision

Imagine something like a home lab or a university lab:

  1. Deploy forge
  2. Go into the WebUI, clone in your favorite uBlue repo and make changes
  3. Forge automatically starts to build the images
  4. PXE boot the clients, select ublue in the menu
  5. Eat tacos
  6. Return to a fully deployed lab with centralized package management

What we have so far

We are still working on making the vision a reality. The following has been implemented so far:

Certificate Authority

We use a Minica as simple CA to generate a key pair and a root certificate for *.ublue.local. The wildcard certificate is then made available to all other components and are valid for 2 years and 30 days.

Reverse Proxy

As an entry point for all components we use Caddy as a reverse proxy. Based on URL routing it will redirect the traffic to the right container instance.

Container Registry

As container registry we make use of the Docker Registry 2.0 implementation for storing and distributing container images

The container registry is available at registry.ublue.local

WebUI

As a WebUI we use Ansible Semaphore.

The WebUI is available at forge.ublue.local

You can use the the user ublue and password ublue to login.

Warning

At the moment there's only a dummy project included. Tasks for real life usage will be included soon.

Handling the forge

You can use the forge.sh to setup, heat-up and cool-down the forge.

Command Description
./forge.sh setup Setup the forge for the first time or update
./forge.sh heat-up Start the forge
./forge.sh cool-down Stop the forge