polymersearch/node-aws

docker-node-aws 镜像文档

镜像概述

docker-node-aws是一个轻量级Docker镜像，基于Alpine Linux构建，集成了Node.js运行环境和AWS CLI工具。该镜像旨在为开发者和运维人员提供一个便捷的环境，用于开发、测试及运行需要与AWS云服务交互的Node.js应用程序，简化依赖管理和环境配置流程。

核心功能与特性

• 轻量级基础：采用Alpine Linux作为基础镜像，具有体积小、启动快、资源占用低的特点
• Node.js环境：内置Node.js运行时，支持Node.js应用的开发、调试和运行
• AWS CLI集成：预装AWS命令行工具，可直接执行AWS服务操作（如S3管理、ECS部署、Lambda函数管理等）
• 兼容性：兼容主流Node.js版本和AWS CLI功能，满足大多数云服务交互需求
• 灵活扩展：支持通过Dockerfile或启动参数添加额外依赖和配置

使用场景与适用范围

• AWS云服务相关的Node.js应用开发与测试
• 自动化脚本执行（如AWS资源部署、数据同步、日志管理等）
• CI/CD流程中需要调用AWS CLI的任务环境
• 本地开发环境快速搭建Node.js+AWS工具链
• 轻量级云服务管理工具容器化部署

使用方法与配置说明

基本使用

启动交互式容器

通过以下命令启动交互式容器，直接使用Node.js和AWS CLI：

bash
docker run -it --rm docker-node-aws /bin/sh

执行AWS CLI命令

在容器中执行AWS CLI命令（需提前配置AWS凭证）：

bash
# 示例：列出S3存储桶
docker run -it --rm -v ~/.aws:/root/.aws docker-node-aws aws s3 ls

运行Node.js脚本

挂载本地Node.js项目并运行：

bash
docker run -it --rm -v $(pwd):/app -w /app docker-node-aws node app.js

AWS凭证配置

方法1：挂载本地AWS配置文件

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

bash
docker run -it --rm -v ~/.aws:/root/.aws docker-node-aws

方法2：通过环境变量配置

适用于CI/CD等无本地配置文件的场景：

bash
docker run -it --rm \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  -e AWS_REGION="us-east-1" \
  docker-node-aws aws ec2 describe-instances

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  node-aws-app:
    image: docker-node-aws
    volumes:
      - ~/.aws:/root/.aws       # 挂载AWS凭证
      - ./node-app:/app         # 挂载Node.js应用代码
    working_dir: /app
    environment:
      - NODE_ENV=production
      - AWS_REGION=us-west-2
    command: node index.js      # 运行应用

启动服务：

bash
docker-compose up -d

环境变量说明