Dokumentation Commerce Adobe Commerce as a Cloud Service

Förutsättningar

Last update: Mon Mar 23 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Appbyggare
Moln

Skapat för:

Mellanliggande
Utvecklare

På den här sidan visas förutsättningarna och konfigurationsstegen för Adobe Commerce as a Cloud Service-självstudiekurser, t.ex. självstudiekursen för klassificeringstillägg och självstudiekursen för leveransmetodtillägg.

Allmänna krav

Följande verktyg krävs för både tillägg och butiksutveckling i den här självstudiekursen.

Node.js (version 22.x.x) och npm (9.0.0 eller senare): Verifiera installationen med följande kommando:

code language-bash
`node --version npm --version`

Installera Git - Verifiera installationen:

code language-bash
`git --version`

Bash-skal
- macOS/Linux: Ingen installation krävs
- Windows: Använd Git Bash eller Windows Subsystem för Linux (WSL)
Hämta en AI-assisterad IDE, till exempel Markör (rekommenderas). Även andra utvecklingsmiljöer, som Claude Code, Gemini CLI och Copilot, stöds, men kan kräva ändringar av instruktioner och andra steg i självstudiekursen.

Krav för Adobe Commerce as a Cloud Service

Installera Adobe I/O CLI

code language-bash
`npm install -g @adobe/aio-cli`

Installera plugin-programmen Adobe I/O CLI Commerce, Adobe I/O CLI Runtime och App Builder CLI:

code language-bash
`aio plugins:install https://github.com/adobe-commerce/aio-cli-plugin-commerce @adobe/aio-cli-plugin-app-dev @adobe/aio-cli-plugin-runtime`

När du har installerat Adobe I/O CLI och de plugin-program som krävs konfigurerar du arbetsytan för utökningsmöjligheter. Adobe rekommenderar att du använder den automatiska installationen för att få en snabbast möjliga upplevelse.

Automatiserad installation (rekommenderas) - Kör ett kommando för att konfigurera arbetsytan automatiskt.
Manuell konfiguration - Följ stegvisa instruktioner för att konfigurera varje komponent individuellt.

Automatiserad installation (rekommenderas) automated-setup

TIP

Om du råkar ut för problem med den automatiska konfigurationen följer du stegen nedan i manuell konfiguration.

Kommandot app-setup automatiserar konfigureringsprocessen för arbetsytan, inklusive att skapa ett Adobe Developer Console-projekt, lägga till nödvändiga API:er, konfigurera Adobe I/O CLI, klona startpaketet, ansluta den lokala arbetsytan och installera AI-verktygen för utbyggbarhet.

Kommandot app-setup vägleder dig genom följande steg:

Välja eller skapa ett Adobe Developer Console-projekt med de nödvändiga API:erna
Konfigurerar Adobe I/O CLI med din organisation, ditt projekt och din arbetsyta
Klona rätt startpaket och konfigurera projektet
Konfigurera miljön och ansluta den lokala arbetsytan till fjärrarbetsytan
Installera Commerce utökningsverktyg och kodningsagentfärdigheter

Kör följande kommando och följ de interaktiva anvisningarna:

aio commerce extensibility app-setup

När kommandot har slutförts går du till projektkatalogen och startar om kodningsagenten för att läsa in de nya MCP-verktygen och kunskaperna. Om din självstudiekurs kräver en butik kör du kommandot igen och väljer startsatsen AEM Boilerplate Commerce.

I följande exempelinstallation visas interaktiva uppmaningar och utdata för startpaketet för utcheckningen.

Exempelinstallation (startkit för utcheckning)

code language-shell-session

