GCP · antropia-aura-01

Referência de Comandos
agente-aura

Guia operacional completo para gerenciar a VM, fazer deploy, transferir arquivos e manter a infraestrutura do projeto AURA.

VM e2-custom-medium-2048
Zona us-central1-c
Acesso IAP Tunnel
Informações da VM
Projeto GCPantropia-aura-01
Nome da VMagente-aura
Zonaus-central1-c
Regiãous-central1
Máquinae2-custom-medium-2048
IP interno10.128.0.2
IP externoNão possui
Acesso SSHVia IAP Tunnel
HTTP / HTTPSLiberado
Pasta padrão/home/Usuario
★
Comando de conexão diária
Use este comando toda vez que precisar entrar na VM. Conecta, garante a pasta padrão e abre o bash.
Windows CMD / PowerShell
gcloud compute ssh agente-aura --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap --command="mkdir -p /home/Usuario && cd /home/Usuario && bash"
O que esse comando faz

Conecta na VM usando IAP Tunnel (sem IP público), com o projeto correto, na zona correta. Cria /home/Usuario caso não exista e já entra na pasta padrão.

02
Selecionar Projeto & Verificar Conta
Use sempre antes de qualquer operação importante no GCP.
WIN

Definir projeto ativo

Selecionar projetoWindows
gcloud config set project antropia-aura-01
Confirmar projeto ativoWindows
gcloud config get-value project

Conta ativa

Listar contasWindows
gcloud auth list
Trocar para conta AntropIAWindows
gcloud config set account accounts@antrop-ia.com
04
Listar VMs do Projeto
WIN
Listagem completaWindows
gcloud compute instances list --project=antropia-aura-01
Formato tabela limpaWindows
gcloud compute instances list --project=antropia-aura-01 --format="table(name,zone,machineType,networkInterfaces[0].networkIP,status)"
05
Conectar na VM via SSH
Como a VM não tem IP externo, toda conexão usa IAP Tunnel.
WIN
SSH simplesWindows
gcloud compute ssh agente-aura --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
SSH + entrar na pasta padrãoWindows
gcloud compute ssh agente-aura --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap --command="mkdir -p /home/Usuario && cd /home/Usuario && bash"
Atalho .bat

Crie um arquivo conectar-agente-aura.bat com o comando acima precedido por @echo off e duplo clique para conectar sem digitar nada.

