Configuração de Desenvolvimento no Ubuntu

Este guia ajudará você a configurar seu ambiente de desenvolvimento no Ubuntu para contribuir com o AirysChat. Estas instruções funcionam para o Ubuntu 20.04, 22.04 e versões mais recentes.

Atualizar Pacotes do Sistema

Abra um terminal e execute os seguintes comandos para atualizar os pacotes do seu sistema:

sudo apt-get update

Instalar o Git

Instale o Git para controle de versão:

sudo apt-get install git

Configure o Git com suas informações:

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

Verifique a instalação do Git:

git --version

Instalar o RVM

Você precisa do software-properties-common instalado para adicionar repositórios PPA:

sudo apt-get install software-properties-common

Instale o RVM (Ruby Version Manager):

sudo apt-add-repository -y ppa:rael-gc/rvm
sudo apt-get update
sudo apt-get install rvm
sudo usermod -a -G rvm $USER

Importante: Habilite Run command as a login shell em Preferences no terminal. Reinicie o computador após a instalação.

Instalar o Ruby

As APIs do AirysChat são construídas em Ruby on Rails. Você precisa instalar o Ruby 3.3.3:

rvm install ruby-3.3.3

Use o Ruby 3.3.3 como padrão:

rvm use 3.3.3 --default

Verifique a instalação do Ruby:

ruby --version
# Should output: ruby 3.3.3

Instalar o Node.js

O AirysChat requer a versão 20 do Node.js. Instale o Node.js do NodeSource usando os seguintes comandos:

curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Verifique a instalação do Node.js:

node --version
# Should output: v20.x.x

npm --version

Instalar o pnpm

Usamos o pnpm como gerenciador de pacotes:

curl -fsSL https://get.pnpm.io/install.sh | sh -

Verifique a instalação do pnpm:

pnpm --version

Instalar o PostgreSQL

O banco de dados usado no AirysChat é o PostgreSQL. Use os seguintes comandos para instalar o PostgreSQL:

sudo apt install postgresql postgresql-contrib

O procedimento de instalação cria uma conta de usuário chamada postgres, associada à função padrão do Postgres. Para usar o Postgres, você pode fazer login nessa conta:

sudo -u postgres psql

Instale as dependências do libpq-dev para o Ubuntu:

sudo apt-get install libpq-dev

Verifique a instalação do PostgreSQL:

psql --version

Instalar o Servidor Redis

O AirysChat usa o servidor Redis nas atribuições de agentes e relatórios. Você precisa instalar o redis-server:

sudo apt-get install redis-server

Em seguida, habilite o Redis para iniciar na inicialização do sistema:

sudo systemctl enable redis-server.service

Verifique a instalação do Redis:

redis-cli ping
# Should output: PONG

Instalar o ImageMagick

Instale o ImageMagick para processamento de imagens:

sudo apt-get install imagemagick

Verifique a instalação do ImageMagick:

convert --version

Solução de Problemas Comuns

A instalação do RVM falha

Solução: Certifique-se de ter reiniciado o computador e ativado “Run command as a login shell”:

# Check if RVM is loaded
rvm --version

# If not found, try loading manually
source ~/.rvm/scripts/rvm

A instalação do Ruby falha

Solução: Instale as dependências ausentes:

sudo apt-get install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev
rvm reinstall ruby-3.3.3

Problemas de conexão com o PostgreSQL

Solução: Configure o usuário e o banco de dados PostgreSQL:

# Switch to postgres user and create a superuser
sudo -u postgres createuser --superuser $USER

# Set password for your user
sudo -u postgres psql -c "ALTER USER $USER PASSWORD 'password';"

# Create a database for your user
sudo -u postgres createdb $USER

Problemas na instalação do Node.js

Solução: Limpe o cache e reinstale:

sudo apt-get remove nodejs npm
sudo apt-get autoremove
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Erros de permissão negada

Solução: Corrija a propriedade de diretórios comuns:

sudo chown -R $USER:$USER ~/.npm
sudo chown -R $USER:$USER ~/.pnpm-store

Obtendo Ajuda

Se você encontrar problemas:

Erros Comuns: Verifique Erros Comuns
Comunidade no Discord: Junte-se ao nosso Discord
Issues do GitHub: Crie uma issue
Comunidade do Ubuntu: Fóruns do Ubuntu

Seu ambiente de desenvolvimento no Ubuntu agora está pronto para o desenvolvimento do AirysChat! 🐧

Getting Started

Environment Setup

Project Setup

Testing

Others

Configuração de Desenvolvimento no Ubuntu

Configuração de Desenvolvimento no Ubuntu

Atualizar Pacotes do Sistema

Instalar o Git

Instalar o RVM

Instalar o Ruby

Instalar o Node.js

Instalar o pnpm

Instalar o PostgreSQL

Instalar o Servidor Redis

Instalar o ImageMagick

Solução de Problemas Comuns

Obtendo Ajuda

​Configuração de Desenvolvimento no Ubuntu

​Atualizar Pacotes do Sistema

​Instalar o Git

​Instalar o RVM

​Instalar o Ruby

​Instalar o Node.js

​Instalar o pnpm

​Instalar o PostgreSQL

​Instalar o Servidor Redis

​Instalar o ImageMagick

​Solução de Problemas Comuns

​Obtendo Ajuda

Configuração de Desenvolvimento no Ubuntu

Atualizar Pacotes do Sistema

Instalar o Git

Instalar o RVM

Instalar o Ruby

Instalar o Node.js

Instalar o pnpm

Instalar o PostgreSQL

Instalar o Servidor Redis

Instalar o ImageMagick

Solução de Problemas Comuns

Obtendo Ajuda