Home

DevOps

POD - Intégration continue

Le processus d'intégration continue est géré par Gitlab CI (description du pipeline : .gitlab-ci.yml), il est composé de 6 étapes.

Etape	Tâches	Description	Executeur
build	build	Build l'application dans une image docker dédiée	push repository
alt_build	failsafe-build	Build de l'application si l'image docker de build n'existe pas	on build failed
alt_build	docker:ci	Création de l'image docker dédiée au build	on build failed
test	test	Génère un rapport de tests surefire	manuel
test	sonarqube	exécute une analyse sonarqube	manuel
release	release	release de l'application dans une image docker dédiée et déploiement du batch dans le package registry du projet	manuel
release	failsafe-release	release de l'application si l'image docker de build n'existe pas	manuel
release, gitlab-release	release	créé une release gitlab de l'application	tag
docker	docker:imagine	Création d'une image docker pour environnement de test	si build ok
docker	docker:production	Création d'une image docker pour environnement de production et isival Ifremer	si release ok
docs	pages	génération de la documentation publique sous forme de gitlab pages	push branche `master`

POD - Exécution du livrable

L'intégration continue génère un livrable sous la forme d'une image docker prête à être exécutée dans son environnement. Avant d’exécuter le livrable s'assurer que l'étape docker de l'intégration continue dédiée à son environnement s'est déroulée correctement.

Environnement de test IMAGiNE

Requiert tâche d'intégration continue : docker:imagine

N'importe quelle machine ayant Docker d'installé peut servir d’environnement de test mais pour facilité l’exécution du livrable un script qui permet de le récupérer et de l’exécuter est disponible sur la machine visi-common-docker1

ssh isi_exp@visi-common-docker1
cd /export/home/docker/duifremer/sih/imagine/
./start-pod.sh

Une fois le script exécuté le POD est accessible à l'adresse suivante visi-common-docker1.ifremer.fr:8080

Environnement de préproduction IMAGiNE (ISIVAL)

Requiert tâche d'intégration continue : docker:production

L’exécution du livrable dans l’environnement de préproduction est automatisée dans le projet gitlab ISIVAL.

Dans le menu Intégration et livraison continue cliquer sur le bouton Run pipeline.

Le pipeline d’intégration continue ISIVAL exécute des tâches automatiquement, une fois que celles si sont achevées il faut lancer manuellement la tâche deploy-imagine-pod.

Le POD sera ensuite accessible à l'adresse suivante : https://imagine-pod.isival.ifremer.fr

APP - Intégration continue

Le processus d'intégration continue est géré par Gitlab CI (description du pipeline : .gitlab-ci.yml), il est composé de 6 étapes.

Etape	Tâches	Description	Executeur
build	build	Build l'application dans une image docker dédiée	push repository
alt_build	failsafe-build	Build de l'application si l'image docker de build n'existe pas	on build failed
alt_build	docker:ci	Création de l'image docker dédiée au build	on build failed
test	test	TODO	manuel
release	release	TODO	manuel
release	failsafe-release	TODO	manuel
release, gitlab-release	release	TODO	tag
docker	docker:imagine	Création d'une image docker pour environnement de test	si build ok
docker	docker:production	Création d'une image docker pour environnement de production et isival Ifremer	si release ok
docs	pages	génération de la documentation publique sous forme de gitlab pages	push branche `master`

APP - Exécution du livrable

Environnement de test IMAGiNE

Requiert tâche d'intégration continue : docker:imagine

ssh isi_exp@visi-common-docker1
cd /export/home/docker/duifremer/sih/imagine/
./start-app.sh

Une fois le script exécuté le POD est accessible à l'adresse suivante visi-common-docker1.ifremer.fr:8081

Environnement de préproduction IMAGiNE (ISIVAL)

Requiert tâche d'intégration continue : docker:production

L’exécution du livrable dans l’environnement de préproduction est automatisée dans le projet gitlab ISIVAL.

Dans le menu Intégration et livraison continue cliquer sur le bouton Run pipeline.

Le pipeline d’intégration continue ISIVAL exécute des tâches automatiquement, une fois que celles si sont achevées il faut lancer manuellement la tâche deploy-imagine-app.

Le front IMAGiNE sera ensuite accessible à l'adresse suivante : https://imagine-app.isival.ifremer.fr/

Configuration Imagine APP

conf serveur imagine

ajouter ces 3 options spécifques pour pointer sur une base 'oracle':

Libellé du profil Administrateur : ALLEGRO_ADMINISTRATEUR
Libellé du profil Utilisateur : ALLEGRO_UTILISATEUR
Libellé du profil Superviseur : ALLEGRO_SUPER_UTILISATEUR

conf programme paramètres bio

conf hsqldb

conf serveur imagine hsqldb

conf programme paramètres bio hsqldb

Release note Imagine POD

Demande au guichet d'exploitation

Avant de déployer Imagine, les entités suivantes doivent être créées dans Harmonie. Pour les PMFM faire une demande au guichet d'exploitation.

