Uma visão do conjunto

O ambiente documentado no projeto parte de um computador Windows. Nele, uma máquina virtual executa o Ubuntu, onde o Docker e o OpenRemote foram instalados.

WindowsVirtualBoxUbuntuDockerOpenRemote

Este é um guia de orientação. O tutorial completo de instalação está em preparação. Aqui, você vai entender as ferramentas e o que precisa conhecer antes de seguir os comandos.

Por que usar uma máquina virtual?

O VirtualBox permite executar outro sistema operacional dentro do computador. No nosso ambiente, o Windows é o sistema hospedeiro e o Ubuntu é o sistema convidado.

Essa organização separa o ambiente de testes do sistema principal. A máquina virtual utiliza parte da memória, do armazenamento e do processamento disponíveis no computador.

Também é possível configurar recursos de integração, como uma pasta compartilhada para transferir arquivos e uma área de transferência compartilhada para copiar textos. Esses recursos foram usados na preparação do projeto.

Docker e Compose: funções diferentes

O Docker executa aplicações em containers. Cada container reúne um programa e os recursos necessários para executá-lo, compartilhando o kernel do sistema que o hospeda.

O Docker Compose descreve e administra um conjunto desses serviços. No projeto, o arquivo docker-compose.yml reúne as configurações dos componentes do OpenRemote.

Máquina virtual e container não são a mesma coisa. Neste ambiente, o Ubuntu roda na máquina virtual. Os containers do OpenRemote são executados dentro desse Ubuntu.

O que funciona junto?

  • Manager: oferece a interface e os recursos de gerenciamento da plataforma.
  • PostgreSQL: mantém os dados persistentes.
  • Keycloak: gerencia identidades, autenticação e permissões.
  • Proxy: recebe conexões e as encaminha aos serviços correspondentes.

O ambiente relatado no projeto permite abrir o Manager pelo navegador do Ubuntu usando https://localhost.

Localhost depende de onde você está. No navegador dentro do Ubuntu, ele aponta para a máquina virtual. No navegador do Windows, aponta para o computador hospedeiro. O acesso entre esses ambientes exige configuração de rede adequada.

O que conferir antes de instalar

  • Anote as versões do sistema operacional, VirtualBox, Docker, Compose e OpenRemote que serão utilizadas.
  • Confira os requisitos das ferramentas e os recursos disponíveis no computador.
  • Identifique a origem do arquivo Compose e as versões das imagens que ele utiliza.
  • Entenda onde os arquivos e os dados da aplicação serão armazenados.
  • Saiba em qual sistema cada comando deve ser executado.

O projeto já registra uma instalação local em funcionamento. Estamos organizando os detalhes necessários para que o passo a passo público seja verificável e reproduzível.

Aprender o ambiente não exige executar a integração com equipamentos reais. A configuração de contas de serviço e os testes de aplicações externas fazem parte de etapas posteriores.

Documentação oficial

A documentação pode mudar com novas versões. Confira os requisitos e a versão correspondente antes de instalar.