dcos-universe-browser

The repository provides a web application for browsing the DC/OS Universe packages.

Using

You can find the deployed application at https://universe.dcos.io, install it locally, or use the dcoslabs/dcos-universe-browser Docker image.

You can host a local instance via

git clone https://github.com/dcos-labs/dcos-universe-browser.git

and installing the dependencies with

npm run install-deps

and starting the application with

npm start

You can run the application via a Docker image like this:

docker run -d --name dcos-universe-browser -p 3000:3000 dcoslabs/dcos-universe-browser

This will expose the application on port 3000 on the Docker host.

You can use the following environment variables to influence the application's behavior:

HOST: The IP address to which the application should bind to. Default is 127.0.0.1.
PORT0: The port on which the application is binding to. Default is 3000.
NODE_ENV: The environment settings for Node.js. Default is development, the Docker image uses production as default.
REFRESH_UNIVERSE: The number of milliseconds to wait before a refresh of the Universe package info. The application caches the package info locally, and refreshes it in intervals as defined. Default is 3600000 (one hour).
REFRESH_EXAMPLES: The number of milliseconds to wait before a refresh of dcos/examples data. The application does a git clone on start, and refreshes it (via git pull) in intervals as defined. Default is 3600000 (one hour).

How is it built?

The backend is a Node.js application, using Express.js to serve static files, and a REST API which is a wrapper around the Universe data.
The frontend is an Angular 1 app, using Bootstrap 3 and various third-party modules.

What does this application do?

It fetches the DC/OS Universe information from https://universe.mesosphere.com/repo, optimizes the data structures for UI usage, and caches it until the next request interval.
It clones the dcos/examples project, containing the DC/OS package examples, and merges them with the Universe information. The markdown is rendered as HTML dynamically.
It renders the combined data as a web application (see above).