Unified Storage: Update readme (#114415)
* update readme * Adds message about creating database * update sample storage config
This commit is contained in:
@@ -202,30 +202,58 @@ then run:
|
||||
kubectl --kubeconfig=./grafana.kubeconfig create -f folder-generate.yaml
|
||||
```
|
||||
|
||||
### Run as a GRPC service
|
||||
### Run as a separate GRPC service
|
||||
|
||||
#### Start GRPC storage-server
|
||||
It is recommended to use a separate config file for the storage-server. Create a file `conf/storage-server.ini` with the following content:
|
||||
|
||||
Make sure you have the gRPC address in the `[grafana-apiserver]` section of your config file:
|
||||
```ini
|
||||
app_mode = development
|
||||
|
||||
target = storage-server
|
||||
|
||||
[database]
|
||||
type = mysql
|
||||
host = 127.0.0.1:3306
|
||||
name = unified-storage
|
||||
user = root
|
||||
password = rootpass
|
||||
skip_migrations = true
|
||||
ensure_default_org_and_user = false
|
||||
|
||||
[grpc_server]
|
||||
network = "tcp"
|
||||
address = "127.0.0.1:10000"
|
||||
|
||||
[grafana-apiserver]
|
||||
; your gRPC server address
|
||||
address = localhost:10000
|
||||
```
|
||||
storage_type = unified
|
||||
|
||||
You also need the `[grpc_server_authentication]` section to authenticate incoming requests:
|
||||
```ini
|
||||
[grpc_server_authentication]
|
||||
; http url to Grafana's signing keys to validate incoming id tokens
|
||||
signing_keys_url = http://localhost:3000/api/signing-keys/keys
|
||||
signing_keys_url = http://localhost:3011/api/signing-keys/keys
|
||||
mode = "on-prem"
|
||||
|
||||
[feature_toggles]
|
||||
kubernetesDashboards = true
|
||||
kubernetesFolders = true
|
||||
unifiedStorage = true
|
||||
unifiedStorageHistoryPruner = true
|
||||
unifiedStorageSearch = true
|
||||
unifiedStorageSearchPermissionFiltering = false
|
||||
unifiedStorageSearchSprinkles = false
|
||||
|
||||
[unified_storage]
|
||||
enable_search = true
|
||||
https_skip_verify = true
|
||||
```
|
||||
|
||||
This currently only works with a separate database configuration (see previous section).
|
||||
You should also have a MySQL database running. You can create one with our docker blocks by running:
|
||||
```bash
|
||||
make devenv sources=mysql
|
||||
```
|
||||
The database credentials in the example above will work with the default mysql docker block. You'll also need to create a database named `unified-storage`.
|
||||
|
||||
Start the storage-server with:
|
||||
```sh
|
||||
GF_DEFAULT_TARGET=storage-server ./bin/grafana server target
|
||||
./bin/grafana server target --config conf/storage-server.ini
|
||||
```
|
||||
|
||||
The GRPC service will listen on port 10000
|
||||
|
||||
Reference in New Issue
Block a user