Les services EOLE3 s'installent dans un cluster Kubernetes
Vous pouvez en louer un chez un hébergeur ou installer le vôtre dans vos infrastucutures.
Notre solution EOLE 3 Base permet de faciliter cette installation.
L'outil Tools sert à générer les différents fichiers nécessaires au déploiement des charts Helm pour les services EOLE3 dans votre kubernetes.
kubectl installationhelm installationjq (utiliser le paquet de votre distribution)python3-click et jinja2 (utiliser les paquets de votre distribution)Cloner le dépôt : git clone https://gitlab.mim-libre.fr/EOLE/eole-3/tools.git && cd tools
Éditer le fichier vars.ini et l'adapter à votre environnement. Cf var.ini sur Gitlab
Il faut au minimum adapter la valeur de la variable domain à votre nom de domaine
Lancer la génération des fichiers avec la commande ./build gen-socle
Si vous n'utilisez pas Cert Manager, copier la clef privée (tls.key) et le certificat (tls.crt) wildcard de votre nom de domaine dans le répertoire ./install
Déployer la configuration avec les commandes suivantes : cd ./install && bash deploy
Pour mettre à jour le socle, il vous faut :
Éditer le fichier vars.ini et mettre à jour les options
Lancer la génération des fichiers avec la commande ./build gen-socle
Mettre à jour la configuration avec les commandes suivantes : cd ./install && bash update
Éditer éventuellement le fichier addons/codimd/codimd-vars.ini
Lancer la génération des fichiers avec la commande : ./build gen-addon -n codimd
Déployer la configuration avec les commandes suivantes : cd ./install/addons/codimd && bash deploy
admin-tools/supercrud/supercrud-vars.ini./build gen-admin-tool -n supercrudcd ./install/admin-tool/supercrud && bash deployVous pouvez spécifier les fichiers de configurations utilisés pour la génération grâce aux options de la commande build.
./build --help gen-socle
Usage: build [OPTIONS] COMMAND [ARGS]...
Options:
-c, --configfile PATH Configuration values (default: vars.ini)
-cc, --clusterconfigfile PATH Cluster configuration values (default: cluster-vars.ini)
-o, --outputdir TEXT Output Directory (default: ./install)
--help Show this message and exit.`
Exemple :
./build -c path/to/my-vars.ini -cc /path/to/my-cluster-vars.ini -o /path/to/my-install gen-socle
./build gen-addon --help
Usage: build gen-addon [OPTIONS]
Generate addon
Options:
-n, --name TEXT Addon name
-ac, --addon-config PATH Addon configuration values
--help Show this message and exit.
Exemple pour CodiMD:
./build -c path/to/my-vars.ini -cc path/to/my-cluster-vars.ini gen-addon -n codimd -ac path/to/my-codimd-vars.ini
./build gen-admin-tool --help
Usage: build gen-admin-tool [OPTIONS]Generate admin tool
Options:
-n, --name TEXT Admin tool name
-atc, --admin-tool-config PATH Admin tool configuration values
--help Show this message and exit.
Exemple pour SuperCRUD:
./build -c path/to/my-vars.ini -cc path/to/my-cluster-vars.ini gen-admin-tool -n supercrud -atc path/to/my-admin-tool-vars.ini