ContacteQuè canvia per a projectes existents
Navegació
| ⬅️ Com omplir la plantilla | ➡️ Ús de Topics |
|---|
Què canvia per a projectes existents
Canigó – Guia de transició
Aquesta pàgina està dirigida a equips que ja utilitzen EventHub i necessiten entendre què canvia amb la publicació del nou model de govern.
Resum executiu
| Àmbit | Canvia? | Impacte |
|---|---|---|
| Recursos ja en producció (topics, schemas, clients, connectors) | No | Els recursos existents es mantenen tal com estan. No cal re-sol·licitar-los. |
| Naming de topics existents | No | Els topics actuals conserven el seu nom. El nou patró aplica només a nous recursos. |
| Plantilla de sol·licitud | Sí | Hi ha una nova versió (V2.5) amb camps nous, auto-generació de noms i herència de dades. |
| Procés de sol·licitud | Sí | El flux formal (plantilla + JIRA + validació) és obligatori per a tots els nous recursos. |
| Convencions de naming | Sí, per a nous recursos | Nou patró: {codigo}-{descripcion}[-entorn] amb guions. |
| Valors per defecte governats | Sí | Particions, RF, Min ISR, retention, cleanup, compressió ara tenen valors estàndard. |
| Autoservei (GEH) | Sí | Nova eina d’autoservei per a INT i PRE, amb validació prèvia de l’Oficina. |
| Permisos creuats | Sí | Nou mecanisme formal per sol·licitar accés a topics d’altres projectes. |
1. Els meus recursos actuals NO canvien
Aquesta és la regla més important.
- Els topics, schemas, clients Kafka i connectors ja desplegats en INT, PRE o PRO es mantenen sense cap modificació.
- No cal re-sol·licitar-los ni actualitzar-ne la configuració.
- El naming actual dels teus recursos es respecta (encara que no segueixi el nou patró).
- Els permisos existents es mantenen.
Quan aplica el nou model: quan sol·licitis nous recursos o facis canvis rellevants sobre recursos existents (ampliar particions, canviar retention, nous permisos, etc.).
2. Nova plantilla de sol·licitud
La plantilla antiga queda obsoleta. A partir d’ara, totes les sol·licituds han d’utilitzar esta:
Què ha canviat respecte a la plantilla anterior
| Àmbit | Abans | Ara (Nova) |
|---|---|---|
| Dades comunes | Es repetien en cada fila de cada pestanya | S’omplen una vegada a Datos_Proyecto i es propaguen automàticament |
| Naming de topics | L’aplicació escrivia el nom a mà | Es genera automàticament: {codigo}-{descripcion}[-entorn] |
| Naming de clients Kafka | L’aplicació escrivia el nom complet | Es genera automàticament: {codigo}-{identificador_corto} |
| Naming de schemas | L’aplicació escrivia el nom | Es genera automàticament: {topic}-value |
| Client Kafka: camps | Descripcion_Uso, Tipo_Cliente, Prefijo_Topics, Prefijo_ConsumerGroup, Tipo_Autenticacion | Eliminats. Ara: Identificador_Corto, Plataforma_Cluster, Topics_Asociados |
| Autenticació | Es podia escollir | Sempre OAuth (no es sol·licita) |
| Connector: tipus CDC | Existia com a tipus de connector | Eliminat. Ara: Tipo=Source/Sink + camp Es_CDC=SI/NO |
| Volumetria | En msg/s | En MB/s (totes les pestanyes) |
| Particions, RF, Min ISR | L’aplicació podia proposar | Fixats per l’Oficina (3/2/1, RF=3, Min ISR=2). Prellenats. |
| Retention | L’aplicació proposava | Valor per defecte 7 dies. Excepció justificada si >7. |
| Stream Processing: Exactly_Once | Camp a la fitxa | Eliminat (no es pot validar a aquest nivell) |
| Permisos creuats | No hi havia mecanisme | Nova pestanya Permisos_Cross |
| Validacions automàtiques | Limitades | Validació de Codigo_Aplicacion (format), camps obligatoris, revisió tècnica automàtica |
| Protecció | Sense protecció | Columnes Oficina i Control protegides (pwd gestionada per l’Oficina) |
Mapatge ràpid: “abans omplia X, ara omple Y”
Client Kafka:
| Abans | Ara |
|---|---|
| Nombre_Cliente_Kafka (text lliure) | Identificador_Corto → nom auto-generat |
| Tipo_Cliente | Eliminat |
| Prefijo_Topics_Autorizado | Eliminat (es deriva del nom del client) |
| Prefijo_ConsumerGroup | Eliminat (es deriva del nom del client) |
| Tipo_Autenticacion | Eliminat (sempre OAuth) |
| Acceso_MultiEntorno | Plataforma_Cluster (una fila per plataforma) |
| — | Topics_Asociados (nou, informatiu) |
Topic:
| Abans | Ara |
|---|---|
| Nombre_del_Topic (text lliure) | Descripcion_Topic → nom auto-generat |
| Volumen_Estimado (msg/s) | Volumen_MBs (MB/s) |
| Pico_Estimado (msg/s) | Pico_MBs (MB/s) |
| Particiones_Propuestas | Eliminat (fixades per l’Oficina) |
| RF_Propuesto | Eliminat (fix: 3) |
| Min_ISR_Propuesto | Eliminat (fix: 2) |
| — | Tamano_Medio_Key_Bytes (nou) |
| — | Cuando_Pico (nou) |
| — | Requiere_Schema + Schema_Asociado (nou) |
| — | Requiere_DLQ (nou) |
| — | Consumidores_Conocidos (nou) |
Connector:
| Abans | Ara |
|---|---|
| Tipo: Source / Sink / CDC | Tipo: Source / Sink + Es_CDC: SI/NO |
| Volumen_Estimado (msg/s) | Volumen_Estimado_MBs (MB/s) |
| — | Tamano_Medio_Msg_Bytes (nou) |
| — | Frecuencia (nou) |
Stream Processing:
| Abans | Ara |
|---|---|
| Exactly_Once | Eliminat |
| Volumen_Estimado (msg/s) | Volumen_Estimado_MBs (MB/s) |
| — | Topics_Intermedios (nou) |
| — | Tamano_Medio_Msg_Bytes (nou) |
3. Noves convencions de naming
Convivència de patrons
| Situació | Patró aplicable |
|---|---|
| Topic ja existent | Conserva el nom actual (no es renombra) |
| Topic nou | Obligatori el nou patró: {codigo}-{descripcion}[-entorn] |
| Canvi sobre topic existent | Conserva el nom actual |
Nou patró de naming
| Recurs | Format | Exemple |
|---|---|---|
| Topic (INT) | {codigo}-{descripcion}-int |
a1234-alta-client-int |
| Topic (PRE) | {codigo}-{descripcion}-pre |
a1234-alta-client-pre |
| Topic (PRO) | {codigo}-{descripcion} |
a1234-alta-client |
| Client Kafka | {codigo}-{identificador} |
a1234-crm |
| Schema | {topic}-value o {topic}-key |
a1234-alta-client-pre-value |
| Consumer Group | {client}-cg-{us} |
a1234-crm-cg-backoffice |
Regles: minúscules, guions, sense espais ni accents, màxim 90 caràcters.
4. Valors per defecte governats
Aquests valors ara estan estandarditzats. Si el teu projecte existent ja utilitza valors diferents, no es modifiquen. Per a nous recursos, apliquen per defecte:
| Paràmetre | Valor estàndard | Excepció requereix |
|---|---|---|
| Particions | 3 (PRO), 2 (PRE), 1 (INT) | Justificació + revisió tècnica |
| Replication Factor | 3 | No modificable |
| Min In-Sync Replicas | 2 | No modificable |
| Cleanup Policy | delete | Justificació |
| Compression | producer (recomanat Zstd) | Justificació |
| Retention | 7 dies | Justificació si >7 dies |
| Max Message Bytes | 1 MB (1048576) | Justificació si >1 MB |
| Schema Validation | No | — |
| Autenticació | OAuth (sempre) | No modificable |
5. Autoservei governat (GEH)
Nova eina web per gestionar recursos en entorns INT i PRE.
Punts clau per a projectes existents:
- GEH no substitueix JIRA ni CRQ. És un complement.
- Primer es valida la integració (JIRA + plantilla), després es pot usar GEH per executar.
- Els recursos existents es poden gestionar via GEH si l’Oficina ho autoritza.
- PRO segueix requerint CRQ com fins ara.
6. Permisos creuats (nou)
Si el teu projecte necessita accedir a topics d’altres projectes, ara existeix un mecanisme formal:
- Pestanya Permisos_Cross a la plantilla Excel.
- Indica el topic, el projecte propietari i el tipus d’accés (READ/WRITE).
- L’Oficina coordina l’aprovació amb l’altre projecte.
Si ja tens permisos creuats configurats, es mantenen. El mecanisme aplica a noves sol·licituds.
7. Què he de fer ara?
Si no tinc cap canvi pendent
Res. Els teus recursos segueixen funcionant. Pren nota de la nova plantilla per quan la necessitis.
Si tinc nous recursos per sol·licitar
- Descarrega la plantilla V2.5.
- Segueix la guia per omplir la plantilla.
- Obre un tiquet JIRA ACOEVENT.
Si tinc canvis sobre recursos existents
- Descarrega la plantilla V2.5.
- Omple Datos_Proyecto i la fitxa del recurs a modificar.
- A Justificacion_Excepcion, indica que és un canvi sobre un recurs existent.
- Obre tiquet JIRA ACOEVENT.
Preguntes freqüents
He de migrar els meus topics al nou naming? No. Els topics existents conserven el seu nom. El nou patró aplica només a nous recursos.
La meva plantilla antiga encara serveix? No. A partir d’ara, totes les sol·licituds han d’usar la V2.5. Les sol·licituds amb la plantilla antiga seran retornades.
Puc seguir usant msg/s per a la volumetria?
No. La nova plantilla utilitza MB/s per homogeneïtzar el dimensionament. Converteix: MB/s = (msg/s × mida_msg_bytes) / 1048576.
Tinc un connector CDC, he de canviar-lo? No. El connector existent segueix funcionant. Quan sol·licitis nous connectors, usa Tipo=Source + Es_CDC=SI.
Qui decideix les particions ara? L’Oficina EventHub, amb valors estàndard (3/2/1 per PRO/PRE/INT). Si necessites més, justifica a la fitxa.