Documentació. Arquitectura CTTI. Generalitat de Catalunya

Introducció

L’entorn de desenvolupament és una màquina virtual Linux, basada en Lubuntu Desktop (Ubuntu Bionic Beaver 18.04.2 LTS) per ser una distribució d’escriptori Linux lleugera, derivada d’una de les distribucions més esteses del món (Ubuntu / Debian) i amb suport LTS, a la qual se li ha afegit una selecció de programari enfocat principalment a aplicacions Canigó.

Objectius

Els objectius perseguits per l’entorn de desenvolupament són:

Facilitar la posada en marxa de l’entorn de desenvolupament, aprovisionant una màquina virtual amb tot el necessari per a començar el desenvolupament d’una aplicació Canigó.
Simular els entorns de desplegament als CPD Generalitat, facilitant contenidors amb les mateixes versions i configuracions dels PaaS que ens trobarem als clouds.

Addicionalment aquesta versió de l’entorn de desenvolupament no només s’ha actualitzat amb les últimes versions estables del programari, sino que s’ha fet que estigui alineada amb l’última versió de Canigó 3.4 per proporcionar la millor experiència d’usuari out-of-the-box en el desenvolupament d’aplicacions Canigó.

Prerequisits

Per poder treballar amb l’entorn de desenvolupament s’ha d’instal·lar prèviament el següent programari:

Virtualbox
Vagrant
Vagranfile amb la configuració de l’entorn Canigó

Per a poder utilitzar l’entorn de desenvolupament és necessari:

120 GB de disc dur lliure
6 GB de memòria ram lliure
32 MB de memòria de video lliure

Instal·lació

La versió 3.0.0 ha simplificat i automatitzat la configuració inicial fins al punt de no haver de fer cap acció especial per part de l’usuari (vegeu apartat KNOWN ISSUES de la versió).

Descarregar la configuració del vagrant amb la següent comanda
```
 git clone https://github.com/gencat/dev-environment.git
```
Anar al directori dev-environment/Vagrant i arrencar l’entorn amb
```
 vagrant up
```
Amb aquesta última instrucció, vagrant aixeca una màquina virtual a Virtualbox, i executa les comandes que inclogui el fitxer Vagrantfile. El temps d’instal·lació pot variar entre 25 i 90 minuts, pel fet que ha de descarregar i instal·lar tot el software necessari.

En el moment que a la màquina virtual aixecada es vegi l’escriptori, el procés haurà finalitzat.

Notes addicionals

Tot i que es pot engegar i aturar la màquina virtual a través de VirtualBox, es recomana utilitzar les comandes vagrant up i vagrant halt per fer aquestes accions.
Es recomana no realitzar cap actualització ni de versió de sistema operatiu ni d’eines a l’entorn sense prèvia consulta a l’equip del CS Canigó.
Hosts Windows/Mac: En el cas que hi hagi problemes de codificació en el moment d’arrencar l’entorn, es pot deure al fet que els fitxers de text (p.e. provision.sh) s’han adaptat automàticament als caràcters EOL del host. En aquest cas s’ha d’indicar a GIT que no faci aquesta adaptació automàtica (respectant el contingut original), amb les següents dues comandes i tornant a instal·lar de zero l’entorn (git clone + vagrant up).
```
  git config --global core.autocrlf false
  vagrant destroy -f
```

Software base

El software base s’ha instal·lat un conjunt de programari per a les tasques complementàries de desenvolupament. Aquest software addicional s’ha instal·lat dins el directori /opt

Open JDK 8 (1.8.0_191)
Visual VM 1.3
Clients per diferents BBDD (Mysql, PostgreSQL, MongoDB i Redis)
Navegador Mozilla FireFox Quantum (66.0.3)
Client VPNC per accés a XCAT
Navegador Google Chrome (73.0.3683.103)
Engine Docker i Docker Compose Tool per l’execució de contenidors Docker
Servidor Apache HTTP (2.4)

Software addicional

A banda del software base s’ha instal·lat i configurat un conjunt de programari addicional dins el directori /opt, amb les versions alineades al full de ruta del programari.

Open JDK 11 (11.0.2 : OpenJDK 64-Bit Server VM 18.9)
LanguageTool 5.3 - Per revisar gramàtica, ortografia i formes correctes del català.
DBeaver 6.0.2 - Eina multi-paradigma (SQL, No-SQL, etc.) per a BBDD.
SoapUI 5.5.0 - Eina per treballar amb serveis SOAP i REST.
jMeter 5.1.1 - Eina per fer validacions funcionals, proves de càrrega i mesures de rendiment d’aplicacions.
NodeJS - Servidor d’aplicacions JS. Les versions instal·lades són 8.15.1 i 10.15.3.
Visual Studio Code - Editor altament extensible (mitjançant plugins). Recomanable principalment per a treballar amb tecnologies frontend (AngularJS, Javascript, Typescript, etc.)
Maven 3.5.3
IDE - Spring Tool Suite 4.2.0 (basat en Eclipse 2019/03), i els següents plugins:
- Plugin CTTI Canigó per creació aplicacions Canigó 3.4 basades en arquitectura REST+HTML5/JS.
- Spring Tool Suite per facilitar el desenvolupament d’aplicacions basades en Spring.
- SonarLint permet detectar i solucionar problemes de qualitat al codi (actualment Java, JavaScript, Python i PHP) SonarLint.
jEdit 5.5.0 - Editor de textos (més lleuger que VS Code) basat en Java. Recomanable per a l’edició de fitxers grans (logs).