Como Instalar Magento 2 com Nginx e SSL Let's Encrypt no Ubuntu 20.04 LTS

Magento é um software de e-commerce de código aberto amplamente utilizado e um sistema de gerenciamento de conteúdo para sites de e-commerce baseado no PHP Zend Framework. Ele usa MySQL ou MariaDB como o backend do banco de dados. O desenvolvimento do Magento começou em 2008 pela Varien.

Neste tutorial, mostraremos passo a passo como instalar o Magento 2 na versão mais recente do Ubuntu 20.04. Instalaremos o Magento sob a pilha LEMP, o servidor web Nginx, PHP-FPM 7.3 e o servidor MariaDB.

Requisitos

Para este tutorial, instalaremos o Magento 2 no sistema Ubuntu 20.04 com 2 GB de RAM, 50 GB de espaço livre em disco e 2 CPUs.

O que faremos?

• Instalar o servidor web Nginx
• Instalar e configurar o PHP-FPM 7.3
• Instalar e configurar o servidor MySQL
• Instalar o PHP Composer
• Baixar e instalar o Magento
• Gerar SSL Letsencrypt
• Configurar o Virtualhost Nginx para o Magento
• Pós-instalação do Magento

Passo 1 - Instalar o servidor web Nginx

Primeiro, instalaremos o servidor web Nginx no sistema Ubuntu 20.04.

Instale o Nginx usando o comando apt abaixo.

sudo apt install nginx

Uma vez que toda a instalação esteja completa, inicie o serviço Nginx e adicione-o à inicialização do sistema.

systemctl start nginx  
systemctl enable nginx

Depois disso, verifique o status do serviço Nginx usando o seguinte comando.

systemctl status nginx

O servidor web Nginx está em funcionamento no servidor Ubuntu 20.04.

Em seguida, abriremos as portas HTTP e HTTPS em nosso sistema Ubuntu.

Execute o comando ufw abaixo.

for svc in ssh http https  
do  
ufw allow $svc  
done

Como resultado, os serviços SSH, HTTP e HTTPS foram adicionados à regra do firewall ufw.

Agora execute o comando para habilitar o firewall ufw usando o seguinte comando.

ufw enable

Digite ‘y’ e pressione Enter, e você habilitou o firewall ufw.

Passo 2 - Instalar e configurar o PHP-FPM 7.3

Após instalar o servidor web Nginx, instalaremos o PHP-FPM em nosso servidor Ubuntu 20.04.

Por padrão, o Ubuntu 20.04 vem com a versão mais recente do PHP/PHP-FPM 7.4. Mas por enquanto, o Magento só funciona com PHP/PHP-FPM 7.3. E neste passo, instalaremos o PHP-FPM 7.3 do repositório PPA.

Antes de prosseguir, instale o pacote ‘software-properties-common’ e adicione o repositório PPA para PHP 7.3 usando o seguinte comando.

sudo apt install software-properties-common  
sudo add-apt-repository ppa:ondrej/php

O ‘add-apt-repository’ atualizará automaticamente todos os repositórios no sistema.

Agora instale os pacotes PHP-FPM 7.3 do repositório PPA usando o comando apt abaixo.

sudo apt install php7.3-fpm php7.3-common php7.3-curl php7.3-cli php7.3-mysql php7.3-gd php7.3-xml php7.3-json php7.3-intl php-pear php7.3-dev php7.3-common php7.3-mbstring php7.3-zip php7.3-soap php7.3-bcmath php7.3-opcache -y

E a instalação do PHP-FPM 7.3 foi concluída.

Depois disso, vá para o diretório ‘/etc/php/7.3’ e edite a configuração ‘php.ini’ para o PHP-FPM.

cd /etc/php/7.3/  
vim fpm/php.ini

Descomente e altere a configuração conforme abaixo.

date.timezone = Asia/Singapore  
memory_limit = 1G  
max_execution_time = 1800  
zlib.output_compression = On  
cgi.fix_pathinfo = 0  
  
opcache.enable=1   
opcache.save_comments = 1

Salve e feche.

Em seguida, inicie o serviço PHP-FPM e adicione-o à inicialização do sistema.

systemctl start php7.3-fpm  
systemctl enable php7.3-fpm

O serviço PHP-FPM está em funcionamento, verifique usando o comando abaixo.

ss -xa | grep php  
systemctl status php7.3-fpm

Como resultado, o PHP-FPM está em funcionamento no servidor Ubuntu 20.04, está rodando sob o arquivo sock ‘/run/php/php7.3-fpm.sock’.

