Read in English · Lire en français · Auf Deutsch lesen
Sección 11.4 de 11.8 · Avanzado · 28 min de lectura
Gobernanza de la arquitectura en organizaciones ágiles
Videolección
5 min · narrado en inglés, con subtítulosSolo escuchar (audio)
Leer la transcripción
¿Cómo mantiene coherente su arquitectura una organización con muchos equipos autónomos, sin hacer que todos esperen una aprobación? Esta lección muestra cómo la gobernanza puede funcionar tan bien que los equipos apenas la notan.
Una ciudad no puede pedir al alcalde que apruebe cada cocina nueva. En su lugar, fija unos pocos principios, como que las calles se puedan recorrer a pie. Tiene normas de construcción que los inspectores comprueban automáticamente. Y reserva un comité para las pocas decisiones que de verdad lo necesitan, como un puente nuevo. Los vecinos hacen la mayoría de las cosas por sí mismos, pero para todo lo que afecte a los de al lado, se espera que les pregunten primero. La gobernanza de la arquitectura en las organizaciones ágiles funciona igual.
La gobernanza garantiza que las decisiones significativas se tomen bien, encajen con los objetivos de la organización y de verdad se sigan. Usa cuatro tipos de instrumento. Un principio da una dirección duradera y deja margen al criterio. Por ejemplo, cada dato de negocio tiene exactamente un servicio propietario. Un estándar es una elección concreta y obligatoria, como que todos los servicios emitan trazas y logs estructurados de la misma manera. Un guardrail mantiene a los equipos dentro de límites seguros mientras trabajan, normalmente de forma automática. Por ejemplo, el pipeline rechaza las imágenes de contenedor de registros no aprobados, sin ninguna cola. Una compuerta detiene el trabajo hasta que alguien lo aprueba, como el visto bueno de seguridad antes de tratar una nueva categoría de datos personales. Prefiere los guardrails siempre que una regla sea objetiva, y mantén las compuertas tempranas y escasas.
Esta es la diferencia en la práctica. Con una compuerta, un equipo diseña y luego espera semanas en la cola de una junta de revisión. Si el diseño se rechaza, se rediseña y vuelve a esperar. Con guardrails, el equipo decide, y el pipeline comprueba automáticamente las reglas objetivas mediante la política como código y las funciones de aptitud. El cambio puede llegar al lanzamiento en minutos. Por debajo, un camino pavimentado de plantillas y plataforma hace que la forma admitida sea la fácil, así que la mayoría de los equipos cumplen sin que se les diga.
TOGAF, el marco de arquitectura empresarial de The Open Group, da a cada principio cuatro partes. Primero, un nombre breve y fácil de recordar, como el principio de la plataforma: un único propietario para cada dato. Después, un enunciado: la regla en una o dos frases inequívocas. Una justificación explica el beneficio para el negocio, y las implicaciones dicen qué exige el principio en la práctica, incluido lo que cuesta. Dos pruebas detectan los principios débiles. ¿Podría una organización sensata elegir lo contrario? "Los sistemas deben ser seguros" no la supera, porque nadie elige la inseguridad. "Preferir comprar a construir para las capacidades genéricas" la supera. ¿Y resuelve una decisión real? Si nadie puede nombrar una elección que resolvería, es un eslogan.
Si ninguna junta decide, ¿quién lo hace? En el proceso de consejo, descrito por Andrew Harmel-Law en 2021, cualquiera puede tomar una decisión arquitectónica. Pero antes debe pedir consejo a todos los afectados de forma significativa, a personas con conocimientos relevantes y, a menudo, a un foro asesor abierto que se reúne cada semana. El foro da consejo; no decide. Quien toma la decisión debe escuchar el consejo, pero no está obligado a seguirlo. El objetivo es una aportación amplia, no el consenso, y la responsabilidad sigue siendo de quien decide. La decisión y el consejo recibido se registran juntos, en un registro de decisiones de arquitectura, o ADR. Y unos principios compartidos y un radar tecnológico orientan cada decisión.
Thoughtworks publica su Technology Radar dos veces al año desde 2010. Sitúa las tecnologías en anillos, cada una con una breve razón por escrito. Muchas organizaciones crean el suyo propio. Adopt significa probado y recomendado. Trial significa que merece la pena aplicarlo en un proyecto que pueda asumir el riesgo. Assess significa que merece la pena explorarlo, para entender su efecto. Y Hold, llamado Caution en las ediciones más recientes, significa avanzar con cuidado. En un radar interno, Hold dice con suavidad que no haya usos nuevos, sin prohibir lo que ya existe.
Así encaja todo. El equipo de pedidos quiere sustituir su relé de outbox por sondeo por una captura de datos de cambios, con una herramienta llamada Debezium que ningún equipo ha usado antes. Redacta un registro de decisión y lo presenta en el foro asesor. Los equipos de plataforma, datos y seguridad comentan, y el foro sugiere considerar la opción gestionada del proveedor de nube. El equipo acepta la mayor parte del consejo, pero rechaza la opción gestionada por su principio de portabilidad, y registra por qué. Añade guardrails: una función de aptitud que mantiene el retraso de los eventos por debajo de dos segundos en el percentil noventa y nueve, y una alerta sobre el retraso del slot de replicación. Debezium entra en el radar en Trial, limitado a pedidos, y los relés por sondeo pasan a Hold. Al cabo de un trimestre, el grupo del radar revisa la experiencia. Si es positiva, Debezium pasa a Adopt. Nada esperó en una cola: la decisión llevó alrededor de una semana.
La sección completa incluye tres principios desarrollados, la política como código y una guía sobre quién decide qué. A continuación, en la Sección once punto cinco, veremos Team Topologies. Nos vemos allí.
Lo que necesitas saber
- La gobernanza de la arquitectura garantiza que las decisiones significativas se tomen bien, de forma coherente con los objetivos de la organización, y que de verdad se sigan; sus propósitos incluyen la alineación, el riesgo y el cumplimiento normativo, limitar la diversidad innecesaria, proteger las cualidades compartidas y difundir el aprendizaje.
- Los principios dan una dirección duradera, los estándares hacen obligatorias elecciones concretas, los guardrails mantienen el trabajo dentro de unos límites de forma automática y las compuertas detienen el trabajo hasta su aprobación; prefiere los guardrails cuando las reglas son objetivas y mantén las compuertas tempranas y escasas.
- Los principios al estilo de TOGAF tienen nombre, enunciado, justificación e implicaciones; un buen principio podría elegirse razonablemente en sentido contrario y resuelve decisiones reales.
- En el proceso de consejo (advice process) (Andrew Harmel-Law, 2021), cualquiera puede tomar una decisión arquitectónica después de pedir consejo a los afectados y a los expertos, y la registra en un ADR; un foro asesor da visibilidad, pero no decide.
- Un radar tecnológico sitúa las tecnologías en anillos como Adopt, Trial, Assess y Hold, con razones por escrito; un radar interno recoge la experiencia propia de la organización y orienta las nuevas elecciones.
- La política como código (por ejemplo, Open Policy Agent con Rego) y las funciones de aptitud automatizan el cumplimiento normativo y producen pruebas para la auditoría como subproducto.
Para qué sirve la gobernanza de la arquitectura
La gobernanza de la arquitectura es el conjunto de prácticas con las que una organización se asegura de que sus decisiones técnicas significativas se toman bien, son coherentes con sus objetivos y se siguen de verdad. Responde a cuatro preguntas: quién puede tomar qué decisiones, cómo deben tomarlas, qué dirección deben seguir y cómo sabe nadie si el resultado se ajusta a lo previsto.
Los propósitos son prácticos. La gobernanza alinea la tecnología con la estrategia, para que cincuenta equipos no elijan cincuenta formas de almacenar los datos de los clientes. Gestiona el riesgo y el cumplimiento normativo: la protección de datos, la seguridad, la accesibilidad y la regulación sectorial necesitan pruebas de que se siguen las reglas. Limita la diversidad innecesaria, porque cada base de datos, lenguaje o producto de mensajería adicional necesita conocimientos, parches y soporte de guardia. Protege cualidades que ningún equipo posee por sí solo, como la latencia de extremo a extremo, la seguridad y el costo. Y difunde el aprendizaje, para que una lección que pagó un equipo no la vuelva a pagar el siguiente.
Las organizaciones ágiles sienten aquí una tensión. El principio del Manifiesto Ágil según el cual las mejores arquitecturas surgen de equipos autoorganizados (Sección 1.8) empuja hacia la autonomía; la escala, la regulación y la infraestructura compartida empujan hacia la alineación. Las descripciones de Henrik Kniberg de la cultura de ingeniería de Spotify popularizaron la expresión autonomía alineada (aligned autonomy) para el objetivo: equipos libres de decidir el cómo, dentro de un entendimiento compartido del qué y el porqué. La gobernanza es la maquinaria que lo hace posible. Mal hecha, se convierte en el lento proceso de aprobación de la Sección 11.2; bien hecha, los equipos apenas la notan, porque lo correcto es también lo fácil.
Principios, estándares, guardrails y compuertas
La gobernanza usa cuatro tipos de instrumento, que difieren en cuánto restringen y en cuándo actúan. Los principios expresan una dirección duradera y dejan margen al criterio. Los estándares son elecciones concretas y obligatorias (todos los servicios exponen trazas de OpenTelemetry; todas las API públicas se describen en OpenAPI). Los guardrails (salvaguardas) mantienen a los equipos dentro de límites seguros mientras trabajan, normalmente de forma automática y continua. Las compuertas (gates) detienen el trabajo hasta que alguien lo aprueba.
Instrumentos de gobernanza
| Instrumento | Ejemplo | Fortaleza | Riesgo |
|---|---|---|---|
| Principio | Cada dato de negocio tiene exactamente un servicio propietario | Guía muchas decisiones, incluidas las imprevistas | Demasiado vago para actuar en consecuencia, o ignorado en la práctica |
| Estándar | Todos los servicios emiten trazas de OpenTelemetry y logs JSON estructurados | Coherencia, herramientas compartidas, incorporación sencilla | Se queda obsoleto; bloquea opciones mejores; las excepciones se acumulan |
| Guardrail (salvaguarda) | El pipeline rechaza imágenes de contenedor de registros no aprobados | Continuo, rápido, objetivo, sin cola | Solo sirve para reglas que una máquina puede comprobar; se puede eludir si nadie es su responsable |
| Compuerta | Visto bueno de seguridad antes de tratar una nueva categoría de datos personales | Criterio humano con rendición de cuentas para decisiones de alto riesgo e irreversibles | Retrasos, retroalimentación tardía, evasión y aprobaciones de trámite |
Compuertas frente a guardrails
El consenso actual, aunque no universal, es preferir los guardrails a las compuertas siempre que una regla pueda formularse de manera objetiva, reservar las compuertas para las pocas decisiones en las que de verdad hace falta un criterio humano con rendición de cuentas, y celebrar esas compuertas pronto y con un tiempo limitado. Un camino pavimentado (paved road) (término de Netflix; Spotify lo llama camino dorado, golden path) complementa a ambos: cuando la forma admitida de construir un servicio ya incluye imágenes aprobadas, logging, análisis de seguridad y despliegue, la mayoría de los equipos cumplen sin que se les diga, y el esfuerzo de gobernanza puede concentrarse en las desviaciones deliberadas. La Sección 10.7 trata las plataformas que ofrecen esos caminos.
Redactar principios de arquitectura
TOGAF, el marco de arquitectura empresarial de The Open Group (el TOGAF Standard, 10th Edition, 2022), ofrece una plantilla muy utilizada para los principios, con cuatro partes. El nombre es breve y fácil de recordar. El enunciado expresa la regla en una o dos frases inequívocas. La justificación explica el beneficio para el negocio, en términos que un patrocinador no técnico podría aceptar. Las implicaciones dicen qué exige el principio en la práctica: qué hay que hacer, cuánto cuesta y qué descarta. TOGAF también enumera criterios para un buen conjunto de principios: comprensible, robusto (lo bastante preciso para decidir casos difíciles), completo, coherente y estable.
Dos pruebas detectan la mayoría de los principios débiles. Primero, ¿podría una organización sensata elegir lo contrario? "Los sistemas deben ser seguros" no la supera; nadie elegiría la inseguridad. "Preferir comprar a construir para las capacidades genéricas" la supera, porque algunas organizaciones prefieren, con razón, construir. Segundo, ¿cambia el principio una decisión real? Si nadie puede nombrar una elección que resolvería, es un eslogan. Andrew Harmel-Law pide un conjunto que no sea ni demasiado pequeño para cubrir las necesidades clave ni demasiado grande para que los equipos lo recuerden, que proceda de los propios equipos y esté vinculado a la estrategia de negocio, en lugar de máximas o prácticas generales de programación. Los principios más escasos y precisos se recuerdan y se usan; las listas largas, no.
Ejemplo práctico
Ejemplo práctico: tres principios para la plataforma de reparto de comida
Redactados por los arquitectos con los líderes de equipo, debatidos en el foro asesor y publicados junto al radar. Cada uno sigue la estructura de TOGAF.
| Nombre de P1 | Un único propietario para cada dato |
|---|---|
| Enunciado | Cada tipo de dato de negocio (pedidos, cartas, posiciones de los repartidores, pagos) tiene exactamente un servicio propietario, que es el único que lo escribe; los demás usan su API o sus eventos. |
| Justificación | Los datos compartidos con escritura acoplan los lanzamientos de los equipos y hacen que los errores no se puedan rastrear (Sección 7.1). Una propiedad clara permite a los equipos cambiar sus esquemas y desplegar de forma independiente, que es como el negocio lanza cada semana. |
| Implicaciones | Ningún servicio lee ni escribe las tablas de otro. Los informes usan eventos publicados o un almacén de datos. Los datos nuevos necesitan un propietario con nombre antes de almacenarse. Una función de aptitud comprueba las credenciales de base de datos por servicio. |
| Nombre de P2 | Asíncrono entre dominios |
| Enunciado | Los dominios se integran por defecto mediante eventos publicados; las llamadas síncronas entre dominios se usan solo cuando el usuario está esperando la respuesta. |
| Justificación | Las cadenas síncronas multiplican la indisponibilidad y añaden latencia (Sección 6.1); el pico del viernes y las caídas de los socios son los mayores riesgos operativos del negocio. |
| Implicaciones | Los equipos diseñan para la consistencia eventual y los consumidores idempotentes. Cada llamada síncrona entre dominios tiene un timeout, una alternativa y un presupuesto de latencia. Más inversión operativa en el broker y en el trazado. |
| Nombre de P3 | Comprar lo genérico, construir lo central, seguir siendo portables |
| Enunciado | Las capacidades genéricas (identidad, pagos, correo electrónico, monitorización) se compran o se usan como servicios gestionados; las capacidades diferenciadoras (optimización del despacho, herramientas para restaurantes) se construyen. La lógica de negocio queda detrás de puertos, no dentro de los servicios propietarios de un proveedor. |
| Justificación | El tiempo de ingeniería es el recurso más escaso y debe ir a donde compite el negocio (dominios centrales, Sección 5.7), evitando a la vez una dependencia del proveedor (lock-in) que debilitaría el poder de negociación (Sección 10.8). |
| Implicaciones | Construir o comprar es una pregunta explícita en cada ADR pertinente. Se accede a los servicios gestionados a través de adaptadores. Algunas funcionalidades gestionadas con una dependencia profunda del proveedor se rechazan aunque sean cómodas. |
Cada principio resuelve elecciones reales y recurrentes, y una organización sensata podría elegir otra cosa.
Las implicaciones incluyen los costos, no solo los beneficios.
P1 y P2 se pueden hacer cumplir en parte como guardrails; P3 necesita criterio humano, así que se aplica mediante el proceso de consejo.
Toma de decisiones descentralizada: el proceso de consejo
Si las decisiones ya no se canalizan a través de una junta, ¿quién las toma? El artículo de Andrew Harmel-Law Scaling the Practice of Architecture, Conversationally (martinfowler.com, diciembre de 2021) propuso una respuesta tomada de las organizaciones autogestionadas: el proceso de consejo (advice process). Su única regla es que cualquiera puede tomar una decisión arquitectónica, siempre que antes de decidir pida consejo a todas las personas a las que afectará de forma significativa y a personas con conocimientos relevantes. Quien toma la decisión debe escuchar y registrar el consejo, pero no está obligado a seguirlo; el objetivo es una aportación amplia, no el consenso. La responsabilidad sigue siendo de la persona o el equipo que decide, y eso es lo que hace funcionar la regla: quien sabe que carga con las consecuencias pide consejo en serio.
Harmel-Law describe cuatro elementos de apoyo. Los registros de decisiones (ADR, Sección 4.5) son la herramienta para pensar y registrar, e incluyen el consejo recibido, de quién y cuándo. Un foro asesor de arquitectura, normalmente semanal, de alrededor de una hora y abierto a cualquiera, da visibilidad a los nuevos spikes, a las decisiones propuestas y a las que se revisan; y, lo que es fundamental, ofrece consejo, pero no decide. Los principios arquitectónicos que proceden de los equipos dan una dirección compartida. Y un radar tecnológico interno muestra el panorama tecnológico actual de la organización y su postura.
El proceso de consejo
El proceso de consejo tiene modos de fallo que conviene conocer. Quienes deciden pueden consultar solo a las personas que probablemente estarán de acuerdo; ayuda una lista publicada de a quién hay que consultar para cada tipo de decisión (a seguridad para cualquier cosa que toque datos personales, al equipo de plataforma para la nueva infraestructura). El consejo puede pedirse demasiado tarde, cuando el código ya está escrito; ayuda hacer del ADR propuesto el comienzo del trabajo, no el final. Y a algunas personas les resulta incómodo al principio que el foro no decida. En entornos regulados, el proceso puede convivir con un pequeño número de compuertas formales, aplicadas solo donde la ley o el apetito de riesgo de la organización lo exijan.
Radares tecnológicos
Thoughtworks publica su Technology Radar dos veces al año desde 2010. Cada edición sitúa un centenar de blips (técnicas, herramientas, plataformas, y lenguajes y frameworks: los cuatro cuadrantes) en anillos que expresan una recomendación. Adopt significa probado y recomendado; Trial, que merece la pena aplicarlo en un proyecto que pueda asumir el riesgo; Assess, que merece la pena explorarlo para entender su efecto; y el anillo exterior, llamado Hold durante la mayor parte de la historia del radar y Caution en sus ediciones más recientes, significa avanzar con cuidado. Cada blip tiene una breve justificación por escrito, que es la parte más valiosa.
Muchas organizaciones crean su propio radar, para sí mismas y no para el sector. Thoughtworks ofrece una herramienta de código abierto, Build Your Own Radar, que genera un radar a partir de una hoja de cálculo o un archivo CSV con las columnas name, ring, quadrant, isNew y description. El valor está menos en la imagen que en el proceso: los equipos proponen blips, un grupo pequeño con representantes de muchos equipos los debate, los anillos se asignan con una razón por escrito y el radar se actualiza cada trimestre o cada semestre. Un anillo Hold es una herramienta de gobernanza suave pero eficaz: dice "ningún uso nuevo" sin prohibir lo que ya existe. Un radar se diferencia de una lista de tecnologías aprobadas en que es explícitamente provisional y razonado, y en que recoge lo que la organización ha aprendido, incluidos sus errores.
Ejemplo práctico
Ejemplo práctico: una entrada del radar y el registro de decisión que la respalda
El equipo de pedidos quiere sustituir su relé de outbox por sondeo (Sección 6.7) por una captura de datos de cambios con Debezium, que lee el registro de escritura anticipada (write-ahead log) de la base de datos y publica los cambios en Kafka. Ningún equipo ha usado Debezium antes, así que la decisión afecta al equipo de plataforma, que gestiona Kafka Connect, y al equipo de datos, responsable de las operaciones de la base de datos.
| 1. Borrador | El equipo redacta el ADR-0031 con estado Proposed (propuesto) y lo presenta en el foro asesor semanal |
|---|---|
| 2. Pedir consejo | Los equipos de plataforma, datos y seguridad comentan en el pull request; el foro sugiere considerar la CDC gestionada del proveedor de nube |
| 3. Decidir | El equipo de pedidos acepta la mayor parte del consejo, rechaza la opción gestionada por el principio P3 (portabilidad) y registra por qué |
| 4. Proteger | Se añaden una función de aptitud sobre el retraso de los eventos (p99 por debajo de 2 s) y una alerta sobre el retraso del slot de replicación |
| 5. Radar | Debezium entra en el radar en Trial, limitado a pedidos; los relés por sondeo pasan a Hold |
| 6. Revisión | Al cabo de un trimestre, el grupo del radar revisa la experiencia; si es positiva, Debezium pasa a Adopt y se cierra la nota de revisión del ADR |
La entrada del radar es el breve resumen público; el ADR contiene el razonamiento y el consejo. Cada uno remite al otro.
Trial tiene un alcance limitado, lo que mantiene la decisión reversible mientras la organización aprende.
Nada esperó en una cola: la decisión llevó alrededor de una semana, dedicada en su mayor parte a reunir consejos realmente útiles.
name,ring,quadrant,isNew,description
Debezium for outbox relay,Trial,Tools,TRUE,"Change data capture from the order database's write-ahead log to Kafka, replacing polling relays. Trial in ordering only; see ADR-0031. Owner: ordering team. Review: Q3."
Polling outbox relay,Hold,Techniques,FALSE,"Adds load and latency at peak; no new uses. Existing relays move when Debezium leaves Trial."# ADR-0031: Use Debezium change data capture for the ordering outbox relay
Status: Accepted (2026-05-14) Decision-taker: Priya N., ordering team
Context: The polling relay queries the outbox table every 500 ms. At 100 orders/s
it adds measurable database load and up to 1 s of event delay to dispatch.
Options: (1) tune polling; (2) Debezium CDC on the write-ahead log; (3) managed CDC
from the cloud provider.
Decision: Option 2, for the ordering service only, as a Trial on the radar.
Advice received:
- Platform team (2026-05-06): supports; will run Kafka Connect, needs runbook.
- Data team (2026-05-07): concern about replication slot growth if Connect stops;
asks for an alert on slot lag. Accepted.
- Security (2026-05-08): CDC user must have replication rights only. Accepted.
- Advisory forum (2026-05-09): suggested option 3; rejected for portability (P3).
Consequences: lower load and delay; a new component to operate; slot-lag alert
and a fitness function on event delay (p99 under 2 s) added.
Review: after one quarter, or before any second service adopts it.El papel actual de la arquitectura empresarial
La arquitectura empresarial (Sección 1.2) ha tenido una reputación incómoda en las organizaciones ágiles: equipos centrales que producían marcos, estándares y procesos de aprobación que los equipos de entrega vivían como obstáculos. El papel ha ido cambiando. En las organizaciones donde funciona bien, los arquitectos empresariales curan los principios y el radar en lugar de dictarlos, mantienen el mapa de capacidades de negocio y sistemas que ningún equipo puede ver por sí solo, toman o facilitan las decisiones de puerta de un solo sentido que de verdad afectan a toda la organización (identidad, datos centrales, estrategia de nube, grandes proveedores), dirigen el foro asesor y dan forma a la plataforma y al camino pavimentado junto con los equipos de plataforma.
La imagen de Gregor Hohpe del arquitecto que viaja en ascensor entre la sala de juntas y la sala de máquinas (Sección 11.7) describe la habilidad que esto requiere: traducir la estrategia en dirección técnica y las restricciones técnicas al lenguaje del negocio. Los profesionales siguen sin ponerse de acuerdo sobre cuánta autoridad central es sana. Algunos sostienen que una función central fuerte es imprescindible en empresas reguladas, con muchas fusiones o muy integradas; otros sostienen que la mayor parte de su valor puede ofrecerse mediante plataformas, principios y consejo. La respuesta depende del tamaño de la organización, de su regulación y de qué parte de su panorama de sistemas es realmente compartida.
Cumplimiento mediante la automatización
Sea cual sea el modelo organizativo, el cumplimiento más barato es el automatizado. Las funciones de aptitud (Sección 11.3) comprueban las características de la arquitectura. La política como código hace lo mismo con las reglas de la organización: las reglas se escriben en un lenguaje legible por máquinas, se guardan en el control de versiones, se revisan y se prueban como el código, y se evalúan automáticamente contra definiciones de infraestructura, manifiestos de despliegue o solicitudes a la API. Open Policy Agent, un proyecto graduado de la Cloud Native Computing Foundation, es un motor de uso general muy utilizado con su propio lenguaje de políticas, Rego; Conftest aplica políticas Rego a archivos de configuración en un pipeline, y los controladores de admisión como OPA Gatekeeper o Kyverno hacen cumplir políticas dentro de los clústeres de Kubernetes.
El cumplimiento automatizado tiene otra ventaja que las organizaciones reguladas valoran mucho: las pruebas. Un registro del pipeline que muestra que cada lanzamiento pasó las mismas comprobaciones es una prueba mucho más sólida para un auditor que un formulario firmado, y se produce sin costo adicional.
package main
import rego.v1
# Guardrail: images must come from the organisation's scanned registry
deny contains msg if {
input.kind == "Deployment"
some c in input.spec.template.spec.containers
not startswith(c.image, "registry.fooddelivery.example/")
msg := sprintf("%s: image %s is not from the approved registry", [input.metadata.name, c.image])
}
# Guardrail: every container declares a memory limit
deny contains msg if {
input.kind == "Deployment"
some c in input.spec.template.spec.containers
not c.resources.limits.memory
msg := sprintf("%s: container %s has no memory limit", [input.metadata.name, c.name])
}Equilibrar autonomía y alineación
La pregunta práctica es qué decisiones se gobiernan y cómo. Una regla útil se deriva de la Sección 1.6: cuanto más reversible y local es una decisión, más cerca del equipo debe tomarse; cuanto más irreversible y de mayor alcance, más consejo y, en ocasiones, aprobación necesita. La tabla presenta un reparto típico; cada organización ajusta el suyo.
Quién decide qué
| Tipo de decisión | Quién decide | Mecanismo | Ejemplo |
|---|---|---|---|
| Local y reversible | El equipo | Criterio del equipo; ADR si es significativa | Una biblioteca dentro de un servicio; la estructura interna de los módulos |
| Afecta a otros equipos, reversible con un costo moderado | El equipo, después de pedir consejo | Proceso de consejo, foro asesor, radar | Adoptar Debezium; un nuevo evento publicado para otros |
| Para toda la organización o difícil de revertir | Un responsable sénior con nombre, después de una consulta amplia | Proceso de consejo con arquitectos empresariales; cambio de principio o de radar | Elección del proveedor de identidad; proveedor de nube principal |
| Reglas objetivas y comprobables | Nadie, caso por caso | Guardrails: política como código y funciones de aptitud | Registros de imágenes aprobados; ningún bucket de almacenamiento público |
| Regulada o de alto riesgo | Un aprobador que rinde cuentas | Compuerta temprana y limitada en el tiempo, con pruebas | Tratamiento de datos de salud; funciones relacionadas con la seguridad (safety) |
La propia gobernanza debe medirse. Son señales útiles cuánto tardan las decisiones significativas desde la propuesta hasta la aceptación, cuántas excepciones a los estándares se solicitan y se conceden, qué proporción de servicios está en el camino pavimentado, cuántas tecnologías en Hold se siguen extendiendo y si los incidentes se remontan a decisiones que se saltaron el consejo. Si las decisiones son lentas, la gobernanza es demasiado pesada; si los incidentes siguen remontándose a decisiones no consultadas, es demasiado ligera.
Guía de decisión
Guía de decisión: ¿compuerta, guardrail o consejo?
Úsala al decidir cómo debe gobernarse una regla concreta o un tipo de decisión.
- ¿Puede formularse la regla de manera objetiva y comprobarse con una máquina?SíConviértela en un guardrail: política como código o una función de aptitud en el pipeline, con un responsable y una vía para las excepciones.NoContinúa.
- ¿Es la decisión local de un equipo y barata de revertir?SíDeja que el equipo decida; registra un ADR si es significativa.NoContinúa.
- ¿Exigen la ley, la regulación o el apetito de riesgo de la organización una aprobación formal de alguien que rinda cuentas?SíUsa una compuerta, pero celébrala pronto, limítala en el tiempo y deja claras las pruebas que necesita.NoContinúa.
- ¿Es una puerta de un solo sentido que afecta a muchos equipos?SíUsa el proceso de consejo con una consulta amplia, que incluya a los arquitectos empresariales, y un responsable sénior de la decisión con nombre.NoUsa el proceso de consejo: consulta a los afectados y a los expertos, y después decide y registra.
Comprueba lo que has entendido
¿Cuál es la diferencia entre un guardrail y una compuerta?
Un guardrail mantiene el trabajo dentro de unos límites de forma continua, normalmente mediante comprobaciones automatizadas, sin detenerlo; una compuerta detiene el trabajo hasta que alguien lo aprueba.
¿Cuáles son las cuatro partes de un principio de arquitectura al estilo de TOGAF?
Nombre, enunciado, justificación e implicaciones.
En el proceso de consejo, ¿quién toma la decisión y debe seguir el consejo?
La persona o el equipo que toma la decisión, que debe pedir y registrar el consejo de los afectados y de los expertos, pero no está obligado a seguirlo.
¿Qué suele significar para los usos existentes situar una tecnología en el anillo Hold de un radar?
Significa que no deberían iniciarse usos nuevos; los usos existentes no se prohíben, aunque pueden migrarse con el tiempo.
Fuentes y lecturas recomendadas
¿Tienes una pregunta sobre esta sección? ArchitectBot, el asistente de estudio con IA del curso, responde primero a partir del curso.
Pregunta: “Tenemos doce equipos de producto y una junta de arquitectura de la que todo el mundo se queja. ¿Cómo introduciríamos el proceso de consejo y un radar tecnológico sin perder el control de las decisiones de seguridad y de datos?”