Vous êtes maintenant à l’intérieur d'une machine virtuelle Incus fonctionnant sur un cluster Incus distant.
Sur cette machine virtuelle, Incus est préinstallé et préconfiguré pour vous.

Pour commencer, suivez ce tutoriel pas à pas qui vous guidera à travers les principales fonctionnalités d’Incus.
Vous pouvez également découvrir Incus à travers sa page de manuel et son option --help !

NOUVEAUTÉ : Vous pouvez également essayer l’une des interfaces web d'Incus !

Incus fonctionne avec des images, qu’il peut charger depuis différents serveurs d’images. Dans ce tutoriel, nous utiliserons le serveur images:.

Ce serveur Incus est actuellement vide, ce que vous pouvez vérifier avec la commande :

incus list

Commencez par lancer quelques instances.

1. Lancez un conteneur nommé « first » utilisant l’image Ubuntu 20.04 :

   incus launch images:ubuntu/20.04 first

   Notez que le lancement du conteneur prend quelques secondes, car l’image doit préalablement être téléchargée et décompressée.
2. Lancez un conteneur nommé « second » utilisant la même image :

   incus launch images:ubuntu/20.04 second

   Le lancement de ce conteneur est plus rapide que pour le premier, car l’image est déjà disponible.
3. Copiez le premier conteneur dans un conteneur nommé « third » :

   incus copy first third

4. Lancez un conteneur nommé « alpine » utilisant l’image Alpine Edge :

   incus launch images:alpine/edge alpine

5. Lancez une machine virtuelle nommée « debian » utilisant l’image Debian 12 :

   incus launch images:debian/12 debian --vm

Vérifiez la liste des instances que vous avez lancées :

incus list

Vous verrez que toutes les instances sont lancées sauf la troisième. C’est parce que vous l’avez créée en copiant la première instance, sans toutefois la démarrer.

Vous pouvez démarrer la troisième instance avec :

incus start third

Vous pouvez obtenir plus d'informations sur chaque instance avec :

incus info first
incus info second
incus info third
incus info alpine
incus info debian

Nous n’avons plus besoin de toutes ces instances pour la suite du tutoriel, nettoyons donc certaines d’entre elles.

1. Arrêtez la deuxième instance :

   incus stop second

2. Supprimez la deuxième instance :

   incus delete second

3. Supprimez la troisième instance :

   incus delete third

   Puisque cette instance est en cours d’exécution, vous obtenez un message d’erreur indiquant que vous devez d’abord l’arrêter. Vous pouvez également la supprimer de force :

   incus delete third --force

Vous pouvez définir un certain nombre de limites et d’options de configuration pour vos instances. Consultez la documentation pour en savoir plus.

Créons une autre instance avec des limites de ressources.

1. Lancez un conteneur et limitez-le à un vCPU et 192 Mio de RAM :

   incus launch images:ubuntu/20.04 limited -c limits.cpu=1 -c limits.memory=192MiB

2. Vérifiez la configuration actuelle et comparez-la à la configuration (sans limite) de la première instance :

   incus config show limited
   incus config show first

3. Vérifiez la quantité de mémoire libre et utilisée sur le système parent et sur les deux instances :

   free -m
   incus exec first -- free -m
   incus exec limited -- free -m

   Notez que la quantité totale de mémoire est identique sur le système parent et sur la première instance, car le conteneur hérite par défaut des ressources de son environnement parent. L’instance limitée, en revanche, ne dispose que de 192 Mio.
4. Vérifiez le nombre de CPU disponibles sur le système parent et sur les deux instances :

   nproc
   incus exec first -- nproc
   incus exec limited -- nproc

   Notez à nouveau que le nombre est identique sur le système parent et sur la première instance, mais qu’il est réduit pour l’instance limitée.

Vous pouvez également mettre à jour la configuration lorsque votre instance est en cours d’exécution.

1. Configurez une limite de mémoire pour votre instance :

   incus config set limited limits.memory=128MiB

2. Vérifiez que la configuration a été appliquée :

   incus config show limited

3. Vérifiez la quantité de mémoire disponible pour l’instance :

   incus exec limited -- free -m

   Notez que la valeur a changé.

Interagissons avec vos instances.

1. Lancez un shell interactif dans votre instance :

   incus exec first -- bash

2. Entrez quelques commandes, par exemple pour afficher des informations sur le système d’exploitation :

   cat /etc/*release

3. Quittez le shell interactif :

   exit

4. Répétez les étapes pour votre instance alpine :

   incus exec alpine -- ash
   cat /etc/*release
   exit

5. Au lieu de vous connecter à l'instance et d’y exécuter des commandes, vous pouvez le faire directement à partir de l’hôte. Par exemple, vous pouvez installer un outil sur l’instance et l’exécuter :

   incus exec first -- apt-get update
   incus exec first -- apt-get install sl -y
   incus exec first -- /usr/games/sl

Vous pouvez accéder aux fichiers de votre instance et interagir avec eux.

1. Récupérez un fichier de l'instance :

   incus file pull first/etc/hosts .

2. Ajoutez une entrée au fichier :

   echo "1.2.3.4 my-example" >> hosts

3. Transférez le fichier vers l’instance :

   incus file push hosts first/etc/hosts

4. Utilisez la même technique pour accéder aux fichiers journaux :

   incus file pull first/var/log/syslog - | less
   q

Incus permet de créer et de restaurer des instantanés d’instances.

1. Créez un instantané nommé « clean » :

   incus snapshot create first clean

2. Confirmez que l’instantané a été créé :

   incus snapshot list first

3. Cassez l’instance :

   incus exec first -- rm -Rf /etc /usr

4. Confirmez que vous l’avez cassée :

   incus exec first -- bash

   Notez que vous ne récupérez pas de shell car vous avez supprimé la commande bash.
5. Restaurez l’instance à l'état de l’instantané :

   incus snapshot restore first clean

6. Confirmez que tout est rentré dans l'ordre :

   incus exec first -- bash
   exit

7. Supprimez l'instantané :

   incus snapshot delete first clean

Nous espérons que ce tutoriel vous a permis de vous familiariser avec Incus, ses capacités et sa facilité d’utilisation.

Vous pouvez utiliser le service de démonstration aussi longtemps que vous le souhaitez pour essayer Incus et jouer avec ses dernières fonctionnalités.

Amusez-vous bien !