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 :
- 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.
- 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.
- 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 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
| Etape 1 | helm uninstall g4it |
|---|
Le Test
Accès Frontend
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
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:
| Etape 1 | kubectl port-forward svc/api-rest-referentiels 8085:8080 |
|---|
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
| Etape 1 | helm uninstall g4it-test |
|---|
Quels sont les sites ressources ?
Le site source de Kubernetes : Kubernetes