Inventory Overview

Ctrlplane’s inventory system provides a centralized view of all your infrastructure resources with custom relationships and dynamic grouping.

What is the Inventory?

The inventory is a real-time database of your deployment targets — Kubernetes clusters, cloud functions, VMs, databases, or any custom infrastructure. It enables:

Unified visibility across providers (AWS, GCP, Kubernetes, custom)
Dynamic environments that automatically include matching resources
Custom relationships to model dependencies and ownership
Rich metadata for filtering, grouping, and automation

Core Concepts

Resources

Deployment targets with metadata and configuration

Environments

Dynamic groups of resources using selectors

Relationships

Model dependencies between resources

Selectors

Query language for matching resources

Resource Providers

Sync infrastructure into the inventory

How It Works

1. Resources are Synced

Resources are synced into Ctrlplane via resource providers or API:

type: Resource
name: production-cluster-us-east
kind: KubernetesCluster
identifier: k8s-prod-useast1
metadata:
  environment: production
  region: us-east-1
  team: platform
config:
  server: https://k8s.example.com
  namespace: default

2. Environments Match Resources

Environments use selectors to dynamically include resources:

type: Environment
name: Production US-East
resourceSelector: |
  resource.metadata["environment"] == "production" &&
  resource.metadata["region"] == "us-east-1"

When new resources are added that match the selector, they’re automatically included in the environment.

3. Deployments Target Environments

Deployments create release targets for each resource in each environment:

Deployment × Environment × Resource = Release Target

Key Benefits

Benefit	Description
Single source of truth	All resources visible in one place
Dynamic targeting	Environments auto-update as infrastructure changes
Rich metadata	Filter and group by any attribute
Cross-provider	Kubernetes, cloud, and custom in one view

Next Steps

Resources — Understand resource structure and lifecycle
Relationships — Model dependencies between resources
Environments — Create dynamic resource groups
Selectors — Write powerful resource queries
Resource Providers — Sync your infrastructure

Relationships

​What is the Inventory?

​Core Concepts

Resources

Environments

Relationships

Selectors

Resource Providers

​How It Works

​1. Resources are Synced

​2. Environments Match Resources

​3. Deployments Target Environments

​Key Benefits

​Next Steps

What is the Inventory?

Core Concepts

How It Works

1. Resources are Synced

2. Environments Match Resources

3. Deployments Target Environments

Key Benefits

Next Steps