Gerenciar aplicativos

Crie um aplicativo quando quiser personalizar e implantar usando um modelo. Por exemplo, você pode criar um aplicativo que planeja implantar para fins de teste. Você pode criar outro aplicativo para uso em produção.

Ao criar um aplicativo, você especifica informações que ajudam a categorizar com base no uso pretendido. Essas informações ajudam você a filtrar e encontrar um aplicativo específico. Você também pode configurar componentes e detalhes de conexão.

Antes de começar

Peça ao administrador para conceder a você um dos seguintes papéis na pasta ou no projeto de gerenciamento ativado para apps:

  • Administrador do App Design Center (roles/designcenter.admin).
  • Administrador de aplicativos (roles/designcenter.applicationAdmin).
  • Editor de aplicativos (roles/designcenter.applicationEditor).

Criar um rascunho de aplicativo

Crie um rascunho de aplicativo com base em um modelo especificando detalhes e, opcionalmente, substituindo as configurações de componentes. Em seguida, implante o rascunho para criar um aplicativo.

  1. No menu de navegação, faça o seguinte:

  2. Clique no ID do modelo que você quer usar.

  3. Na tela de design, clique em Configurar um app e em Criar novo aplicativo.

  4. Na área de nome do aplicativo, faça o seguinte para nomear e descrever seu aplicativo:

    1. No campo Nome, insira um identificador exclusivo. Por exemplo, use uma combinação exclusiva de nome e ambiente, como web-app-staging. Este campo é obrigatório.

      Você pode usar até 63 caracteres, incluindo letras minúsculas, números e hífens. O nome precisa começar com uma letra minúscula e não pode terminar com um hífen. Não é possível mudar os nomes.

    2. No campo Nome de exibição, insira um nome para mostrar no consoleGoogle Cloud .

    3. No campo Descrição, insira a finalidade do aplicativo.

  5. Para definir um projeto padrão para componentes com um campo ID do projeto vazio, selecione um projeto na lista Projeto de implantação. O projeto precisa ter as seguintes qualificações:

    Se um componente já tiver um projeto especificado no campo ID do projeto, esse projeto será usado em vez dessa configuração.

  6. Na lista Região, selecione a região em que os componentes são implantados. A região do componente é aplicada com base no seguinte:

    • Se o escopo do aplicativo for Global (padrão), a região será aplicada a componentes que ainda não têm uma região configurada.

    • Se o escopo do aplicativo for Regional, a região será aplicada a todos os componentes.

  7. Na lista Ambiente, selecione o ambiente em que você quer implantar esse aplicativo. Por exemplo, talvez você queira verificar se sua implantação funciona conforme o esperado em TEST.

  8. Na lista Gravidade, selecione o grau de impacto no seu negócio. Por exemplo, LOW ou HIGH.

  9. Para especificar proprietários, na área Proprietários, clique em Adicionar proprietário e insira um Nome de exibição e um e-mail para o seguinte:

    • Na área Proprietários de empresas, insira um proprietário responsável pela qualidade e pelas expectativas dos usuários.

    • Na área Proprietários do desenvolvedor, insira um proprietário responsável pelo desenvolvimento e pela programação.

    • Na área Proprietários do operador, insira um proprietário responsável por operar o aplicativo.

  10. Na lista Escopo, selecione uma das seguintes opções:

    • Global (padrão): o aplicativo contém um recurso global ou os recursos estão em várias regiões.

    • Regional: todos os recursos estão em uma única região.

    Este campo é obrigatório. Para mais informações, consulte Comparar aplicativos globais e regionais.

  11. Clique em Criar aplicativo. Os detalhes do aplicativo são exibidos.

Configurar componentes e conexões

Para cada componente no aplicativo, é possível especificar detalhes de configuração, como o projeto em que o recurso é criado e o local em que ele é implantado.

Também é possível modificar os detalhes da conexão se a configuração padrão não atender aos seus requisitos. Por exemplo, é possível modificar nomes de chaves variável de ambiente, mudar portas de conexão ou adicionar mais papéis a contas de serviço.

É necessário configurar os detalhes obrigatórios para cada recurso compatível.

