Créer et gérer des déploiements pour votre application Google Chat
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment créer et gérer des déploiements pour votre application Google Chat. En conservant différents déploiements, vous pouvez mieux gérer chaque phase du cycle de vie de votre application Chat et déployer les modifications en production de manière sécurisée.
Créer des déploiements pour chaque phase du cycle de vie de l'application
Pour gérer votre application Chat tout au long de son cycle de vie, nous vous recommandons de créer et de déployer une application Chat pour chacun des environnements suivants :
- Développement : environnement que vous utilisez pour travailler sur les modifications. Si nécessaire, vous pouvez utiliser le déploiement principal ou exécuter cet environnement en local.
- Préproduction : environnement dans lequel vous déployez les tests de bout en bout auprès de testeurs de confiance. Cet environnement doit être aussi proche que possible de la production.
- Production : environnement que vous déployez auprès des utilisateurs finaux en publiant votre application Chat sur Google Workspace Marketplace.
Pour chaque application Chat que vous déployez, vous devez créer un projet Google Cloud. Lorsque vous configurez l'API Chat dans chaque projet Cloud, pensez à utiliser un nom d'application, une URL d'avatar et une description distincts afin de mieux distinguer les applications Chat dans Google Chat.
Dans l'exemple suivant, l'application Chat appelée Task app
est basée sur HTTP et utilise différents points de terminaison pour le déploiement en développement, en préproduction et en production :
Environnement |
Nom du projet Cloud |
Nom de l'application |
URL du point de terminaison HTTP |
Développement |
task-chat-app-dev |
Application Dev Task |
http://example.com/api/myapp/head |
Préproduction |
task-chat-app-staging |
Application Staging Task |
http://example.com/api/myapp/staging |
Production |
task-chat-app |
Application Tasks |
http://example.com/api/myapp/ |
Gérer les déploiements en fonction de l'architecture de votre application Chat
Le tableau suivant inclut des éléments supplémentaires à prendre en compte lors de la gestion des déploiements pour des architectures d'applications de chat spécifiques :
Architecture |
Format de déploiement |
Remarques |
HTTP |
URL du point de terminaison HTTP |
- Déployez les modifications de manière progressive sur chaque point de terminaison du cycle de vie de votre application de chat. Par exemple, après avoir testé une nouvelle fonctionnalité déployée dans votre point de terminaison de préproduction
http://example.com/api/myapp/staging , déployez-la dans votre point de terminaison de production, tel que http://example.com/api/myapp , pour la mettre en production.
- Pour déboguer le code avant de le déployer, vous pouvez définir un point de terminaison sur votre environnement local. Pour savoir comment tester les modifications localement, consultez Déboguer des applications Google Chat.
|
Google Apps Script |
ID de déploiement |
- Les projets Apps Script ne peuvent comporter qu'une seule branche et être associés à un seul projet Cloud. Pour tester les modifications et gérer plusieurs environnements, vous devez créer différents projets Apps Script pour chaque environnement.
- Vous ne devez utiliser le déploiement Head du projet Apps Script que pour l'environnement de développement. Pour les environnements de préproduction et de production, utilisez des déploiements avec versions. Pour en savoir plus, consultez Créer et gérer des déploiements dans la documentation Apps Script.
|
Pub/Sub |
Sujet Pub/Sub |
Vous devez utiliser un sujet Pub/Sub différent pour chaque déploiement. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eManage your Google Chat app's lifecycle by creating separate deployments for development, staging, and production environments.\u003c/p\u003e\n"],["\u003cp\u003eCreate a distinct Google Cloud project for each deployment, using unique app names, avatar URLs, and descriptions for clarity.\u003c/p\u003e\n"],["\u003cp\u003eDeploy changes progressively through each environment, starting with development and moving to staging before releasing to production.\u003c/p\u003e\n"],["\u003cp\u003eFor Apps Script projects, maintain separate projects for each environment due to their single-branch limitation.\u003c/p\u003e\n"],["\u003cp\u003eUtilize different Pub/Sub topics for individual deployments to ensure environment isolation.\u003c/p\u003e\n"]]],["The document outlines creating and managing deployments for Google Chat apps across development, staging, and production environments. Each environment requires a separate Google Cloud project with a distinct app name and details. Deployment methods vary: HTTP uses endpoint URLs, Apps Script utilizes deployment IDs and separate projects, and Pub/Sub employs unique topics. Changes should be progressively deployed, starting from development, then staging, and finally production. Different app architectures require different consideration.\n"],null,["# Create and manage deployments for your Google Chat app\n\nThis page explains how to create and management deployments for your\nGoogle Chat app. By maintaining different deployments, you can\nbetter manage each phase of your Chat app's lifecycle\nand safely release changes to production.\n\nCreate deployments for each phase of the app lifecycle\n------------------------------------------------------\n\nTo manage your Chat app throughout its lifecycle, we\nrecommend that you create and deploy a Chat app for\neach of the following environments:\n\n- **Development:** The environment that you use to work on changes. If needed, you can use the head deployment or run this environment locally.\n- **Staging:** The environment that you deploy to trusted testers for end-to-end testing. This environment should be as close to production as possible.\n- **Production:** The environment that you deploy to end users by [publishing\n your Chat app to the\n Google Workspace Marketplace](/workspace/marketplace/how-to-publish).\n\nFor each Chat app that you deploy, you must create a\nGoogle Cloud project. When you configure the Chat API in each\nCloud project, consider using a distinct app name, avatar URL, and\ndescription so that you can better distinguish between the\nChat apps in Google Chat.\n\nIn the following example, the Chat app\ncalled `Task app` is built on HTTP and uses different endpoints to deploy to\ndevelopment, staging, and production:\n\n| Environment | Cloud project name | App name | HTTP endpoint URL |\n|-------------|-------------------------|------------------|----------------------------------------|\n| Development | `task-chat-app-dev` | Dev Task app | `http://example.com/api/myapp/head` |\n| Staging | `task-chat-app-staging` | Staging Task app | `http://example.com/api/myapp/staging` |\n| Production | `task-chat-app` | Task app | `http://example.com/api/myapp/` |\n\n### Manage deployments based on your Chat app architecture\n\nThe following table includes additional considerations when managing deployments\nfor specific [Chat app\narchitectures](/workspace/chat/structure):\n\n| Architecture | Deployment format | Considerations |\n|--------------------|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| HTTP | HTTP endpoint URL | - Deploy changes progressively to each endpoint in your Chat app's lifecycle. For example, after you've tested a new feature deployed in your staging endpoint `http://example.com/api/myapp/staging`, release the feature to production by deploying it to your production endpoint, such as `http://example.com/api/myapp`. - To debug code before deploying, you can set an endpoint to your local environment. To learn how to test changes locally, see [Debug Google Chat apps](/chat/troubleshoot/debug). |\n| Google Apps Script | Deployment ID | - Apps Script projects can only have a single branch and be associated with one Cloud project. To test changes and maintain multiple environments, you must create different Apps Script projects for each environment. - You should only use the Apps Script project's head deployment for the development environment. For staging and production environments, use versioned deployments. For details, see [Create and manage deployments](/apps-script/concepts/deployments) in the Apps Script documentation. |\n| Pub/Sub | Pub/Sub topic | You should use a different Pub/Sub topic for each deployment. |\n\nRelated topics\n--------------\n\n- [Test interactive features for Google Chat apps](/workspace/chat/test-interactive-features)\n- [Create and manage Apps Script deployments](/apps-script/concepts/deployments)\n- [Choose a Chat app architecture](/workspace/chat/structure)"]]