ContacteÚs de Replicator a EventHub
Navegació
| ⬅️ Ús de Cluster Linking | ➡️ Principis d’Autoservei |
|---|
Ús de Replicator a EventHub
Canigó – Guia per a aplicacions
Aquesta pàgina explica quan i com utilitzar Replicator per a la replicació entre clústers Kafka a EventHub.
⚠️ Replicator és un mecanisme excepcional.
S’ha d’utilitzar només quan Cluster Linking no sigui viable i sempre amb justificació tècnica i funcional explícita.
1. Quan necessites Replicator?
Necessites Replicator únicament si:
- Cluster Linking no és tècnicament viable.
- El cas d’ús requereix processament actiu durant la replicació.
- Existeixen limitacions de versió, arquitectura o compatibilitat.
- L’escenari no es pot resoldre amb replicació passiva.
❌ No utilitzis Replicator si:
- Cluster Linking cobreix el cas d’ús.
- La replicació és estructural i contínua sense lògica addicional.
- L’ús és exploratori o temporal sense cas d’ús formal.
2. Diferències clau: Replicator vs Cluster Linking
Cluster Linking
- Replicació passiva.
- Menor impacte operatiu.
- Mecanisme preferent.
Replicator
- Replicació activa mitjançant Kafka Connect.
- Consumeix recursos de Connect.
- Introdueix més complexitat operativa.
- Ús excepcional.
3. Alta de Replicator: què has de fer
Pas 1. Justificar per què NO utilitzar Cluster Linking
Has de documentar explícitament:
- Per què Cluster Linking no és viable.
- Quina necessitat cobreix Replicator.
- Quin valor addicional aporta.
⚠️ Sense aquesta justificació no es valida la sol·licitud.
Pas 2. Definir el cas d’ús
Has d’identificar:
- Clúster origen.
- Clúster destí.
- Topics a replicar.
- Sentit de la replicació.
- Volum i criticitat.
- Impacte operatiu esperat.
Pas 3. Omplir la Fitxa de Connector (obligatori)
Replicator es governa com un Connector Kafka Connect.
- Plantillas_Solicitud_EventHub
- Una fila per Replicator.
- Camps clau:
- Tipus de connector:
Replicator. - Clúster origen i destí.
- Topics replicats.
- Justificació d’ús davant de Cluster Linking.
- Volum estimat.
- Criticitat.
- Owners funcional i tècnic.
- Tipus de connector:
Sense la fitxa correctament omplerta no es valida la sol·licitud.
Pas 4. Obrir la sol·licitud
- Crear tiquet JIRA.
- Adjuntar la fitxa omplerta.
- Adjuntar la justificació explícita de l’ús de Replicator.
Pas 5. Validació
L’Oficina EventHub valida:
- Que Cluster Linking s’hagi avaluat prèviament.
- Justificació tècnica i funcional.
- Topics governats i actius.
- Impacte operatiu i consum de recursos.
- Gestió d’errors i reintents.
Resultat:
- ✅ Aprovat → s’autoritza el Replicator.
- 🔄 Retornat → cal ajustar la proposta.
Pas 6. Desplegament del Replicator
- Replicator es desplega com a Kafka Connector.
- INT: desplegament controlat.
- PRE / PRO: desplegament mitjançant CRQ.
- Execució tècnica per Operacions o Oficina EventHub, segons l’entorn.
4. Què decideix la plataforma (no l’aplicació)
La plataforma defineix:
- Configuració tècnica final del Replicator.
- Recursos assignats al connector.
- Estratègia de reintents i errors.
- Necessitat de CRQ i finestra de desplegament.
- Monitorització i control operatiu.
5. Canvis sobre Replicator
Es consideren canvis:
- Afegir o retirar topics replicats.
- Canviar clústers origen o destí.
- Canviar la configuració del connector.
- Canviar volum o freqüència.
Què cal fer:
- Actualitzar la fitxa.
- Obrir tiquet JIRA.
- Tramitar CRQ si aplica (obligatòria en PRE/PRO).
6. Retirada de Replicator
- Confirmació formal de no ús.
- Anàlisi d’impacte.
- Aturada i eliminació controlada del connector.
- CRQ en PRO quan apliqui.
La retirada no implica l’eliminació dels topics originals.
7. Errors habituals (evita’ls)
- Utilitzar Replicator sense avaluar Cluster Linking.
- No justificar l’ús excepcional.
- Subestimar l’impacte operatiu.
- Replicar topics no governats.
- Canviar configuració en producció sense CRQ.
8. Documentació de referència
- Govern dels recursos d’EventHub
- Fluxos operatius i cicle de vida complet dels recursos EventHub
- Plantillas_Solicitud_EventHub
Nota important:
Replicator s’ha de considerar l’última opció. Sempre que sigui possible, s’ha de prioritzar Cluster Linking.