> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/fr/automatisation/marketplace-vm-recipes.md).

# Catalogue Marketplace VergeOS : recettes de VM

## Vue d’ensemble

{% hint style="info" %}
**Points clés**

* Le catalogue Marketplace de VergeOS fournit une collection sélectionnée de recettes de VM préconfigurées.
* Les recettes permettent un déploiement rapide, en libre-service, de machines virtuelles avec des paramètres optimisés.
* Chaque recette simplifie le provisionnement des systèmes d'exploitation et des applications courants.
* Les utilisateurs peuvent personnaliser des paramètres clés comme le CPU, la RAM, le stockage et la mise en réseau lors du déploiement.
  {% endhint %}

Le catalogue Marketplace de VergeOS offre un moyen puissant d'accélérer les déploiements de vos machines virtuelles. Au lieu de configurer manuellement chaque nouvelle VM, la Marketplace propose des recettes prêtes à l'emploi pour une variété de systèmes d'exploitation et d'applications. Ces recettes sont optimisées pour l'environnement VergeOS, garantissant une utilisation efficace des ressources et des configurations cohérentes.

Ce guide vous présentera les recettes de VM disponibles dans votre catalogue Marketplace et expliquera les options de configuration courantes auxquelles vous pouvez vous attendre lors de leur déploiement.

## Accéder au catalogue Marketplace

Pour accéder aux recettes de VM du Marketplace et les déployer :

1. Connectez-vous à votre système VergeOS.
2. Accédez à **Machines** dans le menu de gauche.
3. Cliquez sur **Nouvelle VM**.
4. Dans la section « Select Type » à gauche, choisissez Marketplace (ou un catalogue Marketplace spécifique comme « Operating Systems (Marketplace) » ou « Applications (Marketplace) »).

