X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=README.md;h=917f48841cb4d80a0aafa5eb213ab4150acc2808;hb=HEAD;hp=6391fc45ea762a5b606dcf9f867fac8087b1222f;hpb=22edf30ca0ef3ffca2fdb5a44308d828494eee7b;p=ric-plt%2Fdbaas.git diff --git a/README.md b/README.md index 6391fc4..917f488 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,8 @@ This repository containes all the needed elements to deploy database as a servic ## Architecture Redis is the chosen database technology and the final product will deploy autonomous -redis cluster. In R0 schedule, single, non-redundant, non-persistent redis server is -deployed +redis cluster. Supported deployment options are standalone Redis server and HA +(Sentinel) Redis deployment. Either deployment option won't provide data persistency. ## Subsystem structure @@ -32,13 +32,18 @@ docker build --file docker/Dockerfile.testapp --tag dbaas-test . ### DBaaS service -In R0, dbaas service is realized with single container running redis database. -The database is configured to be non-persistent and non-redundant. The container -exposes single port which is hardcoded to be 6379. +Dbaas service is realized either with single container running redis database +or with HA deployment implemented by a redis sentinel solution. +Standalone dbaas database is configured to be non-persistent and +non-redundant. HA dbaas provides redundancy but it is also configured to be +non-persistent. -After dbaas service is installed, environment variables **DBAAS_SERVICE_HOST** -and **DBAAS_SERVICE_PORT** are exposed to application containers. SDL library -will automatically use these environment variables. +After dbaas service is installed, environment variables **DBAAS_SERVICE_HOST**, +**DBAAS_SERVICE_PORT** and **DBAAS_NODE_COUNT** are exposed to application +containers. In the case of HA dbaas deployment also environment variables +**DBAAS_MASTER_NAME** and **DBAAS_SERVICE_SENTINEL_PORT** are exposed to +application containers. SDL library will automatically use these environment +variables. The service is installed via helm by using dbaas-service chart. Modify the values accordingly before installation (repository location, image name, ..) @@ -47,6 +52,13 @@ values accordingly before installation (repository location, image name, ..) helm install ./dbaas-service ``` +### SDLCLI +There is a pre-installed `sdlcli` tool in DBaaS container. With this tool user +can see statistics of database backend (Redis), check healthiness of DBaaS +database backend, list database keys and get and set values into database. +To get more information about available commands and how to use them, please +check help instructions: `sdlcli --help`. + ### DBaaS test application Test application is installed via helm by using dbaas-test chart. Modify the @@ -86,7 +98,7 @@ The environment variables for database backend should be set: >>printenv DBAAS_SERVICE_HOST=10.108.103.51 DBAAS_SERVICE_PORT=6379 - +DBAAS_NODE_COUNT=1 Go test application using preliminary go SDL-API should be able to perform reads and writes: