Gerenciar aplicativos

Ao criar um rascunho de aplicativo com base em um modelo no App Design Center, é possível personalizar e implantar instâncias de aplicativo separadas para ambientes como teste e produção. Ao criar um rascunho de aplicativo, você especifica atributos para categorizar e filtrar o aplicativo, configura componentes e conexões e, se quiser, edita o código do Terraform gerado. Também é possível criar novas revisões conforme seus requisitos mudam e excluir o aplicativo quando você não precisar mais dos recursos implantados.

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
Criar, configurar, editar e criar versões de rascunhos de aplicativos	Administrador do Application Design Center (roles/designcenter.admin) ou Administrador de aplicativos (roles/designcenter.applicationAdmin) ou Editor de aplicativos (roles/designcenter.applicationEditor)
Excluir um aplicativo	Administrador do Application Design Center (roles/designcenter.admin) ou Administrador de aplicativos (roles/designcenter.applicationAdmin)

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

Criar um rascunho de aplicativo

Crie um rascunho de aplicativo usando um modelo, especificando detalhes e, se quiser, substituindo as configurações de componentes. Em seguida, implante o rascunho para criar um aplicativo.

Tela de design

1. No menu de navegação, siga um destes procedimentos:

   • Para ver os modelos criados no seu espaço, clique em Modelos.

     Acessar "Modelos"

   • Para ver os modelos compartilhados de outro espaço, clique em Modelos compartilhados.

     Acessar "Modelos compartilhados"

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

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

4. Na área 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.

      É possível usar até 63 caracteres, incluindo letras minúsculas, números e hifens. 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 console doGoogle Cloud .

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

5. Para definir um projeto padrão para todos os componentes com um campo ID do projeto vazio, selecione um projeto na lista Projeto de implantação. Em um limite no nível da pasta, o projeto precisa ter as seguintes qualificações:

   • O projeto precisa estar dentro da pasta habilitada para apps selecionada.
   • O projeto não pode ser um projeto de gerenciamento.

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

6. Na lista Região, selecione a região em que os componentes estã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 aos 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 a implantação funciona conforme o esperado em TEST.

   Observação: se você planeja implantar e excluir esse aplicativo posteriormente, implante em TEST, DEVELOPMENT ou STAGING.

8. Na lista Gravidade, selecione o grau de impacto na sua empresa. 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 da empresa, insira um proprietário responsável pela qualidade e pelas expectativas do usuário.

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

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

10. Na lista Escopo, selecione uma destas 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.

CLI da gcloud

1. Identifique o URI de revisão do modelo de aplicativo que você quer usar para criar o 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 você quer usar como base para 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. Crie um rascunho de aplicativo com base no seu modelo.

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

   Substitua:

   • APPLICATION: o ID do aplicativo para o rascunho do aplicativo que você quer criar.
   • 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
   • SCOPE_TYPE: o escopo do aplicativo. Um de regional ou global. Se o escopo do aplicativo for "global, the region is applied to components that don't already have a configured region. If the application scope isregional", a região será aplicada a todos os componentes.

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

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, alterar portas de conexão ou adicionar outros papéis às contas de serviço.

É preciso configurar os detalhes necessários para cada recurso compatível.

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

Tela de design

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:

   • O projeto precisa estar dentro da pasta habilitada para apps selecionada.

   • O projeto não pode ser um projeto de gerenciamento.

3. Defina outras configurações para o recurso. Por exemplo, para o Cloud SQL, é possível configurar o seguinte:

   • Região
   • Configuração de backup
   • Flags de banco de dados
   • Configuração de IP

   Para links para a 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, talvez você queira 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.

CLI da gcloud

1. Descrever o aplicativo para visualizar os parâmetros do componente e identificar os parâmetros necessários para o aplicativo.

    gcloud design-center spaces applications describe APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,componentParameters)'
   

   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.

