ldoughty/cicd-docker-aws-node

cicd-docker-aws-node

镜像概述

cicd-docker-aws-node是一个专为CI/CD流水线设计的辅助镜像，旨在简化使用Docker、AWS CLI和Node.js/npm工具链的自动化流程。该镜像整合了核心开发和部署工具，减少了CI/CD环境配置的复杂性，提升流水线效率。

核心功能与特性

• 核心工具集成：包含Docker客户端、AWS CLI和Node.js（及npm），满足容器化构建、云资源管理和Node.js应用开发需求
• 支持工具完备：内置SSH（远程访问）、Git（版本控制）、rsync（文件同步）等辅助工具，覆盖CI/CD流程中的常见操作场景
• 轻量设计：在确保功能完整性的前提下保持镜像体积精简，适合CI/CD环境快速拉取和启动

使用场景与适用范围

适用于需要在CI/CD流程中执行以下操作的场景：

• Docker镜像构建、推送或运行
• 通过AWS CLI管理AWS资源（如S3对象存储、ECS容器服务、Lambda函数等）
• Node.js应用的依赖安装、代码测试、打包或部署
• 跨服务器文件同步（通过rsync）或远程命令执行（通过SSH）
• 从Git仓库拉取代码或提交版本更新

使用方法与配置说明

镜像拉取

从镜像仓库拉取最新版本（具体仓库地址需根据实际部署环境调整）：

bash
docker pull cicd-docker-aws-node:latest

基础运行命令

在CI/CD环境中直接运行镜像并执行命令：

bash
docker run --rm cicd-docker-aws-node [需要执行的命令]

说明：--rm 参数确保容器退出后自动清理，避免资源残留

典型使用示例

1. Node.js应用测试

挂载当前工作目录并运行npm测试：

bash
docker run --rm -v $(pwd):/app -w /app cicd-docker-aws-node npm test

• -v $(pwd):/app：将宿主机当前目录挂载到容器内/app目录
• -w /app：设置工作目录为/app，确保命令在项目根目录执行

2. AWS资源操作

通过环境变量注入AWS凭证，执行S3文件上传：

bash
docker run --rm \
  -v $(pwd):/app \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  -w /app \
  cicd-docker-aws-node \
  aws s3 cp /app/dist s3://your-bucket-name/ --recursive

3. Docker镜像构建与推送

在容器内构建并推送Docker镜像（需确保宿主机Docker服务可访问）：

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd):/app \
  -w /app \
  cicd-docker-aws-node \
  sh -c "docker build -t my-app:latest . && docker push my-app:latest"

• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程套接字，使容器内Docker客户端可访问宿主机Docker服务

注意事项

• 敏感信息（如AWS凭证）建议通过环境变量注入，避免硬编码在命令或配置文件中
• 根据CI/CD平台特性（如GitHub Actions、GitLab CI等），可能需要通过平台内置的挂载机制或服务连接配置网络访问
• 如需持久化工具配置（如SSH密钥、Git凭据），可通过挂载配置目录（如~/.ssh:/root/.ssh）实现