diff --git a/Source/content/en/docs/concepts/resource_system.md b/Source/content/en/docs/concepts/resource_system.md new file mode 100644 index 00000000..1a2116ef --- /dev/null +++ b/Source/content/en/docs/concepts/resource_system.md @@ -0,0 +1,11 @@ +--- +title: Resource System +description: How to get access to storage +weight: 90 +--- + +When using the [Dolittle SDK](https://github.com/dolittle/dotnet.sdk) you get access to the Resource System which is a way to get access to storage. The Resources you get will be separated by [Tenants]({{}}) and unique in your current context. This means that you can depend on the stored data not leaking between tenants. + +## Read Cache + +The Read Cache is available from the Resource System as an `IMongoDatabase` that you can reference in your code. The database will be connected, and you can use normal MongoDB queries to get access to the data you store there. \ No newline at end of file diff --git a/Source/content/en/docs/platform/studio/microservice.md b/Source/content/en/docs/platform/studio/microservice.md index 91464b70..eeed11c9 100644 --- a/Source/content/en/docs/platform/studio/microservice.md +++ b/Source/content/en/docs/platform/studio/microservice.md @@ -9,7 +9,7 @@ A Microservice is a single unit of deployment in the Aigonix Platform. It is a c A Microservice lives inside an [Application]({{}}) and can be deployed to multiple [Environments]({{}}) in that application. -A Microservice in the Aigonix Platform is a Head and optionally a Runtime and data-storage. If you use the Dolittle Runtime you will have access to the [Event Store]({{}}) and [Read Cache]({{}}) for that Microservice. +A Microservice in the Aigonix Platform is a Head and optionally a Runtime and data-storage. If you use the Dolittle Runtime you will have access to the [Event Store]({{}}) and [Read Cache]({{}}) for that Microservice. If you do not use the Dolittle Runtime the Microservice will be stateless and will not have access to any storage. Any state you need to store will have to be stored in an external service. You will have access to the local file-system, but that is not persisted between Microservice restarts, and we do not recommend relying upon it. @@ -23,7 +23,7 @@ Head is the name of the pod where your Microservice Docker image is deployed. It ## Dolittle Runtime -Each Microservice can be deployed with the [Dolittle Runtime]({{}}). The Dolittle Runtime is available as a docker image, and will be deployed alongside your Head. Your code communicates with the Runtime through the [Dolittle SDK]({{}}). The Runtime is used to connect to the [Event Store]({{}}) and will make the resource-system available to you, where you can get the Tenanted [Read Cache]({{}}) and to publish events to the [Event Horizon]({{}}). +Each Microservice can be deployed with the [Dolittle Runtime](https://github.com/dolittle/runtime). The Dolittle Runtime is available as a docker image, and will be deployed alongside your Head. Your code communicates with the Runtime through the [Dolittle SDK](https://github.com/dolittle/dotnet.sdk). The Runtime is used to connect to the [Event Store]({{}}) and will make the resource-system available to you, where you can get the Tenanted [Read Cache]({{}}) and to publish events to the [Event Horizon]({{}}). ## Configuration diff --git a/Source/content/en/docs/platform/studio/overview.md b/Source/content/en/docs/platform/studio/overview.md index e9fbb87b..ffa923dd 100644 --- a/Source/content/en/docs/platform/studio/overview.md +++ b/Source/content/en/docs/platform/studio/overview.md @@ -21,7 +21,7 @@ When you run your [Microservices]({{}}) in the Aigonix Platfor You will define each [Application]({{}}) with its [Environments]({{}}), and add Microservices to them. You define which Docker image to use for each Microservice, and whether or not you want to use the Dolittle Runtime. You can use a publically available image, or store your container image in the provided [container-registry]({{}}). -If you use the Dolittle Runtime one will be made available to your [Head]({{}}) and through it you will have access to [Tenanted resources]({{}}) like the [Event Store]({{}}) and [Read Cache]({{}}). If you do not use the [Dolittle Runtime]({{}}) the service will run the assigned Docker-image without permanent storage (stateless). +If you use the Dolittle Runtime one will be made available to your [Head]({{}}) and through it you will have access to [Tenanted resources]({{}}) like the [Event Store]({{}}) and [Read Cache]({{}}). If you do not use the [Dolittle Runtime](https://github.com/dolittle/runtime) the service will run the assigned Docker-image without permanent storage (stateless). You can make your services available to the internet if you so wish. If you do not they will only be available within the platform.