Como Instalar a Plataforma de eCommerce Magento no Ubuntu 24.04

Magento é uma plataforma de eCommerce de código aberto e bem conhecida, escrita em PHP. Magento é uma solução de eCommerce robusta e poderosa usada por mais de 240.000 comerciantes em todo o mundo. Magento é uma plataforma versátil e escalável para construir uma loja de eCommerce. É adequada para construir lojas online pequenas, médias e grandes. Magento permite que você crie e hospede suas lojas online em seu servidor.

Neste guia, vamos orientá-lo na instalação do Magento eCommerce no servidor Ubuntu 22.04.

Pré-requisitos

Para começar com este guia, certifique-se de ter preparado o seguinte:

• Um Ubuntu 24.04 com pelo menos 4GB de memória.
• Um usuário não-root com privilégios sudo.
• Um nome de domínio apontado para um endereço IP do servidor.

Instalando Dependências

Antes de você pular para a instalação, deve garantir que as dependências do Magento estejam instaladas. Nesta seção, você instalará pacotes de software para o Magento, que incluem OpenSearch, Nginx, servidor MySQL, PHP-FPM, Redis, Composer e Git.

Primeiro, instale os pacotes ‘apt-transport-https‘ e ‘gnupg‘ com o seguinte:

sudo apt install apt-transport-https gnupg -y

Execute o seguinte comando para adicionar a chave GPG do OpenSearch e o repositório para distribuições baseadas em Debian/Ubuntu.

curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | \  
sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/opensearch-keyring

echo "deb [signed-by=/usr/share/keyrings/opensearch-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | \  
sudo tee /etc/apt/sources.list.d/opensearch-2.x.list

Agora atualize o índice de pacotes do Ubuntu e instale as dependências com o seguinte comando apt. Com isso, você instalará os pacotes OpenSearch, Nginx, MySQL, PHP-FPM, Redis, Composer e Git.

sudo apt update && sudo apt install opensearch nginx mysql-server composer git redis-server php-fpm php-bcmath php-common php-mbstring php-xmlrpc php-soap php-gd php-xml php-intl php-mysql php-cli php-redis php-ldap php-zip php-curl php-imagick

Digite Y para confirmar a instalação.

Após a instalação, verifique todos os serviços para garantir que estão em execução.

Verifique o serviço Nginx com o seguinte. Você verá que o serviço Nginx está em execução e habilitado.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Agora verifique o servidor MySQL com o comando abaixo. Você pode ver na saída abaixo que o servidor MySQL está em execução.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Verifique o serviço PHP-FPM usando o seguinte comando. O PHP-FPM deve estar em execução e habilitado automaticamente.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

Verifique o servidor Redis usando o comando abaixo. Você deve ver que o Redis está em execução e habilitado.

sudo systemctl is-enabled redis-server  
sudo systemctl status redis-server

Por fim, verifique a versão do Composer com o seguinte. Você deve ter o Composer v2.7 instalado em seu sistema.

sudo -u www-data composer -v

Configurando OpenSearch

Depois de instalar as dependências, você precisa configurar o OpenSearch. O Magento usou o OpenSearch para pesquisa avançada de produtos e indexação. Nesta seção, você aumentará a memória máxima padrão e desativará o plugin de segurança do OpenSearch (apenas para um ambiente de desenvolvimento).

Abra o arquivo ‘/etc/opensearch/jvm.options‘ usando o seguinte editor nano.

sudo nano /etc/opensearch/jvm.options

Altere a alocação de memória padrão para o OpenSearch conforme necessário. Neste caso, usaremos 2GB para o OpenSearch.

-Xms2g  
-Xmx2g

Salve o arquivo e saia.

Agora abra a configuração padrão do OpenSearch ‘/etc/opensearch/opensearch.yml‘ com o editor nano.

sudo nano /etc/opensearch/opensearch.yml

Adicione a seguinte configuração para desativar o plugin de segurança no OpenSearch. Para demonstração, você pode desativar isso, mas para produção, deve habilitar o plugin de segurança e configurar certificados TLS para sua instalação do OpenSearch.

plugins.security.disabled: true

Quando terminar, salve e saia do arquivo.

Em seguida, execute o comando abaixo para recarregar o gerenciador systemd. Após instalar o OpenSearch, você deve recarregar o gerenciador systemd.

sudo systemctl daemon-reload

Agora inicie, habilite e verifique o serviço Opensearch com o seguinte comando:

sudo systemctl enable --now opensearch  
sudo systemctl status opensearch

Na saída a seguir, você pode ver que o OpenSearch está em execução e habilitado.

Por fim, verifique sua instalação do OpenSearch usando o seguinte comando ‘curl‘. Isso mostrará informações básicas sobre sua instalação do OpenSearch.

curl -X GET http://localhost:9200

Abaixo você pode ver que o OpenSearch 2.14 está em execução no servidor Ubuntu.

Configurando PHP-FPM