Les recettes disponibles apparaîtront alors pour sélection, classées par leur fonction principale (par ex. systèmes d'exploitation, applications, services).

## Options de configuration courantes des recettes

Lors du déploiement d'une VM à partir d'une recette Marketplace, vous verrez généralement un ensemble de questions vous permettant de personnaliser la nouvelle instance de machine virtuelle. Ces questions sont conçues pour couvrir les besoins de configuration les plus courants.

Voici les catégories de paramètres que vous pouvez généralement vous attendre à configurer :

### 1. Paramètres de l'instance VM

Ces options contrôlent le matériel et l'identité de base de votre machine virtuelle :

* **Cœurs (`YB_CPU_CORES`):** Le nombre de cœurs CPU virtuels attribués à la VM.
* **RAM (`YB_RAM`):** La quantité de RAM virtuelle attribuée à la VM (par ex. en Mo ou Go).
* **Nom d'hôte (`YB_HOSTNAME`):** Le nom d'hôte réseau de la VM.
* **Activer UEFI (`SELECT_CREATE_UEFI`):** Une option booléenne (Oui/Non) permettant d'activer le mode de démarrage Unified Extensible Firmware Interface (UEFI) pour la VM.
* **Désactiver Cloud-init après le premier démarrage (`YB_DISABLE_CLOUDINIT`):** Pour les VM Linux, cela permet de désactiver le service cloud-init après son exécution initiale, empêchant d'autres modifications de configuration lors des démarrages suivants. Les options incluent souvent `true`, `false`, ou `purge`.
* **Détacher l'instance de recette (`YB_DETACH_RECIPE`):** Une option masquée qui peut contrôler si la VM reste liée à la recette (pour les mises à jour futures) ou devient une VM autonome après création.

### 2. Paramètres réseau

Ces options définissent comment votre VM se connectera aux réseaux et obtiendra des adresses IP :

* **Sélectionnez le type d'adresse IP (`YB_IP_ADDR_TYPE`):** Choisissez entre `dhcp` (Dynamic Host Configuration Protocol) pour l'attribution automatique d'une IP ou `statique` pour une configuration manuelle.
* **Réseau pour le réseau externe (`YB_NIC_ETH0_EXTERNAL_GATEWAY`):** Le réseau externe auquel la carte réseau principale (eth0) de la VM se connectera.
* **Adresse IP pour (eth0) (`YB_NIC_ETH0_IP_ADDR`):** Si `statique` IP est sélectionné, c'est ici que vous saisissez l'adresse IP spécifique de la VM.
* **Masque de sous-réseau CIDR (`YB_NIC_ETH0_CIDR`):** Le masque de sous-réseau pour l'adresse IP statique (par ex., `/24`).
* **Passerelle par défaut (`YB_NIC_ETH0_GW`):** La passerelle par défaut du réseau de la VM.
* **Serveurs de noms (`YB_NIC_ETH0_NS`):** Une liste d'adresses IP de serveurs DNS séparées par des virgules.

### 3. Paramètres de stockage

Ces options contrôlent la taille du disque principal de la VM :

* **Taille du disque OS (`YB_DRIVE_OS_SIZE`):** La taille du disque virtuel du système d'exploitation (par ex. en Go).
* **Niveau du disque OS (`SELECT_OS_TIER`):** Sélectionne le niveau de stockage préféré pour le disque OS de la VM (par ex., niveau 1 pour hautes performances, niveau 5 pour l'archivage).

### 4. Création de compte utilisateur

Les recettes incluent souvent des options pour créer des comptes utilisateurs initiaux dans le système d'exploitation invité :

* **Nom d'utilisateur (`YB_USER`):** Le nom d'utilisateur du compte administrateur initial ou du compte utilisateur standard.
* **Mot de passe (`YB_PASSWORD`):** Le mot de passe de l'utilisateur spécifié.

### 5. Personnalisations spécifiques au système d'exploitation

Certaines recettes incluent des options adaptées au système d'exploitation spécifique qu'elles déploient :

* **ISO Windows (`WINDOWS_ISO`):** Pour les recettes Windows, cela permet de sélectionner l'image ISO spécifique pour l'installation de Windows (par ex., `windows-2025-evaluation-os-disk.iso`).
* **Clé de licence Windows (`WINDOWS_LICENSE_KEY`):** Un champ facultatif pour saisir une clé de licence Windows pour l'activation.
* **Activer RDP (`ENABLE_RDP`):** Une option booléenne (Oui/Non) permettant d'activer le protocole Bureau à distance pour les VM Windows.
* **Accès à l'interface utilisateur depuis l'interne (`YB_ACCESS_UI_FROM_INTERNAL`):** Pour certaines instances VergeOS basées sur Windows, cette option contrôle l'accès à son interface utilisateur depuis les réseaux internes.
* **Nom du téléchargement VirtIO (`VIRTIO_DL_NAME`):** Pour Windows, cela fait référence à l'ISO du pilote VirtIO à utiliser pour injecter des pilotes dans le système d'exploitation invité.

### 6. Automatisation en coulisses (`Base de données` Questions de type)

De nombreuses recettes incluent des étapes d'automatisation avancées qui peuvent interagir avec la base de données VergeOS ou d'autres services. Ces questions apparaissent souvent avec un `Base de données` type et sont généralement préconfigurées par l'éditeur de la recette. Exemples :

* **Créer le disque OS (`CREATE_OS_DRIVE`):** Crée automatiquement le disque virtuel du système d'exploitation.
* **Télécharger l'ISO Windows (`YB_DOWNLOAD_WINDOWS_ISO`):** Lance le téléchargement de l'ISO Windows depuis une URL spécifiée.
* **Télécharger VirtIO (`YB_DOWNLOAD_VIRTIO`):** Lance le téléchargement de l'ISO du pilote VirtIO.
* **Créer le CD-ROM VirtIO (`YB_CREATE_VIRTIO_CD_DL`):** Crée un lecteur CD-ROM virtuel et y attache l'ISO VirtIO téléchargée pour l'installation automatique des pilotes.
* **Obtenir le CPU du cluster (`GET_CLUSTER_CPU`):** Interroge le cluster pour obtenir les informations CPU disponibles.
* **Modifier le CPU du cluster (`CHANGE_CLUSTER_CPU`):** Modifie programmatiquement les paramètres CPU du cluster.
* **Modifier le type de machine (`EDIT_MACHINE_TYPE`):** Ajuste le type de machine de la VM après sa création.

Ces `Base de données` opérations mettent en évidence la puissance des recettes VergeOS, qui permettent non seulement de déployer des VM, mais aussi d'effectuer des tâches complexes et automatisées lors du provisionnement.

## Recettes disponibles dans le catalogue Marketplace

Le catalogue Marketplace est continuellement mis à jour avec de nouvelles recettes. Voici une liste des recettes couramment disponibles, classées par utilisation principale :

### Systèmes d'exploitation

Ces recettes fournissent des machines virtuelles préconfigurées avec divers systèmes d'exploitation Linux et Windows. Elles sont généralement livrées avec des paramètres par défaut qui peuvent être personnalisés à l'aide des options décrites ci-dessus.

* **AlmaLinux 8 et 9 (dernières versions) :** Installations minimales d'AlmaLinux pour les environnements d'entreprise.
* **CentOS 7 (dernière version) :** Une distribution Linux stable et largement utilisée.
* **CentOS Stream 8 :** Une distribution Linux à publication continue.
* **Debian 10 (Buster), 11 (Bullseye) :** Des distributions basées sur Debian, stables et populaires.
* **Fedora 35, 36, 37, 38 :** Des versions Fedora à la pointe de la technologie pour le développement et les tests.
* **Rocky Linux 8 et 9 (dernières versions) :** Des distributions Linux d'entreprise compatibles binaire avec RHEL.
* **Ubuntu Server 18.04 (Bionic Beaver), 20.04 (Focal Fossa), 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat) :** Versions de support à long terme (LTS) d'Ubuntu Server, idéales pour les charges de travail de production.
* **Windows 2025 - Évaluation :** Une image d'évaluation pour la prochaine version de Windows Server.
* **Windows 2022 - Évaluation :** Une image d'évaluation pour Windows Server 2022.
* **Évaluation Windows Server 2019 :** Une image d'évaluation pour Windows Server 2019.
* **Amazon Linux 2 LTS :** Une distribution Linux optimisée pour Amazon.

### Applications

Ces recettes s'appuient généralement sur un système d'exploitation sous-jacent et incluent des applications préinstallées pour des cas d'utilisation spécifiques.

* **Stack LAMP :** Une pile de serveur web Linux, Apache, MySQL, PHP.
* **Docker :** Une plateforme de conteneurisation préinstallée.
* **Grafana :** Une plateforme open source populaire pour la supervision et l'observabilité.
* **OpenVPN-AS :** OpenVPN Access Server pour des solutions VPN.
* **Kubernetes K3S :** Une distribution Kubernetes légère.

### Services

Ces recettes offrent des services spécialisés ou des VM utilitaires pour gérer votre environnement VergeOS.

* **Poste de dépannage du locataire :** Une VM utilitaire souvent utilisée pour le dépannage ou la récupération dans un environnement locataire.

## Utiliser une recette

Une fois que vous avez sélectionné une recette et cliqué sur « Suivant », vous serez guidé à travers le formulaire « Questions », où vous pourrez saisir les configurations souhaitées. Après avoir rempli tous les champs obligatoires, cliquez sur « Soumettre » pour lancer le processus de création de la VM. L'automatisation de la recette provisionnera alors votre nouvelle machine virtuelle selon vos sélections.

## Avantages de l'utilisation des recettes Marketplace

* **Rapidité :** Déployez de nouvelles VM en quelques minutes, pas en heures.
* **Cohérence :** Garantissez que tous les déploiements respectent les meilleures pratiques prédéfinies.
* **Simplicité :** Réduisez la complexité de la configuration manuelle des VM.
* **Libre-service :** Permettez aux utilisateurs de provisionner leurs propres ressources avec des options contrôlées.
* **Automatisation :** Tirez parti du puissant moteur de recettes VergeOS pour les tâches avancées de provisionnement.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/automate-protect-and-extend/fr/automatisation/marketplace-vm-recipes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
