Core Workflows

Core workflows are the essential processes that power the Blueberry IDP. These workflows handle the fundamental operations of creating, managing, and destroying environments.

Categories

Environment Lifecycle

Workflows for managing the complete lifecycle of environments from creation to deletion.

  • Create Environment - Provision new ephemeral environments
  • Update Environment - Modify existing environment configurations
  • Delete Environment - Clean up and remove environments
  • Environment Health Checks - Monitor and validate environment status
  • TTL Management - Handle environment expiration and auto-cleanup

Configuration Management

Workflows for managing configuration sets, overrides, and validation.

  • Create Config Set - Define reusable configuration templates
  • Update Config Set - Modify existing configuration sets
  • Apply Overrides - Handle user-specific configuration overrides
  • Validate Configuration - Check configuration against constraints
  • Configuration Drift Detection - Identify configuration changes

Resource Provisioning

Workflows for provisioning and managing infrastructure resources.

  • Kubernetes Resources - Deploy pods, services, and ingresses
  • Cloud Resources - Provision GCP resources via Crossplane
  • Storage Setup - Configure persistent volumes and buckets
  • Network Configuration - Set up ingress, DNS, and certificates
  • Service Dependencies - Manage Redis, databases, and other services

Key Concepts

GitOps Approach

All core workflows follow GitOps principles:
- Declarative configuration in Git
- ArgoCD for continuous deployment
- No direct kubectl commands
- Automated sync and reconciliation

State Management

Core workflows maintain state through:
- Firestore for metadata storage
- Kubernetes CRDs for resource state
- ArgoCD Applications for deployment state
- Git as source of truth

Error Handling

All core workflows implement:
- Comprehensive validation
- Graceful error recovery
- Rollback capabilities
- Detailed audit logging

Document ID: workflows/core/README