@aligent/serverless-magento
TypeScript icon, indicating that this package has built-in type declarations

0.1.0 • Public • Published

Serverless Magento

A Serverless framework plugin for handling the registration of a microservices with the magento2-microservice-config module.

Why?

Microservices registered with the magento2-microservice-config module will have a Magento authentication token made available via AWS SSM. This removes the need to manually create Magento integrations / access tokens for each service. The registration also provides the opportunity to create an "admin" interface within the Magento admin interface which can be used for managing the serverless application.

Admin Interface

The admin interface is provided as a link to an externally hosted web application which is rendered in the Magento admin interface as an iframe. Authorisation context will be injected into the iframe when loaded.

Deployment

The Serverless plugin will initially register with the magento2-microservice-config REST API. At this state the service is "registered" but not "active". A service does not become "active" until an admin user approves it.

Serverless configuration

The plugin is configured within the serverless.yaml by providing configuration values.

Example

custom:
  serviceRegistration:
    magentoUrl: https://magento.domain.name
    magentoApiToken: ${ssm:/magento/api/access-token-for-registration}
    displayName: Service name that appears in Magento Admin
    permissions:
      - Magento_Backend::all

Variables

Variable Type Usage
magentoUrl string The base URL - including scheme - of the Magento instance.
magentoApiToken string The api token for registering with Magento instance.
displayName string The name of the application/service.
description string Short description about the application/service. If not provided, resources/Description will be used
permission string Array of Magento permission. Webapp does not need this.
domainOutputKeyPrefix string The prefix of webapp domain output key. The default value is landingDomain.
errorOnFailure boolean Whether the plugin should throw an error when a call to the Magento instance fails. The default value is true

Readme

Keywords

none

Package Sidebar

Install

npm i @aligent/serverless-magento

Weekly Downloads

4

Version

0.1.0

License

MIT

Unpacked Size

46.8 kB

Total Files

4

Last publish

Collaborators

  • torbjorn.vanheeswijck
  • aligent-bot
  • aligent-danielvanderploeg
  • luke-denton-aligent
  • jarrod.swift