Com utilitzar EventHub (onboarding)

Navegació

⬅️ Plataforma Eventhub	➡️ Com omplir la plantilla

---

Com utilitzar EventHub (onboarding)

Canigó – Guia d’onboarding per a aplicacions

Aquesta pàgina és el punt d’entrada únic per a aplicacions que volen integrar‑se o utilitzar EventHub.

---

📥 Plantilla de sol·licitud

Tot comença amb la plantilla. Primer descarrega-la i omple-la completament, després obre el tiquet JIRA adjuntant-la.

Descarregar Plantillas_Solicitud

-> Com omplir la plantilla pas a pas

⚠️ No obriu el tiquet JIRA fins que la plantilla no estigui completament omplerta. Sol·licituds sense plantilla adjunta seran retornades.

---

0. Preguntes prèvies a l’onboarding

Abans de començar, resol les següents preguntes per determinar què necessites:

Client Kafka

• L’aplicació ja té un client Kafka?
  • Sí → es pot reutilitzar si és la mateixa aplicació en el mateix entorn.
  • No → cal crear-ne un de nou.
• Cada aplicació ha de tenir el seu propi client Kafka.
  • No es permet compartir credencials entre aplicacions diferents.
  • Si tens dubtes sobre si pots reutilitzar un client existent del teu departament, consulta primer amb l’Oficina EventHub abans d’omplir la fitxa.
• Necessites client cloud, onpremise o ambdós?
  • Segons la ubicació de la teva aplicació i dels consumidors/productors.
  • Si operes en múltiples plataformes → una fila per plataforma a la fitxa.

Connectivitat

• On s’executa la teva aplicació?
  • Onpremise (CPD) → connectivitat estàndard.
  • AWS → cal configurar Route53. Consulta Connectivitat Cloud.
  • Azure → cal configurar Private DNS Zone. Consulta Connectivitat Cloud.

Connectors

• Necessites connectors (integració amb BBDD o sistemes externs)?
  • No → passa al punt següent.
  • Sí → has de proporcionar:
    • Localització de la BBDD (cloud, CPD, etc.).
    • Definició d’on es desplega cada connector (onpremise si la BBDD és onpremise; cloud si és cloud).
    • Obertura de comunicacions: si la BBDD és al CPD, l’Oficina sol·licita les IPs; si és cloud, ho fa l’aplicació.

Esquemes

• Els teus esdeveniments tenen estructura definida?
  • Sí → necessitaràs schemas (JSON, AVRO o PROTOBUF).
  • No → no cal schema, però es recomana per a integracions estables.

Volumetria

• Quina volumetria esperada tens? (necessari per dimensionar)
  • Volum mitjà en MB/s.
  • Pic en MB/s i quan es produeix.
  • Mida mitjana dels missatges (key i value).

---

1. Què vols fer?

Publicar o consumir esdeveniments

-> Consulta:

• Ús de Topics
• Ús de Schemas
• Ús de Clients Kafka
• Seguretat a EventHub

---

Integrar‑te amb sistemes externs

-> Consulta:

• Ús de Connectors
• Ús de Clients Kafka

---

Processar esdeveniments en temps real

-> Consulta:

• Ús de Stream Processing (ksqlDB / Flink)
• Ús de Topics

---

Replicar dades entre clústers

-> Consulta:

• Ús de Cluster Linking (opció preferent)
• Ús de Replicator (només casos excepcionals)

---

2. Flux típic d’una aplicació

 1. Resoldre preguntes prèvies (secció 0)
        │
 2. Descarregar i omplir la plantilla Excel
        │    ← Primer ompliu la plantilla completament
        │
 3. Obrir tiquet JIRA ACOEVENT adjuntant la plantilla omplerta
        │    ← Adjunteu sempre la plantilla al tiquet
        │
 4. Validació per l'Oficina EventHub
        │
 5. Gestionar recursos via autoservei (GEH) en INT / PRE
        │    (En INT no cal CRQ: l'eina d'autoservei desplega els recursos
        │     directament en on-premise sense tràmit formal de canvi)
        │
 6. Checklist de producció
        │
 7. CRQ en PRE/PRO (quan apliqui)
        │
 8. Desplegament i operació

---

3. Com accedir a JIRA ACOEVENT

1. Accedir al JIRA CSTD: https://cstd.ctti.gencat.cat/jiracstd/
2. Si no tens accés, demanar-lo mitjançant una petició REMEDY de tipus “Gestió accés d’usuaris”, seleccionant “Alta” i l’aplicació “JIRA CSTD”, indicant DNI i sol·licitant permisos per al servei ACOEVENT.
3. Un cop amb accés, crear un tiquet al projecte ACOEVENT i adjuntar la plantilla omplerta.

📋 Si no tens accés a REMEDY: contacta amb el teu Gestor de Solucions o GSIN de CTTI del teu àmbit per sol·licitar-ho.

---

4. Quins documents utilitzar segons el cas

Necessitat	Document
Publicar esdeveniments	Ús de Topics
Definir contracte de dades	Ús de Schemas
Permisos i accessos	Ús de Clients Kafka
Seguretat i OAuth	Seguretat a EventHub
Integracions externes	Ús de Connectors
Processament en temps real	Ús de Stream Processing
Replicació entre clústers	Cluster Linking / Replicator
Permisos creuats	Permisos Cross
Canvis i producció	CRQ i Desplegament
Estàndards	Criteris i validació
Com omplir la plantilla	Guia pas a pas
Connectivitat cloud	AWS i Azure
Troubleshooting connectors	Resolució incidències

---

5. Artefactes de codi

• Productor / Consumidor Kafka
• KStreams
• KTable

---

6. Regles importants

• No hi ha recursos sense fitxa.
• No hi ha producció sense validació.
• No hi ha canvis rellevants sense CRQ en PRO.
• L’Oficina EventHub valida tots els recursos.

---

📞 Suport: Per dubtes, contacta amb l’Oficina EventHub a eventhub.ctti@gencat.cat.