DokumentationCommerceAdobe Commerce as a Cloud Service

Voraussetzungen für das Tutorial

Last update: Wed Feb 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Fortgeschrittener
  • Entwickler

Auf dieser Seite werden die Voraussetzungen und Einrichtungsschritte für Adobe Commerce as a Cloud Service Tutorials aufgelistet, z. B​ das Tutorial zur Erweiterung von Bewertungen ​ das Tutorial Erweiterung der Versandmethode.

Voraussetzungen für Adobe Commerce as a Cloud Service

  • Installieren des Adobe I/O CLI

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

  • Installieren Sie die Plug-ins Adobe I/O CLI Commerce, Adobe I/O CLI Runtime und 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

  • Herunterladen einer KI-unterstützten IDE wie Cursor (empfohlen), andere IDEs wie Claude Code, Gemini CLI oder Copilot werden ebenfalls unterstützt, könnten jedoch Änderungen an den Eingabeaufforderungen und anderen Schritten im Tutorial erfordern.

Voraussetzungen für Adobe Developer Console

  1. Navigieren Sie zur Adobe Developer Console.
  2. Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem Passwort an.

Neues Projekt erstellen

  1. Navigieren Sie zu Adobe Developer Console.

  2. Klicken Sie Projekt aus einer Vorlage erstellen.

  3. Wählen Sie die Vorlage App Builder aus.

  4. Geben Sie einen Projekttitel und App-Namen ein.

  5. Stellen Sie sicher, dass das Kontrollkästchen Include Runtime markiert ist.

    Adobe Developer Console-Projekterstellung mit ausgewählter App Builder-Vorlage {width="600" modal="regular"}

  6. Klicken Sie Speichern.

Hinzufügen von APIs zum Arbeitsbereich

  1. Klicken Sie auf Staging-Arbeitsbereich und wiederholen Sie dann die folgenden Schritte für jede API.

    Staging-Arbeitsbereich mit Option „Service hinzufügen“ für APIs {width="600" modal="regular"}

  2. Klicken Sie auf Service hinzufügen und wählen Sie API aus.

  3. Wählen Sie eine der folgenden APIs aus. Sie müssen diesen Vorgang für jede der unten aufgeführten APIs wiederholen:

    • Adobe Services-Filter:

      • I/O-Management-API
      • I/O Events API

    • Experience Cloud-Filter:

      • Adobe I/O Events für Adobe Commerce-API

  4. Klicken Sie Weiter.

  5. Klicken Sie Konfigurierte API speichern.

  6. Wiederholen Sie die vorherigen Schritte, bis alle APIs zum Arbeitsbereich hinzugefügt wurden.

    Workspace mit allen erfolgreich hinzugefügten erforderlichen APIs {width="600" modal="regular"}

Konfigurieren der Adobe I/O-CLI

  1. Löschen Sie eine vorhandene Konfiguration:

    code language-bash 
    aio config clear

    Melden Sie sich mit dem Adobe I/O CLI an:

    code language-bash 
    aio auth login -f

  2. Wählen Sie Ihre Organisation, Ihr Projekt und Ihren Arbeitsbereich mithilfe der folgenden Befehle aus:

    code language-bash 
    aio console org select
    code language-bash 
    aio console project select
    code language-bash 
    aio console workspace select

    Terminal mit Auswahl der Adobe I/O CLI-Organisationsprojekte und des Arbeitsbereichs {width="600" modal="regular"}

Klonen der Starter Kits

Klonen Sie eines der folgenden Commerce Starter Kit-Repositorys für die Erweiterung, die Sie erstellen, und bereiten Sie Ihr Projekt vor:

Integrations-Starter-Kit:

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

Checkout-Starterkit:

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

Erstellen einer .env-Datei

Erstellen Sie die Konfigurationsdatei Ihrer Umgebung:

code language-bash 
cp env.dist .env

Öffnen Sie die .env in einem Texteditor und fügen Sie die folgenden OAuth-Anmeldeinformationen hinzu:

code language-shell-session 
OAUTH_CLIENT_ID=
OAUTH_CLIENT_SECRET=
OAUTH_TECHNICAL_ACCOUNT_ID=
OAUTH_TECHNICAL_ACCOUNT_EMAIL=
OAUTH_ORG_ID=

