Developer Setup

Prerequisites
Terminal emulator
Linux and MacOS will have a terminal installed already. For Windows, it is recommended that you use git-bash, which you can install from here.
Type echo Hi in the terminal once it is installed. If installed correctly, you should see Hi appear when you hit enter.
Git
Installation instructions for Git can be found here.
Run git --version in the terminal to check if git has been installed correctly:
1
$ git --version
2
git version 2.33.0
Copied!
Java
Installation instructions for Java 8 can be found here.
Run java in the terminal to check if java has been installed correctly:
1
$ java
2
Usage: java [-options] class [args...]
3
...
Copied!
NodeJS (Only needed for the Registry CLI)
Installation instructions for NodeJS can be found here.
Run node -v in the terminal to check if node has been installed correctly:
1
$ node -v
2
v16.11.0
Copied!
Docker
Installation instructions for Docker can be found here.
Run docker -v in terminal to check if docker has been installed correctly:
1
$ docker -v
2
Docker version 20.10.9, build c2ea9bc90b
Copied!
Docker Compose
Installation instructions can be found here.
Run docker-compose -v in terminal to check if docker-compose has been installed correctly:
1
$ docker-compose -v
2
Docker Compose version 2.0.1
Copied!
Downloading The Source Code
Run the following in terminal to download the registry's source code:
1
$ git clone https://github.com/sunbird-rc/sunbird-rc-core.git sunbird-rc/core
Copied!
Move into the folder by typing:
1
$ cd sunbird-rc/core
Copied!
Compiling The Registry
Run the configure-dependencies.sh script in the root of the repo as follows:
1
$ sh configure-dependencies.sh
Copied!
Then compile the registry (this will take some time when you are running it for the first time):
1
$ cd java
2
$ ./mvnw clean install -DskipTests
3
$ cd ..
Copied!
This should create a JAR file in the java/registry/target folder.
Configuring Schemas
Place all your schema files in the java/registry/src/main/resources/public/_schemas/ folder.
A sample set of schemas for a simple student-teacher registry can be found here. You can learn how to write your own schemas by following this guide.
Configure And Start Dependent Services
Run the following in terminal to download this Docker Compose file:
1
$ curl https://raw.githubusercontent.com/sunbird-rc/sunbird-rc-core/main/tools/cli/src/templates/examples/student-teacher/docker-compose.yaml > docker-compose.yml
Copied!
To download a minimal keycloak configuration, run the following:
1
$ curl https://raw.githubusercontent.com/sunbird-rc/sunbird-rc-core/main/tools/cli/src/templates/examples/student-teacher/imports/realm-export.json > import/realm-export.json
Copied!
Then start Keycloak (kc), Postgres (db), Elastic Search (es) and the Claims Service (cs) by running the following command:
1
$ docker-compose up kc db es cs
Copied!
Configuring The Registry
Before we can start the registry, we need to regenerate and retrieve the client secret for the admin-api client in Keycloak. To do that, follow these steps:
Go to http://localhost:8080/auth/admin/master/console/#/realms.
Login using the username admin and password admin.
Click Sunbird RC.
Click Clients in the panel on the left.
Click admin-api.
Click the Credentials tab.
Under Client Secret, click Regenerate Secret. Copy the secret that you see in the box and paste it in the docker-compose.yml file in place of INSERT_SECRET_HERE on line 42.
Running The Registry
Once you have completed all the above steps, run the registry using the following command:
1
$ java -jar java/registry/target/registry.jar
Copied!