Canigó. Integració amb SIC 2.0

11-12-2017

Les aplicacions Canigó poden ser fàcilment integrables al SIC (Servei d’Integració Contínua), tant per la seva custodia de codi al Git, com per la seva construcció i desplegament amb Jenkins. Des del CS Canigó s’ha redactat aquest HowTo on s’explica pas a pas com fer aquesta integració.

A mode de resum, els principals aspectes a tenir en compte són els següents:

Per la custodia de codi al Git…
- Cal dispossar de permissos en el projecte per el qual es vol custodiar el codi. Més informació respecte a l’Autoservei d’usuaris al Gitlab al següent enllaç
- Cal connectar l’aplicació Canigó local amb el projecte del Gitlab i pujar els canvis sempre a la branca principal (master). Recordar que el Git del SIC no és un repositori de desenvolupament, només s’hauran de pujar els canvis quan es tingui una versió “releaseable” de l’aplicació
- Cal configurar l’aplicació per a que ignori la carpeta amb el resultat de la construcció (Ex. /target), meta-dades de l’Eclipse o IDE utilitzat, i binaris que puguin haver-hi en el codi del projecte. Aquests binaris que formen part de l’aplicació han d’ubicar-se al Repositori de Binaris del SIC
Per la construcció i desplegament amb una pipeline al Jenkins…
- Cal configurar el procés de construcció Maven per a que auto-configuri la versió de l’aplicació al descriptor “sic.yml” que ha d’ubicar-se a "<app-canigo>/sic/sic.yml" (Més detall en el HowTo).
  
  sic.yml
```
version: 1.0.0
...
```
  A la propera versió de Canigó que s’alliberi, aquesta configuració Maven ja vindrà pre-establerta. Podeu trobar més detal del fucionament de descriptor “sic.yml” al punt 3.3.3 del Manual d’Usuari del SIC
- En cas que el frontend de l’aplicació es desenvolupi en un projecte apart del de backend i es desplegui també de forma independent (opció recomanada), cal també incorporar aquest descriptor "<frontend>/sic/sic.yml" i idealment automatitzar la seva generació
- Cal especificar a l’equip del SIC les passes per la construcció i desplegament de l’aplicació per a que configurin la pipeline al Jenkins. En el cas del backend Canigó, normalment l’empaquetat estàndard Maven, i per la part de frontend dependrà molt de la tecnologia utilitzada (Angular, React, …) les quals utilitzaran gestors de paquets com npm. Aquesta petició de suport s’ha de fer via Remedy al servei “FRAMEWORK SIC”

Per qualsevol dubte relatiu a la integració al SIC d’aplicacions Canigó, us podeu posar en contacte amb el CS Canigó enviant un correu a oficina-tecnica.canigo.ctti@gencat.cat o bé fent-nos arribar una petició de consulta/suport al CSTD.