L'installation comporte deux étapes :
Si vous avez installé l'outil eole3 dans un venv, il faudra activer celui-ci :
source ~/venv/bin/activate
Dans un dossier dédié sur votre poste de travail, créer un répertoire moncluster.
Le nom moncluster est arbitraire. Il est conseillé d'utiliser un nom de dossier sans espaces, sans accents et en minuscules seulement. :
mkdir moncluster
cd moncluster
On peut afficher la configuration par défaut avec la commande suivante :
eole3 config socle
Dans le dossier moncuster, créer un fichier socle.yaml et l'adapter à votre environnement.
Il faut au minimum adapter la valeur de la variable domain à votre nom de domaine :
cat > socle.yaml <<EOF
default:
#general domain for the deployment
domain: mon-domaine.fr
EOF
Ensuite générer les fichiers de déploiement avec la commande suivante :
eole3 --config socle.yaml build socle
Si vous n'utilisez pas Cert Manager, copier la clef privée (tls.key) et le certificat (tls.crt) wildcard ou multi-domaines dans le répertoire "./install/infra/ingress-nginx/". Vous devez obtenir :
./install/infra/ingress-nginx/tls.key
./install/infra/ingress-nginx/tls.crt
Il est possible de changer de dépot pour récupérer une image ou une version spécifique, il faut ajouter une section dans le fichier de configuration socle.yaml.
controller:
image:
registry: hub.eole.education
image: eole3/ingress-nginx-container-image/controller
tag:
ou
controller:
image:
registry: upstream
image: ingress-nginx/controller
tag: git-e42617c2
Assurez vous d'avoir exporté la variable KUBECONFIG faisant référence au fichier kubeconfig.yaml concernant votre cluster Kubernetes.
Installer la configuration de déploiement avec la commande suivante :
eole3 deploy socle
Pour mettre à jour le socle, il vous faut :
Éditer le fichier moncluster/socle.yaml et mettre à jour les options.
Depuis le dossier moncluster, générer les fichiers de déploiement avec la commande :
cd moncluster
source venv/bin/activate
eole3 --config socle.yaml build socle
deactivate
Mettre à jour la configuration avec la commande suivante :
eole3 update socle
Une fois le socle de base installé, vous pouvez installer des services additionnels et des outils d'administration.