samherrmann/angular-cli repository overview

⁠Angular CLI

A Docker image for running Angular CLI⁠ in a container.

⁠Benefits

• Eliminate the need to manually confirm that you are running a version of Node.js/npm that is compatible with your version of Angular CLI.
• Ensure that all developers are running the same version of the build tools.
• Ensure that the build machine is running the same version of the build tools as the developers.
• Make switching between projects with different versions of the build tools transparent to the developers.
• Ensure that builds are reproducible.

⁠Usage

⁠One-Time Setup

1. Create a new Angular CLI project:

   docker run -it --rm -v $(pwd):/code --entrypoint ng samherrmann/angular-cli new my-app
   

   Copy

2. Copy the npm.sh⁠ script into your project's root directory.

   • Change the latest version tag inside the npm.sh script to the actual version of the image (Ex: Replace latest with 1.6.2).
   • Commit it to your version control system.

3. Add the following configuration to angular.json to make the app accessible from the browser on the host machine:

     "defaults": {
       "serve": {
         "host": "0.0.0.0"
       }
     }
   

   Copy

4. Modify karma.conf.js to use headless Chrome:

   browsers: ['customChrome'],
   customLaunchers: {
     customChrome: {
       base: 'ChromiumHeadless',
       flags: ['--headless', '--no-sandbox']
     }
   }
   

   Copy

5. Modify protractor.conf.js to use headless Chrome:

   chromeDriver: '/usr/bin/chromedriver',
   capabilities: {
     browserName: 'chrome',
     chromeOptions: {
       args: ['--headless', '--no-sandbox']
     }
   }
   

   Copy

6. Modify the e2e script in package.jsonto run e2e tests without updating drivers:

   "e2e": "ng e2e --webdriver-update=false"
   

   Copy

⁠Development Workflow

Execute Angular CLI commands:

./npm.sh run ng g m my-module

./npm.sh run ng g c my-module/my-component

Execute npm commands:

./npm.sh install <my-new-lib>

./npm.sh start

./npm.sh run lint

./npm.sh run test

./npm.sh run e2e

⁠Development

This project uses Docker Hub to build and publish images. Changes made to this repository are built by Docker Hub's automated build system and published as follows:

See the hooks directory for Docker Hub automated build configurations.

⁠Updating Image

1. Check available versions from resources listed below
2. Change version tags as desired in hooks/build
3. Commit changes and tag commit with version of Angular CLI (e.g. v1.2.3)
4. Push commit to GitHub with git push && git push --tags
5. Verify new image is published on Docker Hub⁠

⁠Available Versions

• Node.js⁠
• @angular/cli⁠
• @angular-devkit/schematics-cli⁠