Nesta seção, você modificará a configuração padrão do PHP-FPM e habilitará a extensão Opcache através do arquivo ‘php.ini’. Você aumentará o memory_limit padrão e ajustará a opção date.timezone.

Abra a configuração do PHP-FPM ‘/etc/php/8.3/fpm/php.ini‘ com o seguinte editor nano.

sudo nano /etc/php/8.3/fpm/php.ini

Altere a configuração padrão com o seguinte. Além disso, ajuste a date.timezone e memory_limit com seu ambiente de servidor atual.

date.timezone = Europe/Amsterdam

Quando terminar, salve o arquivo e saia.

Agora execute o comando abaixo para reiniciar o serviço PHP-FPM e aplicar suas alterações.

sudo systemctl restart php8.3-fpm

Configurando o servidor MySQL

Agora que você configurou o PHP-FPM, na próxima seção você configurará a instalação do servidor MySQL e criará um novo banco de dados e usuário para o Magento.

Proteja sua instalação do servidor MySQL executando o comando abaixo.

sudo mysql_secure_installation

Abaixo você será questionado sobre as configurações do servidor MySQL:

• Digite y para habilitar o componente VALIDATE PASSWORD.
• Digite 1 para definir o nível de força da senha como MÉDIO.
• Digite y quando solicitado para alterar sua senha de root do MySQL.
• Digite y para remover o usuário anônimo padrão.
• Digite y para desabilitar o login remoto para o usuário root do MySQL.
• Digite y novamente para remover o banco de dados de teste padrão do MySQL.
• Por fim, digite y para recarregar os privilégios das tabelas do MySQL e aplicar as alterações.

Depois de configurar o MySQL, você precisa criar um novo banco de dados e usuário para o Magento.

Faça login no servidor MySQL com o seguinte comando. Digite sua senha de root do MySQL quando solicitado.

sudo mysql -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário para o Magento. Neste exemplo, você criará um novo usuário e banco de dados ‘magento‘ com a senha ‘M4gentoPassw0rd__‘.

Certifique-se de alterar os seguintes detalhes com suas informações. Além disso, a senha do MySQL para o Magento deve ter um caractere especial, número e letra maiúscula.

CREATE DATABASE magento;  
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'M4gentoPassw0rd__';  
GRANT ALL PRIVILEGES ON magento.* to 'magento'@'localhost';  
FLUSH PRIVILEGES;

Em seguida, execute a seguinte consulta para verificar os privilégios do usuário ‘magento‘. Certifique-se de que seu usuário pode acessar o banco de dados ‘magento‘.

SHOW GRANTS FOR magento@localhost;

Por fim, digite quit para sair do servidor MySQL.

Instalando o Magento através da linha de comando

Nesta seção, você fará o download do código-fonte do Magento e instalará as dependências do PHP usando o Composer. Em seguida, você instalará o Magento usando a linha de comando. Por último, você gerará um crontab para o Magento.

Vá para o diretório ‘/var/www‘ e faça o download do código-fonte do Magento usando o seguinte comando wget. Verifique a página do GitHub do Magento e pegue a URL da versão mais recente do Magento.

cd /var/www  
wget https://github.com/magento/magento2/archive/refs/tags/2.4.7.tar.gz

Após o download ser concluído, extraia o código-fonte do Magento e renomeie o diretório extraído para ‘magento2’. Com isso, sua instalação do Magento deve estar localizada em ‘/var/www/magento2’.

tar -xf 2.4.7.tar.gz  
mv magento2-* magento2

Agora execute o comando abaixo para criar diretórios adicionais para o Composer e alterar a propriedade do diretório ‘/var/www‘ para o usuário ‘www-data‘.

sudo mkdir -p /var/www/{.config,.cache}  
sudo chown -R www-data:www-data /var/www

Em seguida, execute o seguinte comando para dar ao usuário ‘www-data‘ permissão para ler, escrever e executar dentro do diretório ‘/var/www/magento2‘.

sudo chmod u+rwx /var/www/magento2

Em seguida, vá para o diretório ‘/var/www/magento2‘ e instale as dependências do PHP para o Magento com o comando Composer abaixo. Isso garantirá que suas dependências para o Magento estejam instaladas.

cd /var/www/magento2  
sudo -u www-data composer install

Após instalar as dependências, execute o comando abaixo para permitir que o usuário ‘www-data‘ tenha permissão de ‘rwx‘ para os diretórios ‘generated‘ e ‘var‘ dentro da raiz da web do Magento.

sudo chown -R www-data:www-data /var/www/magento2/var /var/www/magento2/generated  
sudo chmod u+rwx /var/www/magento2/var /var/www/magento2/generated  
sudo chmod g+rw /var/www/magento2/var /var/www/magento2/generated

Agora execute o seguinte comando para iniciar a instalação do Magento. Certifique-se de alterar os detalhes da URL, banco de dados MySQL, usuário administrador e senha para sua instalação do Magento.

