Créer et gérer des déploiements

Le déploiement d'un projet Apps Script correspond à une version du script qui est disponible pour être utilisée en tant qu'application Web, module complémentaire ou exécutable d'API. En créant et en gérant des déploiements, vous pouvez itérer sur votre code, suivre vos modifications et contrôler la version exacte du code à laquelle vos utilisateurs ont accès.

Il existe deux types de déploiements :

• Les déploiements de tête, qui sont toujours synchronisés avec le code du projet actuel.
• Les déploiements versionnés, qui sont associés à une version spécifique du projet.

Déploiements Head

Un déploiement "head" correspond au code du projet actuel. Lorsque vous créez un projet Apps Script, vous créez automatiquement un déploiement principal pour ce projet.

Le déploiement de tête est toujours synchronisé avec le code enregistré le plus récemment. Par exemple, si vous créez un déploiement versionné, puis que vous modifiez votre code, le déploiement principal reflète ces modifications, tandis que le déploiement versionné reste intact.

Utilisez les déploiements de tête pour tester le code. N'utilisez pas les déploiements de tête pour un usage public.

Déploiements avec version

Un déploiement versionné met à disposition une version spécifique du code du projet. Vos utilisateurs peuvent ainsi continuer à utiliser une version fonctionnelle pendant que vous apportez des modifications et des améliorations au code.

Lorsque votre application est publiée pour le public, utilisez toujours un déploiement versionné. Vous pouvez avoir plusieurs déploiements versionnés actifs en même temps.

Important : Vous ne pouvez pas transférer la propriété des déploiements versionnés. Si vous transférez la propriété d'un projet de script à une autre personne, le propriétaire des déploiements versionnés existants dans le projet ne change pas. Si un administrateur supprime le compte du propriétaire du déploiement, des erreurs de script peuvent se produire pour ses déploiements.

Créer un déploiement versionné

Pour déployer une version d'un module complémentaire Google Workspace, d'un module complémentaire Editor, d'une application Google Chat ou d'un exécutable d'API, vous devez d'abord modifier l'association du projet Google Cloud de votre script Apps Script, en passant du projet par défaut à un projet standard.

Pour créer un déploiement versionné, procédez comme suit :

1. Ouvrez le projet Apps Script.
2. En haut à droite, cliquez sur Déployer > Nouveau déploiement.
3. En regard de Sélectionner le type, cliquez sur Activer les types de déploiement settings.
4. Sélectionnez le type de déploiement que vous souhaitez déployer. Pour les modules complémentaires Google Workspace, les modules complémentaires des éditeurs et les applications Google Chat, sélectionnez Module complémentaire.

5. Saisissez les informations sur votre déploiement, puis cliquez sur Déployer.

Afficher les déploiements versionnés

Pour afficher les déploiements d'un projet Apps Script, cliquez sur Déployer > Gérer les déploiements en haut de la page.

Pour afficher le code d'une version spécifique, consultez Afficher une version précédente.

Modifier un déploiement versionné

Vous pouvez modifier un déploiement versionné pour changer sa description ou sa version. Pour modifier un déploiement, procédez comme suit :

1. Ouvrez le projet Apps Script.
2. Cliquez sur Déployer > Gérer les déploiements.
3. Sélectionnez le déploiement actif que vous souhaitez modifier, puis cliquez sur Modifier edit.

4. Apportez les modifications souhaitées, puis cliquez sur Déployer.

   Si vous souhaitez modifier un déploiement archivé, vous devez le redéployer, puis suivre les étapes précédentes.

   Lorsque vous souhaitez déployer une modification du code du projet, créez une version et modifiez le déploiement pour l'utiliser. La nouvelle version est automatiquement utilisée par tous les utilisateurs qui utilisent ce déploiement.

Trouver un ID de déploiement

Chaque déploiement est associé à un ID de chaîne créé automatiquement. Pour trouver cet ID, procédez comme suit :

1. Ouvrez le projet Apps Script.
2. En haut à droite, cliquez sur Déployer > Gérer les déploiements.

3. Sélectionnez un déploiement actif pour trouver son ID.

   Les ID de déploiement ne s'affichent que pour les déploiements actifs.

Tester un déploiement

La façon dont vous testez un déploiement dépend du type d'application que vous créez.

Archiver un déploiement avec version

Vous ne pouvez pas supprimer les déploiements versionnés. À la place, vous pouvez les archiver.

Pour archiver un déploiement avec version :

1. Ouvrez le projet Apps Script.
2. Cliquez sur Déployer > Gérer les déploiements.
3. Sélectionnez le déploiement que vous souhaitez archiver, puis cliquez sur Archiver le déploiement archive.

Redéployer un déploiement archivé

1. Ouvrez le projet Apps Script.
2. En haut à droite, cliquez sur Déployer > Gérer les déploiements.
3. À gauche, sous Archivés, sélectionnez le déploiement que vous souhaitez redéployer, puis cliquez sur Modifier edit > Déployer.