ContacteCRQ en operació
Navegació
| ⬅️ Excepcions | ➡️ Rols i tasques CRQ |
|---|
Quan he d’utilitzar aquesta secció?
Consulta aquesta secció quan:
- un canvi operatiu afecta recursos ja en preproducció o producció,
- el canvi requereix traçabilitat formal,
- és necessari obrir una CRQ després del desplegament inicial,
- necessites conèixer els temps mínims, la tipologia o el flux d’estats d’una CRQ.
Per a CRQ durant el desplegament inicial, consulta CRQ i Desplegament.
CRQ en operació
Canigó – Guia operativa
Principis de govern
Una CRQ no és únicament un formulari: és un contenidor obligatori de tasques. Sense tasques i validacions explícites, una CRQ no es considera vàlida dins del model de govern d’EventHub.
- Tota CRQ ha d’incloure almenys una tasca d’execució, una tasca de validació i una tasca de marxa enrera.
- Només s’utilitzen CRQs de tipus Normal i Emergència.
- El motiu del canvi s’ha de seleccionar sempre entre les opcions disponibles a ATOM/Remedy.
- El propietari del recurs sol·licita la CRQ.
- L’Oficina EventHub valida, coordina i assegura la traçabilitat.
Tasques obligatòries de tota CRQ
Tota CRQ a EventHub ha d’incloure tres tasques obligatòries sense excepció:
| Tasca | Contingut obligatori | Assignada a |
|---|---|---|
| Tasca d’execució | Descripció detallada de les accions a executar: recurs afectat, entorn, passos concrets | CPD4 (on-prem) / Oficina EventHub (cloud) |
| Tasca de validació | Criteris d’acceptació i verificació post-canvi: proves a realitzar, estat esperat, responsable de validar | Aplicació sol·licitant + Oficina EventHub |
| Tasca de marxa enrera (rollback) | Passos concrets per revertir el canvi en cas d’error: com es fa, qui l’executa, temps estimat | CPD4 (on-prem) / Oficina EventHub (cloud) |
⚠️ Una CRQ sense tasca de marxa enrera no serà aprovada. El pla de rollback és un requisit de govern, no una recomanació.
ℹ️ Aquesta exigència s’alinea amb la IO de Gestió de Canvis de CTTI(pàg. 44)
Exemple de tasques per a una alta de topic en PRO
Tasca 1 – Execució: Creació del topic a l’entorn PRO amb les particions i retenció definides a la fitxa aprovada. Assignada a: CPD4 Aplicacions.
Tasca 2 – Validació: Verificació que el topic existeix, és accessible pel client Kafka de l’aplicació i que els permisos ACL són correctes. Assignada a: Aplicació sol·licitant.
Tasca 3 – Marxa enrera: En cas d’error o impacte no previst: eliminació del topic creat i restauració de l’estat anterior. Confirmar que cap consumidor ha quedat afectat. Assignada a: CPD4 Aplicacions, coordinat per l’Oficina EventHub.
Tipologia de CRQs
📌 Principi fonamental: Les aplicacions no obren CRQs directament sobre el servei EventHub. Sempre les tramita l’Oficina EventHub a partir d’una Work Order de l’aplicació sol·licitant.
| Tipus de CRQ | Qui l’obre | Què cobreix | Qui executa |
|---|---|---|---|
| CRQ d’Oficina (govern de la plataforma) | Oficina EventHub | Configuració, infraestructura, upgrades, serveis transversals | CPD4 (on-prem) / Oficina (cloud) |
| CRQ originada per Work Order d’Aplicació | Oficina EventHub (a partir de Work Order de l’aplicació) | Alta, baixa i modificació de recursos (topics, permisos, esquemes, connectors, KSQL/Flink) | CPD4 (on-prem) / Oficina (cloud) |
| CRQ externa amb impacte a EventHub | Equip d’aplicació externa (sobre el seu propi servei) | Canvis d’aplicació que afecten fluxos d’EventHub | Equip d’aplicació + tasca de validació tècnica de l’Oficina EventHub |
ℹ️ Vegeu l’apartat “CRQ externa amb impacte a EventHub” més avall per al detall del tercer cas.
Quan és obligatòria
- PRE: obligatòria si hi ha impacte funcional, dades o integracions compartides. CRQ preaprovada si no hi ha impacte ni intervenció d’Operacions.
- PRO: obligatòria sempre per a qualsevol canvi (configuració, permisos, baixes, replicació).
- Canvis de seguretat, accessos o recursos compartits.
Exemples de canvis operatius que requereixen CRQ
- Ampliar particions d’un topic en PRO.
- Modificar retention d’un topic existent.
- Canviar permisos d’un client Kafka.
- Aturar o retirar un connector.
- Afegir topics a un Cluster Link existent.
Temps mínims acordats
CRQ d’Oficina EventHub
Preproducció
| Tipus de canvi | Requereix reinici | Temps mínim |
|---|---|---|
| Canvi runtime (configuració en calent) | No | 24 hores |
| Configuració de plataforma | Sí | 1 setmana |
| Upgrades | Sí | 2 setmanes |
| Infraestructura | Sí | 2 setmanes |
Producció
| Tipus de canvi | Requereix reinici | Temps mínim |
|---|---|---|
| Canvi runtime (configuració en calent) | No | 1 setmana |
| Configuració de plataforma | Sí | 1 setmana |
| Upgrades | Sí | 3 setmanes |
| Infraestructura | Sí | 3 setmanes |
CRQ d’Aplicació
Preproducció
- Alta, baixa o modificació de qualsevol recurs: 24 hores.
Producció
| Recurs | Operació | Temps mínim |
|---|---|---|
| Topics, permisos, esquemes | Alta / Baixa / Modificació | 1 setmana |
| Connect, KSQL/Flink | Alta / Baixa / Modificació | 3 setmanes |
Flux d’estats d’una CRQ
Preproducció
Draft → Review / Authorization (auto-aprovat) → Plan & Schedule → Implementation → Closed
- El Change Coordinator introdueix dates i avança estats.
- Les tasques s’executen segons assignació (CPD4 o Oficina).
- No hi ha aprovacions manuals.
Producció
Draft → Review / Authorization (aprovadors per servei) → Plan & Schedule → Implementation → Closed
- En Review s’envien correus als aprovadors definits pel servei EventHub.
- La CRQ no avança fins a obtenir totes les aprovacions.
- Plan & Schedule fixa dates definitives i notifica els executors.
- El Change Coordinator marca inici i fi real de la implementació.
CRQ externa amb impacte a EventHub
Quan una aplicació externa desplega un canvi al seu propi servei (no sobre EventHub) i aquest canvi pot afectar fluxos ja desplegats a EventHub, la CRQ d’aquesta aplicació ha d’incloure una tasca de validació tècnica assignada a l’Oficina EventHub.
Quan és obligatòria
És obligatòria sempre que es compleixi almenys una d’aquestes condicions:
- La CRQ modifica codi productor o consumidor que opera sobre topics governats per EventHub.
- La CRQ modifica configuració d’integració (formats de missatge, schemes, retencions, particions consumides).
- La CRQ afecta la disponibilitat o el rendiment d’un sistema integrat via connector (per exemple, la BBDD font d’un Source CDC).
Com es configura
| Camp de la tasca | Valor |
|---|---|
| Phase | Implementation |
| Assignee Group | AM22_23-N2-CANVIS |
| Service | EventHub-Hub Corporatiu |
| Summary | Validació tècnica d’impacte a EventHub |
| Notes | Descripció dels fluxos afectats i criteris d’acceptació esperats |
La validació inclou la verificació d’observabilitat post-desplegament (mètriques, logs, consumer lag, estat dels connectors). Vegeu Validació d’observabilitat dins de la CRQ.
⚠️ Sense aquesta tasca, l’Oficina pot demanar el rebuig del canvi per part de Gestió de Canvis.
Errors habituals
- Obrir una CRQ sense validació prèvia de l’Oficina EventHub.
- Que una aplicació intenti obrir una CRQ directament sobre EventHub en lloc d’obrir una Work Order.
- No incloure tasca de marxa enrera (rebutjada automàticament).
- No incloure tasca de validació.
- Que una CRQ externa amb impacte a EventHub no incorpori la tasca de validació tècnica assignada a l’Oficina.
- Executar connectors sense validació prèvia de metadades (alta on-prem).
- No respectar els temps mínims per entorn.
- No registrar inici i fi real de les tasques.
- Confondre CRQ d’urgència amb canvis que no són crítics.
Si la situació requereix actuació immediata i no permet esperar una finestra estàndard, consulta el procediment de CRQ d’urgència.