Início rápido

Este guia orienta você na implantação de uma instância do rtCloud com hospedagem própria em um servidor Linux do zero. Ao final, você terá um rtCloud em execução acessível no seu navegador.

Pré-requisitos link

Certifique-se de que seu servidor atende aos seguintes requisitos antes de começar:

Hardware link

Software link

Instalar o Docker no Ubuntu:

  curl -fsSL https://get.docker.com | sh
  

Verifique a instalação:

  docker --version
docker compose version
  

Etapa 1 — Obtenha os arquivos link

Clone o repositório de implantação no seu servidor:

  git clone ssh://git@rtgit.rta.vn:2224/rtlab/rtwebteam/rta-smart-survey-docker.git rtcloud
cd rtcloud
  

Etapa 2 — Configure o ambiente link

Copie o arquivo de configuração de exemplo:

  cp .env.production.sample .env
  

Abra o .env em um editor de texto e preencha os valores necessários:

  # Identificador único para esta implantação (sem espaços, sem caracteres especiais)
PROJECT_ID=meuprojeto

# Domínio ou endereço IP onde os usuários acessarão o aplicativo
# Exemplo: rtcloud.exemplo.com.br  ou  192.168.1.100
PROJECT_URL=rtcloud.exemplo.com.br

# Protocolo: use "https" se tiver um domínio com SSL, "http" caso contrário
HTTP_PROTOCOL=https

# Senhas fortes e únicas — altere todas as três antes de iniciar
MYSQL_PASSWORD=minha_senha_forte
MYSQL_ROOT_PASSWORD=minha_senha_root
ADMIN_PASSWORD=minha_senha_admin
  

Importante: Apenas o .env é lido automaticamente pelo Docker Compose. Não crie um arquivo chamado .env.production, pois isso causaria confusão. O ADMIN_PASSWORD é aplicado somente na primeira inicialização de um banco de dados novo.

Etapa 3 — Inicie os contêineres link

Inicie todos os serviços em segundo plano:

  docker compose -f docker-compose.production.yml up -d
  

A primeira inicialização leva 3 a 5 minutos enquanto o Docker:

1. Baixa a imagem do aplicativo rtCloud (download de ~1 GB)
2. Inicializa o banco de dados MySQL
3. Carrega o esquema base
4. Executa todas as migrações de banco de dados pendentes

Monitore o progresso da inicialização em tempo real:

  docker compose -f docker-compose.production.yml logs -f rtcloud
  

Aguarde até ver a saída indicando que o aplicativo está pronto. Você também pode monitorar o status de integridade do contêiner:

  watch docker compose -f docker-compose.production.yml ps
  

Etapa 4 — Acesse o aplicativo link

Assim que ambos os contêineres mostrarem Up (healthy), abra seu navegador:

  http://<PROJECT_URL>:8080
  

Entre com a conta de administrador:

Altere a senha do administrador imediatamente após o primeiro login nas configurações da conta.

Etapa 5 — Verifique todos os serviços link

Verifique se todos os contêineres estão em execução e saudáveis:

  docker compose -f docker-compose.production.yml ps
  

Saída esperada:

  NAME                    IMAGE                                   STATUS
rtcloud-app             rtawebteam/rta-smartsurvey:...          Up (healthy)
rtcloud-mysql           mysql:8.0                               Up (healthy)
  

Se um contêiner mostrar Up (starting) ou Up (unhealthy), aguarde mais 30 a 60 segundos e verifique novamente. O MySQL pode levar até um minuto para inicializar completamente na primeira inicialização.

Referência de portas link

O MySQL (porta 3306) e quaisquer serviços opcionais (Keycloak) são somente internos e não são expostos ao host por padrão.

Próximas etapas link

Sua instância do rtCloud está em execução. Considere estas tarefas de acompanhamento:

• Habilitar HTTPS — Aponte um domínio para o seu servidor e configure SSL com Let’s Encrypt. Consulte Implantação em nuvem para configuração automatizada de HTTPS.
• Revisar todas as configurações — Consulte a Referência de configuração para ajustar sua implantação para produção.
• Configurar SSO — Conecte um provedor de identidade para autenticação centralizada de usuários. Consulte Autenticação SSO.
• Planejar seus backups — Revise a página de Manutenção para procedimentos de backup e atualização.