Implanta aplicativos

Ao implantar um rascunho de aplicativo no App Design Center, é possível provisionar recursos do Google Cloud e registrar automaticamente seu aplicativo no App Hub. Antes de implantar, é possível visualizar as mudanças planejadas do Terraform, avaliar o design em relação às políticas da organização e ativar as APIs Google Cloud necessárias. Após a implantação, é possível investigar problemas de implantação, analisar o desempenho de recursos usando dados de telemetria e aplicar novas revisões de modelo ao aplicativo.

Antes de começar

Para realizar as tarefas neste documento, peça ao administrador para conceder a você os papéis necessários na pasta habilitada para apps ou no projeto de gerenciamento, conforme listado na tabela a seguir:

Tarefa	Funções exigidas
Implantar um aplicativo e aplicar revisões de modelo	Administrador de aplicativos (roles/designcenter.applicationAdmin) ou Operador de aplicativos (roles/designcenter.applicationOperator)
Criar uma conta de serviço automaticamente durante a implantação	Administrador de IAM do projeto (roles/resourcemanager.projectIamAdmin)

Para implantar o aplicativo usando uma conta de serviço, consulte Conceder papéis à conta de serviço.

Para mais informações sobre papéis, consulte Controle de acesso com o IAM.

Implantar 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 em Nome do aplicativo.

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

   Observação: se você planeja implantar e depois excluir este aplicativo, implante no ambiente TEST, DEVELOPMENT ou STAGING.

4. Clique em Implantar.

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

   • Selecione 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 à conta de serviço.

   • Criar uma nova conta de serviço: é preciso ter o papel de 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 visualização é copiada para sua área de transferência.

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

8. Na área Analisar APIs, confira 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 exibidos quando 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 do build.

    4. Para ver sugestões de correção de erros de implantação, clique em Resolver problemas de implantação (pré-lançamento).

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

    Dica: para ver 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. Visualize o aplicativo para conferir 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 espaço.
   • SERVICE_ACCOUNT: siga um destes procedimentos:
     • Para criar uma nova conta de serviço, dê um nome a 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 comandos de implantação a seguir.

   • 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 espaço.
   • SERVICE_ACCOUNT: siga um destes procedimentos:
     • Para criar uma nova conta de serviço, dê um nome a 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 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á ver um resumo dos erros, receber uma análise detalhada, identificar as etapas de resolução e corrigir automaticamente alguns problemas.

Para resolver problemas 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 exibir 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 for concluída, você poderá examinar as informações relacionadas. Por exemplo, você pode ver o seguinte:

• Detalhes como horário 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 ver 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 em Nome do aplicativo. O painel Detalhes do aplicativo mostra o seguinte:

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

   • Detalhes do app: confira 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 os URIs de serviço, que podem ser usados para interagir com o front-end ou o back-end do aplicativo.

   • Implantações: examine o status da implantação, os erros de implantação e os links para registros para resolver 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 espaço.

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

Modificar aplicativos implantados

Se você quiser modificar um aplicativo implantado, siga um destes procedimentos para garantir que as alterações sejam mantidas quando você reimplantar o aplicativo:

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

Aplicar revisões de modelo

Se o aplicativo foi implantado anteriormente 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 o aplicativo, uma revisão dele é criada. É possível configurar componentes que foram modificados ou adicionados ao modelo revisado.

É possível ver 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 aplicativo, faça o seguinte:

Atenção: se você modificou os componentes de um aplicativo fora da Central de design de apps, essas mudanças não serão mantidas quando você reimplantar. 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 dele.

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 mais recente do modelo de aplicativo.

    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 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 espaço.
   • SOURCE_APPLICATION_TEMPLATE_REVISION: o URI do modelo do 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.

A seguir

• Acompanhe suas cargas de trabalho monitorando a integridade e o desempenho do aplicativo.
• Comece a usar arquiteturas pré-configuradas criando com base em modelos do Google.