CRQ i Desplegament a EventHub
Navegació
| ⬅️ CRQ | ➡️ Observabilitat |
|---|
Canigó – Guia per a aplicacions
Aquesta pàgina explica com es tramita el desplegament de recursos a EventHub segons l’entorn i el model Work Order → CRQ que regeix la plataforma.
No descriu el procés corporatiu de CRQ en detall: indica com aplicar-lo a EventHub de manera pràctica.
📌 Diferència amb la pàgina anterior: La pàgina Necessito CRQ? respon si un canvi requereix CRQ o no. Aquesta pàgina explica com es tramita un cop s’ha decidit que cal.
Quan he de consultar aquesta secció?
Consulta aquesta secció quan:
- ja has decidit que el canvi pot avançar,
- saps que necessites CRQ,
- vols entendre com aplicar el procés de CRQ als recursos d’EventHub.
Aquesta secció pressuposa que s’ha completat la Checklist final abans de passar a producció.
1. Principis generals de desplegament
A EventHub:
- Els recursos estan governats i auditats.
- El desplegament depèn de l’entorn i de l’impacte.
- Producció (PRO) és sempre l’entorn més restrictiu.
- La Oficina EventHub coordina i valida els desplegaments.
Entorns:
- INT: integració i proves tècniques.
- PRE: preproducció i validació final.
- PRO: producció.
2. Què és una CRQ?
Una CRQ (Change Request) és el mecanisme corporatiu per:
- Controlar canvis amb impacte.
- Reduir riscos en PRE i PRO.
- Garantir traçabilitat i validació.
A EventHub, la CRQ s’aplica a:
- Canvis amb impacte tècnic o operatiu.
- Canvis que afecten dades, integracions o seguretat.
3. Model Work Order → CRQ
A EventHub regeix el següent principi fonamental:
Les aplicacions no obren CRQs directament sobre el servei EventHub. Obren una Work Order a l’Oficina EventHub, que és l’única autoritzada a tramitar CRQs sobre el seu servei a Remedy.
| Actor | Què fa |
|---|---|
| Aplicació sol·licitant | Obre una Work Order a l’Oficina EventHub amb la fitxa adjunta i el detall complet de la sol·licitud (recursos, flux, configuració). |
| Oficina EventHub | Valida la Work Order. Si correspon, obre la CRQ a Remedy seguint la IO de Gestió de Canvis i els procediments d’obertura de CRQ. |
| CPD4 / Oficina cloud | Executa el desplegament tècnic segons l’entorn. |
⚠️ Per saber si un canvi requereix CRQ segons entorn i impacte, consulta Necessito CRQ?. Aquesta pàgina pressuposa que la decisió ja està presa.
4. Validació tècnica obligatòria en CRQs externes
Quan una aplicació externa desplega un canvi al seu propi servei i aquest canvi pot afectar fluxos ja desplegats a EventHub, la CRQ d’aquesta aplicació ha d’incloure obligatòriament una tasca de validació tècnica assignada a l’Oficina EventHub.
É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).
L’assignació es fa al grup AM22_23-N2 com a tasca dins la fase d’Implementació de la CRQ externa. Sense aquesta tasca, l’Oficina pot demanar el rebuig del canvi per part de Gestió de Canvis.
5. Recursos i necessitat de CRQ (resum pràctic)
| Recurs | INT | PRE | PRO |
|---|---|---|---|
| Topic | No | Segons impacte | Sí |
| Schema | No | Segons impacte | Sí |
| Client Kafka / ACLs | No | Segons impacte | Sí |
| Connector | No | Sí | Sí |
| Stream Processing | No | Sí | Sí |
| Cluster Linking | No | Sí | Sí |
| Replicator | No | Sí | Sí |
| Baixa de recursos | No | Sí | Sí |
Nota: «Segons impacte» implica validació prèvia de l’Oficina EventHub.
6. Flux de desplegament a EventHub
Pas 1. Sol·licitud (Aplicació)
L’aplicació obre una Work Order a l’Oficina EventHub amb:
- La fitxa de sol·licitud completa (descarregable a la guia d’onboarding).
- El detall complet del flux: recursos sol·licitats, configuració, productors i consumidors implicats.
- L’entorn (PRE/PRO) i la finestra desitjada.
⚠️ L’aplicació no obre CRQ sobre EventHub directament. La CRQ la tramita l’Oficina EventHub a partir de la Work Order.
Pas 2. Validació (Oficina EventHub)
L’Oficina EventHub valida:
- Correcció de la fitxa adjunta.
- Impacte tècnic i funcional sobre la plataforma.
- Necessitat de CRQ segons entorn i impacte.
- Disponibilitat de finestra de desplegament.
Resultat:
- ✅ Autoritzat sense CRQ (canvis sense impacte rellevant en INT o PRE).
- ✅ Autoritzat amb CRQ (l’Oficina la tramita).
- 🔄 Retornat a l’aplicació per ajustos.
Pas 3. CRQ (Oficina EventHub)
L’Oficina EventHub obre la CRQ a Remedy amb:
- Les tres tasques obligatòries (execució, validació, marxa enrera) segons la IO de Gestió de Canvis i la pàgina CRQ en operació.
- Categorització, classe, urgència i impacte segons el procediment d’obertura de CRQ.
- Coordinació amb Operacions i finestra acordada.
Pas 4. Desplegament
- On-premise: execució tècnica per CPD4.
- Cloud: execució tècnica per l’Oficina EventHub.
- Validació funcional post-desplegament per part de l’aplicació sol·licitant.
- Tancament formal de la CRQ per part del Change Coordinator de l’Oficina.
7. Responsabilitats durant el desplegament
Aplicació / Projecte
- Obrir la Work Order amb antelació i informació completa.
- No obrir CRQ sobre EventHub directament.
- Validar funcionalment després del desplegament (tasca de validació funcional de la CRQ).
- Estar disponible durant la finestra de desplegament.
Oficina EventHub
- Validar la Work Order rebuda de l’aplicació.
- Obrir i tramitar la CRQ a Remedy segons IO de Gestió de Canvis.
- Coordinar el desplegament (Change Coordinator).
- Executar tècnicament el desplegament en entorns cloud.
- Garantir alineació amb el govern.
CPD4 (Operacions on-prem)
- Executar el desplegament tècnic en entorns on-premise.
- Garantir estabilitat i traçabilitat.
- Aplicar plans de rollback si cal.
8. Baixes i desplegaments destructius
Es consideren canvis destructius:
- Eliminació de topics.
- Baixa de connectors.
- Retirada de stream processing.
- Eliminació de replicacions.
Regles:
- Sempre requereixen validació prèvia.
- Sempre requereixen CRQ en PRO.
- Ha d’existir confirmació formal de no ús.
9. Errors habituals (evita’ls)
- Pensar que «és només un canvi tècnic».
- Arribar tard a una finestra de desplegament.
- No informar de l’impacte funcional.
- Canviar recursos compartits sense validació.
- Intentar desplegar en PRO sense CRQ.
10. Documentació de referència
- Fluxos operatius i cicle de vida complet dels recursos EventHub
- Govern dels recursos d’EventHub.
- Procediment corporatiu de CRQ.
- Plantillas_Solicitud_EventHub
Següent pas recomanat: consultar la pàgina específica del recurs (Topics, Schemas, Connectors, etc.) per veure com aplicar la CRQ en cada cas.