En-local-via-Kubernetes.md

+# 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).
+
+![image__1\_](uploads/6376a2d3731a4d5d639ea56743a3b21d/image__1_.png)
+
+## 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