Skip to content

Commit

Permalink
Merge remote-tracking branch 'remotes/gitlab/doc_31073'
Browse files Browse the repository at this point in the history
# Conflicts:
#	README.md
#	pom.xml
#	src/main/resources/jks/prod/samlKeystore.jks
#	src/main/resources/jks/test/samlKeystore.jks
#	src/main/resources/keytool.properties
  • Loading branch information
Fabio Di Lorenzo committed May 29, 2024
2 parents 22ef796 + 240fe6b commit ff047e8
Show file tree
Hide file tree
Showing 101 changed files with 430 additions and 8,325 deletions.
18 changes: 18 additions & 0 deletions .gitlab-ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# template base
include:
- project: 'parer/pipeline-template'
ref: v1.0
file:
- '/templates/dind/Default.gitlab-ci.yml'
- '/templates/dind/Package.gitlab-ci.yml'
- '/templates/dind/Release.gitlab-ci.yml'
- '/templates/dind/Docs.gitlab-ci.yml'
- '/templates/dind/Update.gitlab-ci.yml'
- '/templates/dind/Badge.gitlab-ci.yml'

stages:
- package
- docs
- release
- update
- badge
14 changes: 5 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,31 +5,27 @@ Fonte template redazione documento: https://www.makeareadme.com/.

# Descrizione

Progetto relativo alle generazione delle cofigurazioni standard suddivise per ambiente ed installazione dell'applicazione DPI (Digital Preservation Interface).<br/><br/>
Progetto relativo alle generazione delle cofigurazioni standard suddivise per ambiente ed installazione dell'applicazione **DPI**. <br/><br/>

# Installazione

??? TODO

# Utilizzo


Il seguente progetto viene creato per esternalizzare le configurazioni, per singolo ambiente, dell'applicazione DPI, nello specifico il progetto viene creato a partire dalla configurazioni alla versione **2.6.0** del DPI che sono quindi le ultime ad essere presenti all'interno dell'applicativo stesso.

## Guida alle configurazioni

Nella directory [conf](conf), vengono generate automaticamente dal modello CI/CD, le configurazioni per le diverenze installazioni di DPI per ogni ambiente, che saranno predisposte opportunamente secondo [guida ufficiale](https://parermine.regione.emilia-romagna.it/projects/parer/wiki/DPI_installazione_tomcat9).
Nella directory `conf`, vengono generate automaticamente dal modello CI/CD, le configurazioni per le diverse installazioni di DPI per ogni ambiente, che saranno predisposte opportunamente secondo le istruzioni presenti nel README ufficiale del progetto DPI.

## Versionamento dpi-config e dpi

Il versionamento del progetto **dpi-config** segue direttamente quello dell'applicazione [DPI](https://gitlab.ente.regione.emr.it/parer/dpi), ossia, ad ogni nuovo versionamento di quest'ultimo seguirà anche il versionamento di questo progetto (esempio se creata la versione 3.0.0 di dpi si dovrà anche creare la relativa versione di dpi-config 3.0.0 indipendentemente se quest'ultimo è stato modificato o meno).
Il versionamento del progetto **dpi-config** segue direttamente quello dell'applicazione DPI, ossia, ad ogni nuovo versionamento di quest'ultimo seguirà anche il versionamento di questo progetto (esempio se creata la versione 3.0.0 di dpi si dovrà anche creare la relativa versione di dpi-config 3.0.0 indipendentemente se quest'ultimo è stato modificato o meno).
Questa gestione delle versioni è utile per associare ad ogni nuova versione applicativa di dpi anche le relative configurazioni.
In caso di **sola modifica di dpi-config** non seguita quindi da modifiche applicative su **dpi**, si stabilisce la generazione di una nuova versione di **dpi-config** applicando un quarto numero alla versione da creare (esempio dpi alla versione 3.0.0 e dpi-config 3.0.0, in caso di sola modifica a dpi-config si crea la versione 3.0.0.**1**).


Esempio 1 (modifica a dpi che segue il versionamento di dpi-config)

Sul tag [2.6.0](https://gitlab.ente.regione.emr.it/parer/dpi-config/-/tags/2.6.0) le configurazioni hanno effettuato a **partire** dalla versione 2.6.0 del DPI e da quelle successive, le precedenti versioni avranno quindi configurazioni diverse e certamente non compatibili con quelle rilasciate.
Sul tag 2.6.0 le configurazioni hanno effettuato a **partire** dalla versione 2.6.0 del DPI e da quelle successive, le precedenti versioni avranno quindi configurazioni diverse e certamente non compatibili con quelle rilasciate.

Esempio 2 (modifica esclusiva a dpi-config)

Expand All @@ -38,7 +34,7 @@ Si crea la versione **2.6.0.1** di dpi-config che quindi è relativa alla versio

## Modifica delle configurazioni

La directory su cui agire è [filters](filters) su cui sono presenti i file statici con relativi placeholder, trattandosi di un progetto maven che utilizza l'apposito plugin, è necessario eventualmente agire sui file in cui è già presente una logica di "filtro" e, nell'eventualità le future evolutive dell'applicazione DPI impongano nuovi file, di modificare anche il pom.xml di progetto. Per la generazione dell'artifact finale è stata predisposta una apposista implementazione su pipeline Gitlab che produce il "pacchetto" attraverso il goal maven "package".
La directory su cui agire è `filters` su cui sono presenti i file statici con relativi placeholder, trattandosi di un progetto maven che utilizza l'apposito plugin, è necessario eventualmente agire sui file in cui è già presente una logica di "filtro" e, nell'eventualità le future evolutive dell'applicazione DPI impongano nuovi file, di modificare anche il pom.xml di progetto. Per la generazione dell'artifact finale è stata predisposta una apposita implementazione su pipeline Gitlab che produce il "pacchetto" attraverso il goal maven "package".


# Supporto
Expand Down
216 changes: 0 additions & 216 deletions conf/dpi-aobo_prod/dpi.properties

This file was deleted.

Binary file removed conf/dpi-aobo_prod/samlKeystore.jks
Binary file not shown.
Loading

0 comments on commit ff047e8

Please sign in to comment.