mzgroup/dind-awscli-nodejs

Docker in Docker with NodeJS and AWS CLI 镜像文档

镜像概述

本镜像基于Docker in Docker（DinD）技术构建，集成NodeJS运行环境与AWS CLI工具，提供一站式容器化环境，支持在容器内部执行Docker命令、开发NodeJS应用及管理AWS云服务资源。

核心功能与特性

• Docker in Docker支持：内置Docker引擎，可在容器内直接运行docker build、docker run等命令，无需依赖宿主机Docker环境
• NodeJS开发环境：预安装NodeJS及npm/yarn包管理器，支持NodeJS应用的开发、构建与运行
• AWS CLI集成：包含AWS CLI工具，可直接执行AWS资源管理操作（如S3操作、EC2管理、Lambda部署等）
• 多版本支持：提供不同NodeJS版本（如14/16/18）和AWS CLI版本（v1/v2）的镜像标签
• 轻量级设计：基于官方基础镜像优化，减少冗余依赖，提升容器启动速度

使用场景与适用范围

• CI/CD流水线：在持续集成流程中构建、测试Docker镜像及NodeJS应用
• 开发环境标准化：为团队提供一致的NodeJS开发环境，同时支持本地Docker操作
• AWS自动化任务：执行需与AWS交互的容器化任务（如数据同步、资源部署）
• Docker教学环境：安全的Docker命令练习环境，避免影响宿主机系统

使用方法与配置说明

基本使用（docker run）

需以特权模式运行，并映射必要的工作目录：

bash
docker run --privileged -d \
  --name dind-nodejs-aws \
  -v /local/workspace:/workspace \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secret \
  -e AWS_REGION=us-east-1 \
  dind-nodejs-aws:latest

Docker Compose配置示例

yaml
version: '3'
services:
  dind-env:
    image: dind-nodejs-aws:node18-awscli2
    privileged: true
    volumes:
      - ./workspace:/workspace
      - dind-data:/var/lib/docker
      - aws-config:/root/.aws
    environment:
      - NODE_ENV=development
      - AWS_REGION=ap-southeast-1
    ports:
      - "3000:3000"  # 暴露NodeJS应用端口

volumes:
  dind-data:       # 持久化Docker数据
  aws-config:      # 持久化AWS配置

环境变量说明

常用操作示例

进入容器环境

bash
docker exec -it dind-nodejs-aws /bin/bash

构建Docker镜像

bash
cd /workspace/app
docker build -t my-node-app:v1 .

运行NodeJS应用

bash
node /workspace/app/index.js
# 或使用npm启动
cd /workspace/app && npm start

管理AWS资源

bash
# 列出S3存储桶
aws s3 ls

# 部署Lambda函数
aws lambda update-function-code --function-name my-function --zip-file fileb://function.zip

注意事项

• 特权模式风险：使用--privileged标志会赋予容器较高系统权限，建议仅在可信环境使用
• 数据持久化：需挂载/var/lib/docker（Docker数据）和/workspace（项目代码）以避免数据丢失
• AWS凭证安全：建议通过环境变量或/root/.aws/credentials文件注入凭证，避免硬编码
• 版本选择：通过镜像标签指定版本，如dind-nodejs-aws:node16-awscli1（NodeJS 16 + AWS CLI v1）

典型应用流程

1. 启动容器并挂载项目目录
2. 在容器内使用NodeJS开发应用
3. 通过Docker命令构建应用镜像
4. 使用AWS CLI将镜像推送到ECR或部署应用到AWS服务