Skip to content

What is UnderStack?

UnderStack is a collection of open-source tools and technologies that provides flexible, scalable, and cost-effective infrastructure management solution. The focus is on deploying bare metal in data centers with functional DCIM and IPAM.

About the Guide

While the deployment of UnderStack leans heavily into GitOps, it is not meant to be a definitive guide to GitOps. It is also not the only way GitOps can be used with UnderStack but instead focuses on one example deployment installation. It will make a few assumptions and some opinionated choices that may not align with a production best practices installation. Improvements are always welcome.

System Division

A fully deployed UnderStack is divided into three distinct parts, or tiers, that are referred to in the documentation as:

  • Management
  • Global
  • Region(s)

A fully functioning system only needs one Management tier, one Global tier and one or more Region tier(s). In this configuration, the Management tier is responsible for utilizing our GitOps tool, ArgoCD to deploy the expected state to all other tier. While the Global tier is responsible for hosting any services that are expected to exist only once for a whole system deployment such as the DCIM/IPAM tool. While the Region tiers will run the tools and services that need to live close to the actual hardware.

In fact, one Management tier can control multiple Global tiers and their associated Region tiers. We call the grouping of the Global tier and it's associated Region tiers a partition. An example would be a staging partition and a production partition.