Advanced - UI Custom Base Path
This document lists the instructions for building an aerie-ui Docker image with a custom base path.
Building
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 installWhen 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
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
.Build the aerie-ui.
npm run build
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 .
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
Svelte Kit Issues
Once this issue is resolved we will no longer need this document.