Recettes de locataire
Comment créer et utiliser des recettes de locataire dans VergeOS pour automatiser des déploiements complets de locataires, y compris le réseau, les VM, les paramètres et les questions de configuration personnalisées.
Les recettes de locataire permettent d’automatiser le déploiement des locataires. Une recette de locataire peut inclure tout ce qui est nécessaire pour créer une nouvelle instance de locataire entièrement fonctionnelle, notamment : les paramètres du locataire, la configuration réseau, les machines virtuelles incluses, ainsi que l’automatisation de tâches telles que la création de mots de passe aléatoires, la définition de noms d’hôte/mots de passe/noms d’utilisateur uniques, l’enregistrement des entrées DHCP et DNS, l’envoi de notifications, et bien plus encore. Cette page vous guidera à travers le processus de base de création et d’utilisation des recettes de locataire.
Avantages de l’utilisation des recettes de locataire :
Déploiement rapide de locataires entiers
Cohérence entre les configurations des locataires
Réduction du temps de configuration manuelle, réduisant par conséquent la possibilité d’erreur humaine
Images dorées pour la conformité
Créer une recette de locataire
Créez un locataire qui servira de modèle de base. Une recette de locataire est basée sur un locataire qui sert de modèle de départ. Créez le locataire de manière à inclure les paramètres, les VM et les réseaux qui doivent faire partie de la configuration générique. Le locataire doit être arrêté avant la création de la recette.
Un locataire utilisé comme base d’une recette doit être dédié à cet usage. Si vous souhaitez baser une recette sur un locataire déjà en utilisation, vous pouvez travailler à partir d’un clone de l’original. Veillez à supprimer toute information spécifique, telle que les mots de passe, les noms d’utilisateur particuliers, les données client, etc., de l’instance du locataire cloné avant de l’utiliser comme modèle de recette.
Accédez à la Tableau de bord des recettes de locataire (Référentiels > Recettes de locataire).
Cliquez sur Nouveau dans le menu de gauche.
Configurer la recette de locataire champs :
Nom : Utilisez un nom qui identifie suffisamment la recette pour aider les utilisateurs à trouver les recettes appropriées.
Description : (facultatif) Vous pouvez stocker ici des informations supplémentaires sur la recette. Cela peut être un bon endroit pour fournir une documentation de base sur l’objectif prévu et des निर्देश générales.
Icône : (facultatif) une icône Font Awesome peut être associée à la recette. Les icônes peuvent aider les utilisateurs à identifier facilement différentes recettes/types de recettes. Une liste des icônes disponibles est accessible à FontAwesome .
Catalogue : Sélectionnez un catalogue dans lequel stocker la recette. Les catalogues sont utiles pour organiser les recettes. Voir Organisation des recettes pour plus d’informations sur les catalogues.
Locataire : Sélectionnez le locataire qui servira de base à la recette.
Version : Ce champ sera automatiquement incrémenté à chaque modification de la recette, afin d’aider au suivi des changements. La valeur par défaut est 1.0.0, mais elle peut être modifiée si vous souhaitez commencer le versionnement avec un autre nombre.
Conserver les certificats SSL : Lorsqu’elle est sélectionnée, les certificats SSL installés dans le locataire de base sont copiés vers les instances de locataire créées avec la recette.
Dépendances de version : (non applicable 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 certaines fonctionnalités VergeOS sont requises pour que la recette fonctionne correctement (afin d’empêcher qu’un système distant utilise une recette qu’il ne peut pas prendre en charge).
Cliquez sur Soumettre pour enregistrer la recette. Le tableau de bord de la recette de locataire indiquera où les questions de la recette peuvent être personnalisées.
Questions
Les questions fournissent des valeurs de personnalisation pour les locataires individuels créés avec une recette, en capturant des entrées de l’utilisateur ou en interagissant avec la base de données VergeOS. Une recette de locataire inclura automatiquement des questions système. 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 question(s), puis cliquez sur Activer dans le menu de gauche.
Les questions système peuvent être désactivées, mais ne peuvent pas être supprimées.
Pour configurer des questions supplémentaires, cliquez sur Questions dans le menu de gauche, puis sur Nouveau.
Champs de la question:
Section : Les sections vous permettent de regrouper vos questions sur le formulaire de saisie. Certaines sections sont créées automatiquement et vous pouvez créer des sections supplémentaires pour vos questions depuis le tableau de bord de la recette de locataire.
Nom : sert de nom de variable pouvant être référencé dans les scripts ; utilisez un nom descriptif pour faciliter la maintenance et le dépannage des scripts ; uniquement des caractères alphanumériques, sans espaces ni 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, etc.
ID de l’ordre : utilisé pour déterminer l’ordre dans lequel les questions sont affichées, dans la section sélectionnée.
Affichage : l’étiquette textuelle affichée sur le formulaire de saisie utilisateur pour la question
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é.
Interaction avec la base de données VergeOS
Certains types de questions vous permettent de rechercher des informations dans la base de données ou de créer/modifier des enregistrements de la base de données. Remarquez le texte de remplacement (texte grisé affichant un exemple de saisie) lors de la configuration des questions d’interaction avec la base de données pour obtenir des indices. Ces articles de la base de connaissances fournissent des informations supplémentaires sur l’utilisation de la base de données VergeOS : Description des tables de l’API et Le guide de l’API
Contexte de base de données
Le Contexte de base de données le champ vous permet de choisir d’interagir avec la base de données locale (le système parent) ou la base de données du locataire nouvellement créé. Cela s’applique aux types de questions : Création en base de données, modification en base de données et recherche en base de données.
Référence des questions système
Lorsqu’une recette de locataire est créée, le système génère automatiquement un ensemble de questions intégrées organisées en sections. Bon nombre de ces questions sont désactivées par défaut et doivent être activées si vous souhaitez les utiliser. Les questions système ne peuvent pas être supprimées, mais elles peuvent être activées ou désactivées.
Pour activer une question système désactivée : accédez à Questions (menu de gauche ou carte du tableau de bord), sélectionnez la ou les question(s), puis cliquez sur Activer dans le menu de gauche.
Section Locataire
Ces questions contrôlent les paramètres principaux du locataire, tels que l’identité, les identifiants administrateur et la configuration SSL.
YB_URL
URL
Chaîne
Oui
YB_DESCRIPTION
Description
Zone de texte
Oui
YB_USER_NAME
Utilisateur administrateur
Chaîne
admin
Oui
YB_USER_PASSWORD
Mot de passe
Mot de passe
Oui
YB_USER_EMAIL
Chaîne
Non
YB_USER_CHANGE_PASSWORD
Exiger le changement de mot de passe
Booléen
false
Non
YB_EXPOSE_CLOUD_SNAPSHOTS
Exposer les instantanés système
Booléen
true
Non
YB_HELP_URL
URL d’aide
Chaîne
par défaut
Non
YB_THEME_ACCESS
Accès au thème
Liste
host_only
Oui
YB_SPECIFIED_THEME
Thème
Sélection de ligne
Oui
YB_CLUSTER
Cluster
Cluster
Non
YB_CERT_TYPE
Type de certificat SSL
Masqué
manuel
Non
YB_CERT_DOMAIN
Domaine du certificat SSL
Chaîne
Non
YB_CERT_PUBLIC
Certificat SSL public
Zone de texte
Non
YB_CERT_PRIVATE
Certificat SSL privé
Zone de texte
Non
YB_CERT_CHAIN
Chaîne de certificats SSL
Zone de texte
Non
Section Nœuds
Ces questions définissent les ressources de calcul allouées au(x) nœud(s) du locataire.
YB_NODE_1_CPU_CORES
Cœurs du nœud 1
Nombre
8
Oui
YB_NODE_1_RAM
RAM du nœud 1
RAM
16384
Oui
YB_NODE_1_INSTANCES
Instances du nœud 1
Nombre
1
Non
YB_NODE_1_CLUSTER
Cluster du nœud 1
Cluster
Non
YB_NODE_1_CLUSTER_FAILOVER
Cluster de basculement du nœud 1
Cluster
Non
Section Réseau
Ces questions configurent les adresses réseau du locataire.
YB_NET_1_IP
Adresse IP de l’interface utilisateur
Adresse IP virtuelle
Oui
YB_NET_2_IP
Adresse IP
Adresse IP virtuelle
Oui
Ce sont les questions système par défaut à partir de VergeOS 26.1. Vous pouvez ajouter des questions personnalisées en plus de celles-ci pour capturer des informations supplémentaires telles que des dates d’expiration, des noms d’hôte personnalisés ou d’autres valeurs spécifiques au locataire.
Modifier une recette
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.
Lorsque vous apportez des modifications et republiez une recette, les systèmes distants et les locataires ayant accès à la recette sont informés qu’une mise à jour est disponible (notification en haut du tableau de bord de la recette de locataire et case à cocher de mise à jour disponible) ; ils doivent mettre à jour la recette pour accéder aux modifications.
Utiliser une recette de locataire
Créer un locataire à partir d’une recette
Depuis le menu supérieur, accédez à Locataires > + Nouveau locataire.
Cliquez sur le catalogue souhaité depuis la section des catalogues à gauche.
Les recettes de locataire individuelles disponibles dans le catalogue sélectionné apparaîtront sur le côté droit. Sélectionnez la recette souhaitée et cliquez sur Suivant en bas de l’écran.
Les champs de saisie sont présentés tels que définis par les questions de la recette.
Saisissez/configurez les champs et cliquez sur Soumettre pour créer le nouveau locataire. La configuration des questions de la recette déterminera les champs requis et les autres validations de champ.
Instances de recette
Une instance désigne un locataire spécifique associé à une recette de locataire. Lorsqu’un locataire est créé à partir d’une recette, il est considéré comme une instance de la recette jusqu’à ce qu’il soit supprimé ou détaché de la recette.
Cliquez sur Instances dans le menu de gauche du tableau de bord d’une recette de locataire pour accéder rapidement à une liste des locataires associés. Une recette ne peut pas être supprimée lorsqu’il existe des instances associées.
Les recettes permettent une grande variété de solutions potentielles. Contactez le support VergeOS pour obtenir une assistance supplémentaire afin d’automatiser les déploiements de vos locataires à l’aide de recettes.
Mis à jour
Ce contenu vous a-t-il été utile ?