Saltar a contenido

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):

  1. python scripts/sync_wiki_home.py
  2. mkdocs build
  3. 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).