将 Amazon Cloud9 与适用于 Ruby 的 Amazon SDK 结合使用 - Amazon 适用于 Ruby 的 SDK
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

将 Amazon Cloud9 与适用于 Ruby 的 Amazon SDK 结合使用

Amazon Cloud9 是一个基于 Web 的集成式开发环境 (IDE),其中包含一系列工具,可用于在云中编码、构建、运行、测试、调试和发布软件。您可以将 Amazon Cloud9 与适用于 Ruby 的 Amazon SDK 结合使用,以便通过使用浏览器来编写和运行 Ruby 代码。Amazon Cloud9 包括代码编辑器和终端等工具。由于 Amazon Cloud9 IDE 是基于云的,因此您可以在办公室、在家或在任何地方使用连接 Internet 的设备来处理项目。有关 Amazon Cloud9 的一般信息,请参阅 Amazon Cloud9 用户指南

请按照以下说明设置 Amazon Cloud9 与适用于 Ruby 的 Amazon SDK:

步骤 1:设置 Amazon Web Services 账户 以使用 Amazon Cloud9

要使用 Amazon Cloud9,请从 Amazon Web Services Management Console 登录到 Amazon Cloud9 控制台。

注意

如果您使用 Amazon IAM Identity Center 进行身份验证,则可能需要在 IAM 控制台中向用户附加的策略中添加 iam:ListInstanceProfilesForRole 的所需权限。

要在您的 Amazon 账户中设置可访问 Amazon Cloud9 的 IAM 实体并登录 Amazon Cloud9 控制台,请参阅《Amazon Cloud9 用户指南》中的 Amazon Cloud9 团队设置

步骤 2:设置 Amazon Cloud9 开发环境

登录 Amazon Cloud9 控制台后,请使用控制台创建 Amazon Cloud9 开发环境。创建环境后,Amazon Cloud9 会打开该环境的 IDE。

有关详细信息,请参阅《Amazon Cloud9 用户指南》中的在 Amazon Cloud9 中创建环境

注意

在控制台中首次创建环境之后,我们建议您选择 Create a new instance for environment (EC2) (创建新的环境实例 (EC2))。Amazon Cloud9 会根据此选项创建环境、启动 Amazon EC2 实例,然后将新实例与新环境相连接。这是开始使用 Amazon Cloud9 的最快方式。

如果终端未在 IDE 中打开,请打开它。在 IDE 中的菜单栏上,选择 Window, New Terminal (窗口、新终端)。您可以使用终端窗口来安装工具和构建应用程序。

步骤 3:设置适用于 Ruby 的 Amazon SDK

在 Amazon Cloud9 打开开发环境的 IDE 后,请在您的环境中使用终端窗口来设置适用于 Ruby 的 Amazon SDK。

您可以像安装任何 Ruby Gem 一样安装适用于 Ruby 的 Amazon SDK。这些 Gem 在 RubyGems 中提供。适用于 Ruby 的 Amazon SDK 采用模块化设计,并按照 Amazon Web Service各自独立。整个 aws-sdk Gem 较大,安装过程可能需要一个多小时。

我们建议仅安装您使用的 Amazon Web Services的相应 Gem。这些 Gem 的命名形式为 aws-sdk-service_abbreviation,完整列表见适用于 Ruby 的 Amazon SDK 自述文件的支持的服务表格。例如,用于与 Amazon S3 服务交互的 Gem 可直接从 aws-sdk-s3 中获得。

Ruby 版本管理器

我们建议不要使用系统 Ruby,而是使用如下所示的 Ruby 版本管理器:

例如,如果您使用的是 Amazon Linux 2 操作系统,则可以使用以下命令更新 RVM,列出可用的 Ruby 版本,然后选择想要在开发工作中与适用于 Ruby 的 Amazon SDK 配合使用的版本。要求的最低 Ruby 版本为 2.3。

$ rvm get head $ rvm list known $ rvm install ruby-3.1.3 $ rvm --default use 3.1.3

Bundler

如果使用 Bundler,则使用以下命令安装 Amazon S3 的适用于 Ruby 的 Amazon SDK Gem:

  1. 安装 Bundler 并创建 Gemfile

    $ gem install bundler $ bundle init
  2. 打开创建的 Gemfile,然后为代码将使用的每个 Amazon 服务 Gem 添加一个 gem 行。要按照 Amazon S3 示例进行操作,请将以下行添加到文件底部:

    gem "aws-sdk-s3"
  3. 保存 Gemfile。

  4. 安装 Gemfile 中指定的依赖项:

    $ bundle install

步骤 4:下载示例代码

使用终端窗口将适用于 Ruby 的 Amazon SDK 的示例代码下载到 Amazon Cloud9 开发环境中。

要将官方 Amazon SDK 文档中使用的所有代码示例的副本都下载到环境的根目录中,请运行以下命令:

$ git clone https://github.com/awsdocs/aws-doc-sdk-examples.git

适用于 Ruby 的 Amazon SDK 的代码示例位于 ENVIRONMENT_NAME/aws-doc-sdk-examples/ruby 目录,其中 ENVIRONMENT_NAME 是开发环境的名称。

要继续使用 Amazon S3 示例,我们建议从代码示例 ENVIRONMENT_NAME/aws-doc-sdk-examples/ruby/example_code/s3/bucket_list.rb 开始。使用终端窗口导航到 s3 目录并列出文件。

$ cd aws-doc-sdk-examples/ruby/example_code/s3 $ ls

要在 Amazon Cloud9 中打开文件,可以直接在终端窗口中单击 bucket_list.rb

有关理解代码示例的更多支持,请参阅适用于 Ruby 的 Amazon SDK 代码示例

步骤 5:运行示例代码

要在 Amazon Cloud9 开发环境中运行代码,请选择顶部菜单栏中的运行按钮。Amazon Cloud9 将自动检测 .rb 文件扩展名并使用 Ruby 运行程序来运行代码。有关在 Amazon Cloud9 中运行代码的更多信息,请参阅《Amazon Cloud9 用户指南》中的运行代码

在下面的屏幕截图中,请注意以下基本区域:

  • 1:运行。运行按钮位于顶部菜单栏中。这会为结果打开新选项卡。

    注意

    还可以手动创建新的运行配置。在菜单栏上依次选择 Run(运行)> Run Configurations(运行配置)> New Run Configuration(新建运行配置)

  • 2:命令。Amazon Cloud9 使用运行文件的路径和文件名来填充命令文本框。如果代码需要传入任何命令行参数,则可以将这些参数添加到命令行中,方法与通过终端窗口运行代码时相同。

  • 3:运行程序。Amazon Cloud9 检测到文件扩展名为 .rb,然后选择 Ruby 运行程序来运行代码。


            从 Amazon Cloud9 IDE 的顶部菜单栏中选择“运行”会打开新选项卡,并且已填充“命令”框且已选择 Ruby 运行程序。

运行代码生成的任何输出都显示在选项卡中。