Documentación Commerce Guía de instalación

Instalación local de inicio rápido

Last update: Mon Nov 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Experimentado
Administrador
Desarrollador

Las instrucciones de esta página describen cómo instalar Adobe Commerce en una infraestructura autoalojada. Para obtener instrucciones sobre cómo actualizar una instalación existente, consulte la Guía de actualización.

El Adobe usa Composer para administrar los componentes de Adobe Commerce y sus dependencias. Usar Composer para obtener el metapaquete de Adobe Commerce ofrece las siguientes ventajas:

Reutilice bibliotecas de terceros sin agruparlas con el código fuente
Reduzca los conflictos de extensiones y los problemas de compatibilidad utilizando una arquitectura basada en componentes con una sólida administración de dependencias
Adherirse a los estándares FIG (Grupo de Interoperabilidad PHP-Framework)
Volver a empaquetar el Magento Open Source con otros componentes
Uso del software de Adobe Commerce en un entorno de producción

NOTE

Los desarrolladores que contribuyen a Magento Open Source deben usar el método de instalación basado en Git.

Requisitos previos

Antes de continuar, debe hacer lo siguiente:

Complete todas las tareas previas.
Instalar Compositor.
Obtenga claves de autenticación en el repositorio del Compositor de Adobe Commerce.

Iniciar sesión como propietario del sistema de archivos

Obtenga información acerca de la propiedad, los permisos y el propietario del sistema de archivos en el tema Información general sobre la propiedad y los permisos.

Para cambiar al propietario del sistema de archivos:

Inicie sesión en el servidor de aplicaciones como un usuario con permisos para escribir en el sistema de archivos o cambie a.

Si utiliza el shell de bash, puede utilizar la siguiente sintaxis para cambiar al propietario del sistema de archivos e introducir el comando al mismo tiempo:

code language-bash
`su <file system owner> -s /bin/bash -c <command>`

Si el propietario del sistema de archivos no permite inicios de sesión, puede hacer lo siguiente:

code language-bash
`sudo -u <file system owner> <command>`

Para ejecutar comandos CLI desde cualquier directorio, agregue <app_root>/bin a su sistema PATH.

Como los shells tienen sintaxis diferente, consulte una referencia como unix.stackexchange.com.

Ejemplo de shell de bash para CentOS:

code language-bash
`export PATH=$PATH:/var/www/html/magento2/bin`

Opcionalmente, puede ejecutar los comandos de las siguientes maneras:

cd <app_root>/bin y ejecutarlos como ./magento <command name>
app_root>/bin/magento <command name>
<app_root> es un subdirectorio del servidor web docroot

Obtenga el metapaquete

Para obtener el metapaquete de Adobe Commerce:

Inicie sesión en el servidor de aplicaciones como propietario del sistema de archivos o cambie a él.
Cambie al directorio docroot del servidor web o a un directorio que haya configurado como docroot del host virtual.

Cree un proyecto Composer utilizando un metapaquete de Commerce.

Magento Open Source

code language-bash
`composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>`

Adobe Commerce

code language-bash
`composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>`

Cuando se le solicite, introduzca sus claves de autenticación. Las claves pública y privada se crean y configuran en su Commerce Marketplace.

note note
NOTE
Al utilizar un archivo del Compositor `auth.json` o una variable de entorno, no se le pedirá que escriba las claves de autenticación.

Si encuentra errores, como Could not find package... o ...no matching package found, asegúrese de que no haya errores tipográficos en el comando. Si sigue encontrando errores, es posible que no tenga autorización para descargar Adobe Commerce. Póngase en contacto con el Soporte técnico de Adobe Commerce para obtener ayuda.

Consulte Solución de problemas para obtener ayuda con más errores.

Ejemplo: versión menor

Las versiones menores contienen nuevas funciones, correcciones de calidad y correcciones de seguridad. Use Compositor para especificar una versión secundaria. Por ejemplo, para especificar el metapaquete de Adobe Commerce 2.4.6:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

Ejemplo: parche de calidad

Los parches de calidad contienen principalmente y correcciones de seguridad funcionales. Sin embargo, a veces también pueden contener nuevas funciones compatibles con versiones anteriores. Use Composer para descargar un parche de calidad. Por ejemplo, para especificar el metapaquete de Adobe Commerce 2.4.6:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

Ejemplo: parche de seguridad

