Recipes & known issues

Aurelia CLI Bundler + Docker

Recipe:

1. Dockerfile Configuration:

   FROM node:14
   WORKDIR /app
   COPY package*.json ./
   RUN npm install
   COPY . .
   RUN au build --env prod
   CMD ["npm", "start"]

2. Build and Run:

   docker build -t your-app-name .
   docker run -p 8080:8080 your-app-name

Ensure the Dockerfile copies all necessary files and sets the correct working directory.

NPM Uninstalling Packages

Issue: Uninstalling a package without updating aurelia.json can lead to build errors.

Solution:

1. Uninstall the Package:

   npm uninstall <package-name> --save

2. Remove from aurelia.json:

   • Delete any references in the dependencies array.

   • Update copyFiles if assets were previously copied.

Always verify dependency configurations after uninstalling packages.

Building with TFS

Issue: Team Foundation Server (TFS) builds may fail due to environment discrepancies.

Solution:

1. Ensure Node.js and NPM are Installed:

   • Configure build agents with necessary tools.

2. Install Dependencies During Build:

   • Add npm install as a build step before running build commands.

3. Run Build Commands:

   au build --env prod

Use TFS build pipelines to automate these steps for consistency.

For more detailed configurations and advanced usage, refer to the Aurelia CLI GitHub Repository.