alexxnica / dcos-ui

The UI for The Datacenter Operating System

DC/OS UI

The User Interface for The Datacenter Operating System.

The DC/OS UI is used by datacenter operators to administer and manage a datacenter. Developers use DC/OS UI to manage, deploy and debug their applications. The DC/OS UI sits at the top of the DC/OS stack along with the CLI.

• Issue tracker. Use component dcos-ui.
• Documentation
• Apache License v2

Usage

Requirements

Node 4.4.x and NPM 3.9.x (and above) are required. We suggest using nvm or n to keep multiple Node versions on your system.

DC/OS Installation Instructions:

1. Follow the instructions here to install a local cluster.
2. Clone this repo:

git clone [email protected]:dcos/dcos-ui.git && cd dcos-ui

3. Install dependencies:

npm i

4. Add developer files for config overrides:

npm run scaffold

This will create webpack/proxy.dev.js and src/js/config/Config.dev.js. These files aren't tracked by git and provide a place to override proxy and general dcos-ui configuration. Edit webpack/proxy.dev.js to point to the address of the dcos-vagrant machine.

5. Start the development server:

npm start

6. Navigate to http://localhost:4200

Using External Plugins

DC/OS UI comes bundled with some internal plugins within the /plugins directory. You can also load more plugins from another directory and they will be loaded into DC/OS UI along with the internal plugins. To set a directory for external plugins run:

npm config set externalplugins ../relative/path/to/plugins/directory

Contributing

Contributing Guidelines

Testing

See more info on testing here.

License and Author

Copyright Mesosphere, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this repository except in compliance with the License.

The contents of this repository are solely licensed under the terms described in the LICENSE file included in this repository.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Authors are listed in Authors.md file.