https://github.com/rackerlabs/understack
Bare stack of OpenStack Ironic based environment to enable deployment of Genestack hardware
https://github.com/rackerlabs/understack
Last synced: 4 months ago
JSON representation
Bare stack of OpenStack Ironic based environment to enable deployment of Genestack hardware
- Host: GitHub
- URL: https://github.com/rackerlabs/understack
- Owner: rackerlabs
- License: apache-2.0
- Created: 2024-02-01T16:20:22.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-25T17:29:15.000Z (4 months ago)
- Last Synced: 2026-03-25T17:55:10.235Z (4 months ago)
- Language: Python
- Homepage: https://rackerlabs.github.io/understack/
- Size: 11.4 MB
- Stars: 12
- Watchers: 25
- Forks: 9
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UnderStack
An opinionated installation of OpenStack and related services to
be able to provision bare metal hardware to be consumable by
[genestack](https://github.com/rackerlabs/genestack) for the
full OpenStack suite.
The requirements are a Kubernetes cluster, which
this repo will contain information about building different
clusters and then a pile of bare metal systems that can
be ingested into the stack to be available to be consumed
via OpenStack Ironic.
## Basic Deploy
You will need a k8s cluster with PV provider (host path provisioner works).
### Prereqs
You must have the following installed:
- `yq`
- `kustomize` (5.x versions)
- `helm` (3.8 or newer)
- `kubeseal`
Alternatively, if you don't have those dependencies you can use the dedicated
development environment including those tools by launching `nix-shell` in the
project directory. If you don't have `nix-shell` on your machine, it can be
[downloaded here](https://nixos.org/download.html).
### Install
Follow the [GitOps Install
Guide](https://rackerlabs.github.io/understack/deploy-guide/gitops-install/)
which walks through creating a configuration and bootstrapping UnderStack.