nishadangre/nodejs

Node.js AWS ECS CI/CD镜像 (GitLab Runner专用)

概述

本Docker镜像专为基于GitLab Runner的AWS ECS CI/CD流程设计，集成Node.js运行环境与AWS ECS部署工具链，旨在简化Node.js应用的自动化构建、测试及部署流程，实现从代码提交到AWS ECS集群部署的全流程自动化。

核心功能与特性

• 内置Node.js环境：预安装指定版本Node.js及npm/yarn包管理工具，满足Node.js应用构建需求
• GitLab Runner兼容：适配GitLab CI/CD流程，可直接作为GitLab Runner执行器环境
• AWS ECS工具集成：包含AWS CLI、ECS CLI等工具，支持与AWS ECS服务交互
• 轻量级设计：基于Alpine Linux构建，减小镜像体积，提升CI/CD流程效率
• 多版本支持：提供多种Node.js版本标签（如14.x、16.x、18.x），适配不同应用需求

使用场景与适用范围

• 需通过GitLab CI/CD自动化部署到AWS ECS的Node.js应用（如Web应用、API服务、微服务等）
• DevOps团队实现Node.js应用的持续集成（代码检查、单元测试、构建）与持续部署（ECS服务更新）
• 需要在CI/CD流程中执行AWS ECS相关操作（如任务定义更新、服务部署）的场景

使用方法与配置说明

1. 拉取镜像

bash
# 拉取指定Node.js版本（以18.x为例）
docker pull [镜像仓库地址]/nodejs-ecs-cicd:18-alpine

2. 基本使用（本地测试）

bash
# 启动容器并挂载应用代码目录
docker run -it --rm \
  -v $(pwd):/app \
  -e AWS_ACCESS_KEY_ID=your_aws_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret \
  -e AWS_REGION=us-east-1 \
  [镜像仓库地址]/nodejs-ecs-cicd:18-alpine \
  sh -c "cd /app && npm install && npm run build"

3. GitLab CI/CD配置示例（.gitlab-ci.yml）

yaml
stages:
  - build
  - test
  - deploy

variables:
  NODE_VERSION: 18
  AWS_REGION: us-east-1
  ECS_CLUSTER: my-ecs-cluster
  ECS_SERVICE: my-node-service
  ECS_TASK_DEFINITION: task-definition.json

build:
  stage: build
  image: [镜像仓库地址]/nodejs-ecs-cicd:${NODE_VERSION}-alpine
  script:
    - npm install
    - npm run build
    - zip -r build.zip dist/ package.json package-lock.json

test:
  stage: test
  image: [镜像仓库地址]/nodejs-ecs-cicd:${NODE_VERSION}-alpine
  script:
    - npm install
    - npm run test

deploy_to_ecs:
  stage: deploy
  image: [镜像仓库地址]/nodejs-ecs-cicd:${NODE_VERSION}-alpine
  script:
    - aws configure set aws_access_key_id $AWS_ACCESS_KEY_ID
    - aws configure set aws_secret_access_key $AWS_SECRET_ACCESS_KEY
    - aws configure set region $AWS_REGION
    - aws ecs update-service --cluster $ECS_CLUSTER --service $ECS_SERVICE --force-new-deployment
  only:
    - main

4. 环境变量说明

5. Docker Compose配置示例

yaml
version: '3'
services:
  nodejs-cicd:
    image: [镜像仓库地址]/nodejs-ecs-cicd:18-alpine
    volumes:
      - ./app:/app
    environment:
      - AWS_ACCESS_KEY_ID=your_aws_key
      - AWS_SECRET_ACCESS_KEY=your_aws_secret
      - AWS_REGION=us-east-1
    command: sh -c "cd /app && npm install && npm run build && aws ecs update-service --cluster my-cluster --service my-service --force-new-deployment"

注意事项

• 确保GitLab Runner已配置Docker执行器权限
• AWS密钥需具备ECS服务更新权限（推荐使用IAM角色而非长期密钥）
• 根据应用需求选择合适的Node.js版本标签，避免版本兼容性问题
• 生产环境建议通过GitLab CI/CD变量管理敏感信息（如AWS密钥），避免硬编码