Essa é uma revisão anterior do documento!
Instalação do WSL2 (Windows Subsystem for Linux 2)
Adapte as etapas abaixo ao seu ambiente de desenvolvimento e às suas preferências. Caso não use o WSL, ou queira pular direto para a instalação do SUAP em si veja o item Instalação do SUAP no Linux (ambiente de desenvolvimento).
Opção 1:
1. No menu iniciar localizar a opção “Ativar ou desativar recursos do Windows”
2. Marcar a opção Subsistema do Windows para Linux
Opção 2:
1. Abrir o Powershell como Administrador e executar o comando abaixo:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
- Abrir a Microsoft Store e Instalar o Ubuntu 18.04 LTS
Após a instalação do Ubuntu via WSL executar todos os comandos abrindo o terminal do Ubuntu localizando-o no menu iniciar ou digitando ubuntu1804 no prompt de comando (cmd).
Sugestão: utilizar o Windows Terminal disponível na Microsoft Store Sugestão: no VS Code para abrir um projeto de dentro do WSL instalar a extensão Remote - WSL (será sugerida a instalação automaticamente após a instalação do WSL) e abrir o ambiente remoto na seção correspondente do VS Code.
Instalação do SUAP no Linux (ambiente de desenvolvimento)
1) Instalar o GIT
sudo apt install git
Configuração para evitar erro “fatal: unable to connect to github.com” ao tentar instalar os requirements.
git config --global url."https://".insteadOf git://
2) Instalar alguns pacotes necessários para a aplicação SUAP
sudo apt install build-essential python3-dev python3-setuptools libldap2-dev libsasl2-dev libpq-dev libjpeg-dev libfreetype6-dev zlib1g-dev freetds-dev libxmlsec1-dev libblas-dev liblapack-dev libatlas-base-dev gfortran redis-server libssl-dev libffi-dev wkhtmltopdf poppler-utils
2.1) Instalar o Postgres
Instalar
sudo apt install postgresql-13
Alterar permissões de acesso
sudo nano /etc/postgresql/10/main/pg_hba.conf # modificar a linha host all all 127.0.0.1/32 md5 # para host all all 127.0.0.1/32 trust
Iniciar
sudo service postgresql start
3) Instalar o pip.
sudo apt install python-pip
Se houver problemas ao instalar o pip, coloque o DNS do Google:
sudo nano /etc/resolvconf/resolv.conf.d/head
Inserir o conteúdo:
nameserver 8.8.8.8
Salvar e, no terminal:
sudo resolvconf -u
4) Criar a pasta /opt/suap
sudo mkdir /opt/suap20 sudo chown -R seu_usuario:seu_usuario /opt
5) Fazer o clone do SUAP
Via HTTPS
# no diretório /opt git clone https://gitlab.ifce.edu.br/SUAP/suap.git suap20
Via SSH
# no diretório /opt git clone git@gitlab.ifce.edu.br:SUAP/suap.git suap20
6) Mudar o dono da pasta
sudo chown -R seu_usuario:seu_usuario /opt/suap20
7) criar a pasta suap20/upload e dar um chmod a+w nesta pasta.
# sudo mkdir /opt/suap20/upload # sudo chmod o+rw /opt/suap20/upload # sudo chmod g+rw /opt/suap20/upload sudo chmod go+rw /opt/suap20/deploy/sessions
8) Crie o arquivo settings.py
sudo cp /opt/suap/suap/settings_sample.py /opt/suap/suap/settings.py
9) Instalar e ativar o virtualenv
É importante que a versão do Python utilizada seja a partir da 3.5 (atualização testada na versão 3.8).
# Verificar a versão do Python 3 instalada na máquina (Ubuntu 18.04 em diante já tem o Python 3) python3 --version # Obter o caminho da instalação do Python 3 which python3 # ex.: /usr/bin/python3
sudo apt install virtualenv cd ~ # criar o ambiente virtual usando o executável do Python 3 identificado no comando which python3 virtualenv -p /usr/bin/python3 suap20 source ~/suap20/bin/activate # para desativar o virtualenv: deactivate
10) Instalar as bibliotecas do Python/Django com sudo pip install
# source ~/suap20/bin/activate - caso o virtualenv não esteja ativo pip install -U -r /opt/suap20/requirements/development.txt
11) Dar um chmod em /opt/suap/deploy/logs/audit.log
sudo touch /opt/suap/deploy/logs/audit.log sudo chmod 777 /opt/suap/deploy/logs/audit.log
13) Após restaurar a base de dados, usar o comando sync
# /opt/suap20 python manage.py sync