Esse tutorial tem como proposta fornecer um 'norte' no momento de configurar um servidor dedicado LINUX para uma aplicação Laravel.
Foi utilizado como base o sistema Ubuntu 22.04
Tecnologias utilizadas
- Composer
- NGNIX
- MySql
- Node Js
- PHP 8.3
- Git
- Redis (revisar)
Durante o tutorial você irá se deparar com termos como
projeto
fazendo referencia ao nome do seu projeto, atente-se aos pontos que contem esses nomes genéricos que são utilizados meramente de forma ilustrativa, troque ou faça ajustes sempre que julgar melhor.
Verifica qual é a versão do sistema
lsb_release -a
Atualiza os pacotes:
apt-get update
Instala nova versão dos pacotes
apt-get upgrade
timedatectl set-timezone America/Sao_Paulo
sudo apt install curl
Ativa o firewal e adiciona as portas
ufw allow 3306/tcp
sudo ufw allow 20/tcp
sudo ufw allow 21/tcp
sudo ufw allow 22/tcp
sudo ufw allow 40000:50000/tcp
sudo ufw allow 990/tcp
sudo ufw enable
Instala o MySql Server
apt install mysql-server
libera gravação e acesso de aplicativos acendo o arquivo de configuração em:
nano /etc/mysql/mysql.conf.d/mysqld.cnf
Na linha que esta escrito " bind-address = 127.0.0.1 " mude para " bind-address = 0.0.0.0 ". Salve a modificação e sai do arquivo
Para se criar um usuário que possa acessar de qualquer host e fazer modificações no banco
mysql
CREATE USER 'administrator'@'%' IDENTIFIED BY 'SenhaSecreta';
GRANT ALL PRIVILEGES ON *.* TO 'administrator'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;
exit
Atualiza o serviço do MySql
/etc/init.d/mysql restart
Adiciona o repositorio
add-apt-repository ppa:ondrej/php -y
apt-get update
Instala o PHP e as extensões referente
apt-get install php8.3 php8.3-dev php8.3-fpm php8.3-cli php8.3-xml -y --allow-unauthenticated
apt install php8.3-{bcmath,xml,fpm,mysql,zip,intl,ldap,gd,cli,bz2,curl,mbstring,pgsql,opcache,soap,cgi}
systemctl status php8.3-fpm
nano /etc/php/8.3/fpm/php.ini
mudar os seguintes parâmetros
upload_max_filesize = 256M
post_max_size = 256M
memory_limit = 3072M
max_execution_time = 600
max_input_vars = 3000
max_input_time = 1000
Verifica se tem algum erro no arquivo e reinicia em seguida
php-fpm8.3 -t
service php8.3-fpm restart
Instala composer mais atual
curl -sS https://getcomposer.org/installer -o composer-setup.php
HASH=`curl -sS https://composer.github.io/installer.sig`
echo $HASH
php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
Verifica se foi instalado com sucesso com o comando
composer
Para instalar o Redis local basta ir copiando e colando as seguintes linhas
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
sudo apt-get update
sudo apt-get install redis
Para testar o redis executar o comando
redis-cli ping
O retorno deve ser :
PONG
Instalar extensão do PHP 8.3
sudo apt-get install php8.3-redis
Reinicia o serviço
service php8.3-fpm restart
Adiciona o pacote pacote para usar o Laravel pode se conectar
composer require predis/predis
Abra o .env
nano /var/www/projeto/.env
Altere os seguintes parametros para o seguinte
QUEUE_CONNECTION=redis
CACHE_DRIVER=redis
SESSION_DRIVER=redis
BROADCAST_DRIVER=redis
Caso o servidor seja reiniciado pode ser necessario inicializar novamente o serviço
redis-server --daemonize yes
Instala o git
apt-get install git
(Baseado no link https://www.digitalocean.com/community/tutorials/how-to-set-up-ssh-keys-on-ubuntu-20-04-pt) O primeiro passo é criar uma par de chaves na máquina do cliente
ssh-keygen
Por padrão, as versões mais recentes do ssh-keygen criarão um par de chaves RSA de 3072 bits, que é seguro o suficiente para a maioria dos casos de uso (você pode usar o sinalizador -b 4096
para criar uma chave maior de 4096 bits).
Após digitar o comando, você deve ver o seguinte resultado:
Output
Generating public/private rsa key pair.
Enter file in which to save the key (/your_home/.ssh/id_rsa):
Basta ir apertando enter para para ir pulando as perguntas, por padrão o par de chaves ficarão gravadas no .ssh/
. Depois basta dar o comando cat
no na chave publica, deve ser algo como:
cat .ssh/id_rsa.pub
No github do projeto vá no Settings
do projeto e procure por Deploy Keys
na categoria de Security
, então clique em Add deploy key
. De um nome para a chave e cole ela
Instala o servidor web
apt install nginx
Vá até a pasta onde será adicionado o projeto
cd /var/www/
Baixe o projeto do gitbub
git clone git@github.com:usuario/meu-projeto-laravel.git projeto
cd projeto
Prepa os arquivos da aplicação
cp .env.example .env
composer install
php artisan key:generate
php artisan storage:link
Editar os atributos do .env
APP_NAME=PROJETO
APP_DEBUG=false
APP_ENV=production
APP_URL=https://www.projeto.com.br
DB_HOST=127.0.0.1
DB_READ=127.0.0.1
DB_PORT=3306
DB_DATABASE=db-projeto
DB_USERNAME=administrator
DB_PASSWORD='SenhaSecreta'
Adiciona as portas ao firewall
sudo ufw app list
sudo ufw allow 'Nginx HTTP'
sudo ufw allow 'Nginx HTTPS'
sudo chown -R www-data.www-data /var/www/projeto/storage
sudo chown -R www-data.www-data /var/www/projeto/bootstrap/cache
Caso tenha problemas permissão você pode usar:
chmod -R 777 /var/www/projeto/
nano /etc/nginx/sites-available/projeto
Cole o script:
server {
listen 80;
server_name IP_DO_SERVIDOR DOMINIO_DO_SITE ;
root /var/www/projeto/public;
client_max_body_size 0;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-XSS-Protection "1; mode=block";
add_header X-Content-Type-Options "nosniff";
index index.html index.htm index.php;
charset utf-8;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }
error_page 404 /index.php;
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}
}
Muda o link para o novo script e verifica se tem algum erro
sudo ln -s /etc/nginx/sites-available/projeto /etc/nginx/sites-enabled/
sudo nginx -t
Acessar o arquivo
nano /etc/nginx/nginx.conf
Remova #
para descomentar o comando **server_names_hash_bucket_size 64**;
Caso o novo sub dominio aponte para o mesmo projeto basta ir no arquivo de configuração de dominio
nano /etc/nginx/sites-available/projeto
Adicione o novo sub dominio em na linha server_name
, ficando:
server_name DOMINIO_DO_SITE SUB_DOMINIO_DO_SITE
Caso tenha outro sub dominio para adicionar basta dar um espaço e adicionar
Para finalizar vá no arquivo de host
nano /etc/hosts
Adicione o subdominio: 127.0.0.1 admin.example.local
Reinicie o serviço
sudo systemctl reload nginx
a instalação foi baseado nesse link
Vamos instalar o nodejs utilizando um gerenciador de versão
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
source ~/.bashrc
Para ver as versões disponiveis utilize o comando
nvm list-remote
Para instalar a versão que deseja utilize o comando + versão. Como por exemplo
nvm install v20.12.1
Para diminuir a necessidade de manutenção procure sempre dar preferencia a última versão LTS disponivel
Apesar de não ser obrigatório é sempre recomendado fazer o 'build' do seu front-end, seja utilizando o mix ou o vite. Vá até a pasta da aplicação
cd /var/www/projeto
Instale os pacotes
npm install
'Compila' o código utilizando o vite
npm run build
Caso o projeto venha fazer uso de sub dominios é recomendado não utilizar essa opção pois ao tentar atualizar o certificado do subdominio pode vim apresentar erros
(baseado no link: https://www.linuxtuto.com/how-to-secure-nginx-with-lets-encrypt-on-ubuntu-22-04/)
apt install certbot python3-certbot-nginx
certbot --nginx
systemctl daemon-reload
systemctl reload nginx
service php8.3-fpm restart
nano /etc/crontab
Na ultima linha adicione (deixe tudo alinhado dando os espaços necessarios)
* * * * * root cd /var/www/projeto && php artisan schedule:run >> /dev/null 2>&1
verifica se a cron está funcionando
service cron status
Caso apresente mensagem de erro é preciso ativar
service cron start
Para atualizar o código do projeto vá na pasta do sistema
cd /var/www/projeto
Para atualizar o código
git pull
*Caso o comando git pull não funcione *
git pull --rebase --autostash
Existem diversas formas de atualizar o código do servidor, formas mais manuais como FTP a outras automatizadas utilizandos webhook ou GitHub Actions. A forma informada aqui é uma das mais simples e seguras mas existem melhores opções.
Para ver todos os serviços que estão sendo executados
service --status-all