Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
References: #9490 (set the configured protocol transport for service metadata)

As discussed with @butonic, adding that _configurable service endpoints_ are currently experimental.
  • Loading branch information
mmattel authored Aug 26, 2024
1 parent 83f80a5 commit 78c6046
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions services/gateway/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,10 @@ Store specific notes:
- When using `nats-js-kv` it is recommended to set `OCIS_CACHE_STORE_NODES` to the same value as `OCIS_EVENTS_ENDPOINT`. That way the cache uses the same nats instance as the event bus.
- When using the `nats-js-kv` store, it is possible to set `OCIS_CACHE_DISABLE_PERSISTENCE` to instruct nats to not persist cache data on disc.

## Service endpoints
## Service Endpoints

**IMPORTANT**\
This functionality is currently experimental.

The gateway acts as a proxy for other CS3 services. As such it has to forward requests to a lot of services and needs to establish connections by looking up the IP address using the service registry. Instead of using the service registry each endpoint can also be configured to use the grpc `dns://` or `kubernetes://` URLs, which might be useful when running in kubernetes.

Expand Down Expand Up @@ -95,9 +98,7 @@ SHARING_PUBLIC_CS3_PROVIDER_ADDR="unix:/var/run/ocis/storage-system.sock"
SHARING_PUBLIC_JSONCS3_PROVIDER_ADDR="unix:/var/run/ocis/storage-system.sock"
```



## Storage registry
## Storage Registry

In order to add another storage provider the CS3 storage registry that is running as part of the CS3 gateway hes to be made aware of it. The easiest cleanest way to do it is to set `GATEWAY_STORAGE_REGISTRY_CONFIG_JSON=/path/to/storages.json` and list all storage providers like this:

Expand Down Expand Up @@ -167,4 +168,4 @@ In order to add another storage provider the CS3 storage registry that is runnin
}
```

In the above replace `{storage-users-mount-uuid}` with the mount UUID that was generated for the storage-users service. You can find it in the `config.yaml` generated on by `ocis init`. The last entry `com.owncloud.api.storage-hello` and its `providerid` `"hello-storage-id"` are an example for in additional storage provider, in this case running `hellofs`, an example minimal storage driver.
In the above replace `{storage-users-mount-uuid}` with the mount UUID that was generated for the storage-users service. You can find it in the `config.yaml` generated on by `ocis init`. The last entry `com.owncloud.api.storage-hello` and its `providerid` `"hello-storage-id"` are an example for in additional storage provider, in this case running `hellofs`, an example minimal storage driver.

0 comments on commit 78c6046

Please sign in to comment.