Projetar e implantar um aplicativo usando a CLI do Antigravity

Use os servidores do Protocolo de Contexto de Modelo (MCP) do Gemini Cloud Assist e do App Design Center para projetar, implantar e resolver problemas de infraestrutura doGoogle Cloud diretamente na CLI do Antigravity.

Objetivos

Este tutorial ajuda você a fazer o seguinte:

  • Configure a CLI do Antigravity para usar o Gemini Cloud Assist e os servidores MCP do App Design Center.
  • Projetar e implantar Google Cloud infraestrutura 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.

  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 Google Cloud projeto.

    Funções necessárias para selecionar ou criar um projeto

    • Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, é necessário 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 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 Google Cloud projeto.

    Funções necessárias para selecionar ou criar um projeto

    • Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, é necessário 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 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 participar do programa Trusted Tester. Entre em contato com sua equipe de conta para pedir acesso.
  13. Instale a CLI do Antigravity.
  14. Para implantar e executar comandos da CLI Antigravity, peça ao administrador para conceder a você as funções necessárias 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 App Design Center (roles/designcenter.admin)
    Acessar e chamar o Gemini Cloud Assist pelo MCP Admin 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 seu 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 App 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 Google Cloudusando comandos em linguagem natural. Para se conectar aos servidores MCP, configure as definiçõ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 configurações a todos os seus 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 suas 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 SKILL.md arquivos

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 configurações em todos os 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 configurações em todos os 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 do App Design Center e do Gemini Cloud Assist MCP e criou arquivos de habilidades.

Projete sua infraestrutura de Google Cloud

Projete 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 Google Cloud .

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

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

  3. Aprove o plano.

    Continue with the plan.

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

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

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

  5. Itere 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 fez iterações para melhorar o design.

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

Os administradores da sua organização provavelmente configuraram estruturas de segurança específicas 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 nas estruturas 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ê está pronto para aprovar o design.

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

Implantar o projeto de infraestrutura

Implante o design da infraestrutura no Google Cloud.

  1. Aprove o design e faça a implantação.

    Deploy the infrastructure design to my Google Cloud project.

    O agente implanta o design final no seu projeto 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 com sucesso, o agente vai mostrar detalhes da implantação, componentes da arquitetura e etapas para usar o aplicativo.

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

    Fix the component configuration errors.

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

  3. Para tentar a implantação novamente depois de fazer mudanças, repita as etapas desta seção.

Você implantou o código do aplicativo e o design da infraestrutura em 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.

    Excluir um projeto do Google Cloud :

    gcloud projects delete PROJECT_ID

A seguir