mlaurie/aws-angular-builder

AWS Angular Builder

这是一个简单的Docker容器，支持使用Angular CLI构建Angular应用，并将构建产物推送到AWS环境（如S3存储桶）。

快速开始

查看Angular CLI版本：

bash
docker run -it mlaurie/aws-angular-builder ng --version

查看AWS CLI版本：

bash
docker run -it mlaurie/aws-angular-builder aws --version

版本信息

完整版本历史请参考https://github.com/MattLaurie/aws-angular-builder/blob/master/VERSIONS.md%E3%80%82

注意：从1.4.3版本开始，镜像版本将与Angular CLI版本同步。例如，mlaurie/aws-angular-builder:8.3.4使用Angular CLI 8.3.4。如有问题请反馈。

版本变更详情见https://github.com/MattLaurie/aws-angular-builder/blob/master/CHANGELOG.md%E3%80%82%60latest%60%E6%A0%87%E7%AD%BE%E4%BC%9A%E9%9A%8FAngular CLI和AWS CLI的更新而同步更新。建议在持续构建系统中使用带标签的版本（如8.3.4）以确保工具版本稳定。当前使用的Node.js稳定版本为6.11。

自行构建镜像

脚本check-update.sh可检查Angular CLI和AWS CLI的更新：

bash
./check-update.sh

带-u参数可更新Dockerfile中的版本：

bash
./check-update.sh -u

注意：此脚本依赖jq工具，请参考https://stedolan.github.io/jq/%E5%AE%89%E8%A3%85%E3%80%82

使用场景示例：Bitbucket Pipelines集成

该镜像的主要用途是集成Bitbucket Pipelines，实现Angular项目的自动构建与S3部署。以下配置示例实现：

1. 非master分支推送时执行基础构建；
2. master分支推送时执行生产构建并部署到S3。

bitbucket-pipelines.yml配置：

yaml
image:
  name: mlaurie/aws-angular-builder:8.3.4

clone:
  depth: 1

pipelines:
  default:
    - step:
        script:
        - npm install
        - ng build
  branches:
    master:
      - step:
          script:
          - npm install
          - ng build --prod
          - sh ./deploy.sh

deploy.sh脚本：

bash
#!/bin/bash
export AWS_ACCESS_KEY_ID=$awsAccessKeyId
export AWS_SECRET_ACCESS_KEY=$awsSecretAccessKeyPassword
export AWS_DEFAULT_REGION=us-east-1

BUCKET_TARGET=$awsBucketTarget

aws s3 cp dist/ s3://$BUCKET_TARGET --recursive --acl public-read

其中$awsAccessKeyId、$awsSecretAccessKeyPassword和$awsBucketTarget为Bitbucket Pipelines中配置的环境变量，建议将AWS凭证设为保密变量。bitbucket-pipelines.yml和deploy.sh需放置在项目仓库中。