2. Para cada componente que você quer modificar, no diretório inicial, crie um arquivo JSON que contenha valores de parâmetro.

   Por exemplo, é possível criar o seguinte arquivo para um componente do Cloud Run:

     {
       "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT",
       "parameters": [
          {
             "key": "service_name",
             "value": "frontend-service"
          },
          {
             "key": "project_id",
             "value": "DEPLOYMENT_PROJECT"
          }
       ]
     }
   

3. Atualize o aplicativo para configurar os parâmetros necessários.

    gcloud design-center spaces applications update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --component-parameters=COMPONENT_FILE_PATH_1
   

   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.
   • COMPONENT_FILE_PATH_1: um arquivo JSON que inclui parâmetros de componente. Para cada arquivo JSON adicional, adicione outro argumento e valor --component-parameter.

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

Para ver as etapas de implantação, consulte Implantar aplicativos.

Verificar a conformidade de segurança

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.

É possível realizar uma avaliação de segurança do aplicativo para validar a configuração em relação aos frameworks do Security Command Center. Essa avaliação abrangente analisa o seguinte:

• Valores de configuração do componente: as definições de configuração que foram herdadas automaticamente do modelo ou as configurações que você modificou para este aplicativo.
• Parâmetros do aplicativo: os detalhes específicos da instância fornecidos para o aplicativo, como a região ou o ambiente de implantação.
• Componentes permitidos: os serviços e as cargas de trabalho no aplicativo atual que podem ser usados pela organização.

Os aplicativos herdam os frameworks do Security Command Center do modelo. Primeiro, o administrador precisa anexar um framework de segurança ao modelo do aplicativo. Em seguida, faça o seguinte para avaliar a conformidade de segurança do aplicativo:

CLI da gcloud

  gcloud alpha design-center spaces applications preview APPLICATION \
  --project=PROJECT \
  --location=LOCATION \
  --space=SPACE \
  --generate-assessment-report=true

Substitua:

• APPLICATION: o ID do aplicativo que você quer avaliar.
• PROJECT: o ID do projeto de gerenciamento.
• LOCATION: a região do aplicativo.
• SPACE: o ID do espaço.

A saída mostra um relatório de avaliação do aplicativo com base nos frameworks anexados do modelo.

Editar código do Terraform

O aplicativo gera o código do Terraform para refletir os detalhes de design e configuração. É possível editar o Terraform para especificar detalhes de 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 os componentes de infraestrutura implantados.
• variables.tf: declara o nome, o tipo e a descrição das 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, consulte Visão geral do Terraform no Google Cloud.

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

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

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

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

   O sistema valida automaticamente as edições e exibe 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, na margem, clique em Clique para reverter a mudança.

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

5. Para salvar as mudanças, 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 de configuração.

Criar uma revisão de aplicativo

Crie uma revisão do aplicativo para modificar detalhes ou componentes. Se você modificar componentes de aplicativos 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 de aplicativo:

Tela de design

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:

4. Clique em Editar e modifique os detalhes.

5. Clique em Salvar.

6. 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.

CLI da gcloud

Consulte Configurar componentes e conexões.

Para ver as etapas de implantação, consulte Implantar aplicativos.

Excluir um aplicativo

Se você não precisar mais de um aplicativo, poderá excluí-lo. Por exemplo, é possível implantar um aplicativo para verificar o modelo no ambiente TEST e, em seguida, 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 que foi implantado no ambiente TEST, DEVELOPMENT ou STAGING.

Quando você exclui um aplicativo, acontece o seguinte:

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

Para excluir um aplicativo:

Tela de design

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

   Acesse Aplicativos

2. Na tabela, clique em 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.

CLI da gcloud

Excluir um aplicativo.

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

Substitua:

• APPLICATION: o ID do aplicativo que você quer excluir.
• 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 delete.

A seguir

• Provisione sua infraestrutura com o console ou a linha de comando implantando aplicativos.
• Exporte as configurações do Terraform para sua máquina ou repositório local fazendo o download e a implantação do Terraform.