Proxmox on Jesuisadmin

Déployez vos machines virtuelles KVM sur Proxmox VE avec Cloud-Init

Tue, 04 Dec 2018 12:48:48 +0000

Après un premier article expliquant comment configurer l’interface réseau d’une machine virtuelle KVM sur Proxmox VE en utilisant qemu-nbd, il était nécessaire d’y ajouter une seconde partie pour détailler l’une des nouvelles fonctionnalités de Proxmox : le support de Cloud-Init (depuis la release 5.1). Dans ce tutoriel nous allons voir comment déployer et configurer une machine virtuelle KVM avec Cloud-init.

Qu’est ce que Cloud-init ?

Commençons par une présentation de Cloud-Init. Il s’agit d’une application (ou package en anglais) multi-plateforme dont la fonction est de réaliser la configuration initiale des machines virtuelles (ou instances public cloud) déployées depuis des templates.

Les tâches généralement réalisées par Cloud-Init sont :

Définir le hostname
Générer les clés privées SSH
Configurer les interfaces réseaux
Définir le mot de passe de l’utilisateur
Ajouter une clé SSH
Redimensionner le(s) disque(s) (si nécessaire)
Mettre à jour les paquets via APT

Dans le cas de Proxmox, Cloud-Init permet de configurer les machines virtuelles KVM aussi facilement que le containers LXC. Il n’est plus nécessaire de se connecter via la console NoVNC pour configurer une machine virtuelle.

Cloud-Init est d’autant plus pratique lorsqu’il s’agit de déployer une machine virtuelle nécessitant une configuration réseau particulière (comme une passerelle par défaut qui n’est pas dans le même sous-réseau que la machine virtuelle chez OVH).

Déployer une machine virtuelle KVM avec Cloud-Init

Créer un template de machine virtuelle

La première étape avant de pouvoir déployer notre première machine virtuelle avec Cloud-Init est la création d’un template de VM, qui pourra être cloné pour déployer une nouvelle VM.

À l’heure actuelle, il est déjà possible d’ajouter un disque Cloud-Init à une machine virtuelle depuis l’interface web de Proxmox, cependant l’import d’une image disque nécessite toujours l’utilisation de la CLI de Proxmox.

Pour nous faire gagner du temps, Canonical met à disposition des images minimales de machines virtuelles sur le site cloud-images.ubuntu.com. Cloud-Init est préinstallé sur l’ensemble de ces images permettant un déploiement automatisé.

Ubuntu n’est pas la seule distribution linux à proposer des images cloud, vous pouvez également télécharger des images Debian ou Centos.

Dans notre exemple, nous allons utiliser l’image Ubuntu Server 18.04 LTS Bionic.

Il est tout à fait possible d’installer une distribution linux depuis un ISO avant d’installer Cloud-Init pour en faire un template. Il est cependant important de noter que le redimensionnement automatique de la partition root n’est possible qu’en l’absence de partition swap (pratique courante sur les instances public cloud)

On se connecte donc en SSH à notre hôte Proxmox VE, et on commence par télécharger l’image Ubuntu Server 18.04 LTS :

wget -O bionic.img \
http://cloud-images.ubuntu.com/daily/server/bionic/current/bionic-server-cloudimg-amd64.img

Pour simplifier l’étape suivante, nous allons définir l’ID de notre VM Proxmox via une variable. Notre espace de stockage se nomme ici local, mais il généralement nommé local-lvm lorsque Proxmox est installé depuis un ISO.

# on définit l'ID de la VM
ID_VM=1804

# Créer une VM avec 2GB de RAM + une interface réseau connectée au bridge vmbr0
qm create ${ID_VM} --memory 2048 --net0 virtio,bridge=vmbr0

# on importe l'image de VM précédemment téléchargée
qm importdisk ${ID_VM} bionic.img local

# on associe le nouveau disque virtuel à la machine
qm set ${ID_VM} --scsihw virtio-scsi-pci --scsi0 local:${ID_VM}/vm-${ID_VM}-disk-0.raw

