Créer et gérer des déploiements

Un déploiement de projet Apps Script est une version du script disponibles comme application Web, module complémentaire ou exécutable d'API. En créant et en gérer les déploiements, vous pouvez itérer sur votre code, effectuer le suivi des modifications, et contrôler la version de code exacte à laquelle vos utilisateurs ont accès.

Il existe deux types de déploiements:

  • Les déploiements principaux, qui sont toujours synchronisés avec le code du projet actuel.
  • Les déploiements avec des versions gérées, qui sont connectés à une version de projet spécifique

Déploiements principaux

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

Le déploiement "head" est toujours synchronisé avec le dernier code enregistré. Pour Par exemple, si vous créez un déploiement avec versions gérées et que vous modifiez votre code, le déploiement "head" reflète ces modifications, tandis que le déploiement avec gestion des versions intacts.

Utilisez les déploiements "head" pour tester le code. N'utilisez pas les déploiements "head" pour un usage public.

Déploiements avec des versions gérées

Un déploiement avec versions gérées rend disponible une version spécifique du code du projet. Cela permet à vos utilisateurs de continuer à utiliser une version fonctionnelle pendant que vous effectuez de modifications et d'améliorations du code.

Lorsque votre application est publiée pour une utilisation publique, utilisez toujours un avec gestion des versions. Vous pouvez disposer de plusieurs déploiements actifs avec gestion des versions une seule fois.

Important: Vous ne pouvez pas transférer la propriété des déploiements avec versions gérées. Si vous transférer la propriété d'un projet de script à quelqu'un, le propriétaire les déploiements avec versions gérées du projet ne changent pas. Si un administrateur supprime le compte du propriétaire du déploiement, vous pouvez rencontrer des erreurs de script pour lors de leurs déploiements.

Créer un déploiement avec versions gérées

Pour déployer une version d'un module complémentaire Google Workspace, Module complémentaire d'éditeur, application Google Chat ou API exécutable, vous devez d'abord changer la configuration Association de projet Google Cloud du projet par défaut à un projet standard projet.

Pour créer un déploiement avec versions gérées, procédez comme suit:

  1. Ouvrez le projet Apps Script.
  2. En haut à droite, cliquez sur Déployer > Nouveau déploiement.
  3. À côté de Sélectionner le type, cliquez sur "Activer les types de déploiement".
  4. Sélectionnez le type de déploiement que vous souhaitez déployer. Pour les modules complémentaires Google Workspace et des éditeurs Pour les applications Google Chat, sélectionnez Module complémentaire.
  5. Saisissez les informations concernant votre déploiement, puis cliquez sur Déployer.

Afficher les déploiements avec gestion des versions

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

Pour afficher le code d'une version spécifique, reportez-vous à la section Consulter une version.

Modifier un déploiement avec gestion des versions

Vous pouvez modifier un déploiement avec gestion des versions pour changer sa description ou sa version. À 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".
  4. Apportez les modifications souhaitées, puis cliquez sur Déployer.

    Pour modifier un déploiement archivé, vous devez le redéployer, puis suivez les étapes précédentes.

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

Trouver un ID de déploiement

Chaque déploiement est associé à un identifiant 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 n'apparaissent 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.

Module complémentaire Google Workspace

Pour tester le déploiement d'un module complémentaire Google Workspace, consultez Test des modules complémentaires Google Workspace

Module complémentaire de l'éditeur

Pour tester le déploiement d'un module complémentaire d'éditeur, consultez Tester un module complémentaire d'éditeur.

Application Web

Pour tester le déploiement d'une application Web, consultez la section Tester le déploiement d'une application Web

Application Google Chat

Pour tester le déploiement d'une application Chat, vous devez d'abord créer un déploiement avec versions gérées du script pour accéder à son ID de déploiement.

Une fois que vous disposez de l'ID de déploiement, suivez les étapes pour activer l'API Google Chat. Le la page de configuration sous « Autorisations », indiquez uniquement votre adresse e-mail pour installer et tester votre application.

Exécutable d'API

Pour tester le déploiement d'un exécutable d'API, vous devez d'abord créer un déploiement avec versions gérées. Une fois le déploiement créé, suivez les instructions procédez comme suit:

  1. En haut à droite du projet Apps Script, cliquez sur Déployer > Tests Déploiements.
  2. À côté de "Sélectionner un type", cliquez sur Activer les types de déploiement . > exécutable d'API.
  3. Copiez l'URL et utilisez-la pour tester votre déploiement de l'API exécutable.

Archiver un déploiement avec gestion des versions

Vous ne pouvez pas supprimer les déploiements avec des versions gérées. En revanche, vous pouvez les archiver.

Pour archiver un déploiement avec versions gérées:

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

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électionnez le déploiement que vous souhaitez redéployer. puis cliquez sur Modifier . > Déployer.