08
Ligar, Parar e Reiniciar a VM
WIN
Parar VMWindows
gcloud compute instances stop agente-aura --project=antropia-aura-01 --zone=us-central1-c
Iniciar VMWindows
gcloud compute instances start agente-aura --project=antropia-aura-01 --zone=us-central1-c
Reiniciar VMWindows
gcloud compute instances reset agente-aura --project=antropia-aura-01 --zone=us-central1-c
09
Baixar Arquivos da VM → Windows
WIN
Pasta inteiraWindows
gcloud compute scp --recurse agente-aura:/home/Usuario C:\Users\Usuario\Downloads --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
Arquivo específicoWindows
gcloud compute scp agente-aura:/home/Usuario/NOME_DO_ARQUIVO C:\Users\Usuario\Downloads --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
Todos os .mdWindows
gcloud compute scp agente-aura:/home/Usuario/*.md C:\Users\Usuario\Downloads --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
10
Enviar Arquivos Windows → VM
WIN
Arquivo únicoWindows
gcloud compute scp C:\Users\Usuario\Downloads\arquivo.zip agente-aura:/home/Usuario --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
Pasta inteiraWindows
gcloud compute scp --recurse C:\Users\Usuario\Downloads\minha-pasta agente-aura:/home/Usuario --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
11
Compactar Arquivos na VM
Compacte primeiro dentro da VM, depois baixe um único arquivo .tar.gz.
VM
Compactar pasta UsuarioVM (bash)
cd /home tar -czf Usuario-backup.tar.gz Usuario
Baixar o backup geradoWindows
gcloud compute scp agente-aura:/home/Usuario-backup.tar.gz C:\Users\Usuario\Downloads --project=antropia-aura-01 --zone=us-central1-c --tunnel-through-iap
12
Firewall HTTP & HTTPS
Regra allow-http-https já criada e ativa.
WIN
Verificar regraWindows
gcloud compute firewall-rules describe allow-http-https --project=antropia-aura-01
Listar todas as regrasWindows
gcloud compute firewall-rules list --project=antropia-aura-01
Criar regra (caso não exista)Windows
gcloud compute firewall-rules create allow-http-https --project=antropia-aura-01 --direction=INGRESS --action=ALLOW --rules=tcp:80,tcp:443 --source-ranges=0.0.0.0/0
13
Firewall SSH via IAP
Libera porta 22 apenas para o range do Google IAP.
WIN
Verificar regra IAPWindows
gcloud compute firewall-rules describe allow-ssh-iap --project=antropia-aura-01
Criar regra (caso não exista)Windows
gcloud compute firewall-rules create allow-ssh-iap --project=antropia-aura-01 --network=default --allow=tcp:22 --source-ranges=35.235.240.0/20 --description="Allow SSH via IAP"
14
Cloud NAT
Obrigatório para a VM sem IP externo acessar a internet (apt, npm, curl, etc.).
WIN
Criar routerWindows
gcloud compute routers create nat-router --project=antropia-aura-01 --network=default --region=us-central1
Criar NATWindows
gcloud compute routers nats create nat-config --project=antropia-aura-01 --router=nat-router --router-region=us-central1 --auto-allocate-nat-external-ips --nat-all-subnet-ip-ranges --enable-logging
Listar NATs ativosWindows
gcloud compute routers nats list --project=antropia-aura-01 --router=nat-router --router-region=us-central1
15
Testar Internet dentro da VM
VM
Teste principalVM (bash)
curl -4 -I https://deb.debian.org
Teste nodesourceVM (bash)
curl -4 -I https://deb.nodesource.com
Resultado esperado

HTTP/2 200 ou HTTP/1.1 200. Se retornar, internet está ok e pode instalar pacotes normalmente.

16
Instalar Dependências Básicas
Execute em ordem. Força IPv4 primeiro para evitar timeout.
VM
Forçar IPv4 no aptVM (bash)
sudo bash -c 'echo "Acquire::ForceIPv4 \"true\";" > /etc/apt/apt.conf.d/99force-ipv4'
Atualizar pacotesVM (bash)
sudo apt clean && sudo apt update -o Acquire::ForceIPv4=true
Instalar dependênciasVM (bash)
sudo apt install -y curl wget git build-essential ca-certificates gnupg unzip zip
17
Instalar Node.js 20
VM
Adicionar repositório NodeSourceVM (bash)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
InstalarVM (bash)
sudo apt install -y nodejs
Verificar versãoVM (bash)
node -v && npm -v
18
Instalar Claude Code
VM
Instalar globalmenteVM (bash)
sudo npm install -g @anthropic-ai/claude-code
Verificar instalaçãoVM (bash)
claude --version
Entrar no projeto e abrirVM (bash)
mkdir -p /home/Usuario/aura && cd /home/Usuario/aura && claude
19
Criar API Key Gemini
Execute os passos em ordem no Windows antes de salvar na VM.
WIN
1 · Confirmar billingWindows
gcloud billing projects describe antropia-aura-01
2 · Ativar APIsWindows
gcloud services enable generativelanguage.googleapis.com apikeys.googleapis.com --project=antropia-aura-01
3 · Criar keyWindows
gcloud services api-keys create --project=antropia-aura-01 --display-name="gemini-aura-paid-key"
4 · Listar keysWindows
gcloud services api-keys list --project=antropia-aura-01
5 · Obter valor da key (substitua UID)Windows
gcloud services api-keys get-key-string UID_DA_KEY --project=antropia-aura-01
6 · Restringir para GeminiWindows
gcloud services api-keys update UID_DA_KEY --project=antropia-aura-01 --api-target=service=generativelanguage.googleapis.com
20
Salvar Chave Gemini no .env
VM
Editar .envVM (bash)
cd /home/Usuario/aura && nano .env
GEMINI_API_KEY=sua-chave-aqui
Salvar no nano

CTRL + O → ENTER → CTRL + X

Verificar conteúdoVM (bash)
cat .env
21
Criar IP Externo Estático
Use apenas se precisar expor a VM publicamente.
WIN
Atenção

IPs estáticos têm custo mesmo quando não associados a nenhuma VM. Reserve apenas se for usar.

Criar IPWindows
gcloud compute addresses create agente-aura-ip --project=antropia-aura-01 --region=us-central1
Ver IP criadoWindows
gcloud compute addresses describe agente-aura-ip --project=antropia-aura-01 --region=us-central1 --format="get(address)"
Associar IP à VMWindows
gcloud compute instances add-access-config agente-aura --project=antropia-aura-01 --zone=us-central1-c --access-config-name="External NAT" --address=SEU_IP_ESTATICO
Remover IP externo (voltar ao modo seguro)Windows
gcloud compute instances delete-access-config agente-aura --project=antropia-aura-01 --zone=us-central1-c --access-config-name="External NAT"
23
DNS no Google Cloud
Substitua seudominio.com.br e SEU_IP_ESTATICO pelos valores reais.
WIN
Criar zona DNSWindows
gcloud dns managed-zones create aura-zone --project=antropia-aura-01 --dns-name="seudominio.com.br." --description="Zona DNS do projeto Aura"
Ver nameserversWindows
gcloud dns managed-zones describe aura-zone --project=antropia-aura-01 --format="value(nameServers)"
Criar registro A (3 passos em sequência)Windows
gcloud dns record-sets transaction start --zone=aura-zone --project=antropia-aura-01 gcloud dns record-sets transaction add SEU_IP_ESTATICO --name="aura.seudominio.com.br." --ttl=300 --type=A --zone=aura-zone --project=antropia-aura-01 gcloud dns record-sets transaction execute --zone=aura-zone --project=antropia-aura-01
24
Comandos Úteis dentro da VM
VM
Navegação básicaVM (bash)
pwd # pasta atual ls -lah # listar arquivos cd /home/Usuario # pasta padrão mkdir -p nome-da-pasta
Recursos do sistemaVM (bash)
df -h # uso de disco free -h # memória top # processos em tempo real
Editar arquivoVM (bash)
nano nome-do-arquivo.md
25
Diagnóstico Rápido
Execute quando algo não funcionar. Comece pelo Windows, depois entre na VM.

No Windows — verificar configuração

Check completo (copiar e rodar tudo)Windows
gcloud config get-value project gcloud auth list gcloud compute instances list --project=antropia-aura-01 gcloud compute firewall-rules list --project=antropia-aura-01 gcloud services list --enabled --project=antropia-aura-01

Dentro da VM — verificar conectividade

Check de redeVM (bash)
ping -c 4 8.8.8.8 curl -4 -I https://deb.debian.org sudo apt update -o Acquire::ForceIPv4=true
ANTROP-IA · agente-aura · antropia-aura-01 GCP us-central1-c · IAP Tunnel