Documentación Commerce Guía de instalación

Instalación de Adobe Commerce

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Experimentado
Administrador
Desarrollador

Antes de empezar, complete los siguientes pasos:

Compruebe que su sistema cumple los requisitos mencionados en requisitos del sistema.
Complete todas las tareas previas.
Complete los primeros pasos de instalación. Consulte Su ruta de instalación o actualización.
Después de iniciar sesión en el servidor de aplicaciones, cambie al propietario del sistema de archivos.
Revise la introducción a la instalación desde la línea de comandos.

NOTE

Debe instalar la aplicación desde su subdirectorio bin.

Puede ejecutar el instalador varias veces con diferentes opciones para completar tareas de instalación como las siguientes:

Instalar por fases: por ejemplo, después de configurar el servidor web para Secure Sockets Layer (SSL), puede volver a ejecutar el instalador para definir las opciones de SSL.
Corrija los errores en instalaciones anteriores.
Instale la aplicación en una instancia de base de datos diferente.

NOTE

De forma predeterminada, el instalador no sobrescribe la base de datos si instala el software de Commerce en la misma instancia de base de datos. Puede usar el parámetro cleanup-database opcional para cambiar este comportamiento.

Ver también Actualizar, reinstalar, desinstalar.

Instalación segura

Para utilizar Secure Sockets Layer (SSL), también denominado HTTPS, tanto para el administrador como para la tienda, debe establecer todos los parámetros siguientes:

