figurepos/aws-node-terraform

CircleCI构建专用Docker镜像

镜像概述

本Docker镜像专为CircleCI持续集成/持续部署(CI/CD)流程设计，集成了Node.js运行环境、AWS命令行工具(AWS CLI)和Terraform命令行工具，旨在简化需要同时进行应用构建、云资源管理和基础设施部署的CI/CD工作流配置。

核心功能与特性

• 多工具不集成：包含Node.js（支持JavaScript/TypeScript项目构建）、AWS CLI（用于AWS云资源操作）和Terraform CLI（用于基础设施即代码管理）
• CircleCI适配：优化用于CircleCI环境，可直接作为构建环境镜像使用
• 简化配置：减少CI/CD流程中工具安装步骤，缩短构建时间
• 标准化环境：提供一致的构建环境，避免因工具版本差异导致的构建问题

使用场景

• 前端/后端JavaScript/TypeScript项目的CircleCI自动化构建与测试
• 需要通过AWS CLI进行AWS资源创建、配置或部署的CI/CD流程
• 使用Terraform管理基础设施的项目，在CI/CD中执行terraform plan、terraform apply等操作
• 同时涉及应用构建、云资源操作和基础设施部署的综合CI/CD场景

使用方法与配置说明

基础使用（Docker Run）

bash
# 基本运行命令
docker run --rm -it [镜像名称] /bin/bash

# 执行Node.js版本检查
docker run --rm [镜像名称] node -v

# 执行AWS CLI版本检查
docker run --rm [镜像名称] aws --version

# 执行Terraform版本检查
docker run --rm [镜像名称] terraform --version

CircleCI配置示例

在.circleci/config.yml中使用该镜像作为构建环境：

yaml
version: 2.1

jobs:
  build-and-deploy:
    docker:
      - image: [镜像名称]  # 替换为实际镜像名称
    steps:
      - checkout
      
      # Node.js项目构建示例
      - run:
          name: 安装依赖并构建项目
          command: |
            npm install
            npm run build
      
      # AWS CLI操作示例（需提前配置AWS凭证）
      - run:
          name: 同步构建产物至S3
          command: aws s3 sync ./dist s3://your-bucket-name --delete
      
      # Terraform部署示例
      - run:
          name: 部署基础设施
          command: |
            cd terraform
            terraform init
            terraform plan
            terraform apply -auto-approve

workflows:
  main:
    jobs:
      - build-and-deploy

环境变量配置

使用该镜像时，可通过环境变量配置工具行为：

• NODE_ENV：Node.js环境变量（如production、development）
• AWS_ACCESS_KEY_ID：AWS CLI访问密钥ID（用于AWS认证）
• AWS_SECRET_ACCESS_KEY：AWS CLI密钥（用于AWS认证）
• AWS_REGION：AWS CLI默认区域（如us-east-1）
• TF_VAR_*：Terraform变量（如TF_VAR_environment=production）

注意事项

• 使用AWS CLI和Terraform时，需确保正确配置认证信息（通过环境变量或配置文件）
• 根据项目需求，可能需要在使用前更新工具版本（如npm update -g aws-cli）
• 敏感信息（如AWS密钥）建议通过CircleCI项目环境变量安全注入，避免硬编码