Nous avons ainsi créé notre VM puis importé l’image disque téléchargée depuis cloud-images.ubuntu.com. Il ne nous reste plus qu’à configurer Cloud-Init. Pour cela nous allons ajouter un lecteur Cloud-Init qui permettra la configuration de la VM depuis Proxmox.

 # ajouter un disque cloudinit
 qm set ${ID_VM} --ide2 local:cloudinit

 # définir sur quel disque la VM doit booter
 qm set ${ID_VM} --boot c --bootdisk scsi0

 # ajout d'une interface vga connectée au serial
 qm set ${ID_VM} --serial0 socket --vga serial0

Voilà, notre VM est prête, on peut enfin la transformer en template avec la commande :

 # transformer la VM en template
 qm template ${ID_VM}

Configurer une VM avec Cloud-Init

La configuration d’une VM avec Cloud-Init peut se faire via la CLI de Proxmox ou via l’interface web. Dans notre exemple, l’ID de notre VM est 158 et son IP est 192.168.0.201.

Configuration via l’interface web

On commence par cloner notre template afin de créer une nouvelle machine virtuelle. On peut alors se diriger vers l’onget “Hardware” de notre VM pour la redimensionner selon nos besoins (notamment le disque dont la taille est de 2.5Go par défaut) :

Efin, pour configurer notre VM via l’interface web, il suffit d’aller dans l’onglet “Cloud-Init” pour accéder à la liste des paramètres disponibles :

Parmi les paramètres disponibles, on retrouve

l’utilisateur, qui est généralement le nom de la distribution linux choisie, autrement dit “ubuntu” dans notre cas.
le mot de passe de l’utilisateur
les paramètres DNS des fichier /etc/hosts et /etc/resolv.conf
une ou plusieurs clé SSH publiques
la configuration du l’interface réseau

On peut lorsqu’on a terminé, démarrer notre VM.

Configuration via la CLI

Via la CLI, la démarche est relativement similaire puisqu’on commence par cloner notre template de machine virtuelle :

qm clone 1000 158 --name xenial

Pour redimensionner le disque, il suffit d’utiliser :

qm resize 158 scsi0 10G

On peut alors ajouter une clé SSH pour pouvoir se connecter à la machine virtuelle, par exemple la clé publique de notre hôte Proxmox :

qm set 158 --sshkey ~/.ssh/id_rsa.pub

Et la dernière étape est la configuration de l’interface réseau qui se fait via l’argument --ipconfig[x] où [x] est le numéro de l’interface réseau :

qm set 158 --ipconfig0 ip=192.168.0.201/24,gw=192.168.0.1

Une fois la configuration terminée, on peut démarrer notre vm avec la commande :

qm start 158

Quelques informations complémentaires

Après quelques mois d’utilisation, j’ai eu l’occasion d’utiliser Cloud-Init dans un certain nombre de cas et j’ai parfois remarqué des points qu’il semble important de souligner.

La configuration d’IP fail-over chez OVH

J’ai longtemps cherché la solution pour configurer une IP fail-over OVH sur une VM Ubuntu 18.04 LTS qui utilise netplan pour la configuration de l’interface réseau. Je l’ai découvert un peu par hasard, et je ne comprends toujours pas pourquoi cette configuration fonctionne.

Dans mon cas, je définis l’IP de la VM dans Cloud-Init, du type 178.XX.XX.XX/32 mais au lieu de définir 54.XX.XX.254 en tant que passerelle (IP de l’hôte .254), je définis simplement l’IP de la VM en tant que passerelle.

La configuration post-déploiement

Par défaut Cloud-Init mettra à jour le fichier /etc/hosts, bloquera l’accès SSH en tant que root et mettra à jour le hostname de la machine à chaque démarrage de cette dernière.

Vous pouvez désactiver ces actions en éditant le fichier /etc/cloud/cloud.cfg.

Configuration réseau d'une machine virtuelle KVM sur Proxmox

Wed, 09 May 2018 21:14:42 +0000

