本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将 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 在 RubyGemsaws-sdk
Gem 较大,安装过程可能需要一个多小时。
我们建议仅安装您使用的 Amazon Web Services的相应 Gem。这些 Gem 的命名形式为 aws-sdk-
,完整列表见适用于 Ruby 的 Amazon SDK 自述文件的支持的服务service_abbreviation
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
-
安装 Bundler 并创建
Gemfile
:$
gem install bundler
$
bundle init
-
打开创建的
Gemfile
,然后为代码将使用的每个 Amazon 服务 Gem 添加一个gem
行。要按照 Amazon S3 示例进行操作,请将以下行添加到文件底部:gem "aws-sdk-s3"
-
保存 Gemfile。
-
安装
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 运行程序来运行代码。
运行代码生成的任何输出都显示在选项卡中。