sudo -u www-data bin/magento setup:install \  
--base-url=http://howtoforge.local \  
--db-host=localhost \  
--db-name=magento2 \  
--db-user=magento \  
--db-password=M4gentoPassw0rd__ \  
--admin-firstname=bob \  
--admin-lastname=admin \  
--admin-email=[email protected] \  
--admin-user=bob \  
--admin-password=BobAdm1nP4ssword \  
--currency=USD \  
--timezone=Europe/Amsterdam \  
--use-rewrites=1 \  
--session-save=redis \  
--search-engine=opensearch \  
--opensearch-host=127.0.0.1 \  
--opensearch-port=9200 \  
--opensearch-enable-auth=0 \  
--opensearch-index-prefix=magento22 \  
--opensearch-timeout=30

Abaixo você pode ver o início da instalação do Magento:

Uma vez concluído, você verá a saída ‘Instalação do Magento concluída.’ e o caminho da URL do admin para sua instalação do Magento. Certifique-se de salvar a URL gerada para a página de administração do Magento.

Para finalizar a instalação do Magento, execute o seguinte comando para gerar crontab para o Magento e executar a indexação para o Magento.

sudo -u www-data bin/magento cron:install  
sudo -u www-data bin/magento cron:run --group index

Você pode verificar a lista de crontab para o usuário ‘www-data’ com o seguinte:

crontab -u www-data -l

Você pode ver abaixo que o crontab para o Magento foi gerado.

Por fim, execute o comando abaixo para limpar o cache da sua instalação do Magento. Com isso, você completou a instalação do Magento, agora você precisa configurar o servidor web Nginx.

sudo -u www-data bin/magento cache:clean

Configurando o bloco de servidor Nginx

Neste ponto, sua instalação do Magento está concluída, agora você criará um novo servidor Nginx para executar sua instalação do Magento. Certifique-se de que você tenha um nome de domínio apontado para o endereço IP do seu servidor.

Crie uma nova configuração de bloco de servidor Nginx ‘/etc/nginx/sites-available/magento.conf‘ com o editor nano.

sudo nano /etc/nginx/sites-available/magento.conf

Insira a seguinte configuração e certifique-se de alterar a opção server_name com seu nome de domínio do Magento.

upstream fastcgi_backend {  
 server unix:/run/php/php8.3-fpm.sock;  
}  
  
server {  
 listen 80;  
 listen [::]:80;  
 server_name howtoforge.local;  
 set $MAGE_ROOT /var/www/magento2/;  
 include /var/www/magento2/nginx.conf.sample;  
 client_max_body_size 2M;  
  
 access_log /var/log/nginx/magento.access;  
 error_log /var/log/nginx/magento.error;  
}

Quando terminar, salve e saia do arquivo.

Agora execute o comando abaixo para ativar o bloco de servidor ‘magento.conf‘ e verificar sua sintaxe do Nginx. Certifique-se de obter a saída ‘a sintaxe está ok - o teste é bem-sucedido‘.

sudo ln -s /etc/nginx/sites-available/magento.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Por fim, reinicie o serviço Nginx com o seguinte para aplicar sua nova configuração de bloco de servidor. Após a execução do comando, sua instalação do Magento estará disponível.

sudo systemctl restart nginx

Protegendo o Magento com HTTPS

Se você estiver executando o Magento em um domínio público, deve protegê-lo com HTTPS. Nesta seção, você protegerá sua instalação do Magento com HTTPS através do Certbot e Letsencrypt.

Instale o Certbot e o plugin Certbot Nginx usando o seguinte comando. Digite Y para confirmar a instalação.

sudo apt install certbot python3-certbot-nginx

Após a instalação ser concluída, execute o comando abaixo para gerar certificados SSL/TLS do Letsencrypt. Certifique-se de alterar o endereço de e-mail e o nome de domínio abaixo com suas informações.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Sua instalação do Magento deve ser automaticamente protegida com HTTPS quando o processo for concluído. Seus certificados SSL/TLS estão no diretório ‘/etc/letsencrypt/live/domain.com‘.

Acessando o Magento

Abra seu navegador e visite seu nome de domínio do Magento, como https://howtoforge.local. Se sua instalação for bem-sucedida, você verá a página de índice padrão do Magento como a seguinte.

Agora, visite a URL de administração do Magento, que é https://howtoforge.local/admin_ze87mmj. Veja o processo de instalação.

Digite seu usuário e senha de administrador para o Magento e pressione Login.

Se for bem-sucedido, você deve obter o painel de administração do Magento como o seguinte:

Conclusão

Parabéns! Você completou a instalação do Magento eCommerce no servidor Ubuntu 24.04. Você instalou o Magento com a pilha LEMP (Linux, Nginx, MySQL e PHP-FPM), OpenSearch e Redis. Você também protegeu o Magento com HTTPS através do Certbot e Letsencrypt.