Replicator

The Jinaga Replicator is a single machine in a network. It stores and shares facts. There are three ways to create a Replicator:

• Subscribe in the Azure Marketplace
• Create a Docker container using the jinaga/jinaga-replicator image
• Build a Node.js app using jinaga-server

When you publish a Replicator, you will be given a URL. Use a tool like httpYac or Postman to POST messages to https://rep.jinaga.com/xyz123.../write and /read.

You can download the example httpYac files or example Postman collection to try it yourself. Edit the example and enter your own replicator URL.

For httpYac, add your own .env.local file with the following values:

replicatorUrl=https://rep.jinaga.com/xyz123

oauth2_authorizationEndpoint=https://rep.jinaga.com/xyz123/auth/apple
oauth2_tokenEndpoint=https://rep.jinaga.com/xyz123/auth/token
oauth2_clientId=xyz123
oauth2_usePkce=true

authorizationEndpoint=https://app.jinaga.com/xyz123/authorization
distributionEndpoint=https://app.jinaga.com/xyz123/distribution
secret=zyx321

Get the actual values from your replicator after setting up authentication, authorization, and distribution.

For Postman, enter the replicator URL and other values in the Postman collection variables.

Docker

If you would like to keep everything local, you can also run the Replicator in Docker. Install Docker Desktop. Then run the following commands from the command prompt (Mac Terminal, Windows PowerShell, or WSL2).

docker pull jinaga/jinaga-replicator
docker run --name my-replicator -p8080:8080 jinaga/jinaga-replicator

This creates and starts a new container called my-replicator. The container is listening at port 8080 for commands. Use a tool like Postman to POST messages to http://localhost:8080/jinaga/write and /read.

You can download the example httpYac files or example Postman collection to populate your replicator.

If you are using httpYac, create a file called .env.local in the same folder as the request files. Copy the following configuration setting into the file.

replicatorUrl=http://localhost:8080/jinaga

If you are using Postman, edit the collection variables and enter the replicator URL http://localhost:8080/jinaga.