Incorporación e instalación

Instale el servicio de catálogo para solicitar y recibir datos de producto de una instancia de Commerce mediante la API de GraphQL del servicio de catálogo. El servicio de catálogo se entrega como un metapaquete de compositor desde el repositorio repo.magento.com.

NOTE
Si la instancia de Commerce utiliza Live Search o Product Recommendations, el servicio de catálogo se instala o actualiza automáticamente al incorporar o actualizar esos servicios. Para obtener más información, consulte las instrucciones de instalación de Live Search y Product Recommendations.

Requisitos del sistema

Requisitos de software

  • Adobe Commerce 2.4.4+
  • PHP 8.1, 8.2, 8.3
  • Compositor: 2.x

Plataformas compatibles

  • Adobe Commerce en infraestructura en la nube: 2.4.4+
  • Adobe Commerce local: 2.4.4+

Extremos

Catalog Service tiene dos extremos disponibles para la incorporación:

  • Zona protegida (https://catalog-service-sandbox.adobe.io/graphql): se usa para pruebas y validación antes de activarse
  • Producción (https://catalog-service.adobe.io/graphql): se usa para el tráfico en directo de comerciantes y sitios web de Commerce.

Todas las instancias de prueba de Commerce utilizan el extremo de zona protegida.

Realice todas las pruebas de carga en el extremo de la zona protegida. Antes de comenzar la prueba de carga, envíe un ticket de asistencia para que el equipo de servicios pueda anticipar el tráfico adicional del servidor.

Instalación y configuración

Para comenzar con Catalog Service para Adobe Commerce, se requieren los siguientes pasos:

  • Instalar la extensión del Servicio de catálogo (magento/catalog-service)
  • Configuración del servicio y la exportación de datos
  • Acceso al servicio
recommendation-more-help

Requisito previo

Instale la última versión de la extensión de servicios de catálogo (magento/catalog-service) en una instancia de Adobe Commerce que ejecute Adobe Commerce versión 2.4.4 o posterior. El servicio de catálogo se entrega como un metapaquete de composición desde el repositorio repo.magento.com.

Infraestructura en la nube

Utilice este método para instalar Catalog Service para una instancia de Commerce Cloud.

  1. En la estación de trabajo local, cambie al directorio del proyecto para su proyecto de Adobe Commerce en la nube.

    note note
    NOTE
    Para obtener información sobre cómo administrar los entornos de proyecto de Commerce localmente, consulte Administración de ramas con la CLI en la Guía del usuario de Adobe Commerce on Cloud Infrastructure.
  2. Consulte la rama de entorno para actualizar con la CLI de Adobe Commerce Cloud.

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. Añada el módulo Servicio de catálogo.

    code language-bash
    composer require magento/catalog-service --no-update
    
  4. Actualizar dependencias del paquete.

    code language-bash
    composer update "magento/catalog-service"
    
  5. Confirme y envíe los cambios de código para los archivos composer.json y composer.lock.

  6. Agregue, confirme e inserte los cambios de código para los archivos composer.json y composer.lock en el entorno de nube.

    code language-shell
    git add -A
    git commit -m "Add catalog service module"
    git push origin <branch-name>
    

    Si se insertan las actualizaciones en el entorno de la nube, se inicia el proceso de implementación de la nube de Commerce para aplicar los cambios. Compruebe el estado de implementación desde el registro de implementación.

Local

Utilice este método para instalar Catalog Service para una instancia local.

  1. Use Compositor para agregar el módulo Servicio de catálogo a su proyecto:

    code language-bash
    composer require magento/catalog-service --no-update
    
  2. Actualice las dependencias e instale la extensión:

    code language-bash
    composer update  "magento/catalog-service"
    
  3. Actualizar Adobe Commerce:

    code language-bash
    bin/magento setup:upgrade
    
  4. Borre la caché:

    code language-bash
    bin/magento cache:clean
    
    note tip
    TIP
    En algunos casos, especialmente al implementar en producción, puede que desee evitar borrar el código compilado, ya que puede tardar algún tiempo. Asegúrese de realizar una copia de seguridad del sistema antes de realizar cualquier cambio.

Configuración del servicio y la exportación de datos

Después de instalar Catalog Service, complete las siguientes tareas para integrar el servicio Catálogo con su instancia de Adobe Commerce. Esta integración permite la sincronización de datos y la comunicación entre la instancia de Commerce, el servicio de catálogo y otros servicios de soporte. La sincronización de datos está controlada por la extensión de exportación de datos SaaS.

  1. Configure Commerce Services Connector especificando las claves de API y seleccionando un espacio de datos SaaS.

    La configuración del Conector de servicios de Commerce es un proceso único necesario para utilizar servicios de Adobe Commerce como el Servicio de catálogo, Live Search y Recommendations de productos. Si ya ha configurado el conector para otro servicio, omita este paso.

  2. Realice una sincronización de datos inicial desde el panel de administración de datos.

    La sincronización inicial puede tardar entre unos minutos y horas según el tamaño del catálogo. Puede monitorizar el estado de sincronización desde el panel de control de Data Management. Después de la sincronización inicial, el catálogo exporta datos de productos de forma continua para mantener los servicios actualizados.

    note note
    NOTE
    También puede iniciar la sincronización inicial desde la línea de comandos utilizando la CLI de Commerce. Consulte Sincronización inicial en la Guía de exportación de datos SaaS.

Para asegurarse de que la exportación del catálogo se ejecuta correctamente:

  • Confirme que los trabajos cron se están ejecutando.
  • Compruebe que los indexadores se estén ejecutando desde Admin o mediante el comando bin/magento indexer:info de la CLI de Commerce.
  • Compruebe que los indizadores Catalog Attributes Feed, Product Feed, Product Overrides Feed y Product Variant Feed estén establecidos en Update by Schedule.

Monitorización y solución de problemas de sincronización de datos

Desde Commerce Admin, puede supervisar el proceso de sincronización mediante el tablero de administración de datos. Use la CLI de Commerce y los registros para administrar y solucionar problemas del proceso.

Acceso al servicio

Se puede acceder a la API de GraphQL Catalog Service desde el extremo https://catalog-service.adobe.io/graphql mediante comandos del POST a través de HTTPS.

En las consultas de GraphQL, debe especificar varios encabezados HTTP, incluida la clave de API pública que agregó a la configuración del Conector de servicios de Adobe Commerce en Admin. Para obtener más información, consulte la Documentación de servicios de tienda GraphQL.

Configuración del cortafuegos

Para permitir que Catalog Service pase a través de un firewall, agregue commerce.adobe.io a la lista de permitidos.

Servicio de catálogo y malla de API

La malla de API para Adobe Developer App Builder permite a los desarrolladores integrar API privadas o de terceros y otras interfaces con productos de Adobe mediante E/S de Adobe.

Consulte el tema Catalog Service y API Mesh para obtener detalles de instalación y configuración.

Tablero de administración de datos

Para obtener más información acerca de la sincronización de datos de Catalog Service, consulte Panel de administración de datos.

7c786b3e-f793-4e26-b38a-3fe76d8eca72