Si la configuration réseau d’un container LXC peut s’effectuer directement depuis l’interface web de Proxmox VE, il ~~est~~ était nécessaire (et pénible) de la réaliser via la console NoVNC pour les machines virtuelles KVM tournant sous Debian/Ubuntu.

Nous allons voir dans ce tutoriel, comment configurer le réseau d’une machine virtuelle KVM en utilisant qemu-nbd, qui permet de monter le disque d’une VM et donc d’accéder directement aux fichiers de configuration des interfaces réseau. Si la procédure peut sembler longue pour configurer une seule VM, il sera tout à fait possible de l’automatiser avec un script bash par la suite.

PS : Alors que j’écris ces lignes, le module cloud-init a déjà fait son apparition sur Proxmox VE 5.1, et représentera très probablement une excellente alternative à la solution présentée dans cette article. Mais cela fera sûrement l’objet d’un autre article.

Installer le client nbd

Pour commencer, il faut installer le client nbd sur votre serveur Proxmox.

apt-get update && apt-get install nbd-client -y

Puis charger le module :

modprobe nbd max_part=16

Et enfin, pour rendre la configuration persistente, on utilise :

echo "nbd" >> /etc/modules
cat > /etc/modprobe.d/nbd.conf <<\EOT

options nbd max_part=16

EOT

Monter le disque d’un VM avec qemu-nbd

Cas d’une machine virtuelle sans LVM

Pour monter le disque d’une VM, on utilise qemu-nbd :

qemu-nbd -c /dev/nbd0 vm-101* -f raw

vm-101 correspond à l’ID de la machine virtuelle dans Proxmox.

On créer ensuite un dossier dans lequel nous allons pouvoir monter le disque de la machine virtuelle :

mkdir /mnt/ma-vm
mount /dev/nbd0p1 /mnt/ma-vm

Cas d’une machine virtuelle avec LVM

Dans le cas d’un LVM, il n’est pas possible de monter directement la partition car il faut pour cela connaître le nom du volume group qui contient les fichiers de configuration.

La procédure pour monter le disque est quasiment la même que précédemment :

qemu-nbd -c /dev/nbd0 vm-101*

Mais cette fois-ci on utilise vgscan pour détecter les volume groups disponibles

vgscan

On obtient alors la liste des volume group et on active le volume auquel on souhaite accéder :

vgchange -a y vp-vg

Nous pouvons alors monter le VG :

mkdir /mnt/ma-vm
mount /dev/vp-vg/root /mnt/ma-vm

Configurer l’interface réseau

Maintenant que le disque de notre machine virtuelle est monté dans le répertoire /mnt/ma-vm, nous pouvons modifier la configuation de ses interfaces réseau. On se déplace à la racine du disque :

cd /mnt/ma-vm/

Et nous pouvons modifier directement le fichier /etc/network/interfaces dans le cas d’une machine virtuelle tournant sous Debian ou Ubuntu (exemple avec Ubuntu 16.04 LTS sur un serveur dédié OVH) :

cat > etc/network/interfaces << EOF

auto ens18
iface ens18 inet static
 address IP.FAIL.OVER
 netmask 255.255.255.255
 broadcast IP.FAIL.OVER
 post-up route add IP.SERVEUR.DEDIE.254 dev ens18
 post-up route add default gw IP.SERVEUR.DEDIE.254
 pre-down route del IP.SERVEUR.DEDIE.254 dev ens18
 pre-down route del default gw IP.SERVEUR.DEDIE.254
 # dns-* options are implemented by the resolvconf package, if installed
 dns-nameservers 213.186.33.99

iface ens18 inet6 static
 address IP:V6:FAIL:OVER
 netmask 64
 post-up /sbin/ip -f inet6 route add XXXX:XXXX:XXX:XXff:ff:ff:ff:ff dev ens18
 post-up /sbin/ip -f inet6 route add default via XXXX:XXXX:XXX:XXff:ff:ff:ff:ff
 pre-down /sbin/ip -f inet6 route del XXXX:XXXX:XXX:XXff:ff:ff:ff:ff dev ens18
 pre-down /sbin/ip -f inet6 route del default via XXXX:XXXX:XXX:XXff:ff:ff:ff:ff

