Projetar e implantar um aplicativo usando a CLI do Antigravity

Os servidores do Protocolo de Contexto de Modelo (MCP) do Gemini Cloud Assist e do Application Design Center permitem projetar, implantar e resolver problemas da infraestrutura doGoogle Cloud diretamente na CLI do Antigravity. Depois de conectar os servidores MCP e instalar os arquivos de habilidade do agente, você pode gerar infraestrutura para o código do aplicativo. Também é possível avaliar a conformidade com padrões de segurança e resolver problemas de implantação usando comandos em linguagem natural.

Objetivos

Este tutorial ajuda você a:

  • Configure a CLI do Antigravity para usar os servidores MCP do Gemini Cloud Assist e do App Design Center.
  • Projetar e implantar uma infraestrutura do Google Cloud otimizada para executar o código do aplicativo atual.
  • Analisar e resolver problemas técnicos.

Custos

Neste documento, você vai usar os seguintes componentes faturáveis do Google Cloud:

  • App Design Center.
  • Google Cloud resources that you create as part of your application infrastructure.

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços.

Novos usuários do Google Cloud podem estar qualificados para um teste sem custo financeiro.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Para mais informações, consulte Limpeza.

Antes de começar

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho sem custos financeiros.

  2. Instale a CLI do Google Cloud.

  3. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  4. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  5. Crie ou selecione um projeto do Google Cloud .

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: para selecionar um projeto, não é necessário ter um papel do IAM específico. É possível selecionar qualquer projeto em que você tenha um papel.
    • Criar um projeto: para criar um projeto, é preciso ter o papel de criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

    • Crie um projeto do Google Cloud :

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto do Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

  6. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  7. Instale a CLI do Google Cloud.

  8. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  9. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  10. Crie ou selecione um projeto do Google Cloud .

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: para selecionar um projeto, não é necessário ter um papel do IAM específico. É possível selecionar qualquer projeto em que você tenha um papel.
    • Criar um projeto: para criar um projeto, é preciso ter o papel de criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

    • Crie um projeto do Google Cloud :

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto do Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

  11. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  12. Para acessar o Gemini Cloud Assist pelo MCP, você precisa estar no programa Trusted Tester. Entre em contato com sua equipe de conta para solicitar acesso.
  13. Instale a CLI do Antigravity.
  14. Para implantar e executar comandos da CLI do Antigravity, peça ao administrador para conceder a você os papéis necessários dentro do limite do projeto, conforme listado na tabela a seguir:
    Tarefa Funções exigidas
    Configurar o App Design Center no seu projeto Administrador do Application Design Center (roles/designcenter.admin)
    Acessar e chamar o Gemini Cloud Assist pelo MCP Administrador do Gemini Cloud Assist (roles/geminicloudassist.admin), ou
    Editor do Gemini Cloud Assist (roles/geminicloudassist.editor), ou
    Usuário do Gemini Cloud Assist (roles/geminicloudassist.user)

Prepare o ambiente

Para preparar o ambiente, autentique-se no Google Cloud e ative os serviços necessários.

Autenticar-se no Google Cloud

Execute o seguinte comando no terminal para autenticar no Google Cloud :

  1. Configure o Application Default Credentials para permitir que os servidores MCP façam chamadas de API.

     gcloud auth application-default login

Ativar APIs

Ative os serviços do Gemini Cloud Assist e do Application Design Center no seu projeto.

  1. Ative o serviço do Gemini Cloud Assist no seu projeto:

     gcloud services enable geminicloudassist.googleapis.com

  2. Ative o serviço do App Design Center no seu projeto:

     gcloud services enable designcenter.googleapis.com

Configurar os servidores MCP

Os servidores MCP do Gemini Cloud Assist e do App Design Center ajudam você a projetar, avaliar, implantar e resolver problemas na infraestrutura do Google Cloudusando comandos em linguagem natural. Para se conectar aos servidores MCP, defina as configurações do Antigravity.

Para configurar a CLI do Antigravity para usar servidores MCP, faça o seguinte:

  1. Abra o arquivo de configuração do MCP em um dos seguintes locais:

    • Escopo do usuário: para aplicar as configurações em todos os projetos da CLI do Antigravity, abra ~/.gemini/config/mcp_config.json.
    • Escopo do espaço de trabalho: para aplicar configurações a um projeto específico da CLI do Antigravity, abra .agents/mcp_config.json.

    Se o arquivo de configuração não existir, crie um novo.

  2. Em mcp_config.json, adicione ou mescle o seguinte bloco de configuração na chave mcpServers.

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      },
      "application-design-center": {
        "serverUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      }
    }
  }

    Essa configuração usa automaticamente o Application Default Credentials.

  3. Salve e feche o arquivo de configuração.

  4. Inicie a CLI do Antigravity.

    agy

  5. Verifique se os servidores MCP estão conectados.

    /mcp list

Instalar arquivos SKILL.md

