Flexible composition lets development teams within an organization work separately to create and deploy multiple EdgeWorkers for the same website.

📘

Sign up for the Flexible Composition Beta program

Flexible composition is now available for you to use as part of a Beta program. At the moment you need to contact your Akamai representative to opt-in to this new feature.

With flexible composition two or more EdgeWorkers can handle a single request. The logic for handling the request can be developed, tested, debugged, activated, and monitored by several teams. This is ideal for larger organizations that want to:

• Reuse code across multiple EdgeWorkers - Create a library EdgeWorker that other teams can use to perform common functionality, such as verifying an authorization header.
• Delegate to other EdgeWorkers - Configure the parent EdgeWorker to choose another child to run based on the path of the request.
• Wrap API Endpoints - Encapsulate implementation decisions inside an EdgeWorkers function and use it to modify the implementation of the API endpoint.

This package management solution runs on the Akamai staging and production networks. It enables one EdgeWorker to depend on another EdgeWorker via a dependency list. Dependencies are automatically pulled in to create a combined code bundle. When a child is updated the parent is automatically updated too.

The diagram below shows the parent EdgeWorker receiving a request. It then calls into the child EdgeWorkers, Marketing and Security. In this example two different teams created and activated the child EdgeWorkers using their preferred tools. The parent EdgeWorker can only import an activated child EdgeWorker. If a new version of a child EdgeWorker is activated, the parent EdgeWorker will be dynamically reactivated. This lets teams work independently to add new capabilities to a website.

To learn more go to, Create a parent EdgeWorker and Add a child EdgeWorker to an existing parent.

📘

You can use the EdgeWorkers Management application or the EdgeWorkers APIs to perform tasks related to flexible composition.

Benefits of flexible composition

Flexible composition accommodates organizations that have several development teams. Review these benefits to learn more about how you can use this capability to improve your EdgeWorkers development process.

• Independent contribution - Each team can work at its own pace. You can activate a new version of your EdgeWorkers function anytime you need to add content to the website. You don't need to coordinate with other teams.

• Dynamic activation - The parent EdgeWorker automatically receives updates. The owner doesn't need to rebuild, upload, or run a CI pipeline to activate it.

• Import EdgeWorkers as separate files - Each child EdgeWorker is represented as a JavaScript module.

• Friction-free code reuse - Child EdgeWorkers can export any type of JavaScript object, including classes and functions.

• Choose your developer tools - Each team in your organization can use the developer tools they prefer. If you want to build your EdgeWorkers in TypeScript, you can do so without having to integrate into a larger build chain.

Permissions

By default, the security access model grants any parent EdgeWorkers access to child EdgeWorkers created under the same account. This is provided that the team that created the combined code bundle has Publisher - writeActivationEdgeWorker permission on the parent EdgeWorker and Viewer - readVersionEdgeWorker permission on transitive dependencies.

📘

For more information refer the to Manage access to EdgeWorkers section in this guide.

Product limits

These limits apply to EdgeWorkers functions created using flexible composition. The existing EdgeWorkers Product limits also apply.

📘

Refer to the Terminology section in this guide to learn more about the concepts and terms used for flexible composition.