Guia Detalhado: OrbStack: O Novo Padrão de Virtualização de Alta Performance para macOS
Source: Dev.to
🚀 1. Instalação: O Caminho Mais Rápido
Via Homebrew (Recomendado)
brew install --cask orbstackVia Download Manual
Acesse orbstack.dev e baixe o instalador para Apple Silicon (M1/M2/M3) ou Intel.
⚙️ 2. Configuração Inicial e Migração
Ao abrir o OrbStack pela primeira vez, ele oferece ser o motor Docker principal.
Migração de Dados
Se já tens o Docker Desktop instalado, o OrbStack pergunta se queres migrar imagens e volumes. Se o teu ambiente estiver “sujo”, aproveita para começar do zero e ganhar espaço em disco.
Rosetta 2
Para executar containers de arquitetura Intel (x86) em Macs ARM, garante que o Rosetta 2 está ativo:
softwareupdate --install-rosetta🐳 3. Como Usar: Docker e Máquinas Linux
Docker (Drop‑in Replacement)
O OrbStack mapeia o socket do Docker automaticamente. Todos os comandos habituais funcionam:
docker ps
docker-compose up
docker build .Máquinas Linux (VMs Estilo WSL)
- Via GUI: Clique em “New Machine” e escolha a distro.
- Via CLI:
orb create ubuntu minha-vm - Acesso Direto: Digite
orbno terminal para entrar na máquina padrão instantaneamente.
Domínios Mágicos
Se um container roda na porta 8080, o OrbStack cria automaticamente um domínio:
http://nome-do-container.orb.local
Isso elimina a necessidade de gerenciar conflitos de portas no localhost.
🛠️ 4. Manutenção e Higiene do Sistema
Limpeza de Disco
O OrbStack usa um sistema de arquivos esparso, mas imagens Docker antigas podem permanecer.
- Limpeza automática: Configure o limite de espaço nas definições.
- Limpeza manual:
docker system prune -a # Remove containers parados e imagens não usadasGestão de Memória
Ao contrário do Docker Desktop, não é necessário limitar a RAM. O OrbStack aloca dinamicamente a memória necessária e a devolve ao macOS quando o container termina.
Atualizações
Verifique atualizações em Check for Updates no menu da barra de tarefas. As atualizações são quase silenciosas e não interrompem o fluxo de trabalho.
🏆 5. Dicas de “Power User”
- Acesso a ficheiros:
/mnt/macdentro de qualquer VM permite acesso bidirecional aos arquivos do Mac. - SSH nativo: Conecte‑se a uma máquina OrbStack com
ssh orb. - Kubernetes: Ative nas definições para usar a implementação mais leve de K8s no macOS.
💡 BÔNUS: OrbStack CLI Cheat Sheet
🏗️ Gerenciamento de Máquinas (VMs)
| Comando | O que faz |
|---|---|
orb create | Cria uma nova VM (ex.: orb create ubuntu dev-box) |
orb list | Lista todas as VMs e containers ativos |
orb shell | Entra no terminal da VM (atalho: orb entra na padrão) |
orb stop | Desliga uma VM específica |
orb delete | Remove a VM e todos os seus dados |
📂 Transferência de Arquivos
| Comando | O que faz |
|---|---|
orb push : | Envia um arquivo do Mac para a VM |
orb pull : | Traz um arquivo da VM para o Mac |
Dica Pro: O diretório
Homedo Mac está sempre disponível em/mnt/macdentro de qualquer máquina OrbStack.
⚡ Comandos Rápidos e Execução
Rodar um comando sem entrar na VM:
orb exec
# Exemplo:
orb exec ubuntu apt updateVer logs de um container específico:
orb logs -f Ajuda rápida:
orb help🐳 E o Docker?
O OrbStack funciona como um substituto transparente do Docker Desktop. Continue usando os comandos padrão:
docker psdocker-compose up -ddocker system prune(para limpeza de primavera)
Conclusão do Artigo
Com este guia e o cheat sheet, você está pronto para transformar seu Mac em uma máquina de desenvolvimento de alta performance. O OrbStack não é apenas uma alternativa ao Docker Desktop; é uma evolução do workflow no macOS.