EOF

Terminer la configuration

Une fois la modification terminée, nous pouvons démonter le disque de la VM.

Sans LVM

Sans LVM, la méthode est la même que pour monter le disque

cd ..
umount /dev/nbd0p1
qemu-nbd -d /dev/nbd0
rm -r /mnt/ma-vm

Avec LVM

Avec LVM, il faut utiliser à nouveau vgchange de désactiver le volume group :

cd ..
umount /dev/vp-vg/root
vgchange -a n vp-vg
qemu-nbd -d /dev/nbd0
rm -r /mnt/ma-vm

Dernière étapes, redémarrer la machine virtuelle pour appliquer les modificiations. J’espère que cet article vous aidera à automatiser un peu plus vos création de machines virtuelles.

Configurer Nginx en reverse-proxy avec Let's Encrypt pour Proxmox 4

Wed, 22 Mar 2017 18:33:31 +0000

Il y a plusieurs solutions pour sécuriser l’accès à l’interface Proxmox, mais si vous avez l’habitude tout comme moi de nginx, elle est la plus intéressante car elle permet non seulement d’utiliser le domaine de votre choix pour accéder à l’interface sur le port standard 443, mais également de ne pas vous retrouver bloqué par le firewall en cas de mauvaise configuration.

Dans ce tutorial, nous allons donc voir comment installer nginx et comment le configurer pour obtenir un certificat Let’sEncrypt et sécuriser ainsi l’interface de Proxmox.

==La méthode détaillée dans cet article n’est pas compatible avec Proxmox VE 5==

On commence par installer nginx :

apt-get install nginx

Puis on créer un fichier /etc/nginx/conf.d/proxmox.conf :

upstream proxmox {
 server "votre.serveur.hostname";
}

server {
 server_name proxmox.votredomaine.com;
 rewrite ^(.*) https://$host$1 permanent;
location /.well-known {
 alias /var/www/html/.well-known;
 }

}

Pour appliquer la configuration, on utilise la commande service nginx reload. On peut désormais passer à l’installation de Let’s Encrypt si ce n’est pas déjà fait.

cd /opt
git clone https://github.com/letsencrypt/letsencrypt
cd letsencrypt

Il ne nous reste plus qu’à générer le certificat via la commande :

./letsencrypt-auto certonly --webroot -w /var/www/html -d proxmox.votredomaine.com --email votreemail@votredomaine.com --text --agree-tos

Let’s Encrypt va alors effectuer l’opération de vérification en créer un dossier .well-known dans /var/www/html puis générer votre certificat. Nous pouvons donc désormais ajouter les lignes suivantes à notre fichier /etc/nginx/conf.d/proxmox.conf afin d’utiliser le certificat :

server {
 listen 443;
 server_name proxmox.votredomaine.com;
 ssl on;
 ssl_certificate /etc/letsencrypt/live/proxmox.votredomaine.com/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/live/proxmox.votredomaine.com/privkey.pem;
 proxy_redirect off;
 location / {
 proxy_http_version 1.1;
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection "upgrade";
 proxy_pass https://localhost:8006;
 proxy_buffering off;
 client_max_body_size 0;
 proxy_connect_timeout 3600s;
 proxy_read_timeout 3600s;
 proxy_send_timeout 3600s;
 send_timeout 3600s;
 }
}

On utilise à nouveau la commande service nginx reload pour appliquer la configuration et nous pouvons désormais accéder à l’interface proxmox via l’adresse : https://proxmox.votredomaine.com. Vous pouvez ajouter un cron pour renouveler automatiquement votre certificat letsencrypt tous les 30 jours :

0 0 1 * * /opt/letsencrypt-auto certonly --webroot -w /var/www/html -d proxmox.votredomaine.com --email votreemail@votredomaine.com --text --agree-tos