chore(gitops): deploy Docs Portal v1.0.97 [skip ci]

mkdocs build --strict aborta ante CUALQUIER WARNING, no solo ante links
rotos. El plugin, al no tener .git real en el contexto de build
(workloads/docs-portal/, sin .git de la raíz del repo), cae siempre en
fallback_to_build_date y emite un WARNING por página — suficiente para
tumbar el build bajo --strict (confirmado en run 96, job 108: 33
warnings, todos de este plugin, cero links rotos).

Se deshabilita el plugin (comentado en mkdocs.yml y requirements.txt,
con TODO fase 2: mover el build a la raíz del repo + fetch-depth:0 para
darle historial real) y se revierte la instalación de git en el
Dockerfile, que ya no hace falta. index.md actualizado para no prometer
fechas reales que hoy no se muestran.

workloads/docs-portal/Dockerfile

@@ -3,14 +3,6 @@ FROM python:3.12-slim AS build
 
 WORKDIR /site
 
-# mkdocs-git-revision-date-localized-plugin depende de GitPython, que
-# necesita el binario git presente solo para poder importarse (si falta,
-# el import truena y rompe el build --strict, incluso con
-# fallback_to_build_date activado en mkdocs.yml).
-RUN apt-get update \
-    && apt-get install -y --no-install-recommends git \
-    && rm -rf /var/lib/apt/lists/*
-
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 

workloads/docs-portal/deployment.yaml

@@ -16,7 +16,7 @@ spec:
       - name: gitea-registry-secret
       containers:
       - name: docs-portal
-        image: gitea.cruzcloud.net/devops/docs-portal:v1.0.0
+        image: gitea.cruzcloud.net/devops/docs-portal:v1.0.97
         ports:
         - containerPort: 80
         resources:

workloads/docs-portal/docs/index.md

@@ -44,12 +44,17 @@ que cada una pueda entrar por su propia puerta:
 
 ## Estado de este sitio
 
-Este portal se mantiene vivo junto con el lab — cada página muestra su
+Este portal se mantiene vivo junto con el lab. La idea es que cada
-última fecha de modificación real (`git-revision-date-localized`). Si
+página muestre su última fecha de modificación real vía
-una página dice "TODO", es contenido pendiente de una fase posterior,
+`git-revision-date-localized` — por ahora ese plugin está deshabilitado
-no una promesa incumplida: la estructura completa se construyó primero
+(ver TODO en `mkdocs.yml`): el build corre con `mkdocs build --strict`,
-a propósito, para que el contenido se llene sección por sección con el
+que aborta ante cualquier `WARNING`, y el plugin no tiene historial git
-mismo criterio que el resto del lab.
+real que leer desde el contexto de build actual, así que se queda fuera
+hasta que ese contexto incluya `.git` de verdad. Si una página dice
+"TODO", es contenido pendiente de una fase posterior, no una promesa
+incumplida: la estructura completa se construyó primero a propósito,
+para que el contenido se llene sección por sección con el mismo
+criterio que el resto del lab.
 
 Desde este commit, el sitio se construye y publica solo: cada push a
 `main` que toca `docs/` o `mkdocs.yml` dispara

workloads/docs-portal/mkdocs.yml

@@ -43,10 +43,18 @@ theme:
 plugins:
   - search:
       lang: es
-  - git-revision-date-localized:
+  # TODO (fase 2): git-revision-date-localized deshabilitado a propósito.
-      enable_creation_date: true
+  # El Dockerfile construye con context: workloads/docs-portal/, que no
-      type: date
+  # incluye .git (vive en la raíz del repo) — el plugin no tiene historial
-      fallback_to_build_date: true
+  # real que leer y cae siempre en fallback_to_build_date, emitiendo un
+  # WARNING por página. mkdocs build --strict aborta ante CUALQUIER
+  # WARNING, así que mientras no se le dé contexto de build con .git real
+  # (mover el build a la raíz del repo + fetch-depth:0 en el workflow),
+  # este plugin debe quedar fuera para no romper el pipeline.
+  # - git-revision-date-localized:
+  #     enable_creation_date: true
+  #     type: date
+  #     fallback_to_build_date: true
 
 markdown_extensions:
   - admonition

workloads/docs-portal/requirements.txt

@@ -1,3 +1,3 @@
 mkdocs==1.6.*
 mkdocs-material==9.5.*
-mkdocs-git-revision-date-localized-plugin==1.2.*
+# mkdocs-git-revision-date-localized-plugin==1.2.*  # deshabilitado, ver TODO en mkdocs.yml