Recettes de VM
Comment créer, configurer et utiliser des recettes de VM dans VergeOS pour déployer rapidement des machines virtuelles standardisées avec des questions personnalisables et l’intégration cloud-init.
Les recettes VM offrent un moyen puissant de déployer rapidement des machines virtuelles spécifiques à une instance à partir d’une configuration standard. Cette page vous guidera dans le processus de création et d’utilisation des recettes VM.
Qu’est-ce qu’une recette VM ?
Les recettes VM sont des modèles personnalisables pour lancer de nouvelles machines virtuelles uniques. Elles peuvent inclure des spécifications matérielles initiales, des affectations de pool de ressources et des options de configuration personnalisées via un magasin de paires clé-valeur créé lors de l’instanciation de la VM. Par exemple, une recette peut être configurée pour demander un nom d’utilisateur et un mot de passe de base de données, ou pour sélectionner un ensemble spécifique de paquets à installer. Les utilisateurs peuvent définir les options directement depuis l’interface utilisateur lors de la création de la nouvelle instance de VM. Les recettes peuvent également être exploitées avec l’API VergeOS afin de créer des interfaces utilisateur personnalisées et de rationaliser davantage le processus en s’intégrant aux systèmes existants, par exemple des portails de services.
Intégration conforme aux normes du secteur VergeOS prend en charge à la fois Cloud-Init (Linux) et Cloudbase-Init (Windows) pour personnaliser les VM lors du premier démarrage. Cela peut inclure des tâches comme la configuration des utilisateurs, l’installation de paquets ou l’exécution de scripts. Les recettes peuvent vous permettre de déployer rapidement des implémentations cloud-init/Cloudbase-init en fournissant l’interface utilisateur pour recueillir les entrées et en créant dynamiquement les fichiers de réponses associés. Voir Utilisation avancée ci-dessous pour plus d’informations.
Avantages de l’utilisation des recettes VM
Déploiement rapide de nouvelles machines virtuelles
Cohérence entre les configurations de VM
Réduction du temps de configuration manuelle
Personnalisable pour répondre aux besoins spécifiques des applications
Recettes VM incluses
Un système VergeOS inclut automatiquement le Référentiel du fournisseur de services (Marketplace) composé de recettes VM qui peuvent être utilisées immédiatement pour créer de nouvelles machines virtuelles de nombreux types. La liste de ces recettes VM disponibles peut être consultée en naviguant vers Référentiels > (double-cliquez) Référentiel MarketPlace > Recettes VM.
Vous pouvez double-cliquer sur une recette VM individuelle pour afficher sa configuration.
Créer une nouvelle recette VM
Configuration de base
Créer une VM pour servir de modèle de base pour la recette. La VM doit être généralisée et adaptée au processus de réplication/personnalisation.
Depuis le menu supérieur, accédez à Machines virtuelles > + Nouvelle recette VM.
Champs de la recette
Nom : Utilisez un nom descriptif qui identifie adéquatement la recette et peut aider les utilisateurs à trouver les recettes appropriées.
Description : (facultatif) Vous pouvez stocker ici toute information supplémentaire sur cette recette. Cela peut être un bon endroit pour fournir une documentation de base sur l’objectif visé et des directives générales.
Icône : (facultatif) une Font Awesome icône peut être associée à la recette. Les icônes peuvent aider les utilisateurs à identifier facilement différentes recettes/types de recettes.
Catalogue : Sélectionnez un catalogue dans lequel stocker la recette. Les catalogues sont utiles pour organiser les recettes.
Machine virtuelle : Sélectionnez une VM modèle.
Version : Attribuez un numéro de version. Ce champ s’incrémentera automatiquement chaque fois que la recette est modifiée, afin de suivre les changements.
Utiliser l’actif pour les noms de questions : Lorsqu’elle est activée, les noms des questions de disque et de NIC sont basés sur le numéro d’actif attribué plutôt que sur un numéro ordinal.
Dépendances de version : (Ne s’applique pas aux recettes qui ne seront utilisées que sur le système local et ses propres locataires). Des dépendances peuvent être spécifiées lorsque des fonctionnalités VergeOS sont requises pour que la recette fonctionne correctement (afin d’empêcher un système distant d’utiliser une recette qu’il ne peut pas prendre en charge).
Cliquez sur Soumettre pour enregistrer la configuration de base. Le tableau de bord de la recette VM affichera l’endroit où vous pouvez configurer vos sections et vos questions.
Questions
Les questions de recette sont utilisées pour déterminer les valeurs clés. Lorsqu’une recette est créée, certaines questions sont incluses automatiquement. Certaines de ces questions sont désactivées par défaut et devront être activées si vous souhaitez les utiliser.
(Facultatif) Activer la ou les questions désactivées par défaut : Cliquez sur Questions (menu de gauche ou carte du tableau de bord), sélectionnez la ou les questions, puis cliquez sur Activer dans le menu de gauche.
Pour configurer des questions supplémentaires, cliquez sur Questions dans le menu de gauche, puis sur Nouveau.
Champs de la question:
Section : chaque question appartient à une seule section. Les sections vous permettent de regrouper vos questions sur le formulaire de saisie. Certaines sections sont créées automatiquement. Vous pouvez éventuellement créer de nouvelles sections pour vos questions.
Nom : sert de nom de variable pouvant être référencé dans des scripts ; utilisez un nom descriptif pour faciliter la maintenance et le dépannage des scripts ; caractères alphanumériques uniquement (pas d’espaces ni de caractères spéciaux)
Type : détermine comment les données sont collectées : via la saisie utilisateur, l’interaction avec la base de données VergeOS, le téléchargement d’images cloud, etc.
ID de l’ordre : utilisé pour déterminer l’ordre d’affichage des questions (dans la section sélectionnée)
Affichage : texte affiché dans l’interface VergeOS pour que l’utilisateur réponde aux questions de la recette
Valeur par défaut : (facultatif) définit une valeur de réponse initiale pour la question
Validation Regex : (facultatif) chaîne d’expression régulière utilisée pour valider la saisie (syntaxe Regex standard)
Texte de remplacement : (facultatif) texte grisé affiché pour donner à l’utilisateur un exemple de la saisie attendue
Texte d’info-bulle : (facultatif) texte d’aide utilisateur affiché dans une fenêtre contextuelle lorsque le champ est survolé à la souris
Texte de note : (facultatif) texte d’aide utilisateur affiché directement sous le champ de saisie pour fournir des indications supplémentaires.
À la modification : permet de masquer/afficher d’autres questions lorsque ce champ est modifié. (Un exemple de code est affiché dans ce champ lors de la création d’une nouvelle question.)
Des options de configuration supplémentaires peuvent être disponibles selon le type sélectionné.
Simuler une recette VM
Vous pouvez simuler une recette VM pour la tester. La simulation de la recette vous permettra d’afficher le formulaire de saisie utilisateur, de tester la validation des champs et de créer des fichiers de réponses d’exemple afin de vérifier votre configuration. Vous ne pouvez simuler qu’une recette VM publiée dans votre catalogue local. Si vous le souhaitez, vous pouvez faire référence aux recettes Marketplace et les cloner dans le catalogue local.
Pour simplement afficher le formulaire de saisie utilisateur : lorsque vous êtes sur le tableau de bord de la recette VM, cliquez sur Simuler la recette dans le menu de gauche.
Depuis le formulaire de saisie simulé, vous pouvez tester la validation des champs et générer des fichiers de réponses de test en cliquant sur le bouton Simuler au bas du formulaire. Une liste de paires variable/valeur, ainsi qu’un aperçu des fichiers de résultat simulés, s’affichera.
Pour procéder à la création d’une VM à partir des entrées, cliquez sur le bouton Créer.
Modifier une recette VM
Lorsque des modifications sont apportées à une recette, celle-ci doit être republiée afin que ces changements soient pris en compte. Le haut du tableau de bord de la recette affichera un message indiquant qu’elle doit être republiée pour que les changements prennent effet. Vous pouvez utiliser le Republier lien dans ce message ou cliquer sur Republier dans le menu de gauche.
Utiliser une recette VM
Les recettes VM sont disponibles pour être utilisées lors de la création d’une nouvelle machine virtuelle. Tous les catalogues accessibles (locaux et distants) sont répertoriés à gauche de l’écran de nouvelle VM ; sélectionnez un catalogue pour afficher les recettes individuelles disponibles.
Instances de recette
Une instance désigne une machine virtuelle associée à une recette VM. Lorsqu’une machine virtuelle est créée avec une recette, elle est considérée comme une instance de la recette jusqu’à ce qu’elle soit supprimée ou détachée de la recette.
Cliquez sur Instances dans le menu de gauche d’un tableau de bord de recette VM pour accéder rapidement à la liste des VM associées. Une recette VM ne peut pas être supprimée s’il existe des instances de VM associées.
Utilisation avancée
Intégration de Cloud-Init et Cloudbase-init
À utiliser avec un modèle de VM :
Définissez le Champ Cloud-init Datasource = Config Drive v2.
Installez Cloud-init et les scripts associés dans le modèle de VM.
Pour utiliser une image système en ligne : Les recettes VergeOS permettent de tirer parti des nombreuses images système cloud-init préinstallées et disponibles au téléchargement pour la plupart des systèmes d’exploitation Linux et FreeBSD. Pour utiliser une image téléchargée spécifique, vous pouvez créer une question de recette configurée comme suit :
Nom="OS_DL_URL"
Type=Masqué
Valeur par défaut: l’URL de téléchargement (par exemple
https://cloud-images.example.com/releases/jammy/release/ubuntu-22.04-server-cloudimg-amd64-disk-kvm.img,http://download.rockylinux.org/pub/rocky/8/images/x86_64/Rocky-8-GenericCloud.latest.x86_64.qcow2)
Pour diffuser une image cloud via le web, vous pouvez créer une question de recette configurée comme suit :
Nom="OS_URL"
Type=Masqué
Valeur par défaut: l’URL de l’image (par exemple
https://cloud/debian.org/images/cloud/bullseye/latest/debian-11-generic-amd64.qcow2)
Exemples de référence : Les recettes Marketplace offrent de bons exemples pour utiliser des images OS cloud-init/cloudbase-init dans une recette.
L’intégration avec Cloud-init/Cloudbase-init permet de nombreuses solutions avec une variété d’approches possibles. Contactez le support VergeOS si vous avez besoin d’aide supplémentaire.
Mis à jour
Ce contenu vous a-t-il été utile ?