Para configurar componentes e conexões, faça o seguinte:

  1. Na tela de design, clique em um componente.

  2. Na área Configuração, na lista ID do projeto, selecione o projeto em que você quer implantar o recurso. Selecione um projeto com as seguintes qualificações:

  3. Defina outras configurações para o recurso. Por exemplo, para o Cloud SQL, você pode configurar o seguinte:

    • Região
    • Configuração de backup
    • Sinalizações do banco de dados
    • Configuração de IP

    Para links da documentação de configuração de cada componente, consulte Recursos compatíveis.

  4. Quando você conecta componentes na tela de design, os valores de configuração padrão são usados para criar a conexão. Para adicionar ou modificar detalhes da conexão, faça o seguinte:

    1. Na tela de design, clique na conexão entre dois componentes. O painel Conexão é aberto e mostra os parâmetros de conexão.

    2. Escolha uma destas opções:

      • Para modificar um parâmetro de conexão, clique em Editar.

      • Para adicionar um novo parâmetro de conexão, clique em Adicionar parâmetro.

    3. Atualize os campos Chave e Valor. Por exemplo, você pode querer modificar os seguintes detalhes:

      • Os nomes das chaves variável de ambiente para se alinhar aos requisitos do aplicativo.
      • O valor da porta de conexão.
      • Os papéis adicionados a uma conta de serviço.

  5. Clique em Salvar.

  6. Para conferir as etapas de implantação, consulte Implantar um aplicativo no console.

Editar código do Terraform

O aplicativo gera código do Terraform para refletir detalhes de design e configuração. É possível editar o Terraform para especificar detalhes da configuração do componente.

O sistema gera os seguintes arquivos do Terraform:

  • main.tf: código de infraestrutura que inclui um módulo para cada componente no modelo.
  • outputs.tf: expõe informações sobre componentes de infraestrutura implantados.
  • variables.tf: declara nome, tipo e descrição para variáveis usadas no arquivo main.tf.
  • input.tfvars: define valores para variáveis usadas no arquivo main.tf.
  • providers.tf: define rótulos que ajudam o Terraform a interagir com APIs e recursos do Google Cloud .

Para mais informações contextuais, consulte Visão geral do Terraform em Google Cloud.

Para editar o código do Terraform, faça o seguinte:

  1. Na tela de design, clique em Código. O sistema mostra os arquivos do Terraform gerados.

  2. Clique em main.tf. O sistema mostra o módulo do Terraform para cada componente.

  3. Edite os detalhes da configuração. Para mais informações, consulte a documentação de configuração de cada recurso compatível.

    O sistema valida automaticamente suas edições e mostra erros se elas forem inválidas.

  4. Para destacar e comparar suas edições, faça o seguinte:

    1. Clique em Ver diferença.

    2. Para reverter uma mudança, clique em Clique para reverter a mudança na margem.

    3. Clique em Ver diferenças para fechar a visualização de comparação.

  5. Para salvar as edições, clique em Salvar mudanças no código.

  6. Para verificar as mudanças, faça o seguinte:

    1. Clique em Design.
    2. Clique em um componente e revise os detalhes da configuração.

Criar uma revisão de aplicativo

Crie uma revisão do aplicativo para modificar detalhes ou componentes. Se você modificar componentes do aplicativo fora do App Design Center, essas mudanças não serão mantidas quando você fizer uma nova implantação.

Para criar uma revisão do aplicativo:

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

    Acesse Aplicativos

  2. Na tabela, clique no Nome do aplicativo que você quer revisar.

  3. Para modificar os detalhes do aplicativo, faça o seguinte:

    1. Clique em Editar e modifique os detalhes.
    2. Clique em Salvar.

  4. Para modificar um componente neste aplicativo, faça o seguinte:

    1. Clique no componente na tela de design e edite os detalhes na área Configuração.

    2. Clique em Salvar.

  5. Para conferir as etapas de implantação, consulte Implantar um aplicativo no console.

Excluir um aplicativo

Se você não precisar mais de um aplicativo, poderá excluí-lo. Por exemplo, você pode implantar um aplicativo para verificar seu modelo no ambiente TEST e depois excluir o aplicativo.

É possível excluir os seguintes aplicativos:

  • É um aplicativo que não foi implantado. Na página Aplicativos, o Status é listado como Rascunho.
  • Um aplicativo implantado no ambiente TEST, DEVELOPMENT ou STAGING.

Quando você exclui um aplicativo, acontece o seguinte:

  • Os detalhes do aplicativo são removidos do App Design Center.
  • O aplicativo do App Hub subjacente é excluído.
  • Se você fez a implantação, os recursos serão excluídos.

Para excluir um aplicativo:

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

    Acesse Aplicativos

  2. Na tabela, clique no Nome do aplicativo.

  3. Clique em Ações e selecione Excluir aplicativo.

  4. No campo Excluir, insira o nome do aplicativo.

  5. Clique em Excluir.

A seguir

Implante o aplicativo usando uma das seguintes opções: