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:

   Copy
   composer require magento/commerce-eventing=^1.0 --no-update
   Copied to your clipboard
   composer require magento/commerce-eventing=^1.0 --no-update

   Commerce 2.4.6 and later loads these modules automatically.

2. Update the project dependencies.

   Copy
   composer update
   Copied to your clipboard
   composer update

3. Enable the new modules:

   Copy
   bin/magento module:enable Magento_AdobeCommerceEventsClient Magento_AdobeCommerceEventsGenerator Magento_AdobeIoEventsClient Magento_AdobeCommerceOutOfProcessExtensibility
   Copied to your clipboard
   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.

   Copy
   bin/magento events:generate:module
   Copied to your clipboard
   bin/magento events:generate:module

2. Enable the generated module:

   Copy
   bin/magento module:enable Magento_AdobeCommerceEvents
   Copied to your clipboard
   bin/magento module:enable Magento_AdobeCommerceEvents

3. Upgrade your instance:

   Copy
   bin/magento setup:upgrade
   Copied to your clipboard
   bin/magento setup:upgrade

4. Compile your instance to generate new classes:

   Copy
   bin/magento setup:di:compile
   Copied to your clipboard
   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:

   Copy
   git add app/etc/config.php
   Copied to your clipboard
   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:

   Copy
   stage:
      global:
         ENABLE_EVENTING: true
   Copied to your clipboard
   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:

   Copy
   composer update magento/commerce-eventing --with-dependencies
   Copied to your clipboard
   composer update magento/commerce-eventing --with-dependencies

2. Upgrade Commerce:

   Copy
   bin/magento setup:upgrade
   Copied to your clipboard
   bin/magento setup:upgrade

3. Clear the cache:

   Copy
   bin/magento cache:clean
   Copied to your clipboard
   bin/magento cache:clean

4. Compile the dependencies:

   Copy
   bin/magento setup:di:compile
   Copied to your clipboard
   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.

Copy
composer update magento/commerce-eventing --with-dependencies
Copied to your clipboard
composer update magento/commerce-eventing --with-dependencies

Last updated 12/12/2023

Was this helpful?

Yes

No