> 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/recipes-organization.md).

# Organisation des recettes

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.

```mermaid
graph TD
    A["Dépôt"] --> B("Catalogue 1")
    A --> C("Catalogue 2")
    A --> D("Catalogue 3")
    B --> E("Recette VM")
    B --> F("Recette VM")
    C --> G("Recette locataire")
    C --> H("Recette locataire")
    D --> I("Recette VM")
    D --> J("Recette locataire")
    D --> K("Recette VM")
```

* **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.

{% hint style="info" %}
**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.**
{% endhint %}

### 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.

{% hint style="info" %}
**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.**
{% endhint %}

{% hint style="info" %}
**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.**
{% endhint %}


---

# 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/recipes-organization.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.