Skip to main content

Implantando em uma VM Linux

Este guia o ajudará a instalar o AirysChat no Ubuntu 24.04 LTS. Preparamos um script de implantação para você executar. Consulte o script e sinta-se à vontade para fazer alterações de acordo com o sistema operacional, se você estiver em um sistema que não seja Ubuntu.

Passos para instalar

Se você planeja usar um domínio com o airyschat, adicione um registro A antes de prosseguir. Consulte a seção Configurando o domínio de instalação abaixo.

1. Crie um arquivo install.sh

2. Execute o script

O script cuidará da configuração inicial do AirysChat.

3. Acesse sua instalação

A Instalação do AirysChat agora estará acessível em http://{your_ip_address}:3000 ou se você optou pela configuração de domínio, estará em https://airyschat.mydomain.com.
Isso também instalará o CLI do AirysChat (cwctl) a partir do AirysChat v2.7.0. Use cwctl --help para saber mais.

Configurando O Domínio de instalação

  1. Crie um registro A para airyschat.mydomain.com no seu sistema de gerenciamento de domínio e aponte para o endereço IP da instalação.
  2. Continue com o script de instalação digitando yes quando solicitado sobre a configuração do domínio.
  3. Digite o seu domínio. O script se encarregará de configurar o Nginx e o SSL via LetsEncrypt.
  4. Sua instalação do AirysChat deve estar acessível de https://airyschat.mydomain.com agora.

Configure as variáveis de ambiente necessárias

Para que sua instalação do AirysChat funcione corretamente, você precisaria configurar as variáveis de ambiente essenciais, como FRONTEND_URL, Mailer e uma configuração de armazenamento em nuvem. Consulte Variáveis de ambiente para obter a lista completa.

1. Faça login como usuário airyschat e edite o arquivo .env

2. Atualize as variáveis de ambiente

Consulte Variáveis de ambiente e atualize as variáveis necessárias. Salve o arquivo .env.

3. Reinicie o servidor AirysChat

Se você tem o CLI do AirysChat (cwctl) instalado, use cwctl -r.

Atualizando para uma versão mais recente do AirysChat

Sempre que uma nova versão do AirysChat for lançada, use as etapas a seguir para atualizar sua instância.
Se você tem o CLI do AirysChat (cwctl) instalado, use cwctl --upgrade para atualizar sua instalação do AirysChat.
Para instalar o cwctl, consulte esta seção abaixo.
Se você estiver em uma versão mais antiga do AirysChat (< 2.7), siga as etapas de atualização manual abaixo se enfrentar erros com o cwctl.
Execute as seguintes etapas em sua VM. Faça alterações com base no seu sistema operacional se você estiver em um sistema que não seja Ubuntu.

Executando o Rails Console

Se você tem o CLI do AirysChat (cwctl) instalado, use cwctl -c.

Visualizando Logs

Se você tem o CLI do AirysChat (cwctl) instalado, use cwctl -l web ou cwctl -l worker.
Execute os seguintes comandos no seu shell ubuntu

Instalar ou Atualizar o CLI do AirysChat

Se você usou uma versão mais antiga do script de instalação (< 2.0), você não terá o cwctl no seu PATH. Para instalar/atualizar o CLI do AirysChat,
O comando acima requer acesso root para instalar o cwctl em /usr/local/bin.

Solução de problemas

Se a pré-compilação falhar

Se a etapa de pré-compilação de assets falhar com ActionView::Template::Error (Webpacker can't find application.css in /home/airyschat/airyschat/public/packs/manifest.json) ou se você enfrentar problemas ao reiniciar o servidor, tente o seguinte comando e reinicie o servidor.
Este comando limparia os assets compilados existentes e recompilaria todos os assets. Leia mais sobre isso aqui