peach-devdocs/src/software/microservices/index.md

# Microservices

PeachCloud is built primarily with a [microservices architecture](https://microservices.io/). Each microservice utilises [JSON-RPC](https://www.jsonrpc.org/specification) - a stateless, light-weight remote procedure call protocol - as a means of exposing functionality and allowing interoperability. This approach produces a collection of services which are highly maintainable and testable, loosely coupled and independently deployable. HTTP and WebSockets are used as transports for the microservices.

The suite of PeachCloud microservices currently includes:

 - **peach-buttons** [(repo)](https://github.com/peachcloud/peach-buttons)
   - poll GPIO pins for button presses and emit events via pub-sub
 - **peach-menu** [(repo)](https://github.com/peachcloud/peach-menu)
   - monitor and interact with the device via the physical interface
 - **peach-network** [(repo)](https://github.com/peachcloud/peach-network)
   - query and configure network interfaces
 - **peach-oled** [(repo)](https://github.com/peachcloud/peach-oled)
   - write and draw to the OLED display
 - **peach-stats** [(repo)](https://github.com/peachcloud/peach-menu)
   - query system statistics
Initial commit with draft chapter outline 2019-10-14 18:01:25 +00:00			`# Microservices`
Populate chapters from existing docs 2019-10-15 14:47:13 +00:00
			PeachCloud is built primarily with a [microservices architecture](https://microservices.io/). Each microservice utilises [JSON-RPC](https://www.jsonrpc.org/specification) - a stateless, light-weight remote procedure call protocol - as a means of exposing functionality and allowing interoperability. This approach produces a collection of services which are highly maintainable and testable, loosely coupled and independently deployable. HTTP and WebSockets are used as transports for the microservices.

			`The suite of PeachCloud microservices currently includes:`

Add file trees for all microservices 2019-10-30 14:44:18 +00:00			`- peach-buttons [(repo)](https://github.com/peachcloud/peach-buttons)`
Populate chapters from existing docs 2019-10-15 14:47:13 +00:00			`- poll GPIO pins for button presses and emit events via pub-sub`
Add file trees for all microservices 2019-10-30 14:44:18 +00:00			`- peach-menu [(repo)](https://github.com/peachcloud/peach-menu)`
Populate chapters from existing docs 2019-10-15 14:47:13 +00:00			`- monitor and interact with the device via the physical interface`
Add file trees for all microservices 2019-10-30 14:44:18 +00:00			`- peach-network [(repo)](https://github.com/peachcloud/peach-network)`
Populate chapters from existing docs 2019-10-15 14:47:13 +00:00			`- query and configure network interfaces`
Add file trees for all microservices 2019-10-30 14:44:18 +00:00			`- peach-oled [(repo)](https://github.com/peachcloud/peach-oled)`
Populate chapters from existing docs 2019-10-15 14:47:13 +00:00			`- write and draw to the OLED display`
Add file trees for all microservices 2019-10-30 14:44:18 +00:00			`- peach-stats [(repo)](https://github.com/peachcloud/peach-menu)`
Populate chapters from existing docs 2019-10-15 14:47:13 +00:00			`- query system statistics`