Implantar no Ubuntu
A stack do OpenReplay pode ser instalada em uma única máquina com Ubuntu. Veja como fazer isso.
Pré-requisitos
Section titled Pré-requisitos- O sistema operacional deve ser o Ubuntu Server 24.04 LTS.
- As especificações mínimas da máquina que executa o OpenReplay são
2 vCPUs, 8 GB of RAM, 50 GB of storage, em uma arquitetura x86; caso contrário, os serviços de backend do OpenReplay simplesmente não iniciarão. Isso deve ser suficiente para um volume baixo/moderado. Se você espera um tráfego alto, deve escalar a partir daqui. - Um endereço IP público apontando para a sua máquina.
Implantar o OpenReplay
Section titled Implantar o OpenReplay-
Verifique se a sua máquina está iniciada e, em seguida, conecte-se a ela por SSH como root
-
Instale o OpenReplay informando o domínio no qual ele será executado (por exemplo, DOMAIN_NAME=openreplay.mycompany.com):
sudo wget https://raw.githubusercontent.com/openreplay/openreplay/main/scripts/helmcharts/openreplay-cli -O /bin/openreplay
sudo chmod +x /bin/openreplay
openreplay -i DOMAIN_NAME
Configurar TLS/SSL
Section titled Configurar TLS/SSLO OpenReplay lida com dados sensíveis de usuários e, por isso, exige HTTPS para funcionar. Isso é obrigatório; caso contrário, o tracker simplesmente não começará a gravar. O mesmo vale para o dashboard: sem HTTPS, você não conseguirá reproduzir as sessões dos usuários.
Portanto, você precisa fornecer (ou gerar) o seu próprio certificado SSL.
-
Primeiro, acesse o seu provedor de serviço de DNS, edite a sua zona DNS e crie um
A Record. Use o domínio que você informou anteriormente na etapa de instalação e aponte-o para a máquina usando o IP público dela. -
Se você vai usar o seu próprio certificado, crie um secret SSL com o seguinte comando:
kubectl create secret tls openreplay-ssl -n app --key="private_key_file.pem" --cert="certificate.crt".
Nota: Se você não tem um certificado, gere um, com renovação automática, para o seu subdomínio (o informado durante a instalação) usando o Let’s Encrypt. Basta se conectar à máquina do OpenReplay, executar
cd /var/lib/openreplay/openreplay/scripts/helmcharts && bash certmanager.she seguir as etapas.
- Se você quiser habilitar o redirecionamento de http para https (recomendado), descomente o bloco abaixo, na seção
ingress-nginx, em/var/lib/openreplay/vars.yaml:
ingress-nginx: &ingress-nginx
controller:
config:
ssl-redirect: true
force-ssl-redirect: true
Vale mencionar que o nosso ingress-nginx é executado por padrão nas portas 80|443, mas isso pode ser facilmente alterado, se necessário, em vars.yaml:
ingress-nginx: &ingress-nginx
controller:
service:
ports:
http: 80
https: 443
- Por fim, reinstale o NGINX do OpenReplay:
openreplay -R
Pronto, o OpenReplay já deve estar acessível no seu subdomínio. Você pode criar uma conta acessando a página /signup (por exemplo, openreplay.mycompany.com/signup).
Tem dúvidas?
Section titled Tem dúvidas?Se você tiver algum problema, conecte-se à nossa comunidade no Slack e obtenha ajuda dos nossos desenvolvedores.