Implanta aplicativos

Depois de criar um rascunho de aplicativo com base em um modelo, você pode 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 que você faça o seguinte:

• Visualizar as mudanças que o Terraform planeja fazer na sua infraestrutura.
• Ativar APIs de recursos necessárias para o aplicativo. Google Cloud
• Investigar problemas de implantação.
• Usar dados de telemetria para analisar o desempenho dos recursos.
• Identificar e aplicar revisões de modelo ao aplicativo.

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

Antes de começar

Você precisa ter um dos seguintes papéis 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 de uma das seguintes opções:

• Sua própria conta de serviço configurada 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 nova 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, Google Cloud recursos são criados e você começa a incorrer em 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 os detalhes e clique em Editar para fazer mudanças.

   Observação: Se você planeja implantar e excluir esse aplicativo mais tarde, implante no TEST, DEVELOPMENT, ou STAGING ambiente.

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: você precisa 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 a área de transferência.

   3. Para salvar a visualização, cole e salve em um documento de sua escolha.

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

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. Leia as mensagens de erro.

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

    4. Para conferir sugestões de correção de erros de implantação, clique em Resolver problemas de implantação (visualização).

       Para mais informações, consulte Resolver problemas e corrigir erros 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 gcloud

1. Visualize o aplicativo para conferir o código do Terraform antes de implantar. 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: faça uma das seguintes 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 atual, 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: faça uma das seguintes 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. Monitore 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 e corrigir erros de implantação

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas 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 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 a resolver erros de implantação.

3. Revise 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 a ele. Por exemplo, é possível conferir o seguinte:

• Detalhes como a hora da última atualização, a data da revisão e a região.
• Saídas, como o URI do 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 os 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 URIs de serviço que podem ser usados para interagir com o front-end ou 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 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, faça uma das seguintes ações para garantir que as mudanças sejam mantidas quando você reimplantar o aplicativo:

• Revise o modelo e então aplique a revisão do modelo
• 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 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 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ê 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 do componente.

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

CLI gcloud

1. Identifique o URI da revisão do modelo de aplicativo para a revisão 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 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 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.