joyent-portal/README.md

2.3 KiB

CircleCI License: MPL 2.0

Joyent Portal

Before you begin, you will need to install ensure that docker and docker-compose are installed correctly, this can be done by running make, make continues without any errors, then you are good to go.

Setup

make

Run services

To run the stack locally:

docker-compose -f local-compose.yml up -d

This will run the front-end at http://127.0.0.1:8000, the UI framework at http://127.0.0.1:8001,

Development

If you would like to contribute to the project, the recommended way to setup is to insure that you have docker installed, and optionally have a triton account and profile setup using the triton tool.

Currently requires yarn for installing dependencies.

make && make install

Then to run each individual component locally (subject to change).

Project Management

This project is using Github Projects for organisation and development of the Joyent Dashboard.

Repository Layout

Currently we are using this repository as a monolithic catch-all for all project communication, development and designs. We will also include multiple PoC's of various bits of functionality from UI's prototypes to API development.

.
├── cloudapi-graphql
├── frontend
├── nginx
├── ui
└── spikes

cloudapi-graphql

An implementation of the Joyent CloudAPI in GraphQL.

frontend

The client side code with a dev-server, this also includes the production server for the meantime, however we are looking at moving towards a deployment of the build artifacts to manta, and another server to host these assets.

nginx

Nginx will be sitting in-front of the ui service, allowing the ui to scale out.

ui

Code for the reusable UI framework.

spikes

Implementation examples from spikes, this directory is experimental and is likely broken.