Skip to main content

Advanced - UI Custom Base Path

This document lists the instructions for building an aerie-ui Docker image with a custom base path.

Building

  1. Clone the aerie-ui and install dependencies. Note that Node LTS is required (currently 18.13.0).

    git clone https://github.com/NASA-AMMOS/aerie-ui.git
    cd aerie-ui
    npm install

    When you clone aerie-ui the default branch is develop. If you want to build an image from a specific release you have to checkout the proper tag. For example to checkout v1.0.0 do:

    git checkout tags/v1.0.0 -b v1.0.0
  2. Update svelte.config.js with the base path you want to use. Note that a leading / is required. So for example a valid base path is /aerie.

  3. Build the aerie-ui.

    npm run build
  4. Build the aerie-ui Docker image. Change the tag as necessary. For example we tag the image here with aerie-ui:

    docker build -t aerie-ui .
  5. Use the newly built image as part of your normal Aerie Docker deployment.

Cleaning

If you ever need to re-run through these instructions make sure you always start from a clean environment. Remove all dependencies and build artifacts in aerie-ui:

rm -rf node_modules
rm -rf .svelte-kit
rm -rf build

Remove the built Docker image:

docker rmi aerie-ui

References

  1. aerie-ui Developer.md
  2. aerie-ui Deployment.md

Svelte Kit Issues

Once this issue is resolved we will no longer need this document.

  1. Dynamic basepath