Install Adobe I/O Events for Adobe Commerce

Adobe I/O Events for Adobe Commerce requires Adobe Commerce 2.4.4 or higher.

Magento Open Source is not supported.

After you have created an App Builder project, you must install the Commerce modules that enable integrations with Adobe I/O Events.

Install Adobe I/O modules on Commerce

The following steps apply to both Adobe Commerce on cloud infrastructure and on-premises installations. Cloud customers must perform additional steps to configure the ece-tools package.

  1. If you are running Commerce 2.4.4 or 2.4.5, use the following command to load the eventing modules:

    composer require magento/commerce-eventing=^1.0 --no-update
    

    Commerce 2.4.6 and later loads these modules automatically.

  2. Update the project dependencies.

    composer update
    
  3. Enable the new modules:

    bin/magento module:enable Magento_AdobeCommerceEventsClient Magento_AdobeCommerceEventsGenerator Magento_AdobeIoEventsClient Magento_AdobeCommerceOutOfProcessExtensibility
    

On-premise installation

  1. Run the following command to initialize the AdobeCommerceEvents module. This module consists of generated plugins based on a list of subscribed events and helps publish and process events.

    bin/magento events:generate:module
    
  2. Enable the generated module:

    bin/magento module:enable Magento_AdobeCommerceEvents
    
  3. Upgrade your instance:

    bin/magento setup:upgrade
    
  4. Compile your instance to generate new classes:

    bin/magento setup:di:compile
    

Cloud configuration

Use the following steps to perform additional configuration for Adobe Commerce on cloud infrastructure:

  1. Add the app/etc/config.php file to your working repository:

    git add app/etc/config.php
    
  2. Run the composer info magento/ece-tools command to determine your version of ece-tools. If the version is less than 2002.1.13, update to the most recent version.

  3. Enable eventing in the .magento.env.yaml file:

    stage:
       global:
          ENABLE_EVENTING: true
    
  4. Commit and push updated files to the Cloud environment.

Update Adobe I/O Events for Adobe Commerce

Use the following procedure to update minor or patch versions of Adobe I/O Events for Adobe Commerce, such as from V1.3.0 to V1.4.0.

On-premise updates

  1. Run the following command to update the eventing modules:

    composer update magento/commerce-eventing --with-dependencies
    
  2. Upgrade Commerce:

    bin/magento setup:upgrade
    
  3. Clear the cache:

    bin/magento cache:clean
    
  4. Compile the dependencies:

    bin/magento setup:di:compile
    

Cloud updates

Run the following command to update the eventing modules. ECE tools performs the other steps required by on-premises installations.

composer update magento/commerce-eventing --with-dependencies