code language-shell-session
aio commerce extensibility app-setup 🚀 Adobe Commerce Extensibility App Setup ✔ Logged in 📁 Working directory: /Users/username/projects/my-commerce-project ✔ Which starter kit would you like to use? Checkout Starter Kit ✔ Enter a name for your project directory: my-extension ✔ Which coding agent would you like to install the skills for? Cursor 📦 Cloning Checkout Starter Kit... ✔ Repository cloned Using npm (package-lock.json found) ✔ Dependencies installed 📋 Current Adobe I/O Console configuration: Org: My Organization (1234567) Project: My Commerce Project (1234567890123456789) Workspace: Stage (9876543210987654321) ✔ Do you want to continue with this configuration? (Answer "No" to select a different org/project/workspace) No 🔧 Selecting Adobe I/O Console org, project, and workspace... ? Select Org: My Organization Org selected My Organization You are currently in: 1. Org: My Organization 2. Project: <no project selected> 3. Workspace: <no workspace selected> ? Select Project: My Commerce Project Project selected : My Commerce Project You are currently in: 1. Org: My Organization 2. Project: My Commerce Project 3. Workspace: <no workspace selected> ? Select Workspace: Stage Workspace selected Stage You are currently in: 1. Org: My Organization 2. Project: My Commerce Project 3. Workspace: Stage ✅ Console configured: Org: My Organization Project: My Commerce Project Workspace: Stage 🔐 Configuring workspace credentials and services... ✔ Workspace configuration loaded ✔ OAuth server-to-server credentials already configured ✔ All required services available in organization ✔ Subscribed to: Adobe Commerce as a Cloud Service 📋 Configuring Checkout Starter Kit... Creating .env from env.dist... ✔ Select tenant (type to search) My Commerce Instance: https://<region>.api.commerce.adobe.com/<tenant-id>/graphql ✔ Commerce instance configured ✔ Enter the event prefix for your workspace: my-prefix ✔ Workspace IDs configured ✔ OAuth credentials configured ✔ Checkout Starter Kit configured 🔧 Installing Commerce Extensibility tools and agent skills... ✔ Commerce Extensibility tools installed 🎉 App setup complete! 📁 Project directory: /Users/username/projects/my-commerce-project/my-extension Next steps: 1. cd into your project directory 2. Restart your coding agent to load the Commerce Extensibility tools and skills

aio commerce extensibility app-setup

🚀 Adobe Commerce Extensibility App Setup

✔ Logged in
📁 Working directory: /Users/username/projects/my-commerce-project

✔ Which starter kit would you like to use? Checkout Starter Kit
✔ Enter a name for your project directory: my-extension
✔ Which coding agent would you like to install the skills for? Cursor

📦 Cloning Checkout Starter Kit...
   ✔ Repository cloned
   Using npm (package-lock.json found)
   ✔ Dependencies installed

📋 Current Adobe I/O Console configuration:
   Org: My Organization (1234567)
   Project: My Commerce Project (1234567890123456789)
   Workspace: Stage (9876543210987654321)
✔ Do you want to continue with this configuration? (Answer "No" to select a different org/project/workspace)
No

🔧 Selecting Adobe I/O Console org, project, and workspace...

? Select Org: My Organization
Org selected My Organization
You are currently in:
1. Org: My Organization
2. Project: <no project selected>
3. Workspace: <no workspace selected>

? Select Project: My Commerce Project
Project selected : My Commerce Project
You are currently in:
1. Org: My Organization
2. Project: My Commerce Project
3. Workspace: <no workspace selected>

? Select Workspace: Stage
Workspace selected Stage
You are currently in:
1. Org: My Organization
2. Project: My Commerce Project
3. Workspace: Stage

✅ Console configured:
   Org: My Organization
   Project: My Commerce Project
   Workspace: Stage

🔐 Configuring workspace credentials and services...
   ✔ Workspace configuration loaded
   ✔ OAuth server-to-server credentials already configured
   ✔ All required services available in organization
   ✔ Subscribed to: Adobe Commerce as a Cloud Service

📋 Configuring Checkout Starter Kit...
   Creating .env from env.dist...
✔ Select tenant (type to search) My Commerce Instance:
https://<region>.api.commerce.adobe.com/<tenant-id>/graphql
   ✔ Commerce instance configured
✔ Enter the event prefix for your workspace: my-prefix
   ✔ Workspace IDs configured
   ✔ OAuth credentials configured
   ✔ Checkout Starter Kit configured

🔧 Installing Commerce Extensibility tools and agent skills...
   ✔ Commerce Extensibility tools installed

🎉 App setup complete!

📁 Project directory: /Users/username/projects/my-commerce-project/my-extension

