Cómo instalar Magento con Apache y Let’s Encrypt SSL en Ubuntu 22.04
Magento es una plataforma de comercio electrónico de código abierto y una de las más populares que ayuda a los programadores a crear sitios web de comercio electrónico. Está escrito en PHP, lo que te permite crear un sistema de carrito de la compra flexible. Es totalmente personalizable y te permitirá desarrollar y lanzar una tienda online totalmente funcional en cuestión de minutos. Magento ofrece una versión comunitaria gratuita y una versión comercial, la versión comunitaria es gratuita y está diseñada para pequeñas empresas, mientras que la versión comercial está diseñada para medianas y grandes empresas.
Este tutorial te mostrará cómo instalar Magento en Ubuntu 22.04.
Requisitos previos
- Un servidor con Ubuntu 22.04.
- Un nombre de dominio válido apuntado con la IP de tu servidor.
- Una contraseña de root configurada en el servidor.
Instalar Apache, MySQL y PHP
En primer lugar, instala el servidor web Apache y el servidor de bases de datos MySQL utilizando el siguiente comando:
apt install apache2 mysql-server -y
Magento sólo admite las versiones 7.3 a 7.4 de PHP. Pero, la versión 7.4 de PHP no está incluida en el repositorio por defecto de Ubuntu 22.04, ya que proporciona PHP 8.1 como versión por defecto. Así que tendrás que instalar PHP 7.4 desde el repositorio PHP Ondrej.
Primero, instala las dependencias necesarias utilizando el siguiente comando:
apt install software-properties-common -y
A continuación, añade el repositorio PHP Ondrej utilizando el siguiente comando:
add-apt-repository ppa:ondrej/php
Una vez añadido el repositorio, actualiza el repositorio e instala PHP con otras dependencias necesarias utilizando el siguiente comando:
apt update -y apt install php7.4 libapache2-mod-php7.4 php7.4-common php7.4-gmp php7.4-curl php7.4-soap php7.4-bcmath php7.4-intl php7.4-mbstring php7.4-xmlrpc php7.4-mysql php7.4-gd php7.4-xml php7.4-cli php7.4-zip -y
A continuación, edita el archivo de configuración de PHP y cambia la configuración por defecto:
nano /etc/php/7.4/apache2/php.ini
Cambia los siguientes valores:
file_uploads = On allow_url_fopen = On short_open_tag = On memory_limit = 512M upload_max_filesize = 128M max_execution_time = 3600
Guarda y cierra el archivo y reinicia el servicio Apache para aplicar los cambios de configuración:
systemctl restart apache2
Una vez que hayas terminado, puedes pasar al siguiente paso.
Crear una base de datos para Magento
Magento utiliza MySQL como base de datos, por lo que tendrás que crear una base de datos y un usuario para Magento.
Primero, conéctate al shell de MySQL con el siguiente comando:
mysql
Una vez conectado a MySQL, crea un usuario y una base de datos para Magento con el siguiente comando:
mysql> CREATE DATABASE magento2; mysql> CREATE USER 'magento2'@'localhost' IDENTIFIED BY 'password';
A continuación, concede todos los privilegios a la base de datos Magento2:
mysql> GRANT ALL PRIVILEGES ON magento2.* TO 'magento2'@'localhost';
A continuación, vacía los privilegios y sal de MySQL con el siguiente comando:
mysql> FLUSH PRIVILEGES; mysql> EXIT;
Instalar Composer
Composer es un gestor de dependencias para PHP que se utiliza para instalar las dependencias PHP necesarias para tu proyecto PHP.
Primero, instala la herramienta de línea de comandos Curl utilizando el siguiente comando:
apt-get install curl -y
A continuación, instala Composer utilizando el siguiente comando:
curl -sS https://getcomposer.org/installer -o composer-setup.php php composer-setup.php --install-dir=/usr/local/bin --filename=composer
Una vez instalado Composer, obtendrás la siguiente salida:
All settings correct for using Composer Downloading... Composer (version 2.3.5) successfully installed to: /usr/local/bin/composer Use it: php /usr/local/bin/composer
Puedes comprobar la versión de Composer utilizando el siguiente comando:
composer --version
Obtendrás el siguiente resultado:
Composer version 2.3.5 2022-04-13 16:43:00
Descargar e instalar Magento en Ubuntu 22.04
En esta sección, descargaremos la versión 2.4.3 de Magento utilizando Composer. Para ello, tendrás que crear una clave de acceso después de iniciar sesión en el sitio web de Magento. https://marketplace.magento.com/customer/accessKeys/. Una vez creada la clave de acceso, ejecuta el siguiente comando para descargar Magento en tu servidor:
cd /var/www/html composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.4.3 magento2
Se te pedirá que proporciones tu clave de acceso como se muestra a continuación para descargar Magento:
Creating a "magento/project-community-edition=2.4.3" project at "./magento2" Warning from repo.magento.com: You haven't provided your Magento authentication keys. For instructions, visit https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html Authentication required (repo.magento.com): Username: a6b333ad41629bac913eaabb9b8e053c Password: Do you want to store credentials for repo.magento.com in /root/.config/composer/auth.json ? [Yn] Y Installing magento/project-community-edition (2.4.3) - Downloading magento/project-community-edition (2.4.3) - Installing magento/project-community-edition (2.4.3): Extracting archive Created project in /var/www/html/magento2 Loading composer repositories with package information Info from https://repo.packagist.org: #StandWithUkraine
Una vez descargado Magento, establece la propiedad y el permiso adecuados para el directorio de Magento:
chown -R www-data:www-data /var/www/html/magento2/ cd /var/www/html/magento2 find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} + find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} + chown -R :www-data . chmod u+x bin/magento
A continuación, ejecuta el siguiente comando para instalar Magento en tu servidor:
bin/magento setup:install --base-url=http://magento.example.com --db-host=localhost --db-name=magento2 --db-user=magento2 --db-password=password --admin-firstname=Hitesh --admin-lastname=Jethva [email protected] --admin-user=admin --admin-password=Magento@Secure1Password --language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1
Obtendrás el siguiente error:
Could not validate a connection to Elasticsearch. No alive nodes found in your cluster
Puedes resolver este error utilizando el siguiente comando:
php bin/magento module:disable {Magento_Elasticsearch,Magento_InventoryElasticsearch,Magento_Elasticsearch6,Magento_Elasticsearch7}
Deberías ver la siguiente salida:
The following modules have been disabled: - Magento_Elasticsearch - Magento_Elasticsearch6 - Magento_InventoryElasticsearch - Magento_Elasticsearch7 Cache cleared successfully. Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes. Info: Some modules might require static view files to be cleared. To do this, run 'module:disable' with the --clear-static-content option to clear them.
También tendrás que ejecutar el siguiente comando para desactivar la autenticación de dos factores:
sudo -u www-data bin/magento module:disable Magento_TwoFactorAuth
Obtendrás el siguiente resultado:
The following modules have been disabled: - Magento_TwoFactorAuth Cache cleared successfully. Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes. Info: Some modules might require static view files to be cleared. To do this, run 'module:disable' with the --clear-static-content option to clear them.
Ahora, ejecuta de nuevo el comando de instalación de Magento para iniciar la instalación:
bin/magento setup:install --base-url=http://magento.example.com --db-host=localhost --db-name=magento2 --db-user=magento2 --db-password=password --admin-firstname=Hitesh --admin-lastname=Jethva [email protected] --admin-user=admin --admin-password=Magento@Secure1Password --language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1
Una vez completada la instalación, obtendrás el siguiente resultado:
[Progress: 1359 / 1366] Module 'Yotpo_Yotpo': [Progress: 1360 / 1366] Enabling caches: Current status: layout: 1 block_html: 1 full_page: 1 [Progress: 1361 / 1366] Installing admin user... [Progress: 1362 / 1366] Caches clearing: Cache cleared successfully [Progress: 1363 / 1366] Disabling Maintenance Mode: [Progress: 1364 / 1366] Post installation file permissions check... For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc' [Progress: 1365 / 1366] Write installation date... [Progress: 1366 / 1366] [SUCCESS]: Magento installation complete. [SUCCESS]: Magento Admin URI: /admin_1u9o0y Nothing to import.
Ahora, borra toda la caché y crea una tarea cron de Magento utilizando los siguientes comandos:
sudo -u www-data bin/magento cache:flush sudo -u www-data bin/magento cron:install
Cuando hayas terminado, puedes pasar al siguiente paso.
Configurar Apache para Magento
A continuación, tendrás que crear un archivo de configuración de host virtual Apache para servir Magento a través de la web.
nano /etc/apache2/sites-available/magento2.conf
Añade las siguientes líneas:
<VirtualHost *:80> ServerAdmin [email protected] DocumentRoot /var/www/html/magento2/ ServerName magento.example.com <Directory /var/www/html/magento2/> Options FollowSymlinks AllowOverride All Require all granted </Directory> ErrorLog ${APACHE_LOG_DIR}/magento2_error.log CustomLog ${APACHE_LOG_DIR}/magento2_access.log combined </VirtualHost>
Guarda y cierra el archivo y, a continuación, activa el host virtual de Magento y el módulo de reescritura de Apache mediante el siguiente comando:
a2ensite magento2.conf a2enmod rewrite
A continuación, reinicia el servicio Apache para aplicar los cambios:
systemctl restart apache2
También puedes comprobar el estado de Apache con el siguiente comando:
systemctl status apache2
Deberías ver la siguiente salida:
? apache2.service - The Apache HTTP Server Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled) Active: active (running) since Fri 2022-04-29 09:03:19 UTC; 2s ago Docs: https://httpd.apache.org/docs/2.4/ Process: 39790 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS) Main PID: 39794 (apache2) Tasks: 6 (limit: 4630) Memory: 14.1M CPU: 132ms CGroup: /system.slice/apache2.service ??39794 /usr/sbin/apache2 -k start ??39795 /usr/sbin/apache2 -k start ??39796 /usr/sbin/apache2 -k start ??39797 /usr/sbin/apache2 -k start ??39798 /usr/sbin/apache2 -k start ??39799 /usr/sbin/apache2 -k start Apr 29 09:03:19 ubuntu systemd[1]: Starting The Apache HTTP Server...
Accede a la interfaz web de Magento
Ahora, abre tu navegador web y accede al panel de control de Magento utilizando la URL http://magento.example.com/admin_1u9o0y. Se te redirigirá a la página de inicio de sesión de Magento:
Proporciona tu nombre de usuario y contraseña de administrador, y haz clic en el botón Iniciar sesión. Deberías ver el salpicadero de Magento en la siguiente pantalla:
Asegura Magento con Let’s Encrypt SSL
Siempre es una buena idea asegurar tu sitio web con Let’s Encrypt SSL. Necesitarás instalar el cliente Certbot para instalar y gestionar el SSL. Puedes instalarlo con el siguiente comando:
apt-get install python3-certbot-apache -y
Una vez instalado Certbot, ejecuta el siguiente comando para proteger tu sitio web con Let’s Encrypt SSL:
certbot --apache -d magento.example.com
Se te pedirá que proporciones tu correo electrónico y aceptes las condiciones del servicio, como se muestra a continuación:
Saving debug log to /var/log/letsencrypt/letsencrypt.log Plugins selected: Authenticator standalone, Installer None Enter email address (used for urgent renewal and security notices) (Enter 'c' to cancel): [email protected] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Please read the Terms of Service at https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must agree in order to register with the ACME server at https://acme-v02.api.letsencrypt.org/directory - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - (A)gree/(C)ancel: A - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Would you be willing to share your email address with the Electronic Frontier Foundation, a founding partner of the Let's Encrypt project and the non-profit organization that develops Certbot? We'd like to send you email about our work encrypting the web, EFF news, campaigns, and ways to support digital freedom. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - (Y)es/(N)o: Y Plugins selected: Authenticator apache, Installer apache Obtaining a new certificate Performing the following challenges: http-01 challenge for magento.example.com Enabled Apache rewrite module Waiting for verification... Cleaning up challenges Created an SSL vhost at /etc/apache2/sites-available/magento-le-ssl.conf Enabled Apache socache_shmcb module Enabled Apache ssl module Deploying Certificate to VirtualHost /etc/apache2/sites-available/magento-le-ssl.conf Enabling available site: /etc/apache2/sites-available/magento-le-ssl.conf
A continuación, selecciona si deseas o no redirigir el tráfico HTTP a HTTPS como se muestra a continuación:
Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1: No redirect - Make no further changes to the webserver configuration. 2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for new sites, or if you're confident your site works on HTTPS. You can undo this change by editing your web server's configuration. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2
Escribe 2 y pulsa Intro para instalar el SSL de Let’s Encrypt para tu sitio web:
Enabled Apache rewrite module Redirecting vhost in /etc/apache2/sites-enabled/magento.conf to ssl vhost in /etc/apache2/sites-available/magento-le-ssl.conf - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Congratulations! You have successfully enabled https://magento.example.com You should test your configuration at: https://www.ssllabs.com/ssltest/analyze.html?d=magento.example.com - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - IMPORTANT NOTES: - Congratulations! Your certificate and chain have been saved at: /etc/letsencrypt/live/magento.example.com/fullchain.pem Your key file has been saved at: /etc/letsencrypt/live/magento.example.com/privkey.pem Your cert will expire on 2023-01-23. To obtain a new or tweaked version of this certificate in the future, simply run certbot again with the "certonly" option. To non-interactively renew *all* of your certificates, run "certbot renew" - If you like Certbot, please consider supporting our work by: Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate Donating to EFF: https://eff.org/donate-le
Ahora, puedes acceder a tu sitio web de forma segura utilizando la URL https://magento.example.com.
Conclusión
Enhorabuena! has instalado con éxito Magento con Apache en Ubuntu 22.04. Espero que este post te ayude a poner en marcha tu propio sistema de carrito de la compra online. No dudes en preguntarme si tienes alguna duda.