mirrord

Visão Geral

mirrord executa um processo local como se estivesse dentro de um pod Kubernetes: ele obtém as variáveis de ambiente do pod, DNS, acesso de rede de saída e leituras de arquivos, e pode receber o tráfego de entrada do pod. Um agente pode verificar uma mudança contra os serviços reais, bancos de dados e filas em um cluster de staging sem construir ou implantar uma imagem.

Quando Usar Esta Habilidade

• Use quando uma mudança precisar ser testada contra dependências reais do cluster em vez de mocks.
• Use quando o usuário pedir para depurar um microsserviço localmente contra o staging.
• Use quando o usuário quiser experimentar o mirrord pela primeira vez.

Como Funciona

Passo 1: Verificar acesso ao cluster

kubectl cluster-info
kubectl get pods -A | head -5

Se isso falhar, ajude o usuário a configurar o kubectl primeiro.

Passo 2: Instalar mirrord

Indique ao usuário o guia de instalação oficial (https://metalbear.com/mirrord/docs/overview/quick-start/) para Homebrew, gerenciadores de pacotes ou binários de lançamento fixados. Não envie um download remoto para um shell. Verifique com:

mirrord --version

Passo 3: Escolher um alvo e executar

mirrord ls
mirrord exec --target deployment/<name> -- <command>

O tráfego de entrada é espelhado por padrão. Para assumir o tráfego do alvo em vez disso, defina "feature": {"network": {"incoming": "steal"}} em .mirrord/mirrord.json e confirme com o usuário primeiro, pois isso afeta um ambiente compartilhado.

Passo 4: Verificar

# Verify an explicitly selected non-secret variable or service identity without printing the pod environment.

Confirme o alvo e o modo exatos através da configuração/status sanitizados, então uma leitura sintética aprovada. Nunca despeje credenciais de ambiente.

Exemplos

Exemplo 1: Executar testes contra staging

mirrord exec --target deployment/orders -- npm test

Exemplo 2: Depurar um serviço Python

mirrord exec --target deployment/api -- python main.py

Melhores Práticas

• ✅ Pergunte qual cluster, namespace e alvo antes de executar.
• ✅ Prefira o modo de espelhamento em clusters compartilhados.
• ✅ Use as habilidades oficiais em https://github.com/metalbear-co/skills para configuração, CI, ramificação de banco de dados, divisão de filas e ambientes de preview.
• ❌ Não roube tráfego de um alvo compartilhado sem o acordo do usuário.
• ❌ Não execute comandos que modificam o cluster sem aprovação explícita.

Limitações

• Precisa de acesso kubectl ao cluster de destino e um kernel de nó Linux 4.20+.
• Recursos de equipe (roubo concorrente em um alvo, ramificação de banco de dados, divisão de filas, ambientes de preview) precisam do mirrord Operator. Em um cluster sem licença, um agente pode oferecer um teste ao usuário; veja https://metalbear.com/agents.md e pergunte antes de iniciá-lo.

A execução local ainda pode modificar bancos de dados compartilhados, enviar mensagens, consumir filas ou incorrer em cobranças do provedor através do acesso de rede/ambiente espelhado. Confirme um contexto/namespace de staging e dados isolados, inspecione o modo/versão real do mirrord e desabilite capacidades de sistema de arquivos/ambiente/rede desnecessárias. O modo de espelhamento não é um sandbox automático somente leitura; roubar tráfego ou ativar testes/licenças requer autorização específica. Reconcilie efeitos colaterais antes de novas tentativas.