Implanta aplicativos

Depois de criar um rascunho de aplicativo com base em um modelo, é possível implantar o aplicativo. Quando você implanta um aplicativo usando o App Design Center, ele é registrado automaticamente no App Hub. O processo de implantação permite fazer o seguinte:

• Visualizar as mudanças que o Terraform planeja fazer na sua infraestrutura.
• Ative as APIs de recursos Google Cloud necessárias para seu aplicativo.
• Investigue problemas de implantação.
• Use dados de telemetria para analisar a performance dos recursos.
• Identificar e aplicar revisões de modelo ao seu aplicativo.

Este documento ajuda você a implantar, gerenciar e aplicar uma revisão de modelo ao seu aplicativo.

Antes de começar

Você precisa ter uma das seguintes funções na pasta ou no projeto de gerenciamento ativado para apps:

• Administrador de aplicativos (roles/designcenter.applicationAdmin)
• Operador de aplicativos (roles/designcenter.applicationOperator)

Para implantar o aplicativo com uma conta de serviço, você precisa ter uma das seguintes opções:

• Sua própria conta de serviço, que você configurou para implantar aplicativos e recursos subjacentes. Para mais informações, consulte Conceder papéis à sua conta de serviço.
• O papel de Administrador do IAM do projeto (roles/resourcemanager.projectIamAdmin) na pasta habilitada para apps. Esse papel permite criar uma conta de serviço durante a implantação.

implantar o aplicativo

Selecione uma opção de conta de serviço e implante o aplicativo. Quando você implanta um aplicativo,os recursos do Google Cloud são criados, e você começa a receber cobranças associadas a eles.

Tela de design

1. No menu de navegação, clique em Aplicativos.

   Acesse Aplicativos

2. Na tabela, clique no Nome do aplicativo.

3. Na página Detalhes do aplicativo, revise as informações e clique em Editar para fazer mudanças.

   Observação: se você planeja implantar e excluir esse aplicativo mais tarde, faça a implantação no ambiente TEST, DEVELOPMENT ou STAGING.

4. Clique em Implantar.

5. Selecione uma das seguintes contas de serviço para implantar o aplicativo:

   • Selecionar uma conta de serviço: no campo Conta de serviço, insira o nome de uma conta de serviço atual. Para configurar a conta de serviço, consulte Conceder papéis à sua conta de serviço.

   • Criar uma conta de serviço: é necessário ter o papel Administrador do IAM do projeto (roles/resourcemanager.projectIamAdmin), que é usado para atribuir os papéis de implantação necessários à conta de serviço.

6. Clique em Proceed.

7. Para visualizar as mudanças que o Terraform planeja fazer na sua infraestrutura, faça o seguinte:

   1. Clique em Visualização.

   2. Revise as mudanças e clique em Copiar e fechar. A prévia é copiada para a área de transferência.

   3. Para salvar a prévia, cole e salve em um documento de sua escolha.

8. Na área Analisar APIs, revise a lista de APIs necessárias para seu aplicativo. As APIs são ativadas automaticamente quando você faz a implantação.

9. Clique em Implantar. Os detalhes do aplicativo e o status da implantação são mostrados à medida que a implantação é concluída.

10. Se houver problemas com a implantação, faça o seguinte:

    1. No painel Detalhes do aplicativo, clique em Implantações.

    2. Revise as mensagens de erro.

    3. Clique em Ver registros para conferir informações detalhadas sobre o build.

    4. Para ver sugestões de como corrigir erros de implantação, clique em Resolver problemas de implantação (Prévia).

       Para mais informações, consulte Resolver e corrigir problemas de implantação.

    Dica: para conferir uma lista de aplicativos com problemas de implantação no Cloud Hub, consulte Ver implantações.

11. Para gerenciar o aplicativo implantado, consulte Ver detalhes do aplicativo.

CLI da gcloud

1. Confira o aplicativo para ver o código do Terraform antes da implantação. Essa operação pode levar vários minutos para ser concluída. Escolha uma destas opções:

   • Para criar uma conta de serviço automaticamente, use o seguinte comando:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --create-sa \
     --service-account=SERVICE_ACCOUNT
     

   • Para usar sua própria conta de serviço, use o seguinte comando:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --service-account=SERVICE_ACCOUNT
     

   Substitua:

   • APPLICATION: o ID do aplicativo.
   • PROJECT: o ID do projeto de gerenciamento.
   • LOCATION: a região do aplicativo.
   • SPACE: o ID do seu espaço.
   • SERVICE_ACCOUNT: faça uma destas ações:
     • Para criar uma conta de serviço, forneça um nome para ela.
     • Para usar sua própria conta de serviço, forneça o nome completo do recurso no formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Para mais informações, consulte gcloud design-center spaces applications preview.

2. Implante o aplicativo de forma assíncrona e copie o nome completo da operação. Escolha uma destas opções:

   Observação: para atualizar um aplicativo, adicione a flag --replace aos seguintes comandos de implantação.

   • Para criar uma conta de serviço automaticamente, use o seguinte comando:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --create-sa \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   • Para usar sua própria conta de serviço, use o seguinte comando:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   Substitua:

   • APPLICATION: o ID do aplicativo.
   • PROJECT: o ID do projeto de gerenciamento.
   • LOCATION: a região do aplicativo.
   • SPACE: o ID do seu espaço.
   • SERVICE_ACCOUNT: faça uma destas ações:
     • Para criar uma conta de serviço, forneça um nome para ela.
     • Para usar sua própria conta de serviço, forneça o nome completo do recurso no formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Para mais informações, consulte gcloud design-center spaces applications deploy.

