Self-Hosted Configuration

Configure and tune Bluebricks Deployment Controller (BDC) for self-hosted orchestration.

For the complete Helm chart values reference, see the BDC Helm Chart documentation. For registration and authentication setup, see Registration and Authentication.

Prerequisites

• Kubernetes cluster (version 1.28+)

• Helm 3.8 or later

• Access to Bluebricks API

• Collection token for registration

Quick Install

# Add Helm repository
helm repo add bbx-helm-repo https://storage.googleapis.com/bluebricks-helm-public
helm repo update

# Install BDC
helm install bdc bbx-helm-repo/bluebricks-deployments-controller \
  --set orchestrator.secret.value=YOUR_COLLECTION_TOKEN \
  --namespace bluebricks \
  --create-namespace

# Verify
kubectl get pods -n bluebricks

Key Configuration Options

Parallel Workers

Control concurrent deployment execution:

command:
  args:
    - "start"
    - "operator"
    - "--controllers=tasks"
    - "--max-concurrent-reconciles"
    - "4"  # default: 3

Runner Resources

bricksRunner:
  cm:
    resources:
      requests:
        cpu: "500m"
        memory: "1024Mi"
      limits:
        cpu: "1000m"
        memory: "2048Mi"

Storage

bbxStorageManager:
  storage:
    size: "30Gi"  # 10Gi min, 100Gi+ for high-volume

Sizing Guidelines

Cluster size	Workers	Runner memory	Storage
Small (< 10 nodes)	2-3	1024Mi	10Gi
Medium (10-50 nodes)	4-8	1024Mi	30Gi
Large (50+ nodes)	8-16	2048Mi	100Gi+

Upgrading

helm upgrade bdc bbx-helm-repo/bluebricks-deployments-controller \
  -f values.yaml -n bluebricks

Common Issues

Symptom	Cause	Fix
Jobs OOMKilled	Insufficient memory	Increase bricksRunner.cm.resources.limits.memory
Tasks stuck in pending	Slow polling	Reduce orchestrator.resyncPeriod (default: 5s)
Auth errors in logs	API rate limiting	Increase orchestrator.resyncPeriod
Storage errors	PVC full	Increase bbxStorageManager.storage.size

See also

• BDC Helm Chart -- complete values reference

• Registration and Authentication -- token setup

• Self-Hosted Runner overview -- architecture and concepts

• BDC Helm repository -- public Helm chart source