DocumentaciónCommerce“Guía de Catalog Service”

Incorporación e instalación

Last update: Thu Jun 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador

Instale el servicio de catálogo para solicitar y recibir datos de producto de una instancia de Commerce mediante 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 utiliza para pruebas y validación antes de activarse
  • Producción (https://catalog-service.adobe.io/graphql): se utiliza 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 empezar con Catalog Service para Adobe Commerce, se requieren los siguientes pasos:

  • Instale 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

style
shade-box

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 compositor desde el repo.magento.com repositorio.

Infraestructura en nube

Utilice este método para instalar Catalog Adapter 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 la administración local de entornos de proyecto de Commerce, consulte Administración de ramas con CLI en el Guía del usuario de Adobe Commerce sobre infraestructura en la nube.

  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 Adaptador de catálogo.

    code language-bash 
    composer require magento/catalog-adapter --no-update

  4. Actualizar dependencias del paquete.

    code language-bash 
    composer update "magento/catalog-adapter"

  5. Confirmar y enviar cambios de código para el composer.json y composer.lock archivos.

  6. Añada, confirme e inserte los cambios de código para el composer.json y composer.lock al entorno de nube.

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

    Al insertar las actualizaciones en el entorno de la nube, se inicia el Proceso de implementación de Commerce Cloud para aplicar los cambios. Compruebe el estado de implementación desde el implementar registro.

On-Premise

Utilice este método para instalar Catalog Adapter 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-adapter --no-update

  2. Actualice las dependencias e instale la extensión:

    code language-bash 
    composer update  "magento/catalog-adapter"

  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 el Catalog Service, complete las siguientes tareas para integrar el servicio de catálogo con la 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.

  1. Configure las variables Conector de Commerce Services especificando las claves 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 Tablero 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 el Guía de exportación de datos de 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 el Administrador o utilizando el comando CLI de Commerce bin/magento indexer:info.
  • Compruebe que la variable Catalog Attributes Feed, Product Feed, Product Overrides Feed, y Product Variant Feed los indexadores se establecen en Update by Schedule.

Acceso al servicio

El Catalog Service La API de GraphQL es accesible desde https://catalog-service.adobe.io/graphql extremo que utiliza 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 GraphQL de servicios de tienda documentación.

Configuración del cortafuegos

Para permitir Catalog Service a través de un cortafuegos, añada commerce.adobe.io a la lista de permitidos.

Servicio de catálogo y malla de API

El Malla de API para el Generador de aplicaciones de Adobe Developer permite a los desarrolladores integrar API privadas o de terceros y otras interfaces con productos de Adobe mediante Adobe IO.

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

Tablero de administración de datos

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

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