Skip to content
README.md 2.93 KiB
Newer Older
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
# CAMARAaaS Add-on
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
The **CAMARA as a Service OSL Add-on** allows telecom operators and customer service providers to expose OSL services through CAMARA APIs. By doing so, it enables runtime operations, such as enforcing profiles on User Equipment (UEs) or updating 5G Network Slice characteristics, using standardized CAMARA API endpoints. Thus, this add-on enables the orchestration of CAMARA APIs, which will then be used to control the lifecyle and the operations that shall take place in an already existing OSL Service.
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
Therefore, these are the key features of this add-on:
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
- **Seamless Integration**: Operators can expose their existing OSL services through CAMARA APIs, maintaining consistency with the OSL framework while offering additional accessibility.
- **Dynamic Service Control**: Allows runtime updates to characteristics of 5G-related Services, such as UE profiles or Network Slices, via CAMARA REST API calls. The updated of the characteristics of a Service can then be consumed by a Kubernetes Custom Resource that will produce an operation according to the updated characteristics.
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
## Architecture and Interactions
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
The add-on introduces a generic **CAMARA API Service**, which acts as a wrapper for existing (running)  services. The architecture ensures:
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
1. **API Exposure**: CAMARA APIs are orchestrated by OSL (offered as a service) and their endpoints are exposed to the end clients.
2. **Service Mapping**: The CAMARA API Service references a running service (identified by a UUID), enabling targeted operations. The invoking of CAMARA API endpoints will results in updates in the running service’s characteristics.
3. **Operational Flow**: Updates triggered via CAMARA APIs are propagated to the operator's service through OSL0s message queue (Active MQ), ensuring synchronization of service characteristics.
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
This architecture is presented in the figure below:
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
![CAMARAaaS-Architecture](Documentation/CAMARAaaS-Architecture.png)
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
As already mentioned, the step “PATCH Characteristics” is achieved by send a message to OSL’s message bus.
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
For OSL’s community to get the full grasp of this architecture, we also make available a sequence diagram with all interactions that take place.
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
![CAMARAaaS-Workflow-OSLToday](Documentation/CAMARAaaS-Workflow-OSLToday.png)
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
![CAMARAaaS-Workflow-ServiceOrdering](Documentation/CAMARAaaS-Workflow-ServiceOrdering.png)
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
![CAMARAaaS-Workflow-ServiceOperation](Documentation/CAMARAaaS-Workflow-ServiceOperation.png)
## Important Considerations
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
The OSL CAMARA as a Service Add-on depends on 2 Services:
Kostis Trantzas's avatar
Kostis Trantzas committed

Rafael Direito's avatar
Rafael Direito committed
- The OSL CAMARA API Service
    - Is a generic CAMARA API wrapper service implemented by the OSL team
    - This implementation will be publicly offered as an Addon (Helm chart)
- A custom 5G-related Service (that shall be controlled/referenced by the CAMARA API Service):
    - An OSL user must implement and provide its own 5G-related Controlling Service (following OSL design patterns)
    - Implementation is custom
Kostis Trantzas's avatar
Kostis Trantzas committed