Apple container

Quando Usar

• Use ao construir, executar ou gerenciar contêineres OCI/Linux em Macs com Apple silicon, usando a CLI de código aberto da Apple container.
• Use quando quiser VMs leves por contêiner em vez de um daemon Docker.
• Use ao traduzir fluxos de trabalho no estilo Docker (build, run, exec, logs, networking) para as ferramentas de contêiner da Apple.

A container da Apple é uma CLI de código aberto para construir, executar e gerenciar contêineres OCI/Linux em Macs com Apple silicon. Cada contêiner é executado dentro de sua própria máquina virtual leve (suportada pelo framework de Containerização e pela API de Virtualização), portanto, não há um daemon compartilhado como o Docker — os serviços são executados por usuário via launchd. As imagens são artefatos OCI padrão, então elas interoperam com registros Docker e outras ferramentas OCI. A CLI é deliberadamente semelhante ao Docker (container run, container build e operações de imagem em container image push/pull), mas é uma ferramenta distinta: não assuma que os caminhos de comando, flags, padrões ou comportamento do daemon Docker são transferidos (por exemplo, não há comando de nível superior container images/push/pull — os verbos de imagem vivem em container image).

Portão de Segurança

A instalação de contêineres, inicialização de serviços, pulls de imagem, builds, runs, login em registros, pushes e limpeza de recursos alteram o estado local ou remoto. Explique o comando exato, o registro de imagem, os montadores, as portas, os privilégios e o impacto da persistência de dados, e então obtenha aprovação explícita do usuário antes de executá-lo. Não forneça credenciais de registro, monte caminhos sensíveis ou exponha portas sem a instrução explícita do usuário.

Requisitos

• Apenas Apple silicon (M1 ou posterior). Macs Intel não são suportados.
• macOS 26 (Tahoe) é o alvo oficialmente suportado. Os mantenedores não suportam macOS mais antigos e geralmente não corrigirão problemas que não possam ser reproduzidos no 26. O binário ainda roda no macOS 15 (Sequoia), mas com rede reduzida: apenas a única sub-rede padrão está disponível, e o grupo container network e a flag --network geram erro. Recursos com portão do macOS 26 são destacados nos arquivos de referência.
• Versão: esta habilidade documenta a versão 1.0.0 (o conjunto de recursos mais completo). O grupo machine, container cp, container export, container prune, container image prune, container registry list e container system version foram adicionados em 1.0.0 (não em 0.7.1) — recursos que sucedem 0.7.1 são marcados como (1.0.0+) nos arquivos de referência. Execute container --version e container <group> --help para ver o que sua build instalada suporta.
• Instale baixando o instalador assinado .pkg do GitHub releases do projeto (apple/container) e executando-o. Veja references/concepts.md para a matriz completa de requisitos/compatibilidade e como o modelo VM-por-contêiner funciona.

Configuração

Instale o pacote assinado, então inicie os serviços em segundo plano uma vez:

1. Baixe o instalador assinado mais recente .pkg da página de releases do GitHub.
2. Dê um duplo clique no pacote baixado e siga as instruções, inserindo sua senha de administrador para que ele possa colocar arquivos em /usr/local. (Não há invocação de CLI documentada installer — a instalação é via pacote GUI.)
3. Inicie os serviços e confirme que eles estão saudáveis:

# Start the container services (container-apiserver + helpers via launchd). On first run it
# offers to install the default Linux kernel — accept it, or start non-interactively with
# `--disable-kernel-install` and add a kernel later via `container system kernel set`.
container system start

# Verify services are healthy
container system status

container system start deve ter sido executado antes que qualquer comando de contêiner/imagem/build funcione — um erro de conexão/XPC quase sempre significa que os serviços estão parados, então execute-o novamente. Pare e desregistre os serviços launchd com container system stop (que leva apenas -p/--prefix). As flags de inicialização para container system start (-a/--app-root, --install-root, --log-root, --enable-kernel-install/--disable-kernel-install, --timeout) estão em references/configuration.md.

Atualizar / Rebaixar / Desinstalar use scripts auxiliares em /usr/local/bin (pare primeiro com container system stop): update-container.sh (adicione -v <version> para fixar uma versão) e uninstall-container.sh -d para remover dados do usuário ou -k para mantê-los. Receitas completas em references/workflows.md.

Grupos de comandos em resumo

…