Solução da comunidade

Utilize o Docker no ZimaOS sem instalar o Docker Desktop

A ZimaOS user asks how to install Docker Desktop; the community answer explains that ZimaOS already provides Docker Engine and its own management paths.

O Docker Desktop é a camada errada para o ZimaOS

A resposta no tópico é direta: o Docker Desktop não é suportado no ZimaOS e não é necessário para executar contentores nesse sistema. O ZimaOS já funciona como uma plataforma de servidor nativa do Docker, pelo que as aplicações devem ser implementadas através da App Store, da interface de instalação personalizada ou da linha de comandos do Docker através de uma sessão SSH autorizada.

O Docker Desktop é uma aplicação de ambiente de trabalho para ambientes de ambiente de trabalho compatíveis com Windows, macOS e Linux. Inclui uma experiência gráfica para programadores e a sua própria integração com o runtime. Tentar adicioná-lo a um sistema operativo gerido, ao estilo de um dispositivo dedicado, pode entrar em conflito com o controlo que o ZimaOS exerce sobre o Docker, a rede, os metadados das aplicações e as atualizações.

Traduza o tutorial em vez de instalar o pré-requisito de ambiente de trabalho

Se um tutorial disser «abra o Docker Desktop», identifique o que acontece a seguir. Extrair uma imagem, configurar portas, definir variáveis de ambiente e mapear volumes pode normalmente ser feito como uma aplicação personalizada do ZimaOS. Um ficheiro Compose também pode ser traduzido, mas todos os caminhos do anfitrião e todas as portas devem ser revistos para a máquina com ZimaOS.

Não copie caminhos do Windows, caminhos do macOS ou nomes de anfitrião do Docker Desktop, como host.docker.internal, sem verificar se a aplicação precisa realmente deles. Um contentor de servidor precisa normalmente de caminhos persistentes no armazenamento pretendido do ZimaOS, de uma porta do anfitrião não utilizada e de uma política de reinício explícita.

A documentação oficial sobre o âmbito da instalação do Docker Desktop descreve as distribuições e os requisitos de ambiente de trabalho compatíveis. Isso não transforma o Docker Desktop num pacote de gestão de uso geral para todos os dispositivos dedicados baseados em Linux.

Escolha o método de implementação do ZimaOS adequado à carga de trabalho

Utilize a App Store quando já existir um pacote mantido que corresponda à aplicação e à disposição do armazenamento. Reveja a origem da imagem, a versão, os volumes e as portas expostas antes de instalar. «Um clique» continua a exigir um plano de cópias de segurança e de atualização dos dados da aplicação.

Utilize a instalação personalizada para uma imagem ou uma pilha Compose que necessite de variáveis e caminhos controlados. Antes de iniciar, substitua as palavras-passe de exemplo, selecione armazenamento persistente, confirme que as bases de dados não estão armazenadas apenas numa camada efémera do contentor e evite expor portas de administração à Internet pública.

Utilize o SSH e a CLI do Docker para inspeção, resolução de problemas ou uma pilha gerida intencionalmente de forma autónoma. Comandos como docker ps, docker logs e docker compose funcionam abaixo da interface Web; registe as alterações manuais, porque o ZimaOS pode não apresentar nem preservar todas as premissas externas.

Verifique o contentor sem alterar o sistema operativo base

Após a implementação, confirme que o contentor continua em execução, que a verificação de integridade é bem-sucedida, quando presente, e que o URL da aplicação abre a partir de outro cliente da LAN. Em seguida, reinicie o contentor e verifique se os dados permanecem. Uma página funcional antes do reinício não prova a persistência do volume.

Reinicie o ZimaOS uma vez e confirme que a pilha regressa de acordo com a política de reinício pretendida. Inspecione apenas os registos da aplicação relevantes para esse teste. Se o contentor iniciar mas a página não abrir, distinga entre uma porta incorreta, a firewall do anfitrião, um atraso na inicialização da aplicação e um serviço em estado não saudável antes de o recriar.

Não instale um segundo daemon do Docker, substitua pacotes do sistema nem execute um script genérico de configuração de uma distribuição apenas para satisfazer um tutorial orientado para ambientes de trabalho. Se a aplicação exigir funcionalidades do kernel não suportadas ou alterações privilegiadas no anfitrião, pare e avalie outro método de implementação em vez de enfraquecer cegamente o anfitrião.

Perguntas frequentes

Posso instalar o Docker Desktop através de uma aplicação personalizada do ZimaOS?

Não existe nenhum método suportado estabelecido. Uma aplicação personalizada cria contentores; não transforma um sistema operativo de servidor num ambiente compatível com o Docker Desktop.

O ZimaOS suporta o Docker Compose?

A resposta da comunidade aponta para a CLI do Docker e o Compose através de SSH, enquanto a interface Web pode importar ou traduzir muitas pilhas. Valide os comandos e os caminhos na versão exata do ZimaOS.

Os contentores criados através de SSH aparecerão corretamente na App Store?

Não necessariamente. O Docker pode executá-los, mas o ZimaOS pode não dispor dos mesmos metadados da aplicação nem da mesma vista de gestão. Mantenha a definição Compose original como fonte de verdade.

A resposta específica da plataforma está preservada na discussão sobre o Docker Desktop no ZimaOS.