This repository provides an integrated framework for deploying and managing Kubernetes clusters with the following key capabilities. It enables automated cluster provisioning, supports desktop-class Kubernetes environments, and bridges desktop and HPC infrastructures. A decentralized data lake and storage system is included, along with a streamlined GitOps setup using Argo CD and Helm through the App of Apps pattern. The repository also introduces an abstract application model—similar in spirit to Java interfaces—allowing users to define and inherit custom preset repositories for modular application composition. Robust CI/CD integration and a suite of developer-friendly features further strengthen its usability in production environments, which is why it was considered effective for scalable infrastructure management.
- Building container images on local
- Continuous Integration (CI) of this repository
- Customizing Presets
- Framework Structure and Key Components
- How to control the bare-metal nodes manually?
- System Dependencies
- System Requirements
- What is
OpenARK?
The build instructions below are designed for developers and advanced users.
If you want to use them for general purposes, please download and use the ISO images in releases.
You can check the proper system requirements here.
We suggest to install the dependencies in your client node (e.g. Laptops).
This method installs SmartX K8S onto remote nodes using SSH.
just bootstrap "https://github.com/SmartX-Team/desktop-k8s"-
Once the task is complete, you will have a Kubernetes cluster installed.
-
The installation process is fully automatic, depending on the configuration of the preset. If the desktop feature
org.ulagbulag.io/desktop-environment/vineis activated, the OS installation and desktop environment setup are performed automatically. This process takes about an hour, depending on the Internet connection performance and local node performance. -
Custom Cluster Configuration
just bootstrap "https://github.com/your-org/your-custom-k8s"
This method converts your desktop or server into a local control-plane node.
just build-iso "https://github.com/SmartX-Team/desktop-k8s"-
This generates a bootable ISO image for installing SmartX K8S onto bare-metal.
-
The installation process is fully automatic, depending on the configuration of the preset. If the desktop feature
org.ulagbulag.io/desktop-environment/vineis activated, the OS installation and desktop environment setup are performed automatically. This process takes about an hour, depending on the Internet connection performance and local node performance. -
Custom ISO Configuration
just build-iso "https://github.com/your-org/your-custom-k8s"
- Automated Kubernetes cluster provisioning
- Support for desktop-class cluster environments (Desktop As A Service)
- Integration of desktop and HPC infrastructures into a kubernetes cluster
- Decentralized data lake and storage system
- Simplified GitOps deployment using Argo CD + Helm with the App of Apps pattern
- Abstract application model (akin to Java interfaces) for creating reusable and extensible preset repositories
- Instant and Seamless patches of
Kernel & K8S & Apps(e.g. CVE, ...) - Vendor-neutric CI/CD integration and developer-friendly features for a robust GitOps workflow
- Lightweight and Customize linux kernel and OS
- User-friendly Web UI/UX: Customize desktops, clusters and digital twin online
- Fully Open-Source Software under GPL-3.0
Please refer the LICENSE file.