--use-secure: establecido en 1
--base-url-secure: establezca en una dirección URL segura (es decir, que comience por https://)
--use-secure-admin se estableció en 1

Más adelante en este tema se pueden encontrar más detalles sobre estos parámetros.

Comandos de ayuda del instalador

Puede ejecutar los siguientes comandos para buscar los valores de algunos argumentos necesarios:

Argumento del instalador

Comando

Idioma

magento info:language:list

Moneda

magento info:currency:list

Zona horaria

magento info:timezone:list

NOTE

Si aparece un error al ejecutar estos comandos, compruebe que ha actualizado las dependencias de instalación tal como se describe en Actualizar dependencias de instalación.

Instale desde la línea de comandos

El comando install utiliza el siguiente formato:

magento setup:install --<option>=<value> ... --<option>=<value>

En las tablas siguientes se describen los nombres y valores de las opciones de instalación, como los comandos de instalación. Consulte Ejemplos de instalaciones de localhost.

NOTE

Cualquier opción que contenga espacios o caracteres especiales debe estar entre comillas simples o dobles.

Credenciales de administrador:

Las siguientes opciones especifican la información de usuario y las credenciales del usuario administrador.

En la versión 2.2.8 y posteriores de Adobe Commerce, puede crear el usuario administrador durante o después de la instalación. Si crea el usuario durante la instalación, se requieren todas las variables de credenciales de administrador. Consulte Ejemplos de instalaciones de localhost.

Nombre

Valor

¿Requerido?

--admin-firstname

Nombre del usuario administrador.

Sí

--admin-lastname

Apellido del usuario administrador.

Sí

--admin-email

Dirección de correo electrónico del usuario administrador.

Sí

--admin-user

Nombre de usuario del administrador.

Sí

--admin-password

Contraseña de usuario del administrador. La contraseña debe tener al menos 7 caracteres de longitud e incluir al menos un carácter alfabético y al menos un carácter numérico. Se recomienda una contraseña más larga y compleja. Escriba toda la cadena de contraseña entre comillas simples. Por ejemplo, --admin-password='A0b9%t3g'

Sí

Opciones de configuración del sitio y la base de datos:

Nombre

Valor

¿Requerido?

--base-url

Dirección URL base que se utilizará para obtener acceso al administrador y a la tienda en cualquiera de los siguientes formatos:

http[s]://<host or ip>/<your install dir>/.

Nota: El esquema (http:// o https://) y una barra diagonal son obligatorios.

<your install dir> es la ruta de acceso relativa a docroot en la que se instala la aplicación. Según la configuración del servidor web y los hosts virtuales, la ruta puede ser magento2 o estar en blanco.

Para tener acceso a la aplicación en localhost, puede usar http://127.0.0.1/<your install dir>/ o http://127.0.0.1/<your install dir>/.

- {{base_url}} que representa una URL base definida por una configuración de host virtual o por un entorno de virtualización como Docker. Por ejemplo, si configura un host virtual con el nombre de host commerce.example.com, puede instalar la aplicación con --base-url={{base_url}} y acceder al administrador con una dirección URL como http://commerce.example.com/admin.

Sí

--backend-frontname

Identificador uniforme de recursos (URI) para acceder al administrador. Puede omitir este parámetro para permitir que la aplicación genere un URI aleatorio con el siguiente patrón admin_jkhgdfq.

Recomendamos un URI aleatorio por motivos de seguridad. Un URI aleatorio es más difícil de explotar para los piratas informáticos o para el software malintencionado.

El URI se muestra al final de la instalación. Puede mostrarlo más adelante en cualquier momento mediante el comando magento info:adminuri.

Si elige introducir un valor, le recomendamos que no utilice una palabra común como admin, backend. El URI de administrador solo puede contener valores alfanuméricos y el carácter de subrayado (_).

--db-host

Use cualquiera de los siguientes:

- El nombre de host completo o la dirección IP del servidor de base de datos.

- localhost (predeterminado) o 127.0.0.1 si el servidor de la base de datos está en el mismo host que el servidor web.localhost significa que la biblioteca de cliente MySQL utiliza sockets UNIX para conectarse a la base de datos. 127.0.0.1 hace que la biblioteca de cliente use el protocolo TCP. Para obtener más información sobre sockets, consulte la documentación PHP PDO_MYSQL.

Nota: Si lo desea, puede especificar el puerto del servidor de base de datos en su nombre de host como www.example.com:9000

Sí

--db-name

Nombre de la instancia de base de datos en la que desea instalar las tablas de base de datos.

El valor predeterminado es magento2.

Sí

--db-user

Nombre de usuario del propietario de la instancia de base de datos.

El valor predeterminado es root.

Sí

--db-password

Contraseña del propietario de la instancia de base de datos.

Sí

--db-prefix

Utilícelo únicamente si va a instalar las tablas de base de datos en una instancia de base de datos que ya contiene tablas de Adobe Commerce.

En ese caso, use un prefijo para identificar las tablas de esta instalación. Algunos clientes tienen más de una instancia de Adobe Commerce ejecutándose en un servidor con todas las tablas de la misma base de datos.

El prefijo puede tener una longitud máxima de cinco caracteres. Debe comenzar por una letra y solo puede incluir letras, números y caracteres de subrayado.

Esta opción permite que esos clientes compartan el servidor de base de datos con más de una instalación.

--db-ssl-key

Ruta a la clave de cliente.

--db-ssl-cert

Ruta al certificado de cliente.

--db-ssl-ca

Ruta al certificado del servidor.

--language

Código de idioma que se utilizará en la administración y en la tienda. (Si aún no lo ha hecho, puede ver la lista de códigos de idioma al escribir magento info:language:list desde el directorio bin.)

--currency

Moneda predeterminada que se utilizará en la tienda. (Si aún no lo ha hecho, puede ver la lista de monedas especificando magento info:currency:list desde el directorio bin.)

--timezone

Zona horaria predeterminada que se utilizará en la administración y en la tienda. (Si aún no lo ha hecho, puede ver la lista de zonas horarias escribiendo magento info:timezone:list desde el directorio bin.)

--use-rewrites

1 significa que utiliza las reescrituras de servidor web para los vínculos generados en la tienda y el administrador.

0 deshabilita el uso de reescrituras de servidor web. Esta es la opción predeterminada.

--use-secure

1 habilita el uso de Capa de sockets seguros (SSL) en las direcciones URL de las tiendas. Asegúrese de que el servidor web admita SSL antes de seleccionar esta opción.

0 deshabilita el uso de SSL. En este caso, todas las demás opciones de URL segura se suponen que también son 0. Esta es la opción predeterminada.

--base-url-secure

URL base segura que se usará para tener acceso a su administración y tienda en el siguiente formato: http[s]://<host or ip>/<your install dir>/

--use-secure-admin

1 significa que utiliza SSL para acceder al administrador. Asegúrese de que el servidor web admita SSL antes de seleccionar esta opción.

0 significa que no utiliza SSL con el administrador. Esta es la opción predeterminada.

--admin-use-security-key

1 hace que la aplicación utilice un valor clave generado aleatoriamente para acceder a las páginas del administrador y a los formularios. Estos valores clave ayudan a evitar ataques de falsificación de scripts entre sitios. Esta es la opción predeterminada.

0 deshabilita el uso de la clave.

--session-save

Use cualquiera de las siguientes opciones:

- db para almacenar datos de sesión en la base de datos. Elija el almacenamiento de la base de datos si tiene una base de datos en clúster; de lo contrario, es posible que no haya muchas ventajas con respecto al almacenamiento basado en archivos.

- files para almacenar datos de sesión en el sistema de archivos. El almacenamiento de sesión basado en archivos es adecuado a menos que el acceso al sistema de archivos sea lento, tenga una base de datos en clúster o desee almacenar los datos de sesión en Redis.

- redis para almacenar datos de sesión en Redis. Si utiliza Redis para el almacenamiento en caché predeterminado o de página, debe estar instalado. Consulte Uso de Redis para el almacenamiento de sesión para obtener información adicional sobre la configuración de la compatibilidad con Redis.

--key

Si tiene una, especifique una clave para cifrar datos confidenciales en la base de datos. Si no tiene ninguna, la aplicación generará una para usted.

Sí

--cleanup-database

Para borrar tablas de base de datos antes de instalar la aplicación, especifique este parámetro sin un valor. De lo contrario, la base de datos se deja intacta.

--db-init-statements

Parámetro de configuración avanzado de MySQL. Utiliza sentencias de inicialización de base de datos para ejecutarse al conectarse a la base de datos MySQL. Consulte una referencia similar a esta antes de establecer cualquier valor.

El valor predeterminado es SET NAMES utf8;.

--sales-order-increment-prefix

Especifique un valor de cadena para utilizarlo como prefijo de pedidos de venta. Normalmente, se utiliza para garantizar números de pedido únicos para los procesadores de pagos.

TIP

Para habilitar los servicios de almacenamiento remoto durante la instalación, consulte Configurar almacenamiento remoto en la Guía de configuración.

Opciones de configuración del motor de búsqueda:

Nombre

Valor

¿Requerido?

--search-engine

La versión del motor de búsqueda. Los valores posibles son elasticsearch7, elasticsearch6 y elasticsearch5. El valor predeterminado es elasticsearch7. Si ha instalado OpenSearch como motor de búsqueda, especifique el valor elasticsearch7. El Elasticsearch 5 se ha desaprobado y no se recomienda.

--elasticsearch-host

El nombre de host o la dirección IP donde se está ejecutando el motor de búsqueda. El valor predeterminado es localhost.

--elasticsearch-port

El puerto para las solicitudes HTTP entrantes. El valor predeterminado es 9200.

--elasticsearch-index-prefix

Prefijo que identifica el índice de búsqueda. El valor predeterminado es magento2.

--elasticsearch-timeout

El número de segundos antes de que se agote el tiempo de espera del sistema. El valor predeterminado es 15.

--elasticsearch-enable-auth

Habilita la autenticación en el servidor del motor de búsqueda. El valor predeterminado es false.

--elasticsearch-username

El ID de usuario para autenticar

No, a menos que la autenticación esté habilitada

--elasticsearch-password

La contraseña para autenticarse

No, a menos que la autenticación esté habilitada

RabbitMQopciones de configuración:

Nombre

Valor

¿Requerido?

--amqp-host

No utilice las opciones --amqp a menos que ya haya configurado una instalación de RabbitMQ. Consulte la instalación de RabbitMQ para obtener más información sobre cómo instalar y configurar RabbitMQ.

Nombre de host donde está instalado RabbitMQ.

--amqp-port

El puerto que se va a usar para conectarse a RabbitMQ. El valor predeterminado es 5672.

--amqp-user

Nombre de usuario para conectarse a RabbitMQ. No use el usuario predeterminado guest.

--amqp-password

Contraseña para conectarse a RabbitMQ. No use la contraseña predeterminada guest.

--amqp-virtualhost

Host virtual para conectarse a RabbitMQ. El valor predeterminado es /.

--amqp-ssl

Indica si se debe conectar con RabbitMQ. El valor predeterminado es false. Consulte RabbitMQ para obtener información sobre cómo configurar SSL para RabbitMQ.

--consumers-wait-for-messages

¿Deben los consumidores esperar un mensaje de la cola? 1 - Sí, 0 - No

Opciones de almacenamiento remoto:

Nombre

Descripción

¿Requerido?

remote-storage-driver

Nombre del adaptador
Valores posibles:
archivo: Deshabilita el almacenamiento remoto y usa el sistema de archivos local
aws-s3: Use el servicio Amazon Simple Storage (Amazon S3)

remote-storage-bucket

Almacenamiento de objetos o nombre de contenedor

remote-storage-prefix

Prefijo opcional (ubicación dentro del almacenamiento de objetos)

remote-storage-region

Nombre de región

remote-storage-key

Clave de acceso opcional

remote-storage-secret

Clave secreta opcional

Bloquear opciones de configuración:

Nombre

Valor

¿Requerido?

--lock-provider

Bloquear nombre de proveedor.

Proveedores de bloqueos disponibles: db, zookeeper, file.

El proveedor de bloqueo predeterminado: db

--lock-db-prefix

Prefijo de base de datos específico para evitar conflictos de bloqueo al utilizar el proveedor de bloqueo db.

El valor predeterminado: NULL

--lock-zookeeper-host

Host y puerto para conectarse al clúster de Zookeeper cuando se utiliza el proveedor de bloqueo zookeeper.

Por ejemplo: 127.0.0.1:2181

Sí, si se establece --lock-provider=zookeeper

--lock-zookeeper-path

El camino donde Zookeeper guarda las cerraduras.

La ruta predeterminada es: /magento/locks

--lock-file-path

Ruta de acceso donde se guardan los bloqueos de archivo.

Sí, si se establece --lock-provider=file

Opciones de configuración de consumidores:

Nombre

Descripción

Valor

Requerido

--consumers-wait-for-messages

Determina si los consumidores esperarán un mensaje de la cola.

1 - Sí, 0 - No

0: los consumidores procesan los mensajes disponibles en la cola, cierran la conexión TCP y finalizan. Los consumidores no esperan mensajes adicionales para entrar en la cola, aunque el número de mensajes procesados sea menor que el valor --max_messages especificado durante el inicio de los consumidores.
1: los consumidores continúan procesando mensajes de la cola de mensajes hasta alcanzar el número máximo de mensajes (el valor especificado para --max_messages en el comando queue:consumers:start) antes de cerrar la conexión TCP y finalizar el proceso de consumo. Si la cola se vacía antes de llegar a --max_messages, el consumidor espera a que lleguen más mensajes. Si usa trabajadores para ejecutar consumidores en lugar de usar un trabajo cron, establezca esta variable en 1.

WARNING

La opción --consumers-wait-for-messages es una opción global y no se puede configurar por separado para cada consumidor.

NOTE

Para habilitar o deshabilitar módulos después de instalar la aplicación, vea Habilitar y deshabilitar módulos.

Datos confidenciales:

Adobe Commerce utiliza su clave de cifrado para cifrar lo siguiente:

Información de tarjeta de crédito
Nombres de usuario y contraseñas especificados en la configuración de administración (por ejemplo, inicios de sesión en puertas de enlace de pago)
Valores CAPTCHA enviados a través de la red

Adobe Commerce no cifra:

Nombres de usuario y contraseñas administrativos y de clientes (estas contraseñas tienen un cifrado hash)
Dirección
Número de teléfono
Otros tipos de información de identificación personal excepto números de tarjetas de crédito

Ejemplos de instalaciones de localhost

Los siguientes ejemplos muestran los comandos para instalar Adobe Commerce localmente con varias opciones.

Ejemplo 1: instalación básica con cuenta de usuario de administrador

En el ejemplo siguiente se instala la aplicación con las opciones siguientes:

La aplicación está instalada en el directorio magento2 con relación al servidor web docroot en localhost y la ruta de acceso al administrador es admin; por lo tanto:

La URL de tu tienda es http://127.0.0.1
El servidor de base de datos está en el mismo host que el servidor web.

El nombre de la base de datos es magento, y el nombre de usuario y la contraseña son magento
Utiliza reescrituras del servidor
El administrador tiene las siguientes propiedades:
- El nombre y los apellidos son Commerce User
- El nombre de usuario es admin y la contraseña es admin123
- La dirección de correo electrónico es user@example.com
El idioma predeterminado es en_US (inglés de EE. UU.)
La moneda predeterminada es el dólar estadounidense
La zona horaria predeterminada es Centro de Estados Unidos (América/Chicago)
Elasticsearch 7 está instalado en es-host.example.com y se conecta al puerto 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Se muestran mensajes similares a los siguientes para indicar que la instalación se ha realizado correctamente:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Ejemplo 2: instalación básica sin cuenta de usuario de administrador

Puede instalar la aplicación sin crear el usuario administrador, como se muestra en el siguiente ejemplo.

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Si la instalación se realiza correctamente, se muestran mensajes como el siguiente:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Después de la instalación, puede crear un usuario administrador mediante el comando admin:user:create:
Crear o editar un administrador

Ejemplo 3: Instalar con opciones adicionales

En el ejemplo siguiente se instala la aplicación con las opciones siguientes:

La aplicación Magento está instalada en el directorio magento2 con relación al servidor web docroot en localhost y la ruta de acceso al administrador es admin; por lo tanto:

La URL de tu tienda es http://127.0.0.1
El servidor de base de datos está en el mismo host que el servidor web.

El nombre de la base de datos es magento, y el nombre de usuario y la contraseña son magento
El administrador tiene las siguientes propiedades:
- El nombre y los apellidos son Commerce User
- El nombre de usuario es admin y la contraseña es admin123
- La dirección de correo electrónico es user@example.com
El idioma predeterminado es en_US (inglés de EE. UU.)
La moneda predeterminada es el dólar estadounidense
La zona horaria predeterminada es Centro de Estados Unidos (América/Chicago)
El instalador primero limpia la base de datos antes de instalar las tablas y el esquema
Utiliza un prefijo de incremento de pedido de ventas ORD$ (dado que contiene un carácter especial [$], el valor debe escribirse entre comillas dobles)
Los datos de la sesión se guardan en la base de datos
Utiliza reescrituras del servidor
Elasticsearch 7 está instalado en es-host.example.com y se conecta al puerto 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

NOTE

Debe escribir el comando en una sola línea o, como en el ejemplo anterior, con un carácter \ al final de cada línea.

Si la instalación se realiza correctamente, se muestran mensajes como el siguiente:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

TIP

Si tiene una cuenta de usuario para tener acceso al servidor de aplicaciones, vea establecer una máscara de usuario. Este tipo de configuración es típico del alojamiento compartido.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995