Files
stack/cloud/azure/README.md
kert 8bd649d9ab feat: skinny packages, tree reorg, cloud abstraction (refs #182–#201)
P23 — Skinny Packages:
- Break conf→bib circular dependency with lazy guarded import
- Extract aco.table.base → conf.table_base (shared foundation)
- Add try/except ImportError guards on all cross-module imports
- Define per-module optional-dependencies in pyproject.toml
- Slim base deps to just pydantic; all heavy deps in optional groups
- Add gen_config.py --check validation for module/dep sync
- Add skinny-install CI matrix job (tests each extra in isolation)

P24 — Tree Reorganization:
- Move service configs to infra/ (traefik, coredns, grafana, etc.)
- Consolidate Dockerfiles under infra/images/
- Move styles/ → assets/css/ + assets/icons/ + assets/nature.py
- Update compose.yml, stack.toml, gen_config.py, all backend emitters
- Update bootstrap scripts and install_certs.sh

P25 — Cloud Provider Abstraction:
- Add cloud/ directory with self-hosted, aws, gcp, azure stubs
- Add cloud contexts (aws, gcp, azure) to stack.toml
- Add conf/storage.py — get_filesystem() dispatches per context
- Add aws, gcp, azure optional dependency groups
- Document service mapping for each provider

All 11955 tests pass. Zero functionality lost.
2026-03-24 15:00:26 -04:00

1.4 KiB

Azure Deployment

Service Mapping

Component Azure Service Replaces
Object Storage Azure Blob Storage (ABFS) RustFS
Database Azure Database for PostgreSQL PostgreSQL container
Iceberg Catalog Unity Catalog / Azure Purview Nessie / Polaris
Query Engine Azure Synapse / Databricks SQL Trino
Compute Container Apps / AKS Docker Compose
Ingress Application Gateway + Azure DNS Traefik + CoreDNS
CI/CD Azure DevOps / GitHub Actions Gitea Actions
Observability Azure Monitor + App Insights Grafana stack

Context

[context.azure]
db_backend = "iceberg"
storage_backend = "abfs"
catalog = "unity"
compute = "container-apps"

Environment Variables

export STACK_CONTEXT=azure
export AZURE_STORAGE_ACCOUNT=yourstorageaccount
export AZURE_STORAGE_CONTAINER=lakehouse
# Managed Identity handles auth on Container Apps

Required RBAC Roles

  • Storage Blob Data Contributor on lakehouse container
  • Contributor on PostgreSQL server
  • Databricks workspace access if using Unity Catalog

Terraform

See terraform/ for resource definitions (placeholder).