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

44 lines
1.4 KiB
Markdown

# 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
```toml
[context.azure]
db_backend = "iceberg"
storage_backend = "abfs"
catalog = "unity"
compute = "container-apps"
```
## Environment Variables
```bash
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).