Wiki estática (MkDocs → Azure Storage → Front Door)¶
La documentación en docs/ se publica como sitio estático con MkDocs Material.
La página de inicio es el README del repo (sincronizado con scripts/sync_wiki_home.py), con tarjetas de rutas solo en la wiki.
URLs DEV¶
| Entrada | URL |
|---|---|
| Pública (Front Door) | https://ep-docs-dev-hhg4hpa5ecajdhfm.z02.azurefd.net/ |
| Origin (Storage static) | https://steaidevwikifz1d.z41.web.core.windows.net/ |
Storage: steaidevwikifz1d · container $web · RG rg-eai-dev-mxc
Borde: edge-front-door.md (caché CSS/JS 7 d; wiki pública, sin FRONT_DOOR_ID).
Local¶
pip install -r requirements-docs.txt
python scripts/sync_wiki_home.py
mkdocs serve
# http://127.0.0.1:8000
Edita el home en README.md (raíz). No edites a mano docs/index.md — se regenera.
CI¶
Pipeline eai-docs-wiki-deploy (azure-pipelines-docs-wiki.yml):
python scripts/sync_wiki_home.pymkdocs build- Upload a
$web
Trigger: cambios en README.md, docs/**, mkdocs.yml (rama deployment).
Opcional tras deploy (si el HTML no refresca en AFD):
az afd endpoint purge -g rg-honne-edge-shared `
--profile-name afd-honne-edge-shared `
--endpoint-name ep-docs-dev `
--content-paths "/*"
Terraform¶
infra/environments/dev/docs_wiki.tf — storage account + static website.
Outputs: docs_wiki_url, docs_wiki_storage_account.
Front Door del wiki: manual en rg-honne-edge-shared (no Terraform MVP).