3. A implantação leva alguns minutos para ser concluída. Acompanhe o status da implantação.

   gcloud design-center operations describe OPERATION\
   --project=PROJECT \
   --location=LOCATION
   

   Substitua:

   • OPERATION: o nome completo da operação copiado da resposta ao comando deploy no formato projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • PROJECT: o ID do projeto de gerenciamento.
   • LOCATION: a região do aplicativo.

   Para mais informações, consulte gcloud design-center operations describe.

Resolver e corrigir problemas de implantação

Visualizar

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção "Termos Gerais de Serviço" dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se a implantação do aplicativo falhar, você poderá conferir um resumo dos erros, receber uma análise detalhada, identificar etapas para resolver e corrigir automaticamente alguns problemas.

Para resolver e corrigir erros, faça o seguinte:

1. No painel Detalhes do aplicativo, clique em Implantações.

2. Para analisar erros e sugerir correções, clique em Resolver problemas de implantação.

   O painel Detalhes da solução de problemas mostra sugestões de documentação, mudanças de configuração e outras informações que podem ajudar você a resolver erros de implantação.

3. Analise os erros e as recomendações de implantação:

   1. Se a análise resultar em recomendações de configurações de componentes, revise as mudanças sugeridas e clique em Atualizar aplicativo para aplicar as mudanças.

   2. Se a análise resultar em outras recomendações, o sistema vai mostrar comandos da CLI gcloud que podem ser executados para resolver os erros. Para executar os comandos da CLI gcloud no Cloud Shell, clique em Executar comando.

Ver detalhes do aplicativo

Quando a implantação do aplicativo terminar, você poderá examinar as informações relacionadas. Por exemplo, você pode ver:

• Detalhes como hora da última atualização, data da revisão e região.
• Saídas como URI de serviço.
• Status da implantação, informações de erro e links para registros.

Para conferir os detalhes do aplicativo, faça o seguinte:

Tela de design

1. No menu de navegação, clique em Aplicativos.

   Acesse Aplicativos

2. Na tabela, clique no Nome do aplicativo. O painel Detalhes do aplicativo mostra o seguinte:

   • Ver app no App Hub: investigue seu aplicativo no App Hub. É possível conferir os recursos implantados e examinar dados de telemetria para diagnosticar problemas e analisar a performance. Para mais informações, consulte Monitorar aplicativos do App Hub.

   • Detalhes do app: veja informações como a data da última atualização, o modelo de origem, a região e a conta de serviço.

   • Saídas: identifique URIs de serviço, que podem ser usados para interagir com o front-end ou back-end do aplicativo.

   • Implantações: examine o status e os erros de implantação, além de links para registros, para solucionar problemas.

CLI da gcloud

gcloud design-center spaces applications describe APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

Substitua:

• APPLICATION: o ID do aplicativo.
• PROJECT: o ID do projeto de gerenciamento.
• LOCATION: a região do aplicativo.
• SPACE: o ID do seu espaço.

Para mais informações, consulte gcloud design-center spaces applications describe.

Modificar aplicativos implantados

Se você quiser modificar um aplicativo implantado, faça uma das seguintes ações para garantir que as mudanças sejam mantidas quando você reimplantar o aplicativo:

• Revise o modelo e aplique a revisão.
• Revisar o aplicativo

Aplicar revisões de modelo

Se o aplicativo foi implantado usando o App Design Center e um administrador compartilhou uma revisão de modelo com você, é possível aplicar as mudanças de modelo ao aplicativo. Quando você atualiza seu aplicativo, uma revisão é criada. É possível configurar componentes que foram modificados ou adicionados ao modelo revisado.

É possível conferir as revisões de modelo disponíveis para seus aplicativos usando o Cloud Hub. Para mais informações, consulte Ver implantações.

Para aplicar revisões de modelo ao seu aplicativo, faça o seguinte:

Cuidado: se você modificou os componentes de um aplicativo fora do App Design Center, essas mudanças não serão mantidas quando você fizer uma nova implantação. Para manter as mudanças, consulte Modificar aplicativos implantados.

Tela de design

1. No menu de navegação, clique em Modelos.

   Acessar "Modelos"

2. Clique no ID do modelo que contém a revisão que você quer aplicar.

3. Na lista Configurar um app, selecione o aplicativo que você quer atualizar.

4. Edite os detalhes do aplicativo e clique em Salvar.

5. Clique em cada componente na tela de design e modifique as configurações.

6. Clique em Implantar. Para conferir as etapas de implantação, consulte Implantar o aplicativo.

CLI da gcloud

1. Identifique o URI da revisão do modelo de aplicativo mais recente.

    gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,latestRevision)'
   

   Substitua:

   • APPLICATION_TEMPLATE: o ID do modelo de aplicativo que é a base do seu aplicativo.
   • PROJECT: o ID do projeto de gerenciamento.
   • LOCATION: a região do modelo de aplicativo.
   • SPACE: o ID do seu espaço.

   Para mais informações, consulte gcloud design-center spaces application-templates describe.

2. Copie a saída latestRevision.

3. Atualize o aplicativo para usar a revisão do modelo de aplicativo.

    gcloud design-center spaces applications update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION
   

   Substitua:

   • APPLICATION: o ID do aplicativo.
   • PROJECT: o ID do projeto de gerenciamento.
   • LOCATION: a região do aplicativo.
   • SPACE: o ID do seu espaço.
   • SOURCE_APPLICATION_TEMPLATE_REVISION: o URI do modelo de aplicativo. Por exemplo, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION

   Para mais informações, consulte gcloud design-center spaces applications update.

4. Para configurar componentes novos ou atualizados no aplicativo, consulte Configurar componentes e conexões.

5. Ao implantar o aplicativo, use a flag --replace. Para conferir as etapas de implantação, consulte Implantar o aplicativo.