javierpassan/node-awscli

Node.js LTS & AWS CLI Docker镜像文档

镜像概述

本Docker镜像集成了Node.js LTS（长期支持版）运行时环境与AWS CLI（Amazon Web Services Command Line Interface）工具，旨在为开发者提供一站式容器环境，满足同时使用Node.js应用开发与AWS资源管理的需求。镜像基于轻量级基础镜像构建，确保环境一致性与资源高效利用。

核心功能与特性

Node.js LTS特性

• 包含最新稳定的Node.js LTS版本（具体版本可通过node -v查看）
• 内置npm包管理器，支持Node.js依赖管理与包安装
• 支持ES模块（ESM）与CommonJS模块系统
• 包含Node.js核心API及标准库，满足基础应用开发需求

AWS CLI特性

• 预安装AWS CLI最新稳定版，支持AWS所有服务的命令行管理
• 支持多种认证方式：环境变量配置、AWS凭证文件、IAM角色（适用于ECS/EKS等容器服务）
• 支持AWS配置文件（~/.aws/config）与凭证文件（~/.aws/credentials）
• 支持命令自动补全、输出格式自定义（JSON/table/text）及区域配置

适用场景

• Node.js应用开发与测试：在隔离环境中开发依赖AWS服务的Node.js应用
• AWS资源自动化脚本：运行基于Node.js编写的AWS资源管理、数据处理自动化脚本
• CI/CD流程集成：作为CI/CD流水线的执行环境，完成Node.js应用构建、测试及AWS资源部署
• 本地开发环境标准化：统一团队成员的Node.js与AWS CLI版本，避免环境差异导致的问题

使用方法与配置说明

基本使用

拉取与运行镜像

bash
# 拉取镜像（假设镜像名称为node-aws-cli:lts）
docker pull docker.xuanyuan.run/node-aws-cli:lts

# 交互式运行容器（进入bash终端）
docker run -it --rm docker.xuanyuan.run/node-aws-cli:lts bash

验证环境

在容器终端中执行以下命令验证组件版本：

bash
# 验证Node.js版本
node -v

# 验证npm版本
npm -v

# 验证AWS CLI版本
aws --version

配置AWS CLI

方式1：通过环境变量配置（推荐用于临时环境）

通过-e参数传递AWS凭证与区域信息：

bash
docker run -it --rm \
  -e AWS_ACCESS_KEY_ID="your_aws_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_aws_secret_key" \
  -e AWS_REGION="us-east-1" \
  docker.xuanyuan.run/node-aws-cli:lts \
  aws s3 ls  # 示例：列出S3存储桶

方式2：挂载本地AWS配置文件（推荐用于开发环境）

将本地~/.aws目录（包含config与credentials文件）挂载到容器：

bash
docker run -it --rm \
  -v ~/.aws:/root/.aws \  # 挂载本地AWS配置目录到容器
  node-aws-cli:lts \
  aws ec2 describe-instances  # 示例：查询EC2实例信息

运行Node.js应用与AWS命令

运行本地Node.js脚本

挂载当前目录到容器/app路径，执行脚本：

bash
docker run -it --rm \
  -v $(pwd):/app \  # 挂载本地目录到容器/app
  -w /app \  # 设置工作目录为/app
  node-aws-cli:lts \
  node your_script.js  # 执行本地Node.js脚本

结合Node.js与AWS CLI的自动化任务

示例：在Node.js脚本中调用AWS CLI命令（通过child_process模块）：

javascript
// script.js
const { execSync } = require('child_process');

// 调用AWS CLI获取S3存储桶列表
const s3Buckets = execSync('aws s3 ls --output json', { encoding: 'utf-8' });
console.log('S3 Buckets:', JSON.parse(s3Buckets));

执行脚本：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  -e AWS_ACCESS_KEY_ID="your_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret" \
  -e AWS_REGION="us-east-1" \
  docker.xuanyuan.run/node-aws-cli:lts \
  node script.js

环境变量说明

注意事项

• 容器中root用户为默认运行用户，生产环境建议通过--user参数指定非root用户
• 敏感信息（如AWS凭证）避免硬编码，优先使用环境变量或挂载配置文件
• 长期运行的容器需定期更新镜像以获取Node.js与AWS CLI的安全补丁
• 如需扩展功能（如额外系统依赖），可基于本镜像通过Dockerfile构建自定义镜像