> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/actions/workflow-concepts/publishing-and-versioning.md).

# Publication et gestion des versions

Suivez les changements et mettez les applications en production avec des versions

Le versionnement vous permet de gérer facilement les instances historiques, les brouillons et les versions par défaut publiées de vos workflows.

## Quelle est la différence entre un brouillon, une version et une version par défaut ?

1. **Brouillons** ne sont pas enregistrés de façon permanente, et seul le dernier brouillon est sauvegardé.
2. **Versions** en revanche, sont enregistrées de façon permanente. Elles peuvent toujours être consultées et restaurées. Vous pouvez également exécuter des versions de workflows par lot, via l’API, ou les ajouter à un autre workflow ou agent
3. La **Version par défaut** est la version du workflow qui :
   1. avec laquelle les utilisateurs interagissent dans l’interface AirOps
   2. s’exécute lorsque vous appelez le point de terminaison POST Execute, sauf si une autre version est passée en paramètre

## Comment créer une nouvelle version ?

Lorsque vous êtes prêt à partager, intégrer ou exécuter votre workflow, publiez-le en une version permanente en cliquant sur « **Publier le workflow »** en haut à droite :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-7e953d5aed2f203c0c5c53b2dcff27ae4833904e%2FCleanShot%202025-02-27%20at%2006.22.09%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

Cela génère la « Version 1 » de votre workflow, qui agit désormais comme version par défaut.

### Noms et descriptions de version personnalisés

Lors de la publication d’une nouvelle version, vous pouvez ajouter un nom et une description personnalisés pour aider à suivre les changements significatifs :

1. Cliquez sur **Publier le workflow**
2. Saisissez un **nom de version** (par ex. « Ajout d’une étape d’optimisation SEO »)
3. Ajoutez une **description** expliquant ce qui a changé dans cette version
4. Cliquez sur **Publier**

Les noms et descriptions personnalisés permettent à votre équipe de mieux comprendre ce que contient chaque version et pourquoi elle a été créée, en particulier lors de l’examen de l’historique des versions ou du retour en arrière sur des modifications.

## Que se passe-t-il avec ma version précédente si je republie ?

Toutes les versions publiées précédemment sont enregistrées de façon permanente, et une nouvelle version devient la version par défaut.

## Utiliser les versions précédentes

Pour afficher les versions précédentes de votre workflow, cliquez simplement sur le menu déroulant **« Versions »** et sélectionnez la version souhaitée :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-06e8e76365aae555cae2a00fc2a6c9db271d2a82%2FCleanShot%202025-02-27%20at%2006.23.01%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Votre brouillon ne sera PAS écrasé en cliquant simplement sur une version précédente.
{% endhint %}

### Restaurer les versions précédentes en tant que brouillon

Pour restaurer une version précédente dans votre brouillon actuel, commencez par sélectionner la version historique souhaitée dans le menu déroulant, puis cliquez sur **« Restaurer. »**

{% hint style="info" %}
Votre brouillon actuel SERA écrasé en cliquant sur **« Restaurer, »** alors assurez-vous de n’avoir aucune modification susceptible d’être perdue.
{% endhint %}

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d36146dd3eb58e30245b76c2d443038ac4fc4c20%2FCleanShot%202025-02-27%20at%2006.24.22%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

Cela transforme votre version historique en brouillon actuel, que vous pouvez ensuite choisir d’enregistrer ou de publier.

### Définir les versions précédentes comme version par défaut

Pour restaurer une version précédente afin qu’elle devienne votre version par défaut, commencez à nouveau par sélectionner la version historique souhaitée dans le menu déroulant, puis cliquez sur **« Définir par défaut. »**

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b5e218367f554367354b1f4c60488d3d70264f97%2FCleanShot%202025-02-27%20at%2006.25.53%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

Lorsque vous changez la version par défaut, seule la version en production est modifiée. Le dernier brouillon ne change PAS.

## Référencer les versions via l’API

Une fois que vous avez plusieurs versions de votre workflow, vous pouvez spécifier quelle version exacte exécuter via l’API AirOps.

Pour ce faire, revenez à la fenêtre d’affichage de votre workflow et cliquez sur l’onglet **« Intégrer »** en haut :

La commande POST générale s’exécutera toujours sur la version par défaut, tandis que le point de terminaison de versionnement vous permet de spécifier la version souhaitée à exécuter.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/actions/workflow-concepts/publishing-and-versioning.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.