Files
ess-helm/scripts/migration/models.py
T
Gaël Goinvic ab0b67674a Migration: Add support for secret discovery
- Each secret can exist either inline or in config
- This discovers secrets and prompt for missing ones
- Secrets are outputed in dedicated files
- Helm Values will refer to the secret data imported in kubernetes
2026-02-20 15:43:03 +01:00

70 lines
2.2 KiB
Python

# Copyright 2026 Element Creations Ltd
#
# SPDX-License-Identifier: AGPL-3.0-only
"""
Data models for the migration script using Python dataclasses.
"""
from collections.abc import Callable
from dataclasses import dataclass, field
from typing import Any
@dataclass
class Secret:
"""Represents a Kubernetes Secret resource."""
name: str # Name of the Kubernetes Secret
data: dict[str, str] # Dictionary of secret key-value pairs (values should be base64 encoded)
namespace: str | None = None # Optional namespace for the Secret (None for default namespace)
def to_manifest(self) -> dict[str, Any]:
"""Convert to Kubernetes manifest format."""
metadata = {"name": self.name}
if self.namespace:
metadata["namespace"] = self.namespace
return {
"apiVersion": "v1",
"kind": "Secret",
"metadata": metadata,
"data": self.data,
}
@dataclass
class MigrationInput:
"""Represents all input data for the migration process."""
name: str = field(default="") # Name of the configuration
config_path: str = field(default="") # Path to the configuration file
config: dict[str, Any] = field(default_factory=dict) # Source configuration data
class MigrationError(Exception):
"""Base exception for migration-related errors."""
pass
@dataclass
class DiscoveredSecret:
"""Represents a discovered secret with source and target information."""
source_file: str # Source configuration file (e.g., "synapse.yaml", "mas.yaml")
secret_key: str # ESS secret key (e.g., "synapse.postgres.password")
value: str # Secret value
config_key: str # Original configuration path in source file
@dataclass
class SecretConfig:
init_if_missing_from_source_cfg: bool # Whether to initialize secret if missing from source config
description: str # User-friendly description of the secret
config_inline: str | None # Configuration path for inline secret values
config_path: str | None # Configuration path for secret file paths
transformer: Callable[[str], str | None] | None = (
None # Optional transformer function for extracting secrets from complex values
)