Skip to main content

AULA 5.4 - GEMINI AGENT MODE NO VSCODE

Material de Referência para Instrutor​

INTRODUÇÃO​

Pergunta Central: Como usar IA que não apenas sugere código, mas planeja e executa refatorações massivas em projetos Terraform automaticamente?

Agent Mode representa a evolução natural da IA assistiva para DevOps - a transição de ferramentas que respondem perguntas para agentes que executam tarefas complexas. Não é um chat melhorado ou autocompletar inteligente. É um assistente que recebe instruções de alto nível como "migre todos os recursos para modules Terraform", planeja a execução em etapas sistemáticas, e modifica dezenas de arquivos automaticamente mantendo consistência arquitetural.

O Problema das Refatorações Manuais: Todo profissional DevOps conhece o terror das refatorações grandes: você sabe que precisa modernizar aquele projeto Terraform legacy, migrar recursos para modules, padronizar tags entre ambientes. Mas também sabe que são semanas de trabalho manual, propensão alta a erros, e risco constante de quebrar infraestrutura funcionando. O resultado é procrastinação indefinida e acúmulo de dívida técnica.

A Revolução do Planning Inteligente: Agent Mode elimina o medo da refatoração através de planejamento automático e execução supervisionada. O agente analisa todo o projeto Terraform simultaneamente, identifica dependências e padrões, planeja a refatoração em etapas seguras, executa mudanças sistematicamente, e oferece rollback completo se algo não funcionar conforme esperado.

Por que é Transformacional para Infrastructure as Code: Projetos Terraform modernos envolvem dezenas de arquivos interconectados, múltiplos ambientes que devem permanecer consistentes, e padrões arquiteturais que precisam ser aplicados uniformemente. Agent Mode compreende essas complexidades e executa mudanças que preservam funcionalidade enquanto implementam melhorias estruturais significativas.

O QUE VAMOS APRENDER​

Objetivos de Aprendizagem:​

  1. Ativar Agent Mode no VSCode e compreender diferenças fundamentais versus chat tradicional
  2. Executar três refatorações críticas: migração para modules, padronização de tags, e modernização de sintaxe
  3. Utilizar sistema de checkpoint/rollback para experimentação segura em projetos reais

Competências Desenvolvidas:​

  • Refatoração automatizada de Infrastructure as Code em escala enterprise
  • Migração segura de arquiteturas Terraform legacy para padrões modernos
  • Modernização sistemática de projetos Azure mantendo consistência operacional

AGENT MODE COMO PARADIGMA DE EXECUÇÃO​

Diferença Fundamental: Planejamento versus Resposta​

Agent Mode não é versão melhorada de chat que explica como fazer algo. É assistente que compreende o que precisa ser feito, desenvolve plano de execução detalhado, e implementa mudanças diretamente no projeto. A diferença é entre receber instruções sobre como dirigir versus ter motorista que conhece o destino e executa a viagem completa.

Inteligência Multi-Arquivo Nativa​

Enquanto ferramentas tradicionais trabalham arquivo por arquivo ou sugerem mudanças locais, Agent Mode processa projetos como sistemas integrados. Compreende relacionamentos entre resources, dependencies entre módulos, e impactos de mudanças em arquitetura geral. Essa visão holística permite refatorações que preservam funcionalidade enquanto implementam melhorias estruturais.

Sistema de Checkpoint Automático​

A segurança é fundamental em qualquer refatoração significativa. Agent Mode implementa sistema de checkpoint que cria backup completo antes de qualquer modificação, monitora progresso em tempo real validando sintaxe a cada etapa, e oferece rollback de um clique que restaura estado inicial caso algo não funcione conforme esperado.

TRÊS REFATORAÇÕES TRANSFORMACIONAIS​

Migração para Arquitetura Modular​

A primeira refatoração essencial envolve migrar recursos Terraform dispersos para estrutura modular reutilizável. Agent Mode analisa padrões existentes no projeto, identifica componentes que devem ser modularizados, cria estrutura de modules seguindo best practices, migra resources preservando todas as configurações, e atualiza chamadas nos environments para usar nova arquitetura modular.

Padronização de Tags Corporativas​

A segunda refatoração implementa tags corporativas obrigatórias em todos os recursos Azure do projeto. O agente escaneia recursos existentes identificando quais precisam de tags adicionais, cria locals para gerenciamento centralizado de tags, atualiza cada resource sistematicamente, e adiciona variables necessárias mantendo tags existentes intactas.

Modernização para Terraform 1.5+​

A terceira refatoração moderniza projetos legacy para aproveitar recursos mais recentes do Terraform. Inclui conversão de count para for_each onde apropriado, adição de validation blocks em variables, implementação de lifecycle rules para resources críticos, reorganização de providers em arquivo versions.tf dedicado, e adição de terraform block com required_version específica.

CASOS DE APLICAÇÃO ENTERPRISE​

Reorganização de Projetos Desorganizados​

