11794 2017-07-14 18:26:34 +0000 Add remote HTTP API to enable status aggregation of multiple Toaster instances 2017-08-01 02:01:37 +0000 1 1 7 Build System, Metadata & Runtime Toaster toaster 2.4 All Multiple RESOLVED FIXED Medium enhancement 2.4 M3 1 konrad.scherer david.reyna jessica.zhang stanciux.mihail libertad.gonzalez.de.la.cruz --- --- Yes (doc changes required) oldest_to_newest 75042 0 konrad.scherer 2017-07-14 18:26:34 +0000 I am creating a very basic Toaster Aggregation webapp for a build cluster of potentially 100+ machines. The idea is that each build will be running Toaster and the webapp will show a list of all currently running builds with progress information and a direct link to each individual toaster instance. I suggest the following endpoints: /health: Returns 200 if Toaster instance is healthy. This will help remove inactive Toaster instances from the webapp quickly. /builds: Returns json with a list of names of currently running builds /build/<name>: Returns json with build status for the build with <name>. This should include at minimum the current progress but could include any other relevant status information. If the status information is limited, this endpoint could be merged with the /builds endpoint. 75046 1 david.reyna 2017-07-14 18:45:50 +0000 The patterns "/builds" and "build/<name>" are currently already used for the normal full GUI pages, so I will propose alternate names. FYI, the Toaster URL patterns are encoded here: bitbake/lib/toaster/toastergui/urls.py 75047 2 david.reyna 2017-07-14 19:21:17 +0000 The counter proposal is: /api/builds /api/build/<name> This makes sense in that it follows the Layer Index model for the back end data. 75122 3 david.reyna 2017-07-18 22:29:30 +0000 Here are the example API calls and output, with the returned JSON data fanned out and sorted for clarity. 1) "localhost:8000/toastergui/api/building" {"count": 1, "building": [ {"id": 22, "name": "20170718220837", "project": "foo", "target": "core-image-base", "distro": "poky", "machine": "qemux86", "start": "2017-07-18T22:07:48.083Z", "seconds": "32.783", "clone": "1:1"} "parse": "800:803", "task": "0:0", }] } 2) "localhost:8000/toastergui/api/builds" {"count": 1, "builds": [ {"id": 21, "outcome": "Succeeded", "name": "20170630232654", "project": "Command line builds", "target": "core-image-base", "distro": "poky" "machine": "qemux86", "start": "2017-06-30T23:26:47.767Z", "stop": "2017-06-30T23:35:32.753Z", "seconds": "524.986", "errors": 0, "warnings": 0, }] } 3) "localhost:8000/health" "Ok" Source: <!DOCTYPE html> <html lang="en"> <head><title>Toaster Health</title></head> <body>Ok</body> </html> 75527 4 david.reyna 2017-08-01 02:01:37 +0000 commit 3bc3d26b465b5af3cebc1d4c0d1fa382965c32cf