- Simple to-do app (.net-core, mysql, EF)
- Java Quotations app (java, mysql, mqtt)
- Python Quotations app (python, mysql, amqp-091)
- Golang Chat app (golang, postgres, redis)
These are simple environments to test The Protocol Master application. We will mock without a line of code the database and a rest api of a simple TODO web application.
- The documentation for the protocol master is here
- A Docker environment
- The Docker environment address (let's use DOCKER_SERVER for now)
All .NET applications run out of the box only on Intel architecture, that means
- Platform: linux/amd64
- Target Architecture: amd64
For Apple M processors should work the following, change the HttpServer and RestServer dockerfile according to your needs (see on Microsoft for further info on the subject)
- Platform: linux/arm64
- Target Architecture: arm64
(Thanks patrick-baker for the UI!)
If you have Intellij or know what are *.http files you can configure this setting the
myhost variable to DOCKER_SERVER
- Clone the repo
https://github.com/kendarorg/the-protocol-master-samples.git - Configure your browser to use DOCKER_SERVER:29000 as HTTP/S Proxy
- Navigate to the "net-core" directory
- Run
docker-compose upto generate the environment - Several containers will be created
- net-core-tpm: The Protocol Master server
- net-core-mysql: The mysql database
- net-core-http: The web-ui
- net-core-rest: The rest back-end
- Download the SSL certificate from http://net-core-tpm:8081/api/protocols/http-01/plugins/ssl-plugin/der and install it as a trusted root certificate
You can check now the application navigating (in the proxied browser) to anything you want, and you will se the calls flowing on the console.
You can even try the application on http://net-core-http/index.html but for the sake of simplicity please delete all tasks before continuing the tutorial
- Start the recording on all protocols http://net-core-tpm:8081/api/protocols/all/plugins/record-plugin/start
- Navigate to http://net-core-http/index.html
- Insert a new task and click Submit
- Task Name: Laundry
- Priority: High
- Notes: Separate Colors
- Set the status to Completed
- Click Update
- Click Archive
- Go on Archive tab (upper right) and notice the task
- Stop the recording on all protocols http://net-core-tpm:8081/api/protocols/all/plugins/record-plugin/stop
- You can download all the recordings! http://net-core-tpm:8081/api/storage/download as a zip file
- Stop the
db_mysqlcontainer - Start the replaying on MySQL http://net-core-tpm:8081/api/protocols/mysql-01/plugins/replay-plugin/start
- Refresh the page http://net-core-http/index.html
- Redo exactly all the actions
- And everything will work!!!! But with a fake DB
- Stop all the replaying http://net-core-tpm:8081/api/protocols/all/plugins/replay-plugin/stop
- Stop the
net-core-restcontainer - Start the replaying on MySQL http://net-core-tpm:8081/api/protocols/http-01/plugins/replay-plugin/start
- Refresh the page http://net-core-http/index.html
- Redo exactly all the actions
- And everything will work!!!! But with a fake Rest API!!
- Stop all the replaying http://net-core-tpm:8081/api/protocols/all/plugins/replay-plugin/stop
If you have Intellij or know what are *.http files you can configure this setting the
myhost variable to DOCKER_SERVER
You can check the quotations going to http:\\java-rest\index.html
- Clone the repo
https://github.com/kendarorg/the-protocol-master-samples.git - Configure your browser to use DOCKER_SERVER:29000 as HTTP/S Proxy
- Navigate to the "java" directory
- Run
docker-compose upto generate the environment - Several containers will be created
- java-tpm: The Protocol Master server
- java-mysql: The mysql database
- java-mosquitto: The mqtt broker
- java-rest: The application reading mqtt messages (and showing on APIs)
- java-quote-generator: The quote generation (every 10 seconds random stock quotes)
- Download the SSL certificate from http://java-tpm:8081/api/protocols/http-01/plugins/ssl-plugin/der and install it as a trusted root certificate
- Connect your mysql ui to
DOCKER_HOST:23306and use the databasedb
Now your environment is ready for a real test!
- Start the recording on mqtt-01 protocol http://java-tpm:8081/api/protocols/mqtt-01/plugins/record-plugin/start
- Delete all records on
db.quotationstable - Wait for some data on
quotationstable (at least 10 seconds, this is the "run-time") - Stop the recording on all protocols http://java-tpm:8081/api/protocols/all/plugins/record-plugin/stop
- You can download all the recordings! http://java-tpm:8081/api/storage/download as a zip file
- Stop the
java-quote-generationcontainer - Stop the
java-restcontainer - Delete all data on
quotationstable - Start the replaying on MQTT http://java-tpm:8081/api/protocols/mqtt-01/plugins/replay-plugin/start
- Check the new data on
quotationstable - Mqtt simulation... done!
- Stop the replaying on all protocols http://java-tpm:8081/api/protocols/all/plugins/replay-plugin/stop
- Activate the publish plugin MQTT http://java-tpm:8081/api/protocols/mqtt-01/plugins/publish-plugin/start
- Restart Mosquitto
- Go to the swagger instance http://java-tpm:8081/swagger-ui/index.html#/
- Open the connections API and check the active connections
- Open the message sending API
- Insert the following
- connectionId: -1 (all the subscribed)
- topic: quotations
- Request body (the
unixtimestampmust be in the future of nothing will appear :P )
{
"contentType": "text/plain",
"body": "{ \"symbol\" : \"META\", \"date\" : [UNIXTIMESTAMP]999,\"price\" : 1000, \"volume\" : 1000\n }"
}
- Look on your message on the graph!
If you have Intellij or know what are *.http files you can configure this setting the
myhost variable to DOCKER_SERVER
You can check the quotations going to http:\\py-rest\index.html
- Clone the repo
https://github.com/kendarorg/the-protocol-master-samples.git - Configure your browser to use DOCKER_SERVER:29000 as HTTP/S Proxy
- Navigate to the "python" directory
- Run
docker-compose upto generate the environment - Several containers will be created
- py-tpm: The Protocol Master server
- py-mysql: The mysql database
- py-rabbit: The amqp broker
- py-rest: The application reading mqtt messages (and showing on APIs)
- py-quote-generator: The quote generation (every 10 seconds random stock quotes)
- Download the SSL certificate from http://py-tpm:8081/api/protocols/http-01/plugins/ssl-plugin/der and install it as a trusted root certificate
- Connect your mysql ui to
DOCKER_HOST:23306and use the databasedb
Now your environment is ready for a real test!
- Start the recording on mqtt-01 protocol http://py-tpm:8081/api/protocols/amqp-01/plugins/record-plugin/start
- Delete all records on
db.quotationstable - Wait for some data on
quotationstable (at least 10 seconds, this is the "run-time") - Stop the recording on all protocols http://py-tpm:8081/api/protocols/all/plugins/record-plugin/stop
- You can download all the recordings! http://py-tpm:8081/api/storage/download as a zip file
- Stop the
py-quote-generationcontainer - Stop the
py-restcontainer - Delete all data on
quotationstable - Start the replaying on MQTT http://py-tpm:8081/api/protocols/amqp-01/plugins/replay-plugin/start
- Check the new data on
quotationstable - Mqtt simulation... done!
- Stop the replaying on all protocols http://py-tpm:8081/api/protocols/all/plugins/replay-plugin/stop
- Clone the repo
https://github.com/kendarorg/the-protocol-master-samples.git - Configure your browser to use DOCKER_SERVER:29000 as HTTP/S Proxy
- Navigate to the "golang" directory
- Run
docker-compose upto generate the environment - Several containers will be created
- go-tpm: The Protocol Master server
- go-postgres: The postgres database
- go-redis: The Redis server
- go-rest: The chat application
- Download the SSL certificate from http://go-tpm:8081/api/protocols/http-01/plugins/ssl-plugin/der and install it as a trusted root certificate
- Connect your postgres ui to
DOCKER_HOST:25432and use the databasedb
Now your environment is ready for a real test!
- Start the recording on redis-01 protocol http://go-tpm:8081/api/protocols/redis-01/plugins/record-plugin/start
- Open the proxied browser on http://go-rest/index.html and login as "user1" on channel "common"
- Open another tab of the proxied browser on http://go-rest/index.html and login as "user2" on channel "common"
- Write some messages on both browsers
- Stop the recording on all protocols http://go-tpm:8081/api/protocols/all/plugins/record-plugin/stop
- You can download all the recordings! http://go-tpm:8081/api/storage/download as a zip file
- Start the replaying on REDIS http://go-tpm:8081/api/protocols/redis-01/plugins/replay-plugin/start
- Restart inserting data on the messages
- Stop the replaying on all protocols http://go-tpm:8081/api/protocols/all/plugins/replay-plugin/stop
- Open the message sending API
- Insert the following
- connectionId: -1 (all the subscribed)
- channel: common
- Request body
{
"contentType": "text/plain",
"body": "fake: message"
}
- Look on your message on the chat!