Instalación local avanzada
Interfaz de línea de comandos (CLI)
Adobe Commerce tiene una interfaz de línea de comandos única para las tareas de instalación y configuración: <magento_root>/bin/magento
. La interfaz realiza varias tareas, entre las que se incluyen:
- Instalación (y tareas relacionadas como crear o actualizar el esquema de la base de datos, crear la configuración de implementación).
- Borrando la caché.
- Administrar índices, incluida la reindexación.
- Creación de diccionarios de traducción y paquetes de traducción.
- Generación de clases inexistentes como fábricas e interceptores para complementos, generando la configuración de inyección de dependencias para el administrador de objetos.
- Implementación de archivos de vista estática.
- Crear CSS a partir de Less.
Otros beneficios:
- Un solo comando (
<magento_root>/bin/magento list
) enumera todos los comandos de instalación y configuración disponibles. - Interfaz de usuario coherente basada en Symfony.
- La CLI es extensible para que los desarrolladores de terceros puedan "conectarse" a ella. Esto tiene la ventaja adicional de eliminar la curva de aprendizaje de los usuarios.
- No se muestran los comandos para los módulos desactivados.
En este tema se describe la instalación del software de Adobe Commerce mediante la CLI. Para obtener información sobre la configuración, consulte Guía de configuración.
El instalador se puede ejecutar varias veces si es necesario para que pueda:
-
Proporcionar valores diferentes
Por ejemplo, después de configurar el servidor web para Secure Sockets Layer (SSL), puede ejecutar el instalador para establecer las opciones de SSL.
-
Corrección de errores en instalaciones anteriores
-
Instalar Adobe Commerce en una instancia de base de datos diferente
Antes de iniciar la instalación
Antes de empezar, complete los siguientes pasos:
-
Compruebe que su sistema cumple los requisitos mencionados en requisitos del sistema.
-
Completar todo requisito previo tareas.
-
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, cambiar al propietario del sistema de archivos.
-
Revise la inicio rápido de instalación información general.
bin
subdirectorio.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 establecer las opciones de SSL.
-
Corrija los errores en instalaciones anteriores.
-
Instale Adobe Commerce en una instancia de base de datos diferente.
cleanup-database
para cambiar este comportamiento.Consulte 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
: establezca en1
--base-url-secure
: establezca en una dirección URL segura (es decir, empezando porhttps://
)--use-secure-admin
Configure como.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:
bin/magento info:language:list
bin/magento info:currency:list
bin/magento info:timezone:list
Instale desde la línea de comandos
El comando install utiliza el siguiente formato:
bin/magento setup:install --<option>=<value> ... --<option>=<value>
En las tablas siguientes se describen los nombres y valores de las opciones de instalación. Por ejemplo, para ver los comandos de instalación, consulte Ejemplos de instalaciones de localhost.
Credenciales de administrador:
Las siguientes opciones especifican la información de usuario y las credenciales del usuario administrador.
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.
Las siguientes tablas proporcionan muchos parámetros de instalación disponibles, pero no todos. Para obtener una lista completa, consulte la Referencia de herramientas de la línea de comandos.
--admin-firstname
--admin-lastname
--admin-email
--admin-user
--admin-password
--admin-password='A0b9%t3g'
Opciones de configuración de sitios y bases de datos:
--base-url
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 relativa a docroot en la que se instala el software de Adobe Commerce. Según la configuración del servidor web y los hosts virtuales, la ruta puede ser magento2 o estar en blanco.Para acceder a Adobe Commerce o MagenAdobe Commerce, utilice
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 magento.example.com
, puede instalar el software con --base-url={{base_url}}
y acceder al administrador con una dirección URL como http://magento.example.com/admin
.--backend-frontname
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 tarde en cualquier momento utilizando la variable
bin/magento info:adminuri
comando.Si decide introducir un valor, le recomendamos que no utilice una palabra común como administrador o backend. El URI de administrador puede contener valores alfanuméricos y el carácter de subrayado (
_
) únicamente.--db-host
: Nombre de host o dirección IP completos 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 cliente utilice el protocolo TCP. Para obtener más información sobre los sockets, consulte la Documentación de PHP PDO_MYSQL.Nota: Si lo desea, puede especificar el puerto del servidor de la base de datos en su nombre de host como www.example.com:9000
--db-name
El valor predeterminado es
magento2
.--db-user
El valor predeterminado es
root
.--db-password
--db-prefix
En ese caso, utilice un prefijo para identificar las tablas de esta instalación. Algunos clientes tienen más de un Adobe Commerce o MagenAdobe Commerce Server 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 a estos clientes compartir el servidor de base de datos con más de una instalación de Adobe Commerce
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
bin/magento info:language:list
del directorio bin.)--currency
bin/magento info:currency:list
del directorio bin.)--timezone
bin/magento info:timezone:list
desde el bin/
directorio.)--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 servidores web. Esta es la opción predeterminada.--use-secure
1
habilita el uso de Capa de sockets seguros (SSL) en las direcciones URL de tienda. 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
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
0
deshabilita el uso de la clave.--session-save
-
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
--cleanup-database
--db-init-statements
El valor predeterminado es
SET NAMES utf8;
.--sales-order-increment-prefix
Opciones de configuración del motor de búsqueda:
--search-engine
elasticsearch7
. El Elasticsearch 5 se ha desaprobado y no se recomienda.--elasticsearch-host
localhost
.--elasticsearch-port
9200
.--elasticsearch-index-prefix
magento2
.--elasticsearch-timeout
15
.--elasticsearch-enable-auth
false
.--elasticsearch-username
--elasticsearch-password
--opensearch-host
localhost
.--opensearch-port
9200
.--opensearch-index-prefix
magento2
.--opensearch-timeout
15
.--opensearch-enable-auth
false
.--opensearch-username
--opensearch-password
RabbitMQopciones de configuración:
--amqp-host
--amqp
a menos que ya haya configurado una instalación de RabbitMQ. Consulte RabbitMQ instalación para obtener más información acerca de cómo instalar y configurar RabbitMQ.El nombre de host donde RabbitMQ está instalado.
--amqp-port
--amqp-user
guest
.--amqp-password
guest
.--amqp-virtualhost
/
.--amqp-ssl
false
. Consulte RabbitMQ para obtener información sobre la configuración de SSL para RabbitMQ.--consumers-wait-for-messages
Bloquear opciones de configuración:
--lock-provider
Proveedores de bloqueos disponibles:
db
, zookeeper
, file
.El proveedor de bloqueo predeterminado:
db
--lock-db-prefix
db
bloquear proveedor.El valor predeterminado:
NULL
--lock-zookeeper-host
zookeeper
bloquear proveedor.Por ejemplo:
127.0.0.1:2181
--lock-provider=zookeeper
--lock-zookeeper-path
La ruta predeterminada es:
/magento/locks
--lock-file-path
--lock-provider=file
Opciones de configuración de consumidores:
--consumers-wait-for-messages
-
0
: los consumidores procesan los mensajes disponibles en la cola, cierran la conexión TCP y finalizan. Los consumidores no esperan a que los mensajes adicionales entren en la cola, aunque el número de mensajes procesados sea menor que el--max_messages
valor especificado durante el inicio de 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 elqueue:consumers:start
) antes de cerrar la conexión TCP y finalizar el proceso de consumidor. Si la cola se vacía antes de alcanzar--max_messages
el consumidor espera a que lleguen más mensajes. Si utiliza trabajadores para ejecutar consumidores en lugar de utilizar un trabajo cron, establezca esta variable como1
.
--consumers-wait-for-messages
es una opción global y no se puede configurar por separado para cada consumidor.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 do no cifrar:
- 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
El siguiente ejemplo instala Adobe Commerce con las siguientes opciones:
-
La aplicación se instala en
magento2
directorio relativo al servidor web docroot enlocalhost
y la ruta al administrador esadmin
; por lo tanto:La URL de la 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 sonmagento
-
Utiliza reescrituras del servidor
-
El administrador tiene las siguientes propiedades:
- El nombre y los apellidos son
Magento User
- Nombre de usuario:
admin
y la contraseña esadmin123
- La dirección de correo electrónico es
user@example.com
- El nombre y los apellidos son
-
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)
-
OpenSearch 1.2 está instalado en
os-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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-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 Adobe Commerce 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=opensearch --opensearch-host=os-host.example.com \
--opensearch-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 admin:user:create
comando:
Creación o edición de un administrador
Ejemplo 3: Instalar con opciones adicionales
El siguiente ejemplo instala Adobe Commerce con las siguientes opciones:
-
La aplicación se instala en
magento2
directorio relativo al servidor web docroot enlocalhost
y la ruta al administrador esadmin
; por lo tanto:La URL de la 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 sonmagento
-
El administrador tiene las siguientes propiedades:
- El nombre y los apellidos son
Magento User
- Nombre de usuario:
admin
y la contraseña esadmin123
- La dirección de correo electrónico es
user@example.com
- El nombre y los apellidos son
-
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
-
Puede utilizar el prefijo de incremento del pedido de venta
ORD$
(ya que contiene un carácter especial [$
], el valor debe estar entre comillas dobles) -
Los datos de la sesión se guardan en la base de datos
-
Utiliza reescrituras del servidor
-
OpenSearch está instalado en
os-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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
\
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