Search documentation
karat

+

K

environments overview

Environments

An Environment in Apollo is a grouping of Entities deployed into the same infrastructure, such as a software platform composed of microservices running in a single Kubernetes cluster. Agents report the current state of Entities back to the Hub, and execute Plans for Entities. Environments are disjoint from each other, such that each Entity belongs to a single Environment.

Hubs are Environments that manage other Environments; such Environments are said to be Spoke Environments of that Hub. Hub Environments usually manage themselves, but this is not a strict requirement. A Hub Environment could be managed by a different Hub, leading to a hierarchy of Hubs and Spokes.

Environments do not need to be managed by a Hub at all times. Such Environments are said to be disconnected during those periods where they are not being actively managed by a Hub. This can happen, for example, for Environments running on vehicles. They might be connected to a Hub for upgrades when stationary, but then become disconnected for a while when on the move.

Environment settings

An Apollo Hub can manage multiple Spoke Environments. The Apollo Hub stores settings for each Spoke Environment, which includes the list of Entities that should exist in that Environment, which Release Channels they are subscribed to, and other Entity or Environment-specific information (e.g. information about maintenance windows).

Environment Config

An Environment has its own top-level configuration called Environment Config, which can be used to store additional arbitrary configuration for the Environment. Environment Config can be used to describe settings that apply to the entire Environment and can be referenced by configuration for individual Entities in that Environment.

Learn more about managing Environments.