Il y a 389 articles et 19 utilisateurs inscrits (ce bandeau est défini dans MediaWiki:Sitenotice)
« Installation de Vitam 4.0.3 » : différence entre les versions
Aller à la navigation
Aller à la recherche
| (22 versions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 22 : | Ligne 22 : | ||
Sachant que le déploiement est orchestré depuis un serveur d'administration, les pré-requis suivants doivent y être présents : | Sachant que le déploiement est orchestré depuis un serveur d'administration, les pré-requis suivants doivent y être présents : | ||
* packages nécessaires : | * packages nécessaires : | ||
** '''ansible''' (version 2. | ** '''ansible''' (version 2.3 minimale et conseillée) | ||
** '''openssh-client''' | ** '''openssh-client''' | ||
** '''JDK 11''' | ** '''JDK 11''' | ||
| Ligne 29 : | Ligne 29 : | ||
** '''npm''' | ** '''npm''' | ||
Pour builder le projet VITAM, il est nécessaire de builder la librarie '''elasticsearch-metrics-reporter-java''' : | Pour builder le projet VITAM, il est nécessaire de builder la librarie '''elasticsearch-metrics-reporter-java''' au préalable : | ||
# Commencez par cloner le depôt git : https://github.com/ProgrammeVitam/elasticsearch-metrics-reporter-java.git | # Commencez par cloner le depôt git : https://github.com/ProgrammeVitam/elasticsearch-metrics-reporter-java.git | ||
# Une fois que le dépôt a été cloné, veuillez le builder avec la commande suivante : '''{{cmd|$ mvn clean install}}''' | # Une fois que le dépôt a été cloné, veuillez le builder avec la commande suivante : '''{{cmd|$ mvn clean install}}''' | ||
| Ligne 36 : | Ligne 36 : | ||
Pour ne pas avoir de soucis de droits, veuillez taper la commande suivante : '''{{cmd|$ sudo chmod 666 /var/run/docker.sock}}''' | Pour ne pas avoir de soucis de droits, veuillez taper la commande suivante : '''{{cmd|$ sudo chmod 666 /var/run/docker.sock}}''' | ||
=== | === Build === | ||
{{important|Toutes les étapes sont obligatoires afin d'assurer l'installation ainsi que le déploiement de VITAM}} | {{important|Toutes les étapes sont obligatoires afin d'assurer l'installation ainsi que le déploiement de VITAM}} | ||
Pour installer VITAM, veuillez suivre les étapes suivantes : | Pour installer VITAM, veuillez suivre les étapes suivantes : | ||
# Tout d'abord, commencez par cloner le dépôt VITAM : https://github.com/ProgrammeVitam/vitam.git | # Tout d'abord, commencez par cloner le dépôt VITAM : https://github.com/ProgrammeVitam/vitam.git | ||
# Placez vous dans le répertoire de votre dépôt et tapez la commande suivante afin de builder le projet VITAM : '''{{cmd|$ mvn clean install - | # Placez vous dans le répertoire de votre dépôt et tapez la commande suivante afin de builder le projet VITAM : '''{{cmd|$ mvn clean install -DskipTests -f sources/pom.xml -P-vitam}}''' | ||
# Pour construire les packages deb dédiés, veuillez taper la commande suivante :'''{{cmd|$ ./deb/vitam-product/build-all.sh}}''' | |||
# Pour construire le cache des packages externes : '''{{cmd|$ ./deb/vitam-external/build_repo.sh}}''' | |||
=== Déploiement au sein d'un conteneur docker === | === Déploiement au sein d'un conteneur docker === | ||
Vitam peut être construit et déployé docker de manière presque automatique, ce dernier héberge l'intégralité des outils requis pour construire et déployer la solution. | Vitam peut être construit et déployé sur un environnement docker de manière presque automatique, ce dernier héberge l'intégralité des outils requis pour construire et déployer la solution. | ||
==== Pré-requis ==== | ==== Pré-requis ==== | ||
* Docker 1.12 minimum avec driver "devicemapper" | * Docker 1.12 minimum avec driver "devicemapper" | ||
| Ligne 53 : | Ligne 55 : | ||
==== Procédure ==== | ==== Procédure ==== | ||
# Afin de démarrer le conteneur docker, il faut lancer le script : '''{{cmd|/vitam/dev-deployement/run.sh <environnement>}}''', où <environnement> peut être rpm ou deb, dans notre cas '''deb'''. | # Afin de démarrer le conteneur docker, il faut lancer le script : '''{{cmd|/vitam/dev-deployement/run.sh <environnement>}}''', où <environnement> peut être rpm ou deb, dans notre cas '''deb'''. | ||
# Une fois le shell ouvert dans le conteneur, placez vous dans le dossier '''code''' et executez '''{{cmd|$ | # Une fois le shell ouvert dans le conteneur, placez vous dans le dossier '''code''' et executez '''{{cmd|$ vitam-build-repo}}''' pour construire l'integralité des packages. | ||
# Pour déployer vitam, veuillez lancer la commande '''{{cmd|vitam-deploy}}''' | # Pour déployer vitam, veuillez lancer la commande '''{{cmd|vitam-deploy}}''' | ||
# Si vous souhaitez installer un apache reverse proxy qui met à disposition une page d'accueil avec les liens sur les différentes interfaces graphiques, veuillez taper la commande '''{{cmd|vitam-deploy-extra}}''' | # Si vous souhaitez installer un apache reverse proxy qui met à disposition une page d'accueil avec les liens sur les différentes interfaces graphiques, veuillez taper la commande '''{{cmd|vitam-deploy-extra}}''' | ||
==== Post déploiement ==== | |||
Une fois que le déploiement a été effectué avec succés, vous pouvez accèder a la page d'accueil via le localhost : '''127.0.0.1''' | |||
Dans cette page d'accueil, vous avez différents liens vers les différents services de VITAM. Le lien qui nous intéresse est celui de VITAM métier : | |||
* '''VITAM IHM Demo''' : http://127.0.0.1/ihm-demo/#/login | |||
Voici les informations de connexion pour s'identifier en tant qu'administrateur a VITAM : | |||
* '''Identifiant''' : aadmin | |||
* '''Mot de passe''' : aadmin1234 | |||
Pour bien comprendre les différents termes metiers employés par la documentation de VITAM, veuillez visiter ce lien : https://www.programmevitam.fr/ressources/Doc0.11.1/20170116_Design_SIP_beta_V1.4.pdf | |||
=== Soucis de documentation lors du déploiement a la main === | |||
{{important|La méthode de déploiement concerné est la 2 : https://github.com/ProgrammeVitam/vitam}} | |||
{{notice|Le document concerné est le suivant : https://github.com/ProgrammeVitam/vitam/tree/master_4.0.x/deployment}} | |||
Le point '''II''' du '''chapitre 3''' est sensé s’exécuter en premier, voici comment il faut procéder : | |||
'''I.''' Générer les certificats : {{cmd|pki/scripts/generate_certs.sh environments/<fichier d'inventaire>}} | |||
'''II.''' Configurer le vault référençant les mots de passe de chiffrement des clés privées des certificats : {{cmd|ansible-vault edit environments/certs/vault-certs.yml --vault-password-file vault_pass.txt}} | |||
Il est important d’exécuter les commandes dans cet ordre pour le '''chapitre 4''' : | |||
'''I.''' Générer les keystores {{cmd|./generate_stores.sh}} | |||
'''II.''' Si besoin {{cmd|ansible-vault edit environments/group_vars/all/vault-keystores.yml --vault-password-file vault_pass.txt}} | |||
Dernière version du 30 septembre 2021 à 13:59
Informations importantes
[modifier | modifier le wikicode]Notice :
Cette documentation couvre uniquement l'installation de Vitam 4.0.3 sur une machine Ubuntu 18.04 basé sur Debian 10 (Buster).
Seules deux distributions Linux suivantes sont supportées à ce jour :
- CentOS 7
- Debian 10 (Buster)
Veuillez vérifier la version de Debian utilisé par votre système d'exploitation.
| Debian | Ubuntu |
|---|---|
| Debian 11 (Bullseye) | Ubuntu 20.04 (Focal) |
| Debian 10 (Buster) | Ubuntu 18.04 (Bionic) |
| Debian 9 (Stretch) | Ubuntu 16.04 (Xenial) |
| Debian 8 (Jessie) | Ubuntu 14.04 (Trusty) |
Pré-requis
[modifier | modifier le wikicode]Sachant que le déploiement est orchestré depuis un serveur d'administration, les pré-requis suivants doivent y être présents :
- packages nécessaires :
- ansible (version 2.3 minimale et conseillée)
- openssh-client
- JDK 11
- Maven (version 3.3.9 minimale)
- golang (version 1.6 minimale)
- npm
Pour builder le projet VITAM, il est nécessaire de builder la librarie elasticsearch-metrics-reporter-java au préalable :
- Commencez par cloner le depôt git : https://github.com/ProgrammeVitam/elasticsearch-metrics-reporter-java.git
- Une fois que le dépôt a été cloné, veuillez le builder avec la commande suivante :
$ mvn clean install
La solution VITAM sera déployé dans un conteneur docker, veuillez vérifier qu'il est bien installé dans votre poste via la commande suivante : $ docker version
Pour ne pas avoir de soucis de droits, veuillez taper la commande suivante : $ sudo chmod 666 /var/run/docker.sock
Build
[modifier | modifier le wikicode]Important :
Toutes les étapes sont obligatoires afin d'assurer l'installation ainsi que le déploiement de VITAM.
Pour installer VITAM, veuillez suivre les étapes suivantes :
- Tout d'abord, commencez par cloner le dépôt VITAM : https://github.com/ProgrammeVitam/vitam.git
- Placez vous dans le répertoire de votre dépôt et tapez la commande suivante afin de builder le projet VITAM :
$ mvn clean install -DskipTests -f sources/pom.xml -P-vitam - Pour construire les packages deb dédiés, veuillez taper la commande suivante :
$ ./deb/vitam-product/build-all.sh - Pour construire le cache des packages externes :
$ ./deb/vitam-external/build_repo.sh
Déploiement au sein d'un conteneur docker
[modifier | modifier le wikicode]Vitam peut être construit et déployé sur un environnement docker de manière presque automatique, ce dernier héberge l'intégralité des outils requis pour construire et déployer la solution.
Pré-requis
[modifier | modifier le wikicode]- Docker 1.12 minimum avec driver "devicemapper"
- OS récent comme Ubuntu 18.04 ou Ubuntu 20.04
- Répertoire contenant un clone du dépôt git vitam/vitam
- Utilisateur autre que root, soit appartenant au group docker, soit ayant des capacités de sudo
- Le répertoire ${HOME}/.m2 existe et accessible en écriture
- Les ports "classiques" MongoDB (27017), Elasticsearch (9200, 9201), apache (80), SSL (8443) ne sont pas déjà attribués sur l'hôte
Procédure
[modifier | modifier le wikicode]- Afin de démarrer le conteneur docker, il faut lancer le script :
/vitam/dev-deployement/run.sh <environnement>, où <environnement> peut être rpm ou deb, dans notre cas deb. - Une fois le shell ouvert dans le conteneur, placez vous dans le dossier code et executez
$ vitam-build-repopour construire l'integralité des packages. - Pour déployer vitam, veuillez lancer la commande
vitam-deploy - Si vous souhaitez installer un apache reverse proxy qui met à disposition une page d'accueil avec les liens sur les différentes interfaces graphiques, veuillez taper la commande
vitam-deploy-extra
Post déploiement
[modifier | modifier le wikicode]Une fois que le déploiement a été effectué avec succés, vous pouvez accèder a la page d'accueil via le localhost : 127.0.0.1
Dans cette page d'accueil, vous avez différents liens vers les différents services de VITAM. Le lien qui nous intéresse est celui de VITAM métier :
- VITAM IHM Demo : http://127.0.0.1/ihm-demo/#/login
Voici les informations de connexion pour s'identifier en tant qu'administrateur a VITAM :
- Identifiant : aadmin
- Mot de passe : aadmin1234
Pour bien comprendre les différents termes metiers employés par la documentation de VITAM, veuillez visiter ce lien : https://www.programmevitam.fr/ressources/Doc0.11.1/20170116_Design_SIP_beta_V1.4.pdf
Soucis de documentation lors du déploiement a la main
[modifier | modifier le wikicode]Important :
La méthode de déploiement concerné est la 2 : https://github.com/ProgrammeVitam/vitam.
Notice :
Le document concerné est le suivant : https://github.com/ProgrammeVitam/vitam/tree/master_4.0.x/deployment.
Le point II du chapitre 3 est sensé s’exécuter en premier, voici comment il faut procéder :
I. Générer les certificats : pki/scripts/generate_certs.sh environments/<fichier d'inventaire>
II. Configurer le vault référençant les mots de passe de chiffrement des clés privées des certificats : ansible-vault edit environments/certs/vault-certs.yml --vault-password-file vault_pass.txt
Il est important d’exécuter les commandes dans cet ordre pour le chapitre 4 :
I. Générer les keystores ./generate_stores.sh
II. Si besoin ansible-vault edit environments/group_vars/all/vault-keystores.yml --vault-password-file vault_pass.txt