imageapi/ruby-node-aws

Docker镜像文档

镜像概述和主要用途

本镜像基于circleci/ruby:2.4基础镜像构建，在保留Ruby 2.4环境的基础上，额外集成了NodeJS运行环境和AWS CLI工具。主要用于需要同时使用Ruby开发环境、Node.js工具链及AWS资源管理能力的开发、测试或CI/CD场景，尤其适合在统一环境中完成Ruby应用开发、Node.js相关构建任务及AWS资源自动化操作。

核心功能和特性

• 基础环境：基于circleci/ruby:2.4镜像，提供稳定的Ruby 2.4运行环境，包含Ruby标准库及基础开发工具
• 多语言支持：预装NodeJS环境，可直接运行Node.js脚本或使用npm/yarn管理Node.js依赖
• 云服务集成：内置AWS CLI工具，支持通过命令行管理AWS资源（如S3、EC2、Lambda等）
• CI/CD适配：继承自CircleCI官方基础镜像，可无缝集成到CircleCI等CI/CD平台的自动化流程中

使用场景和适用范围

• Ruby应用开发+Node.js工具链：Ruby后端开发中需使用Node.js工具（如Webpack打包前端资源、Babel转译等）的场景
• AWS部署自动化：需在Ruby应用构建/测试流程中通过AWS CLI执行部署命令（如上传构建产物到S3、更新Lambda函数等）
• 多工具统一环境：避免本地环境配置差异，通过容器化方式提供包含Ruby、Node.js、AWS CLI的统一开发/测试环境
• CI/CD流程集成：作为CircleCI等CI平台的运行环境，执行包含Ruby代码检查、Node.js构建、AWS资源操作的自动化任务

使用方法和配置说明

基本使用

通过docker run命令启动容器，可直接使用Ruby、Node.js及AWS CLI工具：

bash
# 启动交互式shell，检查环境
docker run -it --rm [镜像名称] bash

# 在容器中执行Ruby命令
docker run --rm [镜像名称] ruby -v  # 输出Ruby版本（2.4.x）

# 执行Node.js命令
docker run --rm [镜像名称] node -v  # 输出Node.js版本
docker run --rm [镜像名称] npm -v   # 输出npm版本

# 执行AWS CLI命令
docker run --rm [镜像名称] aws --version  # 输出AWS CLI版本

AWS CLI配置

AWS CLI需配置访问凭证（Access Key）以操作AWS资源，支持两种配置方式：

1. 环境变量注入

通过-e参数传入AWS凭证环境变量：

bash
docker run -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
           -e AWS_SECRET_ACCESS_KEY=your-secret-key \
           -e AWS_REGION=us-east-1 \
           --rm [镜像名称] aws s3 ls  # 列出S3存储桶

2. 挂载本地AWS配置文件

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

bash
docker run -v ~/.aws:/root/.aws \
           --rm [镜像名称] aws ec2 describe-instances  # 描述EC2实例

在CI/CD中使用（以CircleCI为例）

在.circleci/config.yml中指定本镜像作为执行环境，示例如下：

yaml
version: 2.1
jobs:
  build-and-deploy:
    docker:
      - image: [镜像名称]  # 替换为实际镜像名称
    steps:
      - checkout  # 拉取代码
      
      - run:
          name: 安装Ruby依赖
          command: bundle install
          
      - run:
          name: 使用Node.js构建前端资源
          command: |
            npm install
            npm run build  # 执行前端构建脚本
            
      - run:
          name: 通过AWS CLI部署到S3
          command: aws s3 sync ./dist s3://your-bucket-name --delete
          
workflows:
  main:
    jobs:
      - build-and-deploy

自定义配置

如需扩展镜像功能（如安装额外依赖），可基于本镜像创建Dockerfile：

dockerfile
FROM [镜像名称]

# 安装额外Ruby gem
RUN gem install rails

# 安装Node.js包
RUN npm install -g yarn

# 配置AWS CLI默认区域
RUN aws configure set default.region us-west-2

构建并使用自定义镜像：

bash
docker build -t custom-image .
docker run --rm custom-image rails -v