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.
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
Förutsättning
-
Åtkomst till repo.magento.com för att installera tillägget. Om du vill ha nyckelgenerering och de nödvändiga rättigheterna kan du läsa Hämta dina autentiseringsnycklar. Information om molninstallationer finns i Commerce on Cloud Infrastructure Guide
-
Åtkomst till kommandoraden på Adobe Commerce-programservern.
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.
Använd den här metoden om du vill installera Catalog Service för en Commerce Cloud-instans.
-
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. -
Kolla in miljögrenen för att uppdatera med Adobe Commerce Cloud CLI.
code language-shell magento-cloud environment:checkout <environment-id>
-
Lägg till katalogtjänstmodulen.
code language-bash composer require magento/catalog-service --no-update
-
Uppdatera paketberoenden.
code language-bash composer update "magento/catalog-service"
-
Genomför och push-kodsändringar för filerna
composer.json
ochcomposer.lock
. -
Lägg till, implementera och skicka kodändringarna för
composer.json
- ochcomposer.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.
Använd den här metoden för att installera Catalog Service för en lokal instans.
-
Använd Composer för att lägga till katalogtjänstmodulen i ditt projekt:
code language-bash composer require magento/catalog-service --no-update
-
Uppdatera beroenden och installera tillägget:
code language-bash composer update "magento/catalog-service"
-
Uppgradera Adobe Commerce:
code language-bash bin/magento setup:upgrade
-
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.
-
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.
-
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
ochProduct 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.