Os arquivos SKILL.md fornecem ao App Design Center e aos servidores MCP do Gemini Cloud Assist instruções e fluxos de trabalho para design, implantação e solução de problemas de infraestrutura.

Para adicionar arquivos SKILL.md à CLI do Antigravity, faça o seguinte:

  1. Crie um diretório skills/design-and-deploy em um dos seguintes locais:

    • Escopo do usuário: para aplicar as configurações em todos os seus projetos da CLI do Antigravity, crie ~/.gemini/config/skills/design-and-deploy/.
    • Escopo do espaço de trabalho: para aplicar configurações a um projeto específico da CLI do Antigravity, crie .agents/skills/design-and-deploy/.

  2. No diretório skills/design-and-deploy/, crie um arquivo SKILL.md usando o conteúdo de designing-and-deploying-infrastructure.

  3. Crie um diretório skills/google-gemini-cloud-assist em um dos seguintes locais:

    • Escopo do usuário: para aplicar as configurações em todos os seus projetos da CLI do Antigravity, crie ~/.gemini/config/skills/google-gemini-cloud-assist/.
    • Escopo do espaço de trabalho: para aplicar configurações a um projeto específico da CLI do Antigravity, crie .agents/skills/google-gemini-cloud-assist/.

  4. No diretório skills/google-gemini-cloud-assist/, crie um arquivo SKILL.md usando o conteúdo de operating-google-cloud.

  5. Saia e reinicie a sessão da CLI do Antigravity.

    /quit

    Quando você iniciar a CLI do Antigravity novamente com agy, ela vai descobrir automaticamente seus arquivos de habilidade.

  6. Verifique se os arquivos de habilidade foram descobertos automaticamente.

    /skills list

Você configurou a CLI do Antigravity para se conectar aos servidores MCP do App Design Center e do Gemini Cloud Assist e criou arquivos de habilidades.

Projetar sua infraestrutura do Google Cloud

Projetar uma infraestrutura personalizada para armazenar e executar o código do aplicativo.

  1. Defina o projeto que você quer usar:

    gcloud config set project PROJECT_ID

  2. Peça o design da infraestrutura do Google Cloud .

     My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.

    O agente pede para ativar as habilidades que você configurou. O agente cria um plano de design de infraestrutura e pede sua aprovação.

  3. Aprovar o plano.

    Continue with the plan.

    O agente identifica as ferramentas que serão usadas para criar a infraestrutura e pede para usar a ferramenta setup_adc, que configura o App Design Center no seu projeto.

  4. Permitir que o Gemini Cloud Assist use as ferramentas propostas.

    O agente propõe um design e pergunta se você está pronto para implantar.

  5. Iterar no design proposto.

    The infrastructure looks good, but I want to add a cache for frequently accessed data.

    O agente atualiza o design para integrar seu requisito. O agente pergunta se você quer uma explicação das mudanças ou se quer testá-las.

Você criou o design inicial da infraestrutura e o iterou para melhorá-lo.

Avaliar a conformidade com os padrões de segurança

Os administradores da sua organização provavelmente configuraram frameworks de segurança específicos que informam o design e a implantação da infraestrutura. Nesta seção, verifique se o design está em conformidade com os padrões de segurança configurados.

  1. Verifique se o design da infraestrutura está em conformidade com os padrões de segurança da sua organização.

    I want to make sure that infrastructure design is compliant with my organization's security standards.

    O agente analisa o design da infraestrutura com base nos frameworks de segurança que o administrador da sua organização especificou no Security Command Center. Se a auditoria encontrar problemas de compliance, o agente vai sugerir melhorias de segurança e pedir sua aprovação.

  2. Aplicar as melhorias de segurança recomendadas

    Apply the recommended security enhancements.

    O agente aplica as mudanças e pergunta se você quer aprovar o design.

O design da infraestrutura está em conformidade com os frameworks de segurança da sua organização.

Implantar o design da infraestrutura

Implante o design da infraestrutura no Google Cloud.

  1. Aprovar o design e implantar.

    Deploy the infrastructure design to my Google Cloud project.

    O agente implanta o design final no seu projeto do Google Cloud . O agente pede que você aprove as mudanças no projeto. Por exemplo, talvez seja necessário ativar uma API.

    Se o aplicativo for implantado, o agente vai mostrar os detalhes da implantação, os componentes da arquitetura e as etapas para usar o aplicativo.

  2. Se a implantação falhar, receba ajuda para resolver o problema. Por exemplo, talvez seja necessário corrigir detalhes de configuração de componentes ou permissões do Identity and Access Management (IAM).

    Fix the component configuration errors.

    O agente fornece recomendações para configurações de componentes e cria uma visualização de diferenças para você analisar e aceitar.

  3. Para tentar a implantação novamente depois de fazer as alterações, repita as etapas nesta seção.

Você implantou o código do aplicativo e o design da infraestrutura no Google Cloud.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados no tutorial, exclua o projeto que os contém ou mantenha o projeto e exclua os recursos individuais.

    Exclua um projeto do Google Cloud :

    gcloud projects delete PROJECT_ID

A seguir