github.com/zoomfoo/nomad@v0.8.5-0.20180907175415-f28fd3a1a056/ui/README.md (about)

     1  # Nomad UI
     2  
     3  The official Nomad UI.
     4  
     5  ## Prerequisites
     6  
     7  This is an [ember.js](https://emberjs.com/) project, and you will need the following tools installed on your computer.
     8  
     9  * [Node.js](https://nodejs.org/)
    10  * [Yarn](https://yarnpkg.com)
    11  * [Ember CLI](https://ember-cli.com/)
    12  * [PhantomJS](http://phantomjs.org/) (for running tests)
    13  
    14  ## Installation
    15  
    16  The Nomad UI gets cloned along with the rest of Nomad. To install dependencies, do the following from the root of the Nomad project:
    17  
    18  ```
    19  $ cd ui
    20  $ yarn
    21  ```
    22  
    23  ## Running / Development
    24  
    25  First, make sure nomad is running. The UI, in development mode, runs independently from Nomad, so this could be an official release or a dev branch. Likewise, Nomad can be running in server mode or dev mode. As long as the API is accessible, the UI will work as expected.
    26  
    27  * `ember serve`
    28  * Visit your app at [http://localhost:4200](http://localhost:4200).
    29  
    30  ## Running / Development with Vagrant
    31  
    32  All necessary tools for UI development are installed as part of the Vagrantfile. This is primarily to make it easy to build the UI from source while working on Nomad. Due to the filesystem requirements of [Broccoli](http://broccolijs.com/) (which powers Ember CLI), it is strongly discouraged to use Vagrant for developing changes to the UI.
    33  
    34  That said, development with Vagrant is still possible, but the `ember serve` command requires two modifications:
    35  
    36  * `--watch polling`: This allows the vm to notice file changes made in the host environment.
    37  * `--port 4201`: The default port 4200 is not forwarded, since local development is recommended.
    38  
    39  This makes the full command for running the UI in development mode in Vagrant:
    40  
    41  ```
    42  $ ember serve --watch polling --port 4201
    43  ```
    44  
    45  ### Running Tests
    46  
    47  Nomad UI tests can be run independently of Nomad golang tests.
    48  
    49  * `ember test` (single run, headless browser)
    50  * `ember test --server` (watches for changes, runs in a full browser)
    51  
    52  ### Building
    53  
    54  Typically `make release` or `make dev-ui` will be the desired build workflow, but in the event that build artifacts need to be inspected, `ember build` will output compiled files in `ui/dist`.
    55  
    56  * `ember build` (development)
    57  * `ember build --environment production` (production)
    58  
    59  ### Releasing
    60  
    61  Nomad UI releases are in lockstep with Nomad releases and are integrated into the `make release` toolchain.
    62  
    63  ### Troubleshooting
    64  
    65  #### The UI is running, but none of the API requests are working
    66  
    67  By default (according to the `.embercli` file) a proxy address of `http://localhost:4646` is used. If you are running Nomad at a different address, you will need to override this setting when running ember serve: `ember serve --proxy http://newlocation:1111`.
    68  
    69  #### Nomad is running in Vagrant, but I can't access the API from my host machine
    70  
    71  Nomad binds to `127.0.0.1:4646` by default, which is the loopback address. Try running nomad bound to `0.0.0.0`: `bin/nomad -bind 0.0.0.0`.
    72  
    73  Ports also need to be forwarded in the Vagrantfile. 4646 is already forwarded, but if a port other than the default is being used, that port needs to be added to the Vagrantfile and `vagrant reload` needs to be run.