Elasticity 项目技术文档

1. 安装指南

在安装 Elasticity 项目之前，确保你的系统运行的 Ruby 版本不低于 2.2。

使用以下命令通过 Gem 安装 Elasticity：

gem install elasticity

或者，在你的 Gemfile 中添加以下内容：

gem 'elasticity', '~> 6.0'

这样做可以保护你的项目不受 API 更改的影响，因为这些更改只会出现在主要版本中。

2. 项目使用说明

Elasticity 提供了两种访问 Amazon EMR 的方式：

• 通过基于 JobFlow 的 API 间接访问。
• 通过直接访问 EMR REST API 直接访问。

以下是通过 JobFlow API 启动一个 "Cloudburst (Custom Jar)" 样本作业的示例：

require 'elasticity'

# 配置 AWS 凭证
Elasticity.configure do |c|
  c.access_key = ENV['AWS_ACCESS_KEY_ID']
  c.secret_key = ENV['AWS_SECRET_ACCESS_KEY']
end

# 创建一个 job flow
jobflow = Elasticity::JobFlow.new

# 添加一个自定义 jar 步骤
step = Elasticity::CustomJarStep.new('s3n://elasticmapreduce/samples/cloudburst/cloudburst.jar')
step.arguments = %w(s3n://elasticmapreduce/samples/cloudburst/input/s_suis.br s3n://elasticmapreduce/samples/cloudburst/input/100k.br s3n://OUTPUT_BUCKET/cloudburst/output/2012-06-22 36 3 0 1 240 48 24 24 128 16)

# 将步骤添加到 job flow
jobflow.add_step(step)

# 启动 job flow
jobflow.run

请注意，此示例仅适用于 CustomJarStep。其他步骤会有不同的参数传递方式。

3. 项目 API 使用文档

Elasticity API 的 Ruby 文档可以在 RubyGems 自动生成的文档网站 上找到。直接调用 Amazon API 需要你了解如何构建 EMR 请求。

关于如何配置作业流（Job Flows）、实例组（Instance Groups）、引导操作（Bootstrap Actions）等详细使用方法，请参考项目 Wiki 和 README 文件中的相关描述。

4. 项目安装方式

项目的安装方式已在“安装指南”一节中说明。简要概括如下：

• 确保 Ruby 版本不低于 2.2。
• 使用 Gem 命令安装 Elasticity。
• 或者在 Gemfile 中指定 Elasticity 依赖。