Next steps:
   1. cd into your project directory
   2. Restart your coding agent to load the Commerce Extensibility tools and skills

Manuell konfiguration manual-setup

I följande avsnitt beskrivs hur du konfigurerar varje komponent på arbetsytan för utökningsmöjligheter manuellt. Följ de här stegen om du föredrar manuell konfiguration eller om du stöter på problem med den automatiska konfigurationen.

Krav för Adobe Developer Console

Konfigurera ett projekt i Adobe Developer Console med de nödvändiga API:erna och autentiseringsuppgifterna.

Gå till Adobe Developer Console.
Logga in med din e-postadress och ditt lösenord.

Skapa ett nytt projekt

Skapa ett App Builder-projekt i Adobe Developer Console som värd för ditt tillägg.

Navigera till Adobe Developer Console.
Klicka på Create project from a template.
Välj mallen App Builder.
Ange Project Title och App Name.
Kontrollera att kryssrutan Include Runtime är markerad.

{width="600" modal="regular"}
Klicka på Save.

Lägg till API:er på arbetsytan

Lägg till nödvändiga API:er på scenarbetsytan för händelsehantering och integrering med Commerce.

Klicka på arbetsytan Stage och upprepa sedan följande steg för varje API.

{width="600" modal="regular"}
Klicka på Add Service och välj API.
Välj någon av följande API:er. Upprepa den här processen för varje API som visas nedan:
- Adobe Services-filter:
  - I/O Management API
  - API för I/O Events
- Experience Cloud-filter:
  - API för Adobe I/O Events for Adobe Commerce
Klicka på Next.
Klicka på Save configured API.
Upprepa föregående steg tills du lägger till alla API:er på arbetsytan.

{width="600" modal="regular"}

Konfigurera Adobe I/O CLI

Anslut Adobe I/O CLI till din organisation, ditt projekt och din arbetsyta.

Rensa befintlig konfiguration:

code language-bash
`aio config clear`

Logga in med Adobe I/O CLI:

code language-bash
`aio auth login -f`

Välj organisation, projekt och arbetsyta med hjälp av följande kommandon:

code language-bash
`aio console org select`

code language-bash
`aio console project select`

code language-bash
`aio console workspace select`

Terminal som visar Adobe I/O CLI-organisationsprojekt och val av arbetsyta {width="600" modal="regular"}

Klona startkit

Klona en av följande Commerce startkit-databaser för det tillägg du håller på att bygga och förbereda ditt projekt:

Startpaket för integrering:

git clone https://github.com/adobe/commerce-integration-starter-kit.git extension
cd extension

Startpaket för kassan:

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension

Startpaket för integrering

Skapa en .env-fil

Skapa din miljökonfigurationsfil:

code language-bash
`cp env.dist .env`

Öppna filen .env i en textredigerare och lägg till följande OAuth-autentiseringsuppgifter:

code language-bash
`OAUTH_CLIENT_ID= OAUTH_CLIENT_SECRET= OAUTH_TECHNICAL_ACCOUNT_ID= OAUTH_TECHNICAL_ACCOUNT_EMAIL= OAUTH_ORG_ID=`

Kopiera dessa värden från sidan Credential details i Developer Console genom att klicka på fliken OAuth Server-to-Server på arbetsytan.

Autentiseringssidan för OAuth Server-till-Server i Adobe Developer Console {width="600" modal="regular"}

Lägg till Commerce-konfigurationen

Lägg till följande Commerce-instansinformation i din .env-fil:

code language-bash
`COMMERCE_BASE_URL= COMMERCE_GRAPHQL_ENDPOINT=`

Så här hittar du dessa värden:

Navigera till Commerce Cloud Service-instanser.
Klicka på informationsikonen bredvid instansen.
Kopiera REST-slutpunkten som COMMERCE_BASE_URL.
Kopiera GraphQL-slutpunkten som COMMERCE_GRAPHQL_ENDPOINT.

Ange händelseprefix

Ange ett tillfälligt värde för händelseprefixet:

code language-bash
`EVENT_PREFIX=test`

Hämta arbetsytans konfiguration

Kör följande kommando för att hämta arbetsytans konfigurationsfil:

