Skip to content

cloudnativedaysjp/showks-aggregator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

showKs Aggregator

Japan Container Days - showKs Aggregator is a server application which aggregates deployed showks-canvas container information and let clients access the data via Socket.io channel. It also caches canvas thumbnail for better performance.

How to use

Run as a container

$ docker build -t <your username>/showks-aggregator:<your tag> .
$ docker run -p <desired port>:8081 -d <your username>/showks-aggregator:<your tag>

Run with Node.js runtime

$ cd src
$ npm install
$ npm start

Open http://<your host>:8081 with a web browser.

HTTP Endpoints

Endpoint Description
/instances List all available instances (JSON)
/<ID> Instance metadata (JSON) specified with <ID>
/<ID>/thumbnail Canvas thumbnail (PNG) of the container specified with <ID>

JSON Format

/instances:

[ instance1, instance2, ... ]

/<ID>: instance

instance:

{
    id: "Instance ID",
    linkUrl: "Public URL to the instance",
    thumbnailUrl: "Thumbnail image path from the web root",
    author: "Author JSON*",
    createdAt: "Created time in number of milliseconds since 1970/01/01"
}

* See showKs-webapp README for the author JSON format

Socket.IO Namespaces

Namespace Description
/instance Notifies the client of 'updated' message with ID as its value when a container instance is created or updated, or 'deleted' message with ID when an instance is removed from the server.

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •