1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-02 08:20:22 +01:00
docs/content/concepts/compute-to-data.md

77 lines
3.8 KiB
Markdown
Raw Normal View History

2020-04-29 12:27:29 +02:00
---
title: Compute-to-Data
2020-10-17 09:09:20 +02:00
description: Providing access to data in a privacy-preserving fashion
2020-04-29 12:27:29 +02:00
slug: /concepts/compute-to-data/
section: concepts
---
## Motivation
2020-10-17 09:09:20 +02:00
The most basic scenario for a Publisher is to provide access to the datasets they own or manage. However, a Publisher may offer a service to execute some computation on top of their data. This has some benefits:
2020-04-29 12:27:29 +02:00
2020-06-03 02:30:38 +02:00
- The data **never** leaves the Publisher enclave.
- It's not necessary to move the data; the algorithm is sent to the data.
- Having only one copy of the data and not moving it makes it easier to be compliant with data protection regulations.
2020-04-29 12:27:29 +02:00
2020-10-17 09:09:20 +02:00
[This page](https://oceanprotocol.com/technology/compute-to-data) elaborates on the benefits.
2020-04-29 12:27:29 +02:00
## Architecture
2020-10-17 09:09:20 +02:00
### Enabling Publisher Services, using Ocean Provider
2020-04-29 12:27:29 +02:00
The direct interaction with the infrastructure where the data resides requires the execution of a component handled by Publishers.
This component will be in charge of interacting with users and managing the basics of a Publisher's infrastructure to provide these additional services.
The business logic supporting these additional Publisher capabilities is the responsibility of this new technical component.
2020-10-17 09:09:20 +02:00
The main and new key component introduced to support these additional Publisher services is named **Ocean Provider**.
2020-04-29 12:27:29 +02:00
2020-10-17 09:09:20 +02:00
Ocean Provider is the technical component executed by the **Publishers**, which provides extended data services. Ocean Provider includes the credentials to interact with the infrastructure (initially in cloud providers, but it could be on-premise).
2020-04-29 12:27:29 +02:00
### Compute-to-Data Enviroment (Operator-Service)
2020-10-17 09:09:20 +02:00
The Operator Service is a micro-service that implements part of the Compute-to-Data spec [OEP-12](https://github.com/oceanprotocol/OEPs/tree/master/12),
2020-04-29 12:27:29 +02:00
in charge of managing the workflow executing requests.
2020-10-17 09:09:20 +02:00
Typically the Operator Service is integrated from Ocean Provider, but can be called independently if it.
2020-04-29 12:27:29 +02:00
The Operator Service is in charge of stablishing the communication with the K8s cluster, allowing to:
2020-05-04 10:20:05 +02:00
- Register workflows as K8s objects
- List the workflows registered in K8s
- Stop a running workflow execution
- Get information about the state of execution of a workflow
2020-04-29 12:27:29 +02:00
The Operator Service doesn't provide any storage capability, all the state is stored directly in the K8s cluster.
<repo name="operator-service"></repo>
### Responsibilities
The main responsibilities are:
2020-05-04 10:20:05 +02:00
- Expose an HTTP API allowing for the execution of data access and compute endpoints.
- Authorize the user on-chain using the proper Service Agreement. That is, validate that the user requesting the service is allowed to use that service.
- Interact with the infrastructure (cloud/on-premise) using the Publisher's credentials.
- Start/stop/execute computing instances with the algorithms provided by users.
- Retrieve the logs generated during executions.
- Register newly-derived assets arising from the executions (i.e. as new Ocean assets) (if required by the consumer).
2020-04-29 12:27:29 +02:00
### Flow
![Sequence Diagram for computing services](images/4_Starting_New_Compute_Job.png)
In the above diagram you can see the initial integration supported. It involves the following components/actors:
2020-05-04 10:20:05 +02:00
- Data Scientists/Consumers - The end users who need to use some computing services offered by the same Publisher as the data Publisher.
- Ocean Keeper - In charge of enforcing the Service Agreement by tracing conditions.
- Operator-Service - Micro-service that is handling the compute requests.
- Operator-Engine - The computing systems where the compute will be executed.
2020-04-29 12:27:29 +02:00
Before the flow can begin, the following pre-conditions must be met:
2020-05-04 10:20:05 +02:00
- The Asset DDO has a compute service.
2020-10-17 09:09:20 +02:00
- The Asset DDO must specify the Ocean Provider endpoint exposed by the Publisher.
2020-05-04 10:20:05 +02:00
- The Service Agreement template must already be predefined and whitelisted `on-chain`.