|
|
|
# Quels sont les étapes de déploiement à suivre ?
|
|
|
|
|
|
|
|
Voici un schéma reprenant les étapes de déploiement à suivre pour installer la solution NumEcoEval en local via Kubernetes (K8s).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Quels sont les pré-requis au niveau de l'infrastructure ?
|
|
|
|
|
|
|
|
Les pré-requis au niveau de l'infrastructure sont :
|
|
|
|
|
|
|
|
1. **Un accès internet**
|
|
|
|
|
|
|
|
Un accès à internet pour pouvoir télécharger les images docker utilisées pour ce déploiement. Kubectl et Helm installés sur votre poste d'administrateur. Un cluster kubernetes local ou hébergé chez un cloud provider.
|
|
|
|
|
|
|
|
2. **Un K9s**
|
|
|
|
|
|
|
|
Il est également recommandé d'installer K9S pour faciliter le suivi du déploiement et l'administration de votre cluster ainsi qu'une bonne compréhension générale de NumEcoEval couplé avec G4it et de son architecture.
|
|
|
|
|
|
|
|
3. **Une chart Helm**
|
|
|
|
|
|
|
|
Ce déploiement s'effectue via l'utilisation d'une chart Helm.
|
|
|
|
|
|
|
|
Pour configurer le déploiement, vous pouvez copier le fichier value.yaml et l'éditer à votre guise pour répondre à vos besoins spécifiques.
|
|
|
|
|
|
|
|
Le fichier values.yaml par défaut tel qu'il est donné suffit pour un déploiement fonctionnel.
|
|
|
|
|
|
|
|
## Quel est le temps approximatif de déploiement ?
|
|
|
|
|
|
|
|
Ce déploiement se veut très simple et très rapide puisque l'intégralité de ce déploiement s'effectue en 1 commande.
|
|
|
|
|
|
|
|
Ce dernier prend en moyenne entre 3 et 5 minutes le temps que [keycloak](https://www.keycloak.org/) s'initialise correctement.
|
|
|
|
|
|
|
|
## Le déploiement
|
|
|
|
|
|
|
|
Depuis le répertoire g4it:
|
|
|
|
|
|
|
|
| Etape 1 | **helm dependency update** |
|
|
|
|
|---------|----------------------------|
|
|
|
|
| **Etape 2** | **helm install g4it -f values.yaml** |
|
|
|
|
|
|
|
|
Helm dependency va installer les dépendances Helm (Keycloak) dans le dossier 'charts/'.
|
|
|
|
|
|
|
|
### Quels sont les points d'attention ?
|
|
|
|
|
|
|
|
Pour que g4it x NumEcoEval fonctionne, il faut que le **frontend, le backend et keycloak soient exposés** (port-forward).
|
|
|
|
|
|
|
|
A vous de décider comment vous souhaitez faire.
|
|
|
|
|
|
|
|
Par défaut, les services sur lesquels reposent le déploiement de ces briques sont de type ClusterIP.
|
|
|
|
|
|
|
|
Il faut donc configurer les port forward manuellement:
|
|
|
|
|
|
|
|
| Etape 1 | kubectl port-forward svc/g4it-frontend 4200:4200 |
|
|
|
|
|---------|--------------------------------------------------|
|
|
|
|
| **Etape 2** | **kubectl port-forward svc/g4it-backend 8080:8080** |
|
|
|
|
| **Etape 3** | **kubectl port-forward svc/keycloak 8090:8090** |
|
|
|
|
|
|
|
|
Sinon, vous pouvez modifier leur type de service pour les passer en LoadBalancer ou NodePort pour les rendre accessible directement sans avoir à configurer les port forward manuellement.
|
|
|
|
|
|
|
|
### La configuration du fichier values.yaml
|
|
|
|
|
|
|
|
En attente
|
|
|
|
|
|
|
|
### Désinstaller le fichier
|
|
|
|
|
|
|
|
<table>
|
|
|
|
<tr>
|
|
|
|
<th>Etape 1</th>
|
|
|
|
<th>helm uninstall g4it</th>
|
|
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
|
|
## Le Test
|
|
|
|
|
|
|
|
### Accès Frontend
|
|
|
|
|
|
|
|
[URL](http://localhost:4280)
|
|
|
|
|
|
|
|
Si vous êtes sous Linux, vous pouvez éditer votre fichier '/etc/hosts' afin de faire de la redirection sur localhost:
|
|
|
|
|
|
|
|
| Etape 1 | 127.0.0.1 g4it-backend |
|
|
|
|
|---------|------------------------|
|
|
|
|
| **Etape 2** | **127.0.0.1 g4it-frontend** |
|
|
|
|
| **Etape 3** | **127.0.0.1 keycloak** |
|
|
|
|
|
|
|
|
### Accès aux swaggers de NumEcoEval
|
|
|
|
|
|
|
|
[URL](http://localhost:8085/)
|
|
|
|
|
|
|
|
Pour accéder aux swaggers pour l'import des données au niveau de NumEcoEval, il faut exposer l'api rest des référentiels:
|
|
|
|
|
|
|
|
<table>
|
|
|
|
<tr>
|
|
|
|
<th>Etape 1</th>
|
|
|
|
<th>kubectl port-forward svc/api-rest-referentiels 8085:8080</th>
|
|
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
### Traefik access
|
|
|
|
|
|
|
|
Une interface graphique est déployée pour accéder à la configuration de l'ingress Traefik.
|
|
|
|
|
|
|
|
Cette interface est directement accessible en suivant les étapes suivantes:
|
|
|
|
|
|
|
|
| Etape 1 | **Get internal node IP** | kubectl get nodes -o wide |
|
|
|
|
|---------|--------------------------|---------------------------|
|
|
|
|
| **Etape 2** | **Access** | **Interface http://:30808** |
|
|
|
|
| **Etape 3** | **Reverse Proxy** | **http://:30080** |
|
|
|
|
|
|
|
|
### Supprimer le test
|
|
|
|
|
|
|
|
<table>
|
|
|
|
<tr>
|
|
|
|
<th>Etape 1</th>
|
|
|
|
<th>helm uninstall g4it-test</th>
|
|
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
## Quels sont les sites ressources ?
|
|
|
|
|
|
|
|
Le site source de Kubernetes : [Kubernetes](https://kubernetes.io/releases/download/) |
|
|
\ No newline at end of file |