Passo 3 - Instalar e configurar o servidor MariaDB

Neste passo, instalaremos o servidor de banco de dados MariaDB, configuraremos a senha padrão do root para o MariaDB e criaremos um novo banco de dados e usuário para o Magento.

Instale os pacotes do servidor MariaDB no Ubuntu 20.04 usando o comando apt abaixo.

sudo apt install mariadb-server

Uma vez que toda a instalação esteja completa, inicie o serviço MariaDB e adicione-o à inicialização do sistema.

systemctl start mariadb  
systemctl enable mariadb

O serviço MariaDB está em funcionamento.

Em seguida, configuraremos a senha do root do MariaDB usando a ferramenta ‘mysql_secure_installation’.

Execute o comando ‘mysql_secure_installation’ abaixo.

mysql_secure_installation

Digite sua senha forte para o usuário root do MariaDB e digite ‘Y’ para todas as configurações.

Set a root password? [Y/n] Y  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y

Como resultado, a senha do root do MariaDB foi configurada.

Em seguida, criaremos um novo banco de dados e usuário para a instalação do Magento.

Faça login no shell do MariaDB/MySQL usando o comando mysql abaixo.

mysql -u root -p

Agora crie um novo banco de dados para nossa instalação do Magento. Crie o banco de dados ‘magentodb’ e o usuário ‘magentouser’ com a senha ‘magentodbpass’.

Execute as consultas MySQL abaixo.

create database magentodb;  
create user magentouser@'localhost' identified by 'magentopassdb';  
grant all privileges on magentodb.* to magentouser@'localhost';  
flush privileges;

Agora digite ‘exit’ para sair do shell MySQL.

Como resultado, o novo banco de dados e usuário para a instalação do Magento foram concluídos.

Passo 4 - Instalar o Composer

Composer é um gerenciador de dependências para PHP. É um gerenciador de pacotes em nível de aplicativo para PHP que permite baixar dependências e bibliotecas PHP adicionais para seu projeto PHP.

Neste passo, instalaremos o PHP Composer do repositório do Ubuntu.

Instale o Composer usando o comando apt abaixo.

sudo apt install composer -y

Uma vez que a instalação esteja completa, verifique a versão do composer abaixo.

composer --version

Abaixo está a resposta que você receberá.

Composer 1.10.1 2020-03-13 20:34:27

Como pode ser visto, o Composer 1.10 foi instalado no servidor Ubuntu 20.04.

Passo 5 - Baixar e instalar o Magento 2

Neste passo, baixaremos e instalaremos o Magento 2 e todos os pacotes PHP necessários usando o Composer.

Primeiro, vá para o diretório ‘/var/www/‘ e baixe o código-fonte do Magento 2.3.5 CE (Edição Comunitária) usando o comando wget conforme abaixo.

cd /var/www/  
wget -q https://github.com/magento/magento2/archive/2.3.5.tar.gz

Uma vez que tudo esteja completo, extraia o código-fonte do Magento e renomeie o diretório extraído para ‘magento2’.

tar -xf 2.3.5.tar.gz  
mv magento2-*/ magento2/

Em seguida, vá para o diretório de instalação do Magento ‘/var/www/magento2’ e instale todas as dependências de pacotes PHP para o Magento usando o comando Composer conforme abaixo.

cd /var/www/magento2/  
composer install

Uma vez que toda a instalação esteja completa, corrija a propriedade do diretório de instalação do Magento 2 para o usuário ‘www-data’.

chown -R www-data:www-data /var/www/magento2

Como resultado, a instalação do Magento 2 e todas as dependências de pacotes foram concluídas.

Passo 6 - Gerar SSL Letsencrypt

Para este tutorial, iremos proteger a instalação do Magento 2 usando o SSL Letsencrypt. E neste passo, geraremos o SSL Letsencrypt usando o comando certbot. Além disso, certifique-se de que seu nome de domínio esteja resolvido para o endereço IP do servidor.

Instale a ferramenta certbot usando o comando apt abaixo.

sudo apt install certbot

Uma vez que a instalação esteja completa, pare o serviço Nginx.

systemctl stop nginx  
certbot certonly --standalone --agree-tos --no-eff-email --email [email protected] -d magento.hakase-labs.io

Uma vez que tudo esteja completo, você receberá seus certificados SSL no diretório ‘/etc/letsencrypt/live/magento.your-domain.com’.

Como resultado, o SSL Letsencrypt para a instalação do Magento 2 foi gerado.

