Organisation des recettes

Comment organiser les recettes à l’aide de référentiels et de catalogues dans VergeOS, y compris des instructions pour partager des recettes avec des locataires et des systèmes distants.

Cette page traite des dépôts et des catalogues, les conteneurs utilisés pour organiser les recettes de locataire et de VM. Des instructions pour partager des recettes sont également incluses.

Dépôts

Qu'est-ce qu'un dépôt ?

Un dépôt est une collection de recettes du site. Un dépôt peut contenir plusieurs catalogues de recettes.

• Dépôts locaux : les catalogues/recettes sont créés et maintenus sur le système local.
• Dépôts distants : les catalogues de recettes, créés et maintenus sur un système VergeOS distinct, sont récupérés pour être utilisés sur le système local. Le partage via des dépôts distants élimine le besoin d’administrer les mêmes recettes à plusieurs endroits.

Dépôts installés automatiquement

"MarketPlace" Les systèmes au niveau de l’hôte sont installés avec Marketplace, un dépôt spécial, distant, fourni par VergeOS, qui comprend une grande variété de recettes VM Linux et Windows prêtes à l’emploi. Par défaut, les catalogues de recettes contenus dans Marketplace sont définis avec scope="global", ce qui leur permet également d’être utilisés par tous les locataires du système.

"Local" Par défaut, votre nouveau système VergeOS disposera d’un dépôt local vide nommé "Local" qui est prêt à accueillir la création de nouveaux catalogues/recettes.

Catalogues

Qu'est-ce qu'un catalogue ?

Les catalogues vous permettent de regrouper vos recettes associées au sein d’un dépôt. Par exemple, un catalogue peut contenir diverses recettes VM Windows, tandis qu’un autre contient toutes les recettes VM basées sur Linux. Les administrateurs peuvent utiliser les catalogues pour les organiser de la manière qui convient le mieux à leur organisation. Les catalogues peuvent être configurés comme privés ou partagés avec vos locataires ou d’autres systèmes VergeOS externes.

Créer un nouveau catalogue

1. Accédez à Dépôts > Liste dans le menu du haut, puis double-cliquez sur le dépôt où le catalogue doit résider. Cela devra être un dépôt local ; les dépôts distants sont gérés sur le système distant. (Le dépôt "Local" par défaut créé dans chaque nouveau système/locataire VergeOS serait généralement utilisé.)
2. Cliquez sur Catalogues dans le menu de gauche, puis cliquez sur Nouveau.
3. Fournissez une Nom descriptive pour le catalogue. En option, des informations administratives supplémentaires peuvent être ajoutées dans le champ de description.
4. Sélectionnez une Portée de publication pour définir l’accessibilité du catalogue :

   • Privé - uniquement disponible pour ce Cloud VergeOS particulier.
   • Aucune - désactivé, indisponible partout
   • Locataire - disponible pour ce Cloud particulier et ses propres locataires
   • Global - disponible pour ce système particulier, ses locataires et les systèmes VergeOS externes (identifiants utilisateur nécessaires)

Partage de recettes

Partager des catalogues avec vos locataires

1. Définissez la Portée de publication = 'Locataires' (ou 'Global', ce qui permettra également l’accès aux systèmes externes à l’aide des identifiants appropriés).
2. Passez à l’interface utilisateur du locataire pour le reste des étapes.
3. Accédez à la Fournisseur de services dépôt et cliquez sur Actualiser.
4. Double-cliquez sur le catalogue souhaité pour voir les recettes qu’il contient.
5. Cliquez sur Recettes VM -ou- Recettes locataire pour voir la liste correspondante.
6. Sélectionnez la ou les recettes souhaitées.
7. Cliquez sur Télécharger/Mettre à jour dans le menu de gauche pour télécharger dans l’environnement du locataire. Lorsqu’une recette affiche l’état En ligne elle est disponible à l’utilisation.

Lorsqu’une recette est mise à jour à la source, un message s’affichera dans l’interface utilisateur du locataire indiquant qu’une mise à jour est disponible au téléchargement.

Partager des catalogues vers un système distant

Accorder l’accès à un catalogue (côté partage)

1. Créez un nouvel utilisateur, avec Type : API à utiliser pour l’authentification par le système/locataire distant. Notez le nom d’utilisateur et le mot de passe.
2. Accédez à la Tableau de bord du catalogue (Dépôts > Catalogues > double-cliquez sur le catalogue souhaité).
3. Cliquez sur Autorisations dans le menu de gauche.
4. Cliquez sur Ajouter un utilisateur dans le menu de gauche.
5. Définissez les champs suivants pour la nouvelle autorisation :

   • Bénéficiaire: l’utilisateur API créé ci-dessus
   • Autorisations : Liste et lecture
   • Type : Catalogues
   • Nom : nom du catalogue qui est partagé
6. Cliquez sur Soumettre pour enregistrer la nouvelle autorisation.

Se connecter à un catalogue distant (côté réception) :

1. Accédez à Dépôts > + Nouveau dépôt.
2. Complétez les champs pour le nouveau dépôt :

   • Nom : un nom descriptif qui aide à distinguer ce dépôt.
   • Description : (facultatif) des informations supplémentaires saisies ici peuvent être utiles pour l’administration future.
   • Type : Distant
   • URL : l’entrée IP ou DNS du système hôte, par exemple https://VergeOS.example.com
   • Utilisateur/Mot de passe : utilisez les identifiants de l’utilisateur API créé sur le système hôte (ci-dessus).
   • Autoriser les certificats non sécurisés : cette option est fournie pour prendre en charge un certificat auto-signé au sein du même réseau privé ; utiliser une URL publique sans SSL sécurisé peut être risqué et n’est pas recommandé.
   • Niveau le plus rapide max : vous permet de spécifier le meilleur niveau à utiliser pour les disques des recettes (par exemple, si une recette a un disque au niveau 2 sur le système distant, et si ce paramètre est défini sur le niveau 4, le disque sera déplacé vers le niveau 4 lors du téléchargement.)
3. Cliquez sur Soumettre pour enregistrer le nouveau dépôt.
4. Une fois créé, accédez au tableau de bord du dépôt et cliquez sur Actualiser pour recharger ses catalogues. Les recettes peuvent être téléchargées localement, puis seront disponibles pour être utilisées lors de la création d’une nouvelle VM/locataire.

Lorsque le système distant crée le dépôt qui se connecte à votre système, il aura accès à tous vos catalogues pour lesquels l’utilisateur API donné possède des autorisations.

Lorsqu’une recette est mise à jour à la source, un message s’affichera dans l’interface utilisateur du système distant indiquant qu’une mise à jour est disponible au téléchargement.