Esta página foi traduzida pela API Cloud Translation.

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

Tela de design

No menu de navegação, faça o seguinte:
- 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.
  
  Acesse "Modelos compartilhados"
Clique no ID do modelo que você quer usar.
Na tela de design, clique em Configurar um app e em Criar novo aplicativo.
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.
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:
- O projeto precisa ser um descendente da pasta ativada 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, esse projeto será usado em vez dessa configuração.
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.
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.

Observação: se você planeja implantar e excluir esse aplicativo depois, faça a implantação em TEST, DEVELOPMENT ou STAGING.
Na lista Gravidade, selecione o grau de impacto no seu negócio. Por exemplo, LOW ou HIGH.
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 codificação.
- Na área Proprietários do operador, insira um proprietário responsável por operar o aplicativo.
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.
Clique em Criar aplicativo. Os detalhes do aplicativo são exibidos.

CLI da gcloud

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 seu espaço.
Para mais informações, consulte gcloud design-center spaces application-templates describe.
Copie a saída latestRevision.
Crie um rascunho de aplicativo com base no 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 que você quer criar.
- 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
- SCOPE_TYPE: o escopo do seu 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, 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:

Tela de design

Na tela de design, clique em um componente.
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 ser um descendente da pasta com app ativado selecionada.
- O projeto não pode ser um projeto de gerenciamento.
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.
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.
Clique em Salvar.

CLI da gcloud

Descreva o aplicativo para ver os parâmetros do componente e identifique os parâmetros necessários para seu 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 seu espaço.
Para mais informações, consulte gcloud design-center spaces applications describe.

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

Por exemplo, você pode 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"
       }
    ]
  }

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 seu espaço.
- COMPONENT_FILE_PATH_1: um arquivo JSON que inclui parâmetros de componentes. Para cada arquivo JSON adicional, adicione outro argumento e valor --component-parameter.
Para mais informações, consulte gcloud design-center spaces applications update.

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:

Na tela de design, clique em Código. O sistema mostra os arquivos do Terraform gerados.
Clique em main.tf. O sistema mostra o módulo do Terraform para cada componente.
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.
Para destacar e comparar suas edições, faça o seguinte:
1. Clique em Conferir 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.
Para salvar as edições, clique em Salvar mudanças no código.
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:

Tela de design

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

Acesse Aplicativos
Na tabela, clique no Nome do aplicativo que você quer revisar.
Para modificar os detalhes do aplicativo, faça o seguinte:
Clique em Editar e modifique os detalhes.
Clique em Salvar.
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 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 aparece 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:

Tela de design

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

Acesse Aplicativos
Na tabela, clique no Nome do aplicativo.
Clique em Ações e selecione Excluir aplicativo.
No campo Excluir, insira o nome do aplicativo.
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 seu espaço.

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

A seguir

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

Gerenciar aplicativos Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Criar um rascunho de aplicativo

Tela de design

CLI da gcloud

Configurar componentes e conexões

Tela de design

CLI da gcloud

Editar código do Terraform

Criar uma revisão de aplicativo

Tela de design

CLI da gcloud

Excluir um aplicativo

Tela de design

CLI da gcloud

A seguir

Gerenciar aplicativos