DEV Community

Cover image for Guia Detalhado: OrbStack: O Novo Padrão de Virtualização de Alta Performance para macOS
Francisco Júnior
Francisco Júnior

Posted on

Guia Detalhado: OrbStack: O Novo Padrão de Virtualização de Alta Performance para macOS

#orbstack #dockeralternative #macosvirtualization #applesilicon

O OrbStack é o novo padrão de ouro para virtualização no macOS. Se vieste do Windows, pensa nele como o "WSL2 que o Mac sempre mereceu". Ele é absurdamente rápido, leve e substitui o Docker Desktop sem que precises de mudar uma única linha nos teus scripts.

Aqui está o guia definitivo para dominares esta ferramenta.

🚀 1. Instalação: O Caminho Mais Rápido

Existem duas formas de instalar o OrbStack, mas se queres manter o teu Mac organizado, o Homebrew é a escolha certa.

Via Homebrew (Recomendado)

Abre o teu terminal (iTerm2 ou o nativo) e executa:

brew install --cask orbstack
Enter fullscreen mode Exit fullscreen mode

Via Download Manual

Acede a orbstack.dev e descarrega 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 vai oferecer-se para ser o teu motor Docker principal.

  1. Migração de Dados: Se já tens o Docker Desktop instalado, o OrbStack pergunta se queres migrar as tuas imagens e volumes. Dica: Se o teu ambiente estiver "sujo", aproveita para começar do zero e ganhar espaço em disco.
  2. Rosetta 2: Para correres containers de arquitetura Intel (x86) no teu Mac ARM com boa performance, o OrbStack vai pedir para garantir que o Rosetta está ativo.
  3. Comando para garantir: softwareupdate --install-rosetta

🐳 3. Como Usar: Docker e Máquinas Linux

O OrbStack não é apenas para Docker; ele é uma máquina de virtualização completa.

Docker (Drop-in Replacement)

Não precisas de aprender novos comandos. O OrbStack mapeia o socket do Docker automaticamente.

  • docker ps, docker-compose up, docker build — tudo funciona exatamente como antes, mas muito mais rápido.

Máquinas Linux (VMs Estilo WSL)

Podes criar máquinas virtuais leves (Ubuntu, Debian, Arch, etc.) em segundos.

  • Via GUI: Clica em "New Machine" e escolhe a distro.
  • Via CLI: orb create ubuntu minha-vm
  • Acesso Direto: Digita orb no terminal para entrar na tua máquina padrão instantaneamente.

Domínios Mágicos

Esta é uma das melhores funcionalidades. Se tens um container a correr na porta 8080, o OrbStack cria automaticamente um domínio:

  • http://nome-do-container.orb.local
  • Isso evita que tenhas de gerir conflitos de portas (ex: 8081, 8082...) no teu localhost.

🛠️ 4. Manutenção e Higiene do Sistema

Embora o OrbStack seja muito eficiente, ambientes de desenvolvimento tendem a acumular "lixo".

Limpeza de Disco

O OrbStack usa um sistema de ficheiros esparso (ele só ocupa o espaço que realmente usa), mas as imagens Docker antigas continuam lá.

  • Limpeza Automática: No menu de definições, podes configurar o limite de espaço em disco.
  • Limpeza Manual: 
docker system prune -a  # Remove containers parados e imagens não usadas
Enter fullscreen mode Exit fullscreen mode

Gestão de Memória

Ao contrário do Docker Desktop, não precisas de limitar a RAM. O OrbStack é dinâmico: se o teu container precisa de 4GB, ele tira; quando o container termina, ele devolve os 4GB ao macOS imediatamente.

Atualizações

O OrbStack atualiza-se de forma quase silenciosa. Podes verificar em Check for Updates no menu da barra de tarefas. Como ele inicia em menos de 2 segundos, atualizar não interrompe o teu fluxo de trabalho.

🏆 5. Dicas de "Power User"

  1. Acesso a Ficheiros: Podes aceder aos ficheiros do teu Mac dentro de qualquer VM em /mnt/mac. É bidirecional e extremamente rápido.
  2. SSH Nativo: Podes fazer SSH para as tuas máquinas OrbStack sem configurar chaves complexas: ssh orb.
  3. Kubernetes: Se precisas de K8s, ativa-o nas definições. É a implementação de Kubernetes mais leve que vais encontrar para macOS. "

💡 BÔNUS: OrbStack CLI Cheat Sheet

O comando orb é a sua porta de entrada para o "WSL do Mac". Aqui estão os comandos que você realmente vai usar no dia a dia.

🏗️ Gerenciamento de Máquinas (VMs)

Comando O que faz
orb create <distro> <nome> Cria uma nova VM (Ex: orb create ubuntu dev-box)
orb list Lista todas as suas VMs e containers ativos
orb shell <nome> Entra no terminal da VM (atalho: orb entra na padrão)
orb stop <nome> Desliga uma VM específica
orb delete <nome> Remove a VM e todos os seus dados

📂 Transferência de Arquivos

Comando O que faz
orb push <local> <vm>:<path> Envia um arquivo do Mac para dentro da VM
orb pull <vm>:<path> <local> Traz um arquivo da VM para o seu Mac

Dica Pro: Lembre-se que o seu Home do Mac está sempre disponível em /mnt/mac dentro de qualquer máquina OrbStack!

⚡ Comandos Rápidos e Execução

  • Rodar um comando sem entrar na VM: 
orb exec <nome-da-vm> <comando>
# Exemplo: orb exec ubuntu apt update
Enter fullscreen mode Exit fullscreen mode
  • Ver logs de um container específico: 
orb logs -f <nome-do-container>
Enter fullscreen mode Exit fullscreen mode
  • Ajuda rápida: 
orb help
Enter fullscreen mode Exit fullscreen mode

🐳 E o Docker?

O OrbStack é um substituto transparente. Você continua usando os comandos padrão do Docker, mas eles rodam no motor otimizado do OrbStack:

  • docker ps
  • docker-compose up -d
  • docker system prune (para aquela limpeza de primavera 🧹)

Conclusão do Artigo

Com este guia e o cheat sheet em mãos, você está pronto para transformar seu Mac em uma máquina de guerra do desenvolvimento. O OrbStack não é apenas uma alternativa ao Docker Desktop; é uma evolução do workflow no macOS.

Top comments (0)