trion/ng-cli

trion/ng-cli (Angular CLI 容器镜像)

Angular CLI的Docker镜像，用作构建容器。

DockerHub镜像地址：https://hub.docker.com/r/trion/ng-cli/

当前该镜像基于Node LTS（16，npm 8）和node:lts-slim作为基础发行版。

AngularCLI分析功能默认禁用，以避免CI环境中的问题。如需启用，将NG_CLI_ANALYTICS环境变量设置为空值即可。

更多信息、商业支持和培训可访问 [***]

示例用法

bash
docker run -u $(id -u) --rm -v "$PWD":/app trion/ng-cli ng new MyDemo
cd MyDemo
docker run -u $(id -u) --rm -v "$PWD":/app trion/ng-cli ng build

若要从Docker运行Angular CLI开发服务器，需映射端口并指示Angular CLI监听所有接口。例如：

bash
cd MyDemo
docker run -u $(id -u) --rm -p 4200:4200 -v "$PWD":/app trion/ng-cli ng serve --host 0.0.0.0

如果需要克隆额外的Git仓库（例如从package.json中），且运行时使用非1000 uid的用户，需挂载passwd文件，因为git需要解析uid：

bash
docker run -u $(id -u) --rm -p 4200:4200 -v /etc/passwd:/etc/passwd -v "$PWD":/app trion/ng-cli npm install

CI环境中的使用

如需在Docker中运行Angular CLI单元测试，请参见docker-ng-cli-karma和docker-ng-cli-e2e项目及对应的trion/ng-cli-karma和trion/ng-cli-e2e Docker镜像。

Angular karma单元测试和webdriver/selenium端到端测试的Docker镜像：

• https://github.com/trion-development/docker-ng-cli-karma
• https://github.com/trion-development/docker-ng-cli-e2e

使用yarn

该镜像预装yarn，可作为替代包管理器使用。若需使用共享缓存目录，需将该目录挂载到镜像中。

使用yarn创建新项目

bash
docker run -u $(id -u) --rm -v "$PWD":/app trion/ng-cli sh -c "ng config -g cli.packageManager yarn; ng new MyDemoProject"

注意：Angular CLI Docker容器实例在每次执行后会被移除，因此包管理器的选择仅影响当前执行。

使用共享缓存

可使用常规yarn缓存目录或指定其他目录。使用前需确保缓存目录已初始化，避免权限问题。

使用常规yarn目录（常规开发时推荐）：

bash
docker run -u $(id -u) --rm -v "$HOME/.cache/yarn":/tmp/.cache/yarn -v "$PWD":/app trion/ng-cli sh -c "ng config -g cli.packageManager yarn; ng new MyDemoProject"

若存在"../yarn-cache"目录且权限正确，可通过以下命令使用该目录创建新项目：

bash
docker run -u $(id -u) --rm -v "$PWD/../yarn-cache":/tmp/.cache/yarn -v "$PWD":/app trion/ng-cli sh -c "ng config -g cli.packageManager yarn; ng new MyDemoProject"

后续包安装（如CI构建中）只需使用yarn而非npm。

离线模式

需使用共享缓存和之前yarn包安装生成的yarn.lock文件。

bash
cd MyDemoProject
docker run -u $(id -u) --rm -v "$PWD/../../yarn-cache":/tmp/.cache/yarn -v "$PWD":/app trion/ng-cli yarn install --offline