Act system

[mostafa]

Ticket(s)

• Implement signal, action and policy system #422
• Update to Go 1.22 #446
• Refactor termination policy #442

Description

This giant PR adds the very first version of the Act system that was proposed in this proposal. The old way of signaling was static and only supported a single signal: terminate. The new system supports more signals, adds proper policies that can be easily controlled by the users and the actions are executed in sync and async mode.

The Act system consists of these components:

1. Act Registry: takes care of registering signals, policies and actions. It also applies policies to signals to produce outputs for actions and runs actions using those outputs.
2. Signals: plugins' hooks can return signal(s) as part of their request/response. These signals tell GatewayD what to do.
3. Policies: signals pass through predefined policies that will decide whether GatewayD should react to the signal or not.
4. Actions: actions run in sync or async mode and perform a function. Sync actions are used to control traffic (passthrough, terminate, etc.) and other parts of the system, and async actions can other things (log, publish a message to Kafka, etc.).
5. Plugin Registry: after running a hook on each plugin, the signals are extracted and the policies are applied to those signals. The output of those policy evaluations are returned to the caller, which knows how to run action and use its results.

And the code spans over two projects:

1. GatewayD: all the above components of the Act system are in GatewayD.
2. SDK: types and helper functions for creating and exporting signals are in the SDK.

Breaking changes

The old way of terminating requests don't work anymore, as it was refactored in #442 and all the plugins are updated to pick up the changes.

Related PRs

N/A

Development Checklist

• I have added a descriptive title to this PR.
• I have squashed related commits together.
• I have rebased my branch on top of the latest main branch.
• I have performed a self-review of my own code.
• I have commented on my code, particularly in hard-to-understand areas.
• I have added docstring(s) to my code.
• I have made corresponding changes to the documentation (docs).
• I have added tests for my changes.
• I have signed all the commits.

Legal Checklist

• I have read the CONTRIBUTING document.
• I have read and understood the Code of Conduct.
• I have read and agreed to the Apache CLA (required).
• I have read and agreed to the LICENSE (required).