devopsandClaude Sonnet 5
03cfb203eb
Nueva fase, separada y con prioridad sobre las Fases 2-4 del ADR 0012: practica de Apps Script (via clasp, sin MCP -- se verifico que no existe uno oficial de Google) y AppSheet (documentado desde afuera, sin export de codigo posible, verificado contra la documentacion oficial) para iniciativas reales de la empresa con cuenta personal, sin datos ni credenciales de cliente en ningun repo/doc. Deja explicito lo que queda en pausa mientras esta fase este activa: swap de tmux-host, Fase 4 del ADR 0012 (GKE), prueba del skill frontend-design. Co-Authored-By: Claude Sonnet 5 <[email protected]> Claude-Session: https://claude.ai/code/session_01QMP7ULbxbsB5g1vELNAT3D
135 lines
5.3 KiB
YAML
135 lines
5.3 KiB
YAML
site_name: CruzCloud Lab
|
|
site_description: >-
|
|
Portal de documentación del lab GitOps CruzCloud — arquitectura, decisiones
|
|
y playbooks de incidentes reales (ZimaOS + k3d + Gitea + Argo CD).
|
|
site_url: https://docs.cruzcloud.net/
|
|
repo_url: https://gitea.cruzcloud.net/devops/apps-registry
|
|
repo_name: devops/apps-registry
|
|
edit_uri: _blank
|
|
|
|
docs_dir: docs
|
|
|
|
theme:
|
|
name: material
|
|
language: es
|
|
palette:
|
|
- media: "(prefers-color-scheme: light)"
|
|
scheme: default
|
|
primary: indigo
|
|
accent: indigo
|
|
toggle:
|
|
icon: material/weather-night
|
|
name: Cambiar a modo oscuro
|
|
- media: "(prefers-color-scheme: dark)"
|
|
scheme: slate
|
|
primary: indigo
|
|
accent: indigo
|
|
toggle:
|
|
icon: material/weather-sunny
|
|
name: Cambiar a modo claro
|
|
features:
|
|
- navigation.tabs
|
|
- navigation.tabs.sticky
|
|
- navigation.sections
|
|
- navigation.top
|
|
- navigation.footer
|
|
- navigation.indexes
|
|
- search.suggest
|
|
- search.highlight
|
|
- content.code.copy
|
|
- content.tabs.link
|
|
- toc.follow
|
|
|
|
plugins:
|
|
- search:
|
|
lang: es
|
|
# TODO (fase 2): git-revision-date-localized deshabilitado a propósito.
|
|
# El Dockerfile construye con context: workloads/docs-portal/, que no
|
|
# incluye .git (vive en la raíz del repo) — el plugin no tiene historial
|
|
# 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
|
|
- attr_list
|
|
- md_in_html
|
|
- tables
|
|
- toc:
|
|
permalink: true
|
|
- pymdownx.details
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
format: !!python/name:pymdownx.superfences.fence_code_format
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.snippets
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
|
|
nav:
|
|
- Inicio: index.md
|
|
- Templates:
|
|
- platform-templates: plantillas/platform-templates.md
|
|
- Arquitectura:
|
|
- Visión general: arquitectura/vision-general.md
|
|
- Red y exposición: arquitectura/red-y-exposicion.md
|
|
- Flujo GitOps: arquitectura/gitops-flujo.md
|
|
- Agente de monitoreo: arquitectura/agente-monitoreo.md
|
|
- Sesión tmux persistente: arquitectura/sesion-tmux-persistente.md
|
|
- Plugins y subagentes: arquitectura/plugins-y-subagentes.md
|
|
- Glosario: arquitectura/glosario.md
|
|
- Decisiones (ADRs):
|
|
- "0001 · Por qué k3d": decisiones/0001-por-que-k3d.md
|
|
- "0002 · Por qué Argo CD": decisiones/0002-por-que-argocd-vs-manual.md
|
|
- "0003 · HTTP/2 sobre QUIC": decisiones/0003-por-que-http2-sobre-quic-tunnel.md
|
|
- "0004 · Stack multi-categoría": decisiones/0004-evaluacion-stack-multi-categoria.md
|
|
- "0005 · Rediseño storefront": decisiones/0005-rediseno-storefront.md
|
|
- "0006 · Motor de búsqueda y facetas": decisiones/0006-motor-busqueda-facetas.md
|
|
- "0007 · Identidad visual propia": decisiones/0007-identidad-visual-propia.md
|
|
- "0008 · Identidad Navy & Coral": decisiones/0008-identidad-navy-coral.md
|
|
- "0009 · Checkout real": decisiones/0009-checkout-real.md
|
|
- "0010 · Pago y envío reales": decisiones/0010-pago-envio-reales-y-storefront.md
|
|
- "0011 · Ambiente de Staging": decisiones/0011-ambiente-staging.md
|
|
- "0012 · Práctica multi-cloud GCP/Azure": decisiones/0012-practica-multicloud-gcp-azure.md
|
|
- "0013 · Iniciativas de clientes": decisiones/0013-iniciativas-clientes.md
|
|
- Plantilla ADR: decisiones/plantilla-adr.md
|
|
- Playbooks:
|
|
- Crashloop Medusa: playbooks/incidente-crashloop-medusa.md
|
|
- 504 túnel Gitea: playbooks/incidente-504-gitea-tunnel.md
|
|
- Precios Medusa: playbooks/incidente-precios-medusa.md
|
|
- Imágenes NPM: playbooks/incidente-imagenes-npm.md
|
|
- SQLite modo DELETE: playbooks/incidente-sqlite-modo-delete-2026-08.md
|
|
- Anchors YAML en Gitea Actions: playbooks/incidente-yaml-anchors-gitea-actions-2026-08.md
|
|
- Docker-in-Docker y Semgrep: playbooks/incidente-docker-in-docker-semgrep-2026-08.md
|
|
- Realm HTTP y Cosign: playbooks/incidente-cosign-realm-http-tunnel-2026-08.md
|
|
- Contención de recursos Gitea/runner: playbooks/incidente-contencion-recursos-gitea-runner-2026-08.md
|
|
- Blackhole MTU cross-node: playbooks/incidente-mtu-blackhole-cross-node-2026-08.md
|
|
- "Migración a platform-templates": playbooks/migracion-platform-templates-2026-08.md
|
|
- Aprendizajes:
|
|
- Notas sueltas: aprendizajes/notas-sueltas.md
|
|
- Guía del estudiante:
|
|
- Inicio: guia-estudiante/README.md
|
|
- Conceptos básicos: guia-estudiante/conceptos-basicos.md
|
|
- DevSecOps:
|
|
- Resumen: devsecops/index.md
|
|
- Gitleaks (secretos): devsecops/gitleaks.md
|
|
- Trivy (imagen + IaC): devsecops/trivy.md
|
|
- SAST (Semgrep): devsecops/sast.md
|
|
- SBOM (Syft): devsecops/sbom.md
|
|
- Cosign (firma de imágenes): devsecops/cosign.md
|
|
|
|
extra:
|
|
social:
|
|
- icon: fontawesome/brands/git-alt
|
|
link: https://gitea.cruzcloud.net/devops
|