<PROGRAM CODE="SIH-PARAM-BIO" NAME="Programme d'observation des paramètres biologiques" DESCRIPTION="Programme d'observation des paramètres biologiques" STATUS_FK="1" GEAR_CLASSIFICATION_FK="1" TAXON_GROUP_TYPE_FK="2"/>
<PROGRAM2LOCATION_CLASSIF PROGRAM_FK="SIH-PARAM-BIO" LOCATION_CLASSIFICATION_FK="2"/>

<PARAMETER LABEL="MORSE_CODE" NAME="Code Morse" IS_QUALITATIVE="0" IS_ALPHANUMERIC="1" STATUS_FK="1"/>
<PARAMETER LABEL="STRATEGY_LABEL" NAME="Stratégie" IS_QUALITATIVE="0" IS_ALPHANUMERIC="1" STATUS_FK="1"/>

<PMFM PARAMETER_FK="MORSE_CODE" LABEL="MORSE_CODE" MATRIX_FK="21" FRACTION_FK="1" METHOD_FK="3" UNIT_FK="4" STATUS_FK="1"/>
<PMFM PARAMETER_FK="STRATEGY_LABEL" LABEL="STRATEGY_LABEL" MATRIX_FK="21" FRACTION_FK="1" METHOD_FK="3" UNIT_FK="4" STATUS_FK="1"/>

Traduction des requête au format Oracle :

insert into PROGRAM (CODE,NAME,DESCRIPTION,STATUS_FK,GEAR_CLASSIFICATION_FK,TAXON_GROUP_TYPE_FK) values ('SIH-PARAM-BIO','Programme d observation des paramètres biologiques','Programme d observation des paramètres biologiques',1,2);
insert into PROGRAM2LOCATION_CLASSIF (PROGRAM_FK,LOCATION_CLASSIFICATION_FK) values ('SIH-PARAM-BIO',2);

insert into PARAMETER (CODE,NAME,IS_QUALITATIVE,IS_TAXINOMIC,IS_CALCULATED,IS_ALPHANUMERIC,PARAMETER_GROUP_FK,STATUS_FK,CREATION_DATE) values ('MORSE_CODE','Code Morse',0,0,0,1,1,1,sysdate);
insert into PARAMETER (CODE,NAME,IS_QUALITATIVE,IS_TAXINOMIC,IS_CALCULATED,IS_ALPHANUMERIC,PARAMETER_GROUP_FK,STATUS_FK,CREATION_DATE) values ('STRATEGY_LABEL','Stratégie',0,0,0,1,1,1,sysdate);

insert into PMFM (PARAMETER_FK,LABEL,MATRIX_FK,FRACTION_FK,METHOD_FK,UNIT_FK,AGGREGATION_LEVEL_FK,STATUS_FK,CREATION_DATE) values ('MORSE_CODE','MORSE_CODE',21,1,3,4,1,1,sysdate);
insert into PMFM (PARAMETER_FK,LABEL,MATRIX_FK,FRACTION_FK,METHOD_FK,UNIT_FK,AGGREGATION_LEVEL_FK,STATUS_FK,CREATION_DATE) values ('STRATEGY_LABEL','STRATEGY_LABEL',21,1,3,4,1,1,sysdate);

Configuration du serveur

Il faut ensuite surcharger les identifiants des PMFM utilisés par Imagine, le mieux est de le faire depuis l'IHM de l'application en étant connecté en tant qu'administrateur, menu Configuration du serveur.

Sinon il est également possible de faire directement les insertions en base en prenant bien garde à renseigner l'ID correspondant dans la base de données pour le champ NAME.

INSERT INTO SOFTWARE_PROPERTY(ID, LABEL, NAME, CREATION_DATE, UPDATE_DATE, SOFTWARE_FK, STATUS_FK)
SELECT SOFTWARE_PROPERTY_SEQ.nextval, 'sumaris.enumeration.pmfm.AGE.id', '2269', sysdate, systimestamp, S.ID, '1'
FROM SOFTWARE S WHERE S.LABEL = 'IMAGiNE';
      
INSERT INTO SOFTWARE_PROPERTY(ID, LABEL, NAME, CREATION_DATE, UPDATE_DATE, SOFTWARE_FK, STATUS_FK)
SELECT SOFTWARE_PROPERTY_SEQ.nextval, 'sumaris.enumeration.pmfm.SEX.id', '196', sysdate, systimestamp, S.ID, '1'
FROM SOFTWARE S WHERE S.LABEL = 'IMAGiNE';
      
INSERT INTO SOFTWARE_PROPERTY(ID, LABEL, NAME, CREATION_DATE, UPDATE_DATE, SOFTWARE_FK, STATUS_FK)
SELECT SOFTWARE_PROPERTY_SEQ.nextval, 'sumaris.enumeration.pmfm.MORSE_CODE.id', '358', sysdate, systimestamp, S.ID, '1'
FROM SOFTWARE S WHERE S.LABEL = 'IMAGiNE';
      
INSERT INTO SOFTWARE_PROPERTY(ID, LABEL, NAME, CREATION_DATE, UPDATE_DATE, SOFTWARE_FK, STATUS_FK)
SELECT SOFTWARE_PROPERTY_SEQ.nextval, 'sumaris.enumeration.pmfm.STRATEGY_LABEL.id', '359', sysdate, systimestamp, S.ID, '1'
FROM SOFTWARE S WHERE S.LABEL = 'IMAGiNE';