Los parches de seguridad solo contienen correcciones de seguridad. Están diseñadas para que el proceso de actualización sea más rápido y sencillo.

Los parches de seguridad utilizan la convención de nombres del Compositor 2.4.6-px. Use el Compositor para especificar un parche. Por ejemplo, para descargar el metapaquete Adobe Commerce 2.4.6-p1:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>

Definición de permisos de archivo

Debe establecer permisos de lectura y escritura para el grupo de servidores web antes de instalar Adobe Commerce. Esto es necesario para que la línea de comandos pueda escribir archivos en el sistema de archivos.

cd /var/www/html/<magento install directory>
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 . # Ubuntu
chmod u+x bin/magento

Instalación de la aplicación

Debe utilizar la línea de comandos para instalar Adobe Commerce.

En este ejemplo se supone que el directorio de instalación se llama magento2ee, que db-host está en el mismo equipo (localhost) y que db-name, db-user y db-password son todos magento:

bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.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 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15

TIP

Puede personalizar el URI de administrador con la opción --backend-frontname. Sin embargo, Adobe recomienda omitir esta opción y permitir que el comando de instalación genere automáticamente un URI aleatorio. Un URI aleatorio es más difícil de explotar para los piratas informáticos o para el software malintencionado. El URI se muestra en la consola cuando se completa la instalación.

TIP

Para obtener una descripción completa de las opciones de instalación de CLI, consulte Instalar la aplicación desde la línea de comandos.

Resumen de comandos

Para mostrar una lista completa de comandos, escriba:

bin/magento list

Para obtener ayuda acerca de un comando concreto, escriba:

bin/magento help <command>

Por ejemplo:

bin/magento help setup:install

bin/magento help cache:enable

En la tabla siguiente se resumen los comandos disponibles. Los comandos sólo se muestran en forma de resumen. Para obtener más información acerca de un comando, haga clic en el vínculo en la columna Comando.

Comando

Descripción

Requisitos previos

magento setup:install

Instala la aplicación

Ninguno

magento setup:uninstall

Quita la aplicación.

Aplicación instalada

magento setup:upgrade

Actualiza la aplicación.

Configuración de implementación

magento maintenance:{enable/disable}

Activa o desactiva el modo de mantenimiento (en este modo, solo las direcciones IP exentas pueden acceder al administrador o a la tienda).

Aplicación instalada

magento setup:config:set

Crea o actualiza la configuración de implementación.

Ninguno

magento module:{enable/disable}

Habilitar o deshabilitar módulos.

Ninguno

magento setup:store-config:set

Establece opciones relacionadas con la tienda, como la dirección URL base, el idioma y la zona horaria.

Configuración de implementación

magento setup:db-schema:upgrade

Actualiza el esquema de la base de datos.

Configuración de implementación

magento setup:db-data:upgrade

Actualiza los datos de la base de datos.

Configuración de implementación

magento setup:db:status

Comprueba si la base de datos está actualizada con el código.

Configuración de implementación

magento admin:user:create

Crea un usuario administrador.

Puede crear usuarios para lo siguiente:

Configuración de implementación

Habilite como mínimo los módulos Magento_User y Magento_Authorization

Base de datos (la forma más sencilla es usar bin/magento setup:upgrade)

magento list

Muestra todos los comandos disponibles.

Ninguno

magento help

Proporciona ayuda para el comando especificado.

Ninguno

Argumentos comunes

Los siguientes argumentos son comunes a todos los comandos. Estos comandos se pueden ejecutar antes o después de instalar la aplicación:

Versión larga

Versión corta

Significado

--help

-h

Obtener ayuda para cualquier comando. Por ejemplo, ./magento help setup:install o ./magento help setup:config:set.

--quiet

-q

Modo silencioso; sin salida.

--no-interaction

-n

No hay preguntas interactivas.

--verbose=1,2,3

-v, -vv, -vvv

Nivel de detalle. Por ejemplo, --verbose=3 o -vvv muestran el nivel de detalle de la depuración, que es el resultado más detallado. El valor predeterminado es --verbose=1 o -v.

--version

-V

Mostrar esta versión de la aplicación

--ansi

n/a

Forzar salida ANSI

--no-ansi

n/a

Deshabilitar salida ANSI

NOTE

¡Felicidades! Ha completado la instalación rápida. ¿Necesita ayuda más avanzada? Consulte la guía de instalación avanzada.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995