Para projetos Terraform legacy onde todo código está concentrado em main.tf gigante, Agent Mode reorganiza sistematicamente separando por tipo de recurso (networking.tf, storage.tf, security.tf), extrai componentes reutilizáveis em modules dedicados, adiciona validações apropriadas em variables, e organiza outputs por categoria lógica mantendo funcionalidade completa.

Consistência entre Múltiplos Ambientes​

Quando desenvolvimento, staging e produção possuem configurações inconsistentes causando diferenças comportamentais, o agente padroniza configurações usando locals para definições por ambiente, implementa workspace-based deployment, garante naming consistency entre ambientes, e padroniza tags e políticas eliminando discrepâncias operacionais.

Implementação de Security Hardening​

Para aplicação de security best practices em massa, Agent Mode identifica todos os recursos relacionados à segurança, implementa configurações de hardening sistematicamente (Storage Accounts com public access desabilitado, Key Vaults com purge protection, VNets com NSG rules apropriadas), adiciona data sources necessários para políticas de segurança, e valida compliance com Azure policies corporativas.

INTEGRAÇÃO COM WORKFLOWS DE DESENVOLVIMENTO​

Automação de Pre-commit Standards​

Agent Mode pode ser integrado em pre-commit hooks para garantir que todo código segue padrões corporativos antes de ser commitado. O agente executa formatação automática, valida sintaxe, verifica políticas de segurança, e adiciona tags obrigatórias que possam ter sido esquecidas durante desenvolvimento.

Validação Inteligente em CI/CD​

Em pipelines de continuous integration, o agente pode validar pull requests verificando breaking changes potenciais, dependências de recursos, conformidade com naming conventions, e configurações de segurança antes que mudanças sejam aplicadas em ambientes produtivos.

Onboarding Automatizado de Projetos​

Para novos projetos Terraform, Agent Mode pode implementar setup completo seguindo standards corporativos incluindo estrutura de pastas padrão, configurações de provider apropriadas, structure básica de modules, templates de pipeline CI/CD, e baselines de segurança estabelecidos pela organização.

CONFIGURAÇÃO E PRIMEIROS PASSOS​

Setup Técnico para Agent Mode​

A ativação requer VSCode com extensão Gemini Code Assist instalada, subscription do Gemini Pro (necessária para context window de 1M tokens), e habilitação do Agent Mode no workspace específico. O setup completo leva menos de 2 minutos e não requer configurações complexas de ambiente.

Teste de Validação Inicial​

O primeiro teste deve ser executado em projeto Terraform simples contendo Resource Group básico e Storage Account com variables mínimas. Solicite ao agente para organizar seguindo best practices e observe execução: análise de estrutura atual, planejamento de refatoração em etapas, execução automática de mudanças, validação de sintaxe Terraform, e disponibilização de rollback se necessário.

Progressão de Complexidade Estruturada​

Após validação inicial, proceda com casos progressivamente complexos: organização de projeto pequeno na primeira semana, migração de resources para modules na segunda, padronização entre múltiplos ambientes na terceira, e security hardening em massa na quarta semana. Essa progressão constrói confiança e competência sistemática.

DIFERENCIAÇÃO DE FERRAMENTAS CONVENCIONAIS​

Superioridade sobre Chat Traditional​

Enquanto ChatGPT e similares explicam como executar refatorações mas requerem implementação manual, Agent Mode compreende requisitos e executa mudanças diretamente. É diferença entre consultor que recomenda ações versus executor que implementa soluções completas.

Vantagem sobre Autocompletar Inteligente​

GitHub Copilot oferece sugestões linha por linha mas não compreende arquitetura geral do projeto. Agent Mode analisa sistemas completos e executa refatorações que preservam integridade arquitetural enquanto implementam melhorias estruturais significativas.

Comparação com Ferramentas Especializadas​

Ferramentas específicas para Terraform oferecem validação e sugestões mas não executam refatorações complexas automaticamente. Agent Mode combina conhecimento especializado com capacidade de execução, oferecendo solução integrada para modernização de projetos Infrastructure as Code.

CONCLUSÃO​

Principais Takeaways:​

  1. Paradigma de Execução Automática

    • Transição de IA que sugere para IA que executa
    • Planejamento inteligente em etapas sistemáticas
    • Rollback automático para experimentação segura

  2. Transformação de Refatorações Enterprise

    • Projetos legacy modernizados em horas ao invés de semanas
    • Consistência entre ambientes garantida sistematicamente
    • Security hardening implementado em massa com validação

  3. Integração Nativa com Workflows DevOps

    • Pre-commit hooks para standards automáticos
    • CI/CD validation para mudanças seguras
    • Onboarding acelerado para novos projetos

Transformação Real:​

Antes: Refatorações manuais demoradas, propensas a erro, com medo de quebrar infraestrutura funcionando

Com Agent Mode: Execução automática confiável, rollback garantido, modernização sistemática de projetos enterprise