Skip to main content

Pré-requisitos

Antes de prosseguir, certifique-se de ter a versão mais recente do docker e do docker-compose instalada. A partir de agora [no momento em que este documento foi escrito], recomendamos uma versão igual ou superior à seguinte.
O nome do contêiner usa traços em vez de sublinhados por padrão com as novas versões do docker/compose. Se você estiver usando uma versão mais antiga do docker/compose, substitua - por _. Além disso, use docker-compose em vez de docker compose.

Passos para implantar o AirysChat usando docker-compose

1. Instale o Docker em sua VM

2. Baixe os arquivos necessários

3. Configurar variáveis de ambiente

Ajuste o .env e o docker-compose.yaml de acordo com suas preferências. Consulte as variáveis de ambiente disponíveis. Você também pode remover os serviços dependentes como Postgres, Redis etc., em favor de serviços gerenciados configurados via variáveis de ambiente.

4. Preparar o banco de dados

5. Iniciar os serviços

6. Acesse sua instalação

Sua instalação do AirysChat está concluída. Observe que os contêineres não estão expostos à internet e eles se vinculam apenas ao host local. Configure algo como Nginx ou qualquer outro servidor proxy para fazer o proxy das solicitações para o contêiner. Se você quiser verificar se a instalação está funcionando, tente curl -I localhost:3000/api para ver se ele retorna 200. Além disso, você pode descartar temporariamente o 127.0.0.1:3000:3000 para o rails por 3000:3000 no arquivo compose para acessar sua instância em http://<your-external-ip>:3000. É recomendável reverter essa alteração e usar o Nginx ou algum servidor proxy na frente.

Etapas Adicionais

  1. Tenha um servidor web Nginx atuando como um proxy reverso para a instalação do AirysChat. Para que você possa acessar o AirysChat a partir de https://chat.yourdomain.com
  2. Execute docker compose run --rm rails bundle exec rails db:airyschat_prepare sempre que você decidir atualizar as imagens do AirysChat para lidar com as migrações.

Configurar o Nginx e Let’s Encrypt

1. Configure o Nginx para servir como um proxy frontend

2. Use a seguinte configuração do Nginx

Use a seguinte configuração do Nginx após substituir yourdomain.com em server_name.

3. Verificar e recarregar a configuração do Nginx

4. Execute o Let’s Encrypt para configurar o certificado SSL

5. Acesse sua instalação

Sua instalação do AirysChat deve estar acessível em https://yourdomain.com agora.

Passos para construir imagens você mesmo

Nós publicamos nossas imagens base no Docker hub. Você deve ser capaz de construir suas imagens web/worker do AirysChat a partir dessas imagens base.

Web

Worker

Os servidores de aplicativo serão executados disponíveis na porta 3000. Certifique-se de que as imagens se conectem aos mesmos servidores de banco de dados e Redis. Forneça a configuração para esses serviços por meio de variáveis de ambiente.

Configuração inicial do banco de dados

Para configurar o banco de dados pela primeira vez, você deve executar rails db:airyschat_prepare. Você pode obter erros se tentar executar rails db:migrate neste ponto.

Atualizando

Se você não estiver usando a tag latest ou latest-ce, primeiro você precisa alterar a tag desejada em seu arquivo docker-compose. Depois disso você pode baixar a nova imagem e começar a usá-las:
Finalmente você pode precisar atualizar o banco de dados:

Executando o Console do Rails

Imagens docker do AirysChat CE edition

Se você quiser executar a edição AirysChat CE, substitua a tag da imagem do docker pela tag da versão foss equivalente. A tag do docker para a versão atual master seria latest-ce. Tags específicas de versão seguiriam o padrão v*-ce. Por exemplo, a tag da edição ce do docker para o AirysChat v2.3.2 seria v2.3.2-ce.