Cas d'usage concret
Vous voulez piloter votre hyperviseur KVM depuis une interface web simple : découvrez l'installation et la configuration de Kimchi.
Le projet Kimchi
Disposer d’un outil de management simple et accessible pour le Kernel-based Virtual Machine (KVM) est possible avec Kimchi. Développé en Python, l’installation du projet kimchi est accessible à tous et permet en quelques commandes de disposer d’une plate-forme prêt à l’emploi. L’accès par navigateur web est idéale, le projet est sous licence LGPL et a été incubé par le grand projet Ovirt. Installons et configurons ensemble Kimchi sous CentOS 7.
Sommaire
- Les modules du projet Kimchi
- Installation du projet Kimchi (CentOS)
- Modifier le port d’écoute de wok (nginx)
- Conclusion
Les modules du projet Kimchi
Le moteur principal du projet est Wok, un framework web basé sur Cherrypy . Il peut être étendu par des plugins qui exposent les fonctionnalités via les API REST, :
- Kimchi (virtualisation management).
- Ginger Base (gestion de base de l’hôte).
- Ginger (administration du système).
Installation du projet Kimchi (CentOS)
L’interface Wok fonctionne avec un serveur web, ici nous ajoutons le dépôt nginx :
nano /etc/yum.repos.d/nginx.repo
Ajoutons le contenu suivant :
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/7/$basearch/
gpgcheck=0
enabled=1
Téléchargeons la clé de signature des paquets nginx:
wget https://nginx.org/keys/nginx_signing.key
Installons la clé de signature des paquets nginx :
rpm --import nginx_signing.key
Installons les dépendances pour wok et Kimchi :
yum install nginx gcc make autoconf automake gettext-devel git rpm-build libxslt python-cherrypy python-cheetah PyPAM m2crypto python-jsonschema python-psutil python-ldap python-lxml openssl python-websockify logrotate
Téléchargeons wok et de Kimchi :
wget https://github.com/kimchi-project/wok/releases/download/2.5.0/wok-2.5.0-0.el7.centos.noarch.rpm
wget https://github.com/kimchi-project/kimchi/releases/download/2.5.0/kimchi-2.5.0-0.el7.centos.noarch.rpm
Installons wok et de Kimchi :
yum install wok-2.5.0-0.el7.centos.noarch.rpm kimchi-2.5.0-0.el7.centos.noarch.rpm
L’interface de management est désormais accessible depuis n’importe qu’elle interface (ex : 127.0.0.1:8001). Il est également possible de rendre le port 8001 accessible depuis une interface avec le firewall de CentOS :
firewall-cmd --zone=public --add-port=8001/tcp --permanent
Ou encore avec UFW :
ufw allow 8001/tcp
Ou bien avec iptables :
iptables -A INPUT -p tcp -m state --state NEW -m tcp --dport 8001 -j ACCEPT
Installation des dépendances pour ginger-base :
yum install hddtemp libuser-python python-augeas python-netaddr python-ethtool python-ipaddr python-magic tuned lm_sensors python2-crypto
Téléchargement de ginger-base et de ginger :
wget http://kimchi-project.github.io/gingerbase/downloads/latest/ginger-base.el7.centos.noarch.rpm
wget http://kimchi-project.github.io/ginger/downloads/latest/ginger.el7.centos.noarch.rpm
Installation de ginger-base et de ginger :
yum install ginger-base.el7.centos.noarch.rpm ginger.el7.centos.noarch.rpm
Modifier le port d’écoute de wok dans nginx
L’interface wok fonctionne sur le port 8001, voici comment changer le port d’écoute :
Editons le fichier de configuration wok.conf dans nginx :
nano /etc/nginx/conf.d/wok.conf
Recherchons la ligne suivante :
listen 0.0.0.0:8001 ssl;
Remplaçons le port par :
listen 0.0.0.0:443 ssl;
Nous recherchons ensuite la ligne :
proxy_redirect http://127.0.0.1:8010/ https://$host:8001/;
Remplaçons le port comme ceci :
proxy_redirect http://127.0.0.1:8010/ https://$host:443/;
Editons ensuite le fichier wok.conf dans wok :
nano /etc/wok/wok.conf
Décommettons le proxy_port :
#proxy_port = 8001
Changeons la valeur :
proxy_port = 443
Relançons les services wokd et nginx
service wokd restart
service nginx restart
La console wok est accessible depuis https://localhost ou bien si vous avez ouvert le port 443 : https://votre\_ip.
Conclusion
Le projet Kimchi est rapide à mettre en œuvre sur un serveur Linux. Il vous permettra de vous affranchir d’utiliser la libvirt et de connaître les commandes de virsh. Pour ma part, il est un outil complémentaire dans la gestion de mon infrastructure, il ne remplacera jamais la CLI que j’affectionne tout particulièrement. Quoi qu’il en soit, il vous permettra de faire vos premières armes un peu à la manière de webvirtmgr.