code language-bash
`aio console workspace download workspace.json`

Kopiera arbetsytans konfigurationsfil till katalogen scripts:

code language-bash
`cp workspace.json scripts/`

Ansluta den lokala arbetsytan till fjärrarbetsytan

Länka ditt lokala projekt till den fjärranslutna arbetsytan:

code language-bash
`aio app use workspace.json -m`

Terminalen visar en lyckad arbetsyteanslutning med AIR-appkommandot {width="600" modal="regular"}

Startpaket för utcheckning

Ansluta den lokala arbetsytan till fjärrarbetsytan

Länka det lokala projektet till fjärrarbetsytan. Kör från projektets rot (mappen extension):

code language-bash
`aio app use --merge`

När du uppmanas till det väljer du det alternativ som använder den organisation, det projekt och den arbetsyta du valde när du konfigurerade Adobe I/O CLI. Detta skriver arbetsytans konfiguration i programmet så att den arbetsytan används vid distributionen och den lokala utvecklingen.

Terminalen visar en lyckad arbetsyteanslutning med AIR-appkommandot {width="600" modal="regular"}

Installera AI-verktygen för utökningsbarhet

Den här processen skapar MCP-konfigurationen (.<agent>/mcp.json), kompetenskatalogen (.<agent>/skills/) och lägger till AGENTS.md i projektets rot. Du uppmanas att välja ett startpaket, en kodningsagent och en pakethanterare.

Konfigurera AI-stödda utvecklingsverktyg i mappen extension med följande kommandon:

code language-bash
`cd extension`

code language-bash
`aio commerce extensibility tools-setup`

Terminal som visar AI-verktyg för utökningsverktyg för att konfigurera utdata {width="600" modal="regular"}

När installationen är klar startar du om kodningsagenten så att den kan läsa in de nya MCP-verktygen och -kunskaperna. Commerce App Builder-verktygen finns nu i din miljö.

note note
NOTE
Om du ser ett varningsmeddelande om att inga kunskaper hittades för startpaketet gick något fel. Det beror ofta på att konfigurationen kördes i en annan mapp än där startsatsen klonades. Kör `aio commerce extensibility tools-setup` från mappen `extension` (startkit-projektroten) och välj rätt startkit när du uppmanas till detta.

Terminal som visar konfiguration av AI-utökningsverktyg med utcheckningsstartsverktyget valt {width="600" modal="regular"}

Manuell inställning för Stock

I det här avsnittet beskrivs hur du konfigurerar din butik manuellt för självstudiekursen Ratings extension och andra självstudiekurser för butiker.

Om du vill konfigurera din butik automatiskt kör du kommandot app-setup som beskrivs i avsnittet Automatiserad installation och väljer AEM Boilerplate Commerce startsats.

Förutsättningar

Följande objekt krävs för att slutföra avsnittet storefront i självstudiekursen Ratings extension och visa produktbetyg i din butik.

Google Chrome - krävs för att testa butiken
Ett butiksprojekt som är anslutet till din Commerce-instans. Om du inte har något storefront-projekt följer du stegen i Skapa en storefront, inklusive avsnittet Länka repo till handelsdata.

Klona butiksarkivet

Öppna terminalen och klona databasen:

git clone https://github.com/hlxsites/aem-boilerplate-commerce.git storefront
cd storefront

Installera beroenden

Installera projektberoenden:

npm install

Installera storefront AI-verktygen

Konfigurera AI-stödda utvecklingsverktyg i mappen storefront.

Kör följande kommando från roten i mallprojektet. Kommandot installerar @adobe-commerce/commerce-extensibility-tools-paketet som ett dev-beroende, kopierar kunskapsfilerna till din agentes kunskapsregister och konfigurerar MCP (Model Context Protocol) så att din agent får tillgång till sökverktygen i Commerce-dokumentationen.

aio commerce extensibility tools-setup

Kommandot visar två instruktioner:

Välj ett startpaket - Välj AEM-standardpaket för Commerce.
Välj din kodningsagent - Välj din agent i listan med agenter som stöds.

recommendation-more-help

0961bf7c-1df8-4da1-8be1-cb5465eed8fb