Criar e gerenciar implantações para seu app do Google Chat
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, explicamos como criar e gerenciar implantações para seu
app do Google Chat. Ao manter implantações diferentes, você pode
gerenciar melhor cada fase do ciclo de vida do app
e lançar mudanças na produção com segurança.
Criar implantações para cada fase do ciclo de vida do app
Para gerenciar seu app do Chat durante todo o ciclo de vida, recomendamos que você crie e implante um app do Chat para cada um dos seguintes ambientes:
- Desenvolvimento:o ambiente usado para trabalhar nas mudanças. Se
necessário, use a implantação principal ou execute esse ambiente localmente.
- Preparo:o ambiente em que você implanta para trusted testers para
testes completos. Esse ambiente precisa ser o mais próximo possível da produção.
- Produção:o ambiente que você implanta para usuários finais ao publicar
o app do Chat no
Google Workspace Marketplace.
Para cada app do Chat implantado, é necessário criar um projeto do Google Cloud. Ao configurar a API Chat em cada projeto do Cloud, use um nome de app, um URL de avatar e uma descrição diferentes para distinguir melhor os apps de chat no Google Chat.
No exemplo a seguir, o app de chat
chamado Task app é criado em HTTP e usa endpoints diferentes para implantação em
desenvolvimento, preparo e produção:
| Ambiente |
Nome do projeto do Cloud |
Nome do app |
URL do endpoint HTTP |
| Desenvolvimento |
task-chat-app-dev |
App Dev Task |
http://example.com/api/myapp/head |
| Preparo |
task-chat-app-staging |
App Staging Task |
http://example.com/api/myapp/staging |
| Produção |
task-chat-app |
App Tarefas |
http://example.com/api/myapp/ |
Gerenciar implantações com base na arquitetura do app de chat
A tabela a seguir inclui outras considerações ao gerenciar implantações
para arquiteturas de apps de chat específicas:
| Arquitetura |
Formato de implantação |
Considerações |
| HTTP |
URL do endpoint HTTP |
- Implante as mudanças progressivamente em cada endpoint no ciclo de vida do seu app de chat. Por exemplo, depois de testar um novo recurso implantado no endpoint de preparo
http://example.com/api/myapp/staging, lance o recurso para produção implantando-o no endpoint de produção, como http://example.com/api/myapp.
- Para depurar o código antes da implantação, defina um endpoint para seu ambiente local. Para saber como testar mudanças localmente, consulte
Depurar apps do Google Chat.
|
| Google Apps Script |
ID de implantação |
- Os projetos do Apps Script só podem ter uma ramificação e ser
associados a um projeto do Cloud. Para testar mudanças e manter
vários ambientes, crie projetos diferentes do Apps Script
para cada ambiente.
- Use apenas a implantação principal do projeto do Apps Script para o ambiente de desenvolvimento. Para ambientes de teste e produção, use implantações com versões. Para mais detalhes, consulte
Criar e gerenciar implantações
na documentação do Apps Script.
|
| Pub/Sub |
Tópico do Pub/Sub |
Use um tópico do Pub/Sub diferente para cada implantação. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 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)"]]