Sie können diese Werte von der Credential details in Developer Console kopieren indem Sie auf die Registerkarte OAuth Server-to-Server in Ihrem Arbeitsbereich klicken.

Seite mit OAuth Server-zu-Server-Anmeldeinformationen in Adobe Developer Console {width="600" modal="regular"}

Hinzufügen der Commerce-Konfiguration

Fügen Sie die folgenden Commerce-Instanzdetails zu Ihrer .env hinzu:

code language-shell-session 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

So suchen Sie diese Werte:

  1. Navigieren Sie zu Commerce Cloud Service-Instanzen.
  2. Klicken Sie auf das Informationssymbol neben Ihrer Instanz.
  3. Kopieren Sie den REST-Endpunkt nach COMMERCE_BASE_URL.
  4. Kopieren Sie den GraphQL-Endpunkt nach COMMERCE_GRAPHQL_ENDPOINT.

Festlegen des Ereignispräfixes

Legen Sie einen temporären Wert für das Ereignispräfix fest:

code language-shell-session 
EVENT_PREFIX=test

Workspace-Konfiguration herunterladen

Führen Sie den folgenden Befehl aus, um die Workspace-Konfigurationsdatei herunterzuladen:

code language-bash 
aio console workspace download workspace.json

Kopieren Sie die Workspace-Konfigurationsdatei in das scripts:

code language-bash 
cp workspace.json scripts/

Lokalen Arbeitsbereich mit Remote-Arbeitsbereich verbinden

Verknüpfen des lokalen Projekts mit dem Remote-Arbeitsbereich:

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

Terminal, das eine erfolgreiche Arbeitsbereich-Verbindung mit dem AIO-Programm-Anwendungsbefehl anzeigt {width="600" modal="regular"}

Checkout-Starterkit

Lokalen Arbeitsbereich mit Remote-Arbeitsbereich verbinden

Verknüpfen des lokalen Projekts mit dem Remote-Arbeitsbereich. Führen Sie im Stammverzeichnis des Projekts (extension Ordner) Folgendes aus:

code language-bash 
aio app use --merge

Wählen Sie bei Aufforderung die Option aus, die die Organisation, das Projekt und den Arbeitsbereich verwendet, die Sie beim Konfigurieren der Adobe I/O-CLI ausgewählt haben. Dadurch wird die Workspace-Konfiguration in Ihre App geschrieben, damit sie bereitgestellt und für die lokale Entwicklung verwendet werden kann.

Terminal, das eine erfolgreiche Arbeitsbereich-Verbindung mit dem AIO-Programm-Anwendungsbefehl anzeigt {width="600" modal="regular"}

Installieren von Erweiterbarkeits-KI-Tools

Dieser Prozess erstellt die MCP-Konfiguration (.<agent>/mcp.json), das Skills-Verzeichnis (.<agent>/skills/) und fügt AGENTS.md zum Projektstamm hinzu. Sie werden aufgefordert, ein Starter Kit, einen Codierungsagenten und einen Package Manager auszuwählen.

  1. Richten Sie die KI-unterstützten Entwicklungstools mithilfe der folgenden Befehle im Ordner "extension" ein:

    code language-bash 
    cd extension
    code language-bash 
    aio commerce extensibility tools-setup

    Terminal mit der Befehlsausgabe für die Einrichtung von KI-Erweiterbarkeitstools {width="600" modal="regular"}

  2. Starten Sie nach Abschluss des Setups Ihren Codierungsagenten neu, damit er die neuen MCP-Tools und -Kenntnisse laden kann. Die Commerce App Builder-Tools sind jetzt in Ihrer Umgebung verfügbar.

    note note
    NOTE
    Wenn eine Warnung angezeigt wird, dass keine Kenntnisse für das Starter Kit gefunden wurden, ist ein Fehler aufgetreten - häufig, weil das Setup in einem anderen Ordner als dem, in dem das Starter Kit geklont wurde, ausgeführt wurde. Führen Sie aio commerce extensibility tools-setup aus dem extension-Ordner (dem Stammverzeichnis des Starter Kit-Projekts) aus und wählen Sie das entsprechende Starter Kit aus, wenn Sie dazu aufgefordert werden.

    Terminal mit KI-Erweiterbarkeits-Tools-Setup mit ausgewähltem Checkout-Starter-Kit {width="600" modal="regular"}

recommendation-more-help
fce0ca22-edd1-4bad-ab1e-3070c2bf0b91