User Story Edge Cloud Family #265
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,181 @@ | ||
|
|
||
| # Edge Cloud APIs User Story | ||
| _This document is based on the [CAMARA Commonalities template for User Stories](https://github.com/camaraproject/Commonalities/blob/main/documentation/Userstory-template.md)_ | ||
| _Roles are referenced from the ITU-T Cloud Refence Architecture._ | ||
|
|
||
| ## Summary | ||
| "As an Application Developer, I want to determine the Edge Cloud Zone more suitable for my application, being aware of all the options available their Status, Region and Edge Cloud Zone provider of interest. | ||
| I want to be able to put my application available in the selected Edge Cloud Zone in a simpler manner providing both artifacts and metadata for instantiating my application succesfully at the same time I want to be able to terminate running instances of my application on a particular Edge Cloud Zone and also to remove information of the whole application itself ". | ||
|
|
||
| This story includes the whole journey from the Edge Cloud APIs with a couple of examples about the use of these APIs to improve the deployment experience of the APs: | ||
| ## Edge Cloud APIs | ||
| | API | Description| | ||
| |-------|------|-------| | ||
| |Application Endpoint Discovery(AED) |The Application Discovery API extends beyond the capabilities of the Simple Edge Discovery API by not only locating the nearest Edge Cloud Zone but also directly linking to the application endpoints within those zones. | | ||
| |Edge Application Management(EAM)|Edge Application Management API allows API consumers to manage the Life Cycle of an Application and to Discover Edge Cloud Zones. | ||
| |Simple Edge Discovery(SED)|The Simple Edge Discovery API returns the name of the closest operator Edge Cloud Zone to a particular user device. | ||
| |Traffic Influence(TI)|The TI API provides the capability to establish the best routing, in terms of latency, in a specific geographical area, between the user Device, e.g. the user’s smartphone, and the optimal EAS instance nearby. | ||
|
|
||
| To further information about each API, review the User story of each one, which is available in the corresponding repository. | ||
| The purpose of this user story is to have a general picture of the life cycle management of the Edge cloud family APIs. | ||
|
|
||
| ## Actors, Roles, and Scope | ||
| | Actor | Role | Scope | | ||
| |-------|------|-------| | ||
| |Application Provider (AP) |API Consumer | API Requester | | ||
| |Edge Platform (EP)|Edge Cloud Provider | API Publisher | | ||
| |Edge Service Provider (ESP)|Edge Cloud Provider|API Publisher | ||
| |Operator|Communications Service Provider|API Publisher | ||
| |User Client(UC)|API Consumer|API Requester | ||
|
|
||
| Note: the role of Edge Service Provider may be played by either the MNO or Cloud Service Providers (Hyperscalers). | ||
|
|
||
|
|
||
| #### Scenario 1: Request triggered by the AP and the Hyperscaler will host the App. | ||
|
|
||
|
|
||
| | Item | Description | Support Qualifier | | ||
| |----|----|----| | ||
| |Summary|Edge Service Providers offers an Edge platform that exposes computing and networking services in a given territory with several levels of abstraction being the Edge Cloud Zone the lowest one. Edge Service Providers offers a service through EdgeCloud APIs that permits application providers to deploy instances of an application in one or several Edge Cloud Zones, and to Applications Users the posibility to chose the most appropriate Edge Cloud Zone available at a given moment| M | | ||
| |Pre-conditions|The AP has a resource usage agreement with the Operator| M | | ||
| |Begins when|The user client request access to the application| M | | ||
|
There was a problem hiding this comment. I think the statement "user client request access to the application" needs to be rephrased as it is not clear what exactly it is trying to do in terms of API invocation. Also i think there should be step for onboarding application too which will be referred in other steps. |
||
| |Step 1|The AP invokes Application Endpoint Discovery to request an Endpoint of the closest Edge Cloud Zone for this user(MSISDN)| M | | ||
| |Step 2|The Application Endpoint Discovery returns to the EP an Endpoint with the closest Edge Cloud Zone for this user(MSISDN) | M| | ||
| |Step 3|The AP instantiates the App in the Edge Cloud Zone determinated by the SED API| M| | ||
|
There was a problem hiding this comment. In my opinion the sequence could be for example, But please correct if I am missing something. |
||
| |Step 4|Once the App is istantiated the ESP returns the information about the Edge Cloud Zone where the App is instantiated| M| | ||
| |Step 5|The AP provides the user client the corresponding URL to connected| M| | ||
|
There was a problem hiding this comment. We should specify to some extent how AP can provide the user client the URL which I suppose is obtained from Application Endpoint Discovery Response. But some hint or examples should be given on how it can be done programmatically. |
||
| |Step 6|The UE connects to the provided URL and start using the application| M| | ||
|
There was a problem hiding this comment. May be UE here points to user client. If so we may put the right term for consistency |
||
| |Step 7|The AP invokes traffic influence API to activate the appropriate routing at the Edge of the mobile network toward the local ESP Instance for the Premium Users| M| | ||
|
There was a problem hiding this comment. As we are using both AP and user client we need to who can invoke which API. Here whether AP which may be an application too or the user client on UE may invoke the TI API. So just trying to understand if both AP and user client in mix are not creating slight confusion. Or at the beginning we should write who is AP and who is user client and what is there communication to be expected in this page. |
||
| |Step 8|The traffic flow is routed from the selected UPF to the requested ESP Instance for the selected users| M| | ||
| |Step 9|The UE connects to the provided EAS and start using the application| M| | ||
| |Ends when|The UE connects to the ESP| M | | ||
| |Post-conditions|The UE is connected to the most adequate ESP, it may request to reconnect (repeat Step 7) at any time if the perceived quality is not adequate| M | | ||
|
|
||
|
|
||
|
|
||
|
|
||
| ## Flow | ||
| ```mermaid | ||
| sequenceDiagram | ||
| participant UC | ||
| participant AP | ||
| participant Operator | ||
| participant ESP(Hyperscaler) | ||
| Note over AP,Operator: PRE App on device attached <br/> to operator network | ||
| Note over AP,Operator: PRE App developer registered, <br/> authenticated and authorised | ||
| UC->>AP: The user client request access to the application | ||
| Note over Operator,Operator: SED API | ||
| AP->>Operator: GET/ AP Invokes Simple Edge Discovery API to get the closest Edge cloud zone for this MSISDN | ||
| Operator->>AP: Returns the name of the closest Edge cloud zone for this MSISDN(edgeCloudZoneInfo) | ||
| AP->>ESP(Hyperscaler): The AP instantiates the App in the Edge Cloud Zone determinated by the SED API | ||
| ESP(Hyperscaler)->>AP: Return EdgeCloudZoneName and EdcloudZoneProvider | ||
| AP->>UC: The AP provides the URL of the closest Edge Cloud Zone to the UC. | ||
| alt | ||
| Note over Operator,Operator: TI API | ||
| AP->>ESP(Hyperscaler): AP invokes traffic influence API to activate the appropriate routing at the Edge of the mobile network toward the local ESP Instance for the Premium Users | ||
| ESP(Hyperscaler)->>AP: The traffic flow is routed from the selected UPF to the requested ESP Instance for the selected users | ||
| end | ||
| ``` | ||
|
|
||
|
|
||
| #### Scenario 2: Request triggered by the AP and the Operator will host the App. | ||
|
|
||
|
|
||
| | Item | Description | Support Qualifier | | ||
| |----|----|----| | ||
| |Summary|Edge Service Providers offers an Edge platform that exposes computing and networking services in a given territory with several levels of abstraction being the Edge Cloud Zone the lowest one. Edge Service Providers offers a service through EdgeCloud APIs that permits application providers to deploy instances of an application in one or several Edge Cloud Zones, and to Applications Users the posibility to chose the most appropriate Edge Cloud Zone available at a given moment| M | | ||
| |Pre-conditions|The AP has a resource usage agreement with the owner of the Edge Platform| M | | ||
| |Begins when|The Application Provider (AP) invokes the Edge Application Management API to submit an application with references to obtain all needed data for their instantiation (container images or VM images and manifests describing required resources by an application)| M | | ||
| |Step 1|The Operator authorizes the request (terminates with a notification to the AP if it is not valid)| M | | ||
| |Step 2|The Operator validates the request (terminates with a notification to the AP if content is not valid)| M| | ||
| |Step 3|The Operator stores the app information and returns an Id for reference (terminates with a notification to the AP if error)| M | | ||
| |Step 4|The Edge Application Management API instantiate the application in an specific Edge Cloud Zone or serverals | M | | ||
|
There was a problem hiding this comment. I think we should mention who (the actor) initiates the Edge Application Management API. |
||
| |Step 5|The Operator validates the request and if AppId and parameters provided are valid, returns an object including references to one instance Id per Edge Cloud Zone with an instantiation status "instantiating" and starts deploying app instance in EdgeCloud Zones that meet the input criteria| M | | ||
| |Step 6|The AP may request updated information of existing app instances of a given app. Possible status for app instantiation includes "ready" also information for endpoint info is provided for the app instance| O | | ||
| |Step 7|The Operator response to the AP and starts the termination of the app instance, moving its status to terminating| M| | ||
|
There was a problem hiding this comment. Not clear why Operator started the termination? Is anything missing here? |
||
| |Step 8|An User Client solicitates access to the Application | M| | ||
|
There was a problem hiding this comment. Can we mention what it means by "User Client solicitates access to the Application" in terms of APIs? |
||
| |Step 9|The Operator invokes SED API to request information of the closest Edge Cloud zone currently available | M | | ||
|
There was a problem hiding this comment. Does Operator need to invoke SED API in this step? |
||
| |Step 10|The SED API returns the closest Edge Cloud Zone to the OP | M | | ||
|
There was a problem hiding this comment. Is it that the AP get the closest edge cloud zone and not the OP? |
||
| |Step 11|The AP provides the URL with the closest Edge Cloud Zone to the UC | M | | ||
|
There was a problem hiding this comment. Isnt it that the AP still needs to retrieve the application endpoint URL by using Application Endpoint Discovery API and SED will not be available in the SED response? Is a step AED is missing prior to Step 11? |
||
| |Step 12|The UC connects to the provided EAS and start using the application| M| | ||
| |Step 13|The AP invokes traffic influence API to activate the appropriate routing at the Edge of the mobile network toward the local EAS Instance for the Premium Users| M| | ||
|
There was a problem hiding this comment. May be we can add more here to say from AED result UC can get the endpoint information to prepare and invoke TI API. |
||
| |Step 14|The traffic flow is routed from the selected UPF to the requested ESP Instance for the selected users| M| | ||
|
There was a problem hiding this comment. We may say that the traffic flow as mentioned in the TI API towards the EAS is routed |
||
| |Ends when|The UE connects to the ESP| M | | ||
|
There was a problem hiding this comment. Should we say ESP or EAS? |
||
| |Post-conditions|The UE is connected to the most adequate ESP, it may request to reconnect (repeat Step 13) at any time if the perceived quality is not adequate| M | | ||
|
|
||
|
|
||
|
|
||
|
|
||
| ## Flow | ||
| ```mermaid | ||
| sequenceDiagram | ||
| participant UC | ||
| participant AP | ||
| participant Operator | ||
| participant ESP(Operator/Hyperscaler) | ||
|
|
||
| Note over AP,Operator: PRE App on device attached <br/> to operator network | ||
| Note over AP,Operator: PRE App developer registered, <br/> authenticated and authorised | ||
| Note over Operator,Operator: Edge Application Management API | ||
| AP->>Operator: POST/ AP Invokes Edge Application Management API to submit an application with references to obtain all needed data for their instantiation(appManifest) | ||
| Operator->>AP: The Operator stores the app information and returns an Id for reference(appId) | ||
| alt app has a local mapping of server endpoints to Edge Cloud Zones | ||
| AP->>Operator:POST/ The AP could request to instantiate the App in one Edge Clod Zone or several(AppZones). | ||
| Operator->>ESP(Operator/Hyperscaler):Edge Application Management API instantiates the App. | ||
| ESP(Operator/Hyperscaler)->>Operator: Application instantiated | ||
| Operator->>AP:Returns the appInstance created | ||
| UC->>AP: User client request access to the App with a determinated MSISDN. | ||
| Note over Operator,Operator: SED API | ||
| AP->>Operator: GET/ AP Invokes Simple Edge Discovery API to get the closest Edge cloud zone for this MSISDN | ||
| Operator->>AP: Returns the name of the closest Edge cloud zone for this MSISDN(edgeCloudZoneInfo) | ||
| AP->>UC: The AP provides the URL of the closest Edge Cloud Zone to the UC. | ||
| Note over Operator,Operator: TI API | ||
| AP->>ESP(Operator/Hyperscaler): AP invokes traffic influence API to activate the appropriate routing at the Edge of the mobile network toward the local EAS Instance for the Premium Users | ||
| ESP(Operator/Hyperscaler)->>AP: The traffic flow is routed from the selected UPF to the requested EAS Instance for the selected users | ||
| end | ||
| ``` | ||
| #### Scenario 3: Request triggered by the User. | ||
|
|
||
|
|
||
| | Item | Description | Support Qualifier | | ||
| |----|----|----| | ||
| |Summary|Network operators offers a Multi-access Edge Computing platform in a given territory with several levels of abstraction being the Edge Cloud Zone the lowest one. Network operators offers a service through EdgeCloud APIs that permits application providers to deploy instances of an application in one or several Edge Cloud Zones, and to Applications Users the posibility to chose the most appropriate Edge Cloud Zone available at a given moment| M | | ||
| |Pre-conditions|The application is already deployment and the user has access to the application by the market place| M | | ||
| |Begins when|The user client request access to the application| M | | ||
| |Step 1|The AP invokes Application Endpoint Discovery to request an Endpoint of the closest Edge Cloud Zone for this user(MSISDN)| M | | ||
| |Step 2|The Application Endpoint Discovery returns to the EP an Endpoint with the closest Edge Cloud Zone for this user(MSISDN) | M| | ||
| |Step 3|The OP invokes Application Endpoint Discovery API to request information of the closest Edge Cloud zone currently available | M | | ||
| |Step 4|The Application Endpoint Discovery API returns the endpoint for the closest Edge Cloud Zone to the user | M | | ||
| |Step 5|The UE connects to the provided ESP and start using the application| M| | ||
| |Step 6|The AP invokes traffic influence API to activate the appropriate routing at the Edge of the mobile network toward the local ESP Instance for the Premium Users| M| | ||
| |Step 7|The traffic flow is routed from the selected UPF to the requested ESP Instance for the selected users| M| | ||
| |Step 8|The UE connects to the provided ESP and start using the application| M| | ||
| |Ends when|The UE connects to the EAS| M | | ||
| |Post-conditions|The UE is connected to the most adequate ESP, it may request to reconnect (repeat Step 6) at any time if the perceived quality is not adequate| M | | ||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
| ## Flow | ||
| ```mermaid | ||
| sequenceDiagram | ||
| participant UC | ||
| participant AP | ||
| participant Operator | ||
| participant ESP(Operator/Hyperscaler) | ||
| Note over AP,Operator: PRE the App is already instantiate <br/> in some Edge Cloud Zones | ||
| Note over Operator,Operator: Application Endpoint Discovery API | ||
| UC->>AP: The user client request access to the application | ||
| AP->>Operator:GET/ The AP invokes Application Endpoint Discovery to request an Endpoint of the closest Edge Cloud Zone for this user(MSISDN) | ||
| alt | ||
|
|
||
| Operator->>UC: The Application Endpoint Discovery returns to the EP an Endpoint with the closest Edge Cloud Zone for this user(MSISDN) | ||
| Note over Operator,Operator: TI API | ||
| AP->>ESP(Operator/Hyperscaler): AP invokes traffic influence API to activate the appropriate routing at the Edge of the mobile network toward the local EAS Instance for the Premium Users | ||
| ESP(Operator/Hyperscaler)->>AP: The traffic flow is routed from the selected UPF to the requested EAS Instance for the selected users | ||
| end | ||
| ``` | ||
|
|
||
|
|
||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I will suggest to use word "optimal" in place of "best" as it will be difficult to ascertain the best edge.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good appreciation, fixed.