Passo 7 - Configurar o Virtualhost Nginx para o Magento 2

Neste passo, adicionaremos uma nova configuração de virtualhost Nginx para o Magento 2.

Vá para o diretório ‘/etc/nginx/sites-available/‘ e crie uma nova configuração ‘magento’ usando o editor vim.

cd /etc/nginx/sites-available/  
vim magento

Cole a seguinte configuração nele.

upstream fastcgi_backend {  
        server  unix:/run/php/php7.3-fpm.sock;  
}  
  
server {  
    listen 80;  
    listen [::]:80;  
    server_name magento.hakase-labs.io;  
    return 301 https://$server_name$request_uri;  
}  
  
server {  
        listen 443 ssl http2;  
        server_name magento.hakase-labs.io;  
  
        ssl_certificate /etc/letsencrypt/live/magento.hakase-labs.io/fullchain.pem;  
        ssl_certificate_key /etc/letsencrypt/live/magento.hakase-labs.io/privkey.pem;  
  
        set $MAGE_ROOT /var/www/magento2;  
        set $MAGE_MODE developer;  
        include /var/www/magento2/nginx.conf.sample;  
}

Salve e feche.

Em seguida, ative o virtualhost Nginx do Magento e teste a configuração do nginx, e certifique-se de que não haja erro.

ln -s /etc/nginx/sites-available/magento /etc/nginx/sites-enabled/  
ginx -t

Agora reinicie o serviço Nginx usando o seguinte comando.

systemctl restart nginx

Como resultado, a configuração do virtual host Nginx para o Magento 2 foi criada e habilitada.

Passo 8 - Pós-instalação do Magento

Abra seu navegador web e digite o nome de domínio da sua instalação do Magento na barra de endereços.

https://magento.hakase-labs.io/

Agora você será redirecionado para uma conexão segura HTTPS e verá a página de boas-vindas do Magento e os Termos de Serviço.

Clique no botão ‘Concordar e Configurar Magento‘ para continuar.

Na página de ‘Verificação de Prontidão’, certifique-se de que todos os requisitos estejam em verde e clique no botão ‘Próximo‘.

Digite os detalhes do banco de dados MariaDB e do usuário que criamos acima e clique em ‘Próximo‘.

Para a ‘Configuração da Web’, altere todos os protocolos HTTP para HTTPS e certifique-se de alterar o ‘Endereço do Admin do Magento’.

Agora clique em ‘Opções Avançadas’ e marque todas as opções HTTPS, depois desmarque a opção ‘Reescritas do Apache’ e clique no botão ‘Próximo‘ novamente.

Em seguida, na configuração ‘Personalize sua Loja’ do Magento, deixe como padrão e clique no botão ‘Próximo‘.

Agora digite os detalhes do usuário admin, email e senha. Em seguida, clique no botão Próximo.

Clique no botão ‘Instalar Agora’ para instalar sua loja Magento 2.

Agora certifique-se de que toda a instalação não tenha erros.

Uma vez que toda a instalação esteja concluída, você verá a página ‘Sucesso‘ como abaixo.

Clique em ‘Iniciar o Admin do Magento‘ para fazer login no seu Painel de Controle do Admin do Magento.

Agora digite seu usuário e senha do Admin do Magento, em seguida, clique em ‘Entrar’ e você verá o Painel de Controle do Admin do Magento como abaixo.

Para a página de índice padrão do Magento, abra uma nova aba e digite seu nome de domínio na barra de endereços.

Abaixo está a página de índice padrão do Magento.

Como resultado, a instalação do Magento 2 foi concluída.

Em seguida, volte ao shell do seu servidor e configuraremos o Cron do Magento e removeremos a permissão de escrita de alguns diretórios da instalação do Magento.

Para configurar o cron do Magento, execute o comando abaixo.

cd /var/www/magento2  
sudo -u www-data php bin/magento cron:install --force

O cron do Magento será executado sob o usuário ‘www-data’, verifique usando o seguinte comando.

crontab -u www-data -l

Como resultado, o Cron do Magento foi adicionado ao sistema.

Em seguida, precisamos remover a permissão de escrita do diretório ‘/var/www/magento2/app/etc’.

Execute o comando chmod abaixo.

chmod u-w /var/www/magento2/app/etc

E finalmente, a instalação do Magento 2 com o servidor web Nginx, servidor MariaDB, PHP-FPM 7.3 na versão mais recente do Ubuntu 20.04 foi concluída com sucesso.

Referência

• https://devdocs.magento.com/