Onboarding och installation

Installera katalogtjänsten om du vill begära och ta emot produktdata från en Commerce-instans med katalogtjänstens GraphQL API. Katalogtjänsten levereras som ett dispositionsmetapaket från repo.magento.com.

NOTE
Om din Commerce-instans använder Live Search eller Product Recommendations installeras eller uppdateras katalogtjänsten automatiskt när du registrerar eller uppgraderar dessa tjänster. Mer information finns i installationsanvisningarna för Live Search och Product Recommendations.

Systemkrav

Programvarukrav

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

Plattformar som stöds

  • Adobe Commerce om molninfrastruktur: 2.4.4+
  • Adobe Commerce lokalt: 2.4.4+

Slutpunkter

Catalog Service har två slutpunkter tillgängliga för introduktion:

  • Sandbox (https://catalog-service-sandbox.adobe.io/graphql) - används för testning och validering innan live-körning
  • Produktion (https://catalog-service.adobe.io/graphql) - används för Live-trafik för Commerce handlare och webbplatser

Alla Commerce-testinstanser använder sandlådeslutpunkten.

Utför alla inläsningstester på sandlådeslutpunkten. Innan du börjar läsa in testningen skickar du en supportanmälan så att tjänstgruppen kan förutse den extra servertrafiken.

Installation och konfiguration

Följande steg krävs för att komma igång med Catalog Service för Adobe Commerce:

  • Installera katalogtjänsttillägget (magento/catalog-service)
  • Konfigurera tjänsten och dataexporten
  • Åtkomst till tjänsten

Installera katalogtjänsttillägget

recommendation-more-help

Förutsättning

Installera den senaste versionen av Catalog Services-tillägget (magento/catalog-service) på en Adobe Commerce-instans som kör Adobe Commerce version 2.4.4 eller senare. Katalogtjänsten levereras som ett dispositionsmetapaket från databasen repo.magento.com.

Molninfrastruktur

Använd den här metoden om du vill installera Catalog Service för en Commerce Cloud-instans.

  1. På din lokala arbetsstation byter du till projektkatalogen för ditt Adobe Commerce i molninfrastrukturprojekt.

    note note
    NOTE
    Mer information om att hantera Commerce projektmiljöer lokalt finns i Hantera grenar med CLI i Adobe Commerce on Cloud Infrastructure User Guide.
  2. Kolla in miljögrenen för att uppdatera med Adobe Commerce Cloud CLI.

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. Lägg till katalogtjänstmodulen.

    code language-bash
    composer require magento/catalog-service --no-update
    
  4. Uppdatera paketberoenden.

    code language-bash
    composer update "magento/catalog-service"
    
  5. Genomför och push-kodsändringar för filerna composer.json och composer.lock.

  6. Lägg till, implementera och skicka kodändringarna för composer.json- och composer.lock-filerna till molnmiljön.

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

    När uppdateringarna skickas till molnmiljön initieras Commerce molndistributionsprocess för att ändringarna ska tillämpas. Kontrollera distributionsstatusen från distributionsloggen.

Lokal

Använd den här metoden för att installera Catalog Service för en lokal instans.

  1. Använd Composer för att lägga till katalogtjänstmodulen i ditt projekt:

    code language-bash
    composer require magento/catalog-service --no-update
    
  2. Uppdatera beroenden och installera tillägget:

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

    code language-bash
    bin/magento setup:upgrade
    
  4. Rensa cachen:

    code language-bash
    bin/magento cache:clean
    
    note tip
    TIP
    I vissa fall, särskilt när du distribuerar till produktion, kanske du vill undvika att rensa kompilerad kod eftersom det kan ta en stund. Se till att du säkerhetskopierar systemet innan du gör några ändringar.

Konfigurera tjänsten och dataexporten

När du har installerat Catalog Service utför du följande åtgärder för att integrera katalogtjänsten med din Adobe Commerce-instans. Integreringen möjliggör datasynkronisering och kommunikation mellan Commerce-instansen, katalogtjänsten och andra stödtjänster. Datasynkronisering hanteras av SaaS-tillägget för dataexport.

  1. Konfigurera Commerce Services Connector genom att ange API-nycklar och välja ett SaaS-dataminne.

    Installation av Commerce Services Connector är en engångsprocess som krävs för att använda Adobe Commerce-tjänster som Catalog Service, Live Search och Product Recommendations. Om du redan har konfigurerat anslutningen för en annan tjänst hoppar du över det här steget.

  2. Utför en inledande datasynkronisering från Dashboard för datahantering.

    Den inledande synkroniseringen kan ta från några minuter till timmar beroende på katalogstorleken. Du kan övervaka synkroniseringsstatusen från kontrollpanelen för datahantering. Efter den första synkroniseringen exporterar katalogen produktdata fortlöpande för att hålla tjänsterna uppdaterade.

    note note
    NOTE
    Du kan också starta den inledande synkroniseringen från kommandoraden med Commerce CLI. Se Inledande synkronisering i Exportguiden för SaaS-data.

Så här ser du till att katalogexporten körs som den ska:

  • Bekräfta att seriejobben körs.
  • Verifiera att indexerarna körs från Admin eller genom att använda Commerce CLI-kommandot bin/magento indexer:info.
  • Kontrollera att indexerarna Catalog Attributes Feed, Product Feed, Product Overrides Feed och Product Variant Feed är inställda på Update by Schedule.

Övervaka och felsöka datasynkronisering

Från Commerce Admin kan du övervaka synkroniseringsprocessen med Dashboard för datahantering. Använd Commerce CLI och loggar för att hantera och felsöka processen.

Åtkomst till tjänsten

GraphQL-API:t Catalog Service är tillgängligt från slutpunkten https://catalog-service.adobe.io/graphql med hjälp av POST-kommandon via HTTPS.

I dina GraphQL-frågor måste du ange flera HTTP-huvuden, inklusive den offentliga API-nyckeln som du lade till i konfigurationen för Adobe Commerce Services Connector i Admin. Mer information finns i dokumentationen för Storefront Services GraphQL.

Brandväggskonfiguration

Om du vill tillåta Catalog Service genom en brandvägg lägger du till commerce.adobe.io i tillåtelselista.

Katalogtjänst och API-nät

Med API-nät för Adobe Developer App Builder kan utvecklare integrera privata eller tredjeparts-API:er och andra gränssnitt med Adobe-produkter med hjälp av Adobe IO.

Avsnittet Catalog Service och API Mesh innehåller information om installation och konfiguration.

Instrumentpanel för datahantering

Mer information om Catalog Service-datasynkronisering finns i Kontrollpanelen för datahantering.

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