CRD Catalog¶

spec:
  cloud: string              # AWS, GCP, AZURE (auto-detected if not set)
  storageBackend: string     # s3a://, gs://, or abfs://
  s3Endpoint: string         # For S3-compatible storage
  imageRepository: string    # Container registry path
  imagePullSecrets: []string # Private registry secrets
  tolerations: [...]         # Pod tolerations
  nodeSelector: {...}        # Node labels
  serviceAccounts:
    data: string             # For MDS/QS pods
    monitoring: string       # For MonitoringServices pods
  defaultPoolRef: {...}      # Default pool for QueryServices

spec:
  workspace: string      # Required: Workspace name
  tenant: string         # Required: Tenant identifier
  storageBackend: string # Required: s3a://, gs://, or abfs://
  storage:
    imageTag: string     # Required: Storage service version
    resources: {...}     # Required: memory, cpu
  schema:
    imageTag: string     # Required: Schema service version
    resources: {...}     # Required: memory, cpu

spec:
  alias: string          # Required: Cluster alias
  workspace: string      # Required: Must match MetadataServices
  planner: {...}         # Required: Query planner config
  queue: {...}           # Required: Queue/coordinator config
  executor:              # Required: Worker config
    replicas: int
    autoscaling: {...}   # Optional: Enable autoscaling
    poolRef: {...}       # Optional: Reference to Pool

spec:
  xds:
    replicas: int              # xDS control plane replicas (default: 2)
    image: {...}               # Optional: Custom image
    discovery:
      services: []string       # Optional: Auto-registered by operator
  envoy:
    replicas: int              # Envoy proxy replicas (default: 2)
    maxReplicas: int           # Max replicas for HPA
    hpa:
      enabled: bool            # Enable autoscaling
    service:
      type: string             # LoadBalancer, ClusterIP, NodePort

spec:
  domain: string                 # Required: Base domain (e.g., e6data.io)
  replicas: int                  # Pomerium replicas (default: 2)
  authentication:
    enabled: bool                # false = passthrough mode
    idp:
      provider: string           # google, okta, azure, github, oidc
      credentialsSecretRef: {...}
    policy:
      allowedDomains: []string   # Allowed email domains
  services:
    - name: string               # Service route name
      subdomain: string          # e.g., "query" → query.domain.com
      backend:
        serviceName: string      # Backend K8s service
        servicePort: int

spec:
  catalogType: string           # Required: HIVE|GLUE|UNITY|ICEBERG|DELTA
  metadataServicesRef: string   # Required: MetadataServices name
  connectionMetadata:
    catalogConnection:
      hiveConnection: {...}     # For HIVE
      glueConnection: {...}     # For GLUE
      unityConnection: {...}    # For UNITY
      icebergConnection: {...}  # For ICEBERG
      deltaConnection: {...}    # For DELTA

spec:
  e6CatalogRef:
    name: string         # Required: E6Catalog name
  refreshType: string    # Required: full|delta
  databases: []string    # Optional: Specific databases
  timeout: string        # Optional: Default 30m

spec:
  e6CatalogRef:
    name: string              # Required: E6Catalog name
  schedule: string            # Required: Cron expression
  refreshType: string         # Optional: full|delta (default: delta)
  concurrencyPolicy: string   # Optional: Forbid|Allow|Replace
  successfulRefreshHistoryLimit: int  # Optional: Default 3
  failedRefreshHistoryLimit: int      # Optional: Default 1

spec:
  minExecutors: int           # Baseline capacity
  maxExecutors: int           # Required: Maximum capacity
  executorsPerNode: int       # Optional: Default 1
  instanceConfig:
    instanceType: string      # Explicit instance type
    spotEnabled: bool         # Use spot instances
  queryServiceSelector: {...} # Label selector for allowed QS
  # OR
  allowedQueryServices: []    # Explicit allow list

spec:
  catalogName: string         # Required: Target catalog
  policies:
    - name: string            # Policy name
      type: string            # GRANT_ACCESS|COLUMN_MASKING|ROW_FILTERING
      resources: [...]        # Target resources
      users: []string         # Target users
      groups: []string        # Target groups
      allow: bool             # For GRANT_ACCESS
      maskType: string        # For COLUMN_MASKING
      rowFilter: string       # For ROW_FILTERING

spec:
  storage:
    backend: string      # Required: s3|gcs|azure
    bucket: string       # Required: Bucket name
    region: string       # Required: Cloud region
  frontend:
    replicas: int        # Query endpoints
  datanode:
    replicas: int        # Data storage
  meta:
    replicas: int        # Coordination (1 or 3)
  etcd:
    replicas: int        # Metadata (1 or 3)
  grafana:
    enabled: bool        # Optional visualization

spec:
  workspace: string           # Required: Workspace name
  storageBackend: string      # Required: Object storage path
  logs:
    enabled: bool             # Enable pod log collection
    selector: {...}           # Pod selector for log collection
  metrics:
    enabled: bool             # Enable metrics scraping
    selector: {...}           # Pod selector for metrics
  vector:
    image: {...}              # Vector container image
    resources: {...}          # CPU/Memory limits
  sinks:
    s3: {...}                 # S3 sink configuration
    greptimeRef: {...}        # GreptimeDB sink reference

spec:
  version: string            # Required: Semantic version (e.g., "1.2.0")
  product: string            # Required: engine|laminar|copilot|platform
  subType: string            # For engine: metadata|cluster
  description: string        # Human-readable description
  releaseNotes: string       # Changelog
  releaseDate: time          # When released
  deprecated: bool           # Mark as deprecated
  minUpgradeVersion: string  # Minimum version that can upgrade to this
  engine:                    # For engine product
    cluster:                 # QueryService components
      planner: {...}         # Image, resources, config
      queue: {...}
      executor: {...}
    metadata:                # MetadataServices components
      storage: {...}
      schema: {...}
  platform:                  # For platform product
    console: {...}
    apiServer: {...}

image:
  repository: string         # Container registry path
  name: string               # Required: Image name
  tag: string                # Required: Image tag
  digest: string             # Optional: Immutable reference
resources:
  minimum: {cpu, memory}     # Minimum required
  recommended: {cpu, memory} # Optimal performance
  maximum: {cpu, memory}     # Limits
configVariables: {...}       # Default config.properties
environmentVariables: {...}  # Default env vars
affinity: {...}              # Recommended affinity rules
featureFlags: {...}          # Enabled/disabled features
breaking: bool               # Has breaking changes
breakingChanges: []string    # Description of breaking changes