121 lines
4.3 KiB
Markdown
121 lines
4.3 KiB
Markdown
|
[](https://circleci.com/gh/yldio/joyent-portal)
|
||
|
|
[](https://opensource.org/licenses/MPL-2.0)
|
||
|
|
|
||
|
|
# Prototype Triton Portal
|
||
|
|
|
||
|
|
This is a prototype project intended to explore some ideas that might contribute to new capabilities and a new user experience for managing applications on [Joyent's Triton](https://www.joyent.com/triton).
|
||
|
|
|
||
|
|
**This is not intended for general use and is completely unsupported.**
|
||
|
|
|
||
|
|
## Our Principles
|
||
|
|
We have designed this product with these principles in mind (to be completed).
|
||
|
|
|
||
|
|
## Our Design Library
|
||
|
|
We use inVision craft for our design components, you can downoad this library [here](https://drive.google.com/open?id=0Bw56g3tFwIuWOXNHUDZmRmQ3ZlE) and submit proposed changes to our Sketch wireframes [here](https://drive.google.com/open?id=0B1oWObk56wa5cE5iY2JWNmI2djg).
|
||
|
|
|
||
|
|
## Documentation
|
||
|
|
Our workshop meeting notes are kept in this [Google Drive folder](https://drive.google.com/open?id=0B1oWObk56wa5eklBNGFlWFRFOHM). Our meeting notes are kept in this [Google Drive folder](https://drive.google.com/open?id=0B1oWObk56wa5N1VzZjhZWWpDTTQ).
|
||
|
|
|
||
|
|
## 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](https://yarnpkg.com/en/docs/install) for installing dependencies,
|
||
|
|
as well as `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. [node-triton](https://github.com/joyent/node-triton)
|
||
|
|
is also needed if deployment to Triton is required.
|
||
|
|
|
||
|
|
```
|
||
|
|
make && make install
|
||
|
|
```
|
||
|
|
|
||
|
|
Then to run each individual component locally (subject to change).
|
||
|
|
|
||
|
|
## Setup
|
||
|
|
|
||
|
|
```sh
|
||
|
|
make
|
||
|
|
```
|
||
|
|
|
||
|
|
## Run services
|
||
|
|
|
||
|
|
To run the stack locally:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
docker-compose -f local-compose.yml up -d
|
||
|
|
```
|
||
|
|
|
||
|
|
This will run the front-end at [http://127.0.0.1:8000](http://127.0.0.1:8000),
|
||
|
|
the UI framework at [http://127.0.0.1:8001](http://127.0.0.1:8001),
|
||
|
|
|
||
|
|
## Project Management
|
||
|
|
|
||
|
|
This project is using [Github Projects](https://www.youtube.com/watch?v=C6MGKHkNtxU) 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
|
||
|
|
├── docs
|
||
|
|
├── frontend
|
||
|
|
├── nginx
|
||
|
|
├── ui
|
||
|
|
└── spikes
|
||
|
|
```
|
||
|
|
|
||
|
|
### cloudapi-graphql
|
||
|
|
|
||
|
|
An implementation of the [Joyent CloudAPI](https://apidocs.joyent.com/cloudapi/) in GraphQL.
|
||
|
|
|
||
|
|
### Docs
|
||
|
|
|
||
|
|
Documentation about the project, mainly focused on information for the technical runnings of this project.
|
||
|
|
Can be view online at the [documentation website](http://docs.svc.f4b20699-b323-4452-9091-977895896da6.eu-ams-1.triton.zone/)
|
||
|
|
|
||
|
|
### 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.
|
||
|
|
|
||
|
|
### Git LFS
|
||
|
|
- We are using Git LFS to track large files, such as design files in Sketch.
|
||
|
|
- Make sure you have this downloaded locally
|
||
|
|
`brew install git-lfs`
|
||
|
|
|
||
|
|
#### Helpful tips
|
||
|
|
- If there is an error cloning to a new machine, or there is an error cloning in the Circle CI process run `git lfs push origin master --all` from a machine that has it already checked out.
|
||
|
|
|
||
|
|
### Sketch Pre Commit
|
||
|
|
|
||
|
|
A pre-commit hook has been added to generate a PNG shot of each .sketch file "page".
|
||
|
|
|
||
|
|
To use, make sure the following are installed:
|
||
|
|
- [Sketch Toolbox](http://sketchtoolbox.com/)
|
||
|
|
- [Sketch Measure Plugin](https://github.com/utom/sketch-measure)
|
||
|
|
|
||
|
|
|
||
|
|
Then add following to your `.git/config`
|
||
|
|
|
||
|
|
```
|
||
|
|
[diff "sketchtool"]
|
||
|
|
textconv = "sketchtool dump"
|
||
|
|
cachetextconv = true
|
||
|
|
```
|